Modèle:sous-catégoriser par langue

Documentation du modèle

Cette documentation est incluse depuis Modèle:sous-catégoriser par langue/Documentation. [rafraîchir] · [modifier] · [historique]

Ce modèle est désuet. Il ne doit plus être utilisé.
Néanmoins il n’est pas sujet à être supprimé, car certaines pages l’utilisent dans leur historique.

Utilisation :: Ce modèle permet de sous-catégoriser une page indiquée en paramètre (normalement la page courante) en fonction de la langue indiquée aussi en paramètre, dans une catégorie spécifique à une langue et demandant une clé de tri spécifique pour cette langue.

Syntaxe :

{{sous-catégoriser par langue|Nom de la catégorie|code-langue}}

La syntaxe est très similaire à celle du code standard d'une catégorie (la barre vertical remplace les deux points, des accolades remplace les crochets, le code langue remplace l'indication explicite de la clé de tri).

Paramètres :

1= (obligatoire) nom complet de la catégorie cible (sans le préfixe « Catégorie: »).
2= (obligatoire) code langue associé à la catégorie cible.
page= (optionnel) nom de la page de base contenant une sous-page de métadonnées, normalement tel que généré par "{{FULLPAGENAME}}" dans l’article appelant ce modèle (c’est la valeur par défaut).
On pourrait aussi spécifiquement utiliser « {{NAMESPACE}}:{{BASEPAGENAME}} » (c’est-à-dire le nom complet de la page principale où sont définies les métadonnées, et non une de ses sous-pages), mais certaines pages de l’espace de noms principal du Wiktionnaire contiennent un « / » dans leur nom et l’utilisation du nom complet est nécessaire pour ne pas aller chercher ses métadonnées dans la sous-page « /:data » d’une autre page éventuellement inexistante ou sans rapport.

L’utilisation explicite de ce 3^e paramètre dans les articles est donc déconseillée (à usage interne pour certains modèles qui en auraient besoin pour accéder à des métadonnées de pages autres que celles de l’espace de noms principal), il vaut mieux la plupart du temps laisser le modèle déterminer la valeur par défaut, pour éviter tout risque d’erreur.

Il peut y avoir dans la sous-page de métadonnées autant de clés de tri que nécessaire pour les différentes langues contenues dans la page utilisant ce modèle, ainsi que d’autres variables de métadonnées propres à la page.
nocat=1 (optionnel) a pour effet de désactiver la catégorisation de la page courante (qui normalement se fait de façon invisible dans le texte de la page)
aide=1 (optionnel) a pour effet d’afficher (dans le corps de la page) un message de débogage contenant les informations de catégorisation et de génération de clés que ce modèle prendrait si ce paramètre n’était pas indiqué ou vide. Ce paramètre ne devrait être utilisé qu’à titre documentaire (comme sur cette présente page), ou très temporairement durant la conception d’autres modèles pour vérifier dans quelles catégories (et selon quelle clé de tri) ils classeraient la page courante utilisant ces autres modèles.

Format des métadonnées pour précisier le tri :

La clé de tri d’une page quelconque, si elle est renseignée, doit être stockée dans la sous-page de métadonnées nommée /:data, dans la variable nommée « clé de tri.code-langue ». Par exemple la variable de métadonnées nommée clé de tri.eo et indiquée dans la ligne « clé de tri.eo=...| » contiendra la clé de tri spécifique aux catégories en espéranto, et celle nommée clé de tri.zh sera associé à la clé de tri spécifique aux catégories chinoises.
La valeur indiquée dans ces métadonnées est la clé de tri secondaire uniquement, où on devrait supprimer les accents et caractères qui ne sont pas significatifs aux premier ou deuxième niveau de tri pour la langue indiquée, ou bien convertir certains caractères ou les transcrire dans une romanisation, ou encore vers un caractère simplifié tel que les clés idéographiques, ou purement alphabétique et non syllabique (pour les écritures codées en syllabes précomposées, notamment l’hangûl qui devrait être traduit uniquement en jamos de compatibilité non composables).
La clé de tri complète effective est générée à partir de la clé secondaire indiquée en méta-donnée, comme avec le modèle {{clé de tri}}. Ces clés secondaires devraient utiliser la casse originale.
Si la page de métadonnées n’existe pas (ou n’a pas encore été créée) dans la page à catégoriser ou si elle existe mais ne retourne pas de valeur pour la variable nommée "clé de tri.code-langue=...", alors ce modèle catégorisera la page indiquée (ou la page courante par défaut) sans préciser aucune clé de tri. La page sera alors triée en utilisant la clé de tri indiquée par défaut en bas du code Wiki de celle-ci avec {{clé de tri|valeur de la clé par défaut}}.

