forked from ScoDoc/DocScoDoc
Merge pull request 'complément doc sur logos' (#8) from jmplace/DocScoDoc:complete_doc_logos into master
Reviewed-on: https://scodoc.org/git/viennet/DocScoDoc/pulls/8
This commit is contained in:
commit
6238bb6b24
@ -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 `<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.
|
||||
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 `<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 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.
|
||||
|
||||
|
||||
|
Loading…
Reference in New Issue
Block a user