Passage à MkDocs

.gitignore

+/site

.gitlab-ci.yml

+image: python:latest
+pages:
+  stage: deploy
+  only:
+    - master
+  script:
+    - pip install mkdocs-material
+    - pip install mkdocs-macros-plugin
+    - mkdocs build --site-dir public
+  artifacts:
+    paths:
+      - public

docs/index.md

+# Enseignement scientifique en Terminale (partie maths)
+
+[Cours sur Moodle](https://0680010s.moodle.monbureaunumerique.fr/course/view.php?id=733 "Sur le site du lycée Blaise Pascal"){ .md-button }
+
+## Les thèmes au programme
+
+* Les modèles démographiques
+* L'intelligence artificielle
+* La biodiversité et son évolution
+* Optimisation du transport de l'électricité
+
+---
+
+!!! info "Pourquoi ?"
+    Elles permettent de délimiter des blocs de contenu
+     avec une touche de couleur, sans créer de nouvelles
+     entrées dans la table des matières.
+
+    Elles structurent donc sans alourdir les onglets de navigation.
+
+---
+
+$$\pi\approx 3,1415$$
+
+2^e^ essai :
+
+$f(x)=\dfrac{\mathrm{e}^x}{\sin{x}}$
+
+---
+
+=== "`C`"
+
+    ```c
+    #include <stdio.h>
+
+    int main(void) {
+      printf("Hello world!\n");
+      return 0;
+    }
+    ```
+
+=== "`C++`"
+
+    ```cpp
+    #include <iostream>
+
+    int main(void) {
+      std::cout << "Hello world!" << std::endl;
+      return 0;
+    }
+    ```
+
+=== "`Python`"
+
+    ```python
+    print("Hello world!")
+    ```
+
+---
+
+Lorem ipsum[^ip] dolor sit amet, consectetur adipiscing[^ad] elit.[^el]
+
+[^ip]: Lorem ipsum dolor sit amet, consectetur adipiscing elit.
+
+[^ad]:
+    Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nulla et euismod
+    nulla. Curabitur feugiat, tortor non consequat finibus, justo purus auctor
+    massa, nec semper lorem quam in massa.
+
+[^el]:
+    Ce texte [Lorem ipsum ...](https://fr.wikipedia.org/wiki/Lorem_ipsum)
+    est un faux-texte destiné à remplir la vide.
+
+Une liste de tâches
+
+- [ ] à faire
+- [x] fini
+- [ ] presque
+- [x] fait depuis longtemps
+
+JEU_52 = (
+    '🂡🂢🂣🂤🂥🂦🂧🂨🂩🂪🂫🂭🂮',
+    '🂱🂲🂳🂴🂵🂶🂷🂸🂹🂺🂻🂽🂾',
+    '🃁🃂🃃🃄🃅🃆🃇🃈🃉🃊🃋🃍🃎',
+    '🃑🃒🃓🃔🃕🃖🃗🃘🃙🃚🃛🃝🃞',
+    '🂠🂬🂼🃌🃜🃏🃟'
+    )
+
+
+---
+
+> **Cookie** :
+>
+> - Anciennement petit gâteau sucré, qu'on acceptait avec plaisir.
+> - Aujourd'hui : petit fichier informatique drôlement salé, qu'il faut refuser avec véhémence.
+
+De Luc Fayard, _Dictionnaire impertinent des branchés_
+
+---
+
+La définition de la fonction `premier` commence avec le mot clé `def`
+
+Elle prend en paramètre un entier `n`
+
+Elle renvoie un booléen avec le mot clé `return`
+
+---
+
+| Objectif | Markdown | Rendu |
+|:---------|-------------:|:---:|
+| Créer un lien    | `[texte cliquable](https://mon_lien.fr)` | [texte cliquable](https://mon_lien.fr) |
+| Emphase faible   | `Un _mot_ discret`    | Un _mot_ discret   |
+| Emphase forte    | `Un **mot** visible`  | Un **mot** visible |
+| Du code en ligne | ``Une boucle `for` `` | Une boucle `for`   |
+

docs/xtra/javascripts/config.js

+window.MathJax = {
+  tex: {
+    inlineMath: [["\\(", "\\)"]],
+    displayMath: [["\\[", "\\]"]],
+    processEscapes: true,
+    processEnvironments: true
+  },
+  options: {
+    ignoreHtmlClass: ".*|",
+    processHtmlClass: "arithmatex"
+  }
+};
+
+document$.subscribe(() => {
+  MathJax.typesetPromise()
+})

docs/xtra/stylesheets/ajustements.css

+.md-typeset div.arithmatex  {
+    overflow: initial;
+}
+
+.md-typeset .admonition {
+    font-size: 0.8rem;
+}
+
+.md-typeset details {
+    font-size: 0.8rem;
+}

mkdocs.yml

+site_name: "Enseignement scientifique en Terminale (mathématiques)"
+
+nav:
+  - 'Accueil': 'index.md'
+
+
+theme:
+  name: material
+  font: false
+  language: fr
+  features:
+    - navigation.instant
+    - navigation.tabs
+    - navigation.expand
+    - navigation.top
+    - toc.integrate
+    - header.autohide
+
+  palette:
+    # Light mode
+    - media: "(prefers-color-scheme: light)"
+      scheme: default
+      primary: indigo
+      accent: indigo
+      toggle:
+        icon: material/toggle-switch-off-outline
+        name: Mode sombre
+
+    # Dark mode
+    - media: "(prefers-color-scheme: dark)"
+      scheme: slate
+      primary: blue
+      accent: blue
+      toggle:
+        icon: material/toggle-switch
+        name: Mode clair
+
+
+markdown_extensions:
+  - meta
+  - abbr
+  - admonition
+  - def_list
+  - attr_list
+  - footnotes
+  - pymdownx.caret
+  - pymdownx.mark
+  - pymdownx.tilde
+  - pymdownx.snippets
+  - pymdownx.details
+  - pymdownx.highlight:
+      linenums: true
+  - pymdownx.tasklist:
+      custom_checkbox: false
+      clickable_checkbox: true
+  - pymdownx.inlinehilite
+  - pymdownx.superfences
+  - pymdownx.keys
+  - pymdownx.tabbed
+  - pymdownx.betterem:
+      smart_enable: all
+  - pymdownx.emoji:
+      emoji_index: !!python/name:materialx.emoji.twemoji
+      emoji_generator: !!python/name:materialx.emoji.to_svg
+  - pymdownx.arithmatex:
+      generic: true
+  - toc:
+      permalink: ⚓︎
+      toc_depth: 3
+
+
+plugins:
+  - search
+  - macros
+
+extra:
+  social:
+    - icon: fontawesome/solid/paper-plane
+      link: mailto:mon_prénom.mon_nom@chez.moi
+      name: Écrire à l'auteur
+
+extra_javascript:
+  - javascripts/config.js
+  - https://polyfill.io/v3/polyfill.min.js?features=es6
+  - https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js