跳至內容

模板:Citation Style documentation/doc

本頁使用了標題或全文手工轉換
維基百科,自由的百科全書

使用方法

[編輯]

本模板用於為引文格式1系列模板構建格式統一的文檔頁面。

例如:{{Citation Style documentation|author}}將顯示作者參數的文檔說明。

若某部分文檔內容不適用於特定模板,可直接手動添加文本或建立新的子模板。

各模組文本均為子模板,可通過對應連結進行編輯。

章節使用規範

[編輯]

建立模板文件時,請按以下順序組織章節內容:

  • 引言:簡要說明模板用途
  • 使用方法:供複製的空白參數範例
  • 範例:各類使用場景範例
  • 參數說明:各參數的詳細描述
    • 語法:模板語法概述
    • 已棄用參數:列出不再支持的參數
    • 參數描述:按功能分組描述參數,建議順序如下:
      • 作者
      • 標題
      • 日期
      • 出版者
      • 版本、叢書、卷號
      • 文獻內定位
      • 網址
      • 錨點
      • 標識符
      • 引文
      • 編者
      • 顯示選項

引言章節

[編輯]

使用{{csdoc|lead|内容}}建立標準化的引言內容:

[編輯子模板]

本引文格式1模板用於為建立引文。

本字段的選項: 匿名參數1用於生成結尾文本。
原始碼 效果
{{csdoc|lead|书籍}}

本引文格式1模板用於為書籍建立引文。

Lua提示

[編輯]

[編輯子模板]

使用方法章節

[編輯]

使用方法部分以{{csdoc|usage}}開頭:

複製以下其中一個空白版本來使用。幾乎所有參數名稱僅支持小寫形式(部分縮寫如|isbn=有對應的大寫別名如|ISBN=,則這些大寫形式也可使用)。參數之間使用「|」(管道)字元分隔。未使用的參數可以刪除,以避免原始碼雜亂。本文檔中的部分範例可能包含當前日期;若日期顯示不準確,請刷新頁面。

可供複製的參數包含在子模板建立的表格中。

橫式排列的全部參數

[編輯]
  • 以{{csdoc|usage full}}開頭
  • 將範例包裹在<syntaxhighlight lang="wikitext" copy="1">...</syntaxhighlight>標籤中
  • 以{{end}}結束
{{csdoc|usage full}}
<syntaxhighlight lang="wikitext" copy="1">{{cite web |last1= |first1= |author-link1= |last2= |first2= |author-link2= |display-authors= |author-mask1= |author-mask2= |collaboration= |df= |date= |year= |orig-date= |orig-year= |location= |editor-last1= |editor-first1= |editor-link1= |editor-last2= |editor-first2= |editor-link2= |display-editors= |editor-mask1= |editor-mask2= |title= |script-title= |title-link= |url= |url-access= |trans-title= |format= |department= |website= |script-website= |trans-website= |type= |series= |language= |interviewer-last1= |interviewer-first1= |interviewer-link1= |interviewer-last2= |interviewer-first2= |interviewer-link2= |display-interviewers= |interviewer-mask1= |interviewer-mask2= |translator-last1= |translator-first1= |translator-link1= |translator-last2= |translator-first2= |translator-link2= |display-translators= |translator-mask1= |translator-mask2= |others= |name-list-style= |edition= |publication-place= |publisher= |publication-date= |agency= |minutes= |time-caption= |time= |page= |pages= |at= |no-pp= |arxiv= |asin= |asin-tld= |bibcode= |bibcode-access= |biorxiv= |citeseerx= |doi= |doi-access= |doi-broken-date= |eissn= |hdl= |hdl-access= |isbn= |ismn= |issn= |jfm= |jstor= |jstor-access= |lccn= |medrxiv= |mr= |oclc= |ol= |ol-access= |osti= |osti-access= |pmc= |pmc-embargo-date= |pmid= |rfc= |sbn= |ssrn= |s2cid= |s2cid-access= |zbl= |id= |url-status= |archive-url= |archive-format= |archive-date= |access-date= |via= |quote-page= |quote-pages= |quote= |script-quote= |trans-quote= |mode= |ref= |postscript=}}</syntaxhighlight>
{{end}}
橫式排列的全部參數
{{cite web |last1= |first1= |author-link1= |last2= |first2= |author-link2= |display-authors= |author-mask1= |author-mask2= |collaboration= |df= |date= |year= |orig-date= |orig-year= |location= |editor-last1= |editor-first1= |editor-link1= |editor-last2= |editor-first2= |editor-link2= |display-editors= |editor-mask1= |editor-mask2= |title= |script-title= |title-link= |url= |url-access= |trans-title= |format= |department= |website= |script-website= |trans-website= |type= |series= |language= |interviewer-last1= |interviewer-first1= |interviewer-link1= |interviewer-last2= |interviewer-first2= |interviewer-link2= |display-interviewers= |interviewer-mask1= |interviewer-mask2= |translator-last1= |translator-first1= |translator-link1= |translator-last2= |translator-first2= |translator-link2= |display-translators= |translator-mask1= |translator-mask2= |others= |name-list-style= |edition= |publication-place= |publisher= |publication-date= |agency= |minutes= |time-caption= |time= |page= |pages= |at= |no-pp= |arxiv= |asin= |asin-tld= |bibcode= |bibcode-access= |biorxiv= |citeseerx= |doi= |doi-access= |doi-broken-date= |eissn= |hdl= |hdl-access= |isbn= |ismn= |issn= |jfm= |jstor= |jstor-access= |lccn= |medrxiv= |mr= |oclc= |ol= |ol-access= |osti= |osti-access= |pmc= |pmc-embargo-date= |pmid= |rfc= |sbn= |ssrn= |s2cid= |s2cid-access= |zbl= |id= |url-status= |archive-url= |archive-format= |archive-date= |access-date= |via= |quote-page= |quote-pages= |quote= |script-quote= |trans-quote= |mode= |ref= |postscript=}}

