Transclusion/fr

La transclusion consiste généralement en l'inclusion par référence, du contenu d'un document dans un autre document. Dans le contexte d'un wiki, il s'agit de l'utilisation de la fonction modèle de MediaWiki pour inclure le même contenu dans de multiples documents sans avoir à éditer chacun de ces document séparément.

Comment fonctionne la transclusion


 Syntaxe

Si la source est dans l'espace de nom Modèle (par exemple "Template:Welcome"), utilisez simplement le nom du modèle :

Si la source est dans l'espace de nom principal (par exemple "VisualEditor"), placez un symbole « deux points » devant le nom :

Si la source est dans tout autre espace de nom (par exemple "User:Example"), vous devez utiliser le nom complet incluant l'espace de nom :

Si la source est une sous-page de la page cible, (comme « Transclusion/ja »), vous pouvez spécifier simplement le nom de la sous-page indépendamment de l'espace de noms :



Pour transclure n'importe quelle page source (au sein d'un même projet MediaWiki, tel que fr:Wikipédia) à l'intérieur d'une autre page cible, utilisez le code suivant :

Lorsque la page cible A contenant ce code est affichée, le moteur inclura l'ensemble de la page source B à la place du code,

Par exemple, vous pouvez décidez de placer un message de bienvenue sur la page de discussion de chaque nouvel inscrit. La transclusion créera un lien « en direct » entre la page du modèle et les pages cible sur lesquelles le message doit apparaitre. Lorsque le modèle sera modifié, toutes les pages cibles seront modifiées également.

You might also decide to create a (template) page with your mailing address and include that template on not only your page, but all your friends' pages as well. When you move your television and couch to another apartment, you can change your address template, and that new information will automatically update on all your friends' pages.

Étymologie
Ted Nelson inventa le terme "transclusion", ainsi qu'"hypertexte" et "hypermedia" dans son livre de 1982 Literary Machines.

Transclusion partielle
En les balises "noinclude", "onlyinclude" et "includeonly", il est possible de ne transclure qu'une partie d'une page au lieu de son ensemble. De telles transclusions partielles peuvent aussi être mises en œuvre en utilisant d'autres pages sources telles les sous-pages. Il est généralement préférable de ne pas transclure certaines informations, telles la documentation du modèle.

Balises de transclusion

 * noinclude. Le marquage  signifie que le texte entre les balises ne sera pas transclu dans une autre page, mais apparaitra uniquement sur la page elle-même. C'est notamment utile pour la documentation.
 * includeonly. Le marquage  signifie que le texte entre le balises sera uniquement utilisé lorsque la page est transclue depuis une autre page, et n'apparaîtra pas sur la page elle-même. Ce peut être utile, par exemple, pour ajouter des catégories aux pages utilisant un modèle, sans ajouter le modèle lui-même à ces catégories.
 * onlyinclude. Le marquage  indique que seul le texte entouré par les balises "onlyinclude" doit être transclu vers une autre page. Il s'agit de la partie la plus subtile des balises de transclusion partielle, car elle ne tiens en général pas compte des autres. Si il y a au moins un paire de balises "onlyinclude" sur une page, alors lorsque la page est transclue, seul le contenu situé entre les balises "onlyinclude" sera transclu. Il peut y avoir plusieurs sections de ce type, et dans chaque section, une partie du contenu peut également être exclu à l'aide de balises "noinclude", et peut également être entouré be balises "includeonly" pour ne pas apparaître dans la page source. Mais le contenu en dehors des balises "onlyinclude" sera ignoré lorsque la page sera transclue dans une page cible. Cela peut être utile, par exemple, pour répérer une petite partie d'une page dans une autre page. Notez que contrairement à et,  sera prioritaire lorsqu'il est contenu dans des balises . En d'autres mots, Mon contenu  produit seulement "Mon contenu" lorsque transclu.

Sous-pages
You can cut and paste the text to be transcluded into a subpage, then use the name of the subpage in the transclusion template. This approach can be used only where subpages are enabled; for example, on the English Wikipedia, subpages can be used only from User, Talk or Wikipedia pages; currently, subpages cannot be created from main article pages.

Example: you want to discuss the deletion and redirecting of Pussycat to Cat. First, create the subpage Talk:Pussycat/Let's delete Pussycat!, write your comment into it, then transclude it in Talk:Pussycat and Talk:Cat using the template  . Comments posted in either talk page will be shown in both.

Pages spéciales

 * See also:w:Wikipedia:Transclusion and Manual:$wgAllowSpecialInclusion

Some pages on Special:Specialpages can be transcluded, such as Special:AllPages, Special:PrefixIndex, Special:NewFiles, Special:NewPages, Special:RecentChanges and Special:RecentChangesLinked.

Sample: gives 3 new pages.

URL parameters can be given like template parameters, e. g..

Alternatives à la transclusion de modèles
Occasionally you may want to use a template, but for one reason or another may not want to use transclusion. The automatic one-time copying of a template's code/text to the location of a template tag is called Template substitution or subclusion (substitution + transclusion). To subclude a template's code/text, the template tag is modified from the standard transclusion tag to a substitution tag, simply by adding subst:, creating a tag with the form:.

Sections de transclusion nommées
An extension called Labeled Section Transclusion enables marked sections of text to be transcluded. An extension with a somewhat similar function is PageVariableExtension.

Semantic MediaWiki
The Semantic MediaWiki extension uses inline queries to query and display semantic data. There are currently two ways to perform transclusion or something similar: See inline queries for further information.
 * 1) Transclusion proper. The display format "embedded" ensures that selected pages (mainspace articles, templates, etc.) are transcluded. As with templates, sections placed between noinclude tags will be omitted.
 * 2) Selected passages in a page can be assigned a property of type 'Text'. These selections can be requested by running an inline query for this type of property.

Pages relatives à la transclusion de MediaWiki

 * MediaWiki namespace
 * m:Help:MediaWiki namespace
 * m:Help:Variable
 * w:Wikipedia talk:Template namespace

Modèles

 * Help:Template
 * w:Wikipedia:Template namespace
 * w:Wikipedia:Template limits

Voir aussi

 * Request for template transclusion from Commons (interwiki templates, etc.)
 * w:Wikipedia:Substitution (the opposite of transclusion)
 * Extension:Labeled Section Transclusion

fa:ویکی‌پدیا:تراگنجانش fr:Wikipédia:Inclusion ko:위키백과:문서 끼워넣기 yi:װיקיפּעדיע:אריינשטעלן zh:Wikipedia:嵌入包含 pt:Wikipedia:Predefinições