Modèle:Ancre/documentation
Utilisation
[modifier]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
[modifier]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}}
.
- 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
[modifier]{{ancre|nom|texte}}
Paramètres
[modifier]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ètre | Description | Type | État | |
---|---|---|---|---|
Nom | 1 | Nom de l’ancre | Chaîne | facultatif |
Texte | 2 | Texte affiché | Chaîne | facultatif |
Exemple
[modifier]Exemple : lien à l’intérieur d’une page
[modifier]Appel vers l’ancre
[modifier]Code wiki | Rendu |
---|---|
[[#mon_ancre|'''Cliquez ici''']] pour atteindre la cible |
Cliquez ici pour atteindre la cible |
Insertion de l’ancre
[modifier]Code wiki | Rendu |
---|---|
{{Ancre|mon_ancre}} Cible : [[File:WA 80 cm archery target.svg|60px]] |
Cible : ![]() |
Exemple : lien vers une autre page
[modifier]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.