Template:Cite report/doc

引文格式1模板

{{Cite arXiv}}	arXiv預印本
{{Cite AV media}}	影音媒體
{{Cite AV media notes}}	影音媒體內頁說明
{{Cite bioRxiv}}	bioRxiv預印本
{{Cite book}}	書籍
{{Cite citeseerx}}	CiteSeerX論文
{{Cite conference}}	會議論文
{{Cite encyclopedia}}	引用百科全書的資料
{{Cite episode}}	廣播和電視節目
{{Cite interview}}	訪談
{{Cite journal}}	學術期刊
{{Cite magazine}}	雜誌和期刊
{{Cite mailing list}}	公共郵件列表
{{Cite map}}	地圖
{{Cite news}}	新聞報導
{{Cite newsgroup}}	線上新聞群組
{{Cite podcast}}	播客
{{Cite press release}}	新聞稿
{{Cite report}}	報告
{{Cite serial}}	廣播和電視節目系列
{{Cite sign}}	標誌、匾額、銘牌或徽章
{{Cite speech}}	演講
{{Cite ssrn}}	SSRN論文
{{Cite techreport}}	技術報告
{{Cite thesis}}	學位論文
{{Cite tweet}}	Twitter推文
{{Cite web}}	上述模板未包含的其他網路資料
參見	頁面訊息模板 引用模板

该引文格式1模板用于为reports by government departments, instrumentalities, operated companies, etc.创建引文

These reports are to be published in the Wikipedia sense of verifiability: a responsible organisation must have fact checked them; and the selection process for publication must not have been automatic.

Examples include: government printed reports which lack ISSN or ISBN numbers, and reports from major semi-governmental instrumentalities that are freely circulating and available for verification, but which lack a formal ISBN / ISSN publication process.

Usage

複製以下其中一個空白的版本來使用。所有參數名稱必須使用小寫。每個參數之間使用“|”（管道）字符分隔。刪除未使用的參數，以避免在編輯窗口出現。某些範例可能包括當前日期。如果不是當前的日期，請刷新。

橫式排列的全部參數

{{cite report |author= |author-link= |authors= |date= |title= |url= |publisher= |page= |docket= |access-date= |quote= }}

{{cite report
 | author      = <!-- or |last= and |first= -->
 | author-link =
 | authors     =
 | date        = <!-- or |year= -->
 | title       = 
 | url         = 
 | publisher   = 
 | format      =
 | others      =
 | edition     =
 | location    =
 | chapter     =
 | section     =
 | page        =
 | pages       =
 | docket      =
 | access-date = 
 | quote       =
}}

Parameters

Syntax

嵌套参数依赖于其母参数：

• 母参数
• 或者：母参数2—可以代替母参数使用
  • 子参数 —可以与母参数一同使用（若母参数填写，此参数将被忽略）
  • 或者：子参数2—可以代替子参数使用（若母参数2填写，此参数将被忽略）

在列出别名(aliases)的地方，只能定义一个参数；如果定义了多个别名参数(aliased parameters)，那么只有一个会被显示。

By default, sets of fields are terminated with a period (.); this can be an issue when the last field in an abbreviation or initial with a period, as two periods then display. The only solution is to not include the last period in the value for the set of fields.

COinS

该模板将COinS元数据嵌入HTML输出中，允许文献管理软件检索书目元数据。参见Wikipedia:COinS。。通常，每个参数只有一个数据项。不要包含说明性或替代性文字：

• use |date=27 September 2007 not |date=27 September 2007 (print version 25 September)

