From 944255f9f0857a5286d88f627c47dd9428a9f810 Mon Sep 17 00:00:00 2001 From: Jonas Smedegaard Date: Thu, 14 Oct 2010 13:38:34 +0200 Subject: Sync with ikiwiki 3.20100926. --- templates.mdwn | 82 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 82 insertions(+) create mode 100644 templates.mdwn (limited to 'templates.mdwn') diff --git a/templates.mdwn b/templates.mdwn new file mode 100644 index 0000000..0bac82a --- /dev/null +++ b/templates.mdwn @@ -0,0 +1,82 @@ +[[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"]] -- cgit v1.2.3