Tutoriels et aides pour l'enseignant qui crée son site avec Python intégré

Ce tutoriel

Ce tutoriel est conçu pour vous guider à travers les différentes étapes de la création de votre site web.

Que vous soyez débutant ou que vous ayez déjà quelques notions, ce guide vous accompagnera de manière progressive et détaillée.
Vous y trouverez des explications sur la configuration initiale, la personnalisation du design, l'ajout de contenu pédagogique, et les bonnes pratiques pour maintenir votre site à jour.

Chaque étape est illustrée avec des exemples concrets et des conseils pratiques pour vous aider à réussir votre projet web en toute simplicité.
Tous les exemples sont accompagnés de "code à copier" pour une intégration rapide dans votre site.

👉 Le modèle de site avec des exercices interactifs en Python

Ce tutoriel accompagne le modèle suivant à cloner, pour aider à leur prise en main :

Rendu du site avec pyodide-mkdocs-theme Dépôt du site avec pyodide-mkdocs-theme à cloner

Cliquer pour voir le tutoriel pour un site simple sans exercices intéractifs Python

Tutoriel pour un site simple

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

Un parcours pour construire votre site pas à pas

Parcours pas à pas

Les sites compatibles avec ce tutoriel

Votre site n'est pas forcément compatible avec ce tutoriel

😥 Cliquer pour voir les sites non compatibles

Le contenu de ce tutoriel est inadapté si votre site a été construit à partir de l'ancienne version pyodide et n'a pas été mis à jour.

👉 Faire la mise à jour : MAJ

😊 Cliquer pour voir les sites compatibles

Le contenu de ce tutoriel est adapté si

• votre site a été construit à partir de l'ancienne version pyodide et a été mis à jour avec Pyodide Mkdocs Theme (par exemple ceci visible en bas du site à droite) :

👉 Le numéro de la version de Pyodide MkDocs Theme importe peu.

• ou s'il a été construit en utilisant le site modèle donné en haut de cette page.

👉 Cloner le modèle de site pour le personnaliser

Vous pouvez faire une bifurcation (on dit aussi un «fork») de ces modèles pour réaliser le vôtre.
Le tutoriel pour réaliser cette bifurcation est sur ce site, dans la rubrique "Comment créer un site à partir d'un autre".

Lien direct : Faire une «bifurcation» (fork en anglais)

👉 Si vous débutez et pour comprendre la structure

Il est conseillé de commencer par : Avant de démarrer

En bref

😀 Vous pourrez facilement recopier toutes les syntaxes depuis les différents tutoriels proposés.

👉 Pour avoir des informations détaillées sur le fonctionnement du thème mkdocs permettant de réaliser les sites, voir la Documentation détaillée de pyodide-mkdocs-theme par F. Zinelli

Dernière mise à jour le 27/01/2025