Création de styles

Généralités

La définitions de style se fait en définissant un ensemble de fichier de configuration. Ces fichiers de configuration doivent être placés dans le répertoire de publication (/usr/share/what par défaut) sous le répertoire STYLE.

[root@calvados ~]# ls -l /usr/share/what/STYLE/
total 64
drwxr-xr-x 4 apache apache 4096 jun 23 08:59 AQUA
drwxr-xr-x 3 apache apache 4096 jun 23 09:01 BLACK
drwxr-xr-x 4 apache apache 4096 jun 23 09:01 BLUE
drwxr-xr-x 4 apache apache 4096 jun 16 11:50 BRUSHED
drwxr-xr-x 4 apache apache 4096 jun 23 09:01 CARAMEL
drwxr-xr-x 3 apache apache 4096 jun  9 12:32 DARKBLUE
drwxr-xr-x 3 apache apache 4096 jun 23 08:59 DEFAULT
drwxr-xr-x 4 apache apache 4096 jun 23 09:01 GREEN
drwxr-xr-x 4 apache apache 4096 jun 23 09:01 RED

on trouve ainsi déjà les style prédéfinis à l'installation du système. Pour créer un nouveau style, il faut créer un nouveau répertoire en majuscule puis dans ce répertoire créer un fichier de configuration de style (.sty) de même nom que le répertoire.

[root@calvados ~]# mkdir /usr/share/what/STYLE/ORANGE
[root@calvados ~]# vi /usr/share/what/STYLE/ORANGE/ORANGE.sty

Le style doit renseigner au moins son nom. Cela sert à identifier le style. Il ne doit être composé que d'un seul mot ne contenant que des lettres. Par convention, les noms des style sont ceux du répertoire. Pour créer un style, le plus simple est de le faire hériter de DEFAULT. Ceci permet déjà d'avoir l'ensemble des paramètres déjà renseigné. Exemple :

<?php
$sty_desc= array (
"name"          => "ORANGE",              //Name
"description"   => N_("orange mandarine")   //long description
);
 
$sty_inherit="DEFAULT";
?>

Une fois le fichier de style créé et lors de chaque modification de celui-ci, il faut enregistrer les modifications dans la base de données du serveur.

[root@calvados ~]# . /etc/freedom.conf # à faire seulement la première fois pour avoir les alias tels que ''wsh''.
[root@calvados ~]# wsh --api=import_style --name=ORANGE # enregistrement des modifications de style
[root@calvados ~]# /usr/share/what/wstart # nécessaire pour effacer le cache du serveur car les paramètres de style sont généralement dans le cache

Ceci permet de mettre à jour le paramètre global STYLE. Le style ORANGE est maintenant disponible par l'interface. Son aspect est identique à DEFAULT, puisqu'il en hérite sans modification.

Créer un nouveau style en changeant juste les trois couleurs

Il suffit de prendre le fichier de style (ici ORANGE.sty) et de renseigner les 3 couleurs comme cela est fait dans l'exemple. Ces 3 couleurs A,B et C doivent obligatoirement être de la forme #RRGGBB (code RGB en hexadécimal : rouge,vert bleu). Les noms de couleurs tels que yellow ne seront pas pris en compte.

<?php
$sty_desc= array (
"name"          => "ORANGE",              //Name
"description"   => N_("orange mandarine")   //long description
);
 
$sty_inherit="DEFAULT";
$sty_colors = array("A"=>'#947217', // mandarine
		    "B"=>'#263ce5', //blue
		    "C"=>"#c3b649"); // orange
 
 
?>

Ensuite il fait refaire la procédure de mise à jour pour enregistrer les modifications.

[root@calvados ~]# wsh --api=import_style --name=ORANGE # enregistrement des modifications de style
[root@calvados ~]# /usr/share/what/wstart # nécessaire pour effacer le cache du serveur car les paramètres de style sont généralement dans le cache

Créer un nouveau style en modifiant les paramètres du style par défaut

Créer un nouveau style et surcharger la feuille de style du style par défaut

Créer un nouveau style complet et autonome

contribution/cookbook/interfaces/definition.txt · Dernière modification: 09/03/2010 11:52 (édition externe)