Modèle:Ancre

Documentation

Cette documentation est incluse dans la sous-page de documentation (voir | modifier | historique). Si vous voulez améliorer ce modèle et si celui-ci est protégé, demandez à un administrateur de vous aider.

Utilisation

Permet de créer une ancre auquel on peut faire un lien avec [[#nom]] (même page) ou [[titre de page#nom]] (une autre page).

Remarques

Attention :

• Une ancre doit être unique dans une page Web. Par conséquent, il faut donner aux ancres des noms qui garantissent que la même ancre n’apparaîtra pas deux fois lors de la transclusion. Par exemple, on peut choisir des noms qui comprennent le numéro de page : p343_1, p343_2, etc.
• Il faut que le nom de l’ancre contienne au moins une lettre : une ancre dont le nom ne contient que des chiffres et des signes de ponctuation (point, tirets, etc.) sera confondue avec celles créées automatiquement pour marquer les débuts de page, et les liens seront cassés ;
• Avec un seul paramètre, cette ancre est invisible (il est alors équivalent à {{Refancre}}) — il faut mettre un deuxième paramètre si on veut la rendre visible à l’écran, mais le texte visible à l’écran peut être différent du nom de l’ancre ;
• Pour créer automatiquement une ancre dont le nom et l’affichage sont identique, utiliser {{MotAncre}}.

Conseils pour le nom d'une ancre

• N’utilisez que les caractères suivants dans le nom d’une ancre :
  • « a, b, c … z »
  • « A, B, C … Z »
  • « _ » (caractère souligné)
  • « 0, 1, 2 … 9 »
  • Les autres caractères, tels que « , », « ; », « : » et « & », peuvent être confondus par le moteur de Wikisource avec des caractères de contrôle, ce qui provoque le plus souvent des bogues subtils ou difficiles à débusquer. Ne les utilisez pas.

• Le nom de l'ancre doit commencer par une lettre ou un souligné, et jamais par un chiffre.

Vous devez éviter les collisions (c'est-à-dire que deux ancres aient le même nom) en adoptant un système de numérotation. En passant, plus l'ouvrage est long, plus il est hélas ! facile de créer une collision. Voici un système de numérotation qui a fait ses preuves pour moi. Je commence un nom par « p » et le numéro de page (exemple : « p89 ») suivi d'un souligné puis de quelques chiffre (exemple : « p89_6 », pour page 89, sixième note). Ainsi, je sais que l'ancre réfère à la page 89 de l'ouvrage, à la sixième note. Vous pouvez appliquer un autre système ; une fois adopté, soyez systématique et n'utilisez que les caractères mentionnés plus haut. (Conseil de Cantons-de-l'Est sur le Scriptorium le 12 septembre 2021)

 

Syntaxe

{{ancre|nom|texte}}

Paramètres

Permet de créer une ancre auquel on peut faire un lien avec [[#nom]] (même page) ou [[titre de page#nom]] (une autre page)

Paramètres du modèle

La mise en forme sur une seule ligne est préférée pour ce modèle.

Paramètre		Description	Type	Statut
Nom	1	Nom de l’ancre	Chaîne	facultatif
Texte	2	Texte affiché	Chaîne	facultatif

Exemple

Exemple : lien à l’intérieur d’une page

Appel vers l’ancre

Code wiki	Rendu
[[#mon_ancre|'''Cliquez ici''']] pour atteindre la cible	Cliquez ici pour atteindre la cible

Insertion de l’ancre

Code wiki	Rendu
{{Ancre|mon_ancre}} Cible : [[File:WA 80 cm archery target.svg|60px]]	Cible :

Exemple : lien vers une autre page

Code wiki	Rendu
[[L’Homme et la Terre/II/12#c228|L’Inde primitive]] (graphique)	L’Inde primitive (graphique)

Ce lien pointe vers une partie d’une autre page grâce à l’insertion d’une ancre intitulée « c228 » dans la page source.

Voir aussi

• {{Ancre+}}
• {{MotAncre}}
• {{Refancre}}