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

Reviewed-on: viennet/DocScoDoc#20
This commit is contained in:
Emmanuel Viennet 2022-02-27 08:34:17 +01:00
commit 54dd4da541
4 changed files with 46 additions and 2 deletions

29
docs/GestionLogos.md Normal file
View File

@ -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>``<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"

View File

@ -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

View File

@ -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

View File

@ -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%">