De EncyclopAtys
Transclusion
Dans la transclusion Wikipédia, le logiciel MediaWiki se référera 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 tout nom de page peut devenir un lien en plaçant son nom entre doubles crochets, tout nom de page peut devenir un modèle en le plaçant entre doubles accolades, {{Namespace:Pagename}}. Les modifications apportées au modèle sont alors automatiquement répercutées sur toutes les pages dans lesquelles cette page a été intégrée (bien qu'une purge puisse parfois être nécessaire).
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 faire précéder d'un deux-points ( :).
Des exemples de 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 : {{Welcome}}
- l'espace de noms principal (par exemple "Lore"), vous devez placer un symbole « deux points » devant le nom : {{:Lore}}
- tout autre espace de noms (par exemple "User:Example"), vous devez utiliser le nom complet incluant l'espace de noms : {{User:Example}}
- 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 : {{/ja}}
balises associées aux Transclusions partielles
Les balises associées sont <noinclude>, <onlyinclude> et <includeonly>.
La transclusion montrera toute la page (avec les flags de traduction, les catégories etc). Ces 3 balises permettent de choisir ce qui sera montré ou non de la page source.
- typiquement, on met les catégories (code en bas de page) et les flags de traduction entre <noinclude> et </noinclude>
- includeonly est simple (voir l'exemple sur cette page)
- onlyinclude ressemble à includeonly mais en plus complexe.
- Elle l'emporte souvent sur les autres. Cela peut être utile, par exemple, pour répéter une petite partie d'une page sur une deuxième : il suffit d'entourer la petite partie par des balises "onlyinclude" et de l'inclure sur la deuxième page.
- Contrairement à <noinclude> et <includeonly>, <onlyinclude> aura la priorité sur l'insertion de balises <nowiki>. En d'autres termes, <nowiki><onlyinclude>Un texte</onlyinclude></nowiki> ne produit que "Un texte" lorsqu'il est transclu.
Notes et liens
- Source: transclusion (page en anglais).
- https://www.mediawiki.org/wiki/Transclusion/fr
