Template:Excerpt/doc:修订间差异
删除的内容 添加的内容
小无编辑摘要 |
小无编辑摘要 |
||
(未显示同一用户的1个中间版本) | |||
第18行: | 第18行: | ||
* <code>2</code> — 要嵌入的章节的标题或要嵌入的<section>标签的名称。请注意,此模板提供了其他方法来定位页面的特定元素,而无需求助于章节标签。 |
* <code>2</code> — 要嵌入的章节的标题或要嵌入的<section>标签的名称。请注意,此模板提供了其他方法来定位页面的特定元素,而无需求助于章节标签。 |
||
* <code>only</code> — 要嵌入的元素。 默认情况下,所有元素都被嵌入。 |
* <code>only</code> — 要嵌入的元素。 默认情况下,所有元素都被嵌入。 |
||
** <code>only=file</code> or <code>only=files</code> — |
** <code>only=file</code> or <code>only=files</code> — 仅包含文件 |
||
** <code>only=list</code> or <code>only=lists</code> — |
** <code>only=list</code> or <code>only=lists</code> — 仅包含列表 |
||
** <code>only=table</code> or <code>only=tables</code> — |
** <code>only=table</code> or <code>only=tables</code> — 仅包含表 |
||
** <code>only=template</code> or <code>only=templates</code> — |
** <code>only=template</code> or <code>only=templates</code> — 仅包含模板 |
||
** <code>only=paragraph</code> or <code>only=paragraphs</code> — |
** <code>only=paragraph</code> or <code>only=paragraphs</code> — 仅包含段落 |
||
* <code>paragraphs</code> — |
* <code>paragraphs</code> — 要嵌入的段落。默认情况下,所有段落都被嵌入。 |
||
** <code>paragraphs=0</code> — |
** <code>paragraphs=0</code> — 不包含任何段落 |
||
** <code>paragraphs=1</code> — |
** <code>paragraphs=1</code> — 包含第一段 |
||
** <code>paragraphs=2</code> — |
** <code>paragraphs=2</code> — 包含第二段 |
||
** <code>paragraphs=1,3</code> — |
** <code>paragraphs=1,3</code> — 包含第一段和第三段 |
||
** <code>paragraphs=1-3</code> — |
** <code>paragraphs=1-3</code> — 包含第一、二、三段 |
||
** <code>paragraphs=1-3,5</code> — |
** <code>paragraphs=1-3,5</code> — 包含第一、二、三、五段 |
||
** <code>paragraphs=-1</code> — |
** <code>paragraphs=-1</code> — 包含除第一段以外的所有段落 |
||
** <code>paragraphs=-2</code> — |
** <code>paragraphs=-2</code> — 包含除第二段以外的所有段落 |
||
** <code>paragraphs=-1,3</code> — |
** <code>paragraphs=-1,3</code> — 包含除第一和第三段之外的所有段落 |
||
** <code>paragraphs=-1-3</code> — |
** <code>paragraphs=-1-3</code> — 包含除第一、二、三段以外的所有段落 |
||
** <code>paragraphs=-1-3,5</code> — |
** <code>paragraphs=-1-3,5</code> — 包含除第一、二、三、五以外的所有段落 |
||
* <code>lists</code> — 要嵌入的列表。默认情况下,所有列表都被嵌入。与插入段落时的语法相同。 |
|||
* <code>lists</code> — Lists to transclude. By default all lists are transcluded. Same syntax as when transcluding paragraphs. |
|||
* <code>files</code> — 要嵌入的文件。默认情况下,所有文件都被嵌入。与嵌入段落时的语法相同: |
|||
* <code>files</code> — Files to transclude. By default all files are transcluded. Same syntax as when transcluding paragraphs, but also: |
|||
** <code>files=A.jpg</code> — |
** <code>files=A.jpg</code> — 包含名为“A.jpg”的文件 |
||
** <code>files=A.jpg, B.png, C.gif</code> — |
** <code>files=A.jpg, B.png, C.gif</code> — 包含名为“A.jpg”、“B.png”和“C.gif”的文件 |
||
** <code>files=.+%.png</code> — |
** <code>files=.+%.png</code> — 包含所有 PNG 文件 |
||
** <code>files=-A.jpg</code> — |
** <code>files=-A.jpg</code> — 包含除名为“A.jpg”的文件之外的所有文件 |
||
** <code>files=-A.jpg, B.png, C.gif</code> — |
** <code>files=-A.jpg, B.png, C.gif</code> — 包含除名为“A.jpg”、“B.png”和“C.gif”的文件之外的所有文件 |
||
** <code>files=-.+%.png</code> — |
** <code>files=-.+%.png</code> — 包含所有非 PNG 文件 |
||
* <code>tables</code> — 要嵌入的表格。默认情况下,所有表都被嵌入。与嵌入段落时的语法相同: |
|||
* <code>tables</code> — Tables to transclude. By default all tables are transcluded. Same syntax as when transcluding paragraphs, but also: |
|||
** <code>tables=Stats2020</code> — |
** <code>tables=Stats2020</code> — 包含 id 为“Stats2020”的表 |
||
** <code>tables=Stats2020, Stats2019, Stats2018</code> — |
** <code>tables=Stats2020, Stats2019, Stats2018</code> — 包含 ID 为“Stats2020”、“Stats2019”和“Stats2018”的表 |
||
** <code>tables=-Stats2020</code> — |
** <code>tables=-Stats2020</code> — 包含除 id 为“Stats2020”的表之外的所有表 |
||
** <code>tables=-Stats2020, Stats2019, Stats2018</code> — |
** <code>tables=-Stats2020, Stats2019, Stats2018</code> — 包含除 ID 为“Stats2020”、“Stats2019”和“Stats2018”的所有表 |
||
* <code>templates</code> — 要嵌入的模板。默认情况下,所有模板都被嵌入。与嵌入段落时的语法相同: |
|||
* <code>templates</code> — Templates to transclude. By default all templates are transcluded. Same syntax as when transcluding paragraphs, but also: |
|||
** <code>templates=Infobox</code> — |
** <code>templates=Infobox</code> — 嵌入模板“信息框” |
||
** <code>templates=Infobox, Navbox, Chart</code> — |
** <code>templates=Infobox, Navbox, Chart</code> — 嵌入模板“信息框”、“导航框”和“图表” |
||
** <code>templates=-Infobox</code> — |
** <code>templates=-Infobox</code> — 包含除“信息框”以外的所有模板 |
||
** <code>templates=-Infobox, Navbox, Chart</code> — |
** <code>templates=-Infobox, Navbox, Chart</code> — 包含除“Infobox”、“Navbox”和“Chart”之外的所有模板 |
||
* <code>this</code> — 更改注释的初始文本。例如,如果嵌入的内容是一个画廊,您可以设置this=This gallery is,使注释为“此画廊是...的摘录” |
|||
* <code>this</code> — 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..." |
|||
* <code>hat=no</code> — |
* <code>hat=no</code> — 隐藏注释“本节摘自……” |
||
* <code>more=yes</code> — |
* <code>more=yes</code> — 在末尾显示“阅读更多...”链接 |
||
* <code>bold=yes</code> — |
* <code>bold=yes</code> — 保留粗体文本。 |
||
* <code>quote=yes</code> — |
* <code>quote=yes</code> — 用<blockquote>标签包裹摘录。 |
||
* <code>inline=yes</code> — |
* <code>inline=yes</code> — 用<span>标签包裹摘录,以便在其他文本中使用它。 |
||
* <code>references=no</code> — |
* <code>references=no</code> — 删除所有引用。 |
||
* <code>subsections=yes</code> — 包括嵌入部分的子部分。请注意,如果嵌入是从第 3 级的部分完成的,并且被嵌入的子部分也是第 3 级,那么被嵌入的子部分将显示与嵌入部分相同的层次结构,这可能是不可取的,因此请谨慎使用。 |
|||
* <code>subsections=yes</code> — 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. |
|||
===替换摘录部分 === |
|||
=== Replacing sections for excerpts === |
|||
章节通常是更精确子页面的摘要。 |
|||
[[File:How to excerpt.webm|thumb| How to replace a section for an excerpt.]] |
|||
有时,在将章节的原始内容(如果有的话)合并到子页面之后,可以方便地将这些章节的内容替换为子页面的摘录。这改进了子页面和章节,减少了维护,促使贡献者协作,等等。 |
|||
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: |
|||
# 在一个选项卡中打开章节,在另一个选项卡中打开子页面。 |
|||
# Open the section in one tab and the subpage in another. |
|||
# 编辑两者。 |
|||
# 复制该章节的文本并将其粘贴到子页面的前导部分下方。 |
|||
# Edit both. |
|||
# 删除重复的内容并使用常识进行调整。 |
|||
# 使用编辑摘要保存子页面中的更改 |
|||
# Copy the text of the section and paste it below the lead section of the subpage. |
|||
# 返回该章节,删除所有内容并将其替换为子页面的摘录。 |
|||
# 使用编辑摘要保存章节中的更改 |
|||
# Delete repeated content and adjust using common sense. |
|||
⚫ | |||
=== 序言章节 === |
|||
# Save the changes in the subpage with an edit summary like: Bring content from <tvar name=1><nowiki>[[Page]]</nowiki></tvar>. |
|||
<pre>{{Excerpt|金匮要略|hat=no}}</pre> |
|||
{{Excerpt|金匮要略|hat=no}} |
|||
{{Reflist}} |
|||
# Back to the section, delete all content and replace it for an excerpt of the subpage. |
|||
{{Clear}} |
|||
# Save the changes in the section with an edit summary like: Move content to <tvar name=1><nowiki>[[Subpage]]</nowiki></tvar> and leave an excerpt. |
|||
⚫ | |||
== See also == |
|||
* [[Module:Transcluder]] |
|||
* [[Module:Excerpt]] |
|||
* [[Module:Excerpt/config]] |
2022年8月19日 (五) 10:58的最新版本
此模板使用Lua语言: |
此模板用于在其他页面中重用部分页面。这种做法有几个优点:
- 通过避免必须多次更新的重复内容来减少维护
- 通过鼓励编辑合并相关内容而不是在不同的开发阶段拥有多个版本来提高内容质量
- 通过将贡献者引导到一个地方而不是并行工作来促进协作
用法
基本用法
{{Excerpt|Page title}}
— 嵌入前导部分{{Excerpt|Page title|Section title}}
— 包含特定部分,不包括任何小节
参数
1
— 要嵌入的页面的标题。这是唯一必需的参数。默认情况下,前导部分将被嵌入2
— 要嵌入的章节的标题或要嵌入的<section>标签的名称。请注意,此模板提供了其他方法来定位页面的特定元素,而无需求助于章节标签。only
— 要嵌入的元素。 默认情况下,所有元素都被嵌入。only=file
oronly=files
— 仅包含文件only=list
oronly=lists
— 仅包含列表only=table
oronly=tables
— 仅包含表only=template
oronly=templates
— 仅包含模板only=paragraph
oronly=paragraphs
— 仅包含段落
paragraphs
— 要嵌入的段落。默认情况下,所有段落都被嵌入。paragraphs=0
— 不包含任何段落paragraphs=1
— 包含第一段paragraphs=2
— 包含第二段paragraphs=1,3
— 包含第一段和第三段paragraphs=1-3
— 包含第一、二、三段paragraphs=1-3,5
— 包含第一、二、三、五段paragraphs=-1
— 包含除第一段以外的所有段落paragraphs=-2
— 包含除第二段以外的所有段落paragraphs=-1,3
— 包含除第一和第三段之外的所有段落paragraphs=-1-3
— 包含除第一、二、三段以外的所有段落paragraphs=-1-3,5
— 包含除第一、二、三、五以外的所有段落
lists
— 要嵌入的列表。默认情况下,所有列表都被嵌入。与插入段落时的语法相同。files
— 要嵌入的文件。默认情况下,所有文件都被嵌入。与嵌入段落时的语法相同:files=A.jpg
— 包含名为“A.jpg”的文件files=A.jpg, B.png, C.gif
— 包含名为“A.jpg”、“B.png”和“C.gif”的文件files=.+%.png
— 包含所有 PNG 文件files=-A.jpg
— 包含除名为“A.jpg”的文件之外的所有文件files=-A.jpg, B.png, C.gif
— 包含除名为“A.jpg”、“B.png”和“C.gif”的文件之外的所有文件files=-.+%.png
— 包含所有非 PNG 文件
tables
— 要嵌入的表格。默认情况下,所有表都被嵌入。与嵌入段落时的语法相同:tables=Stats2020
— 包含 id 为“Stats2020”的表tables=Stats2020, Stats2019, Stats2018
— 包含 ID 为“Stats2020”、“Stats2019”和“Stats2018”的表tables=-Stats2020
— 包含除 id 为“Stats2020”的表之外的所有表tables=-Stats2020, Stats2019, Stats2018
— 包含除 ID 为“Stats2020”、“Stats2019”和“Stats2018”的所有表
templates
— 要嵌入的模板。默认情况下,所有模板都被嵌入。与嵌入段落时的语法相同:templates=Infobox
— 嵌入模板“信息框”templates=Infobox, Navbox, Chart
— 嵌入模板“信息框”、“导航框”和“图表”templates=-Infobox
— 包含除“信息框”以外的所有模板templates=-Infobox, Navbox, Chart
— 包含除“Infobox”、“Navbox”和“Chart”之外的所有模板
this
— 更改注释的初始文本。例如,如果嵌入的内容是一个画廊,您可以设置this=This gallery is,使注释为“此画廊是...的摘录”hat=no
— 隐藏注释“本节摘自……”more=yes
— 在末尾显示“阅读更多...”链接bold=yes
— 保留粗体文本。quote=yes
— 用标签包裹摘录。
inline=yes
— 用标签包裹摘录,以便在其他文本中使用它。references=no
— 删除所有引用。subsections=yes
— 包括嵌入部分的子部分。请注意,如果嵌入是从第 3 级的部分完成的,并且被嵌入的子部分也是第 3 级,那么被嵌入的子部分将显示与嵌入部分相同的层次结构,这可能是不可取的,因此请谨慎使用。
替换摘录部分
章节通常是更精确子页面的摘要。
有时,在将章节的原始内容(如果有的话)合并到子页面之后,可以方便地将这些章节的内容替换为子页面的摘录。这改进了子页面和章节,减少了维护,促使贡献者协作,等等。
一个有效的方法是:
- 在一个选项卡中打开章节,在另一个选项卡中打开子页面。
- 编辑两者。
- 复制该章节的文本并将其粘贴到子页面的前导部分下方。
- 删除重复的内容并使用常识进行调整。
- 使用编辑摘要保存子页面中的更改
- 返回该章节,删除所有内容并将其替换为子页面的摘录。
- 使用编辑摘要保存章节中的更改
例子
序言章节
{{Excerpt|金匮要略|hat=no}}