Template:Excerpt/doc

模板页面

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

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

用法

基本用法

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