Franz von Sales | PmWikiFr / Directives

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

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

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';

voir aussi:Cookbook:SearchResults

(:searchbox:)

Affiche une boîte de recherche à cet endroit.

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

voir aussi:Cookbook:SearchResults

...

...

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

From Franz von Sales

PmWikiFr: Directives