Traduction de PmWiki:LayoutAdvanced

Comme décrit dans la page BasePourLaMiseEnPage, les modèles basés sur le HTML peuvent être utilisés pour personnaliser la présentation des pages Wiki. Les fichiers de modèles peuvent inclure des liens vers des feuilles de style externes (fichiers .css). Cette page explique comment les fichiers de modèles sont interprétés et comment les fichiers CSS sont inclus.

Modèles: Directives et Variables

Des commentaires HTML peuvent être inclus dans les modèles, par exemple: <!-- ceci est un commentaire -->. Quelques commentaires fonctionnent comme des directives qui ont une signification particulière. Il n'y a pas d'espace entre les délimiteurs de commentaires et les mots clés; c'est à dire <!--PageText--> est valide mais <!-- PageText --> ne l'est pas. Les directives et variables disponibles sont:

  • <!--PageText-->
    • Ceci indique que le contenu de la page Wiki en cours doit être inséré.

  • <!--HeaderText-->
    • Cette directive permet à PmWiki d'insérer les meta tags appropriés dans la section <head> de la sortie HTML (utilisé pour contrôler l'indexation par les moteurs de recherche). PmWiki vérifiera aussi l'existence des fichiers CSS conçernés dans pub/css; $Group.css et $Group.$Title.css seront inclus ici si ils existent.

  • Inclure une page Wiki: <!--wiki:Base.UnePage-->
    • Utiliser ce type de directive pour inclure une page Wiki. Par exemple, si vous avez un menu latéral, vous pouvez l'inclure ici en utilisant <!--wiki:Base.Menu-->.

  • Appeler une fonction PHP: <!--function:UneFunction ''arguments''-->
    • Vous pouvez utiliser ceci pour appeller une fonction que vous avez installée dans votre local/config.php qui peut imprimer un texte différent basé sur, par exemple, le groupe ou la page courante. La fonction recoit un nom complet de page (ex. PmWikiFr.MiseEnPageÉvoluée) et le texte suivant le nom de la fonction (ce qui est optionel et peut être omis).

  • <!--Page...Fmt--> directives
    • Une directive de ce format (c.a.d. démarrant avec "Page" et finissant avec "Fmt") indique le début de la section du modèle. La section qui suit est placée dans une variable du même nom. Par exemple, <!--PagePiedFmt--> indique le démarrage d'un pied qui est stocké dans la variable $PagePiedFmt. La section continuejusqu'a la directive <!--Page...Fmt--> suivante, ou la fin du fichier. Il est aussi possible d'indiquer la fin de la section utilisant <!--/Page...Fmt-->. Noter que, par défaut, seuls $PageHeaderFmt, $PageFooterFmt et $PageTitleFmt sont inclus dans une sortie quand une page Wiki est vue. D'autres variables peuvent être définies et utilisées, mais elles n'apparaitront que dans certaines situations. Par exemple, <!--/PageEditFmt--> peut être utilisée pour définir une section qui n'apparaîtra que quand l'action Edit est en cours (c.a.d. qu'une page est en cours d'édition).

  • Inclure des variables
    • Les variables PHP sont évaluées quand PmWiki interprète un fichier de modèle. Par exemple, vous pouvez insérer un logo en utilisant $PageLogoFmt, ou créer un lien vers une page d'édition en utilisant <a href='$PageUrl?action=edit'>$[Edit Page]</a>


<< Base pour la mise en page | IndexDocAdmin | Personnalisation par groupe >>