Template:Excerpt/doc:修订间差异

勤求古训,博采众方
删除的内容 添加的内容
无编辑摘要
无编辑摘要
 
(未显示同一用户的2个中间版本)
第1行: 第1行:
{{Uses Lua|Module:Excerpt}}
{{Uses Lua|Module:Excerpt}}
此模板用于在其他页面中重用部分页面。这种做法有几个优点:
This template is used for reusing parts of pages in other pages.
This practice has several advantages:


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


== 用法 ==
* '''Improves content quality''' by encouraging editors to merge related content, rather than having multiple versions in various stages of development


=== 基本用法 ===
* '''Fosters collaboration''' by channeling contributors into one place, rather than working in parallel
* <code><nowiki>{{Excerpt|Page title}}</nowiki></code> — 嵌入前导部分
* <code><nowiki>{{Excerpt|Page title|Section title}}</nowiki></code> — 包含特定部分,不包括任何小节


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


== Usage ==
=== 参数 ===


* <code>1</code> — 要嵌入的页面的标题。'''这是唯一必需的参数'''。默认情况下,前导部分将被嵌入
=== Basic usage ===
* <code>2</code> — 要嵌入的章节的标题或要嵌入的‎<section>标签的名称。请注意,此模板提供了其他方法来定位页面的特定元素,而无需求助于章节标签。
* <code><nowiki>{{Excerpt|Page title}}</nowiki></code> — Transclude the lead section ([[<tvar name=1>#Lead section</tvar>|example]])
* <code>only</code> — 要嵌入的元素。 默认情况下,所有元素都被嵌入。
* <code><nowiki>{{Excerpt|Page title|Section title}}</nowiki></code> — Transclude a specific section, excluding any subsections ([[<tvar name=1>#Specific section</tvar>|example]])
** <code>only=file</code> or <code>only=files</code> — 仅包含文件
** <code>only=list</code> or <code>only=lists</code> — 仅包含列表
** <code>only=table</code> or <code>only=tables</code> — 仅包含表
** <code>only=template</code> or <code>only=templates</code> — 仅包含模板
** <code>only=paragraph</code> or <code>only=paragraphs</code> — 仅包含段落
* <code>paragraphs</code> — 要嵌入的段落。默认情况下,所有段落都被嵌入。
** <code>paragraphs=0</code> — 不包含任何段落
** <code>paragraphs=1</code> — 包含第一段
** <code>paragraphs=2</code> — 包含第二段
** <code>paragraphs=1,3</code> — 包含第一段和第三段
** <code>paragraphs=1-3</code> — 包含第一、二、三段
** <code>paragraphs=1-3,5</code> — 包含第一、二、三、五段
** <code>paragraphs=-1</code> — 包含除第一段以外的所有段落
** <code>paragraphs=-2</code> — 包含除第二段以外的所有段落
** <code>paragraphs=-1,3</code> — 包含除第一和第三段之外的所有段落
** <code>paragraphs=-1-3</code> — 包含除第一、二、三段以外的所有段落
** <code>paragraphs=-1-3,5</code> — 包含除第一、二、三、五以外的所有段落
* <code>lists</code> — 要嵌入的列表。默认情况下,所有列表都被嵌入。与插入段落时的语法相同。
* <code>files</code> — 要嵌入的文件。默认情况下,所有文件都被嵌入。与嵌入段落时的语法相同:
** <code>files=A.jpg</code> — 包含名为“A.jpg”的文件
** <code>files=A.jpg, B.png, C.gif</code> — 包含名为“A.jpg”、“B.png”和“C.gif”的文件
** <code>files=.+%.png</code> — 包含所有 PNG 文件
** <code>files=-A.jpg</code> — 包含除名为“A.jpg”的文件之外的所有文件
** <code>files=-A.jpg, B.png, C.gif</code> — 包含除名为“A.jpg”、“B.png”和“C.gif”的文件之外的所有文件
** <code>files=-.+%.png</code> — 包含所有非 PNG 文件
* <code>tables</code> — 要嵌入的表格。默认情况下,所有表都被嵌入。与嵌入段落时的语法相同:
** <code>tables=Stats2020</code> — 包含 id 为“Stats2020”的表
** <code>tables=Stats2020, Stats2019, Stats2018</code> — 包含 ID 为“Stats2020”、“Stats2019”和“Stats2018”的表
** <code>tables=-Stats2020</code> — 包含除 id 为“Stats2020”的表之外的所有表
** <code>tables=-Stats2020, Stats2019, Stats2018</code> — 包含除 ID 为“Stats2020”、“Stats2019”和“Stats2018”的所有表
* <code>templates</code> — 要嵌入的模板。默认情况下,所有模板都被嵌入。与嵌入段落时的语法相同:
** <code>templates=Infobox</code> — 嵌入模板“信息框”
** <code>templates=Infobox, Navbox, Chart</code> — 嵌入模板“信息框”、“导航框”和“图表”
** <code>templates=-Infobox</code> — 包含除“信息框”以外的所有模板
** <code>templates=-Infobox, Navbox, Chart</code> — 包含除“Infobox”、“Navbox”和“Chart”之外的所有模板
* <code>this</code> — 更改注释的初始文本。例如,如果嵌入的内容是一个画廊,您可以设置this=This gallery is,使注释为“此画廊是...的摘录”
* <code>hat=no</code> — 隐藏注释“本节摘自……”
* <code>more=yes</code> — 在末尾显示“阅读更多...”链接
* <code>bold=yes</code> — 保留粗体文本。
* <code>quote=yes</code> — 用‎<blockquote>标签包裹摘录。
* <code>inline=yes</code> — 用‎<span>标签包裹摘录,以便在其他文本中使用它。
* <code>references=no</code> — 删除所有引用。
* <code>subsections=yes</code> — 包括嵌入部分的子部分。请注意,如果嵌入是从第 3 级的部分完成的,并且被嵌入的子部分也是第 3 级,那么被嵌入的子部分将显示与嵌入部分相同的层次结构,这可能是不可取的,因此请谨慎使用。




=== Parameters ===
===替换摘录部分 ===


章节通常是更精确子页面的摘要。
* <code>1</code> — Title of the page to transclude. '''Only required parameter.''' By default the lead section will be transcluded ([[<tvar name=1>#Lead section</tvar>|example]]).
* <code>2</code> — 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. Notice that this template provides other ways of targeting specific elements of a page without having to resort to section tags.
* <code>only</code> — Elements to transclude ([[<tvar name=1>#Files only</tvar>|example]]). By default all elements are transcluded.
** <code>only=file</code> or <code>only=files</code> — Transclude only files
** <code>only=list</code> or <code>only=lists</code> — Transclude only lists
** <code>only=table</code> or <code>only=tables</code> — Transclude only tables
** <code>only=template</code> or <code>only=templates</code> — Transclude only templates
** <code>only=paragraph</code> or <code>only=paragraphs</code> — Transclude only paragraphs
* <code>paragraphs</code> — Paragraphs to transclude. By default all paragraphs are transcluded.
** <code>paragraphs=0</code> — Transclude no paragraphs
** <code>paragraphs=1</code> — Transclude the first paragraph
** <code>paragraphs=2</code> — Transclude the second paragraph
** <code>paragraphs=1,3</code> — Transclude the first and third paragraphs
** <code>paragraphs=1-3</code> — Transclude the first, second and third paragraphs
** <code>paragraphs=1-3,5</code> — Transclude the first, second, third and fifth paragraphs
** <code>paragraphs=-1</code> — Transclude all paragraphs except the first
** <code>paragraphs=-2</code> — Transclude all paragraphs except the second
** <code>paragraphs=-1,3</code> — Transclude all paragraphs except the first and third
** <code>paragraphs=-1-3</code> — Transclude all paragraphs except the first, second and third
** <code>paragraphs=-1-3,5</code> — Transclude all paragraphs except the first, second, third and fifth
* <code>lists</code> — Lists to transclude. By default all lists are transcluded. Same syntax as when transcluding paragraphs.
* <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, 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=.+%.png</code> — Transclude all PNG files
** <code>files=-A.jpg</code> — Transclude all files except the one named '<tvar name=1>A.jpg</tvar>'
** <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=-.+%.png</code> — Transclude all non-PNG files
* <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, 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</code> — Transclude all tables except the one with id '<tvar name=1>Stats2020</tvar>'
** <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>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, 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</code> — Transclude all templates except '<tvar name=1>Infobox</tvar>'
** <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>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>more=yes</code> — Show a "Read more..." link at the end
* <code>bold=yes</code> — Keep bold text.
* <code>quote=yes</code> — Wrap the excerpt with <tvar name=1>{{tag|blockquote|open}}</tvar> tags.
* <code>inline=yes</code> — Wrap the excerpt with <tvar name=1>{{tag|span|open}}</tvar> tags to use it inside other text.
* <code>references=no</code> — Remove all references.
* <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.
=== 序言章节 ===

<pre>{{Excerpt|金匮要略|hat=no}}</pre>

{{Excerpt|金匮要略|hat=no}}
# Delete repeated content and adjust using common sense.
{{Reflist}}

{{Clear}}

# Save the changes in the subpage with an edit summary like: Bring content from <tvar name=1><nowiki>[[Page]]</nowiki></tvar>.


# Back to the section, delete all content and replace it for an excerpt of the subpage.


# 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月19日 (五) 10:58的最新版本

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

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

用法

基本用法

  • {{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|金匮要略|hat=no}}

《金匮要略》三卷,分二十五篇。简称《金匮》。·张仲景撰著,·王叔和编次,·林亿等校订。《金匮要略》是《伤寒杂病论》的杂病部分。是我国现存最早的一部诊治杂病的专著[1]中医四大经典著作之一,中医“治疗杂病之第一书”。《金匮要略》传世各本存在多种书名,如《新编金匮方论》、《新编金匮要略方论》、《金匮要略方论》、《金匮玉函要略方论》、《金匮要略方》等,今通称《金匮要略》。其中吴迁本的书名《金匮要略方》比较符合历史记载,应当是北宋官刻原书名[2]

  1. 徐成贺.《金匮要略》的流传、版本及注家[J].国医论坛,1998(02):1-3.
  2. 付阳,张承坤,沈澍农,顾培杏.《金匮要略》北宋官刻原貌探究[J].中医学报,2021,36(03):671-675.DOI:10.16368/j.issn.1674-8999.2021.03.140.