Rédiger l'énoncé de l'exercice

Pour que l'exercice soit utilisable sur INGINnious, il faut aussi rédiger l'énoncé. Les énoncés des tâches sur INGInious se font dans un fichier .yaml. Le YAML est un langage simple permettant de formater du texte ce qui permet par après de le parser facilement. Nous vous fournissons un template du fichier .yaml que vous devrez juste remplir avec l'énoncé de la tâche. Ce fichier est diponible ICI et devra absolument se nommer task.yaml pour que INGInious l'exécute.

Voici comment le modifier:

• Écrivez votre nom derrière la balise author

• Écrivez le nom de la tâche entre simples guillements ( ' ) derrière la balise name

• Écrivez l'énoncé de l'exercice sous la balise context. N'oubliez pas d'indenter tout votre texte par rapport à la balise.

• Sous la balise problems, écrivez une nouvelle balise q1 qui corresond à votre sous-question, indentée par rapport à la balise problems

• Sous la balise q1, complétez les balises nécessaires (name correspond au titre de la sous-question, header à un court énoncé de celle-ci).

• Inutile de toucher aux autres balises.

• Le texte de l'énoncé de l'exercice (sous la balise context) est écrit en langage reStructuredText (rst) :

  "::" permet d'afficher un bloc de code. Le code doit être séparé de "::" par une ligne vide et être indenté par rapport à "::", comme ceci:

  :: 
    
     ceci sera écrit
     sous forme de code
  
  mais ceci ne le sera plus
  

  ".. code-block:: java" correspond à "::" mais avec la précision qu'il doit le mettre en couleur en fonction de la syntaxe java. Exemple d'utilisation:

  .. code-block:: java
    
     ceci sera écrit
     sous forme de code en java
  
  mais ceci ne le sera plus
  

En ce qui concerne le template que l'on vous fournit, vous pouvez voir ce qu'il donne une fois lu par INGInious à cette adresse.

Notez enfin que vous pouvez également proposer sur INGInious des questions à choix multiples (QCMs). La formule QCM est avantageuse lorsque que vous voudrez faire réaliser à l'apprenant un exercice de façon rapide en minimisant son effort de rédaction afin de tester l'acquisition de connaissances simples. Nous vous fournissons un template de fichier .yaml pour la rédaction de QCMs disponible ici.