Aide:Inclusion

L’inclusion est aussi dénommée transclusion et désigne, de manière générale, la reproduction du contenu d’un document dans un autre document à l’aide d’une référence vers le premier document. Ce procédé est né avec les premiers langages informatiques comme le langage C.

Dans Wikipédia, l’inclusion est un mécanisme qui consiste à reproduire tout ou partie du contenu d’une page dans une autre. L’inclusion d’une page X dans une page Y s’opère en plaçant le code {{X}} dans la page Y. Mais, en l’absence d’espace de noms (c'est-à-dire si X est un article), c’est le modèle Modèle:X (et non X) qui est inclus. Pour inclure un article A dans un article B, il faut utiliser le code {{:A}} dans la page B.

Comment l'inclusion fonctionne

Syntaxe

Si la page incluse est un article dans l'espace de noms principal (comme « Chat »), il faut mettre deux points en face du nom : {{:Chat}}

Si la page incluse est dans l'espace de noms des modèles (comme « Modèle:Ébauche »), il suffit d'écrire le nom seul : {{ébauche}}

Si la page incluse est dans n'importe quel autre espace de noms (comme « User:Dcoetzee »), il faut écrire le nom entier, avec l'espace de noms : {{User:Dcoetzee}}

Pour inclure une page source dans une autre page destination, écrivez :

{{UNEPAGE}}

Quand Mediawiki fournit la page destination A, il n'y inclut pas {{UNEPAGE}} littéralement, mais le remplace par le contenu entier de la page source B, titrée Modèle:UNEPAGE.

Au minimum, cela vous permet de mettre le même texte aux nombreuses places sans le copier-coller. Par exemple, vous pourriez mettre un message dans chaque petit article qui encourage les autres à le modifier.

Mais en plus, l'inclusion crée un « lien » entre la page source et les pages dans lesquelles elle est incluse. Par conséquent, quand on modifie la page source, les autres pages changent aussi.

Par exemple, vous pourriez décider de créer une page modèle qui contient votre adresse postale puis l'inclure sur votre page d'utilisateur ainsi que sur celles de vos amis. Quand vous déménagez à une autre adresse, il suffit de modifier votre page modèle, et cette information apparaîtra automatiquement sur les pages de vos amis.

Exemple

En plaçant le code « {{en}} » dans cette page on inclut le modèle Modèle:en et l'on obtient ceci : « (en) ».

Modèles :

Pages en anglais concernant l'inclusion

en:Wikipedia:Transclusion costs and benefits (en anglais)
en:Wikipedia:MediaWiki namespace (en anglais)
- m:Help:MediaWiki namespace (en anglais)
m:Help:Variable (en anglais)
en:Wikipedia talk:Template namespace#transcluding prose (en anglais)

Voir aussi

Request for template transclusion from Commons (pour les modèles interwiki, etc.)
Balise d’inclusion sélective et substitution (le contraire de l'inclusion)
Aide:Créer un modèle#subst: imbriqué