début de mise à jour de la liste des champs

docs/ApiGenerationBulletinsPdf.md

@@ -1,22 +1,26 @@
-#  Générer des bulletins en Python
+# Génération des bulletins en Python
 
-Il est possible de coder de nouveaux styles de bulletins de notes (web et/ou
-PDF), pour répondre précisément aux besoins de votre établissement.
+Informations internes à destination des développeurs.
 
-Ce n'est pas très difficile, mais il faudra coder en langage Python avec pour le
-PDF la bibliothèque ReportLab (qui est bien documentée, [voir le
-guide](http://www.reportlab.com/software/opensource/rl-toolkit/guide/)).
+## Types de bulletins
 
-ScoDoc demande la création d'un bulletin pour un étudiant donné dans semestre
-donné (`formsemestre_id`). Le bulletin doit être rendu sous forme d'une liste
-d'objets PLATYPUS (voir le chapitre 5 du "User Guide" de ReportLab cité plus
-haut).
+- Formations classiques
+  - HTML, court, intermédiaire, long
+  - XML (deprecated)
+  - JSON
+  - PDF
+- Formations BUT
+  - JSON (utilisé par la version HTML)
+  - XML (partiel, deprecated)
+  - PDF
+  - "but court" HTML
+  - "but court" PDF
 
-<img src="/img/alert.png" style="vertical-align: bottom; margin:0 0 0 0;"
-alt="/!\" /> Attention (août 2011): nouvelle version, changement d'API: les
-informations ci-dessous s'appliquent à partir de la subversion 1047.
+## Balises décisions de jury pour chaque type
 
-##  Organisation
+
+
+## Organisation
 
 A minima, il vous faut créer un module python (fichier .py) qui se définira une
 classe chargée de générer vos bulletins.
@@ -193,7 +197,6 @@ Type | Nom | Description | Exemple de valeur
  | decision | Décision du jury d'admission | 'ADMIS'
  | description | Comment l'étudiant a été inscrit | '(creation individuelle)'
 
-
 #### Inscription
 
  Type | Nom | Description | Exemple de valeur
@@ -220,7 +223,8 @@ Type | Nom | Description | Exemple de valeur
   string  | refcomp_specialite     | code spécialité   | "RT"
   string  | refcomp_specialite_long| spécialité        | "Réseaux et Télécommunications"
 
-###  Résultats (notes) de l'étudiant dans le semestre 
+### Résultats (notes) de l'étudiant dans le semestre
+
 Quelques infos sur les résultats. Le détail des notes est dans la
 liste `infos['ues']` et ses sous-listes imbriquées (modules, evaluation).