上述參數是按上下文邏輯而非字母順序排列的。以下參數雖然通常至少在某些引用模板中可用,但未包含在上述完整參數集中:authors;book-title;class;degree;docket;encyclopedia;mailing-list;message-id;number;publication-date;section;sheet;sheets;title-link;s2cid。

橫式排列的最常用參數

[編輯]
  • 以{{csdoc|usage common}}開頭
  • 將範例包裹在<syntaxhighlight lang="wikitext" copy="1">...</syntaxhighlight>標籤中
  • 以{{end}}結束
{{csdoc|usage common}}
<syntaxhighlight lang="wikitext" copy="1">{{cite web |last= |first= |date= |title= |url= |website= |location= |publisher= |access-date=}}</syntaxhighlight>
{{end}}
橫式排列的最常用參數
{{cite web |last= |first= |date= |title= |url= |website= |location= |publisher= |access-date=}}

縱式排列的全部參數

[編輯]

完整縱向樣式可採用三欄格式(適用於參數數量不多的情況)或四欄格式實現。

三欄式

[編輯]

三欄式完整縱向樣式包含「縱向列表」、「前提條件」和「簡要說明/註釋」三欄。

<!--
* 开始:
-->
{{csdoc|usage vertical}}
<pre style="margin:0px;">
<!--
* 创建“纵式列表”列
* 用以下分隔下一列:
-->
</pre>
{{csdoc|usage vertical mid}}
<pre style="margin:0px;">
<!--
* 创建“前提条件”列;空行必须包含&nbsp;
* 用以下分隔下一列:
-->
</pre>
{{csdoc|usage vertical mid}}
<pre style="margin:0px;">
<!--
* 创建“简要说明/注意事项”列;空行必须包含&nbsp;
* 结束:
-->
</pre>
{{csdoc|usage vertical end}}

範例:

{{csdoc|usage vertical}}
<pre style="margin:0px;">
{{cite book
| last                  =
| first                 =
| author-link           =
}}
</pre>
{{csdoc|usage vertical mid}}
<pre style="margin:0px;">
&nbsp;
&nbsp;
last
&nbsp;
&nbsp;
</pre>
{{csdoc|usage vertical mid}}
<pre style="margin:0px;">
&nbsp;
same as last1
same as first1
&nbsp;
&nbsp;
</pre>
{{csdoc|usage vertical end}}
縱式排列的全部參數
縱式列表 前提條件 簡要說明/注意事項
{{cite book
| last                  =
| first                 =
| author-link           =
}}
 
 
last
 
 
 
same as last1
same as first1
 
 
  • 若某參數名稱列於前提條件欄中,則表示該參數是其左側參數使用的前提條件。

四欄式

[編輯]

(略)

子模板

[編輯]

使用方法(usage)

[編輯]

[編輯子模板]

複製以下其中一個空白版本來使用。幾乎所有參數名稱僅支持小寫形式(部分縮寫如|isbn=有對應的大寫別名如|ISBN=,則這些大寫形式也可使用)。參數之間使用「|」(管道)字元分隔。未使用的參數可以刪除,以避免原始碼雜亂。本文檔中的部分範例可能包含當前日期;若日期顯示不準確,請刷新頁面。

全部參數(usage full)

[編輯]

[編輯子模板]

橫式排列的全部參數

常用參數(usage common)

[編輯]

[編輯子模板]

橫式排列的最常用參數

縱向樣式(usage vertical)

[編輯]

[編輯子模板]

縱式排列的全部參數
縱式列表 前提條件 簡要說明/注意事項

縱向樣式中間欄(usage vertical mid)

[編輯]

[編輯子模板]

| style="vertical-align:top;" | |}

縱向樣式結束欄(usage vertical end)

[編輯]

[編輯子模板]

|}

  • 若某參數名稱列於前提條件欄中,則表示該參數是其左側參數使用的前提條件。

範例章節

[編輯]

使用{{markup2}}來格式化範例(具體用法參見該模板文件)。

