Mentions légales du service

Skip to content
Snippets Groups Projects

Le TP

C'est sur la branche TPworld3 du git que se trouve la séance de travaux pratiques, finalisée dans le notebook <TP.ipynb>. Ce notebook est formé à partir d'un autre notebook, <TP_orginial.ipynb>. Un script Python, <convert_tp.py>, convertit <Tp_orgiginal.ipynb> en <TP_.ipynb> en appliquant plusieurs transformations:

  • Les sections sont automatiquement numérotées et reformatées
  • Dans le TP original, les cellules portent des tags "question", "correction" et "outsider". Le script:
    • Enlève les outsider,
    • Reformatte les questions,
    • Reformatte les liens internes
    • Retire certains outputs
    • Ajoute certaines cellules de titre et de réponse vide
    • Et indique dans les metadata des cellules correction les mentions type:solution et solution2:hidden. Ces dernières informations sont utilisées par le module exercise2 et permet d'avoir un bouton show/hide solution, par défaut caché.

Cette conversion automatique permet des numérotations lors de la conception du TP.

Ça fonctionne pareil pour TP_original_en.ipynb et TP_en.ipynb

Pour rédiger dans TP_orginial

Il faut indiquer avec des tags si la cellule est une question, une correction, un outsider, ou par défaut une celulle inchangée. Une correction doit forcément suivre une cellule exercice. Les questions posées sont écrites au format quote avec un ">" au début de la ligne.

Chaque partie (série de cellules avec question OU séries de cellules de correction) doit commencer par une ligne, puis un vide, puis un titre:

***

# Titre ou sous titre

Les syntaxes pour les titres et sous-titres sont les suivantes:

# Titre 1
# . Titre 2
# .. Titre 3
## Titre 4
### Titre 5

J'ai choisi cette syntaxe pour pouvoir garder des titres assez gros.

Les références intra-notebooks sont reformatées par le script après la numérotation. Pour écrire un lien vers une autre partie du notebook avec le titre Ceci est un titre, écrire `lien vers mon titre.