====== Fil d'Ariane ou les miettes du Petit Poucet ======

Dans DokuWiki vous n'êtes jamais perdu car, comme le [[wpfr>Petit Poucet]], vous laissez des traces de miettes de pain (//breadcrumbs// en anglais) derrière vous. Mais à l'inverse du conte de fées, il n'y a pas d'oiseaux pour venir les picorer ce qui fait que vous gardez toujours une trace de ce que vous avez fait. Ces traces se trouvent en haut à gauche des pages dans le thème par défaut. 

En français, on parle volontiers de [[wpfr>fil d'Ariane]], en référence au labyrinthe mythologique.

===== Type de pistes =====

DokuWiki peut afficher deux types de pistes: la piste (ou trace) ou le modèle hiérarchique.

==== Piste ====

C'est le choix par défaut. La piste affiche les pages qui viennent d'être consultées sur le wiki. C'est particulièrement pertinent lorsque le site n'utilise pas de [[fr:namespaces|catégorie]]. Les traces sont préfixées, dans leur présentation par défaut, par ''Trace: *''.

Le nombre de traces à afficher peut être configuré par la variable [[fr:config:breadcrumbs|breadcrumbs]].

==== Hiérarchie ====

Le modèle hiérarchique est plus plus couramment utilisé pour des CMS utilisant des structures de navigation avec plusieurs niveaux de profondeur. Si votre wiki est organisé de manière strictement hiérarchique à l'aide d'espaces de noms, vous pourriez être intéressés à ce type de présentation. La hiérarchie est préfixées, dans sa présentation par défaut, par ''Vous êtes ici: *''.

La hiérarchie peut être activée par la variable [[fr:config:youarehere|youarehere]].

===== Configuration =====

  * [[fr:config:breadcrumbs|breadcrumbs]] (mettre à 0 pour désactiver)
  * [[fr:config:youarehere|youarehere]]

===== Développement =====

Les fils d'Ariane sont stockés dans la session utilisateur. Les développeurs de [[fr:template|modèles (templates)]] devraient s'assurer de fournir un espaces pour les deux types de pistes en utilisant les 2 fonctions ''tpl_breadcrumbs()'' et ''tpl_youarehere()''.