# La syntaxe des liens
(⭢ comment [[entrer des liens dans le texte]])
 
L’essence-même d’un système de *gestion personnelle des connaissances* ([[gestion personnelle des connaissances|PKM]]), c’est l’écriture et la création des liens entre des fiches ou vers des objets (pages web, images, graphiques, documents PDF, etc.). Il y en a deux types et voici leurs syntaxes respectives. (Vous n’allez bien sûr pas chercher à mettre en couleur dans le texte pur ; c’est juste pour aider à la compréhension que j’ai mis des couleurs !)
### Liens internes
Dans le contexte d’un vrai logiciel de gestion de la connaissance tel qu’*Obsidian*, le type de liens qu’on utilisera le plus, ce sont les liens *internes*, c’est-à-dire des liens qui pointent vers d’autres fiches du même coffre. En référence à *Wikipedia*, on les appelle des *[[wikilink|wikilinks]]* et ils ressemblent à ceci : on écrit le *nom de la fiche* entre des crochets doubles, ainsi :
![[Wikilink simple.jpg]]
<br>Il arrive assez souvent que le texte que l’on veut voir affiché dans le texte, ce ne soit pas exactement le nom de la fiche. On utilise alors cette syntaxe :
![[Wikilink complet.jpg]]
* en vert : le nom de la fiche ; suivi d’…
* une [barre verticale](https://fr.wikipedia.org/wiki/Barre_verticale) (*pipe* en anglais ; ⌥⃣ 7 sur *Mac*) ; suivie du
* texte qu’on veut voir dans le texte (en bleu).
Par exemple, je veux vous parler de `Bach`, le compositeur, et je dois pointer vers une fiche qui s’appelle `Bach, Johann Sebastian`. Dans le texte, je vais écrire ceci :
![[Wikilink, Bach.jpg]]<br>
### Liens externes
On appelle *liens externes* les liens qui pointent vers des objets extérieurs au coffre courant ; ce peut être des liens vers des pages web, des images sur un serveur, une fiche d’un autre coffre *Obsidian*. La syntaxe est la suivante :
![[External link, général.jpg]]
* première partie : entre crochets, le texte qu’on veut voir apparaître dans le texte (partie bleue) ;
* collé juste après, entre parenthèses : le lien lui-même.
Voici, en guise d’exemple, un lien vers le [site internet d’*Obsidian*](https://obsidian.md). Je viens d’écrire ce lien ainsi :
![[External link, Obsidian.jpg]]<br>
Remarquez qu’à l’intérieur des crochets, j’ai pu utiliser la syntaxe *Markdown* pour mettre en italique “Obsidian”.
Une astuce très utile, c’est qu’il est aussi possible d’écrire des liens vers d’autres objets, en utilisant la même syntaxe. Ce qu’il nous faut, c’est une « adresse unique » d’un objet, c’est-à-dire son URL ([Uniform Resource Locator](https://fr.wikipedia.org/wiki/Uniform_Resource_Locator)). Tous les programmes n’offrent pas cette possibilité, mais c’est le cas de *DEVONthink* et d’*Ulysses*, par exemple. Dans *DEVONthink*, on sélectionne un objet — une fiche, une image, un dossier, etc. — et l’on active la commande `Edit > Copy Item Link`. On peut alors l’utiliser ainsi :
![[External link, DEVONthink.jpg]]
Vous remarquez que c’est exactement la même syntaxe, mais au lieu que le lien commence par `HTTPS`, il commence par `x-devonthink-item`. C’est ce que l’on appelle un “x-callback link”, vous n’avez pas forcément besoin de le savoir, mais c’est ce qu’il vous faudra rechercher, dans le manuel des logiciels que vous utilisez, pour savoir si tel ou tel logiciel propose cette possibilité. Dans *Ulysses*, on appuie sur ⌥⃣ et on fait un clique-droit sur une feuille dans la librairie ; on a alors, dans le menu local, le choix `Copy Callback URL` qui nous donne exactement ce dont on a besoin pour créer un lien ainsi :
![[External Link, Ulysses.jpg]]<br>
C’est très pratique pour avoir, dans des fiches « gestion de projet » des liens vers des textes en cours d’écriture ou vers des dossiers *DEVONthink* qui contiennent du matériel de référence — PDF, etc. Ainsi, il suffit de cliquer sur le lien et on a un accès direct à ce dont on a immédiatement besoin.
⭢ comment [[entrer des liens dans le texte]] — il existe bien sûr des facilités qui nous évitent de savoir tout cela par cœur !
 
<p style="text-align: center; font-style: italic;">~~ Olivier Spinnler, le 30 octobre 2021
 ~~</p>
----------------------------------------------
[[comment fait-on pour…]] ✦ [[Obsidian]]
#Obsidian #écriture #markdown