Changes
Jump to navigation
Jump to search
→Common issues: ce
{{Wikipedia how to|WP:CS1|HELP:CS1}}
{{Nutshell|This is an introductory how-to for Wikipedia's most frequently used citation style. It does not cover every option of every citation template. See individual templates' documentation (e.g. at [[Template:Cite journal]]) for details beyond this basic cheatsheet.}}
{{notice|image=Gnome-applications-science.svg|This help page has {{subpages|testcases|Help:Citation Style 1}} demonstrating various uses.}}
'''Citation Style 1''' ('''CS1''') is a collection of [[Wikipedia:Citing sources|reference citation]] [[Help:Template|templates]] that can be modified to create different styles for different referenced materials. Its purpose is to provide a set of default formats for references on Wikipedia. It includes a series of templates that in turn use [[Module:Citation/CS1]].
The use of CS1 or of templates is not compulsory; per [[WP:CITEVAR]]:
<blockquote>Wikipedia does not have a single [[style guide|house style]]. Editors may choose any option they want; one article need not match what is done in other articles or what is done in professional publications or recommended by academic [[style guide]]s. However, citations ''within a given article'' should follow a consistent style.</blockquote>
CS1 uses elements of ''[[The Chicago Manual of Style]]'' and the ''[[APA style|Publication Manual of the American Psychological Association]]'', with significant adaptations.
==Style==
There are a number of templates that use a name starting with ''cite''; many were developed independently of CS1 and are not compliant with the CS1 style. There are also a number of templates that use one of the general use templates as a meta-template to cite a specific source.
To be compliant with CS1, a template must:
* Use [[Module:Citation/CS1]] or one of the templates listed below.
* Use a period as a punctuation mark to separate fields and end the citation.
* Use a semicolon as a punctuation mark to separate authors and editors.
* Format the title of longer works in italics.
* Format the title of short works such as chapters in quotes.
==Templates==
===General use===
The following is a list of templates that implement Citation Style 1 for one or more types of citations but are not restricted to any specific source.
{| class="wikitable" style="max-width:715px"
| {{Yes}} || Indicates that the corresponding tool or gadget can generate the template anytime user wishes. However, this does not mean that the tool or gadget fully supports all parameters or provides an interface for them. In fact, none of the mentioned items do so.
|-
| {{Partial|Sometimes}} || Indicates that the corresponding tool or gadget may or may not generate the corresponding template. For more information, see associated footnote.
|}
{| class="wikitable" style="text-align: center;"
|+ General use CS1 templates
! Template !! Use !! [[Wikipedia:The Wikipedia Library/Citoid|Citoid]] !! [[WP:Citation expander|Citation expander]] gadget !! [[WP:RefToolbar/1.0|RefToolbar 1.0]] !! [[WP:RefToolbar/2.0|RefToolbar 2.0]] !! [[Wikipedia:ProveIt|ProveIt]] || [[User:Odie5533/SnipManager|SnipManager]] || [[WP:Cite4Wiki|Cite4Wiki]] (inactive)
|-
| {{tl|Cite arXiv}} || [[arXiv]] preprints || || || || || || ||
|-
| {{tl|Cite AV media}} || audio and visual sources || || || || || {{Yes}} || {{Yes}} ||
|-
| {{tl|Cite AV media notes}} || liner notes from albums, DVDs, CDs and similar audio-visual media || || || || || || ||
|-
| {{tl|Cite book}} || books || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} ||
|-
| {{tl|Cite conference}} || conference papers || || || || || {{Yes}} || ||
|-
| {{tl|Cite encyclopedia}} || edited collections || || || || || {{Yes}} || ||
|-
| {{tl|Cite episode}} || television or radio programs and episodes || || || || || {{Yes}} || ||
|-
| {{tl|Cite interview}} || interviews || || || || || || ||
|-
| {{tl|Cite journal}} || academic and scientific papers and journals || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Partial|Sometimes}}{{efn|[[WP:Cite4Wiki|Cite4Wiki]] uses {{tl|Cite web}} by default, but has been customized to use {{tl|Cite news}}, etc., for certain specific sources, and can be further customized in this manner.}}
|-
| {{tl|Cite magazine}} || magazines and newsletters || || || || || {{Yes}} || ||
|-
| {{tl|Cite mailing list}} || archived public mailing lists || || || || || || ||
|-
| {{tl|Cite map}} || maps || || || || || || ||
|-
| {{tl|Cite news}} || news articles in print, video, audio or web || {{Yes}} || {{Partial|Sometimes}}<br />{{Elucidate}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Partial|Sometimes}}<br />{{Elucidate}}
|-
| {{tl|Cite newsgroup}} || online newsgroups || || || || || || ||
|-
| {{tl|Cite podcast}} || audio or video [[podcast]] || || || || || || ||
|-
| {{tl|Cite press release}} || press releases || || || {{Yes}} || || {{Yes}} || ||
|-
| {{tl|Cite report}} || unpublished reports by government departments, instrumentalities, operated companies, etc. || || || || || || ||
|-
| {{tl|Cite serial}} || audio or video serials || || || || || || ||
|-
| {{tl|Cite sign}} || signs, plaques and other visual sources || || || || || {{Yes}} || ||
|-
| {{tl|Cite speech}} || speeches || || || || || || ||
|-
| {{tl|Cite techreport}} || technical reports || || || || || || ||
|-
| {{tl|Cite thesis}} || theses || || || || || {{Yes}} || ||
|-
| {{tl|Cite web}} || web sources not characterized by another template || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|}
{{notelist}}
===Specific source===
There are a number of templates that are CS1 compliant, because they use a CS1 template as a base, but are tied to a specific source; these are listed in [[:Category:Citation Style 1 specific-source templates]].
==How the templates work==
CS1 uses a series of templates that provide a consistent output. The main difference is in parameters optimized for the subject. For example, {{tl|cite book}} has fields for title and chapter, whereas {{tl|cite journal}} has fields for journal and title.
This help page uses the names most commonly used across the templates series; see each template's documentation for details.
CS1 templates present a citation generally as:
* With author:
:{{Cite journal |last=Author |date=n.d. |title=Title |work=Work |publisher=Publisher |id=Identifiers |template-doc-demo=true}}
* Without author:
:{{Cite journal |date=n.d. |title=Title |work=Work |publisher=Publisher |id=Identifiers |template-doc-demo=true}}
(where "n.d." could also be any other valid date formatted per the MOS)
===Authors===
An author may be cited using separate parameters for the author's surname and given name by using {{para|last}} and {{para|first}} respectively. If a cited source has multiple authors, subsequent authors can be listed in the citation using {{para|last2}} and {{para|first2}}, {{para|last3}} and {{para|first3}}, etc. as shown in the following example:<ref group=Note>The number of authors that can be listed in the citation and displayed when published is unlimited.</ref>
:<code><nowiki>{{cite book |last=Hawking |first=Stephen |last2=Hawking |first2=Lucy |title=George's Secret Key to the Universe}}</nowiki></code>
:{{cite book |last=Hawking |first=Stephen |last2=Hawking |first2=Lucy |title=George's Secret Key to the Universe}}
If a cited source has a large number of authors, one can limit the number of authors displayed when the citation is published by using the {{para|display-authors}} parameter as described in detail in the [[Help:Citation Style 1#Display options|Display options]] section of this help page.
If a cited author is notable and the author has a Wikipedia article, the author's name can be linked with {{para|author-link}}. If a citation includes multiple notable authors, one may use {{para|author-link2}}, {{para|author-link3}}, etc. This method is used because {{para|last}} and {{para|first}} do not allow wikilinking. Please note that {{para|author-link}} cannot be used to link to an external website; the external link will not render correctly. Below is an example of a wikilinked author credit:
:<code><nowiki>{{cite book |last=Hawking |first=Stephen |author-link=Stephen Hawking |last2=Hawking |first2=Lucy |title=George's Secret Key to the Universe}}</nowiki></code>
:{{cite book |last=Hawking |first=Stephen |author-link=Stephen Hawking |last2=Hawking |first2=Lucy |title=George's Secret Key to the Universe}}
When an author is cited, the date of the cited work is displayed after the author's name, as shown in the example below:
:<code><nowiki>{{cite book |last=Hawking |first=Stephen |author-link=Stephen Hawking |last2=Hawking |first2=Lucy |title=George's Secret Key to the Universe |year=2007}}</nowiki></code>
:{{cite book |last=Hawking |first=Stephen |author-link=Stephen Hawking |last2=Hawking |first2=Lucy |title=George's Secret Key to the Universe |year=2007}}
If no author is cited, the date appears after the title, as shown in the example below:
:<code><nowiki>{{cite book |title=George's Secret Key to the Universe |year=2007}}</nowiki></code>
:{{cite book |title=George's Secret Key to the Universe |year=2007}}
If the cited source does not credit an author, as is common with newswire reports, press releases or company websites use:
:{{para|author|<nowiki><!--Not stated--></nowiki>}}
This HTML comment alerts fact-checking and citation-fixing editors, and potentially bots, that the cited source did not name an author—the author was not overlooked. Without this entry editors and bots would waste time researching cited sources for a non-existent author credit.
When using {{para|author}} avoid citations like {{tlx|cite news |work{{=}}Weekday Times |author{{=}}''Weekday Times'' editors |title{{=}}...}}, unless the article is on a field in which the majority of professional journals covering that field use such a citation style.
Editors should use an {{para|author}} organizational citation when the cited source, such as a committee report, specifically names an official body or a sub-unit of the publisher as the collective author of the work, e.g. {{para|author|Commission on Headphone Safety}} or {{para|author|Rules Sub-committee}}. Do not use {{para|author}} to assert what you think was probably the collective author when the source itself does not specifically specify a collective author; doing so is [[WP:NOR|original research]] and falsification of [[WP:V|source verifiability]] and [[WP:RS|reliability]].
{{para|author}} should never hold the name of more than one author. Separate individual authors into enumerated individual {{para|author''n''}} parameters.
===Editors===
An editor may be cited using separate parameters for the editor's last and first name. A single or first editor would use {{para|editor-last}} and {{para|editor-first}}; subsequent editors would use {{para|editor2-last}} and {{para|editor2-first}}, {{para|editor3-last}} and {{para|editor3-first}}, etc.<ref group=Note>In Lua coded templates, the number of editors that can be listed in the citation and displayed when published is unlimited. In older templates that have not yet been converted to Lua coding, any number of editors may be listed in the citation, however only the first three will display, followed by "et al."</ref>
If an editor is notable and has a Wikipedia article, you may wikilink to that editor's Wikipedia article using {{para|editor-link}}. If a cited work has multiple editors, you may use {{para|editor2-link}}, {{para|editor3-link}}, etc. to wikilink to each editor's Wikipedia article. This method is used because {{para|editor-last}} and {{para|editor-first}} do not allow wikilinking. Please note that {{para|editor-link}} cannot be used to link to an external website; the external link will not render correctly.
If a cited source has a large number of editors, one can limit the number of editors displayed when the citation is published using the {{para|display-editors}} parameter as described in detail in the [[Help:Citation Style 1#Display options|Display options]] section of this help page.
===Others===
* '''others''': This parameter is used to credit contributors other than an author or an editor, such as an illustrator or a translator. You should include both the type of contribution and the name of the contributor, for example {{para|others|Illustrated by John Smith}} or {{para|others|Trans. Jones}}
===Dates===
Dates are indicated by these parameters:
* '''date''': Full date of publication edition being referenced, in the same format as other dates in citations in the same article. Must not be wikilinked.
* OR: '''year''': Year of publication edition being referenced.
** '''orig-year''': Original publication year, for display alongside the date or year. For clarity, please supply specifics, for instance <code>orig-year=First published 1859</code> or <code>orig-year=Composed 1904</code>. This parameter displays only if there is a value for ''year'' or ''date''.
For no date, or "undated", add as <code>date=n.d.</code>
Acceptable date formats are shown in the "Acceptable date formats" table of the [[MOS:DATEFORMAT|Manual of Style/Dates and numbers § Dates, months and years]]. Further points:
* Prescriptions about date formats only apply when the date is expressed in terms of Julian or Gregorian dates, or which use one of the seasons (spring, summer, autumn or fall, winter). Sources are at liberty to use other ways of expressing dates, such as "spring-summer" or a date in a religious calendar; editors should report the date as expressed by the source. [[WP:SEASON|Although the seasons are not normally capitalized]], they are capitalized when used as dates in CS1 templates, and the capitalization of the season stated by the source may be altered to follow this rule.
* Do not wikilink.
* Access and archive dates in references should be in either the format used for [[MOS:DATEUNIFY|publication dates]], or YYYY-MM-DD.
====CS1 compliance with Wikipedia's Manual of Style====
CS1 uses [[Wikipedia:Manual of Style/Dates and numbers]] § Dates, months and years ([[MOS:DATEFORMAT]]) as the reference for all date format checking performed by [[Module:Citation/CS1]]. For various reasons, CS1 is not fully compliant with MOS:DATEFORMAT. This table indicates CS1 compliance with the listed sections of MOS:DATEFORMAT.
{|class="wikitable" style="margin: 1em auto 1em auto;"
|+CS1 compliance with [[MOS:DATEFORMAT|Wikipedia:Manual of Style/Dates and numbers]]
!section !!compliant!! comment
|-
|[[MOS:DATEFORMAT#Acceptable date formats|Acceptable date formats table]]||yes||Exceptions: linked dates not supported;<br />sortable dates not supported ({{tlx|dts}} etc.);<br />proper name dates not supported with the exception of 'Christmas YYYY';<br />shortened month names longer than three characters or with terminating periods not supported;
|-
|[[MOS:DATEFORMAT#Unacceptable date formats|Unacceptable date formats table]]||yes||
|-
|[[MOS:DATEFORMAT#Consistency|Consistency]]||no||rowspan="3"|article level restrictions are beyond the scope of CS1
|-
|[[MOS:DATEFORMAT#Strong national ties to a topic|Strong national ties to a topic]]||no
|-
|[[MOS:DATEFORMAT#Retaining existing format|Retaining existing format]]||no
|-
|[[MOS:DATEFORMAT#Era style|Era style]]||no||Dates earlier than 100 not supported; it is rare for Wikipedia editors to read such old sources; the date of the source actually consulted should be provided in {{para|date}}, and the date of the ancient source may be provided in {{para|orig-year}}; the format of the orig-year value is not checked for errors.
|-
|[[MOS:DATEFORMAT#Julian and Gregorian calendars|Julian and Gregorian calendars]]||limited||Julian prior to 1582; Gregorian from 1582; assumes Gregorian in the overlap period of 1582 – c. 1923
|-
|[[MOS:DATEFORMAT#Ranges|Ranges]]||yes||Exceptions: does not support the use of <code>&ndash;</code> or <code>&nbsp;</code><br />does not support dates prior to 100;<br />does not support solidus separator (/)<br />does not support " to " as a date separator<br />does not support YYYY–YY where the two-digit year is less than 13 (change to YYYY–YYYY to eliminate the error message);
|-
|[[MOS:DATEFORMAT#Uncertain, incomplete, or approximate dates|Uncertain, incomplete, or approximate dates]]||yes||Exceptions: does not support {{tlx|circa}} or {{tlx|floruit}};<br />does not support dates prior to 100;<br />Supports <code>c. </code> only with a single year value (no ranges or day/month combinations).
|-
|[[MOS:DATEFORMAT#Days of the week|Days of the week]]||no||
|-
|[[MOS:DATEFORMAT#Seasons|Seasons]]||limited||CS1 capitalizes seasons used as dates in citations, in line with external style guides;
|-
|[[MOS:DATEFORMAT#Decades|Decades]]||no||
|-
|[[MOS:DATEFORMAT#Centuries and millennia|Centuries and millennia]]||no||
|-
|[[MOS:DATEFORMAT#Abbreviations for long periods of time|Abbreviations for long periods of time]]||no||
|}
====Date range, multiple sources in same year====
If dates are used with [[#Anchors|the ref=harv parameter]], the year range is 100 to present without era indication (AD, BC, CE, BCE). In the case where the same author has written more than one work in the same year, a lower-case letter may be appended to the year in the date parameter ({{xt|date = July 4, 1997b}}) or the year parameter ({{xt|year = 1997b}}).
===Titles and chapters===
* '''title''' The title of the cited source. Titles are displayed in italics, except for short works such as a {{tl|cite press release}} and cited articles in {{tlx|cite news}}, {{tlx|cite journal}}, {{tlx|cite web}}, {{tlx|cite conference}}, and {{tlx|cite podcast}}, where the title is shown in quotation marks. Use title case unless the cited source covers a scientific, legal or other technical topic and sentence case is the predominant style in journals on that topic. Use either [[MOS:CT|title case]] or sentence case consistently throughout the article. Do not omit a leading "The" from the title. Subtitles are typically separated from titles with ": " though " – " is also used. [[MOS:TM|As with trademarks]], Wikipedia {{em|does not}} attempt to emulate any stylistic flourishes used by the cited source's publisher, such as ALL-CAPS, all-lower-case, {{sm|Small Caps}}, etc.; use either standard title case or sentence case consistently. If the cited source is itself notable and has a Wikipedia article, the title can be wikilinked. Wikilinking the title will make it impossible to use the "url" parameter to link to an external copy of the cited source, so only do this when citing works that do not need to be externally linked. A link to the actual source is preferred to a link to a Wikipedia article about the source.
* '''script-title''': Languages that do not use a Latin-based alphabet, Arabic, Chinese, Cyrillic, Greek, Hebrew, Japanese, Korean, etc., should not be italicized and may also read [[right-to-left]] (rtl). To include titles in these languages, use '''script-title'''. Titles in '''script-title''' are wrapped in special HTML markup to isolate rtl script from adjacent left-to-right text. Part of that special markup is a language attribute that browsers can use to assist in the proper display of the script. Editors may add a prefix to the script that will identify the language. The prefix is an [[List of ISO 639-1 codes|ISO 639-1]] two-character language code followed by a colon: {{para|script-title|ar:<bdi>العربية</bdi>}}. Unrecognized codes are ignored and will display in the rendered citation.
* '''trans-title''': If the cited source is in a foreign language, an English translation of the title can be given here. This field will be displayed in square brackets after the title and will be linked to {{para|url}} if used.
* '''chapter''' The title of the cited chapter from the source, written in full. Displayed in quotes before the title. For websites arranged in sections the "at" parameter serves a similar function: {{para|at|Featured News}}
* '''script-chapter''': Languages that do not use a Latin-based alphabet, Arabic, Chinese, Cyrillic, Greek, Hebrew, Japanese, Korean, etc., may possibly read [[right-to-left]] (rtl). To include chapter titles in these languages, use '''script-chapter'''. Chapter titles in '''script-chapter''' are wrapped in special HTML markup to isolate rtl script from adjacent left-to-right text. Part of that special markup is a language attribute that browsers can use to assist in the proper display of the script. Editors may add a prefix to the script that will identify the language. The prefix is an [[List of ISO 639-1 codes|ISO 639-1]] two-character language code followed by a colon: {{para|script-title|ar:<bdi>العربية</bdi>}}. Unrecognized codes are ignored and will display in the rendered citation. This field will be displayed following the transliterated title.
* '''trans-chapter''': If the cited source is in a foreign language, an English translation of the cited chapter title can be given here. This field will be displayed in square brackets within the quotation marks which enclose the chapter field.
Titles containing certain characters will both display and link incorrectly unless those characters are replaced or encoded like this:
{| class="wikitable"
!Character
!Must be replaced with
|-
|newline
|space
|-
|[
|&#91;
|-
|]
|&#93;
|-
|<nowiki>|</nowiki>
|&#124;
|}
===Type===
* '''type''': Specifies the type of work cited. Appears in parentheses immediately after the title. Some templates use a default that can be overridden; example: {{tl|cite press release}} will show (Press release) by default. Other useful values are Review, Systemic review, Meta-analysis or Original article.
===Language===
* '''language''': The language the work is written in, if it is not English. Displayed before the title, enclosed in parentheses and prefixed with ''in''. Do not use icons in this field. If the source is listed as being in English, then this parameter will be ignored.
===Work and publisher===
{{see|WP:CITEHOW}}
* '''work''': Used by some templates such as {{tl|cite web}}, {{tl|cite news}} (where it is aliased to '''newspaper'''), {{tl|cite magazine}} (aliased to '''magazine'''), {{tl|cite journal}} (aliased to '''journal'''), and others where the citation is usually to a specific item in a larger work, most commonly an article in a website or print periodical, or an episode in a TV series. ''Do not confuse this with the "publisher" parameter'', which is for the publishing company. If the work is notable and has an article in Wikipedia, it should be wiki-linked at first appearance in citations in the article. If the "title" is already linked to externally, do not externally link to the "work".
:On websites, in most cases "work" is the name of the website (as usually given in the logo/banner area of the site, and/or appearing in the {{tag|title}} of the homepage, which may appear as the page title in your browser tab, depending on browser); otherwise use the site's domain name. If the "work" as given by the site/publication would be exactly the same as the name of the publisher, use the domain name; do not falsify the work's name by adding descriptive verbiage like "website of [Publisher]" or "[Publisher]'s Homepage". Capitalize for reading clarity, and omit "www.", e.g. convert "www.veterinaryresourcesuk.com" to "VeterinaryResourcesUK.com". Many journals use highly abbreviated titles when citing other journals (e.g. "J Am Vet Med" for "Journal of the [[American Veterinary Medical Association]]") because specialists in the field the journal covers usually already know what these abbreviations mean. Our readers do not, so these abbreviations should always be expanded. If the titled item being cited is part of some other larger work, such as a book, periodical or sub-organization, forming a sub-site at a domain name (e.g., the law school's section of a university's website system), it is usually better to use the name of that more specific work than that of the entire site/system. If the nature of the work and its relation to the site, book or other context in which it is found is complicated or confusing, simply explain the situation after the citation template and before the {{tag|ref|c}} that closes the citation.
* '''publisher''': the name of the organization that actually published the source. The field should not include the corporate designation such as "Ltd" or "Inc.", unless some ambiguity would result or the organization is usually known with that designation even in everyday use. "Publisher", "Publishing" and "Publications" can be abbreviated "Pubr.", "Pubg." and "Pubs." respectively, but some templates in this series include a period (full-stop) immediately after this parameter, so the period may have to be omitted; check the output if you abbreviate here. These words are usually safe to omit, but are usefully included where the publisher's name might be confusing. This is most often the case when the publisher's name is something like "Joshua Martin Publications", which without the designation might be mistaken for a co-author. A leading "The" can generally be omitted, again unless confusion might result (e.g., for [[The International Cat Association]], "The" is part of their official acronym, TICA). If the publisher is notable and has an article independent of the "work", the "publisher" parameter can include a wiki-link to that article, but should never externally link to the publisher's website. The "publisher" parameter should not be included either for mainstream, widely-known newspapers, or where it would be the same or mostly the same as the work/site/journal/etc., for example, the "publisher" parameter should be omitted in these examples:
::{{para|work|Amazon.com}}{{para|publisher|Amazon}}
::{{para|newspaper|''The Aberdeen Times''}}{{para|publisher|The Aberdeen Times}}<!--A genuine Idaho, US newspaper: http://www.smalltownpapers.com/newspapers/newspaper.php?id=1 -->
::{{para|newspaper|''[[USA Today]]''}}{{para|publisher|[[Gannett Company]]}}
::{{para|journal|''[[Journal of Physics G]]''}}{{para|publisher|[[IOP Publishing]]}}
:Whether the publisher needs to be included depends on the type of work. [[Wikipedia:Citing sources]] suggest it should be for books, but not necessarily other works. If the work is self-published, [[WP:SELFPUB|this is a very important fact]] about [[WP:RS|potential reliability of the source]], and needs to be specified; no consensus exists for the exact value of {{para|publisher}}, but some printed style guides suggest "author". When an exhaustive attempt to discover the name of the publisher (try [[whois]] for websites) fails, use {{para|publisher|<nowiki><!--Unspecified by source.--></nowiki>}} to explicitly indicate that this was checked, so other editors do not waste time duplicating your fruitless efforts. Do not guess at the publisher when this information is not clear.
* '''location''': Geographical place of publication, usually City, Country, or City, U.S. State; simply the city name by itself can be used for world-recognized cities like New York, London (except in articles about Canadian topics), Paris, Tokyo. Simply having a unique name does not mean it is globally recognizable; e.g., many people do not know where [[Mumbai]] is, especially if they are old enough that it was called [[Bombay]] for much of their lives. If in doubt, be more not less specific, since "Toronto, Canada" and "San Francisco, California" do not actually hurt anything. The {{para|location}} parameter should be omitted when it is implied by the name of the work, e.g. ''The New York Times''. The {{para|location}} parameter should be used when the location is part of the common name but not the actual name of a newspaper. For example, the newspaper commonly known as the ''New York Daily News'' is actually [[Daily News (New York)|''Daily News'' (New York)]] and can be entered with {{para|newspaper|Daily News}} {{para|location|New York}}, which yields ''Daily News'' (New York).
* '''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.
* '''via''' (optional): Name of the content deliverer (when they are ''not'' the publisher). '''via''' is not a replacement for '''publisher''', but provides additional detail. It may be used when the content deliverer presents the source in a format other than the original, or when the URL provided does not make clear the identity of the deliverer, or as suggested in [[WP:The Wikipedia Library]], e.g. [[WP:Credo accounts/Citations]]. See also [[#Registration or subscription required|§Registration or subscription required]].<!-- see Talk#Via -->
===Pages===
{| class="wikitable" style="float:right; margin-left:1em"
|+cs1{{pipe}}2 template support for<br />{{pipe}}volume=, {{pipe}}issue=, {{pipe}}page(s)=
|-
!template !! {{pipe}}volume= !! {{pipe}}issue= !! {{pipe}}page(s)=
|-
|{{tlx|citation}} || {{yes}} || {{yes}} || {{yes}}
|-
|{{tlx|cite arXiv}} || {{no}} || {{no}} || {{yes}}
|-
|{{tlx|cite AV media}} || {{yes}} || {{no}} || {{no}}
|-
|{{tlx|cite AV media notes}} || {{no}} || {{no}} || {{yes}}
|-
|{{tlx|cite book}} || {{yes}} || {{no}} || {{yes}}
|-
|{{plainlist|
*{{tlx|cite conference}}
*(as a book)}}
| {{no}} || {{no}} || {{yes}}
|-
|{{plainlist|
*{{tlx|cite conference}}
*(as a journal)}}
| {{yes}} || {{yes}} || {{yes}}
|-
|{{tlx|cite encyclopedia}} || {{yes}} || {{no}} || {{yes}}
|-
|{{tlx|cite episode}} || {{no}} || {{yes}} || {{no}}
|-
|{{tlx|cite interview}} || {{yes}} || {{yes}} || {{yes}}
|-
|{{tlx|cite journal}} || {{yes}} || {{yes}} || {{yes}}
|-
|{{tlx|cite magazine}} || {{yes}} || {{yes}} || {{yes}}
|-
|{{tlx|cite mailing list}} || {{no}} || {{no}} || {{no}}
|-
|{{plainlist|
*{{tlx|cite map}}
*(as book)}}
| {{yes}} || {{no}} || {{yes}}
|-
|{{plainlist|
*{{tlx|cite map}}
*(as journal or magazine)}}
| {{yes}} || {{yes}} || {{yes}}
|-
|{{tlx|cite news}} || {{yes}} || {{yes}} || {{yes}}
|-
|{{tlx|cite newsgroup}} || {{no}} || {{no}} || {{no}}
|-
|{{tlx|cite podcast}} || {{no}} || {{no}} || {{no}}
|-
|{{tlx|cite press release}} || {{no}} || {{no}} || {{yes}}
|-
|{{tlx|cite report}} || {{yes}} || {{no}} || {{yes}}
|-
|{{tlx|cite serial}} || {{no}} || {{no}} || {{no}}
|-
|{{tlx|cite sign}} || {{no}} || {{no}} || {{no}}
|-
|{{tlx|cite speech}} || {{no}} || {{no}} || {{no}}
|-
|{{tlx|cite techreport}} || {{yes}} || {{no}} || {{yes}}
|-
|{{tlx|cite thesis}} || {{yes}} || {{no}} || {{yes}}
|-
|{{tlx|cite web}} || {{no}} || {{no}} || {{yes}}
|-
|}
An editor may use any <u>one</u> of the following parameters in a given citation to refer to the specific page(s) or place in a cited source that contains the information that supports the article text. If more than one of the following parameters are used in the same citation, the error message <span style="color:red">Extra <code>|pages=</code> or <code>|at=</code> (</span>[[Help:CS1 errors#extra pages|help]]<span style="color:red">)</span> will display in the published citation. When more than one of the following parameters is used in error, {{para|page}} overrides both {{para|pages}} and {{para|at}}; {{para|pages}} overrides {{para|at}}. To resolve the error, remove extra parameters of this type until only one remains in the affected citation.
* '''page''': page in the cited source containing the information that supports the article text, for example {{para|page|52}} .
**'''Note:''' For a hyphenated page, use {{para|page|<nowiki>12{{hyphen}}34</nowiki>}}. This will not only properly display a hyphen, but also reduce the likelihood that an editor/bot will convert this to {{para|pages|<nowiki>12{{endash}}34</nowiki>}} by mistake.
* '''pages''': pages in the cited source containing the information that supports the article text. Separate page ranges with an [[En dash#En dash|en dash]]: – , for example {{para|pages|236–239}} . Separate non-sequential pages with a comma, for example {{para|pages|157,159}} . The form {{para|pages|461,466–467}} is used when you are citing both non-contiguous and sequential pages.
**'''Note:''' CS1 citations do not record the total number of pages in a cited source; do not use this parameter for that purpose.
* '''at''': place in the cited source containing the information that supports the article text when a page number is not given, is inappropriate or is insufficient. Common examples include column or col., paragraph or para. and section or sec. Depending on the source being cited, other indicators may be appropriate to use with the {{para|at}} parameter including, but not limited to, track, hours, minutes and seconds, act, scene, canto, book, part, folio, stanza, back cover, liner notes, indicia, colophon, dust jacket, etc. Examples include {{para|at|Column 2}} or {{para|at|Paragraph 5}} or {{para|at|Back cover}} or {{para|at|Act III, Scene 2}}.
===Edition identifiers===
* '''edition''': Identifies the particular edition of a cited source when the source has more than one edition, such as "2nd", "Revised", etc. Note that this parameter automatically displays " ed." after your entry. For example, {{para|edition|Revised third}} displays as: Revised third ed. The edition parameter can be omitted if there is no content difference between two editions of the same work; e.g. if a book was identically published in the UK and the US except, for example, ISBN number and cover art, it is not necessary to indicate either "UK" or "US" edition; or if citing minute:seconds of a film available in both a regular edition and a "Special Limited Collector's Edition", if the running time and cut are the same, it is not necessary to cite the particular edition.
* '''series''': When the source is part of a series, such as a book series or a journal where the issue numbering has restarted. For journal series, {{para|series}} should be limited to {{code|Original/New Series}}, {{code|First/Second/Third/... Series}}, or similar.{{refn|name=c17_14.126|group=Note|"Some numbered series have gone on so long that, as with certain long-lived journals, numbering has started over again, preceded by n.s. (new series), 2nd ser. (second series), or some similar notation, usually enclosed in commas. (A change of publisher may also be the occasion for a change in series designation.) Books in the old series may be identified by o.s., 1st ser., or whatever complements the notation for the new series."<ref>{{cite book |author=University of Chicago |title=The Chicago Manual of Style |edition=17th |year= 2017 |publisher=University of Chicago Press |page=14.126|location=Chicago |language= |isbn=978-0226104201}}</ref>
<p>For instance the journal ''[[Physical Review]]'', was numbered volumes 1–35 from 1893–1912 (the first series). In 1913–1969, the volume numbering restarted at 1 and went up to 188 (the second series). In 1970, ''Physical Review'' split into different parts, ''Physical Review A'', ''Physical Review B'', ''Physical Review C'', and ''Physical Review D'', where volumes again restarted at 1 (the third series). Since there are two publications identified as ''Physical Review, Volume 1'' , there is a need to distinguish which is which by use of {{para|series|First Series}} or {{para|series|Second Series}}. While ''Physical Review A'' is in the third series of the ''Physical Review'' [[media franchise]], it is the first series of the publication known as ''Physical Review A''. Since there is no confusion about what ''Physical Review A, Volume 1'' could be referring to, and there is no need to clarify to which numbering series the journal belong.</p>
<p>In particular, note that the {{para|series}} parameter is not to be used to distinguish the different parts of a [[media franchises]], like ''[[Physical Review A]]'', ''[[Acta Crystallographica Section A]]'', ''[[Journal of the Royal Statistical Society, Series B]]''.</p>}}
* '''volume''': For a source published in several volumes. This field is displayed in bold after the title and series parameters. An alternative is to include the volume information in the title parameter after the main title.
* '''issue''': When the source is part of a series that is published periodically. Aliases: '''number'''.
===External links===
* '''url''': Adds a link to the title
* '''chapter-url''': Adds a link to the chapter.
* '''format''': Format of the document at its URL (e.g., PDF, xls, etc.) Do not specify for HTML as it is implied as the default. Several [[Help:External link icons|URI schemes and filename extensions]] will show an icon— these icons have no alt text and do not meet [[Wikipedia:Manual of Style/Accessibility|accessibility standards]]. Do not use this parameter for completely different purposes, with annotations such as "fee required" or "reprint"; its intent is to notify readers what the file format is (e.g. in case some browsers might have trouble with it, or some might prefer to save the link to disk rather than open it in the browser). Access restrictions can be shown using {{para|subscription}} or {{para|registration}}, see [[#Registration or subscription required|Registration or subscription required]]. Other notes about reprintings, etc., should be placed after the template, and before {{tag|ref|c}}.
====Online sources====
{{main|WP:External links|WP:Citing sources}}
Links to sources are regarded as conveniences and are not required, except when citing Web-only sources. There are many digital libraries with works that may be used as sources.
* Links should be to full versions of the source.
* Online sources that require payment or subscription may be included per the [[Wikipedia:Verifiability|verifiability policy]].
Do not link to:
{{main|WP:LINKSTOAVOID}}
* Sites that do not have permission to republish the work or which otherwise violate copyright.
* Commercial sites such as Amazon, unless no alternative exists.
* Reviews of the work.
* Very short extracts such as Google Books snippet view where there is not enough context to verify the content, unless the entire work is also freely available there. (See [[WP:BOOKLINKS]])
====Link formats====
Links should be kept as simple as possible. For example, when performing a search for a Google Book, the link for ''Monty Python and Philosophy'' would look like:
:https://books.google.com/books?id=NPDgD546-doC&pg=PP1#v=onepage&q&f=false
But can be trimmed to:
:https://books.google.com/?id=NPDgD546-doC&pg=PP1#v=onepage&q&f=false
or:
:https://books.google.com/?id=NPDgD546-doC&printsec=frontcover
or:
:https://books.google.com/?id=NPDgD546-doC (if Google Books does not provide the cover page).
====Pages====
A direct link to a specific page may be used if supported by the host. For example, the link to page 172 of ''Monty Python and Philosophy'' on Google Books:
:https://books.google.com/?id=NPDgD546-doC&pg=PA172
like so:
:<code><nowiki>|page=[https://books.google.com/?id=wPQelKFNA5MC&pg=PA172 172]</nowiki></code>
If the same source is reused with different pages, separate citations must be created. A way around this problem is to use a short citation {{tlx|sfn}}, or {{tlx|rp}} to provide linked page number citations.
====Special characters====
{{MediaWiki URL rules}}
====Access date====
* '''access-date''': The full date when the content pointed to by '''url''' was last verified to support the text in the article; do not wikilink; requires '''url'''; use the same format as other access and archive dates in the citations. It is ''not required for linked documents that do not change.'' For example, '''access-date''' is not required for links to copies of published research papers accessed via DOI or a published book, but should be used for links to news articles on commercial websites (these can change from time to time, even if they are also published in a physical medium). Note that '''access-date''' is the date that the URL was checked to not just be working, but to support the assertion being cited (which the current version of the page may not do). Can be [[Help:Citation Style 1/accessdate|hidden or styled]] by registered editors. Alias: '''accessdate'''.
====Icons====
{{main|Help:External link icons}}
URLs with certain filename extensions or URI schemes will apply an icon specific to that file type. This is done through MediaWiki CSS, not these templates.
===Web archives===
{{see|Wikipedia:Link rot}}
* '''archive-url'''
* '''archive-date'''
The original link may become unavailable. When an archived version is located, the original URL is retained and {{para|archive-url}} is added with a link to an archived copy of a web page, usually from services like WebCite and the Internet Archive. {{para|archive-date}} must be added to show the date the page was archived, not the date the link was added. When {{para|archive-url}} is used, {{para|url}} and {{para|archive-date}} are required, else an error will show. When an archived link is used, the citation displays with the title linked to the archive and the original link at the end:
:{{cite journal |title=Monty Python and Philosophy |url=https://books.google.com/books?id=wPQelKFNA5MC |archive-url=https://web.archive.org/web/20130501102912/http://books.google.com/books?id=wPQelKFNA5MC |archive-date=May 1, 2013}}
* '''dead-url''': To change the order with the title retaining the original link and the archive linked at the end, set {{para|dead-url|no}}:
:{{cite journal |title=Monty Python and Philosophy |url=https://books.google.com/books?id=wPQelKFNA5MC |archive-url=https://web.archive.org/web/20130501102912/http://books.google.com/books?id=wPQelKFNA5MC |archive-date=May 1, 2013 |dead-url=no}}
:*When the original URL has been usurped for the purposes of spam, advertising, or is otherwise unsuitable, setting {{para|dead-url|unfit}} or {{para|dead-url|usurped}} suppresses display of the original URL (but {{para|url}} {{para|archive-url}} are still required).
===Identifiers===
{{Citation Style documentation/id2}}
A custom identifier can be specified through
{{Citation Style documentation/id1}}
===Registration or subscription required===
Citations of online sources that require registration or a subscription are acceptable in Wikipedia as documented in [[WP:PAYWALL|Verifiability – Access to sources]]. As a courtesy to readers and other editors, editors can signal the access restrictions of the external links included in a citation.
Four access levels can be used:
* [[File:Lock-green.svg|9px|link=|alt=Freely accessible|Freely accessible]] <code>free</code>: the source is free to read for anyone
* [[File:Lock-gray-alt-2.svg|9px|link=|alt=Free registration required|Free registration required]] <code>registration</code>: a free registration is required to access the source
* [[File:Lock-gray-alt-2.svg|9px|link=|alt=Free access subject to limited trial, subscription normally required|Free access subject to limited trial, subscription normally required]] <code>limited</code>: there are other constraints (such as a cap on daily views) to freely access this source
* [[File:Lock-red-alt.svg|9px|link=|alt=Paid subscription required|Paid subscription required]] <code>subscription</code>: the source is only accessible via a paid subscription
As there are often multiple external links with different access levels in the same citation, these values are attributed to a particular external link.
====Access level of {{para|url}}====
Links inserted with {{para|url}} are expected to be free to read by default. If not, editors can use one of
* {{para|url-access|subscription}}
* {{para|url-access|registration}}
* {{para|url-access|limited}}
to indicate the relevant access restriction.
====Access level of identifiers====
Links inserted by identifiers such as {{para|doi}} are not expected to offer a free full text by default. If they do, editors can use {{para|doi-access|free}} (in the case of {{para|doi}}) to indicate the relevant access level. The following identifiers are supported:
:* {{para|bibcode}} with {{para|bibcode-access|free}}
:* {{para|doi}} with {{para|doi-access|free}}
:* {{para|hdl}} with {{para|hdl-access|free}}
:* {{para|jstor}} with {{para|jstor-access|free}}
:* {{para|ol}} with {{para|ol-access|free}}
:* {{para|osti}} with {{para|osti-access|free}}
Some identifiers always link to free full texts. In this case, the access level is automatically indicated by the template. This is the case for {{para|arxiv}}, {{para|biorxiv}}, {{para|citeseerx}}, {{para|pmc}}, {{para|rfc}} and {{para|ssrn}}.
====Old access parameters====
The parameters {{para|registration|yes}} and {{para|subscription|yes}} can also be used to indicate the access level of a citation. However, they do not indicate which link they apply to, so editors are encouraged to use {{para|url-access|registration}} and {{para|url-access|subscription}} instead, when the restriction applies to {{para|url}}. If the restriction applies to an identifier, these parameters should be omitted.
===Quote===
* '''quote''': Relevant text quoted from the source; enclosed in quotes. When supplied, the citation terminator (a period by default) is suppressed, so the quote must include any terminating punctuation.
===Anchors===
* '''ref''': Creates an anchor for use with [[WP:CITESHORT|Shortened footnotes]] and [[WP:PAREN|parenthetical referencing]]. These styles use in-text cites with a link that will jump to an anchor created by the CS1 template. Anchors are not enabled by default. (See {{tl|Harvard citation documentation}} for details.)
* '''{{para|ref|harv}}''': Creates an anchor from up to four author last names and the year, of the format <code>CITEREF''lastname(s)year''</code>, suitable for a {{tlx|harv}}, {{tlx|sfn}} etc. Examples:
:<code><nowiki>{{cite book |first=Gary L. |last=Hardcastle |title=Monty Python and Philosophy |year=2006 |ref=harv}}</nowiki></code>
::Creates an anchor named [[#CITEREFHardcastle2006|<code>CITEREFHardcastle2006</code>]] which may be linked from {{tlx|harv|Hardcastle|2006|4=pp=12-34}}.
:<code><nowiki>{{cite book |first=Gary L. |last=Hardcastle |first2=George A. |last2=Reisch |title=Monty Python and Philosophy |year=2006 |ref=harv}}</nowiki></code>
::Creates an anchor named [[#CITEREFHardcastleReisch2006|<code>CITEREFHardcastleReisch2006</code>]] which may be linked from {{tlx|harv|Hardcastle|Reisch|2006|5=pp=12-34}}.
* '''{{para|ref|<var>ID</var>}}''': Creates a custom anchor defined by <var>ID</var>. This is useful where the author and/or date is unknown. The {{tlx|harvid}} template may be used here to create an anchor suitable for a {{tlx|harv}}, {{tlx|sfn}} etc. For example, <code><nowiki>ref={{harvid|Monty Python and Philosophy|2006}}</nowiki></code> creates an anchor which may be linked from {{tlx|harv|Monty Python and Philosophy|2006|4=pp=12-34}}.
===Display options===
These features are not often used, but can customize the display for use with other styles.
{{csdoc|display|lua=yes}}
====et al.====
et al. is the abbreviation of the Latin ''et alii'' (and others). It is used to complete a list of authors of a published work, where the complete list is considered overly long. The term is widely used in English, thus it is not italicized per [[MOS:FOREIGN]].
==Printing==
When viewing the page, CS1 templates render the URL to the title to create a link; when printing, the URL is printed. [[Help:External link icons|External link icons]] are not printed.
==Elements not included==
Not all factually accurate pieces of information about a source are used in a Citation Style 1 citation. Examples of information not included:
* The total number of pages in a cited source
* The name of the library that provided access to an electronic copy of a cited source
* The name of the library that owns a physical copy of a cited work
* The library record and/or shelf location of a physical copy of a cited work
==Tools==
{{main|Help:Citation tools}}
CS1 templates may be inserted manually or by use of tools:
* [[Wikipedia:TWL/Citoid|Citoid]], a tool built into [[WP:Visual Editor|Visual Editor]] that attempts to build a full citation based on a URL. See [[Wikipedia:VisualEditor/User guide#Using Citoid|user guide]].
* [[Wikipedia:RefToolbar|RefToolbar]] is part of the editing tool bar. Version 2.0 does not yet support all templates supported by version 1.0.
* [[User:ProveIt GT|ProveIt]] provides a graphical interface for editing, adding, and citing references. It may be enabled per the documentation.
* [https://reftag.appspot.com/ Wikipedia citation tool for Google Books]
* [https://reftag.appspot.com/doiweb.py DOI Wikipedia reference generator]
* [https://reftag.appspot.com/nytweb.py New York Times Wikipedia reference generator]
* [https://tools.wmflabs.org/dispenser/view/Reflinks Reflinks] Adds references to templates while updating/filling-in title/dates/publisher/accessdates etc.
* [https://tools.wmflabs.org/refill/ reFill] open source version of Reflinks
* [[Zotero]] can export citations in Wikipedia-ready format.
* [http://tools.wmflabs.org/citer/ Citer] - Generate shortened footnote or named reference for a given Google Books URL, ISBN, or DOI. Also supports some major news websites.
Error checking:
* [[User:Ucucha/HarvErrors]] is a script that may be enabled to display errors when using [[WP:CITESHORT|Shortened footnotes]] or [[WP:PAREN|parenthetical referencing]].
==Common issues==
{{shortcut|Help:CS1PROBS}}
; {{para|access-date}} does not show.
: If {{para|url}} is not supplied, then {{para|access-date}} does not show; by design.
; The bare URL shows before the title.
: If the {{para|title}} field includes a newline or an invalid character then the link will be malformed; see [[#Web links|Web links]].
; The title appears in red.
: If URL is supplied, then the title cannot be wikilinked.
; The URL is not linked and shows in brackets.
: The URL must include the [[URI scheme]] in order for MediaWiki to recognize it as a link. For example: <code>www.example.org</code> vs. <code>http://www.example.org</code>.
; A field is truncated.
: A pipe (<code>|</code>) in the value will truncate it. Use {{tlx|!}} instead.
; The template markup shows.
: Double open brackets [[ are used in a field without closing double brackets ]].
; The author shows in brackets with an external link icon.
: The use of an URL in {{para|author-link}} will break the link; this field is for the name of the Wikipedia article about the author, not a website.
; Multiple author or editor names are defined and one or more does not show
: The parameters must be used in sequence, i.e. if {{para|last}} or {{para|last1}} is not defined, then {{para|last2}} will not show. By design.
; {{para|page}}, {{para|pages}} or {{para|at}} do not show.
: These parameters are mutually exclusive, and only one will show; by design.
== See also ==
* [[Help:Citation Style 2]]
==Notes==
{{reflist|group=Note}}
==References==
{{reflist}}
{{Wikipedia referencing}}
{{Citation Style 1}}
{{Help navigation}}
[[Category:Citation Style 1 templates|*]]
[[Category:Wikipedia citation administration]]
{{Nutshell|This is an introductory how-to for Wikipedia's most frequently used citation style. It does not cover every option of every citation template. See individual templates' documentation (e.g. at [[Template:Cite journal]]) for details beyond this basic cheatsheet.}}
{{notice|image=Gnome-applications-science.svg|This help page has {{subpages|testcases|Help:Citation Style 1}} demonstrating various uses.}}
'''Citation Style 1''' ('''CS1''') is a collection of [[Wikipedia:Citing sources|reference citation]] [[Help:Template|templates]] that can be modified to create different styles for different referenced materials. Its purpose is to provide a set of default formats for references on Wikipedia. It includes a series of templates that in turn use [[Module:Citation/CS1]].
The use of CS1 or of templates is not compulsory; per [[WP:CITEVAR]]:
<blockquote>Wikipedia does not have a single [[style guide|house style]]. Editors may choose any option they want; one article need not match what is done in other articles or what is done in professional publications or recommended by academic [[style guide]]s. However, citations ''within a given article'' should follow a consistent style.</blockquote>
CS1 uses elements of ''[[The Chicago Manual of Style]]'' and the ''[[APA style|Publication Manual of the American Psychological Association]]'', with significant adaptations.
==Style==
There are a number of templates that use a name starting with ''cite''; many were developed independently of CS1 and are not compliant with the CS1 style. There are also a number of templates that use one of the general use templates as a meta-template to cite a specific source.
To be compliant with CS1, a template must:
* Use [[Module:Citation/CS1]] or one of the templates listed below.
* Use a period as a punctuation mark to separate fields and end the citation.
* Use a semicolon as a punctuation mark to separate authors and editors.
* Format the title of longer works in italics.
* Format the title of short works such as chapters in quotes.
==Templates==
===General use===
The following is a list of templates that implement Citation Style 1 for one or more types of citations but are not restricted to any specific source.
{| class="wikitable" style="max-width:715px"
| {{Yes}} || Indicates that the corresponding tool or gadget can generate the template anytime user wishes. However, this does not mean that the tool or gadget fully supports all parameters or provides an interface for them. In fact, none of the mentioned items do so.
|-
| {{Partial|Sometimes}} || Indicates that the corresponding tool or gadget may or may not generate the corresponding template. For more information, see associated footnote.
|}
{| class="wikitable" style="text-align: center;"
|+ General use CS1 templates
! Template !! Use !! [[Wikipedia:The Wikipedia Library/Citoid|Citoid]] !! [[WP:Citation expander|Citation expander]] gadget !! [[WP:RefToolbar/1.0|RefToolbar 1.0]] !! [[WP:RefToolbar/2.0|RefToolbar 2.0]] !! [[Wikipedia:ProveIt|ProveIt]] || [[User:Odie5533/SnipManager|SnipManager]] || [[WP:Cite4Wiki|Cite4Wiki]] (inactive)
|-
| {{tl|Cite arXiv}} || [[arXiv]] preprints || || || || || || ||
|-
| {{tl|Cite AV media}} || audio and visual sources || || || || || {{Yes}} || {{Yes}} ||
|-
| {{tl|Cite AV media notes}} || liner notes from albums, DVDs, CDs and similar audio-visual media || || || || || || ||
|-
| {{tl|Cite book}} || books || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} ||
|-
| {{tl|Cite conference}} || conference papers || || || || || {{Yes}} || ||
|-
| {{tl|Cite encyclopedia}} || edited collections || || || || || {{Yes}} || ||
|-
| {{tl|Cite episode}} || television or radio programs and episodes || || || || || {{Yes}} || ||
|-
| {{tl|Cite interview}} || interviews || || || || || || ||
|-
| {{tl|Cite journal}} || academic and scientific papers and journals || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Partial|Sometimes}}{{efn|[[WP:Cite4Wiki|Cite4Wiki]] uses {{tl|Cite web}} by default, but has been customized to use {{tl|Cite news}}, etc., for certain specific sources, and can be further customized in this manner.}}
|-
| {{tl|Cite magazine}} || magazines and newsletters || || || || || {{Yes}} || ||
|-
| {{tl|Cite mailing list}} || archived public mailing lists || || || || || || ||
|-
| {{tl|Cite map}} || maps || || || || || || ||
|-
| {{tl|Cite news}} || news articles in print, video, audio or web || {{Yes}} || {{Partial|Sometimes}}<br />{{Elucidate}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Partial|Sometimes}}<br />{{Elucidate}}
|-
| {{tl|Cite newsgroup}} || online newsgroups || || || || || || ||
|-
| {{tl|Cite podcast}} || audio or video [[podcast]] || || || || || || ||
|-
| {{tl|Cite press release}} || press releases || || || {{Yes}} || || {{Yes}} || ||
|-
| {{tl|Cite report}} || unpublished reports by government departments, instrumentalities, operated companies, etc. || || || || || || ||
|-
| {{tl|Cite serial}} || audio or video serials || || || || || || ||
|-
| {{tl|Cite sign}} || signs, plaques and other visual sources || || || || || {{Yes}} || ||
|-
| {{tl|Cite speech}} || speeches || || || || || || ||
|-
| {{tl|Cite techreport}} || technical reports || || || || || || ||
|-
| {{tl|Cite thesis}} || theses || || || || || {{Yes}} || ||
|-
| {{tl|Cite web}} || web sources not characterized by another template || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|}
{{notelist}}
===Specific source===
There are a number of templates that are CS1 compliant, because they use a CS1 template as a base, but are tied to a specific source; these are listed in [[:Category:Citation Style 1 specific-source templates]].
==How the templates work==
CS1 uses a series of templates that provide a consistent output. The main difference is in parameters optimized for the subject. For example, {{tl|cite book}} has fields for title and chapter, whereas {{tl|cite journal}} has fields for journal and title.
This help page uses the names most commonly used across the templates series; see each template's documentation for details.
CS1 templates present a citation generally as:
* With author:
:{{Cite journal |last=Author |date=n.d. |title=Title |work=Work |publisher=Publisher |id=Identifiers |template-doc-demo=true}}
* Without author:
:{{Cite journal |date=n.d. |title=Title |work=Work |publisher=Publisher |id=Identifiers |template-doc-demo=true}}
(where "n.d." could also be any other valid date formatted per the MOS)
===Authors===
An author may be cited using separate parameters for the author's surname and given name by using {{para|last}} and {{para|first}} respectively. If a cited source has multiple authors, subsequent authors can be listed in the citation using {{para|last2}} and {{para|first2}}, {{para|last3}} and {{para|first3}}, etc. as shown in the following example:<ref group=Note>The number of authors that can be listed in the citation and displayed when published is unlimited.</ref>
:<code><nowiki>{{cite book |last=Hawking |first=Stephen |last2=Hawking |first2=Lucy |title=George's Secret Key to the Universe}}</nowiki></code>
:{{cite book |last=Hawking |first=Stephen |last2=Hawking |first2=Lucy |title=George's Secret Key to the Universe}}
If a cited source has a large number of authors, one can limit the number of authors displayed when the citation is published by using the {{para|display-authors}} parameter as described in detail in the [[Help:Citation Style 1#Display options|Display options]] section of this help page.
If a cited author is notable and the author has a Wikipedia article, the author's name can be linked with {{para|author-link}}. If a citation includes multiple notable authors, one may use {{para|author-link2}}, {{para|author-link3}}, etc. This method is used because {{para|last}} and {{para|first}} do not allow wikilinking. Please note that {{para|author-link}} cannot be used to link to an external website; the external link will not render correctly. Below is an example of a wikilinked author credit:
:<code><nowiki>{{cite book |last=Hawking |first=Stephen |author-link=Stephen Hawking |last2=Hawking |first2=Lucy |title=George's Secret Key to the Universe}}</nowiki></code>
:{{cite book |last=Hawking |first=Stephen |author-link=Stephen Hawking |last2=Hawking |first2=Lucy |title=George's Secret Key to the Universe}}
When an author is cited, the date of the cited work is displayed after the author's name, as shown in the example below:
:<code><nowiki>{{cite book |last=Hawking |first=Stephen |author-link=Stephen Hawking |last2=Hawking |first2=Lucy |title=George's Secret Key to the Universe |year=2007}}</nowiki></code>
:{{cite book |last=Hawking |first=Stephen |author-link=Stephen Hawking |last2=Hawking |first2=Lucy |title=George's Secret Key to the Universe |year=2007}}
If no author is cited, the date appears after the title, as shown in the example below:
:<code><nowiki>{{cite book |title=George's Secret Key to the Universe |year=2007}}</nowiki></code>
:{{cite book |title=George's Secret Key to the Universe |year=2007}}
If the cited source does not credit an author, as is common with newswire reports, press releases or company websites use:
:{{para|author|<nowiki><!--Not stated--></nowiki>}}
This HTML comment alerts fact-checking and citation-fixing editors, and potentially bots, that the cited source did not name an author—the author was not overlooked. Without this entry editors and bots would waste time researching cited sources for a non-existent author credit.
When using {{para|author}} avoid citations like {{tlx|cite news |work{{=}}Weekday Times |author{{=}}''Weekday Times'' editors |title{{=}}...}}, unless the article is on a field in which the majority of professional journals covering that field use such a citation style.
Editors should use an {{para|author}} organizational citation when the cited source, such as a committee report, specifically names an official body or a sub-unit of the publisher as the collective author of the work, e.g. {{para|author|Commission on Headphone Safety}} or {{para|author|Rules Sub-committee}}. Do not use {{para|author}} to assert what you think was probably the collective author when the source itself does not specifically specify a collective author; doing so is [[WP:NOR|original research]] and falsification of [[WP:V|source verifiability]] and [[WP:RS|reliability]].
{{para|author}} should never hold the name of more than one author. Separate individual authors into enumerated individual {{para|author''n''}} parameters.
===Editors===
An editor may be cited using separate parameters for the editor's last and first name. A single or first editor would use {{para|editor-last}} and {{para|editor-first}}; subsequent editors would use {{para|editor2-last}} and {{para|editor2-first}}, {{para|editor3-last}} and {{para|editor3-first}}, etc.<ref group=Note>In Lua coded templates, the number of editors that can be listed in the citation and displayed when published is unlimited. In older templates that have not yet been converted to Lua coding, any number of editors may be listed in the citation, however only the first three will display, followed by "et al."</ref>
If an editor is notable and has a Wikipedia article, you may wikilink to that editor's Wikipedia article using {{para|editor-link}}. If a cited work has multiple editors, you may use {{para|editor2-link}}, {{para|editor3-link}}, etc. to wikilink to each editor's Wikipedia article. This method is used because {{para|editor-last}} and {{para|editor-first}} do not allow wikilinking. Please note that {{para|editor-link}} cannot be used to link to an external website; the external link will not render correctly.
If a cited source has a large number of editors, one can limit the number of editors displayed when the citation is published using the {{para|display-editors}} parameter as described in detail in the [[Help:Citation Style 1#Display options|Display options]] section of this help page.
===Others===
* '''others''': This parameter is used to credit contributors other than an author or an editor, such as an illustrator or a translator. You should include both the type of contribution and the name of the contributor, for example {{para|others|Illustrated by John Smith}} or {{para|others|Trans. Jones}}
===Dates===
Dates are indicated by these parameters:
* '''date''': Full date of publication edition being referenced, in the same format as other dates in citations in the same article. Must not be wikilinked.
* OR: '''year''': Year of publication edition being referenced.
** '''orig-year''': Original publication year, for display alongside the date or year. For clarity, please supply specifics, for instance <code>orig-year=First published 1859</code> or <code>orig-year=Composed 1904</code>. This parameter displays only if there is a value for ''year'' or ''date''.
For no date, or "undated", add as <code>date=n.d.</code>
Acceptable date formats are shown in the "Acceptable date formats" table of the [[MOS:DATEFORMAT|Manual of Style/Dates and numbers § Dates, months and years]]. Further points:
* Prescriptions about date formats only apply when the date is expressed in terms of Julian or Gregorian dates, or which use one of the seasons (spring, summer, autumn or fall, winter). Sources are at liberty to use other ways of expressing dates, such as "spring-summer" or a date in a religious calendar; editors should report the date as expressed by the source. [[WP:SEASON|Although the seasons are not normally capitalized]], they are capitalized when used as dates in CS1 templates, and the capitalization of the season stated by the source may be altered to follow this rule.
* Do not wikilink.
* Access and archive dates in references should be in either the format used for [[MOS:DATEUNIFY|publication dates]], or YYYY-MM-DD.
====CS1 compliance with Wikipedia's Manual of Style====
CS1 uses [[Wikipedia:Manual of Style/Dates and numbers]] § Dates, months and years ([[MOS:DATEFORMAT]]) as the reference for all date format checking performed by [[Module:Citation/CS1]]. For various reasons, CS1 is not fully compliant with MOS:DATEFORMAT. This table indicates CS1 compliance with the listed sections of MOS:DATEFORMAT.
{|class="wikitable" style="margin: 1em auto 1em auto;"
|+CS1 compliance with [[MOS:DATEFORMAT|Wikipedia:Manual of Style/Dates and numbers]]
!section !!compliant!! comment
|-
|[[MOS:DATEFORMAT#Acceptable date formats|Acceptable date formats table]]||yes||Exceptions: linked dates not supported;<br />sortable dates not supported ({{tlx|dts}} etc.);<br />proper name dates not supported with the exception of 'Christmas YYYY';<br />shortened month names longer than three characters or with terminating periods not supported;
|-
|[[MOS:DATEFORMAT#Unacceptable date formats|Unacceptable date formats table]]||yes||
|-
|[[MOS:DATEFORMAT#Consistency|Consistency]]||no||rowspan="3"|article level restrictions are beyond the scope of CS1
|-
|[[MOS:DATEFORMAT#Strong national ties to a topic|Strong national ties to a topic]]||no
|-
|[[MOS:DATEFORMAT#Retaining existing format|Retaining existing format]]||no
|-
|[[MOS:DATEFORMAT#Era style|Era style]]||no||Dates earlier than 100 not supported; it is rare for Wikipedia editors to read such old sources; the date of the source actually consulted should be provided in {{para|date}}, and the date of the ancient source may be provided in {{para|orig-year}}; the format of the orig-year value is not checked for errors.
|-
|[[MOS:DATEFORMAT#Julian and Gregorian calendars|Julian and Gregorian calendars]]||limited||Julian prior to 1582; Gregorian from 1582; assumes Gregorian in the overlap period of 1582 – c. 1923
|-
|[[MOS:DATEFORMAT#Ranges|Ranges]]||yes||Exceptions: does not support the use of <code>&ndash;</code> or <code>&nbsp;</code><br />does not support dates prior to 100;<br />does not support solidus separator (/)<br />does not support " to " as a date separator<br />does not support YYYY–YY where the two-digit year is less than 13 (change to YYYY–YYYY to eliminate the error message);
|-
|[[MOS:DATEFORMAT#Uncertain, incomplete, or approximate dates|Uncertain, incomplete, or approximate dates]]||yes||Exceptions: does not support {{tlx|circa}} or {{tlx|floruit}};<br />does not support dates prior to 100;<br />Supports <code>c. </code> only with a single year value (no ranges or day/month combinations).
|-
|[[MOS:DATEFORMAT#Days of the week|Days of the week]]||no||
|-
|[[MOS:DATEFORMAT#Seasons|Seasons]]||limited||CS1 capitalizes seasons used as dates in citations, in line with external style guides;
|-
|[[MOS:DATEFORMAT#Decades|Decades]]||no||
|-
|[[MOS:DATEFORMAT#Centuries and millennia|Centuries and millennia]]||no||
|-
|[[MOS:DATEFORMAT#Abbreviations for long periods of time|Abbreviations for long periods of time]]||no||
|}
====Date range, multiple sources in same year====
If dates are used with [[#Anchors|the ref=harv parameter]], the year range is 100 to present without era indication (AD, BC, CE, BCE). In the case where the same author has written more than one work in the same year, a lower-case letter may be appended to the year in the date parameter ({{xt|date = July 4, 1997b}}) or the year parameter ({{xt|year = 1997b}}).
===Titles and chapters===
* '''title''' The title of the cited source. Titles are displayed in italics, except for short works such as a {{tl|cite press release}} and cited articles in {{tlx|cite news}}, {{tlx|cite journal}}, {{tlx|cite web}}, {{tlx|cite conference}}, and {{tlx|cite podcast}}, where the title is shown in quotation marks. Use title case unless the cited source covers a scientific, legal or other technical topic and sentence case is the predominant style in journals on that topic. Use either [[MOS:CT|title case]] or sentence case consistently throughout the article. Do not omit a leading "The" from the title. Subtitles are typically separated from titles with ": " though " – " is also used. [[MOS:TM|As with trademarks]], Wikipedia {{em|does not}} attempt to emulate any stylistic flourishes used by the cited source's publisher, such as ALL-CAPS, all-lower-case, {{sm|Small Caps}}, etc.; use either standard title case or sentence case consistently. If the cited source is itself notable and has a Wikipedia article, the title can be wikilinked. Wikilinking the title will make it impossible to use the "url" parameter to link to an external copy of the cited source, so only do this when citing works that do not need to be externally linked. A link to the actual source is preferred to a link to a Wikipedia article about the source.
* '''script-title''': Languages that do not use a Latin-based alphabet, Arabic, Chinese, Cyrillic, Greek, Hebrew, Japanese, Korean, etc., should not be italicized and may also read [[right-to-left]] (rtl). To include titles in these languages, use '''script-title'''. Titles in '''script-title''' are wrapped in special HTML markup to isolate rtl script from adjacent left-to-right text. Part of that special markup is a language attribute that browsers can use to assist in the proper display of the script. Editors may add a prefix to the script that will identify the language. The prefix is an [[List of ISO 639-1 codes|ISO 639-1]] two-character language code followed by a colon: {{para|script-title|ar:<bdi>العربية</bdi>}}. Unrecognized codes are ignored and will display in the rendered citation.
* '''trans-title''': If the cited source is in a foreign language, an English translation of the title can be given here. This field will be displayed in square brackets after the title and will be linked to {{para|url}} if used.
* '''chapter''' The title of the cited chapter from the source, written in full. Displayed in quotes before the title. For websites arranged in sections the "at" parameter serves a similar function: {{para|at|Featured News}}
* '''script-chapter''': Languages that do not use a Latin-based alphabet, Arabic, Chinese, Cyrillic, Greek, Hebrew, Japanese, Korean, etc., may possibly read [[right-to-left]] (rtl). To include chapter titles in these languages, use '''script-chapter'''. Chapter titles in '''script-chapter''' are wrapped in special HTML markup to isolate rtl script from adjacent left-to-right text. Part of that special markup is a language attribute that browsers can use to assist in the proper display of the script. Editors may add a prefix to the script that will identify the language. The prefix is an [[List of ISO 639-1 codes|ISO 639-1]] two-character language code followed by a colon: {{para|script-title|ar:<bdi>العربية</bdi>}}. Unrecognized codes are ignored and will display in the rendered citation. This field will be displayed following the transliterated title.
* '''trans-chapter''': If the cited source is in a foreign language, an English translation of the cited chapter title can be given here. This field will be displayed in square brackets within the quotation marks which enclose the chapter field.
Titles containing certain characters will both display and link incorrectly unless those characters are replaced or encoded like this:
{| class="wikitable"
!Character
!Must be replaced with
|-
|newline
|space
|-
|[
|&#91;
|-
|]
|&#93;
|-
|<nowiki>|</nowiki>
|&#124;
|}
===Type===
* '''type''': Specifies the type of work cited. Appears in parentheses immediately after the title. Some templates use a default that can be overridden; example: {{tl|cite press release}} will show (Press release) by default. Other useful values are Review, Systemic review, Meta-analysis or Original article.
===Language===
* '''language''': The language the work is written in, if it is not English. Displayed before the title, enclosed in parentheses and prefixed with ''in''. Do not use icons in this field. If the source is listed as being in English, then this parameter will be ignored.
===Work and publisher===
{{see|WP:CITEHOW}}
* '''work''': Used by some templates such as {{tl|cite web}}, {{tl|cite news}} (where it is aliased to '''newspaper'''), {{tl|cite magazine}} (aliased to '''magazine'''), {{tl|cite journal}} (aliased to '''journal'''), and others where the citation is usually to a specific item in a larger work, most commonly an article in a website or print periodical, or an episode in a TV series. ''Do not confuse this with the "publisher" parameter'', which is for the publishing company. If the work is notable and has an article in Wikipedia, it should be wiki-linked at first appearance in citations in the article. If the "title" is already linked to externally, do not externally link to the "work".
:On websites, in most cases "work" is the name of the website (as usually given in the logo/banner area of the site, and/or appearing in the {{tag|title}} of the homepage, which may appear as the page title in your browser tab, depending on browser); otherwise use the site's domain name. If the "work" as given by the site/publication would be exactly the same as the name of the publisher, use the domain name; do not falsify the work's name by adding descriptive verbiage like "website of [Publisher]" or "[Publisher]'s Homepage". Capitalize for reading clarity, and omit "www.", e.g. convert "www.veterinaryresourcesuk.com" to "VeterinaryResourcesUK.com". Many journals use highly abbreviated titles when citing other journals (e.g. "J Am Vet Med" for "Journal of the [[American Veterinary Medical Association]]") because specialists in the field the journal covers usually already know what these abbreviations mean. Our readers do not, so these abbreviations should always be expanded. If the titled item being cited is part of some other larger work, such as a book, periodical or sub-organization, forming a sub-site at a domain name (e.g., the law school's section of a university's website system), it is usually better to use the name of that more specific work than that of the entire site/system. If the nature of the work and its relation to the site, book or other context in which it is found is complicated or confusing, simply explain the situation after the citation template and before the {{tag|ref|c}} that closes the citation.
* '''publisher''': the name of the organization that actually published the source. The field should not include the corporate designation such as "Ltd" or "Inc.", unless some ambiguity would result or the organization is usually known with that designation even in everyday use. "Publisher", "Publishing" and "Publications" can be abbreviated "Pubr.", "Pubg." and "Pubs." respectively, but some templates in this series include a period (full-stop) immediately after this parameter, so the period may have to be omitted; check the output if you abbreviate here. These words are usually safe to omit, but are usefully included where the publisher's name might be confusing. This is most often the case when the publisher's name is something like "Joshua Martin Publications", which without the designation might be mistaken for a co-author. A leading "The" can generally be omitted, again unless confusion might result (e.g., for [[The International Cat Association]], "The" is part of their official acronym, TICA). If the publisher is notable and has an article independent of the "work", the "publisher" parameter can include a wiki-link to that article, but should never externally link to the publisher's website. The "publisher" parameter should not be included either for mainstream, widely-known newspapers, or where it would be the same or mostly the same as the work/site/journal/etc., for example, the "publisher" parameter should be omitted in these examples:
::{{para|work|Amazon.com}}{{para|publisher|Amazon}}
::{{para|newspaper|''The Aberdeen Times''}}{{para|publisher|The Aberdeen Times}}<!--A genuine Idaho, US newspaper: http://www.smalltownpapers.com/newspapers/newspaper.php?id=1 -->
::{{para|newspaper|''[[USA Today]]''}}{{para|publisher|[[Gannett Company]]}}
::{{para|journal|''[[Journal of Physics G]]''}}{{para|publisher|[[IOP Publishing]]}}
:Whether the publisher needs to be included depends on the type of work. [[Wikipedia:Citing sources]] suggest it should be for books, but not necessarily other works. If the work is self-published, [[WP:SELFPUB|this is a very important fact]] about [[WP:RS|potential reliability of the source]], and needs to be specified; no consensus exists for the exact value of {{para|publisher}}, but some printed style guides suggest "author". When an exhaustive attempt to discover the name of the publisher (try [[whois]] for websites) fails, use {{para|publisher|<nowiki><!--Unspecified by source.--></nowiki>}} to explicitly indicate that this was checked, so other editors do not waste time duplicating your fruitless efforts. Do not guess at the publisher when this information is not clear.
* '''location''': Geographical place of publication, usually City, Country, or City, U.S. State; simply the city name by itself can be used for world-recognized cities like New York, London (except in articles about Canadian topics), Paris, Tokyo. Simply having a unique name does not mean it is globally recognizable; e.g., many people do not know where [[Mumbai]] is, especially if they are old enough that it was called [[Bombay]] for much of their lives. If in doubt, be more not less specific, since "Toronto, Canada" and "San Francisco, California" do not actually hurt anything. The {{para|location}} parameter should be omitted when it is implied by the name of the work, e.g. ''The New York Times''. The {{para|location}} parameter should be used when the location is part of the common name but not the actual name of a newspaper. For example, the newspaper commonly known as the ''New York Daily News'' is actually [[Daily News (New York)|''Daily News'' (New York)]] and can be entered with {{para|newspaper|Daily News}} {{para|location|New York}}, which yields ''Daily News'' (New York).
* '''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.
* '''via''' (optional): Name of the content deliverer (when they are ''not'' the publisher). '''via''' is not a replacement for '''publisher''', but provides additional detail. It may be used when the content deliverer presents the source in a format other than the original, or when the URL provided does not make clear the identity of the deliverer, or as suggested in [[WP:The Wikipedia Library]], e.g. [[WP:Credo accounts/Citations]]. See also [[#Registration or subscription required|§Registration or subscription required]].<!-- see Talk#Via -->
===Pages===
{| class="wikitable" style="float:right; margin-left:1em"
|+cs1{{pipe}}2 template support for<br />{{pipe}}volume=, {{pipe}}issue=, {{pipe}}page(s)=
|-
!template !! {{pipe}}volume= !! {{pipe}}issue= !! {{pipe}}page(s)=
|-
|{{tlx|citation}} || {{yes}} || {{yes}} || {{yes}}
|-
|{{tlx|cite arXiv}} || {{no}} || {{no}} || {{yes}}
|-
|{{tlx|cite AV media}} || {{yes}} || {{no}} || {{no}}
|-
|{{tlx|cite AV media notes}} || {{no}} || {{no}} || {{yes}}
|-
|{{tlx|cite book}} || {{yes}} || {{no}} || {{yes}}
|-
|{{plainlist|
*{{tlx|cite conference}}
*(as a book)}}
| {{no}} || {{no}} || {{yes}}
|-
|{{plainlist|
*{{tlx|cite conference}}
*(as a journal)}}
| {{yes}} || {{yes}} || {{yes}}
|-
|{{tlx|cite encyclopedia}} || {{yes}} || {{no}} || {{yes}}
|-
|{{tlx|cite episode}} || {{no}} || {{yes}} || {{no}}
|-
|{{tlx|cite interview}} || {{yes}} || {{yes}} || {{yes}}
|-
|{{tlx|cite journal}} || {{yes}} || {{yes}} || {{yes}}
|-
|{{tlx|cite magazine}} || {{yes}} || {{yes}} || {{yes}}
|-
|{{tlx|cite mailing list}} || {{no}} || {{no}} || {{no}}
|-
|{{plainlist|
*{{tlx|cite map}}
*(as book)}}
| {{yes}} || {{no}} || {{yes}}
|-
|{{plainlist|
*{{tlx|cite map}}
*(as journal or magazine)}}
| {{yes}} || {{yes}} || {{yes}}
|-
|{{tlx|cite news}} || {{yes}} || {{yes}} || {{yes}}
|-
|{{tlx|cite newsgroup}} || {{no}} || {{no}} || {{no}}
|-
|{{tlx|cite podcast}} || {{no}} || {{no}} || {{no}}
|-
|{{tlx|cite press release}} || {{no}} || {{no}} || {{yes}}
|-
|{{tlx|cite report}} || {{yes}} || {{no}} || {{yes}}
|-
|{{tlx|cite serial}} || {{no}} || {{no}} || {{no}}
|-
|{{tlx|cite sign}} || {{no}} || {{no}} || {{no}}
|-
|{{tlx|cite speech}} || {{no}} || {{no}} || {{no}}
|-
|{{tlx|cite techreport}} || {{yes}} || {{no}} || {{yes}}
|-
|{{tlx|cite thesis}} || {{yes}} || {{no}} || {{yes}}
|-
|{{tlx|cite web}} || {{no}} || {{no}} || {{yes}}
|-
|}
An editor may use any <u>one</u> of the following parameters in a given citation to refer to the specific page(s) or place in a cited source that contains the information that supports the article text. If more than one of the following parameters are used in the same citation, the error message <span style="color:red">Extra <code>|pages=</code> or <code>|at=</code> (</span>[[Help:CS1 errors#extra pages|help]]<span style="color:red">)</span> will display in the published citation. When more than one of the following parameters is used in error, {{para|page}} overrides both {{para|pages}} and {{para|at}}; {{para|pages}} overrides {{para|at}}. To resolve the error, remove extra parameters of this type until only one remains in the affected citation.
* '''page''': page in the cited source containing the information that supports the article text, for example {{para|page|52}} .
**'''Note:''' For a hyphenated page, use {{para|page|<nowiki>12{{hyphen}}34</nowiki>}}. This will not only properly display a hyphen, but also reduce the likelihood that an editor/bot will convert this to {{para|pages|<nowiki>12{{endash}}34</nowiki>}} by mistake.
* '''pages''': pages in the cited source containing the information that supports the article text. Separate page ranges with an [[En dash#En dash|en dash]]: – , for example {{para|pages|236–239}} . Separate non-sequential pages with a comma, for example {{para|pages|157,159}} . The form {{para|pages|461,466–467}} is used when you are citing both non-contiguous and sequential pages.
**'''Note:''' CS1 citations do not record the total number of pages in a cited source; do not use this parameter for that purpose.
* '''at''': place in the cited source containing the information that supports the article text when a page number is not given, is inappropriate or is insufficient. Common examples include column or col., paragraph or para. and section or sec. Depending on the source being cited, other indicators may be appropriate to use with the {{para|at}} parameter including, but not limited to, track, hours, minutes and seconds, act, scene, canto, book, part, folio, stanza, back cover, liner notes, indicia, colophon, dust jacket, etc. Examples include {{para|at|Column 2}} or {{para|at|Paragraph 5}} or {{para|at|Back cover}} or {{para|at|Act III, Scene 2}}.
===Edition identifiers===
* '''edition''': Identifies the particular edition of a cited source when the source has more than one edition, such as "2nd", "Revised", etc. Note that this parameter automatically displays " ed." after your entry. For example, {{para|edition|Revised third}} displays as: Revised third ed. The edition parameter can be omitted if there is no content difference between two editions of the same work; e.g. if a book was identically published in the UK and the US except, for example, ISBN number and cover art, it is not necessary to indicate either "UK" or "US" edition; or if citing minute:seconds of a film available in both a regular edition and a "Special Limited Collector's Edition", if the running time and cut are the same, it is not necessary to cite the particular edition.
* '''series''': When the source is part of a series, such as a book series or a journal where the issue numbering has restarted. For journal series, {{para|series}} should be limited to {{code|Original/New Series}}, {{code|First/Second/Third/... Series}}, or similar.{{refn|name=c17_14.126|group=Note|"Some numbered series have gone on so long that, as with certain long-lived journals, numbering has started over again, preceded by n.s. (new series), 2nd ser. (second series), or some similar notation, usually enclosed in commas. (A change of publisher may also be the occasion for a change in series designation.) Books in the old series may be identified by o.s., 1st ser., or whatever complements the notation for the new series."<ref>{{cite book |author=University of Chicago |title=The Chicago Manual of Style |edition=17th |year= 2017 |publisher=University of Chicago Press |page=14.126|location=Chicago |language= |isbn=978-0226104201}}</ref>
<p>For instance the journal ''[[Physical Review]]'', was numbered volumes 1–35 from 1893–1912 (the first series). In 1913–1969, the volume numbering restarted at 1 and went up to 188 (the second series). In 1970, ''Physical Review'' split into different parts, ''Physical Review A'', ''Physical Review B'', ''Physical Review C'', and ''Physical Review D'', where volumes again restarted at 1 (the third series). Since there are two publications identified as ''Physical Review, Volume 1'' , there is a need to distinguish which is which by use of {{para|series|First Series}} or {{para|series|Second Series}}. While ''Physical Review A'' is in the third series of the ''Physical Review'' [[media franchise]], it is the first series of the publication known as ''Physical Review A''. Since there is no confusion about what ''Physical Review A, Volume 1'' could be referring to, and there is no need to clarify to which numbering series the journal belong.</p>
<p>In particular, note that the {{para|series}} parameter is not to be used to distinguish the different parts of a [[media franchises]], like ''[[Physical Review A]]'', ''[[Acta Crystallographica Section A]]'', ''[[Journal of the Royal Statistical Society, Series B]]''.</p>}}
* '''volume''': For a source published in several volumes. This field is displayed in bold after the title and series parameters. An alternative is to include the volume information in the title parameter after the main title.
* '''issue''': When the source is part of a series that is published periodically. Aliases: '''number'''.
===External links===
* '''url''': Adds a link to the title
* '''chapter-url''': Adds a link to the chapter.
* '''format''': Format of the document at its URL (e.g., PDF, xls, etc.) Do not specify for HTML as it is implied as the default. Several [[Help:External link icons|URI schemes and filename extensions]] will show an icon— these icons have no alt text and do not meet [[Wikipedia:Manual of Style/Accessibility|accessibility standards]]. Do not use this parameter for completely different purposes, with annotations such as "fee required" or "reprint"; its intent is to notify readers what the file format is (e.g. in case some browsers might have trouble with it, or some might prefer to save the link to disk rather than open it in the browser). Access restrictions can be shown using {{para|subscription}} or {{para|registration}}, see [[#Registration or subscription required|Registration or subscription required]]. Other notes about reprintings, etc., should be placed after the template, and before {{tag|ref|c}}.
====Online sources====
{{main|WP:External links|WP:Citing sources}}
Links to sources are regarded as conveniences and are not required, except when citing Web-only sources. There are many digital libraries with works that may be used as sources.
* Links should be to full versions of the source.
* Online sources that require payment or subscription may be included per the [[Wikipedia:Verifiability|verifiability policy]].
Do not link to:
{{main|WP:LINKSTOAVOID}}
* Sites that do not have permission to republish the work or which otherwise violate copyright.
* Commercial sites such as Amazon, unless no alternative exists.
* Reviews of the work.
* Very short extracts such as Google Books snippet view where there is not enough context to verify the content, unless the entire work is also freely available there. (See [[WP:BOOKLINKS]])
====Link formats====
Links should be kept as simple as possible. For example, when performing a search for a Google Book, the link for ''Monty Python and Philosophy'' would look like:
:https://books.google.com/books?id=NPDgD546-doC&pg=PP1#v=onepage&q&f=false
But can be trimmed to:
:https://books.google.com/?id=NPDgD546-doC&pg=PP1#v=onepage&q&f=false
or:
:https://books.google.com/?id=NPDgD546-doC&printsec=frontcover
or:
:https://books.google.com/?id=NPDgD546-doC (if Google Books does not provide the cover page).
====Pages====
A direct link to a specific page may be used if supported by the host. For example, the link to page 172 of ''Monty Python and Philosophy'' on Google Books:
:https://books.google.com/?id=NPDgD546-doC&pg=PA172
like so:
:<code><nowiki>|page=[https://books.google.com/?id=wPQelKFNA5MC&pg=PA172 172]</nowiki></code>
If the same source is reused with different pages, separate citations must be created. A way around this problem is to use a short citation {{tlx|sfn}}, or {{tlx|rp}} to provide linked page number citations.
====Special characters====
{{MediaWiki URL rules}}
====Access date====
* '''access-date''': The full date when the content pointed to by '''url''' was last verified to support the text in the article; do not wikilink; requires '''url'''; use the same format as other access and archive dates in the citations. It is ''not required for linked documents that do not change.'' For example, '''access-date''' is not required for links to copies of published research papers accessed via DOI or a published book, but should be used for links to news articles on commercial websites (these can change from time to time, even if they are also published in a physical medium). Note that '''access-date''' is the date that the URL was checked to not just be working, but to support the assertion being cited (which the current version of the page may not do). Can be [[Help:Citation Style 1/accessdate|hidden or styled]] by registered editors. Alias: '''accessdate'''.
====Icons====
{{main|Help:External link icons}}
URLs with certain filename extensions or URI schemes will apply an icon specific to that file type. This is done through MediaWiki CSS, not these templates.
===Web archives===
{{see|Wikipedia:Link rot}}
* '''archive-url'''
* '''archive-date'''
The original link may become unavailable. When an archived version is located, the original URL is retained and {{para|archive-url}} is added with a link to an archived copy of a web page, usually from services like WebCite and the Internet Archive. {{para|archive-date}} must be added to show the date the page was archived, not the date the link was added. When {{para|archive-url}} is used, {{para|url}} and {{para|archive-date}} are required, else an error will show. When an archived link is used, the citation displays with the title linked to the archive and the original link at the end:
:{{cite journal |title=Monty Python and Philosophy |url=https://books.google.com/books?id=wPQelKFNA5MC |archive-url=https://web.archive.org/web/20130501102912/http://books.google.com/books?id=wPQelKFNA5MC |archive-date=May 1, 2013}}
* '''dead-url''': To change the order with the title retaining the original link and the archive linked at the end, set {{para|dead-url|no}}:
:{{cite journal |title=Monty Python and Philosophy |url=https://books.google.com/books?id=wPQelKFNA5MC |archive-url=https://web.archive.org/web/20130501102912/http://books.google.com/books?id=wPQelKFNA5MC |archive-date=May 1, 2013 |dead-url=no}}
:*When the original URL has been usurped for the purposes of spam, advertising, or is otherwise unsuitable, setting {{para|dead-url|unfit}} or {{para|dead-url|usurped}} suppresses display of the original URL (but {{para|url}} {{para|archive-url}} are still required).
===Identifiers===
{{Citation Style documentation/id2}}
A custom identifier can be specified through
{{Citation Style documentation/id1}}
===Registration or subscription required===
Citations of online sources that require registration or a subscription are acceptable in Wikipedia as documented in [[WP:PAYWALL|Verifiability – Access to sources]]. As a courtesy to readers and other editors, editors can signal the access restrictions of the external links included in a citation.
Four access levels can be used:
* [[File:Lock-green.svg|9px|link=|alt=Freely accessible|Freely accessible]] <code>free</code>: the source is free to read for anyone
* [[File:Lock-gray-alt-2.svg|9px|link=|alt=Free registration required|Free registration required]] <code>registration</code>: a free registration is required to access the source
* [[File:Lock-gray-alt-2.svg|9px|link=|alt=Free access subject to limited trial, subscription normally required|Free access subject to limited trial, subscription normally required]] <code>limited</code>: there are other constraints (such as a cap on daily views) to freely access this source
* [[File:Lock-red-alt.svg|9px|link=|alt=Paid subscription required|Paid subscription required]] <code>subscription</code>: the source is only accessible via a paid subscription
As there are often multiple external links with different access levels in the same citation, these values are attributed to a particular external link.
====Access level of {{para|url}}====
Links inserted with {{para|url}} are expected to be free to read by default. If not, editors can use one of
* {{para|url-access|subscription}}
* {{para|url-access|registration}}
* {{para|url-access|limited}}
to indicate the relevant access restriction.
====Access level of identifiers====
Links inserted by identifiers such as {{para|doi}} are not expected to offer a free full text by default. If they do, editors can use {{para|doi-access|free}} (in the case of {{para|doi}}) to indicate the relevant access level. The following identifiers are supported:
:* {{para|bibcode}} with {{para|bibcode-access|free}}
:* {{para|doi}} with {{para|doi-access|free}}
:* {{para|hdl}} with {{para|hdl-access|free}}
:* {{para|jstor}} with {{para|jstor-access|free}}
:* {{para|ol}} with {{para|ol-access|free}}
:* {{para|osti}} with {{para|osti-access|free}}
Some identifiers always link to free full texts. In this case, the access level is automatically indicated by the template. This is the case for {{para|arxiv}}, {{para|biorxiv}}, {{para|citeseerx}}, {{para|pmc}}, {{para|rfc}} and {{para|ssrn}}.
====Old access parameters====
The parameters {{para|registration|yes}} and {{para|subscription|yes}} can also be used to indicate the access level of a citation. However, they do not indicate which link they apply to, so editors are encouraged to use {{para|url-access|registration}} and {{para|url-access|subscription}} instead, when the restriction applies to {{para|url}}. If the restriction applies to an identifier, these parameters should be omitted.
===Quote===
* '''quote''': Relevant text quoted from the source; enclosed in quotes. When supplied, the citation terminator (a period by default) is suppressed, so the quote must include any terminating punctuation.
===Anchors===
* '''ref''': Creates an anchor for use with [[WP:CITESHORT|Shortened footnotes]] and [[WP:PAREN|parenthetical referencing]]. These styles use in-text cites with a link that will jump to an anchor created by the CS1 template. Anchors are not enabled by default. (See {{tl|Harvard citation documentation}} for details.)
* '''{{para|ref|harv}}''': Creates an anchor from up to four author last names and the year, of the format <code>CITEREF''lastname(s)year''</code>, suitable for a {{tlx|harv}}, {{tlx|sfn}} etc. Examples:
:<code><nowiki>{{cite book |first=Gary L. |last=Hardcastle |title=Monty Python and Philosophy |year=2006 |ref=harv}}</nowiki></code>
::Creates an anchor named [[#CITEREFHardcastle2006|<code>CITEREFHardcastle2006</code>]] which may be linked from {{tlx|harv|Hardcastle|2006|4=pp=12-34}}.
:<code><nowiki>{{cite book |first=Gary L. |last=Hardcastle |first2=George A. |last2=Reisch |title=Monty Python and Philosophy |year=2006 |ref=harv}}</nowiki></code>
::Creates an anchor named [[#CITEREFHardcastleReisch2006|<code>CITEREFHardcastleReisch2006</code>]] which may be linked from {{tlx|harv|Hardcastle|Reisch|2006|5=pp=12-34}}.
* '''{{para|ref|<var>ID</var>}}''': Creates a custom anchor defined by <var>ID</var>. This is useful where the author and/or date is unknown. The {{tlx|harvid}} template may be used here to create an anchor suitable for a {{tlx|harv}}, {{tlx|sfn}} etc. For example, <code><nowiki>ref={{harvid|Monty Python and Philosophy|2006}}</nowiki></code> creates an anchor which may be linked from {{tlx|harv|Monty Python and Philosophy|2006|4=pp=12-34}}.
===Display options===
These features are not often used, but can customize the display for use with other styles.
{{csdoc|display|lua=yes}}
====et al.====
et al. is the abbreviation of the Latin ''et alii'' (and others). It is used to complete a list of authors of a published work, where the complete list is considered overly long. The term is widely used in English, thus it is not italicized per [[MOS:FOREIGN]].
==Printing==
When viewing the page, CS1 templates render the URL to the title to create a link; when printing, the URL is printed. [[Help:External link icons|External link icons]] are not printed.
==Elements not included==
Not all factually accurate pieces of information about a source are used in a Citation Style 1 citation. Examples of information not included:
* The total number of pages in a cited source
* The name of the library that provided access to an electronic copy of a cited source
* The name of the library that owns a physical copy of a cited work
* The library record and/or shelf location of a physical copy of a cited work
==Tools==
{{main|Help:Citation tools}}
CS1 templates may be inserted manually or by use of tools:
* [[Wikipedia:TWL/Citoid|Citoid]], a tool built into [[WP:Visual Editor|Visual Editor]] that attempts to build a full citation based on a URL. See [[Wikipedia:VisualEditor/User guide#Using Citoid|user guide]].
* [[Wikipedia:RefToolbar|RefToolbar]] is part of the editing tool bar. Version 2.0 does not yet support all templates supported by version 1.0.
* [[User:ProveIt GT|ProveIt]] provides a graphical interface for editing, adding, and citing references. It may be enabled per the documentation.
* [https://reftag.appspot.com/ Wikipedia citation tool for Google Books]
* [https://reftag.appspot.com/doiweb.py DOI Wikipedia reference generator]
* [https://reftag.appspot.com/nytweb.py New York Times Wikipedia reference generator]
* [https://tools.wmflabs.org/dispenser/view/Reflinks Reflinks] Adds references to templates while updating/filling-in title/dates/publisher/accessdates etc.
* [https://tools.wmflabs.org/refill/ reFill] open source version of Reflinks
* [[Zotero]] can export citations in Wikipedia-ready format.
* [http://tools.wmflabs.org/citer/ Citer] - Generate shortened footnote or named reference for a given Google Books URL, ISBN, or DOI. Also supports some major news websites.
Error checking:
* [[User:Ucucha/HarvErrors]] is a script that may be enabled to display errors when using [[WP:CITESHORT|Shortened footnotes]] or [[WP:PAREN|parenthetical referencing]].
==Common issues==
{{shortcut|Help:CS1PROBS}}
; {{para|access-date}} does not show.
: If {{para|url}} is not supplied, then {{para|access-date}} does not show; by design.
; The bare URL shows before the title.
: If the {{para|title}} field includes a newline or an invalid character then the link will be malformed; see [[#Web links|Web links]].
; The title appears in red.
: If URL is supplied, then the title cannot be wikilinked.
; The URL is not linked and shows in brackets.
: The URL must include the [[URI scheme]] in order for MediaWiki to recognize it as a link. For example: <code>www.example.org</code> vs. <code>http://www.example.org</code>.
; A field is truncated.
: A pipe (<code>|</code>) in the value will truncate it. Use {{tlx|!}} instead.
; The template markup shows.
: Double open brackets [[ are used in a field without closing double brackets ]].
; The author shows in brackets with an external link icon.
: The use of an URL in {{para|author-link}} will break the link; this field is for the name of the Wikipedia article about the author, not a website.
; Multiple author or editor names are defined and one or more does not show
: The parameters must be used in sequence, i.e. if {{para|last}} or {{para|last1}} is not defined, then {{para|last2}} will not show. By design.
; {{para|page}}, {{para|pages}} or {{para|at}} do not show.
: These parameters are mutually exclusive, and only one will show; by design.
== See also ==
* [[Help:Citation Style 2]]
==Notes==
{{reflist|group=Note}}
==References==
{{reflist}}
{{Wikipedia referencing}}
{{Citation Style 1}}
{{Help navigation}}
[[Category:Citation Style 1 templates|*]]
[[Category:Wikipedia citation administration]]
