jmplace/DocScoDoc
1
0
Fork 0
forked from ScoDoc/DocScoDoc
Code Issues Pull Requests Projects Releases Wiki Activity

complément doc sur logos

Browse Source
This commit is contained in:
Jean-Marie Place 2021-12-12 23:02:42 +01:00
parent 69e528a5bc
commit 9473f5b128
1 changed files with 28 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

29
docs/ParametrageBulletins.md
View File

@ -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 doivent être des images au format JPEG (extension `.jpg` ou `.jpeg`) ou PNG (expension `.png`).
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/modification /suppression d'un logo peut être réalisé par la page de configuration et par un super adminsitrateur.
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 du fichier)
La balise `<logo name="xxx" width="44mm" height="22mm" valign="+5mm"/>`, 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 hauter/largeur. dans ce cas, la dimension manquante est déduite du ratio de l'image originale.
Voir un exemple d'utilisation plus bas.