[[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
<TMPL_VAR variable>.
- Pour écrire un bloc de texte si une variable est définie, utilisez
<TMPL_IF variable>texte</TMPL_IF>.
- Pour utiliser un bloc de texte si une variable est définie et un autre
dans le cas contraire, utilisez
<TMPL_IF variable>texte<TMPL_ELSE>autre texte</TMPL_IF>
[[!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"]]
