.gitignore

@@ -3,3 +3,12 @@ builds/
 .venv/
 .DS_Store
 __pycache__/
+**/__pycache__
+**/.pytest_cache
+**/.vscode
+**/coverage
+**/.coverage
+**/.git
+**/.venv
+**/archived versions
+.env

.gitlab-ci.yml

@@ -7,6 +7,7 @@ stages:
 
 variables:
   PIP_CACHE_DIR: "$CI_PROJECT_DIR/.cache/pip"
+  EDIT_VARIABLE: "$CI_PROJECT_URL/-/tree/main/docs"
 cache:
   paths:
     - .cache/pip
@@ -16,22 +17,28 @@ build:
   before_script:
     - python -m venv .venv
     - source .venv/bin/activate
+    - pip install --upgrade pip
     - pip install -r requirements.txt
   script:
-    - mkdocs build
+    - |
+      if [ $CI_COMMIT_REF_NAME = "main" ] ; then
+        mkdocs build
+      else
+        mkdocs build --no-directory-urls
+      fi
+    - echo -e "CI_PROJECT_REAL_PATH=$(echo $CI_PROJECT_PATH | sed -e "s/$CI_PROJECT_ROOT_NAMESPACE\///")" >> build.env
   rules:
     - if: $CI_PIPELINE_SOURCE == "merge_request_event"
     - if: $CI_COMMIT_REF_NAME == 'main'
   artifacts:
+    reports:
+      dotenv: build.env
     paths:
       - site
 
 pages:review:
   stage: review
-  before_script:
-    - apk add findutils
   script:
-    - find site/ -type f -regextype egrep -iregex ".*\.(html)" -exec sed -i -r -e 's@<a href="../(.*)/"@<a href="../\1/index.html"@' -e 's@<a href="./"@<a href="./index.html"@' -e 's@<a href="../.."@<a href="../../index.html"@' -e 's/(href="[^http].*\/)"/\1index.html"/' "{}" +;
     - mv site public
   needs:
     - job: build
@@ -45,7 +52,7 @@ pages:review:
     - if: $CI_MERGE_REQUEST_ID
   environment:
       name: review/$CI_COMMIT_REF_NAME
-      url: "https://$CI_PROJECT_ROOT_NAMESPACE.$CI_PAGES_DOMAIN/-/$CI_PROJECT_NAME/-/jobs/$CI_JOB_ID/artifacts/public/"
+      url: "https://$CI_PROJECT_ROOT_NAMESPACE.$CI_PAGES_DOMAIN/-/$CI_PROJECT_REAL_PATH/-/jobs/$CI_JOB_ID/artifacts/public/"
       auto_stop_in: 1 week
       on_stop: pages:review:stop
 
@@ -75,7 +82,6 @@ pages:
   dependencies:
     - build
   rules:
-    - if: $CI_PIPELINE_SOURCE == "merge_request_event"
     - if: $CI_MERGE_REQUEST_APPROVED && $CI_MERGE_REQUEST_TARGET_BRANCH_NAME == "main"
     - if: $CI_COMMIT_REF_NAME == 'main'
   artifacts:

.gitlab/route-map.yml

-- source: /docs/(.*)\//
-  public: '\1/index.html'
-- source: /docs/(.*).md/
-  public: '\1/index.html'
+- source: /docs\/(.*).md/
+  public: '\1.html'
 - source: /.*/
   public: 'index.html'

README.md

