Modèle:Catégorise/documentation

Utilisation

Ce modèle est destiné à documenter tous les modèles dont l’usage entraîne une « catégorisation » automatique (ou circonstancielle).

Remarques

En plus de leur propre catégorisation, un modèle ainsi documenté sera aussi catégorisé dans la catégorie : Modèle qui catégorise (cachée et seulement destinée à la maintenance).

Syntaxe

{{Catégorise|nom de la catégorie}}

{{Catégorise|nom de la catégorie|texte|sous-page=1}}

Paramètres

Ce modèle est destiné à documenter tous les modèles dont l’usage entraîne une « catégorisation » automatique (ou circonstancielle)

Paramètres du modèle[Modifier les données du modèle]

La mise en forme sur une seule ligne est préférée pour ce modèle.

Paramètre		Description	Type	État
Nom de catégorie	1	Nom de la catégorie sans l’espace de noms « Catégorie: »	Chaîne	obligatoire
Précisions	2	Texte complémentaire pour apporter des précisions	Chaîne	facultatif
Sous-page	sous-page	Si la page de documentation employant le modèle est en fait une sous-page, utile si l’espace de nom ne le détecte pas (ou pas encore), afin de forcer la catégorisation au moins de la sous-page de documentation, à défaut de la page de base du modèle	Chaîne	facultatif

Exemple

Code wiki	Rendu
{{Catégorise|Modèle qui catégorise|si c’est un modèle}}	Note : Ce modèle « catégorise » la page qui l’emploie dans Catégorie:Modèle qui catégorise(si c’est un modèle).

Notes

Le texte complémentaire permet de préciser notamment dans quelle mesure (généralement pour quels Espaces de noms) la page qui emploie le modèle sera « catégorisée » (on écrira simplement : « si c‘est un article », « si ce n’est pas un modèle », …). En effet, il est presque toujours nécessaire d’employer un test de l’espace de noms. Par exemple, le code du modèle pourra contenir :

{{#ifeq:{{NAMESPACE}}|Modèle|<!--néant-->|[[Catégorie:...|{{PAGENAME}}]]}}

ou

{{#switch:{{NAMESPACE}}|
{{ns:0}} =[[Catégorie:Pour articles...|{{PAGENAME}}]]|
Catégorie=[[Catégorie:Pour sous-catégories...|{{PAGENAME}}]]|
Modèle   =[[Catégorie:Pour modèles...|{{PAGENAME}}]]|
#default =<!--néant-->}}

ou pour ne « catégoriser » que les articles :

{{#ifeq:{{NAMESPACE}}|{{ns:0}}|<!--néant-->|[[Catégorie:...]]}}

Exemple de code dans un méta-modèle pour qu’il ne catégorise que les modèles qui l’emploient :

{{#ifeq:{{NAMESPACE}}|Modèle|{{#ifeq:{{SUBPAGENAME}}|Documentation||[[Catégorie:...|{{PAGENAME}}]]}}|}}

Voir aussi

• {{Modèle utilisant les ParserFunctions}} • {{Géolocalise}} • {{Charte}}