From e76e441e904f6083cd5dab2ef38c6bb25121e9f0 Mon Sep 17 00:00:00 2001 From: Place Jean-Marie Date: Sun, 12 Dec 2021 23:02:42 +0100 Subject: [PATCH] =?UTF-8?q?compl=C3=A9ment=20doc=20sur=20logos?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/ParametrageBulletins.md | 31 +++++++++++++++++++++++++++++-- 1 file changed, 29 insertions(+), 2 deletions(-) diff --git a/docs/ParametrageBulletins.md b/docs/ParametrageBulletins.md index 13d847be..d08a003e 100644 --- a/docs/ParametrageBulletins.md +++ b/docs/ParametrageBulletins.md @@ -96,10 +96,37 @@ Le balisage XML est celui de [ReportLab](http://www.reportlab.com/) (intra-parag ### Logos Une balise supplémentaire est interprétée par ScoDoc pour insérer des logos (images). -Les logos doivent être des images au format JPEG (extension `.jpg` uniquement), placées dans le répertoire `.../logos/`, et nommées `logo_xxx.jpg`. +Les logos sont des images au format JPEG (extension `.jpg` ou `.jpeg`) ou PNG (expension `.png`), téléversés sur le serveur scodoc et intégrables dans les documents html ou pdf. -La balise ``, placée dans un paragraphe, insère alors le logo `xxx` avec les dimensions indiquées. Le paramètre `valign` règle le positionnement vertical par rapport à la ligne de texte courante. +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; +* le nom d'un logo est exclusiement composé de caractères alphanumériques ou du caractère '`-`'; +* les logos définis globalement sont accessibles pour tous les départements. Toutefois, si un logo de même nom est également dans un département, +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 +administrateurs Scodoc depuis la page d'accueil. + +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). + +Pour chaque logo, les actions diponibles sont : + +* Le remplacement de l'image existante par un nouveau fichier +* La suppression du logo (sauf pour `header`et `footer`dans la section globale) + +Il est également possible d'ajouter un nouveau logo dans une section (global ou département) et indiquant le nom. + +*NB*. Quelquesoit l'opération effectuée, le nom du fichier téléversé n'a 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 ``, placée dans un paragraphe, insère alors le logo `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. +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.