From 1250f69535e04f8f682cb588a6bae021bdad4aeb Mon Sep 17 00:00:00 2001 From: Jean-Marie PLACE Date: Sat, 26 Feb 2022 14:34:52 +0100 Subject: [PATCH] mise a jour doc fond de page --- docs/GestionLogos.md | 29 +++++++++++++++++++++++++++++ docs/GuideAdminSys.md | 1 + docs/ParametrageBulletins.md | 4 +++- docs/ParametragePV.md | 14 +++++++++++++- 4 files changed, 46 insertions(+), 2 deletions(-) create mode 100644 docs/GestionLogos.md diff --git a/docs/GestionLogos.md b/docs/GestionLogos.md new file mode 100644 index 000000000..5461c51a6 --- /dev/null +++ b/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_.png` ou `logo_.jpg` +(`` 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_` où `` 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 (`` peut être soit `jpg`ou `png`) : + +| Document | nom | fichier | +|----------------------------------|-------------------------|--------------------------------| +| pv de jury | pvjury_background | `logo_pvjury_background.` | +| bulletin de note | letter_background | `logo_letter_background.` | +| lettre individuelle de décision | letter_background | `logo_letter_background.` | + +## héritage scodoc7 + +Les serveurs scodoc7 utilisaient pour les fonds de page, des fichiers de nom `letter_background.` et `pvjury_background.`. +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" + diff --git a/docs/GuideAdminSys.md b/docs/GuideAdminSys.md index 4d42fdccb..882997f1f 100644 --- a/docs/GuideAdminSys.md +++ b/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 diff --git a/docs/ParametrageBulletins.md b/docs/ParametrageBulletins.md index 2c1f51439..90099ed85 100644 --- a/docs/ParametrageBulletins.md +++ b/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 diff --git a/docs/ParametragePV.md b/docs/ParametragePV.md index 6b5319136..9a6ace864 100644 --- a/docs/ParametragePV.md +++ b/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.