跳至內容

模板: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=}}

上述參數是按上下文邏輯而非字母順序排列的。以下參數雖然通常至少在某些引用模板中可用,但未包含在上述完整參數集中:authorsbook-titleclassdegreedocketencyclopediamailing-listmessage-idnumberpublication-datesectionsheetsheetstitle-links2cid

橫式排列的最常用參數

[編輯]
  • {{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;)。
以下參數參與生成COinS元數據

註:以下列表顯示在所有CS1模板的文檔中。並非所有CS1模板都支持全部參數。部分參數互斥,部分互為別名,還有些參數需要其他參數配合使用。本模板支持的完整參數列表、別名及其依賴關係詳見本文檔頂部附近的使用方法章節。

  • periodicaljournalnewspapermagazineworkwebsiteencyclopediaencyclopaediadictionary
  • chapterscript-chaptercontributionscript-contributionentryscript-entryarticlescript-articlesectionscript-section
  • titlescript-titlebook-title
  • publication-placeplacelocation
  • dateyearpublication-date
  • seriesversion
  • volumeissuenumber
  • pagepagesatquote-pagequote-pages
  • edition
  • publisherinstitution
  • urlchapter-urlcontribution-urlsection-url
  • author-lastauthor-last#author#-lastauthor-surnameauthor-surname#author#-surnamelastlast#surnamesurname#authorauthor#subjectsubject#hosthost#
  • author-firstauthor-first#author#-firstauthor-givenauthor-given#author#-givenfirstfirst#givengiven#
  • degree
  • arxivbibcodebiorxivciteseerxdoieissneprinthdlisbnissnjfmjstorlccnmessage-idmroclcostipmcpmidrfcssrns2cidzbl

句號分隔符(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參數。別名:surnamelast1surname1
    • first:作者的名字(一般用於英文人名);例如:「John Michael」或「J. M.」。如需添加內部連結,請使用author-link參數。別名:givenfirst1given1。必須與last參數配合使用;若last參數為空則不顯示名字。
    • 或者:多位作者時使用author1authorn(中文人名)或last1first1lastnfirstn(英文人名),其中n為任意連續數字,支持無限數量的作者(每個firstn需要對應的lastn,但反之不成立)。參見display參數來調整顯示作者數量。別名:surname1given1surnamengivenn
    • author-link:作者的維基百科條目名稱,而非作者個人網站;僅填寫條目名稱即可,無需特殊語法。別名:author-link1author1-linkauthorlink
    • 或者:多位作者時使用author-link1author-linkn。別名:author1-linkauthorn-link
    • name-list-style:(罕用)姓名顯示格式。設為amp&時,用「&」連接最後兩位作者;設為vanc時,按溫哥華格式顯示姓名列表(需使用last/first參數填寫姓名)。
  • vauthors溫哥華格式的作者列表(用逗號分隔);機構名需用雙括號包裹,如:|vauthors=Smythe JB, ((Megabux Corp.)), etal
    • author-linkauthor-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-surnameeditor1-lasteditor-last1
    • editor-first:編者的名字(一般用於英文人名);例如:「John Michael」或「J. M.」。如需添加內部連結,請使用editor-link參數。別名:editor-giveneditor1-firsteditor-first1。必須與editor-last參數配合使用;若editor-last參數為空則不顯示名字。
    • 或者:多位編者時使用editor1editorn(中文人名)或editor-last1editor-first1editor-lastneditor-firstn(英文人名),其中n為任意連續數字(每個editor-firstn需要對應的editor-lastn,但反之不成立)。別名:editor-surname1editor-given1editor-surnameneditor-givenn
    • editor-link:編者的維基百科條目名稱,而非編者個人網站;請勿添加內部連結。別名:editor-link1editor1-link
    • 或者:多位編者時使用editor-link1editor-linkn(別名editorn-link)。
    • name-list-style:接受有限的關鍵詞值:設為amp&時,在姓名列表最後兩個名字間插入「&」符號;設為vanc時,當姓名參數採用last/first格式時,按溫哥華格式顯示姓名列表。
  • veditors溫哥華格式的逗號分隔編者列表;機構名稱需用雙括號包裹。如適用可添加etal:
    |veditors=Smythe JB, ((Megabux Corp.)), etal
    • editor-linkneditor-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-linktitle所指來源的維基百科條目標題。若需添加外部連結請改用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將不顯示,並會生成錯誤提示。別名:journalnewspapermagazineperiodicalwebsite
    • script-work:原文出版物名稱(非拉丁文字)。必須前綴支持的語言代碼以確保瀏覽器正確顯示。拉丁文字出版物(捷克語、法語、土耳其語、越南語等)留空。別名:script-journalscript-newspaperscript-magazinescript-periodicalscript-website
    • trans-work:外文出版物名稱的中文翻譯。顯示在workscript-work後的方括號內。別名:trans-journaltrans-newspapertrans-magazinetrans-periodicaltrans-website
  • issue:連續出版物的期號。若該期有專屬標題,可連同期號一併給出,例如|issue=2, 現代加拿大文學。別名:number,根據出版物實際用詞選擇。若同時存在兩種編號(通常一種按年編號,一種絕對編號),可合併標註(如|issue=2 #143)。顯示在括號內,跟隨volume之後。
  • article-number:期刊為每篇文章分配的文章編號;顯示在卷號/期號和頁碼之間。
  • department:期刊或雜誌中的常設欄目名稱。例如「通訊」、「社論」、「讀者來信」和「評論」。顯示在title之後,以純文本形式呈現。
本字段的選項:
  • |article_num=yes 顯示article_num參數的說明。
  • |department=yes 顯示department參數的說明。

版本(edition)

[編輯]

[編輯子模板]

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

系列(series)

[編輯]

[編輯子模板]

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

劇集(series_episode)

[編輯]

[編輯子模板]

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

活動(event)

[編輯]

[編輯子模板]

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

通訊社(agency)

[編輯]

[編輯子模板]

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

卷號(volume)

[編輯]

[編輯子模板]

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

日期(date)

[編輯]

[編輯子模板]

  • date:引用來源的發布日期。可以是完整日期(年、月、日)或部分日期(年和月、年和季節或僅年份)。完整的年月日應當使用「YYYY-MM-DD」格式(如2025-06-03)。請勿添加內部連結。日期顯示在作品載體和出版商之後。
使用簡短註腳英語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:列明來源中的寫法);城市名稱有歧義,或不知名,宜附省/州名或國名。通常不添加內部連結。當出版物名稱已包含出版地時可省略(如《波士頓環球報》《印度時報》)。若地名與來源發表時不同,請使用出版物上標註的地名或來源發表時的地名。顯示在標題之後。別名:locationplace
    • 目前placelocation嚴格來講是新聞報道電頭英語Dateline中的報道撰寫地參數,但為了兼容性考慮,當未定義publication-place時仍將其作為出版地顯示。具體規則:若僅定義了publication-placeplacelocation其中之一,將作為出版地顯示在標題後;若同時定義了publication-placeplace/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

  • arxivarXiv標識符;例如:|arxiv=hep-th/9205027(2007年4月前)或|arxiv=0706.0001(2007年4月—2014年12月)或|arxiv=1501.00001(2015年1月起)。請勿包含「.pdf」或「.html」等無關檔案擴展名。別名:ARXIVeprint
  • asin亞馬遜標準識別號碼;若首字元為數字,請使用isbn。由於此連結偏向特定分銷商,僅在無標準標識符時使用。例如:|asin=B00005N5PF。別名:ASIN
    • ASIN-TLD:非美國亞馬遜網站的頂級域名。別名:asin-tld
  • bibcodebibcode;用於多個天文數據系統;例如:1974AJ.....79..819H。別名:BIBCODE
  • biorxivbioRxiv標識符,需完整DOI(如10.1101/078733對應http://biorxiv.org/content/early/2016/10/01/078733或https://doi.org/10.1101/078733)。別名:無。
  • citeseerxCiteSeerX標識符,為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-datedoi-inactive-datedoi_brokendatedoi_inactivedate
  • eissn:電子版國際標準期刊號;8位字元,通常用連字元分為兩組;例如:|eissn=1557-2986。別名:EISSN
  • hdlHandle系統英語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」)及校驗碼。別名:ISBNisbn13ISBN13
  • ismn國際標準音樂編號;例如:979-0-9016791-7-7連字元或空格可選。請使用作品印刷的ISMN。此參數應僅包含ISMN不包含其他字元。系統會校驗長度、非法字元及校驗碼。別名:ISMN
  • issn國際標準期刊號;8位字元,通常用連字元分為兩組;例如:|issn=2049-3630。別名:ISSN
  • jfm數學進展年鑑英語Jahrbuch über die Fortschritte der Mathematik;值中請勿包含「JFM」;例如:|jfm=53.0144.01。別名:JFM
  • jstorJSTOR標識符;例如:|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
  • PMCPubMed Central文章編號;不包含「PMC」,如|pmc=345678與下方的PMID參數不同。別名:pmc
    • embargoPMC開放日期;在此日期之前不會生成連結。別名:無。
  • PMIDPubMed唯一標識符;例如:|pmid=17322060與上方的PMC參數不同。別名:pmid
  • RFCRFC(請求意見稿)編號;例如:|rfc=3143。別名:rfc
  • SSRNSSRN;例如:|ssrn=1900856。別名:ssrn
  • s2cid語義學者語料庫ID;例如:|s2cid=37220927。別名:S2CID
  • unified統一書號。別名:csbnCSBN
  • 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-dateurl使用。預設優先顯示存檔連結,原始連結置於末尾(可透過設置|url-status=live優先顯示原始連結)。別名:archiveurl
      • archive-date:存檔服務快照日期;預設前綴「原始內容存檔於」。格式為「YYYY-MM-DD」。別名:archivedate
      • url-status:控制|title=的標題文字連結至|url=還是|archive-url=;需同時定義urlarchive-url。網址無存檔時,使用{{dead link}}標記連結已失效。標註連結是否失效曾使用dead-url參數:yes表示已失效,no表示未失效。
        接受多組關鍵詞:
        • dead—(預設狀態)連結至|archive-url=
        • live—連結至|url=;用於預防性存檔的連結
        • deviated—連結至|archive-url=;用於原網址仍可訪問但不再支撐文中論述
        • unfitusurped—連結至|archive-url=;用於原網址已被劫持用於垃圾資訊、廣告或不適合展示時,原網址連結被將隱藏
      • archive-formatarchive-url指向檔案的格式(如DOC、XLS),用法同format
    • url-access詳見URL參數訪問指示
  • formaturl指向檔案的格式(如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:可獲取chaptercontribution指定文本的在線地址。若這些參數已添加內部連結則不可使用。如已填寫url,應與其屬於同一站點。使用chapter-url時,僅當著作起始部分與被引章節位於站點不同網頁時才需使用url。別名:contribution-urlsection-url
  • chapter-formatchapter-url指向檔案的格式(如DOC、XLS),顯示在chapter後的括號內。HTML為預設格式無需指定,PDF會自動檢測無需指定。不影響外部連結圖標

引文(quote)

[編輯]

[編輯子模板]

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

通俗摘要(lay)

[編輯]

[編輯子模板]

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

引用錨點(ref)

[編輯]

[編輯子模板]

顯示選項(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. 
標識符訪問指示
[編輯]

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

命名標識符與訪問指示
標識符 訪問參數 允許值
|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參數。
    • 或:多位受訪者時使用firstnlastn組合。
  • subject-link:受訪者維基百科條目標題——非個人網站;請勿添加內部連結。別名:subject-linkauthor-linkauthor-linknsubject-linknauthorn-link
  • 或:多位受訪者時使用subject-linkn
別名:subjectlastlastnauthornauthorsubjectn

採訪者(interview_interviewer)

[編輯]

[編輯子模板]

  • interviewer-last:單個採訪者的姓氏。請勿添加內部連結——應改用interviewer-link。對於來源中僅列出一個名稱的採訪者,可直接使用interviewer或其別名(如|interviewer=Bono)。別名:interviewer-last1interviewer1-lastinterviewer-surnameinterviewer-surname1interviewer1-surnameinterviewerinterviewer1
    • interviewer-first:採訪者的名字或教名;例如:「Firstname Middlename」或「Firstname M.」或「Firstname M., Sr.」。請勿添加內部連結——應改用interviewer-link。別名:interviewer-first1interviewer1-firstinterviewer-giveninterviewer-given1interviewer1-given。必須與interviewer-last配合使用;若interviewer-last為空則不顯示名字。
    • interviewer:此參數用於填寫單個採訪者的全名(包含名和姓)。不可填寫多個採訪者姓名。
    • 多位採訪者時,使用interviewer-last1interviewer-first1interviewer-lastninterviewer-firstn,其中n為任意連續數字(每個interviewer-firstn需要對應的interviewer-lastn,但反之不成立)。參見display參數調整顯示的採訪者數量interviewer-last1interviewer-lastn的別名:interviewer1interviewern。如需同時標註全名採訪者和單名採訪者,可使用|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不同)。