Écrire/créer des liens

Table des matières

Métadonnées d'entête

Pour créer un lien, il faut d'abord le référencer dans l'entête de l'article, au dessus du séparateur -----. Chaque marqueurs peut-être utilisé plusieurs fois et se configure sur 3 lignes. Mais chaque identité du marqueur doit être unique (tous marqueurs confondus). Il existe 2 types de marqueurs de lien :

• vers une URL / un URI ; marqueur link: uniquement
• vers un fichier interne (PDF, image...) ; autres marqueurs

Lien "link:"

L'URL (ou l'URI) du marqueur link: n'est pas vérifiée. Vous pouvez pointer vers un document interne (comme une autre page du site avec ../doc/index.html), mais n'oubliez pas de vérifier que le lien, dans la page HTML, pointe bien vers le document.

Lien "image:", "file:"

Les marqueurs image: et file: étant destinés à créer des liens vers des ressources internes, ils n'acceptent que les URIs. Tyto vérifie la présence des fichiers pointés dans le dossier de travail

Les URIs spécifiques

Vous pouvez en lire plus sur les URIs spécifiques

Configurer les marqueurs de liens

# De manière générale:
# marqueur: identité
#           URL / URI
#           texte descriptif

# Lien vers une URL ou fichier (interne)
link:    ma page web
         https://... ou ./index.html
         Texte alternatif

# Lien vers un fichier interne
file:    mon fichier
         fichier.pdf
         Texte alternatif

# Lien vers une image interne
image:   mon image
         @paysages/montagne.png
         Texte alternatif