Comment Faire /
Travailler Avec Gabarits
(redirection de 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éfinis | Requis | Résulte dans l'insertion de |
PageTitle | oui | la page titre ou le nom de l'action (par ex : chercher) |
PageTitleComment | oui | il est généralement vide, parfois peut contenir de l'information complémentaire (par ex. le texte de redirection) |
PageText | oui | le 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 |
DateCur | non | date en cours |
DateLastChange | non | date de la dernière modification de la page |
EditBar | non | utilisée en option avec une barre de lien horizontale |
SearchForm | non | petit formulaire de recherche qui peut être utilisé sur n'importe quelle page |
WikiName | oui | utilisé pour les méta-tags, nommage de la fenêtre du navigateur et des signets, même résultat que {Insert:SiteName} |
WikiCopyright | non | affiche le texte de copyright, même résultat que le {Insert:WikiCopyright} |
... | | |
LogoFile | non | insère l'image définie dans la variable configuration LogoUrl |
LogoDec | non | insè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
|