Modèle:Excerpt

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 de la balise ‎<section> à 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... »
• displaytitle — Modifiez le texte du lien de la note chapeau. Par exemple en ajoutant des italiques, des indices, etc.
• 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 — Supprimer la note générale et les balises ‎<div> autour de l'extrait 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.

Remplacer une section par un extrait

Comment remplacer une section par un extrait.

Une section est souvent le résumé d'une page plus précise traitant d'un sous-sujet. Parfois, il est pratique de remplacer le contenu d'une telle section par un extrait de la page concernant le sous-sujet, sous-pages, après avoir fusionné le contenu original de la section (s'il existe) dans la page du sous-sujet. Cela améliore à la fois la page du sous-sujet et la section, réduit la maintenance, pousse les contributeurs à collaborer, etc.

Une manière efficace de procéder est :

1. Ouvrir la section pour édition dans un onglet et la page du sous-sujet dans un autre.
2. Copier le texte de la section et le coller en tête de la page du sous-sujet.
3. Consolider et ajuster le début combiné en utilisant le sens commun.
4. Enregistrer les modifications dans l'article fils avec un résumé des modifications comme : Contenu copié de [[Page]]; voir l'historique de cet article pour les attributions.
5. Revenir à la section, supprimer tout le contenu en le remplaçant par un extrait de la page du sous-sujet.
6. Enregistrer les modifications dans la section avec un résumé des modifications comme : Déplacer le contenu vers [[page about the subtopic]] et laisser un extrait.

Arborescences d'extraits

Représentation visuelle d'une arborescence à extraire.

Quand un article très général utilise des extraits d'articles plus spécifiques, qui à leur tour utilisent des extraits d'articles encore plus spécifiques, alors on forme une structure arborescente appelée Arborescence d'extraits.

Vous pouvez parcourir ci-dessous les principales arborescences d'extraits de ce wiki. C'est utile pour les éditeurs qui veulent élargir ou améliorer des articles.

• Architecture Repository
• Platform Engineering Team

Exemples

Section principale

{{Excerpt|Lorem ipsum}}

Cette section est un extrait de Lorem ipsum.[modifier]

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.

Section spécifique

{{Excerpt|Lorem ipsum|Section}}

Cette section est un extrait de Lorem ipsum § Section.[modifier]

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 seulement

{{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}}

This infobox is un extrait de Extension:CategoryLockdown.[modifier]

Manuel des extensions MediaWiki

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	Télécharger l'extension Git [?]: parcourir le dépôt (GitHub) relecture Gerrit du code historique Git des validations (commits) Télécharger le tarball source
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}}

Cette section est un extrait de Extension:CategoryLockdown.[modifier]

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

• Module:Transcluder ^[doc]
• Module:Excerpt
• Module:Excerpt/config
• c:Data:I18n/Module:Excerpt.tab

Données du modèle

Transclure toute partie de page.

Template parameters[Edit template data]

Parameter		Description	Type	Status
Page	1	Page à transclure Example Science	Page name	required
Section	2	Section à transclure Example Histoire	String	optional
Résumé	hat	Masquer le résumé Example 0	Boolean	optional
Ceci	this	Texte initial de la note générale Example Cette galerie est	String	optional
Lire la suite	more	Afficher un lien « Lire la suite... » à la fin Example 1	Boolean	optional
Gras	bold	Garder le texte en gras Example 1	Boolean	optional
Citer	quote	Encadrer l'extrait avec les balises <blockquote> Example 1	Boolean	optional
En ligne	inline	Encadrer l'extrait avec les balises <span> pour l'utiliser dans un autre texte Example 1	Boolean	optional
Références	references	Supprimer toutes les références Example 0	Boolean	optional
Sous-sections	subsections	Inclure des sous-sections de la section transcluse Example 1	Boolean	optional
Fragment	fragment	Nom du fragment à transclure Example Nom du fragment	Boolean	optional
Seul	only	Éléments à transclure Example tables	String	optional
Paragraphes	paragraphs	Paragraphes à transclure Example 1-3,5	String	optional
Fichiers	files	Fichiers à transclure Example A.jpg, B.png	String	optional
Tables	tables	Tables à transclure Example Stats2020	String	optional
Listes	lists	Listes à transclure Example 1-3,5	String	optional
Modèles	templates	Modèles à transclure Example Infobox	String	optional

Modifier les traductions des paramètres

Les éditeurs peuvent expérimenter dans le bac à sable (créer | mirroir) et dans la page de test (créer) de ce modèle.
Sous-pages de ce modèle.