Voir la source de Ébauche/Documentation

{{Sous-page de documentation}}

== Utilisation ==

Ce modèle se place en tête d’article : il affiche un bandeau d’avertissement pour signaler qu’il s’agit d’une ébauche à compléter, et catégorise la page dans les [[:Catégorie:ébauche|catégories d’ébauche]] correspondant aux thèmes indiqués. Toutefois, les [[Aide:Discussion|pages de discussion]] et les pages de l’[[Aide:Espace de noms|espace]] « {{ns:user}} » ne sont pas catégorisées.

== Syntaxe ==

 <code><code>{{</code>ébauche | ''vénètes'' | ''gaule'' | …<nowiki>}}</nowiki></code>
Un maximum de six thèmes est admis. Chaque thème doit avoir une catégorie d’ébauche et une page de paramètres correspondante, nommée {{nobr|« Modèle:Ébauche/paramètres ''thème'' »}}, où ''thème'' est le nom du thème.
Attention, les noms de thèmes sont sensibles à la [[Sensibilité à la casse|casse]].
Si aucun thème n’est précisé, l’article est catégorisé dans la catégorie {{c|ébauche}} des ébauches à classer.
 
== Paramètres ==

<pre style="overflow:auto;">
{{ébauche
 | 1            =
 | 2            =
 | 3            = 
 | 4            = 
 | 5            = 
 | 6            = 
 | icône        = 
 | id           =
 | nocat        = 
}}</pre>
</pre>
* '''1''' = ''thème1'' ''(facultatif)''
* '''2''' = ''thème2'' ''(facultatif)''
* '''3''' = ''thème3'' ''(facultatif)''
* '''4''' = ''thème4'' ''(facultatif)''
* '''5''' = ''thème5'' ''(facultatif)''
* '''6''' = ''thème6'' ''(facultatif)''
En plus de la liste des thèmes, les paramètres suivants peuvent être ajoutés :
* <code>icône = ''thème''</code> : Affiche, dans le bandeau, l’icône du thème indiqué. Si ''thème'' est vide, l’icône par défaut est affichée. Si ''thème'' est l’étoile « * », les icônes de tous les thèmes donnés en paramètres  sont affichés (c’est aussi le comportement lorsque le paramètre « icône » est absent).
* <code>id = ''identificateur''</code> : Affecte un identificateur au bandeau (correspond à l’attribut « id » en [[HTML]]).
* <code>nocat = ''n’importe quoi qui n’est pas vide''</code> : le bandeau est affiché, mais la page n’est pas catégorisé dans les catégories d’ébauches.
Il n’est pas possible de spécifier une clé de tri explicite pour le classement dans les catégories d’ébauche. Veuillez utiliser le mot magique <nowiki>{{DEFAULTSORT}}</nowiki> (sous la forme « <nowiki>{{</nowiki>DEFAULTSORT:''clé de tri''<nowiki>}}</nowiki> ») pour définir une clé de tri par défaut.

Les bandeaux d’ébauches placés dans une page de discussion ou dans une page de l’espace « {{ns:user}} » ne catégorisent jamais. Pour catégoriser une telle page, vous devez insérer manuellement un marqueur de catégorie explicite « <nowiki>[[Catégorie:…]]</nowiki> » (déconseillé).

== Exemples ==

* <pre><nowiki>{{</nowiki>ébauche | Italie <nowiki>}}</nowiki></pre>
{{ébauche | Italie | nocat=oui}}
* <pre><nowiki>{{</nowiki>ébauche | Italie | lac <nowiki>}}</nowiki></pre>
{{ébauche | Italie | lac | nocat=oui}}
* <pre><nowiki>{{</nowiki>ébauche | Italie | lac | Suisse<nowiki>}}</nowiki></pre>
{{ébauche | Italie | lac | Suisse | nocat=oui}}

== Note ==

Si l'article nécessite une clé de tri, et qu'elle n'a pas encore été spécifiée avec <code><nowiki>{{</nowiki>DEFAULTSORT:''nom pour le tri''}}</code>, il est souhaitable d'ajouter celle-ci à la fin de l'article, afin que l'article soit correctement trié dans les catégories d'ébauches.

Pour des explications sur <code><nowiki>{{</nowiki>DEFAULTSORT:...}}</code>, voir [[Aide:Catégorisation#Particularité : les clefs de tri|Comment échapper au classement « par défaut »]].

== Voir aussi ==

* [[Aide:Ébauche/Aide paramètres]]
* [[Spécial:Index/Modèle:Ébauche/paramètres|Liste des thèmes d’ébauche]]
*  {{c|Modèle d'ébauche}}
<includeonly><!--
  Catégorise le [[modèle:ébauche]] lui-même, pas les articles qui incluent ce modèle, ni sa page de documentation ici.
-->
[[Catégorie:Modèle d'ébauche|*]]
[[Catégorie:Modèle de maintenance|Ebauche]]
</includeonly>

<templatedata>
{
	"description": "Ce modèle se place en tête d’article : il affiche un bandeau d’avertissement pour signaler qu’il s’agit d’une ébauche à compléter, et catégorise la page dans les catégories d’ébauche correspondant aux thèmes indiqués",
	"params": {
		"1": {
			"label": "Thème",
			"description": "Un thème de l'article. Attention, les noms de thèmes sont sensibles à la casse.",
			"type": "string"
		},
		"2": {
			"inherits": "1",
			"type": "string"
		},
		"3": {
			"inherits": "1",
			"type": "string"
		},
		"4": {
			"inherits": "1",
			"type": "string"
		},
		"5": {
			"inherits": "1",
			"type": "string"
		},
		"6": {
			"inherits": "1",
			"type": "string"
		},
		"icône": {
			"label": "Icône",
			"description": "Affiche, dans le bandeau, l’icône du thème indiqué. Si thème est vide, l’icône par défaut est affichée. Si thème est l’étoile *, les icônes de tous les thèmes donnés en paramètres sont affichés (c’est aussi le comportement lorsque le paramètre icône est absent).",
			"type": "string"
		},
		"id": {
			"label": "Identificateur",
			"description": "Affecte un identificateur au bandeau (correspond à l’attribut id en HTML).",
			"type": "string"
		},
		"nocat": {
			"label": "Ne pas catégoriser comme ébauche",
			"description": "Si ce champ n'est pas vide, le bandeau est affiché, mais la page n’est pas catégorisée comme ébauche",
			"type": "string"
		}
	}
}
</templatedata>
<includeonly>
[[Catégorie:Exclure lors de l'impression]]
</includeonly>