[go: up one dir, main page]

info Documentation du modèle
Logo du langage Lua
Ce modèle utilise le Module:clé de tri, un script écrit dans le langage de programmation Lua. Toute expérimentation devrait être conduite d’abord via une sous-page bac à sable ou dans votre espace utilisateur.

Par défaut, les entrées sont classées dans les catégories selon un ordre automatiquement défini, souvent convenable pour les langues utilisant l’alphabet latin notamment. Mais parfois, il est nécessaire d’outrepasser ce tri automatique qui ne convient pas, en utilisant ce qu’on appelle une clé de tri.

Ce modèle ne s’utilise en principe que dans l’espace principal (les articles).

Pourquoi ajouter une clé de tri à un article ?

Le tri par défaut convient bien dans la plupart des cas pour des langues comme le français, l’anglais ou l’italien. Mais pour des langues comme le suédois, où le ö est une lettre à part entière qu’on trouve en fin d’alphabet, et non une simple variante de o, il convient de définir une clé de tri forçant le classement de ö en fin d’alphabet, autrement il serait classé avec les o.

En bref, tous les articles dont le nom contient des caractères spéciaux (apostrophe, trait d’union, certaines lettres à diacritiques selon la langue…) doivent avoir une clé de tri. De même, tous les articles dont le nom ne contient pas de caractères spéciaux ne doivent pas avoir de clé de tri.

Elle se place par convention tout en bas (et donc après les catégories).

Tri par défaut

  • Par défaut, l’ordre est celui que l’on connaît en français, c’est-à-dire A-Z.
  • Par défaut, les chiffres viennent avant les lettres dans le classement. C’est le comportement désiré, en général.
  • Par défaut, les diacritiques sont ignorés.

Il en découle que le modèle forme les clés de tri comme suit :

Français

En français, les cas majeurs où le modèle est nécessaire sont les suivants :

  • apostrophe ;
  • le trait d’union et les signes de ponctuation, tels que virgule, barre oblique, etc. (à remplacer par une espace dans la clé de tri).

Le modèle supprime l’apostrophe de la clé de tri et remplace le trait d’union et les autres signes de ponctuation par des espaces (si deux espaces contiguës ou plus sont ainsi générées, le modèle les remplace par une seule).

Il suffit d’ajouter {{clé de tri}} à la page. Spécifier la clé de tri en argument ne devrait être requis que dans de rarissimes cas.

Langues étrangères

Pour les langues dont le tri diffère du tri en français, en plus des règles pour le français, le modèle suit les règles suivantes :

Par défaut, tous les diacritiques sont ignorés. Par exemple, ö et o sont classés de la même façon. C’est le comportement désiré en français (si tant est que ö apparaisse dans un mot, ce qui est rare), mais pas en suédois, où ö est une lettre située en fin d’alphabet.

Dans ce dernier cas, le modèle force ö à être classé après z, en général en ajoutant un signe supplémentaire après z : « z⿕ » par convention, « ⿕ » étant le caractère de point de code le plus élevé. Pour connaître la clé utilisée pour chaque lettre, il convient de consulter la table des matières de la catégorie pour la langue en question. On remarque par exemple dans la table des matières de Catégorie:suédois, qu’en suivant le lien sur une des lettres å, ä ou ö, on atterrit sur une page dont l’URL contient « &from=z⿕ » (exemple pour « å »). Cela signifie que « å » est classé par convention comme « z⿕ ». De même, « ä » est classé comme « z⿕⿕ » et « ö » comme « z⿕⿕⿕ ». Un mot comme öl devrait donc avoir comme clé de tri en suédois « z⿕⿕⿕l ».

  • alt = attention Attention, toutes les langues n’ont pas encore une table des matières au point. N’hésitez pas dans ces cas-là à prendre des initiatives pour corriger le tir ou à demander de l’aide sur Wiktionnaire:Questions techniques.
  • Attention pour la transcription latine du tsolyáni : le tiret sert d’anti-liant sans chasse, et le signe « + » de liant sans chasse ; aussi sont-ils supprimés des clés de tri. L’apostrophe est aussi considérée une lettre à part entière, et ne disparaît donc pas de la clé.

Paramètres

Paramètre Description
1 ou clé Optionnel. Valeur manuelle de la clé dans sa casse originale, selon les règles énoncées ci-dessus. Les ponctuations seront conservées seulement si le paramètre 2 est vide.
2 ou lang Optionnel. Pour les langues triées comme le français, plus le breton, le danois, l’espéranto, l’espagnol, le finnois, le hongrois, l’islandais, le koyukon, le norvégien (incluant bokmål et nynorsk), l’ossète, le same du Nord, le slovène, le suédois, le tsolyáni, le vietnamien et le yupik central, il est possible de se passer du premier paramètre et de ne renseigner ici que le code langue, le modèle génèrera alors la clé de tri lui-même. Les ponctuations seront supprimées.

