révision / mise en forme

docs/AdminUsers.md

@@ -217,4 +217,4 @@ Pour la signification des rôles et l'utilisation du département, voir
     - [Guide administrateur ScoDoc](GuideAdminSys.md)
     - [Configuration des envois d'emails](ConfigEmail.md)
     - [FAQ](FAQ.md)
-    - [Contacts](Contact.md).
+    - [Contacts](Contact.md)

docs/BUT.md

@@ -324,4 +324,12 @@ de décisions ad-hoc (compensations plus simples, moins de cas de mise en attent
   - Règles de compensation au sein de chaque niveau, pour validation de l'année. 
 
 
+!!! note "Voir aussi"
+
+    - [Guide utilisateur](GuideUtilisateur.md)
+    - [Guide du responsable de formation](GuideAdminFormation.md)
+    - [Tutoriels vidéo](https://www.youtube.com/channel/UCb0JYCBRi0CsE4XFp4ByhXg)
+    - [FAQ](FAQ.md)
+    - [Contacts](Contact.md)
+
 

docs/CalculNotes.md

@@ -1,14 +1,13 @@
 
-##  Calcul des notes 
+# Calcul des notes
 
 *Tout ce que vous avez toujours voulu savoir sur le calcul des moyennes...*
 
-**Attention :** Les informations ci-dessous s'appliquent aux formations traditionnelles. 
+Pour les formations par compétences, voir aussi [la page dédiée au BUT](BUT.md).
-Pour les formations par compétences, voir [la page dédiée au BUT](BUT.md).
 
-###  En résumé: 
+## En résumé
 
-A chaque instant, ScoDoc prend en compte les notes des évaluations "complètes"
+À chaque instant, ScoDoc prend en compte les notes des évaluations "complètes"
 (dans lesquelles toutes les notes ont été saisies ou bien signalées "en attente"
 avec le code ATT. Les évaluations partiellement saisies ne sont pas prises en
 compte, sauf si l'option "*prise en compte immédiate*" a été cochée sur
@@ -21,11 +20,9 @@ Les moyennes d'UE et générale sont calculées à partir des moyennes de module
 en utilisant les coefficients du programme pédagogique (dénommé dans ScoDoc
 "formation").
 
-
 Plus de détails ci-dessous.
 
-
+## Calcul des moyennes de modules
-###  Calcul des moyennes de modules 
 
 Chaque évaluation produit des notes de différents types:
 
@@ -41,21 +38,32 @@ Chaque étudiant a donc un nombre variable de notes à prendre en compte dans
 chaque module. Chaque note est associée à un coefficient: le coefficient de
 l'évaluation dans le module.
 
+### En formation classique (hors approches par compétences, BUT)
+
 La moyenne de module est la somme pondérée par le coefficient des évaluations
 des notes aux évaluations prises en compte, sauf si on a défini une formule
 spécifique.
 
+### En BUT
 
-####  Formules de calcul spéciales 
+Comme expliqué en détail sur [la page dédiée au BUT](BUT.md), chaque module
+(ressource ou SAÉ) peut produire des notes différentes pour chaque UE. Le
+programme pédagogique (adapté du Programme National publié au BO) défini des
+coefficients permettant le calcul des moyennes d'UE.
 
-Il est possible de définir des formules de calcul spéciales pour calculer les
+De façon plus fine, chaque évaluation peut s'adresser à un sous-ensemble
-moyennes. Ces formules sont alors utilisées par ScoDoc à la place de la moyenne
+d'apprentissages critiques, et donc être associée à une ou plusieurs UE avec des
-pondérée standard. Voir
+pondérations différentes: les poids de l'évaluation.
-[FormulesCalculUtilisateur](FormulesCalculUtilisateur.md) 
-pour plus d'informations.
 
+On a donc **pour chaque évaluation**:
 
-###  Moyennes d'UE 
+- des poids, un par UE, qui sont par défaut égaux à 1 pour les UE concernées
+  (c'est à dire ayant un coefficient non nul);
+- un coefficient.
+
+Le calcul de la moyenne du module vers les UEs s'effectue en *multipliant* les poids par le coefficient.
+
+## Moyennes d'UE
 
 moyenne_ue = moyenne pondérée des moyennes de modules de l'UE (- malus)
 
@@ -66,18 +74,9 @@ Le malus appliqué à la moyenne d'UE est donné par la somme des notes du ou de
 modules de malus de cette UE (un type spécial de modules, voir
 [ModulesMalus](ModulesMalus.md)).
 
-Comme pour le calcul des moyennes de modules, il est possible de définir une
+## Calcul de la moyenne générale
-formule ad-hoc pour le calcul de la moyenne d'UE (cela est toutefois rarement
-nécessaire, et il est recommandé de ne pas abuser de cette fonctionnalité: la
-présence de formules ralentit considérablement les calculs).
-La syntaxe et les variables sont les mêmes que pour les modules; ici, le vecteur
-de notes est celui des moyennes de modules (et non des évaluations). Voir
-[FormulesCalculUtilisateur](FormulesCalculUtilisateur.md).
 
-La présence de formules d'UE est signalée sur le tableau de bord du semestre.
+### En formations classiques
-
-
-###  Calcul de la moyenne générale 
 
 moyenne = moyenne pondérée des moyennes d'UE + bonus sport/culture
 
@@ -98,8 +97,14 @@ Les modules des UEs de type "Sport & Culture" ne sont évidemment pas pris en
 compte dans la moyenne pondérée: ils sont utilisés pour calculer le bonus, comme
 expliqué ci-dessous.
 
+### Moyenne générale en BUT
 
-###  Notes de rattrapage 
+En BUT, on calcule des notes pour les Unités d'Enseignement, et la moyenne
+générale n'est pas définie. Toutefois, ScoDoc calcule une *moyenne indicative*,
+qui est la moyenne des moyennes des UE du semestre pondérée par leurs ECTS. Voir
+détails [sur la page BUT](BUT.md#moyenne-generale)
+
+## Notes de rattrapage
 
 Dans chaque module, il est possible de définir une évaluation de "rattrapage".
 Lors de la création (ou modification) de l'évaluation, indiquer le type
@@ -110,9 +115,7 @@ Lors de la création (ou modification) de l'évaluation, indiquer le type
 Pour chaque étudiant, la note obtenue à l'évaluation de rattrapage remplace la
 moyenne du module, seulement si elle est supérieure à celle-ci.
 
-
+## Bonus sport/culture
-
-###  Bonus sport/culture 
 
 Ce bonus s'applique directement sur la **moyenne générale** et/ou sur les
 moyennes d'UE (notamment en BUT).
@@ -137,3 +140,44 @@ vous souhaitez disposer d'une nouvelle règle, il faut contacter l'équipe de
 développement en indiquant (en français) le règlement en vigueur dans votre
 établissement. Le code correspondant sera ajouté via une mise à jour.
 
+## Arrondis et affichages
+
+ScoDoc calcule les notes en haute précision. On peut saisir des notes comme
+`12,3456789 / 20` (convenons que c'est un peu ridicule, mais possible).
+
+Les résultats sont en général affichés avec 4 chiffres (12,34/20), soit 1 millième de précision.
+Le nombre de chiffres exportés vers Apogée (dans des fichiers textes) est paramétrable.
+Les exports vers Excel conservent la précision maximale (types numériques).
+
+Les décisions prises par ScoDoc (`ADM` automatique par exemple) sont calculées
+avec une *tolérance* pour éviter que les étudiants ne soient victimes d'erreurs
+d'arrondis: par exemple:
+
+```text
+Pour valider une RCUE, on vérifie que moy_rcue > sco_codes.BUT_RCUE_SUFFISANT
+
+où est défini comme BUT_RCUE_SUFFISANT = 8.0 - NOTES_TOLERANCE.
+
+avec 
+NOTES_TOLERANCE = 0.00499999999999
+```
+
+Donc un étudiant avec 7.996 (affichée `08.00` dans les tableaux) validera mais un autre avec 7.995 (affichée `07.99`) ne validera pas.
+
+⚠️ Attention: il y a deux façon d'exporter vers Excel:
+
+1- l'une est fournie par le navigateur (javascript) et part de la version
+affichée. C'est commode et conserve la mise en forme du tableau affiché, mais on
+n'a pas toute la précision.
+
+2- la seconde est exportée par ScoDoc qui veille à conserver le maximum d'information.
+
+![menu export excel](fig/menu-export-excel.png)
+
+
+!!! note "Voir aussi"
+
+    - [Guide utilisateur](GuideUtilisateur.md)
+    - [Calculs spécifiques en BUT](BUT.md)
+    - [FAQ](FAQ.md)
+    - [Contacts](Contact.md)

docs/CompensationSemestre.md

@@ -1,17 +1,26 @@
 
-##  Compensation des semestres 
+# Compensation des semestres DUT
-L'[arrêté du 3 août 2005](http://www.education.gouv.fr/bo/2005/31/MENS0501754A.htm) définit les modalités des parcours de DUT.
 
-L'article 20 (b) stipule "*Lorsque les conditions posées ci-dessus ne sont pas remplies, la
+L'[arrêté du 3 août
-validation est assurée, sauf opposition de l'étudiant, par une
+2005](http://www.education.gouv.fr/bo/2005/31/MENS0501754A.htm) définit les
-compensation organisée entre deux semestres consécutifs sur la base
+modalités des parcours de DUT.
-d'une moyenne générale égale ou supérieure à 10 sur 20 et d'une
+
-moyenne égale ou supérieure à 8 sur 20 dans chacune des unités
+L'article 20 (b) stipule "*Lorsque les conditions posées ci-dessus ne sont pas
-d'enseignement constitutives de ces semestres. Le semestre servant à
+remplies, la validation est assurée, sauf opposition de l'étudiant, par une
-compenser ne peut être utilisé qu'une fois au cours du cursus.*".
+compensation organisée entre deux semestres consécutifs sur la base d'une
+moyenne générale égale ou supérieure à 10 sur 20 et d'une moyenne égale ou
+supérieure à 8 sur 20 dans chacune des unités d'enseignement constitutives de
+ces semestres. Le semestre servant à compenser ne peut être utilisé qu'une fois
+au cours du cursus.*".
 
 
-ScoDoc propose automatiquement la compensation du semestre *n+1* avec le semestre *n* lorsque c'est possible: le code décision est alors ADC, et on mémorise que le semestre *n* a été utilisé pour compenser.
+ScoDoc propose automatiquement la compensation du semestre *n+1* avec le
+semestre *n* lorsque c'est possible: le code décision est alors ADC, et on
+mémorise que le semestre *n* a été utilisé pour compenser.
 
-<img src="/img/alert.png" style="vertical-align: bottom; margin:0 0 0 0;" alt="/!\" /> cette possibilité n'est offerte que lorsque l'option "*proposer compensations de semestres (parcours DUT)*" (menu "*Modifier le semestre*") est activée (en effet, la règle de compensation est spécifique aux DUT et ne s'applique pas à toutes les formations LMD).
+<img src="/img/alert.png" style="vertical-align: bottom; margin:0 0 0 0;"
+alt="/!\" /> cette possibilité n'est offerte que lorsque l'option "*proposer
+compensations de semestres (parcours DUT)*" (menu "*Modifier le semestre*") est
+activée (en effet, la règle de compensation est spécifique aux DUT et ne
+s'applique pas à toutes les formations LMD).
 

docs/ConfigCAS.md

@@ -146,6 +146,16 @@ Exemples:
 INFO: CAS login denied for  cas_id=prenom.nom (unknown or inactive)
 ```
 
+## Accès via l'API
+
+L'authentification des clients de l'API utilise un jeton (*token*), qui est
+demandé par l'appel `/ScoDoc/api/tokens` (qui lui même appelle
+`User.get_token()`). Ce mécanisme ne passe jamais par le CAS, à condition que le
+compte utilisateur utilisé par l'API soit "*Autorisé à se connecter via ScoDoc*"
+(voir le formulaire plus haut, [configuration des
+utilisateurs](#configuration-des-utilisateurs)). 
+
+
 !!! note "Voir aussi"
 
     - [Gestion des utilisateurs](AdminUsers.md)
@@ -154,4 +164,4 @@ INFO: CAS login denied for  cas_id=prenom.nom (unknown or inactive)
     - [Guide administrateur ScoDoc](GuideAdminSys.md)
     - [API pour ScoDoc 9](ScoDoc9API.md)
     - [FAQ](FAQ.md)
-    - [Contacts](Contact.md).
+    - [Contacts](Contact.md)

docs/ConfigPermissionsDept.md

@@ -70,4 +70,4 @@ Peuvent saisir des notes dans une évaluation située dans un module:
     - [Config. des rôles et permissions en ligne de commande](GuideConfig.md#creation-dun-nouveau-role)
     - [Guide administrateur ScoDoc](GuideAdminSys.md)
     - [FAQ](FAQ.md)
-    - [Contacts](Contact.md).
+    - [Contacts](Contact.md)

docs/Contribuer.md

@@ -5,8 +5,8 @@ peut aider, en améliorant la documentation (page, vidéos), en rejoignant le
 serveur Discord (voir [contacts](Contact.md)) pour y aider les
 collègues, ou en développant ou testant le logiciel.
 
-Les canaux de communication entre développeurs sont [indiqués sur cette
+Les canaux de communication entre développeurs sont
-page](Contact.md). Vous pouvez demander un compte sur le [git du
+[indiqués sur cette page](Contact.md). Vous pouvez demander un compte sur le [git du
  projet](https://scodoc.org/git), consulter/ajouter des tickets, proposer votre
 code (*pull requests*).
 
@@ -19,7 +19,7 @@ La documentation est constituée de deux parties:
   Proposez de nouvelles vidéos, c'est très facile à faire !
 
 - Les pages Web comme celle que vous lisez actuellement. La documentation est
-  générée via `MkDocs, un système très simple basé sur le format
+  générée via `MkDocs`, un système très simple basé sur le format
   [Markdown](https://www.markdownguide.org/basic-syntax/). Toutes les sources
   sont sur le [dépôt git DocScoDoc](https://scodoc.org/git/viennet/DocScoDoc).
 
@@ -27,3 +27,11 @@ La documentation est constituée de deux parties:
 
 Le [dépôt principal](https://scodoc.org/git/viennet/ScoDoc) comporte plusieurs
 branches. Voir le [guide pour les développeurs](GuideDeveloppeurs.md).
+
+
+!!! note "Voir aussi"
+
+    - [Guide développeurs](GuideDeveloppeurs.md)
+    - [Guide administrateur ScoDoc](GuideAdminSys.md)
+    - [FAQ](FAQ.md)
+    - [Contacts](Contact.md)

docs/FAQ.md

@@ -38,8 +38,8 @@ affichage sur leur ENT en général, cet affichage pouvant être désactivé dep
 ScoDoc pour un semestre particulier). A défaut, il faut leur envoyer leurs
 bulletins par mail.
 
-
 ###  Comment supprimer une évaluation ?
+
 1. Supprimer toutes les notes saisies dans cette évaluation, s'il y en a: passer
    par la page "Saisie des notes" et suivre le lien "Effacer toutes les notes de
    cette évaluation".
@@ -49,6 +49,7 @@ bulletins par mail.
 
 
 ### En IUT, comment gérer les licences professionnelles ?
+
 * On peut créer un département regroupant les licences, ou bien rattacher
 chaque licence à un département existant. Cette dernière solution est
 préférable si des étudiants de DUT poursuivent en licence (ainsi, on a
@@ -59,7 +60,8 @@ bulletins par mail.
 l'option "*Semestre dans la formation*" (page "*modification du semestre*").
 
 ### Comment gérer les étudiants les démissionnaires ?
- * Sur la fiche d'un étudiant, on peut choisir plusieurs options:
+
+Sur la fiche d'un étudiant, on peut choisir plusieurs options:
 
 * *Supprimer cet étudiant* : il sera totalement supprimé de la base, sans
   remède. Cette option n'est en principe jamais utile, sauf pour corriger
@@ -80,10 +82,12 @@ bulletins par mail.
   inscrits).
 
 ### Mes données sont erronées, que faire ?
+
 En cas de problème (bug, erreur de manipulation, suspicion de piratage),
 différents journaux peuvent être consultés.
 
 Les utilisateurs autorisés peuvent facilement voir:
+
 * les opérations effectuées sur un étudiant (inscriptions, saisies d'absences,
    ...), accessibles via le menu "Etudiant" / "Voir le journal..." en haut de sa
    fiche individuelle.
@@ -93,24 +97,25 @@ Les utilisateurs autorisés peuvent facilement voir:
   l'identité de l'utilisateur ayant effectué la saisie).
 
 Les administrateurs (informaticiens) peuvent aussi consulter les journaux (logs)
-du serveur, voir plus loin.s
+du serveur, voir ["où sont les journaux"](#ou-sont-les-journaux-logs).
 
 ### Comment signaler un problème ?
+
 Nous vous remercions de nous signaler tous les problèmes que vous rencontrez:
 erreurs, comportement bizarre ou malcommode. Nous ne promettons pas de les
 régler rapidement, ni même plus tard: le logiciel est fourni sans aucune
 garantie. Mais nous faisons de notre mieux:
 
- - si vous êtes utilisateurs, écrire à
+* si vous êtes utilisateurs, écrire à
  [notes@listes.univ-paris13.fr](mailto:notes@listes.univ-paris13.fr).
  ou joindre le canal Discord Assistance.
 
- - si vous êtes informaticien et voulez évoquer un problème technique
+* si vous êtes informaticien et voulez évoquer un problème technique
  (développement, installation), écrire à
  [scodoc-devel@listes.univ-paris13.fr](mailto:scodoc-devel@listes.univ-paris13.fr).
 
-
 ## Configuration
+
 ### Comment changer les logos sur les documents PDF (PV...)
 
 Il faut avoir un compte (web) administrateur sur ScoDoc, et passer
@@ -120,6 +125,7 @@ Voir [la page sur la gestion des logos et images ](GestionLogos.md).
 ### Administration
 
 ### Quel système d'exploitation ?
+
 ScoDoc est accessible depuis n'importe quel navigateur Web (Firefox, Chrome, ...).
 
 Le serveur ScoDoc fonctionne sous Linux. Il n'est testé qu'avec Debian (stable).
@@ -127,8 +133,8 @@ Le script d'installation ([GuideInstallDebian11](GuideInstallDebian11.md))
 assure l'installation de tout les éléments nécessaires au bon fonctionnement de
 ScoDoc.
 
-
 ### Quand et comment mettre à jour le logiciel ?
+
 Les mises à jour sont normalement automatiquement appliquées chaque nuit,
 assurant la sécurité et l'actualisation de ScoDoc.
 
@@ -138,25 +144,25 @@ importantes sont annoncées sur la liste de diffusion
 
 Voir aussi la page [MisesAJour](MisesAJour.md).
 
-
-
 ### Quelles sauvegardes des données ?
-Voir [SauvegardesBases](SauvegardesBases.md).
 
+Voir [SauvegardesBases](SauvegardesBases.md).
 
 ### Où sont les journaux (logs) ?
 
 Les administrateurs du serveur peuvent consulter:
+
 * Le journal du serveur Web (nginx)
-```
+
+```text
 /var/log/nginx/scodoc*.log
 ```
 
 * le fichier `/opt/scodoc-data/log/scodoc.log` reçoit des messages de déboggage
  de ScoDoc.
 
-
 ### J'ai installé ScoDoc mais je n'ai pas de certificat SSL !
+
 Il est de plus en plus important d'installer un certificat SSL; les navigateurs
 Web sont de plus en plus méfiants et vos utilisateurs seront très gênés si votre
 ScoDoc n'a pas de certificat valide. Si votre établissement (par exemple via
@@ -168,17 +174,18 @@ Pour vos tests en local, avec Chrome, modifier le paramétrage en réglant:
 `chrome://flags/#allow-insecure-localhost` (et/ou taper "thisisunsafe" sur la
 page bloquée).
 
-
-
 ### Comment supprimer un département ?
-Voir les commandes d'administration dans [GuideConfig](GuideConfig.md)
 
+Voir les commandes d'administration dans [GuideConfig](GuideConfig.md)
 
 ### Comment contribuer au projet ?
 
-[Voir la page](Contribuer.md).
+[Voir la page "contribuer"](Contribuer.md).
 
 !!! note "Voir aussi"
 
-    - [Contacts](Contact.md).
+    - [Guide administrateur ScoDoc](GuideAdminSys.md)
+    - [Guide du responsable de formation](GuideAdminFormation.md)
+    - [Guide utilisateur](GuideUtilisateur.md)
+    - [Contacts](Contact.md)
     - <a href="https://www.youtube.com/playlist?list=PLw49h6RbvswhasBk9bXj7PzOD8GDW3kG1" target="_blank">Tutoriels sur YouTube <img src="/img/tube.png" alt="" style="margin-top:0px; margin-bottom:0px; border-width:0px;"/></a>

docs/FormulesCalculUtilisateur.md

@@ -1,4 +1,4 @@
-# Obsolète, non disponible en ScoDoc 9.
+# Obsolète, non disponible en ScoDoc 9
 
 <img src="/img/alert.png" style="vertical-align: bottom; margin:0 0 0 0;"
 alt="/!\" /> **Les formules utilisateurs, disponibles à titre expérimental en
@@ -7,33 +7,50 @@ posaient maints problèmes de performance et de maintenance, et ne sont plus
 utilisées en ScoDoc 9.** <img src="/img/alert.png" style="vertical-align: bottom; margin:0 0 0 0;" alt="/!\" />
 
 ## Formules utilisateurs pour le calcul des moyennes
-Dans certains cas (assez rares), on veut calculer la note d'un module autrement qu'avec une simple moyenne des notes pondérée par les
+
-coefficients des évaluations. Par exemple, on veut parfois prendre la meilleure note de deux évaluations. On peut alors définir une formule ad-hoc pour le calcul de la moyenne du module.
+Dans certains cas (assez rares), on veut calculer la note d'un module autrement
+qu'avec une simple moyenne des notes pondérée par les coefficients des
+évaluations. Par exemple, on veut parfois prendre la meilleure note de deux
+évaluations. On peut alors définir une formule ad-hoc pour le calcul de la
+moyenne du module.
 
 Les formules sont aussi utilisable pour calculer la moyenne d'une Unité d'Enseignement (UE).
 
-<img src="/img/alert.png" style="vertical-align: bottom; margin:0 0 0 0;" alt="/!\" /> Attention: l'utilisation de formules ralenti considérablement les traitements, et devrait être réservé à des cas exceptionnels.
+<img src="/img/alert.png" style="vertical-align: bottom; margin:0 0 0 0;"
-
+alt="/!\" /> Attention: l'utilisation de formules ralenti considérablement les
+traitements, et devrait être réservé à des cas exceptionnels.
 
 ### Détails
-Le problème est compliqué par le fait que les notes à traitées ne sont pas toujours des nombres: absences, notes en attentes ou manquantes...
+
+Le problème est compliqué par le fait que les notes à traitées ne sont pas
+toujours des nombres: absences, notes en attentes ou manquantes...
 
 La formule reçoit donc:
 
- * Un tableau (vecteur) de notes (noté "notes"), de taille fixe et égale au nombre d'évaluations définies. Dans ce tableau, les notes "manquantes" ou "neutralisée" sont remplacées par des zéros. Les valeurs sont toujours entre 0 et 20. Toutes les évaluations sont présentes, même celle des évaluation incomplètes (mais leurs notes sont mises à zéro, même celles des étudiants qui ont une note note).
+* Un tableau (vecteur) de notes (noté "notes"), de taille fixe et égale au
+  nombre d'évaluations définies. Dans ce tableau, les notes "manquantes" ou
+  "neutralisée" sont remplacées par des zéros. Les valeurs sont toujours entre 0
+  et 20. Toutes les évaluations sont présentes, même celle des évaluation
+  incomplètes (mais leurs notes sont mises à zéro, même celles des étudiants qui
+  ont une note note).
 
- * Un tableau des coefficients de chaque évaluation, dans lequel les valeurs correspondants aux notes "manquantes" sont nulles.
+* Un tableau des coefficients de chaque évaluation, dans lequel les valeurs
+  correspondants aux notes "manquantes" sont nulles.
 
-Dans ces tableaux, les évaluations sont ordonnées en fonction de leur place sur le tableau de bord du module: l'ordre des évaluation (par défaut par date) peut être modifié par l'utilisateur en utilisant les flèches.
+Dans ces tableaux, les évaluations sont ordonnées en fonction de leur place sur
+le tableau de bord du module: l'ordre des évaluation (par défaut par date) peut
+être modifié par l'utilisateur en utilisant les flèches.
 
-Ainsi, si on a pour un étudiant deux évaluations de coefficients 2 et
+Ainsi, si on a pour un étudiant deux évaluations de coefficients 2 et 3 avec les
-3 avec les notes (12/20 et 16/20), on aura:
+notes (12/20 et 16/20), on aura:
-```
+
+```py
 notes = [ 12., 20. ]
 coefs = [ 2., 3. ]
 ```
 
-Quelques fonctions sont définies: `abs, cmp, dot, len, map, max, min, pow, reduce, round, sum, ifelse`.
+Quelques fonctions sont définies:
+`abs, cmp, dot, len, map, max, min, pow, reduce, round, sum, ifelse`.
 
 Exemples:
 
@@ -46,7 +63,6 @@ Exemples:
  * si la moyenne n'est pas valide, on renvoie la valeur `moy` (ce qui permet de garder le bon code)
 * Le max de deux évaluations, en résistant aux notes manquantes: `ifelse(moy_is_valid, max(notes[0], notes[1]), moy)`
 
-
 Autres variables définies dans les formules:
 
 * moy : la valeur de la moyenne calculée classiquement (somme pondérée) <img src="/img/alert.png" style="vertical-align: bottom; margin:0 0 0 0;" alt="/!\" /> *attention, ce n'est pas forcément un nombre !*
@@ -58,36 +74,43 @@ Autres variables définies dans les formules:
 * nbabs_nojust : nombre d'absences *non justifiées* de l'étudiant dans le semestre (en demi-journées)
 
 
-Attention: pour les conditions, on utilisera la fonction `ifelse`: comme pour tout appel de fonction python, les arguments cette dernière sont évalués avant l'appel, ce qui implique que les deux branches (vraie et faux) sont toujours évaluées. Ce détail est important si l'une d'entre elle déclenche une exception !
+Attention: pour les conditions, on utilisera la fonction `ifelse`: comme pour
-
+tout appel de fonction python, les arguments cette dernière sont évalués avant
-
+l'appel, ce qui implique que les deux branches (vraie et faux) sont toujours
+évaluées. Ce détail est important si l'une d'entre elle déclenche une exception!
 
 ### Calcul des moyennes d'UE
-Dans les formules de calcul des moyennes d'UE, on peut utiliser soit le vecteur de notes soit avec des indices numériques (comme ci-dessus, les moyennes de modules étant accessibles dans l'ordre sous lequel elle apparaissent dans les bulletins de notes), soit en utilisant le code du module.
+
+Dans les formules de calcul des moyennes d'UE, on peut utiliser soit le vecteur
+de notes soit avec des indices numériques (comme ci-dessus, les moyennes de
+modules étant accessibles dans l'ordre sous lequel elle apparaissent dans les
+bulletins de notes), soit en utilisant le code du module.
 
 Ainsi, la moyenne du module `BD1` serait aussi accessible comme la variable `notes['BD1']`.
 
-Exemple: dans une UE, on veut ajouter la note du module SPORT (qui aurait été défini avec un coefficient nul dans le programme), on écrira: 
+Exemple: dans une UE, on veut ajouter la note du module SPORT (qui aurait été
-```
+défini avec un coefficient nul dans le programme), on écrira:
+
+```py
 ifelse(moy_is_valid, min(moy_val+notes['SPORT'], 20), moy)
 ```
 
-
 ### Traitement des erreurs
-La formule doit ramener une valeur numérique entre 0 et 20, sans quoi
-ScoDoc considère la note erronée et la remplace par le code 'ERR' (qui
-se voit dans le tableau récapitulatif des notes et sur les bulletins).
-Idem pour tout autre erreur de calcul pouvant se produire.
-Si vous voyez des 'ERR', corrigez votre formule ! (message d'erreur affiché sur le tableau de bord du semestre)
-
 
+La formule doit ramener une valeur numérique entre 0 et 20, sans quoi ScoDoc
+considère la note erronée et la remplace par le code 'ERR' (qui se voit dans le
+tableau récapitulatif des notes et sur les bulletins). Idem pour tout autre
+erreur de calcul pouvant se produire. Si vous voyez des 'ERR', corrigez votre
+formule ! (message d'erreur affiché sur le tableau de bord du semestre)
 
 ## Exemples de formules de calcul utiles
+
 ### Exemple (contribué par Cédric C., IUT de Bordeaux)
 
 *J'ai réussi à faire mon calcul de moyenne pour une évaluation ayant pour calcul :* `moyenne(DS5, TD4, moyenne(TP1,TP2,TP3))`
 
 *Si cela vous intéresse, voici le détail :*
+
 ```
 Moyenne des [TPs](TPs.md)
 (notes[1]*coefs[1]+notes[2]*coefs[2]+notes[3]*coefs[3])/(coefs[1]+coefs[2]+coefs[3])
@@ -111,8 +134,3 @@ Soit la formule finale de moyenne de production
 ifelse(max(max(max(max(cmask[1], cmask[2]), cmask[3]), cmask[4]), cmask[5]), ((notes[5]*coefs[5]+notes[4]*coefs[4]+ (notes[1]*coefs[1]+notes[2]*coefs[2]+notes[3]*coefs[3])/( ifelse(max(max(cmask[1],cmask[2]),cmask[3]), coefs[1]+coefs[2]+coefs[3],1)
 )))/max(coefs[5]+coefs[4]+max(max(cmask[1],cmask[2]),cmask[3]),1) ,moy)
 ```
-
-
-###  Autres exemples 
-*à compléter, n'hésitez pas à envoyer vos exemples !*
-

docs/GestionLogos.md

@@ -25,13 +25,15 @@ réalisées par le menu de configuration des logos.
 
 ### Fichiers et répertoires associés aux logos
 
-Les images (logos et fonds de document) sont enregistrées dans le répertoire `/opt/scodoc-data/config/logos` et ses sous-répertoires.
+Les images (logos et fonds de document) sont enregistrées dans le répertoire
+`/opt/scodoc-data/config/logos` et ses sous-répertoires.
 
-Les images ajoutées par les utilisateurs ont toutes un nom de la forme `logo_<nom>.png` ou `logo_<nom>.jpg` 
+Les images ajoutées par les utilisateurs ont toutes un nom de la forme
-(`<nom>` représente le nom d'usage du logo : *header*, *footer*, signature, ... au choix de l'utilisateur)
+`logo_<nom>.png` ou `logo_<nom>.jpg` (`<nom>` représente le nom d'usage du logo:
-Les sous-répertoires ont des noms de la forme `logos_<dept>` où `<dept>` est
+*header*, *footer*, signature, ... au choix de l'utilisateur) Les
-l'identifiant numérique du département
+sous-répertoires ont des noms de la forme `logos_<dept>` où `<dept>` est
-(la commande `flask list-depts` donne la correspondance cf. [Administration en ligne de commande](GuideConfig.md)).
+l'identifiant numérique du département (la commande `flask list-depts` donne la
+correspondance cf. [Administration en ligne de commande](GuideConfig.md)).
 
 Les **fonds de page** se distinguent uniquement des logos par leur nom (`<ext>` peut être soit `jpg`ou `png`) :
 
@@ -51,3 +53,8 @@ exceptionnellement prise en compte. Bien évidemment, si un fichier scodoc9 (don
 avec le préfixe `logo_`) est présent, il est prioritaire sur le fond de page
 "historique".
 
+!!! note "Voir aussi"
+
+    - [Guide administrateur ScoDoc](GuideAdminSys.md)
+    - [FAQ](FAQ.md)
+    - [Contacts](Contact.md)

docs/GuideAdminFormation.md

@@ -128,11 +128,11 @@ fichiers sur la page
 
 !!! note "Voir aussi"
 
-    - [Guide utilisateurs](GuideUtilisateur.md)
+    - [Guide utilisateur](GuideUtilisateur.md)
     - [Tutoriels vidéo](https://www.youtube.com/channel/UCb0JYCBRi0CsE4XFp4ByhXg)
           - [Gestion des UE Bonus](https://www.youtube.com/watch?v=SVbjuDpq-lI)
           - [Mise en place des parcours BUT](https://www.youtube.com/watch?v=OnuOXJo-3ro)
           - [Saisie des codes Apogée](https://www.youtube.com/watch?v=MW0nNhbBjDM)
           - [Du DUT au BUT: comment transformer un programme](https://www.youtube.com/watch?v=9HizGTvYgck)
     - [FAQ](FAQ.md)
-    - [Contacts](Contact.md).
+    - [Contacts](Contact.md)

docs/GuideAdminSys.md

@@ -40,4 +40,4 @@ Utilisez un **serveur virtuel** ou un container Docker si vous n'avez pas de mac
     
     - [Guide pour les développeurs](GuideDeveloppeurs.md)
     - [FAQ](FAQ.md)
-    - [Contacts](Contact.md).
+    - [Contacts](Contact.md)

docs/GuideConfig.md

@@ -1,10 +1,9 @@
 
-##  Prise en main et paramétrage de ScoDoc 9
+#  Prise en main et paramétrage de ScoDoc 9
 
 Ce document suppose que le logiciel a été installé suivant la procédure décrite dans 
 [GuideInstallDebian11](GuideInstallDebian11.md).
 
-
 ## Administration en ligne de commande
 
 Les opérations d'administration se résument à la création de départements, et la
@@ -64,6 +63,7 @@ Il s'agit d'un utilisateur ayant tous les droits, comme s'il était
 où `admin2` est ici le pseudo du nouvel admin.
 
 ### Changement du mot de passe d'un utilisateur
+
 Cette opération peut s'effectuer via la page de gestion web des
 utilisateurs, mais il est parfois commode de le faire depuis la 
 console:
@@ -111,6 +111,7 @@ départements (utile pour certains compte administrateurs ou utilisés en lectur
 par des clients de l'API).
 
 ### Migration des données de ScoDoc 7
+
 Les données dans ScoDoc 9 ayant un format et une organisation très différents
 de ScoDoc 7, une étape de conversion (migration) est nécessaire. Elle est automatique
 mais prend du temps.
@@ -128,6 +129,7 @@ départements.
     flask import-scodoc7-users
 
 #### Départements
+
 Pour migrer un seul département:
 
     flask import-scodoc7-dept DEPT DBNAME
@@ -341,10 +343,22 @@ distribués. Pour les changer, passer par la page d'administration (lien
 
 * Connectez-vous au site: `https://votre.site.fr/`
 
+Vous allez voir la page d'accueil de ScoDoc, vous permettant de choisir le
+département où travailler.
 
-Vous allez voir la page d'accueil de ScoDoc, vous permettant de choisir le département 
+<img src="/img/alert.png" style="vertical-align: bottom; margin:0 0 0 0;"
-où travailler.
+alt="/!\" /> Surtout, évitez de travailler comme "admin" (super admin): prenez
+le temps de créer un utilisateur "chef de département !" dans chaque
+département, qui à son tour peut déléguer des droits.
 
-<img src="/img/alert.png" style="vertical-align: bottom; margin:0 0 0 0;" alt="/!\" /> Surtout, 
+
-évitez de travailler comme "admin" (super admin): prenez le temps de créer un utilisateur 
+!!! note "Voir aussi"
-"chef de département !" dans chaque département, qui à son tour peut déléguer des droits.
+
+    - [Guide installation](GuideInstallDebian11.md)
+    - [Gestion des utilisateurs](AdminUsers.md)
+    - [Rôles et permissions](ConfigPermissionsDept.md)
+    - [Configuration des envois d'emails](ConfigEmail.md)
+    - [Configuration des logos et fonds de documents](GestionLogos.md)
+    - [Guide administrateur ScoDoc](GuideAdminSys.md)
+    - [FAQ](FAQ.md)
+    - [Contacts](Contact.md)

docs/GuideDeveloppeurs.md

@@ -34,6 +34,8 @@ tout commit (configurez votre éditeur pour appeler `black` à l'enregistrement)
 On pourra adopter le style "Google": <https://google.github.io/styleguide/pyguide.html#383-functions-and-methods>
 
 Exemple:
+
+```py
     """Description résumée de la fonction
 
     blah blah sur la fonction
@@ -54,6 +56,7 @@ Exemple:
          b'Zim': ('Irk', 'Invader'),
          b'Lrrr': ('Omicron Persei 8', 'Emperor')}
     """
+```
 
 ### Git
 
@@ -71,6 +74,7 @@ Ci-dessous quelques pense-bête qui peuvent servir.
 Pour les développeurs internes (écriture sur le dépôt master), un exemple
 basique illustrant le cycle de développement:
 
+```bash
   # Créer une branche
   #  si besoin (travail en cours), utiliser git stash avant
   git checkout master
@@ -85,6 +89,7 @@ basique illustrant le cycle de développement:
   # publication
 
   # éventuellement: git stash pop
+```
 
 Dans la plupart des cas, on travaillera sur son propre dépôt (clone du dépt
 origine), et on proposera une *pull request* (PR, *demande d'ajout* en français).
@@ -132,10 +137,11 @@ Restore les modes au besoin (SAMBA les changent parfois):
     git diff -p -R --no-color | grep -E "^(diff|(old|new) mode)" --color=never | git apply
 ```
 
-
 Note pour travailler sur VirtualBox:
 
+```text
   addgroup scodoc vboxsf
+```
 
 ### Préparation d'une PR (Pull Request)
 
@@ -161,7 +167,8 @@ demande d'ajout (*pull request*, dite "PR"):
 Les manipulations sont décrites selon quatre phases du développement : l'installation,
 la mise en place, le suivi et la livraison.
 
-##### l'installation
+##### L'installation
+
 Il est pratique d'avoir en ligne les deux dépôts git distants que vous pouvez
 utiliser : votre dépôt personnel (`https://scodoc.org/git/<user>/<dépôt>.git`) et
 le dépôt officiel (`https://scodoc.org/git/ScoDoc/ScoDoc.git`).
@@ -207,10 +214,10 @@ principale évolue pendant ce temps.
 Pour garder la cohérence, il est nécessaire de réintégrer en local les
 modifications de la branche principale. Ceci peut se faire de deux façons.
 
-- Une fusion (`merge`) applique toutes les modifications en un seul commit).
+* Une fusion (`merge`) applique toutes les modifications en un seul commit).
  C'est la méthode couramment utilisée.
 
-- Un `rebase` rejoue tous les commits de la nouvelle branche par dessus l'état
+* Un `rebase` rejoue tous les commits de la nouvelle branche par dessus l'état
  le plus à jour de la branche principale (il en résulte un historique plus
  linéaire).
 
@@ -266,7 +273,7 @@ exemple):
 ```
 
 Utilisateurs Windows : Vérifiez bien que les réglages de fin de ligne suivent
-bien les règles Linux (pas de retour chariot (noté CR ou `\r`) en fin de ligne
+bien les règles Linux: pas de retour chariot (noté CR ou `\r`) en fin de ligne
 mais un seul caractère line feed (noté LF  ou `\n`). Le cas échéant, réglez
 votre IDE pour cela.
 
@@ -302,7 +309,8 @@ commandes :
 git rebase --continue # pour poursuivre le processus
 git rebase --abort # pour tout abandonner
 ```
-_vous permettront de résoudre ces problèmes exceptionnels_.
+
+*vous permettront de résoudre ces problèmes exceptionnels*.
 
 Application:
 
@@ -370,7 +378,7 @@ Quand vous sortez de l'éditeur, git effectue toutes les opérations demandées.
 * toutes les différences entre officiel/master et votre branche locale sont
   signifiantes.
 
-##### Étape 4 :
+##### Étape 4
 
 Vous pouvez maintenant pousser votre branche locale sur votre dépôt personnel
 (vers une branche de même nom):
@@ -435,7 +443,7 @@ bibliothèques, ou autres expériences de ce genre, vous pouvez le récréer ain
 
 Puis soit vous installez les versions "officielles" (testées)
 
-```
+```bash
   pip install -r requirements-3.9.txt 
 ```
 
@@ -445,6 +453,7 @@ faire ceci est:
 ```bash
   cut -d= -f 1 requirements-3.9.txt | xargs pip install
 ```
+
 à adapter selon vos objectifs.
 
 Pour régénérer le fichier indiquant la liste des paquets:
@@ -456,15 +465,11 @@ Pour régénérer le fichier indiquant la liste des paquets:
 Note: la mise à jour par `apt` recrée le virtualenv à chaque fois.
 
 ## Roadmap
-Sujets **prioritaires** en 2021-2022:
 
-- Modernisation du code: Flask, Python 3: achevé août 2021.
+  * [voir les tickets](https://scodoc.org/git/viennet/ScoDoc/issues)
 
-- Prise en compte du Bachelor (BUT): SAÉ, suivi compétences, validations des
-  blocs, UE, semestres selon la cadrage et l'arrêté Licence Pro 2020. (achevé
-  avec ScoDoc 9.2 puis complété en 9.3 et 9.4)
 
-- Définition et développement nouvelle API (achevé avec 9.3 en juillet 22)
+!!! note "Voir aussi"
     
-Autres sujets:
+    - [FAQ](FAQ.md)
-  - [voir les tickets](https://scodoc.org/git/viennet/ScoDoc/issues)
+    - [Contacts](Contact.md)

docs/GuideInstallDebian11.md

@@ -12,30 +12,29 @@ système Linux.
 
 Cette documentation est prévue pour installer ScoDoc version 9 sur un système
 [Debian](http://www.debian.org) 11 (Bullseye, stable) s'exécutant sur une
-machine intel-like **64bits** (architecture **AMD64**). Debian s'installe
+machine intel-like **64bits** (architecture **AMD64** sur Intel/AMD, ou
-facilement en cinq minutes, sur une machine normale ou un serveur
+**aarch64** sur Apple ARM). Debian s'installe facilement en cinq minutes, sur
-virtualisé. Il est **vivement déconseillé** de tenter l'installation sur une
+une machine normale ou un serveur virtualisé. Il est **vivement déconseillé** de
-autre version.
+tenter l'installation sur une autre version.
 
 Si vous mettez à jour un serveur existant (ScoDoc 7 sur Debian 10), voir [la page
 sur les migrations](https://scodoc.org/MigrationScoDoc7a9/#2-upgrade-debian).
 
 Merci de signaler tout problème [sur le Discord](https://discord.gg/ybw6ugtFsZ)
-ou éventuellement la liste [scodoc-devel](https://listes.univ-paris13.fr/mailman/listinfo/scodoc-devel) ).
+ou éventuellement la liste [scodoc-devel](https://listes.univ-paris13.fr/mailman/listinfo/scodoc-devel).
 
 - Note: l'image du CD d'installation de Debian (amd64) peut se trouver ici:
   [https://www.debian.org/distrib/netinst](https://www.debian.org/distrib/netinst.md),
 choisir la version "petits CD" pour **amd64**
 (*Il est indispensable d'utiliser une version 64 bits !*)
 
-
 🚸 **Important:**
+
 La procédure d'installation décrite ci-dessous suppose que ScoDoc va s'exécuter
 sur un serveur dédié.  Pour faire des tests, utilisez un serveur virtuel (comme
-VirtualBox ou VMWare). L'installation ci-dessous va en effet modifier de
+VirtualBox ou VMWare, ou UTM sur Mac). L'installation ci-dessous va en effet
-nombreux paramètres de votre système Linux (serveur web, firewall, serveur SQL,
+modifier de nombreux paramètres de votre système Linux (serveur web, firewall,
-messagerie, ...).
+serveur SQL, messagerie, ...).
-
 
 ## 1) Préalable: configurer un serveur linux
 
@@ -145,7 +144,6 @@ redémarrer le service:
  [ce post sur Stack Overflow](
    https://stackoverflow.com/questions/9445489/performing-http-requests-with-curl-using-proxy).
   
-
 #### Note sur l'install dans un container LXC
 
 Il y a deux possibilités :
@@ -308,3 +306,10 @@ bloquage des envois de mails). Au besoin, il est possible de désactiver IPv6
 - Mettez en place des [sauvegardes](SauvegardesBases.md)
 
 - Abonnez-vous au moins à la liste d'annonces: voir [contacts](Contact.md)
+
+!!! note "Voir aussi"
+
+    - [Guide configuration](GuideConfig.md)
+    - [Guide administrateur ScoDoc](GuideAdminSys.md)
+    - [FAQ](FAQ.md)
+    - [Contacts](Contact.md)

docs/GuideUtilisateur.md

@@ -1,46 +1,66 @@
 # Utilisation de ScoDoc
 
-ScoDoc contrôle les opérations via un mécanisme de permissions facile à mettre en œuvre et permettant de bien répartir les rôles entre les utilisateurs: responsables, enseignants, secrétariats.
+ScoDoc contrôle les opérations via un mécanisme de permissions facile à mettre
+en œuvre et permettant de bien répartir les rôles entre les utilisateurs:
+responsables, enseignants, secrétariats.
 
 ## Pour le responsable de formation
-La définition  des programmes, l'inscription des étudiants et certains paramétrages ne sont accessibles qu'au responsable de formation, ou chef de département.
 
-- [Guide pour le responsable de formation](GuideAdminFormation.md)
+La définition  des programmes, l'inscription des étudiants et certains
+paramétrages ne sont accessibles qu'au responsable de formation, ou chef de
+département.
+
+* [Guide pour le responsable de formation](GuideAdminFormation.md)
      * [Modification d'un programme pédagogique et versions](VersionProgrammes.md)
      * [Exemples et partages de programmes pédagogiques entre établissements](ExemplesProgrammesPedagogiques.md)
+  
 * [Importation des étudiants](ImportationEtuds.md)
+  
      * [Synchronisation des inscrits avec Apogée](SynchroApogee.md)
      * [Procédure d'inscription des étudiants via Apogée](InscriptionsEtudApogee.md)
      * [Données sur l'origine des étudiants](DonneesAdmissions.md)
      * [Gestion des photos des étudiants](GestionPhotos.md)
      * [Coordonnées des étudiants](GestionAdresses.md)
+
 * [Opérations en fin de semestre (jury, ré-inscriptions, ...)](TransitionSemestre.md)
 * [Export des résultats et décisions de jury vers Apogée](ScoDocApogee.md)
 * [Utilisation des rôles et permissions](ConfigPermissionsDept.md)
 
-## Pour les enseignants et administratifs:
+## Pour les enseignants et administratifs
 
 * [Édition des bulletins de notes](BulletinsNotes.md)
      * [paramétrage des bulletins pdf](ParametrageBulletins.md)
+  
 * [Édition des PV de jury](ParametragePV.md)
 * Comment sont calculées les moyennes : [Calcul des notes](CalculNotes.md)
 
 ## Opérations diverses
-#### Tenue des jurys et commissions
+
+### Tenue des jurys et commissions
 
 * [Saisie des décisions](SaisieDecisionsJury.md)
 * [Gestion des commissions et jurys, édition des PV](GestionJury.md)
 * [Capitalisation des UE](CapitalisationUE.md)
+
+### Spécificités du BUT
+
+(documentation à venir)
+
+### Spécificités du DUT
+
 * [Compensation automatique des semestres](CompensationSemestre.md)
 
-#### Suivi de l'assiduité
+### Suivi de l'assiduité
 
 * [Suivi de l'assiduité des étudiants](GestionAbsences.md)
 
-#### Rapports, avis et tableaux de bords
+### Rapports, avis et tableaux de bords
 
 * [Rapports, suivi de cohortes, parcours](RapportsStatistiques.md)
 * [Génération des avis de poursuite d'études](AvisPoursuiteEtudes.md)
 
-## Questions fréquentes
+!!! note "Voir aussi"
-Voir la [FAQ](FAQ.md)
+
+    - [Guide du responsable de formation](GuideAdminFormation.md)
+    - [FAQ](FAQ.md)
+    - [Contacts](Contact.md).

docs/MisesAJour.md

@@ -1,11 +1,14 @@
 
-Il est nécessaire de mettre à jour très fréquemment votre installation ScoDoc.
-
-
 # Mise à jour de ScoDoc 9
 
+Il est nécessaire de mettre à jour très fréquemment votre installation ScoDoc.
+
 À partir de ScoDoc 9, les mises à jour sont automatiques. Au besoin, on peut en
 lancer une à tout moment avec la commande
 
     apt update && apt-get upgrade
 
+!!! note "Voir aussi"
+
+    - [Guide administrateur ScoDoc](GuideAdminSys.md)
+    - [Contacts](Contact.md)

docs/ParametrageBulletins.md

@@ -1,37 +1,50 @@
 
 #  Paramétrage des bulletins de notes
-Ces réglages permettent de configurer la présentation des relevés de notes au format PDF.
+
+Ces réglages permettent de configurer la présentation des relevés de notes au
+format PDF.
 
 Le bulletin est constitué de plusieurs zones:
 
 * Le titre;
 * le tableau des notes;
- * les absences et appréciations (immédiatement sous le tableau des notes; les absences ne sont mentionnés que si la case "Indiquer les absences sur les bulletins" est cochée);
+* les absences et appréciations (immédiatement sous le tableau des notes; les
+  absences ne sont mentionnés que si la case "Indiquer les absences sur les
+  bulletins" est cochée);
 * la situation de l'étudiant (inscription, décision de jury, validations d'UE);
 * la signature de gauche et celle de droite;
 * le pied de page.
 
-Le contenu et la présentation des zones titre, situation et signatures sont paramétrables à l'aide de formats utilisant un balisage XML assez simple.
+Le contenu et la présentation des zones titre, situation et signatures sont
-
+paramétrables à l'aide de formats utilisant un balisage XML assez simple.
 
 ## Marges et position du pied de page
+
 Les bulletins sont formattés pour du papier A4.
 
-Les marges sont réglables via les valeurs dans la section "Marges additionnelles des bulletins". Ces valeurs s'ajoutent aux marges par défaut qui sont assez étroites.
+Les marges sont réglables via les valeurs dans la section "Marges additionnelles
-
+des bulletins". Ces valeurs s'ajoutent aux marges par défaut qui sont assez
-Le pied de page (*Edité par ScoDoc le ...*) n'est pas affecté par le réglage des marges, et est positionné à l'aide des paramètres "Position horizontale du pied de page pdf" (resp. verticale) dans la section "Mise en forme des documents PDF". Ces valeurs affectent tous les documents PDF générés par ScoDoc. 
+étroites.
 
+Le pied de page (*Edité par ScoDoc le ...*) n'est pas affecté par le réglage des
+marges, et est positionné à l'aide des paramètres "Position horizontale du pied
+de page pdf" (resp. verticale) dans la section "Mise en forme des documents
+PDF". Ces valeurs affectent tous les documents PDF générés par ScoDoc. 
 
 ## Valeurs remplacées
-Dans les formats, les balises de la forme `%(X)s` sont remplacées par la valeur (texte) de la variable X si elle existe. Les variables définies apportent différentes informations:
 
+Dans les formats, les balises de la forme `%(X)s` sont remplacées par la valeur
+(texte) de la variable X si elle existe. Les variables définies apportent
+différentes informations:
 
 ### Préférences
-Toutes les préférences pour le semestre considéré (ou définies globalement) sont utilisables par leur nom.
-Voir la liste complète sur [NomsPreferences](NomsPreferences.md).
 
+Toutes les préférences pour le semestre considéré (ou définies globalement) sont
+utilisables par leur nom. Voir la liste complète sur
+[NomsPreferences](NomsPreferences.md).
 
 ### Informations sur le semestre
+
 Variable | Valeur
 ---------|-------
 titre_num | Le titre du semestre
@@ -42,8 +55,8 @@ date_debut | 01/09/2008
 date_fin | 05/07/2009
 responsable | Nom du responsable du semestre (dir. des études)
 
-
 ### Informations sur l'étudiant
+
 Variable | Valeur (exemple)
 ---------|-------
 nom| DUPONT
@@ -63,6 +76,11 @@ decisions_ue      | noms (acronymes) des UE validées, séparées par des virgul
 descr_decisions_ue| " UE acquises: UE1, UE2", ou vide si pas de dec. ou paramétrage
 mention| Mention, calculée d'après la moyenne générale (vide en BUT)
  |
+**Parcours et référentiel BUT** |
+ parcours_titre         | "Cybersécurité"
+ parcours_code          | "Cyber"
+ refcomp_specialite     | "RT"
+ refcomp_specialite_long| "Réseaux et Télécommunications"
 **Jurys de BUT:** |
  descr_decision_annee | vide ou "Décision année: ADM" (code annuel: `ADM`, `PASD`, `DEF`...)
  descr_decisions_rcue | vide ou nom de la compétence et code jury RCUE: "Administrer 1: ADM, Connecter 1: ADJ" 
@@ -84,27 +102,30 @@ groupes | indique les groupes auxquels appartient l'étudiant dans le semestre
 group_0 | nom du groupe principal (1ère partition)
 group_<n> | nom du group de la n-ième partition
 
-
 ### Autres informations
+
 Variable | &nbsp;
 ---------|-------
 date_dmy | date courante, au format jj/mm/aaaa
 date_iso | date courante, au format aaaa-mm-jj
 
-
-
 ##  Balises XML utilisées dans les formats
-Le balisage XML est celui de [ReportLab](http://www.reportlab.com/) (intra-paragraph markup, voir page 70 du [guide utilisateur](http://www.reportlab.com/docs/reportlab-userguide.pdf)). La balise `<img>` n'est pas utilisable.
 
+Le balisage XML est celui de [ReportLab](http://www.reportlab.com/)
+(intra-paragraph markup, voir page 70 du [guide
+utilisateur](http://www.reportlab.com/docs/reportlab-userguide.pdf)). La balise
+`<img>` n'est pas utilisable.
 
 ### Logos
+
 Une balise supplémentaire est interprétée par ScoDoc pour insérer des logos (images).
 
 Les logos sont des images au format JPEG (extension `.jpg` ou `.jpeg`) ou PNG
 (extension `.png`), téléversés sur le serveur scodoc et intégrables dans les
-documents PDF. [Plus d'information sur la gestion des logos ici](GestionLogos.md).
+documents PDF. [Plus d'information sur la gestion des logos
+ici](GestionLogos.md).
 
-Principes généraux : 
+Principes généraux:
 
 * Un logo est désigné par un identifiant (nom) et peut être défini soit globalement, soit pour un département;
 
@@ -116,12 +137,15 @@ c'est le logo du département qui sera utilisé en lieu et place de logo global;
 
 * les logos de nom '`header`' et '`footer`' définis globalement ne peuvent être supprimés (mais peuvent être redéfinis).
 
-L'enregistrement, la modification ou la suppression d'un logo peut être réalisé via la page de configuration qui est accessible aux 
+L'enregistrement, la modification ou la suppression d'un logo peut être réalisé
-administrateurs Scodoc depuis la page d'accueil.
+via la page de configuration qui est accessible aux administrateurs Scodoc
+depuis la page d'accueil.
 
-Ce formulaire comporte une section pour les définitions globales plus une section par département.
+Ce formulaire comporte une section pour les définitions globales plus une
+section par département.
 
-Une section présente la liste des logos avec leurs propriétés (la dimension est donnée à titre indicatif quand elle est disponible). 
+Une section présente la liste des logos avec leurs propriétés (la dimension est
+donnée à titre indicatif quand elle est disponible). 
 
 Pour chaque logo, les actions disponibles sont :
 
@@ -131,21 +155,25 @@ Pour chaque logo, les actions disponibles sont :
 
 * l'ajout d'un nouveau logo dans une section (global ou département) et indiquant le nom.
 
-*NB*. Quelle que soit l'opération effectuée, le nom du fichier téléversé n'a aucune importance
+*NB*. Quelle que soit l'opération effectuée, le nom du fichier téléversé n'a
-(Seul le nom indiqué dans le formulaire est pris en compte et le format du fichier est déduit des données propres du fichier)
+aucune importance (Seul le nom indiqué dans le formulaire est pris en compte et
+le format du fichier est déduit des données propres du fichier)
 
-La balise `<logo name="xxx" width="44mm" height="22mm" valign="+5mm"/>`, placée dans un paragraphe, insère le logo de nom `xxx` avec les dimensions indiquées.
+La balise `<logo name="xxx" width="44mm" height="22mm" valign="+5mm"/>`, placée
-Le paramètre `valign` règle le positionnement vertical par rapport à la ligne de texte courante.
+dans un paragraphe, insère le logo de nom `xxx` avec les dimensions indiquées.
+Le paramètre `valign` règle le positionnement vertical par rapport à la ligne de
+texte courante.
 
-Notez qu'il est possible de ne préciser que l'une des deux dimensions hauteur ou largeur. 
+Notez qu'il est possible de ne préciser que l'une des deux dimensions hauteur ou
-Dans ce cas, la dimension manquante est déduite du ratio (rapport hauteur/largeur) de l'image originale.
+largeur. Dans ce cas, la dimension manquante est déduite du ratio (rapport
-Voir un exemple d'utilisation plus bas.
+hauteur/largeur) de l'image originale. Voir un exemple d'utilisation plus bas.
 
 ### Fond de page.
 Les modalités d'utilisation des fonds de pages sont similaires pour les PV, les lettres individuelles de décision et les bulletins.
 Celles-ci sont décrites ici: [Paramétrage des PV. Images de fond de page](ParametragePV.md)
 
 ## Exemples
+
 ###  Exemple 1: Bulletins par défaut 
 Les bulletins édités par défaut sont obtenus avec:
 

docs/UtilisateursScoDoc.md

@@ -1,6 +1,9 @@
 
 # Établissements utilisant ScoDoc
-Cette page tente de lister les utilisateurs connus de ScoDoc. Le logiciel étant libre, nous ne sommes pas en mesure de dresser une liste exhaustive. Si vous utilisez le logiciel, merci d'envoyer un mail à <emmanuel.viennet@gmail.com>.
+
+Cette page tente de lister les utilisateurs connus de ScoDoc. Le logiciel étant
+libre, nous ne sommes pas en mesure de dresser une liste exhaustive. Si vous
+utilisez le logiciel, merci d'envoyer un mail à <emmanuel.viennet@gmail.com>.
 
 ## Établissements membres de l'association (2020-2021) [liste non à jour]
 
@@ -47,11 +50,13 @@ Cette page tente de lister les utilisateurs connus de ScoDoc. Le logiciel étant
 * département Informatique de l'[IUT de Montpellier-Sète](https://iut-montpellier-sete.edu.umontpellier.fr/dut-informatique/)
 
 ### Autres membres
+
 * [IUT de La Rochelle](http://www.iut-larochelle.fr/).
 
 * [IUT de Villetaneuse](http://www.iutv.univ-paris13.fr/) (Université Sorbonne Paris Nord), départements Informatique, CJ, GEA, GEII, R&T, STID Formation Continue (1600 étudiants, depuis 2005);
 
-##  IUT utilisateurs
+## IUT utilisateurs ou adhérents
+
 * [IUT d'Aix en Provence (GEII)](http://iut.univ-amu.fr/diplomes/dut-genie-electrique-informatique-industrielle-dut-geii),
 (site de Salon);
 
@@ -169,6 +174,7 @@ Cette page tente de lister les utilisateurs connus de ScoDoc. Le logiciel étant
 * [IUT de Villeurbanne (Lyon 1)](http://iut.univ-lyon1.fr/), département GEII, environ 220 inscrits/an.
 
 ## Autres établissements utilisateurs (hors IUT)
+
 * Licence de sciences (SPI) à L'Université de Bretagne Occidentale (UBO);
 
 * Masters de sciences, Institut Galilée, Université Sorbonne Paris Nord;
@@ -184,3 +190,8 @@ Cette page tente de lister les utilisateurs connus de ScoDoc. Le logiciel étant
 
 * [École Supérieure des Sciences et Technologies de l'Ingénieur de Nancy](http://www.esstin.univ-lorraine.fr) (jusqu'en 2013);
 
+
+!!! note "Voir aussi"
+
+    - [FAQ](FAQ.md)
+    - [Contacts](Contact.md)