Directives

traduction noe 19 février 2005 à 07h54 merci de corriger et compléter

voir les pages : PmWiki.IncludeOtherPages et balises spéciales

Voir aussi l'index des balises.

PmWiki utilise la séquence de balise (:directive ...:) pour nombre de directives et des substitutions de texte. Nombre de ces directives remplacent les directives à "double-crochet" qui étaient utilisées dans PmWiki 1.0 et les versions antérieures. Voici une brève description de chacune de ces directives.

(:title texte:)

Définit un titre de page différent de son nom. Par exemple, la syntaxe
(:title Accueil site Patrick:)
utilise "Accueil site Patrick" comme titre de page dans la barre de titre du navigateur (balise HTML <title>) et la zone de titre de la page (variable $PageTitle). Noter que les apostrophes et les caractères spéciaux peuvent être utilisés ici.

(:keywords Mot clés, ...:)

Définit les mots clés d'une page dans une balise HTML <meta name='keywords' content='mot clé, ...' /> .

(:include NomDeLaPage:) et (:include NomDeLaPage#début#fin:)

Inclut le contenu d'une autre page dans le texte de la page courante. La seconde forme est utilisée pour inclure une portion de page située entre les ancres #début et #fin.
On peut spécifier un ensemble de lignes à utiliser pour la directive ->(:include:) de la manière suivante :
(:include UnePage :) - inclut la totalité de UnePage
(:include UnePage lines=10 :) - inclut les lignes 1-10 de la page UnePage
(:include UnePage lines=1..10 :) - inclut les lignes 1-10 de la page UnePage
(:include UnePage lines=6..10 :) - inclut les lignes 6-10 de la page UnePage
(:include UnePage lines=6.. :) - inclut les lignes 6 à la fin de la page UnePage
(:include UnePage lines=6..6:) - inclut seulement la ligne 6 de la page UnePage

(:noheader:), (:nofooter:), (:notitle:), etc.

Ces directives désactivent l'en-tête de page, le pied de page, et la partie titre du modèle de la page (si cette partie existe dans le modèle).

(:(no)spacewikiwords:)

Active ou désactive l'espacement automatique des MotsWiki dans le texte des pages. Quand c'est activé, WikiWord s'affichera "Wiki Word".

(:(no)linkwikiwords:)

Active ou désactive la liaison des MotsWiki nus avec les pages de même nom.

(:if cond param:)

La syntaxe (:if cond param:) permet à des portions du texte à balise d'être traitées de manière conditionnelle (jusqu'au prochain (:if:)) en fonction de conditions définies par l'administrateur. Les conditions prédéfinies sont "true", "false", "group", et "name". Par exemple,
(:if group PmWiki:) Ce texte ne s'affiche que dans le groupe PmWiki(:if:)
Pour plus de détails, voir PmWiki.Conditional Markup.

(:pagelist group=xxx fmt=yyy list=zzz:)

La syntaxe (:pagelist ..:) permet d'inclure une liste à puce des noms de pages qui sont dans le groupe spécifié. Le groupe et les noms des pages sont affichés comme des liens.
group=xxx
optionnel, xxx = nom du groupe dont les pages doivent être incluses dans la liste
Question: peut-on aussi donner des noms de pages, par exemple avec regex ou un préfixe pour le nom : Group\.PREF.* = toutes les pages du goupe "Group" commençant par "PREF"
Réponse: Non, juste des groupes et pas des pages. Il y aura peut-être une nouvelle option ajoutée pour permettre de spécifier des noms complets avec regex. De plus il y a l'option list=zzz décrite ci-dessous qui permet des listes quelconques.
fmt=yyy
optionnel, yyy =
bygroup
par défaut, niveau 1 liste chaque groupe, niveau 2 liste les pages des groupes
simple
une ligne par page en utilisant le nom complet de la page: "* groupname.pagename", pas d'en-tête de groupe.
voir aussi le Cookbook
Index alphabétique
list=zzz
optionnel, zzz =
normal
n'inclut pas dans la liste les pages spéciales comme RecentChanges, GroupHeader et GroupFooter
Vous pouvez utiliser
(:pagelist:) pour avoir la liste de toutes les pages,
(:pagelist group=PmWiki:) pour avoir la liste de toutes les pages du groupe PmWiki,
(:pagelist group={$Group}:) pour avoir la liste de toutes les pages du groupe courant,
(:pagelist group={$Group} list=normal:) pour avoir la liste de toutes les pages du groupe courant sauf GroupHeader, GroupFooter, RecentChanges etc
à partir des emails:
Pour RecentPages, j'ai juste ajouté dans mon fichier local/config.php:
(Il doit y avoir deux espaces entre le lien wiki et le texte qui suit -> Coupé&Collé à partir du source, et non de la vue html.)
$RCTime = strftime('%b %d %H:%M',$Now);
$RecentChangesFmt['Main.RecentPages'] = ':[[$FullName]]: $RCTime';

(:searchbox:)

Affiche une boîte de recherche à cet endroit.

(:searchresults group=xxx fmt=yyy list=zzz text:)

...

...

Peut être utilisé pour les exemples d'emploi des balises, montre la balise puis le résultat de son utilisation. voir Règles de formatage des textes pour des exemples.

<< Index des balises | Index documentation | Balises spéciales >>


Traduction de Directives - Page originale sur PmWiki:PmWikiFr.Directives