Modèle:Excerpt

This page is a translated version of the page Template:Excerpt and the translation is 100% complete.
Documentation du modèle

Ce modèle est utilisé pour réutiliser des parties de pages dans d'autres pages. Ce moyen présente plusieurs avantages:

  • Réduit la maintenance en évitant le contenu en double devant être mis à jour plusieurs fois
  • Améliore la qualité du contenu en encourageant les éditeurs à fusionner le contenu associé, plutôt que d'avoir plusieurs versions à différents stades de développement
  • Favorise la collaboration en canalisant les contributeurs en un seul endroit, plutôt que de travailler en parallèle

Ce modèle étend les capacités de la transclusion normale intégrée.

Utilisation

Utilisation de base

  • {{Excerpt|Page title}} — Transclure la section d'introduction (exemple)
  • {{Excerpt|Page title|Section title}} — 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) ou nom du ‎<section> tag à transclude. 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.
  • only — Éléments à transclure (exemple). Par défaut, tous les éléments sont transclus.
    • only=file ou only=files — Transclure uniquement les fichiers
    • only=list ou only=lists — Transclure uniquement les listes
    • only=table ou only=tables — Transclure uniquement les tableaux
    • only=template ou only=templates — Transclure uniquement les modèles
    • only=paragraph ou only=paragraphs — Transclure uniquement les paragraphes
  • paragraphs — Paragraphes à transclure. Par défaut, tous les paragraphes sont transclus.
    • paragraphs=0 — Ne pas transclure les paragraphes
    • paragraphs=1 — Transclure le premier paragraphe
    • paragraphs=2 — Transclure le deuxième paragraphe
    • paragraphs=1,3 — Transclure les premier et troisième paragraphes
    • paragraphs=1-3 — Transclure les premier, deuxième et troisième paragraphes
    • paragraphs=1-3,5 — Transclure les premier, deuxième, troisième et cinquième paragraphes
    • paragraphs=-1 — Transclure tous les paragraphes sauf le premier
    • paragraphs=-2 — Transclure tous les paragraphes sauf le second
    • paragraphs=-1,3 — Transclure tous les paragraphes sauf le premier et le troisième
    • paragraphs=-1-3 — Transclure tous les paragraphes sauf le premier, le deuxième et le troisième
    • paragraphs=-1-3,5 — Transclure tous les paragraphes sauf les premier, deuxième, troisième et cinquième
  • lists — Listes à transclure. Par défaut, toutes les listes sont transcluses. Même syntaxe que lors de la transclusion de paragraphes.
  • files — Fichiers à transclure. Par défaut, tous les fichiers sont transclus. Même syntaxe que lors de la transclusion de paragraphes, mais aussi :
    • files=A.jpg — Transclure le fichier « A.jpg »
    • files=A.jpg, B.png, C.gif — Transclure les fichiers « A.jpg », « B.png » et « C.gif »
    • files=.+%.png — Transclure tous les fichiers PNG
    • files=-A.jpg — Transclure tous les fichiers sauf « A.jpg »
    • files=-A.jpg, B.png, C.gif — Transclure tous les fichiers sauf « A.jpg », « B.png » et « C.gif »
    • files=-.+%.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 »
  • templates — Modèles à transclure. Par défaut, tous les modèles sont transclus. Même syntaxe que lors de la transclusion de paragraphes, mais aussi :
    • templates=Infobox — Transclure le modèle « Infobox »
    • templates=Infobox, Navbox, Chart — Transclure les modèles « Infobox », « Navbox » et « Chart »
    • templates=-Infobox — Transclure tous les modèles sauf « Infobox »
    • templates=-Infobox, Navbox, Chart — Transclure tous les modèles sauf « Infobox », « Navbox » et « Chart »
  • this — Modifier le texte initial de la note générale. Par exemple, si le contenu transclus est une galerie, vous pouvez définir this=This gallery is pour que la note générale soit « Cette galerie est un extrait de... »
  • hat=no — Masquer la note générale « Cette section est un extrait de... »
  • more=yes — Afficher un lien « Lire plus... » à la fin
  • bold=yes — Garder le texte en gras.
  • quote=yes — Encadrer l'extrait avec les balises ‎<blockquote>.
  • inline=yes — Encadrer l'extrait avec les balises ‎<span> pour l'utiliser dans un autre texte.
  • references=no — Supprimer toutes les références.
  • subsections=yes — 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

