模板:Citation Style documentation

模板文件[檢視] [編輯] [歷史] [清除快取]

使用方法

本模板用於為引文格式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=}}

完整縱向樣式

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

三欄格式

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

<!--
* Start with: 
-->
{{csdoc|usage vertical}}
<pre style="margin:0px;">
<!--
* Create the vertical list column
* Separate the next column with:
-->
</pre>
{{csdoc|usage vertical mid}}
<pre style="margin:0px;">
<!--
* Create the prerequisites column; blank lines must include a &nbsp;
* Separate the next column with:
-->
</pre>
{{csdoc|usage vertical mid}}
<pre style="margin:0px;">
<!--
* Create the instructions column; blank lines must include a &nbsp;
* End with:
-->
</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）

|}

縱向樣式結束欄（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填寫，此參數將被忽略）

在列出別名（aliases）的地方，只能定義一個參數；如果定義了多個別名參數（aliased parameters），那麼只有一個會被顯示。

COinS（coins）

該模板在HTML輸出中嵌入了COinS元數據，使文獻管理軟件能夠獲取書目元數據。參見WP:COinS。一般規則是每個參數只包含一個數據項，不要包含解釋性或替代文本：

• 使用|date=2007-09-27，而非|date=2007-09-27（印刷版為9月25日）

不建議在引用模板內嵌套其他模板，因為許多模板會添加多餘的HTML或CSS代碼，這些代碼會以原始形式包含在元數據中。此外，在影響元數據的參數中不應使用HTML實體，例如 、–或 。

為以下參數生成COinS元數據

註：此元數據表顯示在所有CS1模板的文檔中。並非所有CS1模板都支持全部參數。部分參數互斥，部分互為別名，還有些參數需要其他參數配合使用。本模板支持的完整參數列表、別名及其依賴關係詳見本文檔頂部附近的使用方法部分。 periodical、journal、newspaper、magazine、work、website、encyclopedia、encyclopaedia、dictionary chapter、script-chapter、contribution、script-contribution、entry、script-entry、article、script-article、section、script-section title、script-title、book-title publication-place、place、location date、year、publication-date series、version volume、issue、number page、pages、at、quote-page、quote-pages edition publisher、institution url、chapter-url、contribution-url、section-url author-last、author-last#、author#-last、author-surname、author-surname#、author#-surname、last、last#、surname、surname#、author、author#、subject、subject#、host、host# author-first、author-first#、author#-first、author-given、author-given#、author#-given、first、first#、given、given# degree arxiv、bibcode、biorxiv、citeseerx、doi、eissn、eprint、hdl、isbn、issn、jfm、jstor、lccn、message-id、mr、oclc、osti、pmc、pmid、rfc、ssrn、s2cid、zbl

句號分隔符（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：溫哥華格式的逗號分隔作者列表；機構作者名需用雙括號包裹。如適用可添加etal：

  |vauthors=Smythe JB, ((Megabux Corp.)), etal

  • author-link和author-mask可用於|vauthors=中的個人姓名，用法同上
• authors：已棄用自由格式的作者列表參數；不建議使用此參數，因其不貢獻引文元數據；並非last的別名
• contributor：（僅限書籍類文獻使用）章節作者姓名；必須與參數contribution搭配使用。如需添加內部連結，請使用contributor-link。別名：contributor1。
  • contributor-last：章節作者姓氏（一般用於英文人名）。別名：contributor-surname、contributor1、contributor1-last、contributor-last1。
  • contributor-first：章節作者名字（一般用於英文人名）。別名：contributor-given、contributor1-first、contributor-first1。
  • 或者：多位章節作者時使用contributor1至contributorn（中文人名）或contributor-last1、contributor-first1至contributor-lastn、contributor-firstn（英文人名），其中n為任意連續數字。別名：contributor1-last、contributor1-first至contributorn-last、contributorn-first。
  • contributor-link：章節作者的維基百科條目名稱，而非其個人網站；請勿添加內部連結。別名：contributor-link1、contributor1-link。
  • 或者：多位章節作者時使用contributor-link1至contributor-linkn。別名：contributor1-link至contributorn-link。
