Merge pull request 'mise a jour doc fond de page' (#20) from jmplace/DocScoDoc:fond_de_page into master

Reviewed-on: https://scodoc.org/git/viennet/DocScoDoc/pulls/20

docs/GestionLogos.md

@@ -0,0 +1,29 @@
+
+# Gestions des logos et fonds de documents
+
+Les images (logos et fonds de document) sont enregistrées dans le répertoire `/opt/scodoc-data/config/logos` et ses sous-répertoires.
+
+Normalement, l'administrateur n'a pas besoin d'intervenir dans ces répertoires, la totalité des opérations nécessaires 
+pouvant être réalisées par le menu de configuration des logos. 
+
+Les images ajoutées par les utilisateurs ont toutes un nom de la forme `logo_<nom>.png` ou `logo_<nom>.jpg` 
+(`<nom>` représente le nom d'usage du logo : header, footer, signature, ... au choix de l'utilsateur)
+Les sous-répertoires ont des noms de la forme `logos_<dept>` où `<dept>` est l'identifant 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`) :
+
+| Document                         | nom                     | fichier                        |
+|----------------------------------|-------------------------|--------------------------------|
+| pv de jury                       | pvjury_background       | `logo_pvjury_background.<ext>` |
+| bulletin de note                 | letter_background       | `logo_letter_background.<ext>` |
+| lettre individuelle de décision  | letter_background       | `logo_letter_background.<ext>` |
+
+## héritage scodoc7
+
+Les serveurs scodoc7 utilisaient pour les fonds de page, des fichiers de nom `letter_background.<ext>` et `pvjury_background.<ext>`.
+Lors de la migration depuis scodoc7, ces fichiers ont placés dans le même répertoire que les images scodoc9. 
+Pour assurer la compatibilité ascendante,
+leur présence est exceptionnellement prise en compte. Bien evidement, si un fichier scodoc9 (donc avec le préfixe `logo_`) est présent, 
+il est prioritaire sur le fond de page "historique"
+

docs/GuideAdminSys.md

@@ -29,6 +29,7 @@ référer à [GuideInstallDebianDix](GuideInstallDebianDix.md) ou
 ## Autres problèmes
 
  * [Problèmes configuration des envois mail](ProblemesMail.md)
+ * [Gestion des logos et fonds de documents](GestionLogos.md)
  * [ProblemesEtBugs](ProblemesEtBugs.md) en cas d'ennuis.
 
 ##  Utilisation avancée

docs/ParametrageBulletins.md

@@ -31,7 +31,6 @@ Toutes les préférences pour le semestre considéré (ou définies globalement)
 Voir la liste complète sur [NomsPreferences](NomsPreferences.md).
 
 
-
 ###  Informations sur le semestre 
 Variable | Valeur
 ---------|-------
@@ -134,6 +133,9 @@ Notez qu'il est possible de ne préciser que l'une des deux dimensions hauteur o
 Dans ce cas, la dimension manquante est déduite du ratio (rapport 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)
 
 ##  Exemples 
 ###  Exemple 1: Bulletins par défaut 

docs/ParametragePV.md

@@ -10,6 +10,18 @@ Le PV de jury est en format paysage et liste les résultats des étudiants chois
 ## Image de fond de page (logos, tête, pied)
 L'exemple ci-dessus utilise une image de fond qui contient l'en-tête et le pied de page, avec des logos. Il faut fournir à ScoDoc une image de fond. Le plus simple est généralement de la composer dans un logiciel de traitement de texte, et de l'enregistrer en image: exporter en PDF puis convertir le PDF en image PNG ou JPEG de bonne résolution (300dpi , par exemple avec un logiciel comme Aperçu sur Mac.
 
+L'image obtenue peut ensuite être téléversée sur le serveur de la même façon que pour un simple logo 
+(voir la section [paramètrage des bulletins, section Logos](ParametrageBulletins.md)
+avec le nom "`pvjury_background`" ou "`letter_background`" selon le type de document visé.
+
+Il ne reste plus qu'à activer l'option correspondante soit globalement dans le paramètrage du département, soit (pour les bulletins) dans par le menu réglage bulletin du semestre (qui a précédence):
+- Mettre l'image de fond sur les PV de jury (paysage)
+- Mettre l'image de fond sur les bulletins
+- Mettre l'image de fond sur les lettres individuelles de décision
+
+Note pour les serveurs migrés depuis scodoc7:
+Les anciennes configurations ayant suivi la migration depuis scodoc7 sont encore fonctionnelles.
+
 L'image doit ensuite être enregistrée sur le serveur à un emplacement spécifique (seul l'administrateur du serveur peut faire cela):
 
  - Pour les PV de jury (A4 paysage), sous le chemin `/opt/scodoc/var/scodoc/config/logos/pvjury_background.png`
@@ -33,7 +45,7 @@ Les paragraphes de texte utilisent un balisage identique à celui des bulletins
 
 ScoDoc génère un docuement PDF contenant les letters de tous les étudiants du semestre ou d'un groupe.
 
-Le principe est le même, mais on fournit une trame de fond au format portrait, come indiqué plus haut. Le texte de la lettre est configurable dans les préférences.
+Le principe est le même, mais on fournit une trame de fond au format portrait, comme indiqué plus haut. Le texte de la lettre est configurable dans les préférences.
 
 <img src="/screens/LettresPreferences.png" width="50%">