Template:Excerpt/fr

{{Documentation|content=

{{Lua|Module:Excerpt}} 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

 * — Transclure la section d'introduction (exemple)
 * — Transclure une section spécifique, à l'exclusion de toute sous-section (exemple)

Paramètres

 * — Titre de la page à transclure. Seul paramètre obligatoire. Par défaut, la section principale sera transcluse (exemple).
 * — Titre de la section à transclure (exemple) ou nom de la balise à 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.
 * — Éléments à transclure (exemple). Par défaut, tous les éléments sont transclus.
 * ou  — Transclure uniquement les fichiers
 * ou  — Transclure uniquement les listes
 * ou  — Transclure uniquement les tableaux
 * ou  — Transclure uniquement les modèles
 * ou  — Transclure uniquement les paragraphes
 * — Paragraphes à transclure. Par défaut, tous les paragraphes sont transclus.
 * — Ne pas transclure les paragraphes
 * — Transclure le premier paragraphe
 * — Transclure le deuxième paragraphe
 * — Transclure les premier et troisième paragraphes
 * — Transclure les premier, deuxième et troisième paragraphes
 * — Transclure les premier, deuxième, troisième et cinquième paragraphes
 * — Transclure tous les paragraphes sauf le premier
 * — Transclure tous les paragraphes sauf le second
 * — Transclure tous les paragraphes sauf le premier et le troisième
 * — Transclure tous les paragraphes sauf le premier, le deuxième et le troisième
 * — Transclure tous les paragraphes sauf les premier, deuxième, troisième et cinquième
 * — Listes à transclure. Par défaut, toutes les listes sont transcluses. Même syntaxe que lors de la transclusion de paragraphes.
 * — Fichiers à transclure. Par défaut, tous les fichiers sont transclus. Même syntaxe que lors de la transclusion de paragraphes, mais aussi :
 * — Transclure le fichier « A.jpg »
 * — Transclure les fichiers « A.jpg », « B.png » et « C.gif »
 * — Transclure tous les fichiers PNG
 * — Transclure tous les fichiers sauf « A.jpg »
 * — Transclure tous les fichiers sauf « A.jpg », « B.png » et « C.gif »
 * — Transclure tous les fichiers non PNG
 * — Tables à transclure. Par défaut, toutes les tables sont transcluses. Même syntaxe que lors de la transclusion de paragraphes, mais aussi :
 * — Transclure la table ayant l'identifiant « Stats2020 »
 * — Transclure les tables ayant les identifiants « Stats2020 », « Stats2019 » et « Stats2018 »
 * — Transclure toutes les tables sauf celle ayant l'identifiant « Stats2020 »
 * — Transclure toutes les tables sauf celles ayant les identifiants « Stats2020 », « Stats2018 » et « Stats2018 »
 * — Modèles à transclure. Par défaut, tous les modèles sont transclus. Même syntaxe que lors de la transclusion de paragraphes, mais aussi :
 * — Transclure le modèle « Infobox »
 * — Transclure les modèles « Infobox », « Navbox » et « Chart »
 * — Transclure tous les modèles sauf « Infobox »
 * — Transclure tous les modèles sauf « Infobox », « Navbox » et « Chart »
 * — Modifier le texte initial de la note générale. Par exemple, si le contenu transclus est une galerie, vous pouvez définir  pour que la note générale soit « Cette galerie est un extrait de... »
 * — Masquer la note générale « Cette section est un extrait de... »
 * — Afficher un lien « Lire plus... » à la fin
 * — Garder le texte en gras.
 * — Encadrer l'extrait avec les balises.
 * — Supprimer la note générale et les balises autour de l'extrait pour l'utiliser dans un autre texte.
 * — Supprimer toutes les références.
 * — 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 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


Section spécifique


Fichiers seulement


Boîte d'information seulement


Portail


Voir aussi

 * Module:Transcluder
 * Module:Excerpt
 * Module:Excerpt/config
 * c:Data:I18n/Module:Excerpt.tab



Données du modèle
}}