Directives
traduction à corriger et compléter
Voir les pages : Include Other Pages? et Markup Master Index?.
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.
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.
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).
Active ou désactive l'espacement automatique des MotsWiki? dans le texte des pages. Quand c'est activé, WikiWord s'affichera "Wiki Word".
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'optionlist=zzzdé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,GroupHeaderetGroupFooter
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
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 documentation? | >>