update(theme): bump Material for Mkdocs minimal version to 9.7 and adapt to full features (#74)

See:
https://squidfunk.github.io/mkdocs-material/blog/2025/11/11/insiders-now-free-for-everyone/

Author: Guts

.github/labeler.yml

@@ -41,7 +41,6 @@ theme:
   - changed-files:
       - any-glob-to-any-file:
           - content/theme/**/*
-          - requirements-insiders.txt
   - head-branch:
       - theme
       - ^theme

.github/workflows/deploy.yml

@@ -42,15 +42,13 @@ jobs:
       - name: Set up Python
         uses: actions/setup-python@v6
         with:
-          python-version: 3.11
+          python-version: 3.12
           cache: "pip"
 
       - name: Install dependencies
-        env:
-          GH_TOKEN_MATERIAL_INSIDERS: ${{ secrets.GH_TOKEN_MATERIAL_INSIDERS }}
         run: |
           python -m pip install --upgrade pip setuptools wheel
-          python -m pip install --upgrade -r requirements-insiders.txt
+          python -m pip install --upgrade -r requirements.txt
 
       - name: Cache build dependencies (external assets downloaded)
         uses: actions/cache@v4

.github/workflows/issue_comment.yml

@@ -21,7 +21,7 @@ jobs:
         uses: actions/setup-python@v6
         with:
           cache: "pip"
-          python-version: 3.11
+          python-version: 3.12
 
       - name: Parse template form
         uses: stefanbuck/github-issue-parser@v3

.github/workflows/links_checker.yml

@@ -23,15 +23,13 @@ jobs:
       - name: Set up Python
         uses: actions/setup-python@v6
         with:
-          python-version: 3.11
+          python-version: 3.12
           cache: "pip"
 
       - name: Install dependencies
-        env:
-          GH_TOKEN_MATERIAL_INSIDERS: ${{ secrets.GH_TOKEN_MATERIAL_INSIDERS }}
         run: |
           python -m pip install --upgrade pip setuptools wheel
-          python -m pip install --upgrade -r requirements-insiders.txt
+          python -m pip install --upgrade -r requirements.txt
           python -m pip install --upgrade "LinkChecker>=10,<11"
 
       - name: Build static website

.github/workflows/pr_checker_build.yml

@@ -34,27 +34,14 @@ jobs:
       - name: Set up Python
         uses: actions/setup-python@v6
         with:
-          python-version: 3.11
+          python-version: 3.12
           cache: "pip"
 
       - name: Install dependencies
         id: dependencies
-        env:
-          GH_TOKEN_MATERIAL_INSIDERS: ${{ secrets.GH_TOKEN_MATERIAL_INSIDERS }}
         run: |
           python -m pip install -U pip setuptools wheel
-
-          # if secret (PR created by repo collaborator) exists = paid features, else only free
-          if [[ -z "${GH_TOKEN_MATERIAL_INSIDERS}" ]]; then
-            echo "::warning:: L'accès aux token est réservé aux comptes avec droits d'écriture sur le dépôt. La version gratuite du thème est donc utilisée sans mots-clés, etc.)"
-            python -m pip install -U -r requirements-free.txt
-            echo "MKDOCS_CONFIG_FILENAME=mkdocs-free.yml" >> $GITHUB_ENV
-          else
-            # install insiders version using token
-            python -m pip install -U -r requirements-insiders.txt
-            echo "MKDOCS_CONFIG_FILENAME=mkdocs.yml" >> $GITHUB_ENV
-          fi
-
+          python -m pip install -U -r requirements.txt
       - name: Cache build dependencies (external assets downloaded)
         uses: actions/cache@v4
         with:
@@ -76,13 +63,13 @@ jobs:
           export MKDOCS_SITE_URL="https://${NETLIFY_SITE_PREFIX}--${NETLIFY_SITE_NAME}.netlify.app/"
 
           # merge different configs
-          python scripts/100_mkdocs_config_merger.py -c ${{ env.MKDOCS_CONFIG_FILENAME }}
+          python scripts/100_mkdocs_config_merger.py
 
           # build
-          mkdocs build --config-file ${{ env.MKDOCS_CONFIG_FILENAME }} --strict
+          mkdocs build --strict
 
           # save mkdocs.yml for debug
-          cp ${{ env.MKDOCS_CONFIG_FILENAME }} ${{ env.BUILD_DIR }}
+          cp mkdocs.yml ${{ env.BUILD_DIR }}
 
           # remove files reserved for production
           rm ${{ env.BUILD_DIR }}/CNAME

.github/workflows/pr_linter_markdown.yml

@@ -30,7 +30,7 @@ jobs:
         uses: reviewdog/[email protected]
         with:
           github_token: ${{ secrets.GITHUB_TOKEN }}
-          fail_on_error: true
+          fail_level: warning
           filter_mode: added
           reporter: github-pr-review
 

.pre-commit-config.yaml

@@ -1,4 +1,4 @@
-exclude: "node_modules|migrations|.venv|tests/dev/|tests/fixtures/"
+exclude: ".venv|tests/dev/|tests/fixtures/"
 
 repos:
   - repo: meta
@@ -25,7 +25,7 @@ repos:
     hooks:
       - id: pyupgrade
         args:
-          - "--py39-plus"
+          - "--py312-plus"
 
   - repo: https://github.com/astral-sh/ruff-pre-commit
     rev: "v0.14.3"

hooks/mkdocs/G003_social_cards_adapter.py

@@ -27,10 +27,8 @@
 # standard library
 import logging
 from pathlib import Path
-from typing import Optional
 
 # Mkdocs
-from material import __version__ as material_version
 from material.plugins.social.plugin import SocialPlugin
 from mkdocs.config.defaults import MkDocsConfig
 from mkdocs.plugins import event_priority
@@ -44,9 +42,6 @@
 logger = logging.getLogger("mkdocs")
 hook_name = Path(__file__).stem
 
-# check si c'est la version Insiders (payante) ou la version Communauté (gratuite) du thème
-is_insiders = "insiders" in material_version
-
 # ###########################################################################
 # ########## Functions #############
 # ##################################
@@ -55,7 +50,7 @@
 @event_priority(50)
 def on_page_markdown(
     markdown: str, *, page: Page, config: MkDocsConfig, files: Files
-) -> Optional[str]:
+) -> str | None:
     """
     The `page_markdown` event is called after the page's markdown is loaded
     from file and can be used to alter the Markdown source text. The meta-
@@ -106,23 +101,22 @@ def on_page_markdown(
 
         # si la page a une icône, on adapte le template de l'image (disponible que pour Insiders)
         # ref : https://squidfunk.github.io/mkdocs-material/reference#setting-the-page-icon
-        if page.meta.get("icon") and is_insiders:
+        if page.meta.get("icon"):
             cards_layout = "default/variant"
             logger.info(
                 f"[{hook_name}] La page {page.abs_url} a une icône définie "
                 f"({page.meta.get('icon')}). Dans ce cas, le modèle de social "
                 f"card est : {cards_layout}"
             )
-        elif is_insiders:
+        else:
             cards_layout = social_plugin.config.cards_layout
 
         # définit les paramètres pour les social cards au niveau de la page
-        if is_insiders:
-            page.meta["social"] = {
-                "cards": True,
-                "cards_layout": cards_layout,
-                "cards_layout_options": social_plugin.config.cards_layout_options,
-            }
+        page.meta["social"] = {
+            "cards": True,
+            "cards_layout": cards_layout,
+            "cards_layout_options": social_plugin.config.cards_layout_options,
+        }
         # else:
         #     page.meta["social"] = {
         #         "cards": True,