[[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"]]