En panne 😭

Les FAQ

🌵 Si vous rencontrez des problèmes ...

Le rendu n'est pas bon

Vous voyez du code html ou markdown s'afficher.

• Vérifier qu'il n'y a pas d'erreur d'indentation : Il n'en faut pas moins, mais pas plus non plus. Bien regarder les modèles proposés dans ce tutoriel.

• Vérifier qu'une ligne vide nécessaire a bien été mise : avant un tableau, avant une liste à puce ...

Si vous avez écrit du code entre

Markdown

```python
du code python
```

vérifier que vous avez bien mis 3 backticks au début et à la fin.

Après un commit, cela ne passe pas à la coche verte réussi

👉 Attendre, puis rafraichir la page dans votre navigateur.

Le pipeline est en échec

• Pas de panique 😅 ! Il faut commencer par comprendre la cause de l'échec : Echec du pipeline

• Votre site était créé avant le 25/8/2024, et vous avez réalsé un commit après. Une mise à jour est nécessaire : dans le fichier mkdocs.yml vers la ligne 130 :

Remplacer

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

par :

  - search
  - tags:
      tags_file: tags.md

Erreurs fréquentes qui mettent un pipeline en échec

• Un fichier .pages incorrect

Vérifier qu'il n'y a pas d'erreur dans le fichier .pages (suite à des modifications ou suppressions de fichiers par exemple, ou à une faute d'orthographe)

• Vérifier qu'il n'y a pas d'erreur de syntaxe (indentation par exemple) dans le fichier mkdocs.yml

• Un nom de fichier est invalide : Le thème n’autorise plus les caractères accentués, caractères spéciaux, espaces …
  Voir : Mettre à jour les fichiers

👉 Si vous avez rectifié une erreur, après un nouveau commit, le pipeline devrait passer.

L'IDE d'un exercice reste vide, alors que vous avez bien mis un fichier Python

• Si c'est votre premier exercice, attendre, rafraichir la page dans le navigateur, rafraichir l'IDE.

• Vérifier le chemin du fichier devant se trouver dans l'IDE : par exemple, est-il dans un dossier scripts ou pas ?

• Si cela fonctionnait correctement avant et que cette panne survient après un nouveau commit : vider le cache du navigateur.

• Vérifier les paramètres du projet :

👉 Aller sur le dépôt, puis dans Déploiement, puis dans Pages

👉 Il faut décocher "Utiliser un domaine unique"

👉 Ne pas oublier de rafraichir la page du rendu.

Le dépôt semble correct, mais le rendu ne correspond pas

👉 Essayer dans un autre navigateur. Si cela fonctionne bien, vider la mémoire cache de votre navigateur. Vous trouverez facilement en ligne comment procéder.

J'ai créé un répertoire, il a disparu

👉 Si vous avez créé un nouveau répertoire sans y mettre de fichier dedans, il a disparu après le commit. Recommencer l'opération en ajoutant un fichier dedans.

Une page n'apparaît pas dans le menu

👉 Vérifiez que cette page est bien notée dans le fichier .pages dans lequel elle devrait être.

Contact en cas de problème :

Envoyer un message à tutoriels@aeif.fr