Modèle:clé de tri/Documentation

Ceci est la page de documentation du Modèle:clé de tri.

Pourquoi devrais-je ajouter une clé de tri à un article ?

La clé de tri permet de classer les articles dans un ordre systématique, notamment dans les catégories. Un article contenant des caractères spéciaux dans son nom risquerait de se retrouver en tout début ou en fin de liste d’une catégorie. Tous les articles dont le nom contient des caractères spéciaux 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.

Caractères autorisés

Une clé de tri peut contenir :

• Des lettres de l’alphabet latin : a b c d e f g h i j k l m n o p q r s t u v w x y z
• Des chiffres : 0 1 2 3 4 5 6 7 8 9
• Des caractères espace (sauf en début et en fin de clé et jamais deux espaces collées)

Important : Il ne faut pas mettre de lettres accentuées, ni d’éléments de ponctuation, dans cette clé de tri.

Attention aux alphabets étrangers et leurs différences. Par exemple, l’alphabet espagnol comprend la lettre ñ, ce qui donne ñ → nñ.

NB : Le modèle mobilien trie correctement les lettres majuscules et minuscules, il rend la clé insensible à la casse uniquement pour l’ordre de tri primaire.

On doit conserver la casse existante qui ne sera toutefois prise en compte que pour le tri tertiaire (la casse est cependant moins prioritaire que les différences d’accents ou diacritiques considérée pour le tri secondaire). Ce modèle doit donc être employé pour obtenir un tri correct, même sans aucun paramètre, si le titre de l’article contient des majuscules, même s’il n’y a aucun séparateur ou ponctuation autre que des espaces, ni aucun accent ou diacritique.

Paramètres

Paramètre	Description
1	Optionnel. Valeur de la clé dans sa casse originale, mais sans ponctuation ni diacritique (si elle n’est pas précisée, c’est le nom de l’article, dans sa casse originale, qui est utilisé). Cette valeur correspond à la clé secondaire de tri (sensible à la casse) et utilisée pour générer automatiquement la clé primaire (insensible à la casse); elle n’est pas utilisée pour la clé tertiaire (constituée par le nom original de l'article).
lang	Optionnel. On peut modifier, pour certaines catégories, le calcul des clés de tri en précisant ce paramètre dont la valeur par défaut est lang=fr. En effet, ce modèle utilise par défaut les règles de tri appropriées pour la langue française et les clés de tri utilisées sont évaluées par le sous-modèle mobilien qui génère les clés de tri effectives composées à partir de trois sous-clés, conformément à l’algorithme de tri multiniveau « UCA » normalisé.

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

Types de termes	Consignes à suivre	Exemples de termes	Exemples de clés de tri
Terme sans accent, cédille, ligature, majuscule, ou caractère typographique	clé de tri non nécessaire	renard
Terme avec espace (mais sans accent, cédille, ligature, majuscule, ou caractère typographique)	clé de tri non nécessaire	bail financier
Terme avec majuscule initiale (mais sans majuscule médiale, accent, tiret, apostrophe, etc.)	Mettre mobilien	Cahors	{{clé de tri}}
Terme avec minuscule initiale et majuscule interne (mais sans diacritique, tiret, parenthèse, barre oblique, apostrophe, point ou ligature)	Mettre mobilien	chien de Pavlov	{{clé de tri}}
Terme avec accent	Remplacer les lettres accentuées par leur lettre de base non accentuée	éléphant	{{clé de tri|elephant}}
Terme avec cédille	Supprimer la cédille	maçon	{{clé de tri|macon}}
Terme avec ligature (æ et œ)	Éclater la ligature	œillet	{{clé de tri|oeillet}}
Terme avec apostrophe	Supprimer l’apostrophe	aujourd’hui	{{clé de tri|aujourdhui}}
Préfixes et suffixes	Supprimer le tiret	anémo- -ard	{{clé de tri|anemo}} {{clé de tri|ard}}
Terme avec tiret ou trait d’union à l’intérieur	Remplacer le tiret par une espace unique	porte‑monnaie	{{clé de tri|porte monnaie}}
Abréviations avec point et tiret à la suite	Remplacer le point et le tiret par une seule espace	c.‑à‑d.	{{clé de tri|c a d}}
Terme avec parenthèses internes	Supprimer les parenthèses mais conserver la casse	Capt(N)	{{clé de tri|CaptN}}
Terme avec parenthèses de ponctuation	Supprimer les parenthèses mais conserver la casse	dimli (zazaki du Sud)	{{clé de tri|dimli zazaki du Sud}}
Terme avec barre oblique (/), point médian (·), multiplication (×)	Remplacer le(s) caractère(s) par une espace	km/h al·ludir	{{clé de tri|km h}} {{clé de tri|al ludir}}
Terme avec majuscule initiale (et majuscule médiale, accent, tiret, apostrophe, etc.)	Écrire la clé en respectant les régles précédentes mais conserver la casse (Majuscules et minuscules)	César MHz A/G A.C. SKI	{{clé de tri|Cesar}} {{clé de tri|MHz}} {{clé de tri|A G}} {{clé de tri|AC}} {{clé de tri|SKI}}

Note : Il peut y avoir des exceptions. Dans la transcription latine du tsolyáni, par exemple, le tiret sert d’anti-liant sans chasse, il est donc supprimé de la clé de tri plutôt que d’être remplacé par une espace. En revanche, la transcription latine du minnan utilise abondamment les tirets comme séparateurs syllabiques explicites (pour éviter de nombreuses ambigüités, dont la plupart étaient inexistantes dans l’ancienne transcription du minnan en sinogrammes syllabiques), et ces tirets essentiels doivent être conservé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
• quand deux termes diffèrent seulement par leur casse, les majuscules sont normalement triées avant les minuscules (toutefois c’est un tri purement binaire, ce n’est pas garanti pour tous les couples de lettres majuscule/minuscule comportant certains diacritiques.

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 cat= comme pour l’exemple suivant :

{{fr-conj-1|émul|
|'=oui
|pron=e.my
|pc=l
|cat=emuler
}}

Les règles pour construire la clé secondaire à passer en paramètre sont les mêmes.