Aller au contenu

Mise à jour vers des versions ulterieures de PMT

Pour PMT v.5.4+⚓︎

Attention : Mise à jour à effectuer si vous avez créé votre site avant le 02/01/2026 pour PMT v.5.4+

Si le version du modèle que vous avez cloné est inférieure à v.2.2.0 vous devez réaliser la mise à jour suivante.

Le passage à Pyodide MkDocs Theme v.5.4+, pour ne pas mettre le pipeline en échec, nécessite des modifications dans le fichier mkdocs.yml vers la ligne 130 vous devez avoir :

À compléter
  - pyodide_macros:
      # Vous pouvez ajouter ici tout réglage que vous auriez ajouté concernant les macros:
      on_error_fail: true     # Il est conseillé d'ajouter celui-ci si vous ne l'utilisez pas.
      # Indispensable pour les versions PMT superieures ou égales à v.5.4.0
      project:
        id: "id_unique_perso_par_projet"    # À personnaliser : doit être différent pour chacun de vos dépots 
        disambiguate_local_storage: false        # Ajouter cette ligne
      build:
        python_libs:
          - turtle
        tab_to_spaces: 4

Vérifier aussi qu'au début du fichier site_name: est bien renseigné

Cette mise à jour, permettra de ne pas perdre les codes des IDE qui ont automatiquement été enregistrés dans le navigateur (dans le localStorage) par les utilisateurs sur une même machine.

Pour plus de précisions : documentation officielle de Fréfdéric Zinelli - local storage TL DR

Mise à jour conseillée en periode creuse si vous avez créé votre site avant le 02/01/2026 pour PMT v.5.4.0

La mise à jour suivante est recommandée, mais effacera les codes des IDE qui ont automatiquement été enregistrés dans le navigateur (dans le localStorage) par les utilisateurs sur une même machine. Il est donc conseillé de la réaliser pendant les grandes vacances par exemple.

vers la ligne 130 vous devez avoir :

Remplacer le code existant par :
  - pyodide_macros:
      # Vous pouvez ajouter ici tout réglage que vous auriez ajouté concernant les macros:
      on_error_fail: true     # Il est conseillé d'ajouter celui-ci si vous ne l'utilisez pas.
      # Indispensable pour les versions PMT superieures ou égales à v.5.4.0
      project:
        id: "id_unique_perso_par_projet"    # À personnaliser : doit être différent pour chacun de vos dépots 
        # disambiguate_local_storage: false        # Supprime cette ligne
      build:
        ides_id_hash_mode: relative  # Ajouter cette ligne
        python_libs:
          - turtle
        tab_to_spaces: 4

Pour plus de précisions : documentation officielle de Fréfdéric Zinelli - local storage TL DR

Pour PMT v.2.2.0⚓︎

Attention : Mise à jour à effectuer si vous avez créé votre site avant le 26/08/2024

Le passage à Pyodide MkDocs Theme v.2.2.0 se fera automatiquement au prochain commit. Pour ne pas mettre le pipeline en échec, il faut dans le fichier mkdocs.yml vers la ligne 130 :

Remplacer

À modifier
  - material/search
  - material/tags:
      tags_file: tags.md

par :

À mettre à la place
  - search
  - tags:
      tags_file: tags.md