Aide :Transclusion

Un article de Wikipédia, l'encyclopédie libre
Aller à la navigation Aller à la recherche

La transclusion signifie l'inclusion du contenu d'un document dans un autre document par référence . Dans la transclusion de Wikipédia, le logiciel MediaWiki fera référence au contenu d'une page, le modèle , pour l'inclure dans le contenu de toute autre page, la page cible. De la même manière que n'importe quel nom de page peut devenir un lien en plaçant son nom entre doubles crochets, n'importe quel nom de page peut devenir un modèle en le plaçant entre doubles accolades, . Les modifications apportées au modèle sont alors automatiquement répercutées sur toutes les pages dans lesquelles cette page a été transcluse (bien qu'une purge puisse parfois être nécessaire). {{Namespace:Pagename}}

Si le nom de la page du modèle ne commence pas par un espace de noms, il est supposé se trouver dans l'espace de noms du modèle. Pour faire référence à une page dans l'espace de noms "Main" (article), il est nécessaire de la préfixer avec deux-points ( : ). Exemples:

Ce qui sera transclu d'une page peut être contrôlé avec les balises <noinclude>, <onlyinclude> et <includeonly> placées dans le texte wiki de la page source. (Voir le balisage ci-dessous.) L'utilisation de balises permet au modèle de transclure partiellement, sinon les doubles accolades transclureront toujours tout le contenu. Pour la transclusion sélective , les parties <includeonly> du modèle sont nommées (à l'aide de fonctions d'analyseur ) et ce modèle est ensuite appelé avec le paramètre . transcludesection=name

Les événements de transclusion se produisent à chaque fois que la page est chargée , lorsque le modèle est rendu. Une autre utilisation du même mécanisme est une substitution unique de l'appel de modèle lui-même par sa page source transcluse. Un appel de modèle avec le préfixe "subst:" est transclus une fois mais plus jamais, car le wikitext de cet appel est remplacé (substitué) lorsque sa page est enregistrée . Ce qui était un appel de modèle unique devient le texte wiki réel du modèle au moment de son appel. {{fullpagename}}{{subst:fullpagename}}

Comment fonctionne la transclusion

Pour transclure n'importe quelle page source (au sein d'un seul projet MediaWiki, tel que en:Wikipedia), incluez le code suivant dans la page cible :

{{SOURCEPAGE}}

Chaque fois qu'une page cible avec ce code ( {{SOURCEPAGE}}) est rendue, le moteur inclura tout le contenu de SOURCEPAGEdans la page cible.

