SourceForge.net Logo
January 8, 2007
© GPL
FractalWikiFR - ProWikiCentre
Comment Faire /
Travailler Avec Gabarits


Cette page est destinée aux administrateurs qui veulent régler la mise en page de leur wiki.

Les Gabarits - ou plus exactement - les fichiers gabarit sont la base à partir de laquelle le ProWikiSoftware crée les pages wiki. Généralement un wiki dispose d'un gabarit unique (ok, deux, si vous recensez le gabarit d'impression) qui change rarement au fil du temps. Ainsi seule une personne qui configure les wikis doit connaître les détails.

Le gabarit utilisé est défini par le fichier gabarit TemplateFile. Si le fichier est situé dans un répertoire de téléversement, la définition ressemblera à :

  • TemplateFile=@/upload/BobMorane/template-xyz.html
de manière (en supposant que vous êtes l'administrateur Bob Morane) à ce que vous puisssiez téléverser et modifier le gabarit. Pour bricoler le gabarit, installez une page de test et déposez cette commande à l'intérieur de sa ContextPage. Après avoir vérifié que le nouveau gabarit fonctionne, copiez cette commande vers la page context du niveau le plus haut top.

Un fichier gabarit est techniquement une page HTML normale. Il contient un certain nombre de marqueurs d'insertions comme {PageTitle} ou {PageText} indiquant au logiciel où placer les parties dynamiques. Tous les marqueurs d'insertion sont encadrés entre accolades. Tous les marqueurs d'insertion sont remplacés par du contenu ou rien (si le marqueur d'insertion est faux ou s'il n'existe pas de contenu disponible).

Marqueurs d'insertion prédéfinis / variables

Marqueurs d'insertion prédéfinisRequisRésulte dans l'insertion de
PageTitleouila page titre ou le nom de l'action (par ex : chercher)
PageTitleCommentouiil est généralement vide, parfois peut contenir de l'information complémentaire (par ex. le texte de redirection)
PageTextouile texte de la page ou le résultat d'une action
LinkBarTextHor(1)la barre dynamique de lien, texte seulement, horizontale
LinkBarTextVer(1)la barre dynamique de lien, texte seulement, verticale
DateCurnondate en cours
DateLastChangenondate de la dernière modification de la page
EditBarnonutilisée en option avec une barre de lien horizontale
SearchFormnonpetit formulaire de recherche qui peut être utilisé sur n'importe quelle page
WikiNameouiutilisé pour les méta-tags, nommage de la fenêtre du navigateur et des signets, même résultat que {Insert:SiteName}
WikiCopyrightnonaffiche le texte de copyright, même résultat que le {Insert:WikiCopyright}
...  
LogoFilenoninsère l'image définie dans la variable configuration LogoUrl
LogoDecnoninsère l'image définie dans la variable de configuration LogoUrl, l'image pointe vers la page d'accueil du wiki (ou vers la commande d'édition si vous êtes administrateur, pratique pour les wikis sans une barre de lien comme le WikiWeb:action=FrontPage)

(1) ... un de ces groupes de marqueurs d'insertions est requis.

Les marqueurs d'insertion peuvent être utilisés plus d'une fois à l'intérieur d'un gabarit unique. (par ex : la barre de liens est parfois placé en haut et en bas de la page).

Variables d'insertion auto-définies

En utilisant des marqueurs comme {Insert:VariableName[;valeur optionnelle par défaut]} on peut utiliser n'importe quelle variable qui est connue dans le script ou qui est définie dans un fichier de configuration ou dans la page context.

De telles variables auto-définies sont utiles par exemple pour maintenir des couleurs définies, des largeurs de lignes, des largeurs de tableaux,... ce que vous voulez.


LangueFrançaise PageTranslation ProWiki:HowTo/WorkWithTemplates DossierLayout