Voir la source de Modèle:Article détaillé/Documentation

{{Sous-page de documentation}}

== Utilisation ==
Ce modèle permet de mettre en exergue un ou plusieurs liens vers d'autres articles approfondissant le sujet en question.

Il est utilisé lorsqu’une section d’un article traite d’un sujet qui est traité plus en détail dans un autre article. Le modèle se place juste sous le titre de la section.

Aperçu du modèle avec un lien vers l'article [[Géographie de l'Antarctique]] :
{{Article détaillé|Géographie de l'Antarctique}}

D'autres modèles sont à préférer dans certains cas :
* Pour le lien dans un article détaillé vers l'article principal, il existe {{m|Article général}}.
* Pour placer un lien vers un article qui ne traite que partiellement du sujet, utiliser plutôt {{m|Article connexe}}.
* Dans une catégorie, pour le lien vers son article principal, il existe {{m|Article principal}}.

== Syntaxe ==
; Simple
: <code><nowiki>{{Article détaillé|</nowiki>''{{vert|article1}}''<nowiki>}}</nowiki></code>
; Avec plusieurs articles
: <code><nowiki>{{Article détaillé|</nowiki>''{{vert|article1}}''{{!}}''{{vert|article2}}''{{!}}{{vert|...}}<nowiki>}}</nowiki></code>
; Pour afficher un texte différent que {{Citation|Article détaillé}} ou {{Citation|Articles détaillés}} au début du bandeau.
: <code><nowiki>{{Article détaillé|</nowiki>amorce=''{{vert|amorce}}''{{!}}''{{vert|article1}}''<nowiki>}}</nowiki></code>
; Pour modifier le texte affiché d'un lien
: <code><nowiki>{{Article détaillé|</nowiki>''{{vert|article1}}''<nowiki>{{!}}</nowiki>''{{vert|texte lien article1}}''<nowiki>}}</nowiki></code>
; Avec une ancre
: <code><nowiki>{{Article détaillé|</nowiki>''{{vert|article1#section}}''<nowiki>}}</nowiki></code>
; Avec un contenu entièrement modifié
: <code><nowiki>{{Article détaillé|</nowiki>contenu=''{{vert|texte libre en wikicode comprenant des liens}}''<nowiki>}}</nowiki></code>

== Paramètres ==
; <code>1</code> à <code>16</code>
: Noms d'articles (au moins un), sans les crochets.
: Exemple : <code><nowiki>{{Article détaillé|Géographie de l'Antarctique|Région antarctique}}</nowiki></code>
:; Changement du texte du lien
:: Pour changer le texte du lien ou le mettre en forme, il faut ajouter le séparateur spécial <code>[[:mw:Help:Magic_words/fr#pipe|<nowiki>{{!}}</nowiki>]]</code> entre le nom de l'article et le texte du lien.
:: Exemple : <code><nowiki>{{Article détaillé|Détroit de Wilkins (Antarctique)</nowiki>{{rouge|<nowiki>{{!}}</nowiki>}}<nowiki>Détroit de Wilkins}}</nowiki></code>
:; Nom d'article contenant un signe égal (<code>=</code>)
:: Si un nom d'article contient un signe égal alors la syntaxe à utiliser est la suivante : <code><nowiki>{{Article détaillé|</nowiki>{{rouge|<nowiki>1=</nowiki>}}<nowiki>E=mc2}}</nowiki></code> pour que le <code>=</code> du lien ([[E=mc2]] dans l'exemple) ne soit pas interprété.
; <code>amorce</code>
: Remplacement du texte au début du bandeau, qui est par défaut {{citation|Article détaillé}} ou {{citation|Articles détaillés}}, par un autre texte.
: Exemple : <code><nowiki>{{Article détaillé|amorce=Annexe détaillée|...}}</nowiki></code>
; <code>contenu</code>
: Texte libre contenant du wikicode remplaçant les liens et l'amorce. Permet l'utilisation d'un texte personnalisé ou d'utiliser des modèles {{m|Lien}}. Le point final est à ajouter manuellement
: Exemple : <code><nowiki>{{Article détaillé|contenu=Article détaillé : {{lien|langue=en|trad=Page en anglais|fr=Page en français}}.}}</nowiki></code>

=== Lien vers un article dans une autre langue ===
{{Aide détaillée|Aide:Lien interlangue}}

Deux possibilités existent pour faire un [[Aide:Lien interlangue|lien interlangue]] :
* Avec le modèle {{m|Lien}} : <code><nowiki>{{Article détaillé|contenu=Article détaillé : {{Lien|langue=en|trad=Page en anglais|fr=Page en français}}.}}</nowiki></code>.
* Lien en {{citation|dur}} type <code><nowiki>[[:en:Pagename]]</nowiki></code> : <code><nowiki>{{Article détaillé|:en:Page en anglais}}</nowiki></code> ('''{{rouge|déconseillé}}''', {{cf.}} [[Aide:Lien interlangue]])

== Position d'ajout ==
L’ensemble de la syntaxe à placer en tête de section, par exemple lorsqu’une image est présente : 
 <nowiki>== Titre de section ==</nowiki>
 <nowiki>[[Fichier:Image.png|thumb|Légende de l'image.]]</nowiki>
 '''<nowiki>{{Article détaillé|</nowiki>''{{vert|article1}}''<nowiki>}}</nowiki>'''
 
 Texte qui résume l'article détaillé...

La ligne vide entre le modèle {{m|Article détaillé}} et le début du texte est à des fins de lisibilité du code.

== Exemples ==
{| class="wikitable"
! scope="col" | Code
! scope="col" | Rendu
|-
|<code><nowiki>{{Article détaillé|Japon}}</nowiki></code>
|{{Article détaillé|Japon}}
|-
|<code><nowiki>{{Article détaillé|États-Unis{{!}}États-Unis d’Amérique}}</nowiki></code>
|{{Article détaillé|États-Unis{{!}}États-Unis d’Amérique}}
|-
|<code><nowiki>{{Article détaillé|Octodon degus{{!}}''Octodon degus''}}</nowiki></code>
|{{Article détaillé|Octodon degus{{!}}''Octodon degus''}}
|-
|<code><nowiki>{{Article détaillé|Utopie|Philosophie}}</nowiki></code>
|{{Article détaillé|Utopie|Philosophie}}
|-
|<code><nowiki>{{Article détaillé|Bouliac#Transports en commun{{!}}Transports en commun de Bouliac}}</nowiki></code>
|{{Article détaillé|Bouliac#Transports en commun{{!}}Transports en commun de Bouliac}}
|-
|<code><nowiki>{{Article détaillé|1|2|3|4|5|6|7|8|9|10}}</nowiki></code>
|{{Article détaillé|1|2|3|4|5|6|7|8|9|10}}
|-
|<code><nowiki>{{Article détaillé|amorce=Annexe détaillée|Schéma de la ligne du Pied-du-Jura}}</nowiki></code>
|{{Article détaillé|amorce=Annexe détaillée|Schéma de la ligne du Pied-du-Jura}}
|-
|<code><nowiki>{{Article détaillé|contenu=Article détaillé : {{lien|langue=en|trad=Page en anglais|fr=Page en français}}.}}</nowiki></code>
|{{Article détaillé|contenu=Article détaillé : {{lien|langue=en|trad=Page en anglais|fr=Page en français}}.}}
|}

== Catégorisation si syntaxe erronée ==
Ce modèle catégorise l’article dans [[:Catégorie:page utilisant un modèle avec une syntaxe erronée]] lorsque le paramètre <code>1</code> est vide.

== Apparence ==
La présentation actuelle de ce modèle a été décidée par une [[WP:PDD|prise de décision]] : [[Wikipédia:Prise de décision/Unification des modèles : article détaillé et Loupe]].

== TemplateData ==
<templatedata>
{
	"description": "Bandeau de section pour lien vers un ou plusieurs articles approfondissant le sujet.",
	"params": {
		"1": {
			"type": "wiki-page-name",
			"label": "Article 1",
			"required": true,
			"description": "Nom d'un article. Pour modifier le texte affiché du lien, saisissez « {{!}} » après le nom de l'article, suivi du texte à afficher.",
			"example": "Géographie de l'Antarctique"
		},
		"2": {
			"label": "Article 2",
			"type": "wiki-page-name",
			"description": "Nom d'un article. Pour modifier le texte affiché du lien, saisissez « {{!}} » après le nom de l'article, suivi du texte à afficher.",
			"example": "Géographie de l'Antarctique"
		},
		"3": {
			"label": "Article 3",
			"inherits": "2"
		},
		"4": {
			"label": "Article 4",
			"inherits": "2"
		},
		"5": {
			"label": "Article 5",
			"inherits": "2"
		},
		"6": {
			"label": "Article 6",
			"inherits": "2"
		},
		"7": {
			"label": "Article 7",
			"inherits": "2"
		},
		"8": {
			"label": "Article 8",
			"inherits": "2"
		},
		"9": {
			"label": "Article 9",
			"inherits": "2"
		},
		"10": {
			"label": "Article 10",
			"inherits": "2"
		},
		"11": {
			"label": "Article 11",
			"inherits": "2"
		},
		"12": {
			"label": "Article 12",
			"inherits": "2"
		},
		"13": {
			"label": "Article 13",
			"inherits": "2"
		},
		"14": {
			"label": "Article 14",
			"inherits": "2"
		},
		"15": {
			"label": "Article 15",
			"inherits": "2"
		},
		"16": {
			"label": "Article 16",
			"inherits": "2"
		},
		"contenu": {
			"description": "Texte pour remplacer tout le contenu du bandeau, y compris l'amorce « Article détaillé ». Permet aussi l'utilisation de modèles comme {{lien}}.",
			"type": "string",
			"label": "Texte libre",
			"example": "Article détaillé : {{lien|langue=en|trad=Nom de l'article en anglais|fr=Nom de l'article en français}}."
		},
		"amorce": {
			"description": "Texte remplaçant l’amorce par défaut « Article détaillé » ou « Articles détaillés ».",
			"type": "line",
			"label": "Amorce",
			"default": "Article détaillé",
			"example": "Annexe détaillée"
		}
	},
	"format": "\n{{_|_=_}}\n",
	"paramOrder": [
		"1",
		"2",
		"3",
		"4",
		"5",
		"6",
		"7",
		"8",
		"9",
		"10",
		"11",
		"12",
		"13",
		"14",
		"15",
		"16",
		"contenu",
		"amorce"
	]
}
</templatedata>

== Voir aussi ==
* {{m|Aide détaillée}}
* {{m|Article connexe}}
* {{m|Article général}}
* {{m|Article principal}}
* {{m|Catégorie détaillée}}
<includeonly>
[[Catégorie:Modèle de bandeau de section]]
[[Catégorie:Modèle renvoi d'article]]
[[Catégorie:Exclure lors de l'impression]]
</includeonly>