Ce wiki est un espace de travail et d'organisation, les informations qu'il contient peuvent être fausses ou erronnées et ne constitue pas une communication officielle d'Actux.

Cette page dcrit comment un administrateur du Wiki peut modifier la mise en page d'une page sur PmWiki (en-tte et pieds de page). La mise en page est dfinie dans un thme enregistr dans le rpertoire pub/skins/. Un thme est en fait un rpertoire contenant un fichier de modle (fichier .tmpl) et des fichiers associs, tels que logos et feuilles de style (fichiers .css).

PmWiki est distribu avec un thme par dfaut appel "pmwiki" stock dans le rpertoire pub/skins/pmwiki/. Ce rpertoire contient un fichier type *.tmpl, qui est le modle utilis pour afficher les pages sur l'cran, et aussi un fichier CSS et un logo.

Si vous voulez modifier le thme par dfaut, vous pouvez:

  • Faire une copie du thme `pmwiki et le modifier.
  • Installer un thme depuis le 'Cookbook'. Voir PmWiki:Cookbook.Skins pour les fichiers de thmes et les mises en page labores par d'autres.
  • Crer votre propre thme.

Crer et modifier un thme

Les tapes de base pour modifier un thme sont de crer/diter un sous-rpertoire de /pubs/skins/, et ensuite de dfinir la variable $Skin comme tant le nom de votre rpertoire.

Ce qui suit est une aide pour ces deux tapes.

Modifier le thme "pmwiki"

Le thme pmwiki (c.a.d. les fichiers du rpertoire pub/skins/pmwiki/) font partie de l'installation de PmWiki, aussi toute modification de ces fichiers sera crase 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 modle .tmpl et les autres fichiers votre guise. Vous indiquerez alors PmWiki d'utiliser le thme dans pub/skins/xyzskin/ en dfinissant

  $Skin = 'xyzskin';

dans votre fichier de configuration local/config.php

Introduction au fichier de modle (.tmpl)

Un fichier de modle est essentiellement un fichier HTML qui contient des variables de substitution (indiques par '$') et des directives insres dans les commentaires HTML. Deux de ces directives particulires sont ncessaire dans un fichier de modle. 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 modle, ses variables telles que $PageUrl, $ScriptUrl, $Group, and $Title sont remplaces 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 modle sont remplaces par les variables globales quivalentes PHP. D'autres squences courantes:

    $SkinDirUrl - l'URL du rpertoire de thme
    $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 modle 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 utilise pour afficher le contenu de Main.UnePage un endroit quelconque de la forme. ceci est pratique pour crer des menus ditables depuis des pages autres que celle affiches. 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 spcifies, 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.


<< Prfrences 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 19:54