[[Ikiwiki]] se sert de modèles dans beaucoup de cas. En modifiant ces modèles, vous pouvez « personnaliser » ce wiki. Les modèles sont situés dans le répertoire `/usr/share/ikiwiki/templates`. Le paramètre `templatedir` peut être utilisé pour commencer la recherche dans un autre répertoire. Des modèles personnalisés peuvent être placés dans dans le sous-répertoire `templates/` du répertoire source du wiki. Ikiwiki utilise le module HTML::Template pour créer ses modèles. Ce module, facile à étudier, permet l'utilisation de conditions et de boucles. Voici ce que vous avez besoin de savoir : * Pour insérer la valeur d'une variable, sans que la syntaxe wiki soit convertie en HTML, utilisez ``. * Pour écrire un bloc de texte si une variable est définie, utilisez `texte`. * Pour utiliser un bloc de texte si une variable est définie et un autre dans le cas contraire, utilisez `texteautre texte` [[!if test="enabled(template)" then=""" ## pages modèles La directive [[!iki ikiwiki/directive/template desc="template"]] permet d'utiliser des pages de wiki comme modèles. Ces modèles peuvent être remplis et insérés dans d'autres pages du wiki. """]] [[!if test="enabled(edittemplate)" then=""" ## contenu par défaut des nouvelles pages La directive [[!iki ikiwiki/directive/edittemplate desc="edittemplate"]] permet que le contenu par défaut des nouvelles pages soit le texte d'une page modèle, qui peut être remplie en même temps que la page est modifiée. """]] [[!if test="enabled(template) or enabled(edittemplate)) and enabled(inline)" then=""" [[!inline pages="templates/* and !*.tmpl and !templates/*/* and !*/discussion" feeds=no archive=yes sort=title template=titlepage rootpage=templates postformtext="Ajouter un nouveau modèle :"]] """]] ## modèles du wiki Ces modèles permettent la construction du wiki. Le but est de mettre presque tout le formatage HTML dans des modèles, hors de ikiwiki. * `page.tmpl` - permet d'afficher toutes les pages normales du wiki. C'est le principal modèle à modifier. [[!if test="enabled(pagetemplate)" then=""" (La directive [[!iki ikiwiki/directive/pagetemplate desc="pagetemplate"]] permet d'utiliser un modèle différent de `page.tmpl`.)"""]] * `rsspage.tmpl` - permet la création de flux RSS pour les blogs. * `rssitem.tmpl` - permet la création d'éléments individuels dans les flux RSS. * `atompage.tmpl` - permet la création de flux Atom pour les blogs. * `atomitem.tmpl` - permet la création d'éléments individuels dans les flux Atom. * `inlinepage.tmpl` - permet l'affichage d'un message dans un blog. * `archivepage.tmpl` - permet de lister une page dans une page d'archive de blog. * `titlepage.tmpl` - permet de lister une page par son titre dans une page d'archive de blog. * `microblog.tmpl` - permet de montrer un message de microblog au fil du texte. * `blogpost.tmpl` - offre un formulaire pour ajouter un message dans un blog (avec des liens RSS/Atom) * `feedlink.tmpl` - permet d'ajouter des liens RSS/Atom quand `blogpost.tmpl` n'est pas utilisé. * `aggregatepost.tmpl` - modèle utilisé par le module aggregate pour créer une page de blog. * `searchform.tmpl`, `googleform.tmpl` - modèles utilisés par les modules search et. google pour ajouter un formulaire de recherche dans les pages de wiki. * `searchquery.tmpl` - C'est un modèle Omega, utilisé par le module search. * `comment.tmpl` - modèle utilisé par le module comments pour afficher un commentaire. * `change.tmpl` - permet la création d'une page décrivant une modification du wiki. * `recentchanges.tmpl` - permet de lister une modification sur la page RecentChanges. * `autoindex.tmpl` - modèle utilisé par le module autoindex pour créer des pages d'index. * `autotag.tmpl` - modèle utilisé par le module tag pour créer des pages avec étiquette. * `calendarmonth.tmpl`, `calendaryear.tmpl` - modèles utilisés par le module ikiwiki-calendar pour créer les pages d'archives des agendas. * `editpage.tmpl`, `editconflict.tmpl`, `editcreationconflict.tmpl`, `editfailedsave.tmpl`, `editpagegone.tmpl`, `pocreatepage.tmpl`, `editcomment.tmpl` `commentmoderation.tmpl`, `renamesummary.tmpl`, `passwordmail.tmpl`, `openid-selector.tmpl` - modèles faisant partie de l'interface utilisateur d'ikiwiki'. Il n'y a en général aucun besoin de les personnaliser. [[!meta robots="noindex, follow"]]