Implémentation du support de l'exportation vers PDF4Teachers (Feature #733)

1. traitement par AMC des questions à choix multiple, et questions ouvertes sur la copie (hors AMC, sans utilisation de \AMCopen)
2. export par AMC de la copie annotée (symboles sur chaque case mais pas les scores des questions), avec un fichier yml à côté qui reprend les notes des questions
3. traitement de ces fichiers par PDF4Teachers, qui permet la correction des questions ouvertes et export final des notes (pour l'enseignant) et copies corrigées (pour les étudiants)

Si c'est bien le cas, je propose une option qui agisse plutôt lors de la fabrication des copies corrigées, pour le pas afficher les scores et l'en-tête mais tout de même les symboles sur les cases, et à la fois produire le fichier yml associé.

Il me semble que j'aurai besoin de précisions concernant le contenu du fichier yml attendu, et éventuellement de cas concrets avec un sujet, des copies, et le fichier yml attendu.

Il faudrait en effet que lors de la génération des copies corrigés, les notes des questions puissent être présente dans un fichier yml à part plutôt que dans la copie PDF.

Cependant, les notes ne sont pas affichés dans le document généré par l'onglet Notation. Il n'y a donc rien à changer au niveau du fichier PDF exporté, si ce n'est qu'il faudrait pouvoir générer un document PDF par élève et non pas une page par élève.

Il faudrait donc ajouter dans la section Export des notes une option "Édition PDF4Teachers", qui génèrerait un seul fichier yml qui contiendrait toutes les éditions.
La version 1.2.1 de PDF4Teachers qui devrait bientôt sortir, proposera en effet une méthode d'import et d'export d'éditions et il sera possible d'importer plusieurs éditions contenues dans un même fichier yml.

À propos des éditions :

Les éditions de PDF4Teachers sont enregistrés au format YAML. Elles ont à la racine les propriétés texts et grades. Ici seul grades va nous être utile.
Puisque toutes les éditions seront dans le même fichier yaml, les propriétés à la racine seront le nom du fichier PDF de l'élève et on retrouvera grades à l’intérieur (deux espaces avant le mot grades: pour marquer qu'il est à l'intèrieur).

Les noms de fichier dans l'édition YAML doivent correspondre exactement au fichier PDF généré

Exemple :

élève no1.pdf:
  grades:
  - [...]
  - [...]
élève no2.pdf:
  grades:
  - [...]
  - [...]
élève no3.pdf:
  grades:
  - [...]
  - [...]

Dans la section grades :

grades contient une liste YAML. On utilise donc des tirets alignés avec le mot grades: (donc toujours deux espaces avant).
Il y a différentes manières de représenter les donnés de chaque élément de la liste en YAML. Vous pouvez utilisez la méthode en ligne : les propriétés sont entre accolades et séparés par des virgules. le : sépare le mot clef de la valeur.
Chaque élément de la liste représente une note visible.

Voici un exemple :

élève no1.pdf:
  grades:
  - {x: 600, y: 574, page: 0, index: 0, parentPath: '', value: 14, total: 20, name: Total}
  - {x: 165, y: 138, page: 0, index: 0, parentPath: \Total, value: 14, total: 20, name: QCM AMC}
  - {x: 165, y: 400, page: 1, index: 0, parentPath: \Total\QCM AMC, value: 4, total: 5, name: Question 1}
  - {x: 165, y: 539, page: 2, index: 1, parentPath: \Total\QCM AMC, value: 2, total: 5, name: Question 2}
  - {x: 165, y: 138, page: 2, index: 2, parentPath: \Total\QCM AMC, value: 3, total: 5, name: Question 3}
  - {x: 165, y: 138, page: 3, index: 3, parentPath: \Total\QCM AMC, value: 5, total: 5, name: Question 4}

Sens des propriétés :

x : coordonné x du point supérieure gauche de la note sur une échelle de 0 à 1654 (nombre entier)
y : coordonné y du point supérieure gauche de la note sur une échelle de 0 à 2339 (nombre entier)
page : numéro de la page de la note (commence à 0)

Les barèmes de PDF4Teachers fonctionnent de manière hiérarchique. Chaque note peut avoir un parent, et il y a un ordre précis. Il faut donc toujours écrire les éléments de la liste dans l'ordre (d'abord le Total, après son premier enfant, les enfants de son premier enfant, puis le second enfant du total etc.).

index: l'indice de la note parmi les autres notes enfants du même parent. l'indice commence toujours à 0 pour le premier enfant, puis augmente. Lorsque une note n'est plus enfant du même parent, on reprend à 0 si c'est la première note, et sinon, on reprend de là ou on en était.
parentPath: Le chemin de la note parente. Chacun des noms des notes parentes sont ajoutés etséparés par un \. le Total a un parentPath qui est vide ('') car il n'a pas de parent. Les autres notes autont \Total ou même \Total\A) si la note est enfant d'un grand A).

value : la valeur de la note. pour un 6/10, value est égal à 6
total : la valeur maximale de la note. pour un 6/10, total est égal à 10
name : le nom visible de la note

Pour les chaines de caractère, il est possible de les afficher sans guillemets, mais si elles contiennent des caractères clés, il faut utiliser des guillemets ou des caractères d’échappement.

Vous retrouverez un exemple en pièce jointe.

Globalement, ce que vous devrez générer ressemblera à l'exemple montré plus haut, avec le Total, un parent nommé QCM AMC, puis tous ses enfants avec un enfant par question du QCM

élève no1.pdf:
  grades:
  - {x: 600, y: 574, page: 0, index: 0, parentPath: '', value: 14, total: 20, name: Total}
  - {x: 165, y: 138, page: 0, index: 0, parentPath: \Total, value: 14, total: 20, name: QCM AMC}
  - {x: 165, y: 400, page: 1, index: 0, parentPath: \Total\QCM AMC, value: 4, total: 5, name: Question 1}
  - {x: 165, y: 539, page: 2, index: 1, parentPath: \Total\QCM AMC, value: 2, total: 5, name: Question 2}
  - {x: 165, y: 138, page: 2, index: 2, parentPath: \Total\QCM AMC, value: 3, total: 5, name: Question 3}
  - {x: 165, y: 138, page: 3, index: 3, parentPath: \Total\QCM AMC, value: 5, total: 5, name: Question 4}