Création de styles
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.
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