Dans l'exemple ci-dessous, commençons par la page cible A et SOURCEPAGE B .
Si B est transclus dans A , alors le moteur inclura à cet endroit non pas le code ( {{B}}) lui-même mais le contenu de la page source B (qui se compose d'un seul mot, foo).

La ligne du haut montre comment la page cible A s'affiche, tandis que la ligne du bas montre le code requis pour transclure la page source dans la page cible. Notez que la position du code détermine le rendu de chacune des pages cibles A , P et Q .

Le contenu de la page source foo ne sera pas mis en surbrillance ni encadré sur la page cible.

Transclusion-multiple-foo.svg

Un cas d'utilisation typique de la transclusion serait si vous vouliez placer le même message de bienvenue sur plusieurs pages de discussion pour les nouveaux arrivants.

La transclusion crée un lien "en direct" entre la page du modèle et la ou les pages cibles sur lesquelles le contenu du modèle doit apparaître. Lorsque le modèle est modifié, le rendu de ce modèle sur les pages cibles est également mis à jour. Supposons que vous créez une page (modèle) dans Wikipedia avec l'adresse d'un événement Wikimedia local. Ensuite, vous transclure ce modèle sur votre page de discussion, ainsi que sur les pages de discussion de tous les éditeurs locaux à inviter. Une semaine plus tard, l'événement est déplacé dans un lieu légèrement plus grand. Vous mettrez alors à jour le modèle d'adresse et l' adresse révisée apparaîtra automatiquement sur toutes les pages des autres participants.

La rupture de transclusions existantes dans un modèle est appelée rupture . Il est à éviter si possible, car la rupture se propagera à travers chaque page cible dans laquelle la page modèle (source) a été transcluse.

Syntaxe de transclusion

La syntaxe générale de la transclusion sur Wikipédia est , où décrit le titre d'une page Wikipédia. {{Namespace:Pagename}}Namespace:Pagename

L'utilisation de la syntaxe de transclusion nécessite une certaine connaissance des titres de page. Sur Wikipédia, les pages qui ne sont pas des articles ont des titres avec un espace de noms visible et un nom de page séparés par deux points ; par exemple, la page Wikipedia:Tips a Wikipediacomme espace de noms et Tipscomme nom de page. Mais les articles encyclopédiques n'ont qu'un nom de page visible dans leurs titres : par exemple l'article Potato a Potatocomme nom de page, et l'espace de noms, appelé main namespace , n'est pas visible.

  • Le wikitexte {{Namespace:Pagename}} transclurea la page intitulée Namespace:Pagename. Par exemple, si une page contient le wikitext {{Wikipedia:Notability}}, elle y transclurea la page Wikipedia:Notability . Veuillez noter que {{WP:Notability}}cela ferait exactement la même chose, tout comme WP:un alias d'espace de noms , qui est automatiquement traduit par les serveurs Wikipedia en Wikipedia:.
  • Si l'espace de noms est omis, mais que les deux-points sont inclus, comme {{:Pagename}}, l'article encyclopédique Pagenamesera transclus. Par exemple, {{:Notability}}transcludera l'article notabilité .
  • Si l'espace de nom et les deux-points sont omis, comme {{Pagename}}, le Template:Pagenamesera transclus. Par exemple {{Notability}}, et aussi {{Template:Notability}}, transclureont tous les deux le Template:Notability .
  • Pour transclure les sous-pages, consultez cette section . Voir également la section des paramètres de modèle et des modificateurs de transclusion .

Donc, en résumé, une page d'exemple ayant le wikitext {{Pagename}}ou {{Template:Pagename}}inclus, transclurea le Template:Pagenamedans cette page d'exemple. Mais {{:Pagename}}aura un effet différent : il transclurea l'article Pagename. Transclude également {{Namespace:Pagename}}la page Namespace:Pagename, pour les pages avec des titres de ce format.

Transclusion de modèle

L'application la plus courante de la transclusion est la transclusion de modèles . Les modèles sont des pages écrites dans le but premier d'être incluses dans d'autres pages, soit par transclusion, soit par substitution . Comme indiqué ci-dessus, la syntaxe habituelle pour transclure un modèle intitulé Template:Pagename est {{Pagename}}. Cependant, certains modèles peuvent également utiliser des paramètres . Les paramètres sont des variables qui peuvent recevoir des valeurs (également appelées arguments ) qui peuvent être transmises à certains modèles afin qu'ils fonctionnent de différentes manières. Les modèles peuvent soit n'utiliser aucun paramètre, soit un nombre fixe de paramètres, soit un nombre variable de paramètres. Le nombre de paramètres qu'un modèle peut utiliser est de un vers le haut.

La syntaxe exacte pour l'utilisation de paramètres avec des modèles peut varier considérablement, selon le modèle réel utilisé. Mais, pour un modèle d'exemple intitulé Template:Pagename, qui utilisait trois paramètres, la forme générale serait :

{{Pagename|parameter1|parameter2|parameter3}}

chaque paramètre étant remplacé par un value, ou un parameter name=value, lorsqu'il est utilisé dans la pratique. Notez que chaque paramètre est séparé par une barre verticale . Les paramètres qui prennent la forme valuesont appelés paramètres sans nom ou positionnels. Les paramètres qui prennent la forme parameter name=valuesont appelés paramètres nommés . Avec des paramètres sans nom, les premier, deuxième, troisième etc. paramètres sont équivalents aux paramètres '1', '2', '3' etc. dans la documentation du modèle. Les paramètres sans nom doivent être dans le bon ordre et mieux placés avant les paramètres nommés. Un exemple de syntaxe utilisant le Template:Collapse top :

{{Collapse top|This is the title text|This is a custom warning line|left=true}}

Dans cet exemple particulier, trois paramètres sont utilisés, mais Template:Collapse top peut en fait utiliser un nombre variable de paramètres. This is the title textet This is a custom warning linesont les valeurs des paramètres sans nom '1' et '2' ; et trueest la valeur du paramètre nommé left.

Pour plus de détails, voir Aide:Modèle . Voir également Wikipedia:Template index pour une liste de liens vers les modèles disponibles liés à l'espace de noms principal (généralement pour les articles encyclopédiques) ; et d'autres modèles liés à l'espace de noms (généralement pour les pages sans article) ; il y a aussi une fonction de recherche.

Substitution

La substitution a une syntaxe similaire à double accolade et son action est similaire à la transclusion. Lorsque vous prévisualisez une page contenant du texte wiki de substitution, son action est identique à la transclusion. Mais lorsque vous enregistrez une page contenant un texte wiki de substitution, cela diffère en ce qu'il remplace ce texte wiki par le texte wiki réel du modèle.

Par exemple, lorsque {{subst:Like}}est enregistré, il remplacerait ce wikitexte par le wikitexte réel du Template:Like . En pratique, la principale différence que cela fait est que si une mise à jour arrivait au wikitext du Template:Like, il ne mettrait pas à jour les pages {{subst:Like}}déjà enregistrées.

mots magiques

Les mots magiques ne sont pas des exemples de transclusion. Mais certains ont une syntaxe et une action à double accolade similaires à la transclusion. Par exemple, {{FULLPAGENAME}}rend le Fullpagename de n'importe quelle page Wikipedia. Comme les modèles, certains mots magiques peuvent également prendre des paramètres, qui sont séparés par deux-points (:) ; par exemple {{FULLPAGENAME:value}}.

Des modèles existent pour certains mots magiques, par exemple Template:FULLPAGENAME ; mais ceux-ci invoquent simplement le mot magique associé si vous passez des paramètres à l'aide d'une barre verticale (|); par exemple comme {{FULLPAGENAME|value}}. Mais les paramètres de mots magiques sont mieux passés directement en utilisant deux-points, par exemple comme {{FULLPAGENAME:value}}, qui contourne tous les modèles.

Modificateurs de transclusion

Comme indiqué ci-dessus, avec l'exemple {{subst:Like}}, le subst:code modifie la transclusion en substitution. Il s'agit d'un modificateur de transclusion , un type de mot magique spécialisé pour modifier la transclusion d'une manière ou d'une autre. Un autre exemple est {{:Notability}}, où le :(caractère deux-points) force la transclusion vers l'espace de noms principal. Il existe des modificateurs de transclusion supplémentaires tels que safesubst:, int:, msg:, msgnw:et raw:. Pour plus de détails sur leur utilisation, voir mw:Help:Magic words § Modificateurs de transclusion . Voir aussi les commandes modifiées #section:, #section-x:et #section-h:utilisées pour la transclusion de section étiquetée .

Applications de transclusion

L'application la plus courante de la transclusion est l'utilisation de modèles . Cependant, d'autres pages sont également parfois transcluses, principalement dans l'espace du projet.

Pages composées

Les pages composites sont constituées, en totalité ou en partie, de pages composantes transcluses. Le wikitext d'une telle page peut, en partie ou en totalité, être constitué de balises, pour l'inclusion de pages composantes. Les pages de composants ne se trouvent généralement pas dans l'espace de noms du modèle et sont souvent des pages complètes à part entière. Les pages composites sont destinées à les rassembler dans un emplacement central.

Exemples de pages composites :

Cela permet de choisir entre visualiser les pages des composants séparément ou ensemble. L'affichage d'une page composite est pratique lorsqu'il existe de nombreuses petites pages de composants connexes, en ce sens qu'elle permet une vue d'ensemble de tous les composants sans l'effort de suivre de nombreux liens.

En général, chaque page composant et la page composite sont traitées séparément. Bien que les modifications réelles apportées aux pages composantes soient transcluses sur la page composite, l'historique des modifications, les modifications récentes, les paramètres de surveillance de la page, la protection de la page, la table des matières, les liens "quels liens ici" et d'autres fonctionnalités de la page composite ne reflètent pas , ou affecter, les historiques, les paramètres de la montre, les niveaux de protection, ce qui relie ici les listes des pages des composants. La page composite est une page à part entière. La page de discussion d'une page composite est utilisée pour parler de la composition et de la page en général, pas des pages composantes ; bien qu'il puisse à son tour être un composite des pages de discussion des pages de composants.

L'édition d'une section d'une page de composant peut être effectuée directement depuis la page composite, voir l'édition des sections des modèles inclus . Après l'enregistrement, on finit par éditer la page du composant auquel appartient la section.

Sur les projets avec la fonctionnalité de lien interlangue , la page composite affiche les liens interlangues combinés de toutes les pages du composant, donc éventuellement plusieurs liens pour une langue ou même pour une page.

Voir aussi Wikipedia talk:Template namespace/Archive 1#transcluding prose .

Pages avec une section commune

Lorsque deux pages doivent discuter de la même matière de la même manière, elles peuvent partager une section. Cela implique de créer une troisième page et de transclure cette page sur les deux pages. Cette troisième page peut être une page à part entière ou une sous-page de l'une des deux autres, et si c'est la première, elle peut être placée dans le même espace de noms que les autres pages ou dans l'espace de noms du modèle. Les sections communes comme celle-ci doivent être marquées d'un en-tête explicatif et/ou d'une mise en page spéciale, pour informer le lecteur que cette section de la page se trouve à un emplacement différent, car la transclusion des sections d'articles partagés peut facilement confondre les éditeurs novices et les lecteurs si laissé sans marque.

Cela peut être très utile lorsque deux pages de désambiguïsation partagent du contenu, [ contesté ] ou qu'une page de liste et une page de désambiguïsation partagent du contenu (voir le troisième exemple ci-dessous).

Exemples:

Répétition dans une page

Sur les pages contenant de nombreuses informations répétitives (généralement différents types de listes), il est parfois utile de créer un modèle contenant le texte répétitif, puis d'appeler ce modèle plusieurs fois. Par exemple, la ligne de construction répertoriée Template:EH est utilisée à plusieurs reprises pour construire des tableaux dans de nombreux articles.

La répétition simple du même texte peut être gérée avec la répétition d'un paramètre dans un modèle unique : par exemple, {{ 3x }}, où {{3x| howdy!}}produit howdy! howdy! howdy!.

Pour plus d'informations sur la répétition, voir aussi m:Help:Recursive conversion of wikitext .

Pour plus d'informations sur le système de template actuel, voir Wikipedia:Template namespace .

Transclusion partielle

En utilisant <noinclude>, <includeonly>et <onlyinclude>le balisage, il est possible de transclure une partie d'une page, plutôt que la totalité. De telles transclusions partielles peuvent être réalisées en effectuant une transclusion à partir de n'importe quelle page, y compris les sous-pages. Il est souvent utile d'exclure une partie d'une page dans une transclusion, un exemple étant avec la documentation de modèle.

Pour un exemple de la façon dont cette technique peut être appliquée pour simplifier la création d' articles de synthèse , voyez comment une partie de l' Histoire de la pathologie (voir le diff ici ) a été transcluse en Pathologie (voir le diff ici ) en utilisant le {{:History of pathology}}balisage. L'article sur la pathologie à l'époque (voir ici ) se composait principalement de paragraphes principaux transclus et d'autres sections d'un certain nombre d'articles. Regardez la source pour voir comment cela a été fait. Depuis, l'article de Pathologie a été réécrit, et n'inclut pas toutes ces transclusions.

Un autre exemple peut être trouvé dans la transclusion d'une partie de HitRecord (paragraphe d'introduction uniquement) dans une section de résumé du même nom dans Joseph Gordon-Levitt .

