Modèle:Extrait/Documentation

Utilisation de base

• {{Extrait|Titre de la page}} — Transclure la section d'introduction (exemple)
• {{Extrait|Titre de la page|Section titre}} — Transclure une section spécifique, à l'exclusion de toute sous-section (exemple)

Paramètres

• 1 — Titre de la page à transclure. Seul paramètre obligatoire. Par défaut, la section principale sera transcluse (exemple).
• 2 — Titre de la section à transclure (exemple).
• fragment — Nom du fragment à transclure. Doit être marqué avec <section begin=Nom du fragment/> et <section end=Nom du fragment/> dans la page transcluse. Notez que ce modèle fournit d'autres moyens de cibler des fragments spécifiques d'une page sans avoir à recourir aux balises de section.
• seul — Éléments à transclure (exemple). Par défaut, tous les éléments sont transclus.
  • seul=fichiers ou seul=fichier — Transclure uniquement les fichiers
  • seul=liste ou seul=listes — Transclure uniquement les listes
  • seul=table ou seul=tables — Transclure uniquement les tables
  • seul=modèle ou seul=modèles — Transclure uniquement les modèles
  • seul=paragraphe ou seul=paragraphes — Transclure uniquement les paragraphes
• paragraphes — Paragraphes à transclure (exemple). Par défaut, tous les paragraphes sont transclus.
  • paragraphes=0 — Ne pas transclure les paragraphes
  • paragraphes=1 — Transclure le premier paragraphe
  • paragraphes=2 — Transclure le deuxième paragraphe
  • paragraphes=1,3 — Transclure les premier et troisième paragraphes
  • paragraphes=1-3 — Transclure les premier, deuxième et troisième paragraphes
  • paragraphes=1-3,5 — Transclure les premier, deuxième, troisième et cinquième paragraphes
  • paragraphes=-1 — Transclure tous les paragraphes sauf le premier
  • paragraphes=-2 — Transclure tous les paragraphes sauf le second
  • paragraphes=-1,3 — Transclure tous les paragraphes sauf le premier et le troisième
  • paragraphes=-1-3 — Transclure tous les paragraphes sauf le premier, le deuxième et le troisième
  • paragraphes=-1-3,5 — Transclure tous les paragraphes sauf les premier, deuxième, troisième et cinquième
• listes — Listes à transclure. Par défaut, toutes les listes sont transcluses. Même syntaxe que lors de la transclusion de paragraphes.
• fichiers — Fichiers à transclure (exemple). Par défaut, tous les fichiers sont transclus. Même syntaxe que lors de la transclusion de paragraphes, mais aussi :
  • fichiers=A.jpg — Transclure le fichier « A.jpg »
  • fichiers=A.jpg, B.png, C.gif — Transclure les fichiers « A.jpg », « B.png » et « C.gif »
  • fichiers=.+%.png — Transclure tous les fichiers PNG
  • fichiers=-A.jpg — Transclure tous les fichiers sauf « A.jpg »
  • fichiers=-A.jpg, B.png, C.gif — Transclure tous les fichiers sauf « A.jpg », « B.png » et « C.gif »
  • fichiers=-.+%.png — Transclure tous les fichiers non PNG
• tables — Tables à transclure. Par défaut, toutes les tables sont transcluses. Même syntaxe que lors de la transclusion de paragraphes, mais aussi :
  • tables=Stats2020 — Transclure la table ayant l'identifiant « Stats2020 »
  • tables=Stats2020, Stats2019, Stats2018 — Transclure les tables ayant les identifiants « Stats2020 », « Stats2019 » et « Stats2018 »
  • tables=-Stats2020 — Transclure toutes les tables sauf celle ayant l'identifiant « Stats2020 »
  • tables=-Stats2020, Stats2019, Stats2018 — Transclure toutes les tables sauf celles ayant les identifiants « Stats2020 », « Stats2018 » et « Stats2018 »
• modèles — Modèles à transclure. Par défaut, tous les modèles sont transclus, sauf ceux listés en Module:Excerpt/config. Même syntaxe que lors de la transclusion de paragraphes, mais aussi :
  • modèles=Infobox — Transclure le modèle « Infobox »
  • modèles=Infobox, Navbox, Chart — Transclure les modèles « Infobox », « Navbox » et « Chart »
  • modèles=-Infobox — Transclure tous les modèles sauf « Infobox »
  • modèles=-Infobox, Navbox, Chart — Transclure tous les modèles sauf « Infobox », « Navbox » et « Chart »
• ceci — Modifier le texte initial de la note générale. Par exemple, si le contenu transclus est une galerie, vous pouvez définir ceci=Cette galerie est pour que la note générale soit « Cette galerie est un extrait de... » (exemple).
• note=non — Masquer la note générale « Cette section est un extrait de... »
• plus=oui — Afficher un lien «Lire la suite...» à la fin (exemple).
• gras=oui — Garder le texte en gras.
• citer=oui — Encadrer l'extrait avec les balises <blockquote>.
• span=oui — Encadrer l'extrait avec les balises <span> pour l'utiliser dans un autre texte.
• références=non — Supprimer toutes les références.
• sous-sections=oui — Inclure des sous-sections de la section transcluse. Notez que si la transclusion est effectuée à partir d'une section de niveau 3 et que les sous-sections transcluses sont également de niveau 3, alors les sous-sections transcluses s'afficheront avec la même hiérarchie que la section de transclusion, ce qui n'est probablement pas souhaitable, donc à utiliser avec précaution.

Remplacement de sections pour des extraits

Les sections sont souvent des résumés de sous-pages plus précises. Parfois, il est pratique de remplacer le contenu de ces sections par des extraits des sous-pages, après avoir fusionné le contenu original de la section (le cas échéant) dans la sous-page. Cela améliore à la fois la sous-page et la section, réduit la maintenance, pousse les contributeurs à collaborer, etc.

Une manière efficace de procéder est:

1. Ouvrez la section dans un onglet et la sous-page dans un autre.
2. Modifiez les deux.
3. Copiez le texte de la section et collez-le sous la section principale de la sous-page.
4. Supprimer le contenu répété et ajuster avec le bon sens.
5. Enregistrez les modifications dans la sous-page avec un résumé d'édition comme: Apportez du contenu à partir de [[Page]].
6. Revenez à la section, supprimez tout le contenu et remplacez-le par un extrait de la sous-page.
7. Enregistrez les modifications dans la section avec un résumé de modification comme: Déplacer le contenu vers [[Subpage]] et laisser un extrait.