summaryrefslogtreecommitdiff
path: root/templates.mdwn
diff options
context:
space:
mode:
authorJonas Smedegaard <dr@jones.dk>2010-10-14 13:38:34 +0200
committerJonas Smedegaard <dr@jones.dk>2010-10-14 13:38:34 +0200
commit944255f9f0857a5286d88f627c47dd9428a9f810 (patch)
tree7e946cdb321966dec83d2e8bf093a15dc5588e41 /templates.mdwn
Sync with ikiwiki 3.20100926.HEADmasterikiwiki
Diffstat (limited to 'templates.mdwn')
-rw-r--r--templates.mdwn82
1 files changed, 82 insertions, 0 deletions
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 `<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"]]