Balisage

Dans la transclusion, une page source est transcluse dans une page de destination. Mais avec une transclusion partielle, seule une partie de cette page source sera transcluse dans une page de destination. Mais en plus, ce qui est transclus à une page de destination n'a pas à être visible sur la page source.

Le rendu de page d'une page source peut être défini comme le rendu de cette page source lorsqu'elle est enregistrée, qui sera identique à l' aperçu . Nous pouvons appeler ce rendu ici .

Le rendu de transclusion d'une page source peut être défini comme le rendu d'une page de destination qui contient une page source transcluse ; mais uniquement la partie de la page de destination qui a été transcluse de la page source. L'aperçu du rendu de transclusion sera à nouveau identique. Nous pouvons appeler ce rendu ici .

Il y a trois paires de balises impliquées dans les cas où le rendu de la page ici devrait différer du rendu de la transclusion -bas . Comme décrit précédemment, ce sont <noinclude>, <includeonly>et <onlyinclude>. Ces balises sont invisibles, mais affectent à la fois le rendu de la page ici et le rendu de la transclusion . Ces balises s'associent pour délimiter les sections qui créeront des différences. Chaque balise décrira les exceptions à la transclusion de la page entière nommée.

<noinclude> Cette section est visible ici ; mais cette section n'y est pas visible. Les sections en dehors de ces balises seront visibles à la fois ici et là. </noinclude>