{{markup2 |t=带网址和版本的基本用法
|m={{cite book |title=Mysterious book |url=https://www.example.com |edition=2nd}}
|r={{cite book |title=Mysterious book |url=https://www.example.com |edition=2nd}}
}}

帶網址和版本的基本用法

  • {{cite book |title=Mysterious book |url=https://www.example.com |edition=2nd}}
    Mysterious book 2nd. 

參數說明章節

[編輯]

語法(syntax)

[編輯]

[編輯子模板]

以下參數說明採用如下格式規範:

  • 主參數
  • 或者:主參數2—可替代主參數使用的參數
    • 子參數—需與主參數配合使用(若未指定主參數則自動忽略)
    • 或者:子參數2—可替代子參數使用的參數(若未指定主參數2則自動忽略)
當參數存在別名時,不可同時使用別名與主參數,必須擇一使用。

COinS(coins)

[編輯]

[編輯子模板]

本模板會在輸出的HTML中嵌入COinS(英語:COinS)元數據,供文獻管理軟件提取書目資訊(參見WP:COinS(英語:WP:COinS))。因此使用模板時:

  • 每個參數僅包含單一數據項,不附加說明文字。例如應使用|date=2007-09-27,而非|date=2007-09-27(紙質版為9月25日)。
  • 不建議在引用模板內嵌套其他模板,以防冗餘HTML/CSS代碼混入元數據。
  • 影響元數據的參數中不應使用HTML實體(如&nbsp;、&ndash;或&#160;)。

句號分隔符(sep_period)

[編輯]

[編輯子模板]

預設使用半角句號(.)分隔引文各部分。

逗號分隔符(sep_comma)

[編輯]

[編輯子模板]

預設使用半角逗號(,)分隔引文各部分。

必填參數(required)

[編輯]

[編輯子模板]

此參數為必填項,若未定義將生成錯誤提示。條目、幫助和模板命名空間的錯誤頁面會被歸入Category:頁面引用語法錯誤分類。如需在文檔中展示錯誤範例,可通過設置|no-tracking=true禁用分類追蹤。

已棄用參數(deprecated)

[編輯]

[編輯子模板]


引文格式1/2過時參數
過時參數 替換參數
|coauthor=
|coauthors=
  • |last1=、|first1=、|last2=、|first2=等;或
  • |author1=、|author2=等;或
  • |vauthors=或
  • |authors=

作者(author)

[編輯]

[編輯子模板]

  • author:作者姓名。一般用於中文人名或機構名稱;英文人名應使用|first=和|last=分別填寫名和姓。多位作者需分別填寫,詳見下文說明。如需添加內部連結,請使用author-link參數。請勿使用斜體。別名:author1。
    • last:作者的姓氏(一般用於英文人名);例如:「Smith」。如需添加內部連結,請使用author-link參數。別名:surname、last1、surname1。
    • first:作者的名字(一般用於英文人名);例如:「John Michael」或「J. M.」。如需添加內部連結,請使用author-link參數。別名:given、first1、given1。必須與last參數配合使用;若last參數為空則不顯示名字。
    • 或者:多位作者時使用author1至authorn(中文人名)或last1、first1至lastn、firstn(英文人名),其中n為任意連續數字,支持無限數量的作者(每個firstn需要對應的lastn,但反之不成立)。參見display參數來調整顯示作者數量。別名:surname1、given1至surnamen、givenn。
    • author-link:作者的維基百科條目名稱,而非作者個人網站;僅填寫條目名稱即可,無需特殊語法。別名:author-link1、author1-link、authorlink。
    • 或者:多位作者時使用author-link1至author-linkn。別名:author1-link至authorn-link。
    • name-list-style:(罕用)姓名顯示格式。設為amp或&時,用「&」連接最後兩位作者;設為vanc時,按溫哥華格式顯示姓名列表(需使用last/first參數填寫姓名)。
  • vauthors:溫哥華格式的作者列表(用逗號分隔);機構名需用雙括號包裹,如:|vauthors=Smythe JB, ((Megabux Corp.)), etal
    • author-link和author-mask可用於|vauthors=中的個人姓名,用法同上
  • contributor:(僅限書籍類文獻使用)章節作者姓名;英文人名應使用|contributor-first=和|contributor-last=分別填寫名和姓。必須與參數contribution搭配使用。如需添加內部連結,請使用contributor-link。具體用法參見author。
  • translator:譯者姓名。一般用於中文人名或機構名稱;英文人名應使用|translator-first=和|translator-last=分別填寫名和姓。如需添加內部連結,請使用translator-link。具體用法參見author。
  • others:用於標註作者、編輯者、譯者之外的其他貢獻者(如插畫師)。使用此參數時,請同時註明該姓名及其具體職責,例如:「John Smith (繪圖)」。
  • 注意:使用{{sfn}}或{{harv}}時,請勿在單個字段中包含多個姓名,否則錨點將無法匹配內聯連結。
本字段的選項:
  • |contributor=yes 顯示contributor(章節作者)參數說明(僅限cite book和citation模板使用)
  • |others=yes 顯示others(其他貢獻者)參數說明
  • |aliases= 為author參數添加別名

編者(editor)

[編輯]

[編輯子模板]

  • editor:編者姓名。一般用於中文人名或機構(如編委會)名稱;對於英文人名,優先使用|editor-first=和|editor-last=組合。請僅填寫一位編者的姓名,多位編者的寫法見下方說明。如需添加內部連結,請使用editor-link參數。別名:editor1。
    • editor-last:編者的姓氏(一般用於英文人名);例如:「Smith」。如需添加內部連結,請使用editor-link參數。別名:editor-surname、editor1-last、editor-last1。
    • editor-first:編者的名字(一般用於英文人名);例如:「John Michael」或「J. M.」。如需添加內部連結,請使用editor-link參數。別名:editor-given、editor1-first、editor-first1。必須與editor-last參數配合使用;若editor-last參數為空則不顯示名字。
    • 或者:多位編者時使用editor1至editorn(中文人名)或editor-last1、editor-first1至editor-lastn、editor-firstn(英文人名),其中n為任意連續數字(每個editor-firstn需要對應的editor-lastn,但反之不成立)。別名:editor-surname1、editor-given1至editor-surnamen、editor-givenn。
    • editor-link:編者的維基百科條目名稱,而非編者個人網站;請勿添加內部連結。別名:editor-link1、editor1-link。
    • 或者:多位編者時使用editor-link1至editor-linkn(別名editorn-link)。
    • name-list-style:接受有限的關鍵詞值:設為amp或&時,在姓名列表最後兩個名字間插入「&」符號;設為vanc時,當姓名參數採用last/first格式時,按溫哥華格式顯示姓名列表。
  • veditors:溫哥華格式的逗號分隔編者列表;機構名稱需用雙括號包裹。如適用可添加etal:
    |veditors=Smythe JB, ((Megabux Corp.)), etal
    • editor-linkn和editor-maskn可用於|veditors=中的個人姓名,用法同上
  • 顯示規則:
    使用display-editors指定顯示的編者人數,其餘編者以「et al.」形式省略顯示。
    若存在作者:先顯示作者,接着顯示文獻名稱,然後是編者姓名和「(編)」,收錄該文獻的作品名稱(如期刊名)。
    若無作者:編者顯示在文獻名稱前,並顯示「(編)」。

標題(title)

[編輯]

[編輯子模板]

(另見Help:引文格式1 § 標題與章節)

  • title:來源標題。可添加內部連結至現有條目或使用url添加外部連結,但二者不可同時使用。
    • script-title:非拉丁文字標題(日文、韓文、阿拉伯文、西里爾文、希臘文、希伯來文等)。必須前綴支持的語言代碼以確保瀏覽器正確顯示,如:|script-title=ja:東京タワー。
    • trans-title:外文來源標題的中文翻譯。顯示在title後的方括號內。建議配合language參數使用。
含特殊字元的標題需經編碼才能正確顯示和連結:
換行字元 [ ] |
空格 &#91; &#93; {{!}}(推薦)
{{bracket|文本}} &#124; 或 {{pipe}} – 另見Help:表格 § 管道符渲染
  • title-link:title所指來源的維基百科條目標題。若需添加外部連結請改用url參數
本字段的選項:

title_title設置「title」參數名的顯示:

  • encyclopedia = encyclopedia
  • 預設值 = title

網頁(web)

[編輯]

[編輯子模板]

(另見Help:引文格式1 § 標題與章節、§ 作品載體與出版商)

  • title:網站來源頁面標題。
    • script-title:非拉丁文字標題(日文、韓文、阿拉伯文、西里爾文、希臘文、希伯來文等)。必須前綴支持的語言代碼以確保瀏覽器正確顯示,如:|script-title=ja:東京タワー。
    • trans-title:外文來源標題的中文翻譯。顯示在title後的方括號內。建議配合language參數使用。
含特殊字元的標題需經編碼才能正確顯示和連結:
換行字元 [ ] |
空格 &#91; &#93; &#124;
{{bracket|文本}} {{pipe}} - 另見Help:表格 § 管道符本身渲染
此參數為必填項,若未定義將生成錯誤提示。條目、幫助和模板命名空間的錯誤頁面會被歸入Category:頁面引用語法錯誤分類。如需在文檔中展示錯誤範例,可通過設置|no-tracking=true禁用分類追蹤。
  • website:網站名稱(當網站有明確名稱時使用,而非域名);可添加內部連結。別名:work

章節(chapter)

[編輯]

[編輯子模板]

  • chapter:來源的章節標題。可添加內部連結或使用chapter-url添加外部連結,但二者不可同時使用。
    • script-chapter:非拉丁文字章節標題(日文、韓文、阿拉伯文、西里爾文、希臘文、希伯來文等)。必須前綴支持的語言代碼以確保瀏覽器正確顯示,如:|script-chapter=ja:東京タワー。
    • trans-chapter:外文來源章節標題的中文翻譯。顯示在chapter字段後的方括號內;若定義了chapter-url,則trans-chapter會包含在連結中。建議配合language參數使用。
  • contribution:由author之外其他人撰寫的書籍部分。可添加內部連結或使用contribution-url添加外部連結,但二者不可同時使用。貢獻內容的作者資訊通過contributor參數提供。
本字段的選項:

title_title設置顯示標題:

  • booktitle = booktitle
  • 預設值 = chapter

類型(type)

[編輯]

[編輯子模板]

  • type:提供來源類型的附加資訊。顯示在標題後的括號內。若使用關鍵字none可禁用類型顯示。例如:評論、論文、小冊子、錄用稿件、CD內頁說明、新聞稿等。
本字段的選項:
  • type_default:添加「預設值為type_default」的說明。

期刊(journal)

[編輯]

[編輯子模板]

  • work({{cite journal}}和{{cite magazine}}必填):包含來源文獻的出版物名稱。可添加內部連結。若出版物當前名稱與來源發表時不同,應使用來源發表時的名稱。當設置work時,chapter將不顯示,並會生成錯誤提示。別名:journal、newspaper、magazine、periodical、website。
    • script-work:原文出版物名稱(非拉丁文字)。必須前綴支持的語言代碼以確保瀏覽器正確顯示。拉丁文字出版物(捷克語、法語、土耳其語、越南語等)留空。別名:script-journal、script-newspaper、script-magazine、script-periodical、script-website。
    • trans-work:外文出版物名稱的中文翻譯。顯示在work或script-work後的方括號內。別名:trans-journal、trans-newspaper、trans-magazine、trans-periodical、trans-website。
  • issue:連續出版物的期號。若該期有專屬標題,可連同期號一併給出,例如|issue=2, 現代加拿大文學。別名:number,根據出版物實際用詞選擇。若同時存在兩種編號(通常一種按年編號,一種絕對編號),可合併標註(如|issue=2 #143)。顯示在括號內,跟隨volume之後。
  • article-number:期刊為每篇文章分配的文章編號;顯示在卷號/期號和頁碼之間。
  • department:期刊或雜誌中的常設欄目名稱。例如「通訊」、「社論」、「讀者來信」和「評論」。顯示在title之後,以純文本形式呈現。
本字段的選項:
  • |article_num=yes 顯示article_num參數的說明。
  • |department=yes 顯示department參數的說明。

版本(edition)

[編輯]

[編輯子模板]

  • edition:當出版物存在多個版本時使用,例如:「第二版」、「修訂版」等。若已定義期刊類參數則不顯示。

系列(series)

[編輯]

[編輯子模板]

  • series或version:當來源屬於某個系列(如叢書或卷號重新編排的期刊)時使用。

劇集(series_episode)

[編輯]

[編輯子模板]

  • series:所屬系列名稱(如電視劇系列)。可添加內部連結。
    • series-link:對應維基百科條目名稱,用於為series添加內部連結。通過添加跨語言前綴可連結至其他語言版本的維基條目。請勿輸入網址。

活動(event)

[編輯]

[編輯子模板]

  • event:演講或報告的活動名稱。

通訊社(agency)

[編輯]

[編輯子模板]

  • agency:提供內容的通訊社(新聞機構);如美聯社、路透社、法新社。若內容直接發布在通訊社官網(如apnews.com或reuters.com)則不使用此參數,應改用work或publisher。可附對應的內部連結。

卷號(volume)

[編輯]

[編輯子模板]

  • volume:多卷本出版物的卷號。顯示在title和series之後。純數字、純大寫羅馬數字或少於5個字元時加粗顯示,其餘情況不加粗。多卷書的分卷書名、卷次、冊次等可直接寫在title參數中,而不使用volume。極少數出版物同時標註連續卷號和年度卷號時合併標註,如|volume=IV/#10。

日期(date)

[編輯]

[編輯子模板]

  • date:引用來源的發布日期。可以是完整日期(年、月、日)或部分日期(年和月、年和季節或僅年份)。完整的年月日應當使用「YYYY-MM-DD」格式(如2026-11-17)。請勿添加內部連結。日期顯示在作品載體和出版商之後。
使用簡短註腳(英語:Help:Shortened footnotes)時,完整引用的錨點通過此參數指定的年份生成。若同一作者在同一年份有多部作品,可在年份後附加小寫字母加以區分(如|date=1997b);如果date參數填寫的不是年份,而是完整的「YYYY-MM-DD」日期,此時不能通過添加字母來區分引用,而要同時填寫year參數(例如:|date=1997-01-01 |year=1997b,其中「1997-01-01」用於顯示,1997b用於建立錨點),或使用ref參數建立自訂錨點。
  • year:出版年份。更靈活的|date=參數也可單獨處理年份。除非如前文的情況,使用簡短註腳時,需要區分同一作者同年的多部作品,否則不要與date參數同時使用。
  • orig-year:文獻最初發布的日期或年份;顯示在date(或year)後的方括號內。為明確「最初發布」的含義,請提供具體說明,例如:|orig-year=首版於1859或|orig-year=創作於1904。
本字段的選項:
  • |limited_param_list=yes 隱藏orig-year參數說明,因為該參數在有限參數模板中不允許使用

出版商(publisher)

[編輯]

[編輯子模板]

(另見Help:引文格式1 § 作品載體與出版商)

  • publisher:出版商名稱。出版商是指出版被引用作品的公司、組織或其他法律實體,因此請勿輸入出版物名稱(如網站、書籍、百科全書、報紙、雜誌、期刊等的名稱)。一般省略「有限公司」或「股份有限公司」等公司標識。可添加對應的內部連結,但不要添加出版商網站的外部連結。若出版商當前名稱與來源發表時不同,應使用出版物上標註的名稱或來源發表時的名稱。該參數最常用於書籍類來源(一般指書籍的出版社),較少用於網站或期刊來源(某些情況下可替代work)。出版商與作品載體名稱相同或高度相似時,不要使用「publisher」參數(例如《紐約時報》由紐約時報公司出版,無需重複說明)。顯示在title之後。
  • publication-place:出版地。填寫出版商所在地的城市名稱(如|publication-place=北京,WP:列明來源中的寫法);城市名稱有歧義,或不知名,宜附省/州名或國名。通常不添加內部連結。當出版物名稱已包含出版地時可省略(如《波士頓環球報》《印度時報》)。若地名與來源發表時不同,請使用出版物上標註的地名或來源發表時的地名。顯示在標題之後。別名:location、place。
    • 目前place、location嚴格來講是新聞報道電頭(英語:Dateline)中的報道撰寫地參數,但為了兼容性考慮,當未定義publication-place時仍將其作為出版地顯示。具體規則:若僅定義了publication-place、place或location其中之一,將作為出版地顯示在標題後;若同時定義了publication-place和place/location,則place/location作為報道撰寫地以「寫於」為前綴顯示在標題前,而publication-place作為出版地顯示在標題後。
  • publication-date:出版日期,與作品創作日期不同時。若同時定義了不同的date(或year),則publication-date顯示在publisher後的括號內;若未定義date(或year),則publication-date作為date顯示。格式同date參數,不要添加內部連結。
  • via:內容提供方名稱(若不同於publisher)。via不能替代publisher參數,但可提供額外資訊。適用於:文章署名其他出版物但無法溯源時(如雅虎新聞);內容提供方以非原始格式提供內容時;內容提供方無法從URL直接識別時;或內容提供方要求署名時。訪問限制顯示參見access level參數;原始來源為通訊社時參見agency參數。

新聞組(newsgroup)

[編輯]

[編輯子模板]

  • newsgroup:新聞組名稱;自動生成外部連結,請勿添加內部連結。

語言(language)

[編輯]

[編輯子模板]

  • language:來源使用的語言,請填寫ISO 639-1語言代碼,例如:|language=ru;可接受逗號分隔的多語言列表,例如:|language=fr, pt-br。請勿使用模板或內部連結。顯示在括號內。使用被引文模組識別的語言會將頁面歸入Category:CS1外文來源相應子分類。別名:in

頁碼(pages)

[編輯]

[編輯子模板]

  • page:來源中包含佐證內容的單頁頁碼。使用|page=或|pages=二者之一,兩者顯示效果一致,可不作明確區分。顯示時前綴為冒號(:)。別名:p。
  • 或:pages:來源中包含佐證內容的頁碼範圍。使用|page=或|pages=二者之一。用短橫線(-)表示範圍,用逗號(,)分隔非連續頁碼。不可用於表示來源總頁數。顯示時前綴為冒號(:)。別名:pp。
  • 或:at:用於頁碼不適用或不充分的情況。會被|page=或|pages=覆蓋。|page=、|pages=和|at=三者僅能使用其一。
    範例:第幾欄、第幾段、第幾節;第幾音軌;時:分:秒;第幾幕、第幾場;某部分、扉頁題詞、封底、唱片內頁、版權頁、書籍末頁、護封。

時間(time)

[編輯]

[編輯子模板]

  • minutes:來源中事件發生的具體時間;自動後接「記錄於」。
  • 或:time:來源中事件發生的具體時間;預設前綴「事件發生在」。
    • time-caption:修改time前的預設顯示文字。

標識符1(id1)

[編輯]

[編輯子模板]

標識符2(id2)

[編輯]

[編輯子模板]

下列標識符會生成外部連結。每個參數僅接受一個標識符值,輸入多個值或多餘內容將無法正確生成連結。指定標識符參數時,通常只需輸入可變部分,例如|rfc=822或|pmc=345678。

  • arxiv:arXiv標識符;例如:|arxiv=hep-th/9205027(2007年4月前)或|arxiv=0706.0001(2007年4月—2014年12月)或|arxiv=1501.00001(2015年1月起)。請勿包含「.pdf」或「.html」等無關檔案擴展名。別名:ARXIV、eprint。
  • asin:亞馬遜標準識別號碼;若首字元為數字,請使用isbn。由於此連結偏向特定分銷商,僅在無標準標識符時使用。例如:|asin=B00005N5PF。別名:ASIN。
    • ASIN-TLD:非美國亞馬遜網站的頂級域名。別名:asin-tld。
  • bibcode:bibcode;用於多個天文數據系統;例如:1974AJ.....79..819H。別名:BIBCODE。
  • biorxiv:bioRxiv標識符,需完整DOI(如10.1101/078733對應http://biorxiv.org/content/early/2016/10/01/078733或https://doi.org/10.1101/078733)。別名:無。
  • citeseerx:CiteSeerX標識符,為URL中的數字與點組合(如10.1.1.176.341對應https://citeseerx.ist.psu.edu/viewdoc/summary?doi=10.1.1.176.341)。別名:無。
  • cn:國內統一刊號。別名:CN。
  • doi:數位物件識別符;以10.開頭,例如:10.1038/news070508-7。別名:DOI。
    • doi-broken:DOI在https://doi.org失效的日期。格式為「YYYY-MM-DD」。別名:doi-broken-date、doi-inactive-date、doi_brokendate、doi_inactivedate。
  • eissn:電子版國際標準期刊號;8位字元,通常用連字元分為兩組;例如:|eissn=1557-2986。別名:EISSN。
  • hdl:Handle系統(英語:Handle System)數字對象標識符;例如:|hdl=20.1000/100。別名:HDL。
  • isbn:國際標準書號;例如:978-0-8126-9593-9。(參見Help:各類書號和國際標準書號 § 概述)連字元可選但建議保留。請使用書籍印刷的ISBN。優先使用13位ISBN(以978或979開頭)。若書籍僅印有10位ISBN則使用之。ISBN通常位於版權頁(書名頁背面)或條形碼下方(以978或979開頭的條形碼)。9位SBN請使用。請勿通過簡單添加978前綴將10位ISBN轉為13位(末位為校驗碼,隨意變更會導致ISBN無效)。此參數應僅包含ISBN不包含其他字元。系統會校驗長度、非法字元(10位ISBN末位可為「X」)及校驗碼。別名:ISBN、isbn13、ISBN13。
  • ismn:國際標準音樂編號;例如:979-0-9016791-7-7。連字元或空格可選。請使用作品印刷的ISMN。此參數應僅包含ISMN不包含其他字元。系統會校驗長度、非法字元及校驗碼。別名:ISMN。
  • issn:國際標準期刊號;8位字元,通常用連字元分為兩組;例如:|issn=2049-3630。別名:ISSN。
  • jfm:數學進展年鑑;值中請勿包含「JFM」;例如:|jfm=53.0144.01。別名:JFM。
  • jstor:JSTOR標識符;例如:|jstor=3793107。別名:JSTOR。
  • LCCN:美國國會圖書館控制號。字母前綴應為小寫且無空格;例如:|lccn=79-57364或|lccn=2004042477或|lccn=e09001178。別名:lccn。
  • MR:《數學評論》標識符;例如:|mr=630583。別名:mr。
  • OCLC:開放圖書館標識符,用於在WorldCat聯合目錄檢索;例如:|oclc=9355469。別名:oclc。
  • ol:開放圖書館標識符;值中請勿包含「OL」;例如:|ol=7030731M。別名:OL。
  • OSTI:美國能源部科學和技術資訊辦公室(英語:Office of Scientific and Technical Information)標識符;例如:|osti=4367507。別名:osti。
  • PMC:PubMed Central文章編號;不包含「PMC」,如|pmc=345678。與下方的PMID參數不同。別名:pmc。
    • embargo:PMC開放日期;在此日期之前不會生成連結。別名:無。
  • PMID:PubMed唯一標識符;例如:|pmid=17322060與上方的PMC參數不同。別名:pmid。
  • RFC:RFC(請求意見稿)編號;例如:|rfc=3143。別名:rfc。
  • SSRN:SSRN;例如:|ssrn=1900856。別名:ssrn。
  • s2cid:語義學者語料庫ID;例如:|s2cid=37220927。別名:S2CID。
  • unified:統一書號。別名:csbn、CSBN。
  • ZBL:數學文摘期刊標識符;例如:|zbl=0472.53010。對於類似JFM 35.0387.02的zbMATH搜索結果請使用|jfm=35.0387.02。別名:zbl。

部分標識符可通過對應的|參數-access=參數指定訪問狀態。

無需通過|url=重複填寫標識符自動生成的連結地址。此時|url=可用於提供便捷訪問連結。

網址(url)

[編輯]

[編輯子模板]

  • url:可獲取title指定出版物文本的在線地址。若title已添加內部連結則不可使用。如適用,連結可指向具體引用頁。需移除URL中的跟蹤參數(如#ixzz2rBr3aO94或?utm_source=google&utm_medium=...&utm_term=...&utm_campaign=...)。請勿連結至商業售書網站(如亞馬遜),而應使用|isbn=或|oclc=提供中立圖書檢索連結。含空格等無效URL將觸發錯誤提示。
    • access-date:最後驗證url連結的內容支持條目內容的日期;必須與url參數同時使用;格式為「YYYY-MM-DD」。對於內容不會發生變動的來源無需使用該參數(例如通過DOI獲取的文獻或紙質書籍連結);但對於商業網站的新聞文章應使用該參數(這些內容可能隨時變更,即使同時有紙質版本發布)。需注意access-date不僅是驗證連結可訪問的日期,更是確認網頁內容支持所引用條目內容的日期(當前網頁內容可能發生變更而不再支持)。別名:accessdate。
    • archive-url:網頁存檔快照的URL(參見WP:失效連結)。通常指向互聯網檔案館(參見WP:使用時光機)或archive.today(參見Help:使用archive.today(英語:Help:Using archive.today))等服務;需配合archive-date和url使用。預設優先顯示存檔連結,原始連結置於末尾(可通過設置|url-status=live優先顯示原始連結)。別名:archiveurl。
      • archive-date:存檔服務快照日期;預設前綴「原始內容存檔於」。格式為「YYYY-MM-DD」。別名:archivedate。
      • url-status:控制|title=的標題文字連結至|url=還是|archive-url=;需同時定義url和archive-url。網址無存檔時,使用{{dead link}}標記連結已失效。標註連結是否失效曾使用dead-url參數:yes表示已失效,no表示未失效。
        接受多組關鍵詞:
        • dead—(預設狀態)連結至|archive-url=
        • live—連結至|url=;用於預防性存檔的連結
        • deviated—連結至|archive-url=;用於原網址仍可訪問但不再支撐文中論述(參見WP:列明來源 § 原地更新的來源)
        • unfit或usurped—連結至|archive-url=;用於原網址已被劫持用於垃圾資訊、廣告或不適合展示時,原網址連結被將隱藏
      • archive-format:archive-url指向檔案的格式(如DOC、XLS),用法同format。
    • url-access:詳見URL參數訪問指示
  • format:url指向檔案的格式(如DOC、XLS),顯示在標題後的括號內。(媒體格式請用type參數。)HTML為預設格式無需指定,PDF會自動檢測無需指定。不影響外部連結圖標。
URL必須以支持的URI方案開頭。所有瀏覽器均支持http://和https://;而ftp://、gopher://、irc://、ircs://、mailto:和news:可能需要插件或外部應用支持,通常應避免使用。當前不支持IPv6主機名。

若引文模板參數中的URL包含特定字元,將無法正確顯示和連結。這些字元需進行百分號編碼。例如空格必須替換為%20。編碼替換規則如下:

字元 空格 " ' < > [ ] { | }
編碼 %20 %22 %27 %3C %3E %5B %5D %7B %7C %7D

單引號無需編碼,但未編碼的多個引號會被解析為斜體/粗體標記。單個右花括號無需編碼,但未編碼的成對花括號會被解析為模板嵌入的結束符。

本字段的選項:
  • media將描述文字中的「出版物文本」替換為「媒體檔案」

章節網址(chapterurl)

[編輯]

[編輯子模板]

  • chapter-url:可獲取chapter或contribution指定文本的在線地址。若這些參數已添加內部連結則不可使用。如已填寫url,應與其屬於同一站點。使用chapter-url時,僅當著作起始部分與被引章節位於站點不同網頁時才需使用url。別名:contribution-url、section-url。
  • chapter-format:chapter-url指向檔案的格式(如DOC、XLS),顯示在chapter後的括號內。HTML為預設格式無需指定,PDF會自動檢測無需指定。不影響外部連結圖標。

引文(quote)

[編輯]

[編輯子模板]

  • quote:從來源引用的相關文本。顯示在引號內。需包含終止標點(預設情況下引文會抑制引文終止符句號)。
    • script-quote:非拉丁文字引文(阿拉伯文、西里爾文等)。必須前綴支持的語言代碼以確保瀏覽器正確顯示,如:|script-quote=ja:東京タワー。
    • trans-quote(暫不支持):外文引文的中文翻譯。顯示在quote之後的方括號內。
本字段的選項:
  • |cs2=yes 取消「需包含終止標點(預設情況下引文會抑制引文終止符句號)」的預設提示

通俗摘要(lay)

[編輯]

[編輯子模板]

  • laysummary:面向非專業人士對來源的摘要或評論的URL;顯示為帶有「通俗摘要」標題的外部連結。
    • laysource:通俗摘要的來源名稱,可添加內部連結。顯示為斜體,在「通俗摘要」之後,通過破折號連接。
    • laydate:通俗摘要的日期。顯示在圓括號內。

引用錨點(ref)

[編輯]

[編輯子模板]

  • ref:用於設置引文的HTML錨點標識符,以替代自動生成的預設值,通常使用{{harvid}}模板填寫,以配合{{harv}}、{{sfn}}系列短註腳(英語:Help:Shortened footnotes)模板定位至完整引用。自2026年7月起,已不再需要手動設置|ref=harv。如需禁用錨點生成,設置|ref=none即可。(詳見Help:引文格式1 § 錨點)

顯示選項(display)

[編輯]

[編輯子模板]

  • mode:用於指定分隔符和末尾標點的設置。|mode=cs1使用半角句號(.)作為分隔符和末尾標點;|mode=cs2使用半角逗號(,)作為分隔符和末尾標點。分別對應引文樣式1和樣式2。覆蓋預設末尾標點設置請使用postscript參數。
  • author-mask:
  • contributor-mask:
  • editor-mask:
  • interviewer-mask:
  • subject-mask:
  • translator-mask:
    將第一位作者(或編者等)顯示的姓名替換為橫線或指定文本。設為數字n時顯示n em橫線(—);設為文本時直接顯示該文本,且其後不帶分隔符。特殊值「0」將直接隱藏第一位作者,但此時元數據仍保留真實作者姓名,故不要省略作者參數。此參數主要用於簡短註腳的參考文獻列表中,同一作者的多部作品連續列出時。不應在{{reflist}}或<references />生成的文獻列表中使用(因為文獻的顯示順序易發生改變)。如需省略第二位及以後特定作者的姓名,使用|authorn-mask=參數。
  • display-authors:
  • display-contributors:
  • display-editors:
  • display-interviewers:
  • display-subjects:
  • display-translators:
    控制顯示的作者(或編者等)數量,預設全部顯示;超過顯示數量將以「et al.」代替。例如|display-authors=2僅顯示前兩位作者。特殊值|display-authors=0隱藏所有作者及「et al.」。|display-authors=etal則顯示全部作者後追加「et al.」。
  • postscript:控制引用末尾的標點。預設為半角句號(.);設為|postscript=none取消末尾標點(留空效果等同,但語義模糊故不建議)。包含額外文本或多字元標點模板時會生成維護提示。定義quote參數時本參數無效。
本字段的選項:
  • cs2:設置時將:
    • postscript預設值改為「無標點」
    • separator預設值改為「逗號(,)」

訂閱或註冊要求(registration)

[編輯]

[編輯子模板]

維基百科允許引用需要註冊或訂閱的在線來源。為方便讀者和其他編者,建議註明引用的外部連結的獲取限制級別。這些級別僅說明獲取材料的限制條件,不涉及內容的重用許可或版權狀態(因其與可供查證無關)。

可使用四種訪問級別:

  • 標識符訪問指示:
    • 可免費查閱 free:任何人都可免費閱讀全文
  • URL參數訪問指示:
    • 需要免費註冊 registration:需免費註冊才能查閱(但部分預覽/摘要可能無需註冊)
    • 有限度免費查閱,超限則需付費訂閱 limited:有限度免費查閱,超限則需付費訂閱
    • 需要付費訂閱 subscription:必須付費訂閱才能查閱(「付費牆」)

同一引用的不同連結可能有不同訪問級別,需為每個連結單獨指定級別。

URL參數訪問指示
[編輯]

|url=、|article-url=等URL參數指定的連結預設視為可免費訪問。若非免費訪問,應通過對應參數指定訪問級別以顯示提示標識。因預設視為免費訪問,故無需標記free。若服務已終止導致無法註冊/訂閱,則應移除訪問級別參數,並添加|archive-url=和|archive-date=存檔資訊。

URL參數與訪問指示
URL參數 訪問參數 允許值
|url= |url-access= registration 需要免費註冊
limited 有限度免費查閱,超限則需付費訂閱
subscription 需要付費訂閱
|article-url= |article-url-access=
|chapter-url= |chapter-url-access=
|contribution-url= |contribution-url-access=
|entry-url= |entry-url-access=
|map-url= |map-url-access=
|section-url= |section-url-access=

例如需要免費註冊的文獻應這樣標註:

  • {{cite web |url=https://example.com/nifty_data.php |url-access=registration |date=2021-04-15 |title=Nifty example data}}
    Nifty example data需要免費註冊. 2021-04-15. 
標識符訪問指示
[編輯]

由標識符生成的連結(後文列出的除外)預設假定需要訂閱或註冊。若實際可免費訪問,應通過對應參數指定訪問級別。若標識符僅提供摘要服務(無全文),則不可標記為limited、registration或subscription。

命名標識符與訪問指示
標識符 訪問參數 允許值
|bibcode= |bibcode-access= free 可免費查閱
|doi= |doi-access=
|hdl= |hdl-access=
|jstor= |jstor-access=
|ol= |ol-access=
|osti= |osti-access=
|ssrn= |ssrn-access=
|s2cid= |s2cid-access=

以下標識符始終提供免費訪問,系統會自動標註訪問級別(無需額外參數):

  • |arxiv=
  • |biorxiv=
  • |citeseerx=
  • |medrxiv=
  • |pmc=
  • |rfc=

未來將開放的PMC付費內容參見embargo。

地圖系列(map_series)

[編輯]

[編輯子模板]

  • scale:地圖的比例尺數值。
  • series:地圖所屬系列名稱。
  • cartography:地圖製作者,顯示為「Cartography by XXX」。

地圖頁碼(map_pages)

[編輯]

[編輯子模板]

  • page:來源中包含佐證內容的單頁頁碼;會被at參數覆蓋。
  • 或:pages:來源中包含佐證內容的頁碼範圍。用短橫線(-)表示範圍,用逗號(,)分隔非連續頁碼;不可用於表示來源總頁數。
  • inset:引用的專題插圖名稱(如「市中心區」);顯示為「插圖名稱 inset」;會被at參數覆蓋。
  • section:引用的地圖區域編號(如A6、B9等);會被at參數覆蓋。
  • at:當上述參數不足以描述來源位置時使用。
範例:頁;插圖;節;地圖或圖集中的其他自訂位置。

受訪者(interview_author)

[編輯]

[編輯子模板]

  • last:受訪者(非採訪者)姓氏。請勿添加內部連結——應使用subject-link。對於姓氏前置(如中文)或機構受訪者,直接使用last保持與來源相同格式。
    • first:受訪者名字(可含頭銜),如「Firstname Middlename」或「Firstname M.」或「Firstname M., Sr」;請勿添加內部連結——應改用subject-link參數。
    • 或:多位受訪者時使用firstn和lastn組合。
  • subject-link:受訪者維基百科條目標題——非個人網站;請勿添加內部連結。別名:subject-link、author-link、author-linkn;subject-linkn、authorn-link
  • 或:多位受訪者時使用subject-linkn。
別名:subject、last、lastn、authorn、author、subjectn。

採訪者(interview_interviewer)

[編輯]

[編輯子模板]

  • interviewer-last:單個採訪者的姓氏。請勿添加內部連結——應改用interviewer-link。對於來源中僅列出一個名稱的採訪者,可直接使用interviewer或其別名(如|interviewer=Bono)。別名:interviewer-last1、interviewer1-last、interviewer-surname、interviewer-surname1、interviewer1-surname、interviewer、interviewer1。
    • interviewer-first:採訪者的名字或教名;例如:「Firstname Middlename」或「Firstname M.」或「Firstname M., Sr.」。請勿添加內部連結——應改用interviewer-link。別名:interviewer-first1、interviewer1-first、interviewer-given、interviewer-given1、interviewer1-given。必須與interviewer-last配合使用;若interviewer-last為空則不顯示名字。
    • interviewer:此參數用於填寫單個採訪者的全名(包含名和姓)。不可填寫多個採訪者姓名。
    • 多位採訪者時,使用interviewer-last1、interviewer-first1至interviewer-lastn、interviewer-firstn,其中n為任意連續數字(每個interviewer-firstn需要對應的interviewer-lastn,但反之不成立)。參見display參數調整顯示的採訪者數量。interviewer-last1至interviewer-lastn的別名:interviewer1至interviewern。如需同時標註全名採訪者和單名採訪者,可使用|interviewer-first1=… |interviewer-last1=… |interviewer2=…組合。

季數(season)

[編輯]

[編輯子模板]

  • season:通常用於美劇的季數編號。
  • 或:series-number:通常用於英劇的系列編號。別名:series-no。
  • number:多數劇集通過季數和集數組合標識。部分劇集採用包含季數的單集編號格式,此時可省略季數字段。

電視網(network)

[編輯]

[編輯子模板]

  • network:播出該劇集的電視網名稱(如ABC、NBC、CBS、Fox、迪士尼、USA電視網、BBC)。
    • station:當地電視台呼號(如有)。

文字記錄(transcript)

[編輯]

[編輯子模板]

  • transcript:原始來源的文字記錄。
    • transcript-url:文字記錄的在線地址。

會議(conference)

[編輯]

[編輯子模板]

  • conference:會議名稱。
    • conference-url:會議議程網址(若與url不同)。