Admin
Le rapport n'est pas le seul document à produire, des petits documents sont à produire avant le début du TB et vers la fin.
Énoncé pour GAPS
Si tu propose toi même ton sujet, une fois qu'un·e prof est trouvé·e, tu devras probablement rédiger un premier énoncé pour GAPS. Cette énoncé pourra aussi servir de base au cahier des charges à terminer au début du TB.
Je conseille de trouver un prof qui est partant pour ton projet avant la soirée Forum Etudiants/Professeurs (les profs qui sont tous à la cafétéria pour discuter des sujets de TBs proposés). Pour donner une idée du timing, la soirée a été organisée le mardi 18 novembre 2025 et mardi 19 novembre 2024.
TODO: pointer vers exemples de énoncé.
Rendu sur GAPS
Cette étape est faite par les enseignant·es qui peuvent rentrer du texte brut ou du HTML (en 2025),
Pour exporter votre Markdown en HTML, beaucoup d'outils existent, et pandoc fonctione aussi pour ce besoin.
pandoc cdc.md -o cdc.html
Le HTML n'est pas supporté pleinement, une partie des balises sont retirées (probablement pour éviter des attaques XSS), donc si vous incluez des morceaux de code inline ou block (simple ou triple backticks), qui génère des balises <pre></pre> et <code></code> elles seront retirées...
Bon au pire ça s'affiche juste mal et tant pis, le problème n'est pas très grave, puisque ce texte n'est affiché que sur GAPS donc uniquement pour un usage interne administratif.
Détails du bug
Exemple avec ce morceau de HTML, le rendu HTMl local est fonctionnel, la balise <pre> permet d'afficher les retours à la ligne et la police monospace.
<p>Voici un exemple préliminaire de la syntaxe DY qui permettra de décrire un exercice de programmation dans PLX. Elle contient 2 checks pour vérifier le comportement attendu. Le premier cas décrit un check de succès et le deuxième cas décrit une situation d'erreur.</p>
<pre style="background-color:#f2f2f2; padding: 0px 10px;"><code>
<span>exo Just greet me</span>
<span> </span>
<span>checks </span>
<span>name Can enter the full name and be greeted </span>
<span>see What is your firstname ? </span>
<span>type John </span>
<span>see Hello John, what's your lastname ? </span>
<span>type Doe </span>
<span>see Have a nice day John Doe ! </span>
<span>exit 0 </span>
<span> </span>
<span>name Stops if the name contains number </span>
<span>see What is your firstname ? </span>
<span>type Alice23 </span>
<span>see Firstname cannot contain digits. </span>
<span>exit 1 </span>
</code></pre>
Mais une fois rendu sur GAPS, malheureusement les balises <pre> semblent être remplacée par <p>, les balises <code> sont retirées et les retours à la ligne sont retirés aussi.
Comme je n'ai pas accès à changer ce contenu, je ne peux pas tester et je ne sais pas comment le problème pourrait être corrigé. Est-ce que les <br> ne sont pas retirés ? On espère que ce genre de filtrage sera amélioré un jour...
Le cahier des charges
Si tu as besoin de convertir un format vers un autre, il est possible que pandoc puisse aider à faire le gros du travail de conversion.
Par exemple si ton cahier des charges est en Word et que tu veux une version Markdown pour ton repos Git ou une version Typst pour l'inclure dans le rapport.
# fichier d'entrée cdc.docx et fichier de sortie (-o = output) cdc.md
# ainsi le format de sortie est détecté avec l'extension
pandoc cdc.docx -o cdc.md
# ou pour générer une version Typst
pandoc cdc.docx -o cdc.typ
Le rendu sur GAPS du cahier des charges a les mêmes problèmes de contenu filtré que précédemment expliqué sur l'énoncé pour GAPS. (Très probable même si je n'ai pu tester).
L'affiche
TODO
Le résumé publiable
TODO