<onlyinclude> Cette section est visible ici ; cette section y est également visible. Les sections en dehors de ces balises seront visibles ici, mais ne seront pas visibles là. </include>

<includeonly> Cette section n'est pas visible ici ; mais c'est visible là. Les sections en dehors de ces balises seront visibles à la fois ici et là. </includeonly>
Wikitexte Ce qui est rendu ici (page source) Ce qui y est transclus (page de destination)
<noinclude>text1</noinclude>texte2 text1 text2 text2
<onlyinclude>text1</onlyinclude>texte2 text1 text2 text1
<includeonly>text1</includeonly>texte2 text2 text1 text2

Un point important à noter est que <noinclude>et <onlyinclude>n'affectent pas du tout le rendu de la page ici , contrairement à <includeonly>. Les <noinclude>balises empêchent le texte à l'intérieur des balises d' y être transclus , alors qu'elles <onlyinclude>ont l'effet inverse : elles empêchent le texte à l'extérieur des balises d' y être transclus .

Arrête uniquement <includeonly>le rendu du texte de la page ici . Mais assez naturellement il y est transclus . Le texte en dehors des balises sera à la fois rendu ici et transclus .

Il peut y avoir plusieurs sections de ce type. De plus, ils peuvent être imbriqués. Toutes les différences possibles entre ici et -bas sont réalisables. Un exemple est un éditeur de contenu qui choisit une <onlyinclude>section, puis en extrait une <noinclude>section ; mais choisit ensuite une autre <onlyinclude>section à y ajouter ; mais rien de tout cela n'affecte leur article en aucune façon.