• translator：譯者姓名。一般用於中文人名或機構名稱；對於英文人名，優先使用|translator-first=和|translator-last=組合。如需添加內部連結，請使用translator-link。別名：translator1。
  • translator-last：譯者姓氏（一般用於英文人名）。如需添加內部連結，請使用translator-link。別名：translator-surname、translator1-last、translator-last1。
  • translator-first：譯者名字（一般用於英文人名）。如需添加內部連結，請使用translator-link。別名：translator-given、translator1-first、translator-first1。
  • 或者：多位譯者時使用translator1至translatorn（中文人名）或translator-last1、translator-first1至translator-lastn、translator-firstn（英文人名），其中n為任意連續數字。別名：translator1-last、translator1-first至translatorn-last、translatorn-first。
  • translator-link：譯者的維基百科條目名稱，而非其個人網站；請勿添加內部連結。別名：translator-link1、translator1-link。
  • 或者：多位譯者時使用translator-link1至translator-linkn。別名：translator1-link至translatorn-link。
• 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控制顯示的編者姓名列表長度，並指定何時包含「etal」。

  若存在作者：先顯示作者，接着顯示被引作品，然後是編者和「(編)」，最後顯示主作品。

  若無作者：編者顯示在被引作品前，並顯示「(編)」。

標題（title）

（另見Help:引文格式1 § 標題與章節）

• title：來源標題。可添加內部連結至現有條目或使用url添加外部連結，但二者不可同時使用。
  • script-title：非拉丁文字標題（日文、韓文、阿拉伯文、西里爾文、希臘文、希伯來文等）。必須前綴支持的語言代碼以確保瀏覽器正確顯示，如：|script-title=ja:東京タワー。
  • trans-title：外文來源標題的中文翻譯。顯示在title後的方括號內。建議配合language參數使用。

含特殊字元的標題需經編碼才能正確顯示和連結：

換行字元	[	]	|
空格	[	]	{{!}}（推薦）
	{{bracket|文本}}		| 或 {{pipe}} – 另見Help:表格 § 管道符渲染

• title-link：title所指來源的維基百科條目標題——不要使用網址；請勿添加內部連結。

本字段的選項：

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

• encyclopedia = encyclopedia
• 預設值 = title

網頁（web）

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

• title：網站來源頁面標題。
  • script-title：非拉丁文字標題（日文、韓文、阿拉伯文、西里爾文、希臘文、希伯來文等）。必須前綴支持的語言代碼以確保瀏覽器正確顯示，如：|script-title=ja:東京タワー。
  • trans-title：外文來源標題的中文翻譯。顯示在title後的方括號內。建議配合language參數使用。

含特殊字元的標題需經編碼才能正確顯示和連結：

