title:   Écrire/créer des liens
about:   Comment écrire des liens pour Tyto - Littérateur
date:    2024-01-08
tags:    format .tyto,écrire,liens
authors: echolib

link:    les URIs spécifiques
         ./metas_uris.html
         Comment cibler un fichier avec les URIs spécifiques des marqueurs pour Tyto - Littérateur

-------------------------------------------------------------------------------
! TOC

#1 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
   )=
))

#2 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.
))

#2 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
))

#2 Les URIs spécifiques
((
   Vous pouvez en lire plus sur ::les URIs spécifiques
))

#2 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
}}