L'autre exemple est le programmeur de modèles, qui s'occupera <includeonly>de la section de code et <noinclude>de la section de documentation d'une page.

Un mauvais exemple est, sur une page utilisateur, d'utiliser <includeonly>pour "commenter" une section. Bien qu'il puisse commenter des sections ici , une telle encre invisible peut s'avérer gênante ; si transclus, les commentaires seraient révélés. Utilisez à la <!--...-->place.

NoInclude en tant que nom sur la transclusion est assez simple. Il existe un mnémonique pour les deux autres transclusions : Inclusion ONLY ; et encore une autre inclusion SEULEMENT .

Transclusion sélective

La transclusion sélective est le processus de transclusion partielle d' une section sélectionnée d'un document qui a plus d'une section transcludable. Comme indiqué ci-dessus, si une seule section d'un document doit être transcluée, cela peut être fait en entourant simplement la section d'intérêt avec des <onlyinclude> … </onlyinclude>balises et en transcluant toute la page. Cependant, pour transclure sélectivement une section d'un modèle ou d'un document dans une page, et une autre section du même modèle ou document dans une deuxième page et/ou une section différente de la même page, il faut un moyen de :

a) marquer de manière unique chaque section transcludable dans le document source ; et
b) dans le(s) document(s) cible(s) (ceux qui montrent les sections transcluses), un moyen de spécifier quelle section doit être transcluse.

Cette section décrit comment y parvenir. Il existe trois façons de procéder : (1) la transclusion basée sur l'en-tête de section, (2) la transclusion de section étiquetée et (3) la méthode de paramétrisation.

