DotClear - Guide d'utilisation
précédent | Table des matières | suivant

5. Modèles (templates)

  1. Généralités
  2. Création du thème

5.1. Généralités

DotClear n'utilise pas de moteur de template particulier. Les modèles de page de DotClear sont donc uniquement en PHP.

Ceci ne signifie pas que les modèles ne sont pas modifiables selon vos goûts.

Par défaut vous trouverez le modèle de page dans le fichier template.php. La feuille de style CSS associée à ce modèle se trouve dans themes/default/style.css.

Pour modifier l'apparence de votre blogue vous avez deux choix : modifier le fichier template.php ou créer un nouveau thème.

Pour faciliter les mises à jour vers d'autres versions, vous êtes vivement encouragés à créer un thème, ceci n'étant pas bien compliqué.

5.2. Création du thème

Un thème contient deux choses indispensables : une feuille de style nommée style.css et un fichier XML décrivant le thème nommé desc.xml. Commencez par créer un reperoire themes/montheme puis les deux fichiers (feuille de style et fichier XML).

Le fichier XML est très simple, voici un exemple :

<?xml version="1.0" encoding="ISO-8859-1"?>
<theme name="montheme" version="1.0" active="true">
  <author>Moi même</author>
  
  <label>Mon thème</label>
  <desc>Superbe thème tout nouveau.</desc>
</theme>

Ensuite, vous avez le choix. Soit le template par défaut vous convient et vous n'avez donc pas besoin d'en créer un (celui par défaut sera alors utilisé). Soit le template ne vous convient pas et vous voulez en créer un. Dans ce cas vous allez créer un fichier template.php.

Pour commencer, vous pouvez copier le template par défaut dans votre nouveau template.php dans themes/montheme.

Votre thème de départ est prêt. En vous rendant dans la configuration de DotClear (dans les outils), vous pourrez choisir entre le thème default et montheme. Choisissez montheme et validez. Notez que vous pouvez aussi éditer le fichier conf/blog_conf.php pour parvenir au même effet.

Note
Une copie du template par défaut existe dans le thème default sous le nom de template.php.copy.

Vous êtes maintenant prêt à passer à la création ou la modification d'un gabarit.


précédent | Table des matières | suivant