Aller au contenu

Mise à jour pour utiliser le package TikZ

Le package TikZ

Depuis la version du site modèle v.2.5.2, il est possible d'utiliser le package TikZ de LaTeX pour réaliser des tableaux de signes ou de varaiations.
Si la version de votre site est antérieure vous devez réaliser la mise à jour suivante.

Ajouter le fichier tikzjax.config.js⚓︎

Dans le répertoire docs, dans le répertoire xtra, ajouter s'il n'existe pas le répertoire javascripts, et dans ce répertoire le fichier tikzjax.config.js

Code à copier du fichier tikzjax.config.js
window.TikzJaxOptions = {
    renderTimeout: 15000,
    maxRetries: 1,
    restartWorkerOnFail: true,

    brokenImageSrc: "https://cdn.jsdelivr.net/npm/@rod2ik/tikzjax@1.1.7/dist/assets/broken-image.svg",

    tex: {
        texPackages: {
            amsmath: "",
            "tkz-tab": ""
        },
        tikzLibraries: [
            "arrows.meta",
            "calc",
            "positioning"
        ],
        addToPreamble: ""
    },

    tkzTab: {
        lineWidth: "1.2pt",
        font: "\\Large",

        lgt: 10,
        firstColumnWidth: 10,
        espcl: 3.2,

        variableRowHeight: 1.5,
        signRowHeight: 2.5,
        variationRowHeight: 2.5,
        imageRowHeight: 2.5,
        antecedentRowHeight: 2.5
    }
};

Modifier le fichier mkdocs.yml⚓︎

Vers la ligne 106 ajouter les trois lignes manquantes pour obtenir :

    - pymdownx.superfences:
        custom_fences:
          - name: tikzjax
            class: language-tikzjax
            format: !!python/name:pymdownx.superfences.fence_code_format
          - name: mermaid
            class: mermaid
            format: !!python/name:pymdownx.superfences.fence_code_format

Vers la ligne 149, modifier pour obtenir ceci

extra_javascript:   # Supprimer le # du début de la ligne s'il y en avait un
  - xtra/javascripts/tikzjax.config.js    # Ligne à rajouter pour le package TikZ

Modifier le fichier main.html⚓︎

Dans le répertoire overrides modifier le fichier main.html

Ajouter les lignes manquantes pour obtenir :

Fichier main.html
<!--
Pour utiliser tikzjax et indiquer le numéro de version à la main en pied de page
-->

{% extends "base_pmt.html" %}

{% block libs %}
  {{ super() }}
  <script src="{{base_url}}/xtra/javascripts/tikzjax.config.js"></script>
  <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@rod2ik/tikzjax@1.1.8/dist/fonts.min.css">
  <script src="https://cdn.jsdelivr.net/npm/@rod2ik/tikzjax@1.1.8/dist/tikzjax.min.js"></script>
{% endblock %}

{% block footer %}
  {{ super() }}
  <script>
  $(".md-copyright_pyodide #pyodide-footer").prepend(
    $(`<div>v.2.5.2</div>`).css({display:"flex", "justify-content":"right"})
  )
  </script>
{% endblock %}