Template:Excerpt/doc:修订间差异

勤求古训,博采众方
删除的内容 添加的内容
无编辑摘要
无编辑摘要
第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> — Transclude only files
** <code>only=file</code> or <code>only=files</code> — 仅包含文件
** <code>only=list</code> or <code>only=lists</code> — Transclude only lists
** <code>only=list</code> or <code>only=lists</code> — 仅包含列表
** <code>only=table</code> or <code>only=tables</code> — Transclude only tables
** <code>only=table</code> or <code>only=tables</code> — 仅包含表
** <code>only=template</code> or <code>only=templates</code> — Transclude only templates
** <code>only=template</code> or <code>only=templates</code> — 仅包含模板
** <code>only=paragraph</code> or <code>only=paragraphs</code> — Transclude only paragraphs
** <code>only=paragraph</code> or <code>only=paragraphs</code> — 仅包含段落
* <code>paragraphs</code> — Paragraphs to transclude. By default all paragraphs are transcluded.
* <code>paragraphs</code> — 要嵌入的段落。默认情况下,所有段落都被嵌入。
** <code>paragraphs=0</code> — Transclude no paragraphs
** <code>paragraphs=0</code> — 不包含任何段落
** <code>paragraphs=1</code> — Transclude the first paragraph
** <code>paragraphs=1</code> — 包含第一段
** <code>paragraphs=2</code> — Transclude the second paragraph
** <code>paragraphs=2</code> — 包含第二段
** <code>paragraphs=1,3</code> — Transclude the first and third paragraphs
** <code>paragraphs=1,3</code> — 包含第一段和第三段
** <code>paragraphs=1-3</code> — Transclude the first, second and third paragraphs
** <code>paragraphs=1-3</code> — 包含第一、二、三段
** <code>paragraphs=1-3,5</code> — Transclude the first, second, third and fifth paragraphs
** <code>paragraphs=1-3,5</code> — 包含第一、二、三、五段
** <code>paragraphs=-1</code> — Transclude all paragraphs except the first
** <code>paragraphs=-1</code> — 包含除第一段以外的所有段落
** <code>paragraphs=-2</code> — Transclude all paragraphs except the second
** <code>paragraphs=-2</code> — 包含除第二段以外的所有段落
** <code>paragraphs=-1,3</code> — Transclude all paragraphs except the first and third
** <code>paragraphs=-1,3</code> — 包含除第一和第三段之外的所有段落
** <code>paragraphs=-1-3</code> — Transclude all paragraphs except the first, second and third
** <code>paragraphs=-1-3</code> — 包含除第一、二、三段以外的所有段落
** <code>paragraphs=-1-3,5</code> — Transclude all paragraphs except the first, second, third and fifth
** <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> — Transclude the file named '<tvar name=1>A.jpg</tvar>'
** <code>files=A.jpg</code> — 包含名为“A.jpg”的文件
** <code>files=A.jpg, B.png, C.gif</code> — Transclude the files named '<tvar name=1>A.jpg</tvar>', '<tvar name=2>B.png</tvar>' and '<tvar name=3>C.gif</tvar>'
** <code>files=A.jpg, B.png, C.gif</code> — 包含名为“A.jpg”、“B.png”和“C.gif”的文件
** <code>files=.+%.png</code> — Transclude all PNG files
** <code>files=.+%.png</code> — 包含所有 PNG 文件
** <code>files=-A.jpg</code> — Transclude all files except the one named '<tvar name=1>A.jpg</tvar>'
** <code>files=-A.jpg</code> — 包含除名为“A.jpg”的文件之外的所有文件
** <code>files=-A.jpg, B.png, C.gif</code> — 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>'
** <code>files=-A.jpg, B.png, C.gif</code> — 包含除名为“A.jpg”、“B.png”和“C.gif”的文件之外的所有文件
** <code>files=-.+%.png</code> — Transclude all non-PNG files
** <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> — Transclude the table with id '<tvar name=1>Stats2020</tvar>'
** <code>tables=Stats2020</code> — 包含 id 为“Stats2020”的表
** <code>tables=Stats2020, Stats2019, Stats2018</code> — Transclude the tables with ids '<tvar name=1>Stats2020</tvar>', '<tvar name=2>Stats2019</tvar>' and '<tvar name=3>Stats2018</tvar>'
** <code>tables=Stats2020, Stats2019, Stats2018</code> — 包含 ID 为“Stats2020”、“Stats2019”和“Stats2018”的表
** <code>tables=-Stats2020</code> — Transclude all tables except the one with id '<tvar name=1>Stats2020</tvar>'
** <code>tables=-Stats2020</code> — 包含除 id 为“Stats2020”的表之外的所有表
** <code>tables=-Stats2020, Stats2019, Stats2018</code> — Transclude all tables except the ones with ids '<tvar name=1>Stats2020</tvar>', '<tvar name=2>Stats2019</tvar>' and '<tvar name=3>Stats2018</tvar>'
** <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> — Transclude the template '<tvar name=1>Infobox</tvar>'
** <code>templates=Infobox</code> — 嵌入模板“信息框”
** <code>templates=Infobox, Navbox, Chart</code> — Transclude the template '<tvar name=1>Infobox</tvar>', '<tvar name=2>Navbox</tvar>' and '<tvar name=3>Chart</tvar>'
** <code>templates=Infobox, Navbox, Chart</code> — 嵌入模板“信息框”、“导航框”和“图表”
** <code>templates=-Infobox</code> — Transclude all templates except '<tvar name=1>Infobox</tvar>'
** <code>templates=-Infobox</code> — 包含除“信息框”以外的所有模板
** <code>templates=-Infobox, Navbox, Chart</code> — Transclude all templates except '<tvar name=1>Infobox</tvar>', '<tvar name=2>Navbox</tvar>' and '<tvar name=3>Chart</tvar>'
** <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> — Hide the hatnote "This section is an excerpt from..."
* <code>hat=no</code> — 隐藏注释“本节摘自……”
* <code>more=yes</code> — Show a "Read more..." link at the end
* <code>more=yes</code> — 在末尾显示“阅读更多...”链接
* <code>bold=yes</code> — Keep bold text.
* <code>bold=yes</code> — 保留粗体文本。
* <code>quote=yes</code> — Wrap the excerpt with <tvar name=1>{{tag|blockquote|open}}</tvar> tags.
* <code>quote=yes</code> — 用‎<blockquote>标签包裹摘录。
* <code>inline=yes</code> — Wrap the excerpt with <tvar name=1>{{tag|span|open}}</tvar> tags to use it inside other text.
* <code>inline=yes</code> — 用‎<span>标签包裹摘录,以便在其他文本中使用它。
* <code>references=no</code> — Remove all references.
* <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|金匮要略}}</pre>

