Modèle:Clé de tri/Documentation

Une page de Wikiversité.
Sauter à la navigation Sauter à la recherche

Pourquoi devrais-je ajouter une clé de tri à un article ?[modifier le wikicode]

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 (ou seulement {{clé de tri}} sans paramètre qui doit être présent s'il y a des majuscules, équivalent à {{clé de tri|titre de l’article non modifié}}).

Caractères autorisés[modifier le wikicode]

Une clé de tri secondaire peut contenir :

  • Des lettres minuscules 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 lettres majuscules 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’apostrophe (sauf si elles ont valeur de lettre dans la langue), ni d’éléments de ponctuation, dans cette clé de tri. Les cédilles, accents, et autres diacritiques qui n'influent pas sur l’ordre alphabétique sont supprimés, les apostrophes sont supprimées, et les caractères séparateurs comme - / etc. sont remplacées par une espace.

Attention aux alphabets non français et leurs différences. Certains requièrent de maintenir des distinctions de premier niveau avec des lettres comportant des diacritiques. Pour les écritures alphabétiques non latines, la clé de tri peut contenir également les lettres non accentuées de leur alphabet de base.

  • Attention pour le turc ou l’azéri : respecter la casse mais ne pas unifier les lettres i avec et sans points : la conversion de casse ne permet pas à la clé de tri de fonctionner normalement pour le troisième niveau de tri, cependant, le point en chef au dessus du I majuscule (« İ », dont on conserve la casse) est signifiant et ne devrait pas être supprimé, de même on laisse le i minuscule sans point (« ı ») écrit ainsi sans le remplacer par un i latin usuel avec point. Il n’est malheureusement pas possible de trier ces lettres spéciales entre i et j, elles seront classées à la fin de l’alphabet dans le Wiktionnaire francophone qui utilise les conversions de casse normales, non adaptées spécialement pour les langues à alphabet latin turc.

Cas particuliers des autres langues que le français :

  • Les lettres non accentuées, et sans diacritique, majuscules ou minuscules, des alphabets grecs et cyrilliques.
  • Attention pour le grec : le sigma final minuscule (« ς ») se change en sigma normal (« σ ») ; le iota souscrit (« ͺ » en grec polytonique) se change en iota normal écrit après la lettre de base ; on supprime aussi les esprits, pas seulement les accents.
  • Les lettres hébreux ou arabes sans points diacritiques ni marques de cantillation (il n’y a pas de différences de casse dans ces écritures).
  • Attention pour l’hébreu : on supprime aussi le gerich (« ֜  ») et les points sine (« ׂ ») et chine (« ׁ ») en hébreu (modificateurs de consonnes ou de semi-voyelles).
  • Attention pour le minnan : le n en exposant (marque de nasalisation écrite après une voyelle) se change en n normal même si c’est un diacritique (en fait une lettre modificative) modifiant une voyelle (similaire à un tilde en chef dans l’API) pour conserver l’alphabet de base de cette langue.
  • 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é.
  • Attention pour les titres contenant de l’API : on conserve les diacritiques de l’API mais seulement ceux de la notation phonologique (ne pas indexer les notations phonétiques qui sont souvent multiples et dépendantes de variantes régionales d’un même mot de la même langue)

On peut conserver la casse existante dans la clé de tri, casse 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.

Le modèle {{clé de tri}} trie correctement les lettres majuscules et minuscules, il rend la clé insensible à la casse uniquement pour l’ordre de tri primaire, mais conserve la casse existante dans les autres niveaux de tri. Les autres différences de ponctuation d’accents ou diacritiques ne sont prises en compte que dans la clé tertiaire.

Il n’y a pas d’autres clé à un niveau supérieur que la clé tertiaire ici, on suppose que les noms à trier n’utilisent que des codages canoniques. C’est une limitation du modèle actuel, impossible à corriger sans le support complet des clés de tri UCA directement dans le logiciel MediaWiki, car cela nécessite le traitement conditionnel de chaque caractère utilisé. Toutefois, le tri obtenu est conforme à la norme UCA même s’il ne se fait que sur 3 niveaux et non 4, ce qui est autorisé.

Paramètres[modifier le wikicode]

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 {{clé de tri/fr}} 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é. Toutefois cette valeur par défaut devrait fonctionner correctement dans la plupart des langues. Ne pas utiliser ce paramètre avancé sans avoir d’abord créé le sous-modèle correspondant clé de tri/... utilisé pour la langue indiquée ! Pour le moment, outre le sous-modèle /fr, les sous-modèles suivants existent : eo, ja

Clés de tri spécifiques à certaines langues[modifier le wikicode]

Cette solution en cours d'évaluation, mais pas encore fonctionnelle dans les modèles usuels du Wiktionnaire comme les modèles de classement grammatical et lexical et les modèles de section de langues.

Dans les pages comprenant des sections relatives à des langues différentes, il n'est parfois pas possible de trier ces pages d'une façon qui convienne à la fois à l'une et à toutes les autres en utilisant une clé unique par défaut pour toute la page. Il faut donc pouvoir mentionner des clés spécifiques pour certaines langues, différentes de celles par défaut (qui devraient continuer à utiliser les règles ci-dessous qui conviennent bien au français et la majorité des langues.

La solution consiste à stocker les clés de tri spécifiques à certaines langues dans une sous-page de métadonnées.

Consulter la documentation des modèles {{métadonnées}} et {{sous-catégoriser par langue}} ainsi que la description des sous-pages de méta-données /:data que ce dernier modèle sait utiliser (exemple : abĥazo/:data), pour récupérer une clé de tri spécifique à chaque langue stockée dans une variable nommée « clé de tri.code-langue=... ».

Utilisation et exemples[modifier le wikicode]

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 {{clé de tri}} Cahors {{clé de tri}}
Terme avec minuscule initiale et majuscule interne (mais sans diacritique, tiret, parenthèse, barre oblique, apostrophe, point ou ligature) Mettre {{clé de tri}} 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
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
Ásia
A/G
A.C.
MHz
SKI
{{clé de tri|Cesar}}
{{clé de tri|Asia}}
{{clé de tri|A G}}
{{clé de tri|AC}}
{{clé de tri|MHz}} ou juste {{clé de tri}}
{{clé de tri|SKI}} ou juste {{clé de tri}}

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[modifier le wikicode]

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[modifier le wikicode]

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.

Cas particulier[modifier le wikicode]

Important : le fait de placer une clé de tri dans deux pages incluses dans une troisième, nécessite qu’elles soient identiques, ou alors le message d'erreur suivant apparait : Attention : la clé de tri par défaut « equation du cinquième degre prerequis conseilles » écrase la précédente « equation du cinquième degre objectifs ».

Généralement, cela concerne les pages des leçons :

  1. /Présentation de la leçon
  2. /Objectifs
  3. /Prérequis conseillés
  4. /Référents

Celles des cours :

  1. /Présentation du cours
  2. /Objectifs
  3. /Prérequis conseillés
  4. /Référents
  5. /Leçon
  6. /Fiche
  7. /Sujet d'examen
  8. /Exercices
  9. /Quiz
  10. /Devoir
  11. /TP
  12. /Dissertation
  13. /Annexe
  14. /Compléments

etc.

Celles des départements :

  1. /Présentation du département
  2. /Leçons par thèmes
  3. /Leçons par niveaux
  4. /Contributeurs
  5. /Voir aussi

Celles des facultés :

  1. /Présentation de la faculté
  2. /Départements
  3. /Transverse
  4. /Voir aussi

Et celles des structures :

  1. /Présentation de la structure
  2. /Cours
  3. /Sous structure
  4. /Compléments
  5. /Annexe