Lien#

Syntaxe classique#

Pour définir un lien, il faut respecter la syntaxe suivante:

• [Texte_du_lien](URL_du_lien)

[Je suis un lien relatif vers une autre page (du même répertoire) du site](image/)

[Je suis un lien relatif vers une autre page (page parente) du site](./)

[Je suis un lien absolu vers une autre page du site](/markdown/image/)

[Je suis un lien absolu vers une ressource statique du site](/images/favicon.png)

[Je suis un lien vers un ID de titre](#lien)

[Je suis un lien vers la page d'accueil](/)

[Je suis un lien vers la page d'accueil d'une autre langue](/fr/)

[Je suis un lien externe](https://www.google.com)

Syntaxe classique avec titre#

Pour définir un lien avec un titre, il faut respecter la syntaxe suivante:

• [Texte_du_lien](URL_du_lien "Titre_du_lien")

[Je suis un lien](#syntaxe-classique-avec-titre "Et moi son titre")

Syntaxe alternative#

Pour définir un lien externe il est possible d’utiliser des syntaxes alternatives:

• Ecrire l’URL du lien (le rendu sera automatiquement réalisé par le convertisseur markdown).
• Entourer l’URL du lien entre les caractères inférieur (<) et supérieur (>).

https://www.google.com

<https://www.google.com>

<foo@bar.com>

Echapper un lien#

Pour échapper un lien (faire apparaitre une URL en tant que texte) et éviter son rendu automatique par le convertisseur markdown, il est possible d’utiliser des syntaxes alternatives:

• Ajouter une apostrophe inversée (`) avant et après l’URL du lien (Définir le lien en fragment de code).
• Echapper le premier slash (/) de l’URL du lien.

`https://www.google.com`

https:\//www.google.com

Accentuer un lien#

Pour accentuer un lien, il faut entourer le code markdown du lien par le code d’acccentuation choisi. Dans le cas d’un lien en fragment de code il faut placer les parenthèses inversées (`) à l’intérieur du texte du lien (entre les crochets).

*[Je suis un lien en italique](/markdown/link/)*

**[Je suis un lien en gras](/markdown/link/)**

***[Je suis un lien en italique et en gras](/markdown/link/)***

[`Je suis un lien en fragment de code`](/markdown/link/)

Lien référencé#

Pour définir un lien dont l’URL est référencée (donc réutilisable), il faut formater le lien en 2 parties.

• Première partie (texte du lien)

  Pour définir la première partie du lien, qui correspond au texte qui sera rendu et fait le lien avec une référence d’URL à définir dans la deuxième partie, il faut respecter la syntaxe suivante:

  • [Texte_du_lien][Référence_de_l’URL_du_lien]
  La référence de l’URL du lien n’est pas sensible à la casse et peut contenir des caractères alphanumériques, des espaces et de la ponctuation.

• Deuxième partie (référence du lien)

  Pour définir la deuxième partie du lien, qui fait le lien entre la référence de l’URL du lien définie dans la première partie, et la valeur de l’URL, il faut respecter une des syntaxes suivantes:

  • [Référence_de_l’URL_du_lien]: URL_du_lien
  • [Référence_de_l’URL_du_lien]: URL_du_lien "Titre_du_lien"
  • [Référence_de_l’URL_du_lien]: URL_du_lien 'Titre_du_lien'
  • [Référence_de_l’URL_du_lien]: URL_du_lien (Titre_du_lien)
  • <[Référence_de_l’URL_du_lien]>: URL_du_lien "Titre_du_lien"
  • <[Référence_de_l’URL_du_lien]>: URL_du_lien 'Titre_du_lien'
  • <[Référence_de_l’URL_du_lien]>: URL_du_lien (Titre_du_lien)
  La deuxième partie du lien peut-être placée à n’importe quel endroit dans le document. Par exemple toutes les références d’un document peuvent être regroupée à la fin d’un document pour des raisons de lisibilité et de simplicité.

[Je suis un lien][Référence A]

[Je suis un second lien][Référence A]

Je suis un texte tout seul

[Référence A]: #lien-référencé

[Je suis un lien][Référence A]

[Je suis un second lien][Référence A]

Je suis un texte tout seul

[Référence A]: #lien-référencé "Et moi son titre"

[Je suis un lien][Référence A]

[Je suis un second lien][Référence A]

Je suis un texte tout seul

[Référence A]: #lien-référencé 'Et moi son titre'

[Je suis un lien][Référence A]

[Je suis un second lien][Référence A]

Je suis un texte tout seul

[Référence A]: #lien-référencé (Et moi son titre)

[Je suis un lien][Référence A]

[Je suis un second lien][Référence A]

Je suis un texte tout seul

[Référence A]: <#lien-référencé> "Et moi son titre"

[Je suis un lien][Référence A]

[Je suis un second lien][Référence A]

Je suis un texte tout seul

[Référence A]: <#lien-référencé> 'Et moi son titre'

[Je suis un lien][Référence A]

[Je suis un second lien][Référence A]

Je suis un texte tout seul

[Référence A]: <#lien-référencé> (Et moi son titre)

Lien avec espace#

Pour définir un lien dont l’URL contient des espaces, il faut encoder l’URL avec le code en pourcentage associé au caractère espace (%20).

[Themes Hugo](https://www.google.com/?query=Themes%20Hugo)

ID d’un lien (Spécificité du thème)#

Pour définir l’ID d’un lien, il faut écrire un lien en suivant la syntaxe classique avec titre . L’ID est rajouté au lien automatiquement (à l’aide du thème) et aura pour valeur la sortie de la fonction anchorize de Hugo avec en entrée la valeur du titre du lien:

• [Texte_du_lien](URL_du_lien "Titre_du_lien")

[Je suis un lien](#id-dun-lien-spécificité-du-thème "Et moi son titre")

Ref/Relref#

Pour définir un lien en utilisant ref ou relref, il faut suivre la syntaxe par défaut des shortcodes intégrés à Hugo .

[Je suis un lien ref]({{%/* ref "image/" */%}})

[Je suis un lien ref avec des paramètres nommées]({{%/* ref path="image/" lang="fr" outputFormat="html" */%}})

[Je suis un lien relref]({{%/* relref "image/" */%}})

[Je suis un lien relref avec des paramètres nommées]({{%/* relref path="image/" lang="fr" outputFormat="html" */%}})