La directive inline est fournie par le module d'extension [[!iki
plugins/inline desc=inline]].
Cette directive permet l'inclusion d'une page de wiki dans une
autre. L'utilisation la plus fréquente de cette directive est la création de
blog ou de flux Atom ou RSS.
Exemple :
\[[!inline pages="blog/* and !*/Discussion" show="10" rootpage="blog"]]
Toute page correspondant à la spécification, [[PageSpec]], (dans l'exemple,
toute [[SubPage]] de "blog") fera partie du blog et les dix dernières pages
apparaîtront dans la page. Notez que les fichiers qui, sans être des pages,
correspondent à la spécification, seront inclus dans la diffusion par RSS,
ce qui est utile pour le « podcasting ».
Le paramètre facultatif rootpage indique que les nouveaux messages de ce
blog seront des sous-pages [[SubPages|SubPage]] de "blog". Il active aussi
un formulaire en haut de la page du blog qui permet l'écriture de nouveaux
messages.
Si vous voulez que le blog possède une page d'archive, listant tous les
messages déjà envoyés, voici ce qu'il faut faire :
\[[!inline pages="blog/* and !*/Discussion" archive="yes"]]
Vous pouvez même créer une liste de toutes les pages du wiki, les plus
récentes en tête, comme cela :
\[[!inline pages="* and !*/Discussion" archive="yes"]]
Vous pouvez aussi ajouter des pages à un blog donné en les étiquetant. Pour
étiqueter une page, il suffit de la lier à une ou plusieurs pages qui
représentent cette étiquette. Puis, il faut utiliser une spécification
[[PageSpec]] avec la fonction spéciale link() pour trouver toutes les
pages correspondant à cette étiquette.
\[[!inline pages="link(rugby)"]]
Vous pouvez aussi inclure certaines étiquettes et en exclure d'autres :
\[[!inline pages="link(debian) and !link(social)"]]
Usage
Il est possible d'utiliser beaucoup de paramètres avec la directive
inline . Voici les plus communs :
pages - Une spécification [[PageSpec]] des pages à relier.
show - Indique le nombre maximun de pages correspondantes à relier. Par
défaut, ce nombre vaut 10 sauf pour l'archivage où toutes les pages sont
reliées. La valeur 0 permet d'afficher toutes les pages correspondantes.
archive - Quand ce paramètre vaut "yes", on ne liste que le titre des
pages et certaines métadonnées, pas tout le contenu des pages.
description - donne le nom du flux RSS créé. Par défaut, c'est le nom du
wiki.
skip - Indique un nombre de pages à ne pas afficher. C'est utile pour
produire un flux qui ne montre que les pages archivées.
postform - Quand ce paramètre vaut "yes", le formulaire qui permet de
créer de nouvelles pages sur un blog est activé.
postformtext - Spécifie le texte affiché par le formulaire.
rootpage - Active le formulaire et indique l'endroit où les nouveaux
messages seront placés, en donnant la page dont ils seront des sous-pages.
Voici quelques paramètres moins nécessaires :
actions - Quand ce paramètre vaut "yes", des liens permettant la
modification et la discussion sont ajoutés au bas des pages reliées plutôt
qu'en haut.
rss - Contrôler la création d'un flux RSS. Si le wiki est configuré par
défaut pour créer des flux rss, le mettre à "no" désactive la création de
flux. Si le wiki est configuré avec l'option allowrss , le mettre à
"yes" active la création de flux rss.
atom - Contrôler la création d'un flux Atom. Si le wiki est configuré
par défaut pour créer des flux Atom, le mettre à "no" désactive la
création de flux. Si le wiki est configuré avec l'option allowatom , le
mettre à "yes" active la création de flux Atom.
feeds - Contrôler la création de tout type de flux. Le mettre à "no"
pour désactiver la création de flux.
emptyfeeds - Mettre ce paramètre à "no" pour désactiver toute création
de flux vides. N'a aucun effet si le paramètre rootpage ou le paramètre
postform est activé.
template - Ce paramètre indique le modèle de page à utiliser pour chaque
page reliée. Par défaut le modèle utilisé est inlinepage . Pour les
archives, le modèle utilisé est archivepage . Il est possible d'utiliser
d'autres modèles comme titlepage qui n'affiche que le titre des
messages, ou microblog , optimisé pour le « microblogging », et même de
créer vos propres modèles. Notez que vous devez quand même activer le
paramètre archive, archive=yes , si votre modèle n'inclut pas le contenu
de la page.
raw - Si ce paramètre vaut "yes", la page sera incluse sous sa forme
« brute », sans balisage supplémentaire, comme si elle faisait partie de
la source de la page dans laquelle elle est incluse. Le comportement par
défaut de ce paramètre est de créer un blog.
sort - permet d'indiquer comment les pages liées sont triées
[[sorted|pagespec/sorting]]. Par défaut, les pages les plus récentes sont
triées en premier.
reverse - Si ce paramètre vaut "yes", l'ordre de classement est
renversé.
feedshow - Indique le nombre maximun de pages à inclure dans le flux
RSS/Atom. La valeur par défaut est la même que celle du paramètre show .
feedonly - Ne créer que le flux, ne pas afficher les pages reliées sur
la page.
quick - Construire l'archive en mode rapide, sans chercher les
métadonnées dans le contenu des pages. Cela désactive la création de flux.
timeformat - Ce paramètre permet d'indiquer la manière d'afficher
l'heure ou la date dans les pages de blog. Le format est passé à la
fonction strftime(3).
feedpages - Une spécification [[PageSpec]] des pages à inclure dans le
flux rss/atom. Par défaut, cette valeur est la même que celle du paramètre
pages et seules les pages correspondantes sont incluses, mais une
spécification plus précise peut en exclure certaines.
guid - Si une URI est donnée (peut-être un UUID préfixé, urn:uuid: ),
le flux Atom aura cet identifiant, son <id> . Par défaut, l'URL de la
page contenant la directive inline est utilisée.
feedfile - On peut utiliser ce paramètre pour changer le nom du fichier
créé pour le flux. C'est très utile dans le cas d'une page qui contient
plusieurs flux. Par exemple, indiquez "feedfile=feed" pour créer un
fichier page/feed.atom ou page/feed.rss . Si le wiki est configuré pour
ne pas utiliser usedirs , ce paramètre ne fonctionne pas.
pagenames - Si ce paramètre est utilisé à la place de pages , il est
interprété comme une liste de liens, séparés par des espaces, avec les
mêmes règles [[SubPage/LinkingRules]] que dans un
[[ikiwiki/WikiLink]]. Ces liens sont reliés dans l'ordre dans lequel ils
sont listés : les paramètres sort et pages ne peuvent pas être
utilisés en même temps.
[[!meta robots="noindex, follow"]]
Une directive apparentée à cette directive est
[[ikiwiki/directive/edittemplate]], qui permet d'indiquer un texte par
défaut pour la nouvelle page.
|