• Vue
• Éditer
• Historique
• Imprimer
• Référencé par

WikiTrails

La fonctionnalité WikiTrails permet aux auteurs de wikis de créer des "parcours" à travers des séquences de pages. Il suffit de spécifier les pages et leur ordre dans un "index de parcours", puis de placer le balisage de navigation sur les pages à parcourir.

(Ne confondez pas la directive pagelist avec WikiTrails - ce sont deux choses différentes, comme expliqué dans la Q et R ci-dessous.)

Types de trails

PmWiki définit 2 balises de trail, spécifiant un lien vers l'index du trail :

• <<|[[Trail Index Page]]|>> s'affiche comme "<< Page précédente | Page d'index du trail | Page suivante >>".
• <|[[Trail Index Page]]|> s'affiche comme "< Page précédente | Trail Index Page | Page suivante >", sauf que la flèche appropriée est omise au début et à la fin du trail.

et pour un chemin de trail :

• ^|[[TrailIndexPage]]|^

Le balisage est le plus souvent ajouté à un En-tête de page ou à un Pied de page.

Balisage du lien vers la page d'index des trails

Le lien vers la page d'index des trails utilise le même balisage qu'un lien standard link, cela signifie par exemple que vous pouvez spécifier :

• <|[[TrailIndexPage | +]]|>
• <<|[[TrailIndexPage | Une description]]|>>

Les liens de la page d'index des trails peuvent être restreints par ancres (liens pointant vers un emplacement précis dans la page). cela signifie que vous pouvez inclure plusieurs trails sur une même page ou démarrer un trail à partir d'un emplacement spécifique.

