Changes

7,888 bytes added ,  05:55, 27 July 2020
Updating to match new version of source page
<noinclude>
<languages />
</noinclude>{{#switch:
| =
<includeonly>{{languages|Module:Transcluder/doc}}</includeonly>
{{Shared Template Warning|Module:Transcluder|Module:Transcluder}}
Ce module est un '''moteur de transclusion''' à but général, capable de transclure toute partie d'une page quelconque et avec de nombreuses options non fournies par la transclusion standard.

== Utilisation ==

=== Modules ===

Le point d'entrée principal pour les modules est la méthode <code>get</code> .

* <code>get( 'Title' )</code> — Get the requested page (exact same result as normal transclusion)
* <code>get( 'Title#' )</code> — Get the lead section of the requested page
* <code>get( 'Title#Section' )</code> — Get the requested section or {{tag|section|open}} tag (includes any subsections)

{{tag|noinclude|open}} and {{tag|onlyinclude|open}} tags are handled [[Special:MyLanguage/Transclusion#Transclusion markup|the usual way]] and there's also an optional second parameter to exclude various elements from the result:

* <code>get( 'Title#Section', { files = 0 } )</code> — Exclure tous les fichiers
* <code>get( 'Title#Section', { files = 1 } )</code> — Exclure tous les fichiers à l'exception du premier
* <code>get( 'Title#Section', { files = 2 } )</code> — Exclure tous les fichiers sauf le second
* <code>get( 'Title#Section', { files = '1,2' } )</code> — Exclude all files except the first and second
* <code>get( 'Title#Section', { files = '1-3' } )</code> — Exclude all files except the first, second and third
* <code>get( 'Title#Section', { files = '1,3-5' } )</code> — Exclude all files except the first, third, fourth and fifth
* <code>get( 'Title#Section', { files = -2 } )</code> — Exclure le second fichier
* <code>get( 'Title#Section', { files = '-2,3' } )</code> — Exclude the second and third files
* <code>get( 'Title#Section', { files = '-1,3-5' } )</code> — Exclude the first, third, fourth and fifth files
* <code>get( 'Title#Section', { files = 'A.png' } )</code> — Exclude all files except A.png
* <code>get( 'Title#Section', { files = '-A.png' } )</code> — Exclure A.png
* <code>get( 'Title#Section', { files = 'A.png, B.jpg, C.gif' } )</code> — Exclude all files except A.png, B.jpg and C.gif
* <code>get( 'Title#Section', { files = '-A.png, B.jpg, C.gif' } )</code> — Exclude A.png, B.jpg and C.gif
* <code>get( 'Title#Section', { files = { [1] = true, [3] = true } } )</code> — Exclude all files except the first and third
* <code>get( 'Title#Section', { files = { [1] = false, [3] = false } } )</code> — Exclure le premier et le troisième fichier
* <code>get( 'Title#Section', { files = { ['A.png'] = false, ['B.jpg'] = false } } )</code> — Exclure A.png et B.jpg
* <code>get( 'Title#Section', { files = '.+%.png' } )</code> — Exclude all files except PNG files (see [[Special:MyLanguage/Extension:Scribunto/Lua reference manual#Patterns|Lua patterns]])
* <code>get( 'Title#Section', { files = '-.+%.png' } )</code> — Exclure tous les fichiers PNG.

The very same syntax can be used to exclude many other elements:

* <code>get( 'Title#Section', { sections = 0 } )</code> — Exclure toutes les sous-sections.
* <code>get( 'Title#Section', { sections = 'History, Causes' } )</code> — Exclude all subsections except 'History' and 'Causes'
* <code>get( 'Title#Section', { lists = 1 } )</code> — Exclude all lists except the first
* <code>get( 'Title#Section', { tables = 'stats' } )</code> — Exclude all tables except the one with id 'stats'
* <code>get( 'Title#Section', { paragraphs = '1-3' } )</code> — Exclude all paragraphs except the first, second and third
* <code>get( 'Title#Section', { references = 0 } )</code> — Exclure toutes les références
* <code>get( 'Title#Section', { categories = '0' } )</code> — Exclure toutes les catégories
* <code>get( 'Title#Section', { templates = '-.+infobox' } )</code> — Exclure les modèles de boîtes d'information
* <code>get( 'Title#Section', { parameters = 'image' } )</code> — Exclure tous les paramètres de tous les modèles sauf le paramètre 'image'

Les options peuvent être combinées à volonté.
Par exemple :

* <code>get( 'Title#Section', { sections = 0, files = 1, paragraphs = '1-3' } )</code> — Exclude all subsections, all files except the first, and all paragraphs except the first three

Vous pouvez également n'obtenir que quelques éléments de la manière suivante :

* <code>get( 'Title#Section', { only = 'files' } )</code> — Obtenir que les fichiers
* <code>get( 'Title#Section', { only = 'lists', lists = 1 } )</code> — Obtenir que la première liste
* <code>get( 'Title#Section', { only = 'tables', tables = 'stats' } )</code> — Obtenir seulement la table avec l'ID 'stats'
* <code>get( 'Title#Section', { only = 'paragraphs', paragraphs = '1,3-5' } )</code> — Get only the first, third, fourth and fifth paragraph
* <code>get( 'Title#Section', { only = 'templates', templates = 'Infobox' } )</code> — Obtenir seulement la boîte d'information
* <code>get( 'Title#Section', { only = 'files, lists', files = 1 } )</code> — Obtenir seulement le premier fichier, suivi de toutes les listes

The output can be further modified with a few special options:

* <code>get( 'Title#Section', { noFollow = true } )</code> — Ne pas suivre les redirections
* <code>get( 'Title#Section', { linkBold = true } )</code> — Link the bold title or synonym near the start of the text
* <code>get( 'Title#Section', { noBold = true } )</code> — Enlever le texte en gras
* <code>get( 'Title#Section', { noSelfLinks = true } )</code> — Remove self links
* <code>get( 'Title#Section', { noBehaviorSwitches = true } )</code> — Remove [[Special:MyLanguage/Help:Magic words#Behavior switches|behavior switches]] such as <code><nowiki>__NOTOC__</nowiki></code>
* <code>get( 'Title#Section', { fixReferences = true } )</code> — Prefix reference names with 'Title ' to avoid name conflicts when transcluding and rescue references defined outside the requested section to avoid undefined reference errors

Besides the <code>get</code> method, the module exposes several other methods to get specific parts of the wikitext.
This allows other modules to combine elements in more advanced ways.

=== Modèles ===

The main entry point for templates is the <code>main</code> method.
It's essentially a wrapper of the <code>get</code> method to make it usable for templates.

See the documentation of the <code>get</code> method for more details and options.

* <code><nowiki>{{#invoke:Transcluder|main|Title}}</nowiki></code> — Transclure la page demandée
* <code><nowiki>{{#invoke:Transcluder|main|Title#}}</nowiki></code> — Transclude the lead section of the requested page
* <code><nowiki>{{#invoke:Transcluder|main|Title#Section}}</nowiki></code> — Transclude the requested section or {{tag|section|open}} tag (includes any subsections)
* <code><nowiki>{{#invoke:Transcluder|main|Title#Section|sections=0}}</nowiki></code> — Transclude the requested section, excluding subsections
* <code><nowiki>{{#invoke:Transcluder|main|Title|only=files|files=1}}</nowiki></code> — Transclude only the first file of the page
* <code><nowiki>{{#invoke:Transcluder|main|Title#Section|only=tables|tables=2}}</nowiki></code> — Transclude only the second table of the requested section
* <code><nowiki>{{#invoke:Transcluder|main|Title#|only=paragraphs|linkBold=yes}}</nowiki></code> — Transclude only the paragraphs of the lead section and link the bold text

== Voir aussi ==
* [[Module:Transcluder/testcases]]
* [[c:Data:i18n/Module:Transcluder.tab]]

<includeonly>{{#ifeq:{{SUBPAGENAME}}|sandbox | |
<!-- Categories below this line, please; interwikis at Wikidata -->

}}</includeonly>
| #default=
{{#invoke:Template translation|renderTranslatedTemplate|template=Module:Transcluder/doc|noshift=1|uselang={{int:lang}}}}
}}
Anonymous user