Comment remplacer une section par un extrait.

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 de 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. Ouvrir la section dans un onglet et la sous-page dans un autre.
  2. Modifier les deux.
  3. Copier le texte de la section et le coller sous la section principale de la sous-page.
  4. Supprimer le contenu répété et ajuster avec bon sens.
  5. Enregistrer les modifications dans la sous-page avec un résumé d'édition comme : Contenu rapporté de [[Page]].
  6. Revenir à la section et supprimer tout le contenu en le remplaçant par un extrait de la sous-page.
  7. Enregistrer les modifications dans la section avec un résumé des modifications comme : Déplacer le contenu vers [[Subpage]] et laisser un extrait.

Exemples

Section principale

{{Excerpt|Lorem ipsum}}
This is an image.
This is another image.

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.[1]

Section spécifique

{{Excerpt|Lorem ipsum|Section}}

Sed ut perspiciatis unde omnis iste natus error sit voluptatem accusantium doloremque laudantium, totam rem aperiam, eaque ipsa quae ab illo inventore veritatis et quasi architecto beatae vitae dicta sunt explicabo. Nemo enim ipsam voluptatem quia voluptas sit aspernatur aut odit aut fugit, sed quia consequuntur magni dolores eos qui ratione voluptatem sequi nesciunt. Neque porro quisquam est, qui dolorem ipsum quia dolor sit amet, consectetur, adipisci velit, sed quia non numquam eius modi tempora incidunt ut labore et dolore magnam aliquam quaerat voluptatem. Ut enim ad minima veniam, quis nostrum exercitationem ullam corporis suscipit laboriosam, nisi ut aliquid ex ea commodi consequatur? Quis autem vel eum iure reprehenderit qui in ea voluptate velit esse quam nihil molestiae consequatur, vel illum qui dolorem eum fugiat quo voluptas nulla pariatur?

Fichiers seulements

{{Excerpt|Lorem ipsum|only=files|hat=no}}
This is an image.
This is another image.

Boîte d'information seulement

{{Excerpt|Extension:CategoryLockdown|only=templates|templates=Extension|this=This infobox is}}
Manuel des extensions MediaWiki
OOjs UI icon advanced-invert.svg
Excerpt
État de la version : stable
Implémentation Droits utilisateur
Description Restrict permissions by category and group
Auteur(s) Sophivorusdiscussion
MediaWiki
Modifie la base
de données
Non
Licence Aucune licence spécifiée
Téléchargement
Exemple [1]
Traduire l’extension Excerpt sur translatewiki.net si elle y est disponible

Pas de boîte d'information

{{Excerpt|Extension:CategoryLockdown|templates=-Extension}}

The CategoryLockdown extension allows admins to restrict permissions by category and group.

Portail

{{Excerpt|Lorem ipsum|files=1|references=no|hat=no|more=yes}}
This is an image.

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

Voir aussi

Données du modèle

Transclure toute partie de page.

Template parameters

ParameterDescriptionTypeStatus
Page1

Page à transclure

Example
Science
Page namerequired
Section2

Section à transclure

Example
Histoire
Stringoptional
Résuméhat

Masquer le résumé

Example
0
Booleanoptional
Cecithis

Texte initial de la note générale

Example
Cette galerie est
Stringoptional
Lire la suitemore

Afficher un lien « Lire la suite... » à la fin

Example
1
Booleanoptional
Grasbold

Garder le texte en gras

Example
1
Booleanoptional
Citerquote

Encadrer l'extrait avec les balises <blockquote>

Example
1
Booleanoptional
En ligneinline

Encadrer l'extrait avec les balises <span> pour l'utiliser dans un autre texte

Example
1
Booleanoptional
Référencesreferences

Supprimer toutes les références

Example
0
Booleanoptional
Sous-sectionssubsections

Inclure des sous-sections de la section transcluse

Example
1
Booleanoptional
Fragmentfragment

Nom du fragment à transclure

Example
Nom du fragment
Booleanoptional
Seulonly

Éléments à transclure

Example
tables
Stringoptional
Paragraphesparagraphs

Paragraphes à transclure

Example
1-3,5
Stringoptional
Fichiersfiles

Fichiers à transclure

Example
A.jpg, B.png
Stringoptional
Tablestables

Tables à transclure

Example
Stats2020
Stringoptional
Listeslists

Listes à transclure

Example
1-3,5
Stringoptional
Modèlestemplates

Modèles à transclure

Example
Infobox
Stringoptional
Modifier les traductions des paramètres