Johanna: 1 revision imported

2025-10-10T14:20:39Z

1 revision imported

← Older revision	Revision as of 14:20, 10 October 2025
(No difference)

MediaWiki>Wladek92: T82 access to doc page

2025-03-11T12:08:38Z

T82 access to doc page

New page

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

{{Lua|Module:Excerpt}}
<translate> This template is used for reusing parts of pages in other pages.</translate>
<translate> This practice has several advantages:</translate>

<translate>

* '''Reduces maintenance''' by avoiding duplicate content that must be updated multiple times</translate>
<translate>

* '''Improves content quality''' by encouraging editors to merge related content, rather than having multiple versions in various stages of development</translate>
<translate>

* '''Fosters collaboration''' by channeling contributors into one place, rather than working in parallel


This template extends the capabilities of the built-in [[<tvar name=1>Special:MyLanguage/Transclusion</tvar>|normal transclusion]].

== Usage == 

=== Basic usage === 
</translate>
* <code><nowiki>{{Excerpt|Page title}}</nowiki></code> — <translate> Transclude the lead section ([[<tvar name=1>#Lead section</tvar>|example]])</translate>
* <code><nowiki>{{Excerpt|Page title|Section title}}</nowiki></code> — <translate> Transclude a specific section, excluding any subsections ([[<tvar name=1>#Specific section</tvar>|example]])</translate>

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

<translate>
=== Replacing a section with an excerpt === 
</translate>
[[File:How to excerpt.webm|thumb|<translate> How to replace a section with an excerpt.</translate>]]

<translate> A section is often a summary of a more precise page dealing with a subtopic.</translate>
<translate> 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.</translate>
<translate> This improves both the page about the subtopic and the section, reduces maintenance, drives contributors to collaborate, etc.</translate>

<translate> An efficient way to proceed is:</translate>

<translate>

# Open the section for editing in one tab, and the page about the subtopic in another.</translate>
<translate>

# Copy the text of the section and append it to the lead of the page about the subtopic.</translate>
<translate>

# Consolidate and adjust the combined lead using common sense.</translate>
<translate>

# Save the changes in the child article with an edit summary like: Copied content from <tvar name=1><nowiki>[[Page]]</nowiki></tvar>; see that article's history for attribution.</translate>
<translate>

# Back in the section, delete all content and replace it with an excerpt of the page about the subtopic.</translate>
<translate>

# Save the changes in the section with an edit summary like: Move content to <tvar name=1><nowiki>[[page about the subtopic]]</nowiki></tvar> and leave an excerpt.

== Excerpt trees == 
</translate>
[[File:Excerpt tree.png|thumb|<translate> Visual representation of an imaginary excerpt tree.</translate>]]

<translate>

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".
</translate>

<translate> Below you can navigate the main excerpt trees on this wiki.</translate>
<translate> It's useful for editors interested in expanding or improving them.</translate>

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

<translate>
== Examples == 

=== Lead section === 
</translate>
<pre>{{Excerpt|Lorem ipsum}}</pre>
{{Excerpt|Lorem ipsum}}
{{Reflist}}
{{Clear}}

<translate>
=== Specific section === 
</translate>
<pre>{{Excerpt|Lorem ipsum|Section}}</pre>
{{Excerpt|Lorem ipsum|Section}}

<translate>
=== Files only === 
</translate>
<pre>{{Excerpt|Lorem ipsum|only=files|hat=no}}</pre>
{{Excerpt|Lorem ipsum|only=files|hat=no}}
{{Clear}}

<translate>
=== Infobox only === 
</translate>
<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}}

<translate>
=== No infobox === 
</translate>
<pre>{{Excerpt|Extension:CategoryLockdown|templates=-Extension}}</pre>
{{Excerpt|Extension:CategoryLockdown|templates=-Extension}}

<translate>
=== Portal === 
</translate>
<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}}

<translate>
== See also == 
</translate>
* [[Module:Transcluder]] <sup>{{ll|Module:Transcluder/doc|[doc]}}</sup>
* [[Module:Excerpt]]
* [[Module:Excerpt/config]]
* [[c:Data:I18n/Module:Excerpt.tab]]

<translate>
== Template data == 
</translate>
{{#invoke:TNT|doc|Excerpt}}

}}
</noinclude>

Template:Excerpt - Revision history

Johanna: 1 revision imported

MediaWiki>Wladek92: T82 access to doc page