De EncyclopAtys
La transclusion signifie l'inclusion du contenu d'un document dans un autre document par référence. 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.
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) entre <noinclude> et </noinclude>
- includeonly est simple (voir l'exemple sur cette page)
Notes et liens
- Source: transclusion (page en anglais).
- https://www.mediawiki.org/wiki/Transclusion/fr
