Transclusion/fr

La transclusion consiste généralement en l'inclusion du contenu d'un document dans un autre document par référence. Dans le contexte de Wikipédia, 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. La transclusion de modèles est la manière généralement utilisée pour utiliser les modèles de messages, et est implémentée par l'utilisation d'une balise modèle de la forme :

Comment fonctionne la transclusion


 Syntaxe des modèles

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

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

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 :

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, SOMEPAGE.



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.

For example, you might decide to create a (template) page with your mailing address and include that template on not only your page, but all your friends' pages, too. When you move your television and couch to another apartment, you will change your address template, and automatically, that new information will appear 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.

Pour un exemple de mise en œuvre de cette technique pour simplifier la création d'articles de résumé, voir comment History of pathology a été transclu dans Pathology,  qui consistait en un ensemble de paragraphes d'introduction transclus depuis différents articles principaux.

Balises de transclusion

 * noinclude. The markup  means that the text between the tags will not be transcluded onto another page, but will only appear on the page itself. This is useful for 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.

Exemple : comment transclure l'en-tête d'un article
[ Edit Source to see how this works ]

The lead section (also known as the lead, introduction or intro) of a Wikipedia article is the section before the table of contents and the first heading. The lead serves as an introduction to the article and a summary of its most important contents. It is not a news-style lead or lede paragraph.

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 only be used where subpages are enabled; for example, on the English Wikipedia, subpages can only be used 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 to transclusion by template
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:.

The content of a page can also be transcluded from a namespace other than "Template". See http://meta.wikimedia.org/wiki/Help:Embed_page.

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 http://semantic-mediawiki.org/wiki/Help: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 related to MediaWiki transclusion

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

Templates

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