模板:Excerpt/doc

勤求古訓,博采眾方
於 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