Template:Transclude lead excerpt/doc
 | This is a documentation subpage for Template:Transclude lead excerpt. It contains usage information, categories and other content that is not part of the original template page. |
 | This template is used on approximately 3,300 pages, so changes to it will be widely noticed. Please test any changes in the template's /sandbox or /testcases subpages, or in your own user subpage. Please consider discussing changes on the talk page before implementing them. |
 | This template uses Lua: |
Transclude lead excerpt transcludes the lead of an article as an excerpt. It is designed for use in portals, stand-alone lists and outlines. It returns the text of the named article up to but excluding the first header, after removing:
- initial templates such as infoboxes, hatnotes and article improvement tags
- noinclude sections
- references and footnotes
- images, unless specifically retained
Usage[edit source]
{{Transclude lead excerpt | 1= | paragraphs= | files= | fileargs= | more= | errors= }}
The template requires one parameter: the name of the page to be transcluded. Include a namespace where necessary. There are no other positional parameters, but there are some optional named parameters:
- A list of paragraphs such as
paragraphs=1,3-5; the default is all paragraphs. - A list of file (image) numbers such as
files=1; the default is no images. Non-free images are removed. - Arguments to pass to File: such as
fileargs=leftto move images to the left; the default is none. - A link to the article itself such as
more=(more); the default is no link. Short cut:more=produces Read more... errors=to allow Lua error messages to appear in the output
paragraphs= and files= each accept a comma-separated list containing numbers and/or number ranges in the format min-max. Alternatively, files= can accept the name of a single image, e.g. files=My image file.jpg.
Page options[edit source]
Each page to be transcluded may be specified either plain or as a wikilink, possibly piped. Links to sections also work, and extract the named section rather than the lead. Examples: Article; Article#Section; [[Article]]; [[Article#Section|A section of an article]]. (Any piped text will be ignored.)
Any of the above formats may be followed by option(s) separated by pipes, e.g. Article|paragraphs=2. Such options override any global options for the given page only. Note that the characters | and = have special meaning within calls to templates but can be escaped using {{!}} and {{=}} respectively. Examples: Article#Section{{!}}files{{=}}2; [[Article|Some page]]{{!}}files{{=}}3,4{{!}}more{{=}}Click here. (= need not be escaped if the parameter is explicitly numbered, e.g. 1=Article{{!}}files=2).
Special characters such as pipes within page options must be doubly escaped, replacing their double braces by {{((}} and {{))}}. For example, to set display Custom image.jpg on the left with a custom caption, set fileargs to left|Custom caption using Article{{!}}files{{=}}Custom image.jpg{{!}}fileargs{{=}}left{{((}}!{{))}}Custom caption. To add a wikilink within a caption, escape the link brackets and any pipe twice using {{!((}}, {{))!}} and possibly {{!}}, e.g. Caption with {{((}}!(({{))}}Pipe (computer science){{((}}!{{))}}piped{{((}}))!{{))}} link.
See also[edit source]
Similar templates also using Module:Excerpt:
- {{Transclude linked excerpt}}: chooses the article randomly from those linked from a page
- {{Transclude list item excerpt}}: chooses the article randomly from those listed on a page
- {{Transclude random excerpt}}: chooses the article randomly from a list
- {{Transclude selected excerpt}}: chooses the article from a list using an index such as the week number
External links[edit source]
- Template:Transclude lead excerpt/doc at Wikipedia, the free Terran-based encyclopedia that anyone can edit.
