Export translations

Settings

Group

Language

Format

Export for off-line translation

Export in native format

Export in CSV format

<noinclude>
<languages />
</noinclude><includeonly>{{#invoke:Excerpt|main}}</includeonly><noinclude>
{{Documentation|content=

{{Lua|Module:Excerpt}}
<span lang="en" dir="ltr" class="mw-content-ltr">This template is used for reusing parts of pages in other pages.</span>
<span lang="en" dir="ltr" class="mw-content-ltr">This practice has several advantages:</span>

<div lang="en" dir="ltr" class="mw-content-ltr">
* '''Reduces maintenance''' by avoiding duplicate content that must be updated multiple times
</div>
<div lang="en" dir="ltr" class="mw-content-ltr">
* '''Improves content quality''' by encouraging editors to merge related content, rather than having multiple versions in various stages of development
</div>
<div lang="en" dir="ltr" class="mw-content-ltr">
* '''Fosters collaboration''' by channeling contributors into one place, rather than working in parallel
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
This template extends the capabilities of the built-in [[Special:MyLanguage/Transclusion|normal transclusion]].
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
== Usage ==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Basic usage ===
</div>
* <code><nowiki>{{Excerpt|Page title}}</nowiki></code> — <span lang="en" dir="ltr" class="mw-content-ltr">Transclude the lead section ([[#Lead section|example]])</span>
* <code><nowiki>{{Excerpt|Page title|Section title}}</nowiki></code> — <span lang="en" dir="ltr" class="mw-content-ltr">Transclude a specific section, excluding any subsections ([[#Specific section|example]])</span>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Parameters ===
</div>
* <code>1</code> — <span lang="en" dir="ltr" class="mw-content-ltr">Title of the page to transclude.</span> <span lang="en" dir="ltr" class="mw-content-ltr">'''Only required parameter.'''</span> <span lang="en" dir="ltr" class="mw-content-ltr">By default the lead section will be transcluded ([[#Lead section|example]]).</span>
* <code>2</code> — <span lang="en" dir="ltr" class="mw-content-ltr">Title of the section to transclude ([[#Specific section|example]]) or name of the {{ll|Extension:Labeled Section Transclusion#How it works|{{tag|section|open}}}} tag to transclude.</span> <span lang="en" dir="ltr" class="mw-content-ltr">Notice that this template provides other ways of targeting specific elements of a page without having to resort to section tags.</span>
* <code>only</code> — <span lang="en" dir="ltr" class="mw-content-ltr">Elements to transclude ([[#Files only|example]]).</span> <span lang="en" dir="ltr" class="mw-content-ltr">By default all elements are transcluded.</span>
** <code>only=file</code> <span lang="en" dir="ltr" class="mw-content-ltr">or</span> <code>only=files</code> — <span lang="en" dir="ltr" class="mw-content-ltr">Transclude only files</span>
** <code>only=list</code> <span lang="en" dir="ltr" class="mw-content-ltr">or</span> <code>only=lists</code> — <span lang="en" dir="ltr" class="mw-content-ltr">Transclude only lists</span>
** <code>only=table</code> <span lang="en" dir="ltr" class="mw-content-ltr">or</span> <code>only=tables</code> — <span lang="en" dir="ltr" class="mw-content-ltr">Transclude only tables</span>
** <code>only=template</code> <span lang="en" dir="ltr" class="mw-content-ltr">or</span> <code>only=templates</code> — <span lang="en" dir="ltr" class="mw-content-ltr">Transclude only templates</span>
** <code>only=paragraph</code> <span lang="en" dir="ltr" class="mw-content-ltr">or</span> <code>only=paragraphs</code> — <span lang="en" dir="ltr" class="mw-content-ltr">Transclude only paragraphs</span>
* <code>paragraphs</code> — <span lang="en" dir="ltr" class="mw-content-ltr">Paragraphs to transclude.</span> <span lang="en" dir="ltr" class="mw-content-ltr">By default all paragraphs are transcluded.</span>
** <code>paragraphs=0</code> — <span lang="en" dir="ltr" class="mw-content-ltr">Transclude no paragraphs</span>
** <code>paragraphs=1</code> — <span lang="en" dir="ltr" class="mw-content-ltr">Transclude the first paragraph</span>
** <code>paragraphs=2</code> — <span lang="en" dir="ltr" class="mw-content-ltr">Transclude the second paragraph</span>
** <code>paragraphs=1,3</code> — <span lang="en" dir="ltr" class="mw-content-ltr">Transclude the first and third paragraphs</span>
** <code>paragraphs=1-3</code> — <span lang="en" dir="ltr" class="mw-content-ltr">Transclude the first, second and third paragraphs</span>
** <code>paragraphs=1-3,5</code> — <span lang="en" dir="ltr" class="mw-content-ltr">Transclude the first, second, third and fifth paragraphs</span>
** <code>paragraphs=-1</code> — <span lang="en" dir="ltr" class="mw-content-ltr">Transclude all paragraphs except the first</span>
** <code>paragraphs=-2</code> — <span lang="en" dir="ltr" class="mw-content-ltr">Transclude all paragraphs except the second</span>
** <code>paragraphs=-1,3</code> — <span lang="en" dir="ltr" class="mw-content-ltr">Transclude all paragraphs except the first and third</span>
** <code>paragraphs=-1-3</code> — <span lang="en" dir="ltr" class="mw-content-ltr">Transclude all paragraphs except the first, second and third</span>
** <code>paragraphs=-1-3,5</code> — <span lang="en" dir="ltr" class="mw-content-ltr">Transclude all paragraphs except the first, second, third and fifth</span>
* <code>lists</code> — <span lang="en" dir="ltr" class="mw-content-ltr">Lists to transclude.</span> <span lang="en" dir="ltr" class="mw-content-ltr">By default all lists are transcluded.</span> <span lang="en" dir="ltr" class="mw-content-ltr">Same syntax as when transcluding paragraphs.</span>
* <code>files</code> — <span lang="en" dir="ltr" class="mw-content-ltr">Files to transclude.</span> <span lang="en" dir="ltr" class="mw-content-ltr">By default all files are transcluded.</span> <span lang="en" dir="ltr" class="mw-content-ltr">Same syntax as when transcluding paragraphs, but also:</span>
** <code>files=A.jpg</code> — <span lang="en" dir="ltr" class="mw-content-ltr">Transclude the file named 'A.jpg'</span>
** <code>files=A.jpg, B.png, C.gif</code> — <span lang="en" dir="ltr" class="mw-content-ltr">Transclude the files named 'A.jpg', 'B.png' and 'C.gif'</span>
** <code>files=.+%.png</code> — <span lang="en" dir="ltr" class="mw-content-ltr">Transclude all PNG files</span>
** <code>files=-A.jpg</code> — <span lang="en" dir="ltr" class="mw-content-ltr">Transclude all files except the one named 'A.jpg'</span>
** <code>files=-A.jpg, B.png, C.gif</code> — <span lang="en" dir="ltr" class="mw-content-ltr">Transclude all files except the ones named 'A.jpg', 'B.png' and 'C.gif'</span>
** <code>files=-.+%.png</code> — <span lang="en" dir="ltr" class="mw-content-ltr">Transclude all non-PNG files</span>
* <code>tables</code> — <span lang="en" dir="ltr" class="mw-content-ltr">Tables to transclude.</span> <span lang="en" dir="ltr" class="mw-content-ltr">By default all tables are transcluded.</span> <span lang="en" dir="ltr" class="mw-content-ltr">Same syntax as when transcluding paragraphs, but also:</span>
** <code>tables=Stats2020</code> — <span lang="en" dir="ltr" class="mw-content-ltr">Transclude the table with id 'Stats2020'</span>
** <code>tables=Stats2020, Stats2019, Stats2018</code> — <span lang="en" dir="ltr" class="mw-content-ltr">Transclude the tables with ids 'Stats2020', 'Stats2019' and 'Stats2018'</span>
** <code>tables=-Stats2020</code> — <span lang="en" dir="ltr" class="mw-content-ltr">Transclude all tables except the one with id 'Stats2020'</span>
** <code>tables=-Stats2020, Stats2019, Stats2018</code> — <span lang="en" dir="ltr" class="mw-content-ltr">Transclude all tables except the ones with ids 'Stats2020', 'Stats2019' and 'Stats2018'</span>
* <code>templates</code> — <span lang="en" dir="ltr" class="mw-content-ltr">Templates to transclude.</span> <span lang="en" dir="ltr" class="mw-content-ltr">By default all templates are transcluded.</span> <span lang="en" dir="ltr" class="mw-content-ltr">Same syntax as when transcluding paragraphs, but also:</span>
** <code>templates=Infobox</code> — <span lang="en" dir="ltr" class="mw-content-ltr">Transclude the template 'Infobox'</span>
** <code>templates=Infobox, Navbox, Chart</code> — <span lang="en" dir="ltr" class="mw-content-ltr">Transclude the template 'Infobox', 'Navbox' and 'Chart'</span>
** <code>templates=-Infobox</code> — <span lang="en" dir="ltr" class="mw-content-ltr">Transclude all templates except 'Infobox'</span>
** <code>templates=-Infobox, Navbox, Chart</code> — <span lang="en" dir="ltr" class="mw-content-ltr">Transclude all templates except 'Infobox', 'Navbox' and 'Chart'</span>
* <code>this</code> — <span lang="en" dir="ltr" class="mw-content-ltr">Change the initial text of the hatnote. For example, if the transcluded content is a gallery, you can set <code>this=This gallery is</code> so that the hatnote reads "This gallery is an excerpt from..."</span>
* <code>displaytitle</code> — <span lang="en" dir="ltr" class="mw-content-ltr">Change the text of the link in the hatnote. For example to add italics, subscripts, etc.</span>
* <code>hat=no</code> — <span lang="en" dir="ltr" class="mw-content-ltr">Hide the hatnote "This section is an excerpt from..."</span>
* <code>more=yes</code> — <span lang="en" dir="ltr" class="mw-content-ltr">Show a "Read more..." link at the end</span>
* <code>bold=yes</code> — <span lang="en" dir="ltr" class="mw-content-ltr">Keep bold text.</span>
* <code>quote=yes</code> — <span lang="en" dir="ltr" class="mw-content-ltr">Wrap the excerpt with {{tag|blockquote|open}} tags.</span>
* <code>inline=yes</code> — <span lang="en" dir="ltr" class="mw-content-ltr">Remove the hatnote and {{tag|div|open}} tags around the excerpt, to use it inside other text.</span>
* <code>references=no</code> — <span lang="en" dir="ltr" class="mw-content-ltr">Remove all references.</span>
* <code>subsections=yes</code> — <span lang="en" dir="ltr" class="mw-content-ltr">Include subsections of the transcluded section. Notice that if the transclusion is done from a section level 3, and the transcluded subsections are level 3 too, then the transcluded subsections will show with the same hierarchy as the transcluding section, which is probably not desirable, so use with caution.</span>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Replacing a section with an excerpt ===
</div>
[[File:How to excerpt.webm|thumb|<span lang="en" dir="ltr" class="mw-content-ltr">How to replace a section with an excerpt.</span>]]

<span lang="en" dir="ltr" class="mw-content-ltr">A section is often a summary of a more precise page dealing with a subtopic.</span>
<span lang="en" dir="ltr" class="mw-content-ltr">Sometimes it's convenient to replace the content of such a section with an excerpt of the page about the subtopic, after merging the original content of the section (if any) into the page about the subtopic.</span>
<span lang="en" dir="ltr" class="mw-content-ltr">This improves both the page about the subtopic and the section, reduces maintenance, drives contributors to collaborate, etc.</span>

<span lang="en" dir="ltr" class="mw-content-ltr">An efficient way to proceed is:</span>

# <span lang="en" dir="ltr" class="mw-content-ltr">Open the section for editing in one tab, and the page about the subtopic in another.</span>
# <span lang="en" dir="ltr" class="mw-content-ltr">Copy the text of the section and append it to the lead of the page about the subtopic.</span>
# <span lang="en" dir="ltr" class="mw-content-ltr">Consolidate and adjust the combined lead using common sense.</span>
# <span lang="en" dir="ltr" class="mw-content-ltr">Save the changes in the child article with an edit summary like: Copied content from <nowiki>[[Page]]</nowiki>; see that article's history for attribution.</span>
# <span lang="en" dir="ltr" class="mw-content-ltr">Back in the section, delete all content and replace it with an excerpt of the page about the subtopic.</span>
# <span lang="en" dir="ltr" class="mw-content-ltr">Save the changes in the section with an edit summary like: Move content to <nowiki>[[page about the subtopic]]</nowiki> and leave an excerpt.</span>

<div lang="en" dir="ltr" class="mw-content-ltr">
== Excerpt trees ==
</div>
[[File:Excerpt tree.png|thumb|<span lang="en" dir="ltr" class="mw-content-ltr">Visual representation of an imaginary excerpt tree.</span>]]

<div lang="en" dir="ltr" class="mw-content-ltr">
When a very general article uses excerpts from more specific articles, which in turn use excerpts from even more specific articles, then a [[w:Tree structure|tree structure]] emerges, called an "Excerpt tree".
</div>

<span lang="en" dir="ltr" class="mw-content-ltr">Below you can navigate the main excerpt trees on this wiki.</span>
<span lang="en" dir="ltr" class="mw-content-ltr">It's useful for editors interested in expanding or improving them.</span>

{{Excerpt tree|
* [[Architecture Repository]]
* [[Platform Engineering Team]]
}}

<div lang="en" dir="ltr" class="mw-content-ltr">
== Examples ==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Lead section ===
</div>
<pre>{{Excerpt|Lorem ipsum}}</pre>
{{Excerpt|Lorem ipsum}}
{{Reflist}}
{{Clear}}

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Specific section ===
</div>
<pre>{{Excerpt|Lorem ipsum|Section}}</pre>
{{Excerpt|Lorem ipsum|Section}}

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Files only ===
</div>
<pre>{{Excerpt|Lorem ipsum|only=files|hat=no}}</pre>
{{Excerpt|Lorem ipsum|only=files|hat=no}}
{{Clear}}

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Infobox only ===
</div>
<pre>{{Excerpt|Extension:CategoryLockdown|only=templates|templates=Extension|this=This infobox is}}</pre>
{{Excerpt|Extension:CategoryLockdown|only=templates|templates=Extension|this=This infobox is}}
{{Clear}}

<div lang="en" dir="ltr" class="mw-content-ltr">
=== No infobox ===
</div>
<pre>{{Excerpt|Extension:CategoryLockdown|templates=-Extension}}</pre>
{{Excerpt|Extension:CategoryLockdown|templates=-Extension}}

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Portal ===
</div>
<pre>{{Excerpt|Lorem ipsum|files=1|references=no|hat=no|more=yes}}</pre>
{{Excerpt|Lorem ipsum|files=1|references=no|hat=no|more=yes}}
{{Clear}}

<div lang="en" dir="ltr" class="mw-content-ltr">
== See also ==
</div>
* [[Module:Transcluder]] <sup>{{ll|Module:Transcluder/doc|[doc]}}</sup>
* [[Module:Excerpt]]
* [[Module:Excerpt/config]]
* [[c:Data:I18n/Module:Excerpt.tab]]

<div lang="en" dir="ltr" class="mw-content-ltr">
== Template data ==
</div>
{{#invoke:TNT|doc|Excerpt}}

}}
</noinclude>