Bases pour la mise en page

Cette page décrit comment un administrateur du Wiki peut modifier la mise en page d'une page sur PmWiki (en-tête et pieds de page). La mise en page est définie dans un thème enregistré dans le répertoire pub/skins/. Un thème est en fait un répertoire contenant un fichier de modèle (fichier .tmpl) et des fichiers associés, tels que logos et feuilles de style (fichiers .css).

PmWiki est distribué avec un thème par défaut appelé "pmwiki" stocké dans le répertoire pub/skins/pmwiki/. Ce répertoire contient un fichier type *.tmpl, qui est le modèle utilisé pour afficher les pages sur l'écran, et aussi un fichier CSS et un logo.

Si vous voulez modifier le thème par défaut, vous pouvez:

  • Faire une copie du thème `pmwiki et le modifier.
  • Installer un thème depuis le 'Cookbook'. Voir PmWiki:Cookbook.Skins pour les fichiers de thèmes et les mises en page élaborées par d'autres.
  • Créer votre propre thème.

Créer et modifier un thème

Les étapes de base pour modifier un thème sont de créer/éditer un sous-répertoire de /pubs/skins/, et ensuite de définir la variable $Skin comme étant le nom de votre répertoire.

Ce qui suit est une aide pour ces deux étapes.

Modifier le thème "pmwiki"

Le thème pmwiki (c.a.d. les fichiers du répertoire pub/skins/pmwiki/) font partie de l'installation de PmWiki, aussi toute modification de ces fichiers sera écrasée lors d'une mise à jour. Aussi, au lieu d'éditer les fichiers directement, commencez par en faire une copie sur par exemple, pub/skins/xyzskin/.

Vous pouvez maintenant éditer dans cette copie le fichier modèle .tmpl et les autres fichiers à votre guise. Vous indiquerez alors à PmWiki d'utiliser le thème dans pub/skins/xyzskin/ en définissant 

  $Skin = 'xyzskin';

dans votre fichier de configuration local/config.php

Introduction au fichier de modèle (.tmpl)

Un fichier de modèle est essentiellement un fichier HTML qui contient des variables de substitution (indiquées par '$') et des directives insérées dans les commentaires HTML. Deux de ces directives particulières sont nécessaire dans un fichier de modèle. La directive <!--PageText--> appartient à la section <body> d'un document HTML, et indique à PmWiki ou se trouve le contenu principal de chaque page wiki. L'autre directive requise est <!--HeaderText-->, qui doit aller dans la section <head> du document HTML.

Dans le fichier de modèle, ses variables telles que $PageUrl, $ScriptUrl, $Group, and $Title sont remplacées au moment de l'affichage par l'URL de la page courante, l'URL de base du script pmwiki.php, le nom du groupe courant et le titre de la page en cours. D'autres variables du modèle sont remplacées par les variables globales équivalentes PHP. D'autres séquences courantes: 

    $SkinDirUrl - l'URL du répertoire de thème
    $Namespaced - le nom de la page avec des espaces entre les mots
    $Groupspaced - le groupe de la page avec des espaces entre les mots

Finalement, le modèle peut contenir d'autres directives permettant l'affichage du contenu d'autres pages, de fichiers, ou l'appel de fonctions PHP. La directive <!--wiki:Main.UnePage--> peut être utilisée pour afficher le contenu de Main.UnePage à un endroit quelconque de la forme. ceci est pratique pour créer des menus éditables depuis des pages autres que celle affichées. Les substitutions de variables fonctionnent ici, aussi <!--wiki:$Group.UnePage--> affichera le contenu de "UnePage" dans le Groupe Wiki courant. Des alternatives multiples peuvent aussi être spécifiées, donc <!--wiki:$Group.UnePage Main.UnePage--> affiche le contenu de UnePage dans le groupe Wiki courant, et si cette page n'existe pas Main.UnePage est utilisé à la place.

<< Préférences du site | Index doc admin | Mise en page évoluée >>

Page originale sur PmWikiFr.LayoutBasics - Référencé par
Dernières modifications:
PmWikiFr.LayoutBasics: 13/04/2006