Modèle:Catégorise/Documentation

Ceci est la page de documentation de Modèle:Catégorise [modifier] [purger].

Cette sous-page contient les instructions et les catégories de son modèle d'origine et elle n'est pas destinée à être visualisée directement.

Description modifier

Ce modèle est destiné à documenter tous les modèles (sauf peut-être les bandeaux d’ébauches) dont l’usage entraîne une « catégorisation » automatique (ou circonstancielle).

Paramètres du modèle
Paramètre		Description	Type	État
Nom de la catégorie	`1`	aucune description	Ligne de texte	obligatoire
Texte supplémentaire	`2`	Texte complémentaire pour apporter des précisions.	Ligne de texte	facultatif

Dans la catégorie correspondante, vous pouvez utiliser {{Catégorisée par}}.

Ce modèle « catégorise » la page qui l’emploie dans la catégorie Modèle qui catégorise.

Syntaxe modifier

{{Catégorise/Documentation|1=nom de la catégorie|2=texte}}

Paramètres modifier

1=nom de la catégorie (obligatoire) : nom de la catégorie sans l’espace de noms Catégorie:.
2=texte (facultatif) : texte complémentaire pour apporter des précisions (vierge par défaut).
nocat (facultatif) à mettre à oui si l'on ne veut pas catégoriser le modèle dans [[:Catégorie:Modèle qui catégorise}}.

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:...]]}}

ou

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

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

{{#ifeq:{{NAMESPACE}}|{{ns:0}}|[[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:...]]}}|}}

Exemple modifier

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

Modèles similaires modifier

{{Géolocalise}} • {{Charte}}.