Exemples :

Noter tout d’abord que cette page d’aide (affichée ici) utilise {{clé de tri|categorie}}, ce qui génère pour cette page la clé de tri par défaut « categorie ! !sous-catégoriser par langue ».

Noter aussi que le code réellement utilisé ici ajoute le paramètre « nocat=1 » pour ne pas déclencher de catégorisation intempestive de cette page d’aide dans les catégories citées en exemple, à la place, le message d’information et de débogage vient s’afficher.

{{sous-catégoriser par langue|Noms communs en {{eo}}|eo}}
Syntaxe recommandée pour catégoriser les pages de l’espace de nom principal. Recherche la métadonnée nommée « clé de tri.eo= » dans la sous-page « /:data » de la page courante, pour la catégoriser en la triant correctement dans la Catégorie:Noms communs en espéranto (clé prenant en compte les règles éventuelles de tri applicables uniquement aux catégories en espéranto, et qui ne peut pas être utilisée comme clé de tri par défaut pour les pages multilingues). Noter comment la clé multiniveau est bien générée à l’aide de la clé secondaire indiquée dans les métadonnées, exactement comme pour les clés secondaires indiquées en bas des articles dans un appel au modèle {{clé de tri|clé secondaire}} pour définir la clé de tri par défaut de la page.

(catégorisation de la page Modèle:sous-catégoriser par langue dans la Catégorie:Noms communs en espéranto, avec la clé de tri « dexmosxtratxon ! !sous-catégoriser par langue » générée pour la langue de code [eo] (espéranto) à partir de sa sous-page de métadonnées)

{{sous-catégoriser par langue|Noms propres en {{zh}}|zh|page={{NAMESPACE}}:{{BASEPAGENAME}}}}
Syntaxe avancée (utilisation restreinte à certains modèles utilitaires). Recherche la métadonnée nommée « clé de tri.zh= » dans la sous-page « /:data » de la page de base de la page courante, pour la catégoriser en la triant correctement dans la Catégorie:Noms propres en chinois (clé prenant en compte les règles éventuelles de tri applicables uniquement aux catégories en chinois).

(catégorisation de la page Modèle:sous-catégoriser par langue dans la Catégorie:Noms propres en chinois, avec la clé de tri « 人06 deing1 mong4 stras2 tion3 ! !sous-catégoriser par langue » générée pour la langue de code [zh] (chinois) à partir de sa sous-page de métadonnées)

{{sous-catégoriser par langue|1=Lexique en {{nom langue| {{{lang|fr}}} }} de la cuisine|2={{{lang|fr}}}|page={{{page|{{NAMESPACE}}:{{BASEPAGENAME}}}}}}}
Syntaxe avancée (utilisation restreinte à certains modèles utilitaires). Ce code qui pourrait être présent dans un modèle avec paramètres recherche la métadonnée nommée « clé de tri.lang= » dans la sous-page « /:data » de la page indiquée par le paramètre page (qui prend ici par défaut la page de base de la page courante), pour la catégoriser en la triant correctement dans la « Catégorie:Lexique en langue de la cuisine ». La démonstration ci-dessous affiche une clé pour le français, car la page courante d’aide est affichée ici normalement sans paramètre lang et pas incluse dans une autre page précisant ce paramètre, aussi ce paramètre prend ici la valeur par défaut fr.

(catégorisation de la page Modèle:sous-catégoriser par langue dans la Catégorie:Lexique en français de la cuisine, avec la clé de tri par défaut de la page, qui n’a pas de « clé de tri.fr » définie pour la langue de code [fr] (français) dans sa sous-page de métadonnées)

Voir aussi :

Cette page dispose d’une sous-page de métadonnées.