Transclusion de section standard (le balisage spécial du document source n'est pas nécessaire !)

À l' aide {{#section-h:PAGENAME|SECTIONNAME}}de , on peut facilement transclure le contenu d'une section d'une page à une autre en se référant aux en-têtes de section standard et omniprésents basés sur les titres utilisés dans Wikipédia. Pour transclure le titre d'un article avec cette méthode, on peut utiliser {{#section-h:PAGENAME}}. C'est plus simple que les méthodes de transclusion sélective déjà largement utilisées des sections ci-dessous, qui nécessitent un balisage spécial du document source.

 Cette méthode de transclusion sélective ajoute souvent un saut de ligne au-dessus et/ou au-dessous de la transclusion de section, selon le balisage du document source et cible ; pour éviter ce problème, enveloppez le modèle de transclusion sélective dans un modèle. {{trim}}En d'autres termes, utilisez les modifications suivantes du code de transclusion répertorié immédiatement ci-dessus :

  • Code pour transclure une section dans le corps d'un article :{{trim|{{#section-h:PAGENAME|SECTIONNAME}}}}
  • Code pour transclure le début d'un article :{{trim|{{#section-h:PAGENAME}}}}

Note de chapeau de la section transcluse

Afin d'indiquer où se trouve le contenu de l'article transclus sélectivement, il est utile d'inclure une note de chapeau en haut de la section correspondante d'un article ; c'est-à-dire, utilisez soit ou , selon que le contenu transclus comprend une section entière de la page cible. Ces modèles s'affichent comme suit. {{Transcluded section}}{{transcluded section|source=PAGENAME}}{{transcluded section|source=PAGENAME|part=yes}}

  • {{transcluded section|source=PAGENAME}}rend comme:
  • {{transcluded section|source=PAGENAME|part=yes}}rend comme:

Utilisation de la méthode de la section étiquetée

La transclusion sélective de section étiquetée utilise les fonctions d'analyseur répertoriées dans mw:Extension:Labeled Section Transclusion , qui sont activées sur tous les wikis Wikimedia, pour transclure sélectivement le contenu. Voir Help:Labeled section transclusion pour savoir comment fonctionne la transclusion de section étiquetée.

Méthode de paramétrage

Balisage du document source

Insérez la ligne suivante dans le document "source" (celui dont le texte doit être transclus), précédant immédiatement la première ligne de chaque section à transclure, en remplaçant SECTIONNAME (deux fois) par le nom unique de la section respective. Le nom de la section peut être n'importe quel identifiant et doit être unique dans ce document :

<onlyinclude>{{#ifeq:{{{transcludesection|SECTIONNAME}}}|SECTIONNAME|

Terminez chacune de ces sections transcludables par :

}}</onlyinclude>
Balisage du document cible

Pour transclure une section marquée comme ci-dessus dans une autre page (la "page cible"), utilisez la ligne suivante sur cette page, en remplaçant PAGENAME par le document "source" à partir duquel le texte doit être transclu, et SECTIONNAME par le nom de la section que vous veux transclure :

{{PAGENAME|transcludesection=SECTIONNAME}}

Ainsi, chaque section entourée de <onlyinclude> … </onlyinclude> balises sera toujours rendue lorsque le transcludesectionparamètre n'est pas défini (lorsque le document est affiché normalement, ou lorsque le document est transclus sans définir le transcludesectionparamètre comme indiqué ci-dessous), et sera rendu par transclusion sur toute page qui ne défini transcludesectionsur le nom de la section. Il ne sera pas rendu par la transclusion qui utilise le transcludesectionparamètre mais le définit sur autre chose que le nom de la section.

De plus, lors de la fourniture de PAGENAME, sans fournir de Namespace , le wiki supposera que PAGENAME appartient au Template Namespace . Pour transclure à partir d'un article Mainspace , utilisez :PAGENAME.

{{:PAGENAME|transcludesection=SECTIONNAME}}
Exemple

Si nous voulons que les sections "Principal Criteria" et "Common Name" de WP:TITLE soient transcludables indépendamment, nous éditons la page WP:TITLE et joignons la section "Principal Criteria" comme suit :

<onlyinclude> {{ # ifeq : {{{ transcludesection | critère principal }}} | critères principaux | 
... 
'' ( texte  de la  section "Critères principaux"  ) '' ... }} </onlyinclude>


De même, nous joignons la section "Nom commun" avec :

<onlyinclude> {{ # ifeq : {{{ transcludesection | nom commun }}} | nom commun | 
... 
'' ( texte  de la  section "Nom commun"  ) '' ... }} </onlyinclude>


Ensuite, pour transclure la section "Critères principaux" dans une autre page, nous insérons dans cette page :

{{WP:TITLE|transcludesection=principalcriteria}}

Pour transclure la section "Common Name" dans une autre page, nous insérons dans cette page :

{{WP:TITLE|transcludesection=commonname}}

Bien sûr, la même page peut transclure deux ou plusieurs sections de cette façon en incluant plusieurs de ces lignes.

Il n'y a pas de limite au nombre de sections sélectionnables pour la transclusion qu'un document peut avoir. La seule exigence est que chacun transcludesectionreçoive une valeur unique dans cette page.

Sous-pages

Pour transclure une sous- page :

  • La syntaxe générale est {{Namespace:Pagename/subpagename}}.
  • S'il s'agit d'une sous-page de la page que vous modifiez, il s'agit de la syntaxe générale, ou {{/subpagename}}.
  • Pour un article encyclopédique, c'est {{:Pagename/subpagename}}, bien que les sous-pages d'articles soient normalement désactivées.
  • Pour un template, c'est la syntaxe générale, ou {{Pagename/subpagename}}.
  • Vous avez la possibilité d'utiliser des modificateurs de transclusion et des paramètres de modèle , mais en pratique, cela est rare.

Par exemple, pour transclure le Template:Like/doc , ce serait soit {{Template:Like/doc}}ou {{Like/doc}}. Les sous-pages ne sont autorisées que dans certains espaces de noms, tels que les pages Utilisateur, Discussion ou Wikipédia ; actuellement, les sous-pages des pages d'articles principales ne peuvent pas être créées .

Les sous-pages peuvent être utilisées pour une discussion partagée sur les pages de discussion. Par exemple : vous souhaitez discuter de la suppression et de la redirection de l'article Pussycat vers l'article Cat dans les deux pages de discussion. Commencez par créer la sous-page Talk:Pussycat/Let's delete Pussycat ! , écrivez-y votre commentaire, puis transcluez-le dans Talk:Pussycat et Talk:Cat en utilisant le modèle {{Talk:Pussycat/Let's delete Pussycat!}}. Les commentaires publiés dans cette sous-page seront affichés dans les deux pages de discussion. Pour faciliter l'édition de la sous-page, il peut être utile de faire précéder l'exposé transclus de {{ lat }} ; par exemple, le wikitext {{lat|Pussycat/Let's delete Pussycat!}}produirait Talk:Pussycat/Let's delete Pussycat!  ( éditer |articles | histoire | liens | regarder | journaux ) . La transclusion de cette manièreneconservera pas un enregistrement fixe de la discussion au moment de tout archivage, de sorte que les discussions doivent être fermées en même temps que l'archivage.

Une alternative consiste à ne pas utiliser de sous-pages du tout. Vous pouvez centraliser la discussion, de manière normale, sur une seule page de discussion et la pointer sur l'autre page de discussion en remplaçant le modèle {{ Veuillez voir }}, conformément à WP:MULTI . Par exemple, une discussion pourrait avoir lieu sur Talk:Pussycat#Let's delete Pussycat ! ; vous pouvez alors placer le wikitext {{subst:Please see|Talk:Pussycat#Let's delete Pussycat!}}dans la page Talk:Cat . Une fois la modification enregistrée, elle la remplacerait par le texte :

==Discussion sur Talk :Pussycat#Supprimons Pussycat !==
[[File:Farm-Fresh eye.png|15px|link=|alt=]] Vous êtes invité à rejoindre la discussion sur [[Talk:Pussycat#Let's delete Pussycat !]]. Merci. [[User:Example|Example]] ([[User talk:Example|talk]]) 19:03, 20 octobre 2014 (UTC){{z48}}<!--Template:Veuillez voir-->

Pages spéciales

Certaines pages sur Special:Specialpages peuvent être transcluses, telles que Special:Allpages , Special:Prefixindex , Special:Newfiles , Special:Newpages , Special:Recentchanges et Special:Recentchangeslinked . Échantillons :

  • {{Special:Allpages/General}}– une liste de pages commençant par "Général".
  • {{Special:Prefixindex/General}}– une liste de pages avec le préfixe "Général".
  • {{Special:Newfiles/4}}– une galerie des quatre derniers fichiers téléchargés.
  • {{Special:Newpages/5}}– une liste des cinq dernières pages créées.
  • {{Special:Recentchanges/5}}– les cinq modifications les plus récentes.
  • {{Special:Recentchangeslinked/General}}– modifications récentes des pages liées depuis "Général".

Tenter de transclure {{Special:Categories}}n'entraînera pas une véritable liste de catégories, mais {{Special:Prefixindex/Category:}}peut être utilisé à cette fin.

À l' exception de Special:Recentchangeslinked, la barre oblique et le mot ou le nombre après la barre oblique peuvent être omis, donnant une liste de pages sans point de départ spécifique ou une liste de la longueur par défaut.

Les paramètres d' URL peuvent être donnés comme des paramètres de modèle :

  • {{Special:Recentchanges|namespace=10|limit=5}}– les cinq changements les plus récents dans l'espace de noms "Template".
  • {{Special:Prefixindex/Jimbo Wales/|namespace=2|stripprefix=1}}– les sous-pages pour User:Jimbo Wales , mais sans le préfixe de la page utilisateur.

Remarque : La transclusion de certaines pages spéciales (telles que Special:Newpages ) peut modifier le titre affiché de la page.

Voir également

Transclusion MediaWiki

Modèles

Autre