換行字元	[	]	|
空格	[	]	|
	{{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內頁說明、新聞稿。別名：medium。

本字段的選項：

• type_default: Adds "Defaults to 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之後，以純文本形式呈現。

本字段的選項：

• department參數添加：

• department：期刊或雜誌中的常規部門或欄目。例如「通訊」、「社論」、「讀者來信」和「評論」。顯示在title之後，以純文本形式呈現。

版本（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個字元的卷號會加粗顯示，5個及以上字元的字母數字組合不加粗。也可將卷次資訊直接包含在title參數中。極少數出版物同時標註連續卷號和年度卷號時需一併提供，例如|volume=IV/#10。

日期（date）

• date：引用來源的發布日期。可以是完整日期（年、月、日）或部分日期（年和月、年和季節或僅年份）。完整的年月日應當使用「YYYY-MM-DD」格式（如2025-05-30）。請勿添加內部連結。日期顯示在作品載體和出版商之後。

使用簡短註腳時，完整引用的錨點透過此參數指定的年份生成。若同一作者在同一年份有多部作品，可在年份後附加小寫字母加以區分（如|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：出版商名稱；可添加對應的內部連結。出版商是指出版被引用作品的公司、組織或其他法律實體。請勿將publisher參數用於出版物名稱（如網站、書籍、百科全書、報紙、雜誌、期刊等）。若出版商名稱隨時間變更，請使用出版物上標註的名稱或來源發表時的名稱。通常不包含「有限公司」、「股份公司」等企業標識。該參數最常用於書籍，較少用於網站或期刊（某些情況下可替代work）。當出版商名稱與出版物名稱基本相同時可省略（例如《紐約時報》由紐約時報公司出版，無需重複說明）。顯示在title之後。
• place：對於含電頭的新聞報道，指報道撰寫地點。若地名隨時間變更，請使用出版物上標註的名稱或來源發表時的名稱。在早期模板版本中此為出版地，為保持兼容性，當未定義publication-place時將作為出版地處理（詳見該參數說明）。別名：location。
• 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顯示。格式需與文中其他日期一致；請勿添加內部連結。
• via：內容分發方名稱（若不同於publisher）。via不是publisher的替代參數，而是提供額外資訊。適用於：文章署名其他出版物（如雅虎新聞）但無法溯源時；內容分發方（如NewsBank）以非原始格式呈現時；提供的URL未明確分發方身份時；無URL或DOI時（如EBSCOhost）；或分發方要求署名時。訪問限制顯示參見access level參數；原始來源為通訊社時參見agency參數。

本字段的選項：

• |work=no取消「若定義了work，則publisher和location顯示在括號內」的預設規則
• |map=yes將改變：
  • publisher：出版商名稱。出版商是指出版被引用作品的公司。請勿將publisher參數用於出版物名稱（如書籍、百科全書、報紙等）。顯示在標題前。請勿添加內部連結——應改用publisher-link。
  • publisher-link：指向出版商維基百科條目的標題——非出版商網站；請勿添加內部連結。

新聞組（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=三者僅能使用其一。
  範例：第幾欄、第幾段、第幾節；第幾音軌；時:分:秒；第幾幕、第幾場；某部分、對開頁、封底、唱片內頁、著作權頁、書籍末頁、護封。
• 與|quote=配合使用的|quote-page=和|quote-pages=參數說明參見此處。

時間（time）

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

標識符1（id1）

• id：唯一標識符，在無專用標識符時使用；可添加內部連結或使用外部連結模板。例如|id=NCJ 122967將在引文末尾添加「NCJ 122967」。也可使用模板如|id={{NCJ|122967}}來顯示美國犯罪司法參考服務資料庫 122967。

標識符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）。別名：none。
• citeseerx：CiteSeerX標識符，為URL中的數字與點組合（如10.1.1.176.341對應https://citeseerx.ist.psu.edu/viewdoc/summary?doi=10.1.1.176.341）。別名：none。
• cn：國內統一刊號。別名：CN。
• doi：數字對象標識符（DOI）；例如：10.1038/news070508-7。系統會驗證其是否以(10.)開頭。別名：DOI。
  • doi-broken：DOI在https://doi.org失效的日期。格式需與文中其他日期一致。別名：doi-broken-date、doi-inactive-date、doi_brokendate、doi_inactivedate。
• eissn：電子版國際標準期刊號；8位字元可用連字元分為兩組（不可用短橫線或空格）；範例|eissn=1557-2986。別名：EISSN。
• hdl：Handle系統數字對象標識符；範例|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：OCLC號用於在WorldCat聯合目錄檢索；範例|oclc=9355469。別名：oclc。
• ol：開放圖書館標識符；值中請勿包含「OL」；範例|ol=7030731M。別名：OL。
• OSTI：科技資訊辦公室；範例|osti=4367507。別名：osti。
• PMC：PubMed Central；使用開放獲取期刊文章編號，如|pmc=345678。值中請勿包含「PMC」。另見下方PMID參數，此為兩種不同標識符。別名：pmc。
  • embargo：PMC開放日期；若該日期在未來，則在此之前不會生成連結。別名：none。
• PMID：PubMed唯一標識符；範例|pmid=17322060另見上方PMC參數，此為兩種不同標識符。別名：pmid。
• 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=參數指定訪問狀態。

對於{{cite journal}}，當未使用|url=和|title-link=時，某些標識符（指定免費資源）會自動連結至標題。可透過|title-link=的特殊關鍵字（|title-link=pmc或|title-link=doi）手動選擇連結目標，或使用|title-link=none禁用此功能。

若標識符生成的連結與現有連結完全相同，則無需額外指定URL。此時|url=（或|title-link=）可用於提供直接文檔連結或便捷訪問連結。

網址（url）

• url：可獲取title指定出版物文本的在線地址。若title已添加內部連結則不可使用。如適用，連結可指向具體引用頁。需移除URL中的跟蹤參數（如#ixzz2rBr3aO94或?utm_source=google&utm_medium=...&utm_term=...&utm_campaign=...）。PDF檔案或Google圖書的頁面連結參見WP:PAGELINKS。請勿連結至商業售書網站（如亞馬遜），應使用|isbn=或|oclc=提供中立圖書檢索連結。含空格等無效URL將觸發錯誤提示。
  • access-date：最後驗證url內容支撐文中論述的完整日期；需配合url使用；格式需與其他訪問/存檔日期一致。不適用於內容不變的連結文檔。例如：無出版日期的個人網站等在線資源必須提供訪問日期（參見WP:CITEWEB），但已發表論文或書籍的連結無需提供。注意此日期僅表示驗證網址有效且支撐引文內容的日期。註冊用戶可隱藏或自訂樣式。別名：accessdate。
  • archive-url：網頁存檔快照的URL。通常指向互聯網檔案館（參見WP:使用時光機）或archive.today（參見en:Help:Using archive.today）等服務；需配合archive-date和url使用。預設（可被|url-status=live覆蓋）優先顯示存檔連結，原始連結置於末尾。別名：archiveurl。
    • archive-date：存檔服務快照日期；預設前綴「存檔於原頁面」。格式需與其他訪問/存檔日期一致。請勿添加內部連結；不建議使用模板日期。別名：archivedate。
    • url-status：控制參數，選擇透過|title=連結|url=或|archive-url=；需同時定義url和archive-url。無存檔網址時，使用{{dead link}}標記失效|url=。

      接受多組關鍵詞：

      • dead - （預設狀態）選擇|archive-url=
      • live - 選擇|url=；用於預防性存檔的連結
      • deviated - 選擇|archive-url=；用於原網址仍有效但不再支撐文中論述
      • unfit - 選擇|archive-url=；用於原網址指向賭博/色情/廣告/惡意軟件/釣魚等不良內容時，將隱藏原網址連結。若整個域名不可用，可考慮域名接管或黑名單，機械人輔助參見en:WP:URLREQ
      • usurped - 選擇|archive-url=；用於域名被劫持轉向不良內容時，將隱藏原網址連結
      • bot: unknown - 機械人無法判定網址狀態時遺留的值，頁面會自動歸入Category:CS1 maint: bot: original URL status unknown，編者需手動評估並修正參數值

    • archive-format：archive-url指向檔案的格式（如DOC/XLS），顯示在存檔連結後的括號內。HTML為預設格式無需指定，PDF會自動檢測無需指定。不影響外部連結圖標（PDF除外）。注意：連結圖標不含替代文本，故無法為視障用戶提供格式資訊（PDF因自動添加「(PDF)」描述文本而無此問題）。參見format參數用法
  • url-access：參見URL參數訪問指示
• format：url指向檔案的格式（如DOC/XLS），顯示在標題後的括號內。（媒體格式請用type參數。）HTML為預設格式無需指定，PDF會自動檢測無需指定。不影響外部連結圖標（PDF除外）。注意事項同archive-format。參見format參數用法

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指向檔案的格式（如PDF/DOC/XLS），顯示在chapter後的括號內。HTML為預設格式無需指定。不影響外部連結圖標。注意：連結圖標不含替代文本，無法為視障用戶提供格式資訊。

引文（quote）

• quote：從來源引用的相關文本。顯示為引號內文本。需包含終止標點（預設情況下引文會抑制引文終止符句號）。
  • script-quote：非拉丁文字引文（阿拉伯文、西里爾文等）。必須前綴支持的語言代碼以確保瀏覽器正確顯示：

    ... |script-quote=ja:東京タワー |trans-quote=东京塔 ...

  • trans-quote：外文引文的中文翻譯。顯示在方括號內。
• quote-page：|quote=所引用的單頁頁碼。使用|quote-page=或|quote-pages=二者之一。應為|page=、|pages=或|at=指定頁面的子集。
• 或：quote-pages：|quote=引用的頁面列表或範圍。使用|quote-page=或|quote-pages=二者之一。應為|pages=或|at=指定頁面的子集。用短橫線（–）分隔連續頁碼，用逗號（,）分隔非連續頁碼。

本字段的選項：

• |cs2=yes取消「引文需包含終止標點」的預設提示

通俗摘要（lay）

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

引用錨點（ref）

• ref：為簡短註腳建立錨點。預設不生成錨點。（詳見Help:引文格式1 § 錨點）
  • 特殊值|ref=harv會生成兼容{{harv}}、{{sfn}}模板的錨點格式。
  • 設置|ref=ID會生成指定ID的自訂錨點，可使用{{harvid}}模板。

顯示控制（display）

• mode：根據設定值調整元素分隔符、預設終止標點和特定大寫規則。|mode=cs1使用半角句號（.）作為分隔符和終止標點；|mode=cs2使用半角逗號（,）作為分隔符，無終止標點，特定單詞保持小寫。分別對應引文樣式1和樣式2。覆蓋預設終止標點請使用postscript參數。

• author-mask（作者掩碼）：
• contributor-mask（貢獻者掩碼）：
• editor-mask（編輯掩碼）：
• interviewer-mask（採訪者掩碼）：
• subject-mask（主題掩碼）：
• translator-mask（譯者掩碼）：

  用破折號或文本替換（首位）作者姓名。設為數字n時顯示n倍寬破折號；設為文本時直接顯示該文本（不帶後續分隔符，如「with」）。特殊值0需配合<name>-link使用，此時顯示連結文本。無論何種情況，仍需提供完整姓名以生成元數據。主要用於同一作者多部作品連續列出的參考文獻（如Template:Sfnote）。不可在{{reflist}}或<references />生成的列表中使用（因無法控制引用顯示順序）。可透過添加枚舉值（如|authorn-mask=）對特定姓名應用掩碼。

• display-authors（顯示作者數）：
• display-contributors（顯示貢獻者數）：
• display-editors（顯示編輯數）：
• display-interviewers（顯示採訪者數）：
• display-subjects（顯示主題數）：
• display-translators（顯示譯者數）：

  控制顯示的作者（或其他貢獻者）姓名數量。預設顯示全部姓名。例如|display-authors=2僅顯示前兩位作者（不影響其他貢獻者顯示）。特殊值|display-authors=0隱藏所有作者（包括「etal」）。|display-authors=etal顯示全部姓名後接「etal」。

• 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.  含有內容需登入檢視的頁面 (link)

命名標識符訪問指示

預設認為命名標識符連結需付費/註冊（例外見下）。若可免費訪問，需用對應參數添加圖標。若標識符僅提供摘要服務（無全文），則不可標記為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：地圖製作者，顯示為「製圖：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：會議名稱，若與location不同可包含地點資訊，若與date或year不同可包含日期。
  • conference-url：會議議程網址（若與url不同）。

註釋

上述文件嵌入自Template:Citation Style documentation/doc。 (編輯 | 歷史)
編者可以在本模板的沙盒 (建立 | 鏡像)和測試樣例 (建立)頁面進行實驗。
請在/doc子頁面中添加分類。 本模板的子頁面。