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

• Vérifier si vous ne devez pas réaliser une mise à jour : Mise à jour

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.

Un lien devant s'ouvrir dans une nouvelle fenêtre s'affiche mal

👉 Vérifier si dans le texte qui précède ou suit le lien (sans saut de ligne le séparant du lien), ne se trouve pas le caractère _. Si c'est le cas, vous pouvez :

• soit supprimer ce caractère (ne pas écrire en italique par exemple, ou utiliser ** pour écrire en gras)
• soit ajouter une ligne vide pour séparer du lien.

Voir Description du bug à la fin du 1.

Le téléchargement d'un fichier python mis sur le site ne fonctionne pas

👉 Il faut modifier le fichier mkdocs.yml.

Voir le point 3. pour les fichiers Python

Un fichier pdf qui doit s'afficher directement sur le site dans un iframe ne s'affiche pas

👉 Vérifier le lien donné : Au début du II : Attention aux liens.
La solution est peut-être d'ajouter ../ au début du lien.

Une ou des images entre des balises <center> et </center> ne s'affichent pas

👉 Pour une seule image, utiliser l'option .center comme par exemple : ![Mon image](mon_image.png){.center .autolight width=50%}

👉 Pour plusieurs images accolées, utiliser les balises <center markdown> et </center>. Voir les explications ici : Fin du I.4. Insérer une image

Le rendu d'un QCM sur tablette ou smartphone n'est pas correct

👉 Si des images sont utilisées, vérifier la présence de l'option donnant leur taille comme par exemple { width=50% } : QCM

Contact en cas de problème :

Envoyer un message à tutoriels@aeif.fr