-Ce fichier est à éditer lors de la première utilisation du projet.
+[Rendu de mon site](https://docs.forge.apps.education.fr/modeles/pyodide-mkdocs-theme-review/)
 
-<a rel="license" href="http://creativecommons.org/licenses/by-nc-sa/4.0/"><img alt="Licence Creative Commons" style="border-width:0" src="https://i.creativecommons.org/l/by-nc-sa/4.0/80x15.png" /></a><br />Le modèle et les travaux dérivés sont mis à disposition selon les termes de la <a rel="license" href="http://creativecommons.org/licenses/by-nc-sa/4.0/">Licence Creative Commons Attribution - Pas d’Utilisation Commerciale - Partage dans les Mêmes Conditions 4.0 International</a>.
+Modifier l'url du site
+Ajouter des renseignements si nécessaire
 
-Le rendu se trouve ici :  https://modeles-projets.forge.aeif.fr/mkdocs-pyodide-review/
+## Tutoriel 
 
-Pour signaler un souci sur le **modèle**, écrire à [gitlab+modeles-projets-modeles-projets-154-issue-@aeif.fr](mailto:gitlab+modeles-projets-modeles-projets-154-issue-@aeif.fr)
+Le tutoriel pour utiliser ce modèle est ici : [tutoriel](https://docs.forge.apps.education.fr/modeles/tutoriels/pyodide-mkdocs-theme-review/)
 
+Si vous voulez supprimer le lien vers le dépôt de votre site en haut à droite : ![lien_depot](docs/assets/images/aller_depot.png){ width=5%}   
+👉 les explications sont ici : [Tutoriel : votre propre contenu](https://docs.forge.apps.education.fr/modeles/tutoriels/pyodide-mkdocs-theme-review/08_tuto_fork/1_fork_projet/#iii-votre-propre-contenu){:target="_blank" }
+
+
+## Noms de groupes
+
+La forge est un espace de liberté pour ses membres. Mais nous souhaitons attirer votre attention sur le choix du nom d'un groupe que vous décideriez de créer pour ensuite l'utiliser en _GitLab Pages_.
+
+Si vous choisissez "Ministère" alors votre application en ligne ou site web personnel sera accessible à l'URL `ministere.forge.apps.education.fr` Cet exemple est caricatural mais vous comprenez aisément que cela puisse poser problème et créer de la confusion. De meme "Troisième", "Mathématiques" ou "Tutoriels" qui pourraient laisser à penser qu'on y retrouvera toutes les ressources de troisième et de mathématiques de la forge, ou des tutoriels concernant l'usage de la forge.
+
+Merci donc de personnaliser et de ne pas utiliser de noms génériques pour vos groupes : soyez le plus précis possible. Par exemple, si votre lycée s'appelle Van Gogh, ne mettez pas seulement vanGogh, mais par exemple lyceeVanGoghErmont (lycée Van Gogh d'Ermont)
+
+Nous vous demandons donc de respecter les règles suivantes :
+
+* Utiliser un nom de groupe qui soit clair et précis, et qui ne soit pas trompeur quant à l'identité ou les objectifs du groupe.
+* Ne pas choisir un nom de groupe qui pourrait créer une confusion avec un autre groupe existant ou qui pourrait nuire à la réputation d'autrui.
+* Les noms de groupe ne doivent en aucun cas contenir des éléments offensants, discriminatoires, ou qui pourraient gêner d'autres utilisateurs.
+* Les noms de groupe trop génériques, tels que "modèles" ou "cours", sont interdits /a priori/ afin de prévenir toute confusion et de maintenir une organisation claire au sein de la plateforme. Ils peuvent toutefois être utilisés, après accord par le comité de suivi (COSUI) s'ils représentent une communauté de contributeurs.
+
+Le [comité de suivi](https://docs.forge.apps.education.fr/apropos.html) se réserve le droit de juger qu'un nom de groupe n'est pas approprié et de vous demander d'en changer. Merci de votre compréhension. Certains groupes aux noms génériques existent et sont liés à l'existence d'une communauté active sur le sujet.
+
+## Les licences
+
+Quelle licence choisir pour mon projet sur la forge ?
+
+Commençons par rappeler que tout projet de LaForgeÉdu est un logiciel **libre** ou une ressource éducative **libre**. Et donc tout projet doit s'accompagner à la racine du dépôt d'un fichier nommé LICENSE explicitant la licence choisie (ex. [celui de MathALEA](https://forge.apps.education.fr/coopmaths/mathalea/-/blob/main/LICENSE)).
+
+- **Si votre projet est un logiciel libre** (i.e. du code) alors il conviendra d'en choisir la licence parmi [cette liste](https://www.data.gouv.fr/fr/pages/legal/licences/) du site data.gouv. Si vous choisissez une licence _permissive_, nous vous suggérons la MIT. Si vous préférez une licence _à réciprocité_ (copyleft), nous vous suggérons la GPLv3. Liens vers le site de l'ANCT pour en savoir plus [sur les licences libres en général](https://licence-libre.incubateur.anct.gouv.fr/) et [sur la distinction importante entre les licences permissives et les licences copyleft](https://licence-libre.incubateur.anct.gouv.fr/licence-libre/le-point-sur-les-licences-libres) en particulier.
+
+- **Si votre projet est une ressource éducative libre** (par ex. du contenu pédagogique sur un site web), il conviendra d'en choisir la licence parmi les différents types de licence Creative Commons. Nous préférons la CC-BY et nous déconseillons d'introduire la clause ND (car l'éducation est en perpétuelle évolution). Pour orienter votre choix, nous vous suggérons ces quatre lectures : le témoignage d'un enseignant [Pourquoi je publie mes travaux sous licence libre](https://ababsurdo.fr/blog/20141119-pourquoi-publier-sous-licence-libre/), ces deux articles issus de blog de la chaire RELIA de l'Unesco [Choisir une licence ouverte, une affaire de goût ou de posture ?](https://chaireunescorelia.univ-nantes.fr/2023/06/14/choisir-une-licence-ouverte-une-affaire-de-gout-ou-de-posture/) et [Comment garantir les deux “R” qui fâchent…](https://chaireunescorelia.univ-nantes.fr/2024/10/30/comment-garantir-les-deux-r-qui-fachent/) ainsi que [La connaissance libre grâce aux licences Creative Commons, ou pourquoi la clause « pas d’utilisation commerciale » ne répond pas (forcément) à vos besoins](https://upload.wikimedia.org/wikipedia/commons/0/0b/WMBE-La_connaissance_libre_gr%C3%A2ce_aux_licences_Creative_Commons.pdf) de Wikimédia Belgique.
\ No newline at end of file

docs/.pages

+nav:
+    - index.md
+    - 01_chapitre_1
+    - 02_chapitre_2
+    - exercice_deux_versions
+    - saisies
+    - python_imbrique
+    - qcm_1
+    - exercices_avec_dessins
+    - avec_SQL
+    - bac_a_sable.md
+    - tags.md
+    - credits
+

docs/01_Chapitre_1/1_chapitre_1.md

----
-author: Votre nom
-title: Python
----
-
-## I. Paragraphe 1 : 
-
-texte 1
-
-### 1. Sous paragraphe 1
-
-Texte 1.1
-
-### 2. Sous paragraphe 2
-
-Texte 1.2
-
-## II. Paragraphe 2 : 
-
-texte 1
-
-### 1. Sous paragraphe 1
-
-Texte 2.1
-
-### 2. Sous paragraphe 2
-
-Texte 2.2

docs/01_Chapitre_1/scripts/addition.py

-def addition(a, b):
-    ...
-
-# tests
-assert addition(2, 3) == 5
-

docs/01_Chapitre_1/scripts/addition_corr.py

-def addition(a, b):
-    return a + b
-

docs/01_Chapitre_1/scripts/addition_test.py

-# Tests
-assert addition(2, 3) == 5
-
-# Autres tests
-assert addition(2458942644, 34894513287656) == 34896972230300
\ No newline at end of file

docs/01_Chapitre_1/scripts/premier_liste.py

-def premier(ma_liste):
-    ...
-
-
-# Tests
-assert premier([8, 4, 6]) == 8
\ No newline at end of file

docs/01_Chapitre_1/scripts/premier_liste_corr.py

-def premier(ma_liste):
-    return ma_liste[0]
-

docs/01_chapitre_1/chapitre_1.md

+---
+author: Votre nom
+title: Chapitre 1
+---
+
+## I. Paragraphe 1 :
+
+texte 1
+
+### 1. Sous paragraphe 1
+
+Texte 1.1
+
+### 2. Sous paragraphe 2
+
+Texte 1.2
+
+## II. Paragraphe 2 : Quelques formules
+
+Utiliser LaTeX
+
+### 1. En maths
+
+Une suite : 
+
+$$
+\begin{cases}
+u_0 = 1 \\
+u_{n+1} = 0,75 u_n + 7 \quad \text{ pour }n \geqslant 0
+\end{cases}  
+$$
+
+Ajouter ses commandes :
+
+$$
+\newcommand{\norm}[1]{\left\lVert#1\right\rVert}
+\norm{\vec{v_C}} = \frac{\sqrt{(x_D - x_C)^2 + (y_D - y_C)^2}}{\Delta t}
+$$
+
+La norme du vecteur ${\vec{u}}$ se note $\norm{\vec{u}}$.
+
+### 2. En chimie
+
+$$
+{CuSO_4}_{(s)}   \rightarrow   {Cu^{2+}}_{(aq)}+ {SO_{4}^{2-}}_{(aq)}
+$$
+
+$$
+^{14}_{6}C  \rightarrow \ ^{14}_{7}N  + \  ^{ 0}_{-1}e^{-}
+$$
+
+On peut tout mettre en ligne : d'abord cette formule ${CuSO_4}_{(s)}   \rightarrow   {Cu^{2+}}_{(aq)}+ {SO_{4}^{2-}}_{(aq)}$ 
+puis celle-ci :  $^{14}_{6}C  \rightarrow \ ^{14}_{7}N  + \  ^{ 0}_{-1}e^{-}$
+
+Autre formule de chimie: 
+
+$$
+\ce{Hg^2+ ->[I-] HgI2 ->[I-] [Hg^{II}I4]^2-}
+$$

docs/02_chapitre_2/.pages

+title: Chapitre 2 - Python
+nav:
+    - 3_liste.md
+    - 2_fonction.md
+

docs/01_Chapitre_1/2_fonction_1.md → docs/02_chapitre_2/2_fonction.md

 ---
 author: Votre nom
-title: Une fonction
+title: Une fonction simple
 tags:
-  - 2-fonction
+  - fonction
 ---
 
-La fonction `addition` prend en paramètres deux nombres entiers ou flottants, et renvoie la somme des deux.
+Compléter la fonction `addition` qui prend en paramètres deux nombres entiers ou flottants, et renvoie la somme des deux.
+
+!!! example "Exemple"
+
+    ```pycon
+    >>> addition(2, 3)
+    5
+    ```
 
 ???+ question "Compléter ci-dessous"
 

docs/01_Chapitre_1/3_liste_1.md → docs/02_chapitre_2/3_liste.md

@@ -2,7 +2,7 @@
 author: Votre nom
 title: Premier élément d'une liste Python
 tags:
-  - 3-liste/tableau
+  - liste/tableau
 ---
 
 La fonction `premier_liste` prend en paramètres une liste Python **non vide** et renvoie le premier élément de cette liste

docs/02_chapitre_2/chapitre_2.md

----
-author: Votre nom
-title: Chapitre 2
----
-
-## I. Paragraphe 1 : 
-
-texte 1
-
-### 1. Sous paragraphe 1
-
-Texte 1.1
-
-### 2. Sous paragraphe 2
-
-Texte 1.2
-
-## II. Paragraphe 2 : 
-
-texte 1
-
-### 1. Sous paragraphe 1
-
-Texte 2.1
-
-### 2. Sous paragraphe 2
-
-Texte 2.2

docs/02_chapitre_2/scripts/addition.py

+# --------- PYODIDE:code --------- #
+
+def addition(a, b):
+    ...
+
+
+# --------- PYODIDE:corr --------- #
+
+def addition(a, b):
+    return a + b
+
+
+# --------- PYODIDE:tests --------- #
+
+assert addition(2, 3) == 5
+
+
+# --------- PYODIDE:secrets --------- #
+
+# Tests secrtets
+assert addition(10, 20) == 30
+
+
+
+
+
+
+
+

docs/01_Chapitre_1/scripts/addition_REM.md → docs/02_chapitre_2/scripts/addition_REM.md

 !!! info "Paramètres"
 
-    Lorsqu'on écrit `addition(a, b)` a et b s'appellent les **paramaètres** de la fonction `addition`
+    Lorsqu'on écrit `addition(a, b)` a et b s'appellent les **paramètres** de la fonction `addition`

docs/01_Chapitre_1/scripts/premier_liste_test.py → docs/02_chapitre_2/scripts/premier_liste.py

-# Tests
+# --------- PYODIDE:code --------- #
+
+def premier(ma_liste):
+    ...
+
+
+# --------- PYODIDE:corr --------- #
+
+def premier(ma_liste):
+    return ma_liste[0]
+
+
+# --------- PYODIDE:tests --------- #
+
 assert premier([8, 4, 6]) == 8
 
-# Autres tests
+
+# --------- PYODIDE:secrets --------- #
+
 assert premier([9, 4, 6, 15]) == 9
 assert premier([200, 4, 6, 15]) == 200