{{Excerpt|金匮要略}}

{{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.

== Examples ==

== See also ==

* [[Module:Transcluder]]
* [[Module:Excerpt]]
* [[Module:Excerpt/config]]

2022年8月18日 (四) 14:40的版本

此模板用于在其他页面中重用部分页面。这种做法有几个优点:

  • 通过避免必须多次更新的重复内容来减少维护
  • 通过鼓励编辑合并相关内容而不是在不同的开发阶段拥有多个版本来提高内容质量
  • 通过将贡献者引导到一个地方而不是并行工作来促进协作

用法

基本用法

  • {{Excerpt|Page title}} — 嵌入前导部分
  • {{Excerpt|Page title|Section title}} — 包含特定部分,不包括任何小节


参数

  • 1 — 要嵌入的页面的标题。这是唯一必需的参数。默认情况下,前导部分将被嵌入
  • 2 — 要嵌入的章节的标题或要嵌入的‎<section>标签的名称。请注意,此模板提供了其他方法来定位页面的特定元素,而无需求助于章节标签。
  • only — 要嵌入的元素。 默认情况下,所有元素都被嵌入。
    • only=file or only=files — 仅包含文件
    • only=list or only=lists — 仅包含列表
    • only=table or only=tables — 仅包含表
    • only=template or only=templates — 仅包含模板
    • only=paragraph or only=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 级,那么被嵌入的子部分将显示与嵌入部分相同的层次结构,这可能是不可取的,因此请谨慎使用。


替换摘录部分

章节通常是更精确子页面的摘要。

有时,在将章节的原始内容(如果有的话)合并到子页面之后,可以方便地将这些章节的内容替换为子页面的摘录。这改进了子页面和章节,减少了维护,促使贡献者协作,等等。

一个有效的方法是:


  1. 在一个选项卡中打开章节,在另一个选项卡中打开子页面。
  1. 编辑两者。
  1. 复制该章节的文本并将其粘贴到子页面的前导部分下方。
  1. 删除重复的内容并使用常识进行调整。
  1. 使用编辑摘要保存子页面中的更改
  1. 返回该章节,删除所有内容并将其替换为子页面的摘录。
  1. 使用编辑摘要保存章节中的更改

例子

前导部分

{{Excerpt|金匮要略}}

Module:TNT第159行Lua错误:Missing JsonConfig extension; Cannot load https://commons.wikimedia.org/wiki/Data:I18n/Module:Excerpt.tab