Template:Excerpt

{{Documentation|content=

{{Lua|Module:Transcluder}}

This template is used for transcluding any part of any page into another page, with many options that normal transclusion doesn't provide.

Basic usage

 * — Transclude the lead section
 * — Transclude a specific section

Parameters

 * — Title of the page to transclude. Only required parameter.  If no other parameters are used, the lead section will be transcluded (1>#Lead section|example).
 * — Title of the section or name of the   tag to transclude (2>#Section without subsections|example).
 * — Transclude only the requested elements (1>#Files only|example).
 * — Transclude only the files
 * — Transclude only the lists
 * — Transclude only the tables
 * — Transclude only the sections
 * — Transclude only the templates
 * — Transclude only the parameters
 * — Transclude only the paragraphs
 * — Transclude only the categories
 * — Transclude only the references
 * — Cherry-pick the paragraphs to transclude. By default all paragraphs are transcluded.  Notice that if the paragraph order changes in the source page, the transcluded paragraphs will change too and without any notice.
 * — Transclude no paragraphs
 * — Transclude the first paragraph
 * — Transclude the second paragraph
 * — Transclude the first and third paragraphs
 * — Transclude the first, second and third paragraphs
 * — Transclude the first, second, third and fifth paragraphs
 * — Transclude all paragraphs except the first
 * — Transclude all paragraphs except the second
 * — Transclude all paragraphs except the first and third
 * — Transclude all paragraphs except the first, second and third
 * — Transclude all paragraphs except the first, second, third and fifth
 * — Cherry-pick the files to transclude. By default all files are transcluded.  The exact same syntax and considerations as when transcluding paragraphs apply, but additionally:
 * — Transclude the file named 'A.jpg'
 * — Transclude the files named 'A.jpg', 'B.png' and 'C.gif'
 * — Transclude all PNG files
 * — Transclude all files except the one named 'A.jpg'
 * — Transclude all files except the ones named 'A.jpg</>', '<tvar|2>B.png</>' and '<tvar|3>C.gif</>'
 * — Transclude all non-PNG files
 * — Cherry-pick the tables to transclude. By default all tables are transcluded.  The exact same syntax and considerations as when transcluding paragraphs apply, but additionally:
 * — Transclude the table with id '<tvar|1>Stats2020</>'
 * — Transclude the tables with ids '<tvar|1>Stats2020</>', '<tvar|2>Stats2019</>' and '<tvar|3>Stats2018</>'
 * — Transclude all tables except the one with id '<tvar|1>Stats2020</>'
 * — Transclude all tables except the ones with ids '<tvar|1>Stats2020</>', '<tvar|2>Stats2019</>' and '<tvar|3>Stats2018</>'
 * — Cherry-pick the sections to transclude. By default all sections are transcluded.  The exact same syntax and considerations as when transcluding paragraphs apply, but additionally:
 * — Transclude the section titled '<tvar|1>History</>'
 * — Transclude the sections titled '<tvar|1>History</>', '<tvar|2>Causes</>' and '<tvar|3>Effects</>'
 * — Transclude all sections except the one titled '<tvar|1>History</>'
 * — Transclude all sections except the ones titled '<tvar|1>History</>', '<tvar|2>Causes</>' and '<tvar|3>Effects</>'
 * — Cherry-pick the references to transclude. By default all references are transcluded.  The exact same syntax and considerations as when transcluding paragraphs apply, but additionally:
 * — Transclude the reference with name '<tvar|1>Darwin1859</>'
 * — Transclude the references with names '<tvar|1>Darwin1859</>', '<tvar|2>Darwin1871</>' and '<tvar|3>Darwin1839</>'
 * — Transclude all references except the one with name '<tvar|1>Darwin1859</>'
 * — Transclude all references except the ones with names '<tvar|1>Darwin1859</>', '<tvar|2>Darwin1871</>' and '<tvar|3>Darwin1839</>'

Replacing sections for excerpts


Sections are often summaries of more precise subpages.

Sometimes it's convenient to replace the content of such sections for excerpts of the subpages, after merging the original content of the section (if any) into the subpage.

This improves both the subpage and the section, reduces maintenance, drives contributors to collaborate, etc.

An efficient way to proceed is:


 * 1) Open the section in one tab and the subpage in another.


 * 1) Edit both.


 * 1) Copy the text of the section and paste it below the lead section of the subpage.


 * 1) Delete repeated content and adjust using common sense.


 * 1) Save the changes in the subpage with an edit summary like: Bring content from <tvar|1> Page </>.


 * 1) Back to the section, delete all content and replace it for an excerpt of the subpage.


 * 1) Save the changes in the section with an edit summary like: Move content to <tvar|1> Subpage </> and leave an excerpt.

Template data
}}