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 documents séparément.

Comment fonctionne la transclusion


 Syntaxe

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

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

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

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 Wikipédia) à l'intérieur d'une autre page cible, incluez le code suivant :

Lorsque la page cible A est affichée, tout le contenu de la page source B (dans ce cas, SOMEPAGE), sera affiché à l'endroit où la transclusion a été demandée.

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.

Vous pouvez aussi décider de créer une page (de modèle) avec votre adresse courriel et inclure ce modèle pas seulement sur votre page mais également sur toutes les pages de vos amis. Lorsque vous déplacez votre téléviseur et votre canapé dans un autre appartement, vous pouvez modifier le modèle de votre adresse et ces nouvelles informations seront automatiquement mises à jour sur les pages de tous vos amis.

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

Transclusion partielle
En utilisant 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 à partir d'autres pages sources telles les sous-pages. Il est généralement préférable de ne pas transclure certaines informations, telles que la documentation du modèle et les catégories.

Balises de transclusion

 * noinclude - Le marquage  signifie que le texte entre les balises ne sera pas transclus dans une autre page, mais apparaitra uniquement sur la page elle-même. Ceci est utile pour la documentation des modèles et les catégories.
 * includeonly - Le marquage  signifie que le texte entre le balises « sera uniquement utilisé lorsque la page sera transclue depuis une autre page, et n'apparaîtra pas sur la page elle-même ». This can be useful, for example, for adding categories to pages transcluding a template, without adding the template itself to these categories.
 * onlyinclude - * $onlyincl. Le marquage $tagonlyincl indique que « seul le texte entouré par les balises "$onlyincl" doit être transclus vers une autre page, mais il apparaîtra sur la page elle-même » s'il n'est pas accompagné également des balises $onlyincl. 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 une paire de balises "$onlyincl" sur une page, alors lorsque la page est transclue, seul le contenu situé entre les balises "$onlyincl" 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 "$noincl", et peut également être entouré de balises "$inclonly" pour ne pas apparaître dans la page source. Mais le contenu en dehors des balises "$onlyincl" sera ignoré lorsque la page sera transclue dans une page cible. Cela peut être utile, par exemple, pour repérer une petite partie d'une page dans une autre page. Notez que contrairement à $tagnoinclopen et $taginclonlyopen, $tagonlyinclopen sera prioritaire lorsqu'il est contenu dans des balises $tagnowikiopen. En d'autres mots, $tagbegin Mon contenu $tagend produit seulement "Mon contenu" lorsque transclu. This is the most subtle of the partial transclusion tags because it often overrules the others. If there is at least one pair of "onlyinclude" tags on a page, then whenever this page is transcluded, it is only the material within the "onlyinclude" tags which gets transcluded. There can be several such sections, and within each such section, some material might be further excluded by "noinclude" tags, and might also be surrounded by "includeonly" tags so that it does not appear on the original page itself. But material outside the "onlyinclude" tags will be ignored when the page is transcluded onto another page. This can be useful, for example, to repeat a small part of one page on a second one: just surround the small part by onlyinclude tags, and transclude it onto the second page. Note that unlike and,  will take precedence over enclosing  tags. In other words, My content produces only "My content" when transcluded.

Sous-pages
Vous pouvez copier et coller le texte à transclure dans une sous-page, et utiliser le nom de la sous-page dans le modèle de transclusion. Cette approche peut être utilisée seulement si les sous-pages sont activées; par exemple, sur la Wikipedia en anglais, les sous-pages peuvent être utilisées seulement à partir des pages utilisateur, discussion ou des pages Wikipedia; actuellement, les sous-pages ne peuvent pas être créées à partir des pages principales d'articles.

Exemple: vous voulez discuter de la supression et de la redirection de Pussycat vers Cat. D'abord, créez la sous-page Talk:Pussycat/Let's delete Pussycat!, et mettez-y vos commentaires, ensuite faites la transclusion de cette page dans Talk:Pussycat et Talk:Cat en utilisant le modèle  . Les commentaires postés sur l'une ou l'autre des pages de discussion apparaîtront dans les deux.

Pages spéciales

 * Voir aussi : w:Wikipedia:Transclusion et Manual:$wgAllowSpecialInclusion

Certaines pages sur Special:Specialpages peuvent être transcluses, comme Special:AllPages, Special:PrefixIndex, Special:NewFiles, Special:NewPages, Special:RecentChanges et Special:RecentChangesLinked.

Exemple: donne 3 nouvelles pages.

Les paramètres d'URL peuvent être passés comme des paramètres de modèle, par exemple :.

Alternatives à la transclusion de modèles
Occasionnellement, vous pourriez vouloir utiliser un modèle, mais pour une raison ou pour une autre, sans passer par une transclusion. La copie automatique en une passe du code/texte d'un modèle vers la destination d'une balise de modèle est appelée substitution de modèle ou subclusion (substitution + transclusion). Pour subclure le code/texte d'un modèle, la balise du modèle est modifiée à partir de la balise standard de transclusion en une balise de substitution, simplement en ajoutant subst:, ce qui crée une balise de la forme:.

Sections de transclusion nommées
Une extension appelée Transclusion de sections avec étiquettes permet la transclusion de sections de texte marquées. Une extension avec une fonction quelque peu similaire est PageVariableExtension.

Semantic MediaWiki
L'extension Semantic MediaWiki utilise les requêtes en ligne pour demander et afficher les données sémantiques. Il existe actuellement deux manières de réaliser la transclusion ou quelque chose qui s'y rapporte : Voir les requêtes en ligne pour d'autres informations.
 * 1) La transclusion proprement dite. Le format d'affichage « en ligne » assure que les pages sélectionnées (les articles de l'espace principal, les modèles, etc.) sont incluses. Comme pour les modèles, les sections placées entre les balises noinclude sont omises.
 * 2) Une propriété de type 'Text' peut être assignée aux passages sélectionnés d'une page. Ces sélections peuvent être demandées en exécutant une requête en ligne pour ce type de propriété.

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

 * Demande de transclusion des modèles de Commons (modèles interwiki, etc.)
 * w:Wikipedia:Substitution (l'opposé de la transclusion)
 * Extension:Labeled Section Transclusion

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