• <|[[Page d'index des trails (#débutdutrail#findutrail)]]|>

Création d'un index de trail

Avant de pouvoir utiliser un parcours de navigation, vous devez créer un "index de parcours" sur une page distincte, que nous appellerons "page d'index de parcours". Sur cette page d'index de parcours, il vous suffit de créer une liste de liens numérotée, à puces ou de définition de liste. (Ainsi, toute liste de liens numérotée ou à puces crée implicitement un parcours.)

Il est important que chaque nom de page (lien) soit le premier élément suivant chaque puce ; tout texte ou mise en forme avant le lien du nom de page l'exclura du parcours.
Si vous souhaitez styliser votre index de parcours, vous pouvez inclure une feuille de style CSS.

Un exemple de page d'index de trail pourrait être la liste suivante :

• Installation comment installer
• La page de personnalisation
• PmWiki Autre texte PmWiki Philosophy (Ce dernier élément ne figurera pas dans le trail car il est précédé de texte)
• Autre texte. PmWiki.WikiStyles (Ceci ne figurera pas dans le trail car il suit du texte)
• Uploads (Ceci ne figurera pas dans le tutoriel car il est précédé du style %center%)
• Texte (Ceci ne figurera pas dans le flux car ce n'est pas un lien)
• PageLists Searching and listing pages by multiple criteria with templated output
• https://pmwiki.org (Ceci ne figurera pas dans le flux car ce n'est pas un lien de page)
  • PmWiki:InterMap (Ceci ne figurera pas dans le flux car c'est un lien InterMap)
• Cookbook:Cookbook (Ceci ne figurera pas dans le flux car c'est un lien InterMap)

PmWiki philosophy

Design notes (Le premier lien de cette liste de définitions figurera et le second ne figurera pas dans le flux défini par (liste de définitions))

• Security (Ceci ne sera pas dans le trail car il est précédé d'une ancre cachée)
• Links (Ceci ne sera pas dans le trail car il est précédé d'un style %newwin% masqué)
• Troubleshooting (Ceci ne sera pas dans le flux car il est précédé d'un balisage de style italique masqué)

La liste ci-dessus crée le "wikitrail" suivant, affiché à l'aide d'un pagelist :

(:pagelist trail={$FullName}#trailstart#trailend fmt={$FullName}#traillist:)

Observations

1. En général, l'indentation dans la liste des pages n'a pas d'importance : les trails sont une séquence linéaire de pages.
2. Une page fait partie du trail uniquement si son lien suit immédiatement le balisage de la liste.
3. La liste elle-même peut être délimitée à l'aide de balises anchors, ce qui permet d'afficher plusieurs listes sur une même page ou d'exclure certains éléments.

Utilisation du trail

Ce qui permet à un sentier de "fonctionner", c'est l'ajout de balises de trail sur les pages qui le composent (c'est-à-dire les pages listées dans la liste à puces/numérotée de la page d'index du trail).

Pour créer un trail, ajoutez le balisage de trail suivant : <<|[[TrailIndexPage]]|>> à une page, où TrailIndexPage est la page, décrite précédemment, contenant la liste à puces des pages du trail. PmWiki affichera ce balisage avec des liens vers les pages précédentes et suivantes du parcours.

Le balisage de trail peut être placé n'importe où dans l'en-tête ou le pied de page d'un groupe, ou sur une page. Une page peut contenir plusieurs balises de suivi. Si vous ajoutez un balisage de suivi à chaque page d'un groupe, il est conseillé de le placer dans l'en-tête ou le pied de page du groupe plutôt que sur chaque page individuelle.

Chemin de trail

^|[[TrailIndexPage]]|^ traite les niveaux de la liste comme une hiérarchie et affiche le "chemin" pour atteindre la page actuelle (c'est-à-dire un fil d'Ariane).

• TrailPage1
• TrailPage2
  • TrailPage3
  • TrailPage4

Dans l'exemple de sentier ci-dessus, le balisage ^|TrailIndexPage|^ sur TrailPage4 afficherait "TrailIndexPage | TrailPage2 | TrailPage4".

Les administrateurs du wiki peuvent modifier le séparateur de chemin du sentier de trail ( ^|[[TrailIndexPage]]|^ ) par défaut en définissant la variable $TrailPathSep dans le fichier "config.php". Par exemple, $TrailPathSep = ' > '; affichera « TrailIndexPage > TrailPage2 > TrailPage4 ».

Trails circulaires

s the last item in the trail index:

En général, un parcours est une liste linéaire avec une première et une dernière page. Cependant, on peut rendre le parcours "circulaire" en répétant la première page comme dernier élément de l’index :

 * [[TrailPage1]]
 * [[TrailPage2]]
 ...
 * [[TrailPageN]]
 * [[TrailPage1]]

Si la page d'index du sentier est destinée à être lue par d'autres personnes, le dernier élément peut être rendu invisible à l'intérieur d'un bloc (:if false:) :

 * [[TrailPage1]]
 * [[TrailPage2]]
 ...
 * [[TrailPageN]]
 (:if false:)
 * [[TrailPage1]]
 (:ifend:)

Trails intergroupes

Avant la version 2.2.1, si votre sentier contient des pages appartenant à différents groupes, il doit utiliser des liens complets [[Group.Name]] au lieu de simples liens [[Name]].

Autres remarques

• Il n'y a pas d'espace entre <| et [[link]] et |> ; même chose pour les autres balises de trail.
• Notez que les pages inexistantes apparaitront dans WikiTrail sous forme de liens.
• Conditional markup prend en charge la requête ontrail.
• Page lists fournit le paramètre trail=.

Style de trail

PmWiki encapsule le trail avec une classe CSS wikitrail. Cela permet de personnaliser le WikiTrail en définissant du CSS pour wikitrail dans le fichier local.css.

Trail dans des page lists

Les trails d'une seule page ne peuvent être affichés qu'à l'aide du paramètre pagelist trail. Par exemple :

(:pagelist trail=PmWiki/WikiTrails#trailstart fmt=PmWiki.WikiTrails#traillist order=random,$Name count=3:)

Un exemple simple de WikiTrail

1) Sur la page d'index du trail :

* [[MyTrailPage1]]
* [[MyTrailPage2]]
* [[MyTrailPage3]]

2) Sur les pages MyTrailPage1, 2 et 3 :

<<|[[TrailIndexPage]]|>>

FAQ

Traduction de PmWiki.WikiTrails Page originale sur PmWikiFr.WikiTrails - Référencé par
Dernières modifications:
PmWikiFr.WikiTrails: 21 May 2026 à 10h35
PmWiki.WikiTrails: 12 February 2023 à 11h10