Les permaliens sont des liens directs vers des tiddlers individuels à l'intérieur d'un TiddlyWiki.
La forme simple des permaliens
La forme la plus simple d'un permalien () vers un tiddler cible unique est son nom précédé de "#" accolé au lien URL de base :
https://tiddlywiki.com/#HelloThere
Le titre du tiddler peut contenir des espaces si nécessaire :
https://tiddlywiki.com/#Using TiddlyWiki on Node.js
Remarquez que les doubles crochets ne sont pas requis autour du titre du tiddler cible ; cependant, s'ils sont présents ils seront supprimés automatiquement.
(NDT : Attention en cas de traduction, le lien doit pointer vers le titre original title et pas vers le titre traduit affiché qui ne reflète que le contenu du champ fr-title)
Permaliens vers un déroulé
Le permalien peut aussi spécifier la liste de tiddlers qui seront ouverts dans le déroulé en plus du tiddler cible, à l'aide d'un filtre :
https://tiddlywiki.com/#TiddlerFields:Tiddlers TiddlerTags TiddlerFields ContentType
Si le tiddler cible est absent de la liste, il est alors automatiquement inséré au début du déroulé. Ce qui veut dire que les exemples suivants désignent tous les deux le tiddler Tiddlers dans le déroulé Tiddlers, Tags, TiddlerFields :
https://tiddlywiki.com/#Tiddlers:Tags TiddlerFields
https://tiddlywiki.com/#Tiddlers:Tiddlers Tags TiddlerFields
Il est aussi possible de spécifier un filtre sans spécifier de tiddler cible de navigation :
https://tiddlywiki.com/#:[tags[task]]
Concernant le codage URL
Il existe des restrictions techniques aux caractères autorisés dans un adressage URL. Afin de permettre à tous les titres de tiddler d'être adressés, les caractères illégaux font l'objet d'un processus appelé « codage URL » où les caractères problématiques sont remplacés par leurs codes numériques. Par exemple, le caractère espace est remplacé par %20.
Aussi bien le tiddler cible que le déroulé filtre devraient être encodés (mais pas le séparateur « : »). TiddlyWiki génère des URLs encodées correctement qui peuvent paraître un peu "moche". Cependant, dans la pratique les navigateurs parviennent heureusement à interpréter parfaitement des caractères arbitraires dans les extraits URL. De ce fait, quand vous créez des permaliens manuellement vous pouvez choisir d'ignorer le codage URL.
Comportement de TiddlyWiki avec les Permaliens
Deux aspects importants du comportement de TiddlyWiki avec les permaliens peuvent être réglés avec les options de l'onglet Réglages avancés du $:/ControlPanel :
- d'une part la mise à jour automatique de la zone d'adresse à chaque navigation, et dans ce cas s'il faut inclure la séquence du déroulé aussi bien que le tiddler cible
- d'autre part si les mises à jour de la zone d'adresse doivent affecter l'historique du navigateur. Par défaut, c'est non ; mais lorsque oui est sélectionné, vous pouvez reprendre votre navigation entre les tiddlers en utilisant les boutons avancer et reculer du navigateur
Notez que saisir un permalien ou s'y rendre causera toujours le traitement du permalien, ainsi que l'ouverture et la fermeture des tiddlers appropriés en fonction de son contenu.
Détails techniques
Quand TiddlyWiki se lance il traite les permaliens selon les étapes ci-dessous ; ces même étapes sont répétées dynamiquement lors des modifications du permalien (ce qui survient en réaction à l'édition de la barre d'adresse par l'utilisateur, par exemple).
- Si le permalien contient un « : », traiter la chaine précédente comme la cible et la chaine qui suit comme le filtre du déroulé
- Si « : » est absent, traiter toute la chaine comme la cible et marquer le filtre du déroulé comme non-spécifié
- Si le filtre du déroulé est non-spécifié pendant le processus de lancement, alors mettre une chaine vide dans le filtre du déroulé si la cible est spécifiée, ou les tiddlers par défaut si la cible n'est pas spécifiée
- Si le filtre du déroulé est non-spécifié hors du processus de lancement, alors affecter le filtre du déroulé au déroulé actuel
- Évaluer le filtre du déroulé comme liste du déroulé
- Si la cible est spécifiée et absente de la liste du déroulé alors l'ajouter au début
- Si la cible est spécifiée alors s'y rendre, autrement naviguer au premier tiddler de la liste du déroulé