Clés de tri spécifiques à certaines langues

Actuellement, ce modèle ainsi que le mot magique {{DEFAULTSORT:}}, ne peuvent donner qu’une seule clé de tri à la page, même s’il y a plusieurs sections de langue.

C'est pourquoi, il est parfois préférable de spécifier la clé de tri juste après le nom de la catégorie directement ([[Catégorie:Exemple|clé de tri]]). Pour certaines catégories ajoutées automatiquement aux pages, on peut spécifier la clé de tri en paramètre du modèle catégorisant ; c’est le cas du modèle {{S}} avec son paramètre "clé=" (ex. : Biškek), qui permet de changer la clé de tri pour les catégories de nature grammaticale (noms communs, etc.) et de langue (français, etc.).

Utilisation et exemples

Ce modèle doit être placé en toute fin d’article juste avant les éventuelles catégories (qui précèdent elles-même les liens interwikis).

Les exemples qui suivent valent pour le français.

Types de termes Consignes à suivre Exemples de termes Exemples avec la nouvelle collation uca-default
Terme sans accent, cédille, ligature, ou caractère typographique clé de tri non nécessaire renard [{{clé de tri}}]
→ [renard]
Terme avec espace (mais sans accent, cédille, ligature, ou caractère typographique) clé de tri non nécessaire bail financier [{{clé de tri}}]
→ [bail financier]
Terme avec majuscule (mais sans autre particularité) clé de tri non nécessaire Bamako [{{clé de tri}}]
→ [Bamako]
Terme avec accent ou cédille clé de tri non nécessaire éléphant [{{clé de tri}}]
→ [éléphant]
Terme avec ligature (æ et œ) clé de tri non nécessaire œillet [{{clé de tri}}]
→ [œillet]
Terme avec apostrophe Supprimer l’apostrophe automatiquement aujourd’hui [{{clé de tri}}]
→ [aujourdhui]
Préfixes et suffixes, ou termes avec tiret ou trait d’union au début ou à la fin du mot Supprimer le tiret automatiquement anémo-
-ard
[{{clé de tri}}]
→ [anémo ]
→ [ ard]
Terme avec tiret ou trait d’union à l’intérieur du mot (pas au début ni à la fin) Remplacer le tiret/trait d’union par une espace unique automatiquement porte-monnaie [{{clé de tri}}]
→ [porte monnaie]
Abréviations avec point et tiret ou trait d’union à la suite Remplacer le point et le tiret/trait d’union par une seule espace automatiquement c.-à-d. [{{clé de tri}}]
→ [c à d ]
Terme avec parenthèse (()), barre oblique (/), point (.), point médian (·), multiplication (×), points de suspension (…) Remplacer le(s) caractère(s) par une espace unique automatiquement Capt(N)
km/h
al·ludir
à … près
S.S.
S. S.
[{{clé de tri}}]
→ [Capt N ]
→ [km h]
→ [al ludir]
→ [à près]
→ [S S ]
→ [S S ]

Problèmes existants

Le tri obtenu n’est pas totalement conforme à l’algorithme de tri UCA de la norme Unicode, même s’il s’en approche le mieux possible; en effet :

  • la clé secondaire de tri pour le français devrait être renversée (du dernier caractère au premier) ;
  • les diacritiques sont ordonnés dans l’ordre binaire (ce qui est en réalité peu gênant, bien que non conforme à certaines normes : voir cette discussion) ;
  • la casse n’a aucun effet sur l’ordre (ce qui est en réalité peu gênant).

Il n’y a pas d’entête pour les lettres contenant des diacritiques dans les index de catégories. En effet, le choix a été fait que le système de tri actuel ignore les diacritiques, et donc toutes les variantes d’une lettre avec des diacritiques sont considérées comme la même lettre. Il en résulte l’utilisation du symbole « ⿕ » dans les clés de tri pour forcer une indexation en fin de liste, par exemple à la toute fin des Z pour la lettre suédoise ö (qui se traduit z⿕⿕⿕ en « langage clé de tri », comme expliqué plus haut).

Annexe de Conjugaison française

Les modèles {{fr-conj-1}}, {{fr-conj-2}} et similaires gèrent eux-même les clés de tri. Ainsi, au lieu de rajouter le modèle {{clé de tri}}, il faut écrire la clé avec le paramètre clé= comme pour l’exemple suivant (tiré de Conjugaison:français/auto-gérer) :

{{fr-conj-1-é*er|auto-g|o.to.ʒ|r|ʁ|'=oui|clé=auto g}}

Exemples

  • Clé par défaut : {{clé de tri}} donne clé de tri
  • Clé manuelle : {{clé de tri|L’été à la pêche}} donne Lété à la pêche
  • Clé propre à une langue : {{clé de tri|ñ|es}} donne n⿕

Voir aussi