Use of templates within the citation template is discouraged because many of these templates will add extraneous HTML or CSS that will be included raw in the metadata. Also, HTML entities, for example  , –, etc, should not be used in parameters that contribute to the metadata. Do not include Wiki markup '' (italic font) or ''' (bold font) because these markup characters will contaminate the metadata.

COinS metadata is created for these parameters

Note: This table of metadata is displayed for all Citation Style 1 templates. Not all of these parameters are supported by every CS1 template. Some of these parameters are mutually exclusive, some are aliases of another parameter, and some require other parameters to be present. Please refer to each template's documentation for a full list of supported parameters, their aliases, and their dependencies.

• |periodical=, |journal=, |newspaper=, |magazine=, |work=, |website=, |encyclopedia=, |encyclopaedia=, |dictionary=
• |chapter=, |contribution=, |entry=, |article=, |section=
• |title=
• |publication-place=, |publicationplace=, |place=, |location=
• |date=, |year=, |publication-date=, |publicationdate=
• |series=, |version=
• |volume=, |issue=, |number=
• |page=, |pages=, |at=
• |edition=
• |publisher=, |distributor=, |institution=
• |url=, |chapter-url=, |chapterurl=, |contribution-url=, |contributionurl=, |section-url=, |sectionurl=
• |author#=, |author-last#=, |author#-last=, |last#=, |surname#=
• |author-first#=, |author#-first=, |first#=, |given#=
• any of the named identifiers: |isbn=, |issn=, |doi=, |pmc=, etc.

Deprecated

These parameters are deprecated and will no longer work. Use will place the page in Category:含有过时参数的引用的页面.

Use accessdate:

• access-date
• accessed
• accessdaymonth
• accessday
• accessmonthday
• accessmonth
• accessyear

Use date:

• day

No longer supported:

• dateformat
• doilabel

Description

Authors

• last: Surname of author. Do not wikilink—use authorlink instead. Where the surname is usually written first—as in Chinese—or for corporate authors, simply use last to include the same format as the source. Aliases: last, author, authors, last1, author1
  • first: Given or first names of author, including title(s); for example: Firstname Middlename or Firstname M. or Dr. Firstname M., Sr. Do not wikilink—use authorlink instead. Aliases: first, first1.
  • OR: for multiple authors, use last1, first1 through last9, first9 for up to nine authors. By default, if nine authors are defined, then only eight will show and "et al." will show in place of the last author. Aliases: last1, author1 through last9, author9.

• authorlink: Title of existing Wikipedia article about the author—not the author's website; do not wikilink. Aliases: authorlink, authorlink1, author-link, author1-link.
• OR: for multiple authors, use authorlink1 through authorlink9. Aliases: authorlink1, author1-link through authorlink9, author9-link.

• others: To record other contributors to the work, such as "Illustrated by John Smith" or "Translated by John Smith."

When using Template:Sfnote or Template:Paren styles with templates, do not use multiple names in one field else the anchor will not match the inline link.

Date

• date: Full date of source being referenced in the same format as other publication dates in the citations. Do not wikilink. Displays after the authors and enclosed in parentheses. If there is no author, then displays after publisher.
• OR: year: Year of source being referenced.
  • month: Name of the month of publication. If you also have the day, use date instead; do not wikilink.
  • origyear: Original publication year; displays after the date or year. For clarity, please supply specifics; example: |origyear=First published 1859 or |origyear=Composed 1904.

Editors

• editor-last: Surname of editor. Do not wikilink—use editor-link instead. Where the surname is usually written first—as in Chinese—or for corporate authors, simply use editor-last to include the same format as the source. Aliases: editor-last, editor1-last, editor, editors.
  • editor-first: Given or first names of editor, including title(s); example: Firstname Middlename or Firstname M. or Dr. Firstname M., Sr. Do not wikilink—use editor-link instead. Aliases: editor-first, editor1-first.
  • OR: for multiple editors, use editor1-last, editor1-first through editor4-last, editor4-first for up to four editors.

• editor-link: Title of existing Wikipedia article about the editor—not the editor's website; do not wikilink. Aliases: editor-link, editor1-link.
• OR: for multiple editors, use editor1-link through editor4-link.

Display:

If authors: Authors are first, followed by the included work, then "In" and the editors, then the main work.

If no authors: Editors appear before the included work; a single editor is followed by "ed."; multiple editors are followed by "eds."; more than three editors will be followed by "et al., eds."

Title

• title: Title of source. Can be wikilinked to an existing Wikipedia article or url may be used to add an external link, but not both. Displays in italics.
  • trans_title: English translation of the title if the source cited is in a foreign language. Displays in square brackets after title; if url is defined, then trans_title is included in the link. Use of the language parameter is recommended.

Titles containing certain characters will display and link incorrectly unless those characters are encoded.

newline	[	]	|
space	[	]	|

• language: The language the source is written in, if not English. Displays in parentheses with "in" before the language name. Use the full language name; do not use icons or templates.

URL

• url: URL of an online location where the text of the publication can be found. Cannot be used if title is wikilinked. If applicable, the link may point to the specific page(s) referenced. Do not link to any commercial booksellers such as Amazon.com; see WP:PAGELINKS.
  • accessdate: Full date when URL was accessed; use the same format as other access and archive dates in the citations; do not wikilink. Can be hidden by registered editors.
  • archiveurl: The URL of an archived copy of a web page, if or in case the url becomes unavailable. Typically used to refer to services like WebCite and the Internet Archive; requires archivedate.
    • archivedate: Date when the item was archived; use the same format as other access and archive dates in the citations; do not wikilink. Displays preceded by "archived from the original on".
    • deadurl: When the URL is still live, but preemptively archived, then set |deadurl=no. This changes the display order with the title retaining the original link and the archive linked at the end.
  • template doc demo: The archive parameters have error checking to ensure that all the required parameters are included, else {{citation error}} is invoked. On errors, main, help and template pages are placed into Category:Articles with incorrect citation syntax. Set |template doc demo=true to disable categorization; mainly used for documentation where the error is demonstrated.
• format: Format of the work referred to by url; examples: PDF, DOC, XLS; HTML is implied and should not be specified; displayed in parentheses after title. Does not change external link icon.

URLs must begin with a supported URI scheme: http:// and https:// will be supported by all browsers; irc://, ircs://, ftp://, news:, mailto: and gopher:// will require a plugin or an external application and should normally be avoided. IPv6 host-names are currently not supported.

If URLs in citation template parameters contain certain characters they will display and link incorrectly. Those characters need to be percent-encoded. For example, a space must be replaced by %20. To encode the URL, replace these characters:

sp	"	'	<	>	[	]	|	}
%20	%22	%27	%3c	%3e	%5b	%5d	%7c	%7d

Single apostrophes do not need to be encoded; but unencoded multiples will be parsed as italic or bold markup. Single curly closing braces also do not need to be encoded; but an unencoded pair will be parsed as the double closing braces for the template transclusion.

Periodical

• work: Name of the source periodical; may be wikilinked if relevant. Displays in italics. Aliases: work, journal, newspaper, magazine, periodical.
  • issue: When the publication is one of a series that is published periodically.
  • department: Regular department within the periodical. Displays after work and is in plain text.

When set, work changes the formatting of other parameters:

title is not italicized and is enclosed in quotes.

chapter is italicized and is not enclosed in quotes.

location and publisher are enclosed in parentheses.

page and pages do not show p. or pp.

edition does not display.

type does not display.

Publisher

• publisher: Name of publisher; may be wikilinked if relevant. Not normally included for periodicals. Corporate designations such as "Ltd", "Inc" or "GmbH" are not usually included. Displays after title; if work is defined, then publisher and location are enclosed in parentheses.
• location: Geographical place of publication; generally not wikilinked; omit when the name of the work includes the location; examples: The Boston Globe, The Times of India. Displays preceding publisher.
• publication-date: Date of publication when different from the date the work was written. Displays only if year or date are defined and only if different, else publication-date is used and displayed as date. Use the same format as other dates in the article; do not wikilink. Follows publisher; if work is not defined, then publication-date is preceded by "published" and enclosed in parenthesis.

Edition, series, volume

• edition: When the publication has more than one edition; for example: "2nd", "Revised" etc. Displays " ed." after this field, so |edition=2nd produces "2nd ed." Does not display if a periodical field is defined.

• series or version: When the source is part of a series, such as a book series or a journal where the issue numbering has restarted.

• volume: For one publication published in several volumes. Displays in bold after the title and series fields; if bolding is not desired, then include the volume information in the title field.

In-source locations

• page: Page in the source that supports the content. Displays preceded with p. unless |nopp=y or work is defined.
• OR: pages: Pages in the source that supports the content; separate page ranges with an en dash (–); separate non-sequential pages with a comma (,); do not use to indicate the total number of pages in the source. Displays preceded with pp. unless |nopp=y or work is defined.
  • nopp: Set to y to suppress the p. or pp. notations where this is inappropriate; for example, where |page=Front cover.
• OR: at: For sources where a page number is inappropriate or insufficient. Overridden by |page= or |pages=.

Examples: page (p.) or pages (pp.); section (sec.), column (col.), paragraph (para.); track; hours, minutes and seconds; act, scene, canto, book, part, folio, stanza, back cover, liner notes, indicia, colophon, dust jacket, verse.

Identifiers

• id: A unique identifier, used where none of the specialized identifiers are applicable; wikilink or use a template as applicable.
• docket: Docket number.

• arxiv: ArXiv.
• asin: Amazon Standard Identification Number.
  • asin-tld: ASIN top-level domain for Amazon sites other than the US; valid values: co.jp, co.uk, ca, cn, fr, de, it, es
• bibcode: Bibcode; used by a number of astronomical data systems; example: 1924MNRAS..84..308E.
• doi: DOI; example: 10.1038/news070508-7; checked to ensure it begins with 10.; if not an error shows and the page is placed in Category:含有DOI错误的引用的页面.
  • doi_brokendate: Date the DOI is broken; use the same format as other dates in the article.
• isbn: International Standard Book Number such as 978-0812695939; see Wikipedia:ISBN and ISBN. Dashes in the ISBN are optional, but preferred. Use the 13-digit ISBN where possible; this can normally be found beneath the barcode as a number beginning 978 or 979. For sources with the older 9 digit SBN system, prefix the number with a zero; thus SBN 812695-93-3 should be entered as |isbn=0812695-93-3.
• issn: International Standard Serial Number; eight characters may be split into two groups of four using a hyphen, but not an N-dash or a space.
• jfm: Jahrbuch über die Fortschritte der Mathematik.
• jstor: JSTOR abstract.
• lccn: Library of Congress Control Number.
• mr: Mathematical Reviews.
• oclc: Online Computer Library Center.
• ol: Open Library.
• osti: Office of Scientific and Technical Information.
• pmc: PubMed Central article number for full-text free repository of an article.
• pmid: PubMed Unique Identifier.
• rfc: Request for Comments.
• ssrn: Social Science Research Network.
• zbl: Zentralblatt MATH.

Lay summary

• laysummary: URL link to a non-technical summary or review of the source; the URL title is set to "Lay summary".
  • laysource: Name of the source of the laysummary. Displays in italics and preceded by an endash.
  • laydate: Date of the summary. Displays in parentheses.

Quote

• quote: Relevant text quoted from the source. Displays enclosed in quotes. When supplied, the citation terminator (a period by default) is suppressed, so the quote needs to include terminating punctuation.

Anchor

• ref: ID for anchor. By default, no anchor is generated. The ordinary nonempty value |ref=ID generates an anchor with the given ID; such a linkable reference can be made the target of wikilinks to full references, especially useful in short citations like shortened notes and parenthetical referencing. The special value |ref=harv generates an anchor suitable for the {{harv}} template; see anchors for Harvard referencing templates.

Display options

• author-mask: Replaces the name of the first author with em dashes or text. Set author-mask to a numeric value to set the dash in em spaces; set author-mask to a text value to display a word instead; for example, "with". You must still include the values for all authors for metadata purposes. Primarily intended for use in bibliographies for some styles where multiple works by a single author are listed. Do not use in a list generated by {{reflist}}, <references /> or similar as there is no control as to the order that references will display.
• author-name-separator: Changes the separator between last and first names; defaults to a comma and space (, ); if the parameter is present, but blank, no separator punctuation will be used; a space must be encoded as   do not use an asterisk (*), colon (:) or hash (#) as they will be interpreted as wikimarkup.
• author-separator: Changes the separator between authors; defaults to a semicolon and space (; ); if the parameter is present, but blank, no separator punctuation will be used; a space must be encoded as   do not use an asterisk (*), colon (:) or hash (#) as they will be interpreted as wikimarkup.
• display-authors: By default, the number of authors displayed is limited to 8; if 9 are provided, the ninth is displayed as "et al." This parameter allows display of fewer authors before the "et al."; example: |display-authors=2; "et al." may be suppressed altogether by setting |display-authors=9.
• lastauthoramp: When set to any value, changes the separator to use between the last two names in lists of authors to an ampersand (&); defaults to a semicolon and space (; ), else author-separator if set.
• postscript: The closing punctuation for the citation; defaults to a period (.); if the parameter is present, but blank, no terminating punctuation will be used. Ignored if quote is defined.
• separator: The punctuation used to separate lists of authors, editors, etc. Defaults to a period (.); if the parameter is present but blank, no separator punctuation will be used; do not use an asterisk (*), colon (:) or hash (#) as they will be interpreted as wikimarkup.

This template produces COinS metadata; see COinS in Wikipedia for background information.

TemplateData

以下是该模板的模板数据，适用于可视化编辑器等工具。

Cite report模板数据

This template formats a citation to an article in a magazine or journal, using the provided source information (e.g. journal name, author, title, issue, URL) and various formatting options.

模板参数

参数		描述	类型	状态
URL	url URL	The URL of the online location where the text of the publication can be found	单行文本	推荐
Title	title	The title of the article; can be wikilinked to an existing Wikipedia article or url may be used to add an external link, but not both. Displays in quotes.	内容	必需
Last name	last author author1 authors last1	The surname of the author; don't wikilink, use 'authorlink'; can suffix with a numeral to add additional authors	单行文本	推荐
First name	first first1	Given or first name, middle names, or initials of the author; don't wikilink, use 'authorlink'; can suffix with a numeral to add additional authors	单行文本	推荐
Last name 2	last2 author2	The surname of the second author; don't wikilink, use 'authorlink2'.	单行文本	可选
First name 2	first2	Given or first name, middle names, or initials of the second author; don't wikilink.	单行文本	可选
Source date	date	Full date of the source; do not wikilink	日期	必需
Publisher	publisher	Name of the publisher; displays after title	内容	可选
Issue	issue	Issue identifier when the source is part of a series that is published periodically	单行文本	推荐
DOI	doi	Digital Object Identifier; begins with '10.'	字符串	推荐
DOI broken date	doi-broken-date	The date that the DOI was determined to be broken	日期	可选
Location of publication	location	Geographical place of publication; usually not wikilinked.	字符串	可选
Publication date	publication-date	Date of publication when different from the date the work was written; do not wikilink	日期	可选
Edition	edition	When the publication has more than one edition; for example: '2nd', 'Revised' etc.; suffixed with ' ed.'	单行文本	可选
Volume	volume	For one publication published in several volumes	单行文本	推荐
Page	page	Page in the source that supports the content; displays after 'p.'	单行文本	可选
Pages	pages	Pages in the source that support the content (not an indication of the number of pages in the source; displays after 'pp.'	单行文本	可选
Language	language	The language in which the source is written, if not English; use the full language name; do not use icons or templates	内容	可选
arXiv identifier	arxiv	An identifier for arXive electronic preprints of scientific papers	单行文本	可选
ASIN	asin	Amazon Standard Identification Number; 10 characters	单行文本	可选
ASIN TLD	asin-tld	ASIN top-level domain for Amazon sites other than the US	单行文本	可选
Bibcode	bibcode	Bibliographic Reference Code (REFCODE); 19 characters	单行文本	可选
biorXiv	biorxiv	biorXiv identifier; 6 digits	单行文本	可选
CiteSeerX	citeseerx	CiteSeerX identifier; found after the 'doi=' query parameter	单行文本	可选
ISBN	isbn	International Standard Book Number; use the 13-digit ISBN where possible	单行文本	可选
ISSN	issn	International Standard Serial Number; 8 characters; may be split into two groups of four using a hyphen	单行文本	可选
jfm code	jfm	Jahrbuch über die Fortschritte der Mathematik classification code	单行文本	可选
JSTOR	jstor	JSTOR identifier	单行文本	可选
LCCN	lccn	Library of Congress Control Number	单行文本	可选
MR	mr	Mathematical Reviews identifier	单行文本	可选
OCLC	oclc	Online Computer Library Center number	数字	可选
OL	ol	Open Library identifier	单行文本	可选
OSTI	osti	Office of Scientific and Technical Information identifier	单行文本	可选
PMC	pmc	PubMed Center article number	数字	可选
PMID	pmid	PubMed Unique Identifier	单行文本	推荐
id	id	A unique identifier used where none of the specialized ones are applicable	单行文本	可选
docket	docket	Docket number	单行文本	可选
Quote	quote	Relevant text quoted from the source; displays last, enclosed in quotes; needs to include terminating punctuation	内容	可选
Last name 3	last3 author3	The surname of the third author; don't wikilink, use 'authorlink3'.	单行文本	可选
First name 3	first3	Given or first name, middle names, or initials of the third author; don't wikilink.	单行文本	可选
Last name 4	last4 author4	The surname of the forth author; don't wikilink, use 'authorlink4'.	单行文本	可选
First name 4	first4	Given or first name, middle names, or initials of the forth author; don't wikilink.	单行文本	可选
Last name 5	last5 author5	The surname of the fifth author; don't wikilink, use 'authorlink5'.	单行文本	可选
First name 5	first5	Given or first name, middle names, or initials of the fifth author; don't wikilink.	单行文本	可选
Last name 6	last6 author6	The surname of the sixth author; don't wikilink, use 'authorlink6'.	单行文本	可选
First name 6	first6	Given or first name, middle names, or initials of the sixth author; don't wikilink.	单行文本	可选
Last name 7	last7 author7	The surname of the seventh author; don't wikilink, use 'authorlink7'.	单行文本	可选
First name 7	first7	Given or first name, middle names, or initials of the seventh author; don't wikilink.	单行文本	可选
Last name 8	last8 author8	The surname of the eighth author; don't wikilink, use 'authorlink8'.	单行文本	可选
First name 8	first8	Given or first name, middle names, or initials of the eighth author; don't wikilink.	单行文本	可选
Last name 9	last9 author9	The surname of the ninth author; don't wikilink, use 'authorlink9'. If nine authors are defined, then only eight will show and 'et al.' will show in place of the last author.	单行文本	可选
First name 9	first9	Given or first name, middle names, or initials of the ninth author; don't wikilink.	单行文本	可选
Author link	author-link authorlink	Title of existing Wikipedia article about the author; can suffix with a numeral to add additional authors	页面名称	可选
Author link 2	author-link2 author2-link authorlink2	Title of existing Wikipedia article about the second author.	页面名称	可选
URL access date	access-date accessdate	The full date when the original URL was accessed; do not wikilink	日期	推荐
Archive URL	archive-url archiveurl	The URL of an archived copy of a web page, if or in case the URL becomes unavailable; requires 'archivedate'	单行文本	可选
Archive date	archive-date	Date the url in the field 'archive-url' was archived. 示例值 2018-01-24	日期	可选
Author link 3	author-link3 author3-link authorlink3	Title of existing Wikipedia article about the third author.	页面名称	可选
Author link 4	author-link4 author4-link authorlink4	Title of existing Wikipedia article about the forth author.	页面名称	可选
Author link 5	author-link5 author5-link authorlink5	Title of existing Wikipedia article about the sixth author.	页面名称	可选
Author link 6	author-link6 author6-link authorlink6	Title of existing Wikipedia article about the sixth author.	页面名称	可选
Author link 7	author-link7 author7-link authorlink7	Title of existing Wikipedia article about the seventh author.	页面名称	可选
Author link 8	author-link8 author8-link authorlink8	Title of existing Wikipedia article about the eighth author.	页面名称	可选
Author link 9	author-link9 author9-link authorlink9	Title of existing Wikipedia article about the ninth author.	页面名称	可选
Format	format	Format of the work referred to by 'url' ('url' is required when using 'format'); examples: PDF, DOC, XLS; do not specify HTML	内容	可选
URL access level	url-access	Classification of the access restrictions on the URL ('registration', 'subscription' or 'limited')	字符串	可选
Bibcode access level	bibcode-access	If the full text is available from ADS via this Bibcode, type 'free'.	字符串	可选
DOI access level	doi-access	If the full text is free to read via the DOI, type 'free'.	字符串	可选
HDL access level	hdl-access	If the full text is free to read via the HDL, type 'free'.	字符串	可选
Jstor access level	jstor-access	If the full text is free to read on Jstor, type 'free'.	字符串	可选
OpenLibrary access level	ol-access	If the full text is free to read on OpenLibrary, type 'free'.	字符串	可选
HDL access level	osti-access	If the full text is free to read on OSTI, type 'free'.	字符串	可选