قالب:Transclude linked excerpt/sandbox
 | This is the template sandbox page for قالب:Transclude linked excerpt (diff). See also the companion subpage for test cases. |
Template documentation | Uses Lua: |
Transclude linked excerpt transcludes the lead of an article as an excerpt. It is designed for use in portals. It returns the text of an 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
{{Transclude linked excerpt | 1= | section= | sectiononly= | paragraphs= | files= | fileargs= | errors= }}
Parameters
The template accepts one page name as an unnamed parameter. Wikilinks are collected from that page, or a section of it. One wikilink is selected randomly, and its destination is transcluded. (If the selected page is invalid, the template will choose again.) Include a namespace where necessary. There are no other positional parameters, but there are some optional named parameters:
- A section name such as
section=Featured articles; the default is to collect wikilinks from all sections.- A flag
sectiononly=yesto exclude subsections.
- A flag
- 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. errors=to allow Lua error messages to appear in the outputshowall=to show all articles simultaneouslylist=to show a list of articles قالب:Warnsign
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.
showall= shows all articles simultaneously. This option is intended for a subpage aimed at editors as well as readers. Using this template on a subpage with <noinclude>|showall=</noinclude> and transcluding the subpage on a main page will show all excerpts on the subpage but only one on the main page, without repeating the template and its arguments.
Page options
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. This text can be achieved more simply using {{Doubly escaped wikilink}}, e.g. Caption with {{Doubly escaped wikilink|Pipe (computer science)|piped}} link.
See also
- {{Transclude lead excerpt}}: specifies the article explicitly
- {{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
The templates were discussed at Use of direct transclusion in portals and the newer portal transclusion templates.
- {{Excerpt}}: template designed for excerpt transclusion in articles
TemplateData
See the monthly error report for this template.
TemplateData for Transclude linked excerpt
Transclude linked excerpt transcludes the lead of a randomly chosen article as an excerpt
| وسيط | وصف | نوع | حالة | |
|---|---|---|---|---|
| 1 | 1 | The name of a page containing wikilinks to articles which may be transcluded
| نص | مطلوب |
| section | section | Limits wikilink collection to one section of the page
| نص | اختياري |
| sectiononly | sectiononly | Excludes subsections of the selected section
| بولياني | اختياري |
| Paragraphs | paragraphs | Numbers of the paragraphs to be transcluded, as a comma-separated list containing numbers and/or number ranges in the format min-max
| نص | اختياري |
| Files | files | Numbers of the images to be transcluded, as a comma-separated list containing numbers and/or number ranges in the format min-max
| نص | اختياري |
| FileArgs | fileargs | Arguments to pass to File:
| نص | اختياري |
| More | more | Text for trailing link to the entire article. Note: more= with no value produces the standard text: Read more...
| نص | اختياري |
| Errors | errors | Allow Lua error messages to appear in the output?
| بولياني | اختياري |
| ShowAll | showall | Show all excerpts simultaneously?
| نص | اختياري |
| List | list | Show a list of excerpts?
| نص | اختياري |
| The above documentation is transcluded from قالب:Transclude linked excerpt/doc. (edit | history) Editors can experiment in this template's sandbox (edit | diff) and testcases (edit) pages. Please add categories to the /doc subpage. Subpages of this template. |