Ada Programming $WikiTagline
 

Traduction de PmWiki:LayoutAdvanced

Comme dcrit dans la page BasePourLaMiseEnPage, les modles bass sur le HTML peuvent tre utiliss pour personnaliser la prsentation des pages Wiki. Les fichiers de modles peuvent inclure des liens vers des feuilles de style externes (fichiers .css). Cette page explique comment les fichiers de modles sont interprts et comment les fichiers CSS sont inclus.

Modles: Directives et Variables

Des commentaires HTML peuvent tre inclus dans les modles, par exemple: <!-- ceci est un commentaire -->. Quelques commentaires fonctionnent comme des directives qui ont une signification particulire. Il n'y a pas d'espace entre les dlimiteurs de commentaires et les mots cls; 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 insr.
  • <!--HeaderText-->
    • Cette directive permet PmWiki d'insrer les meta tags appropris dans la section <head> de la sortie HTML (utilis pour contrler l'indexation par les moteurs de recherche). PmWiki vrifiera aussi l'existence des fichiers CSS conerns 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 latral, 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 installe dans votre local/config.php qui peut imprimer un texte diffrent bas sur, par exemple, le groupe ou la page courante. La fonction recoit un nom complet de page (ex. PmWikiFr.MiseEnPagevolue) 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. dmarrant avec "Page" et finissant avec "Fmt") indique le dbut de la section du modle. La section qui suit est place dans une variable du mme nom. Par exemple, <!--PagePiedFmt--> indique le dmarrage 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 dfaut, seuls $PageHeaderFmt, $PageFooterFmt et $PageTitleFmt sont inclus dans une sortie quand une page Wiki est vue. D'autres variables peuvent tre dfinies et utilises, mais elles n'apparaitront que dans certaines situations. Par exemple, <!--/PageEditFmt--> peut tre utilise pour dfinir une section qui n'apparatra 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 values quand PmWiki interprte un fichier de modle. Par exemple, vous pouvez insrer un logo en utilisant $PageLogoFmt, ou crer un lien vers une page d'dition en utilisant <a href='$PageUrl?action=edit'>$[Edit Page]</a>

<< | IndexDocAdmin | >>