Jump to content

User:Rjjiii/sandbox3

From Wikipedia, the free encyclopedia
Citation Style 1 templates
{{Cite arXiv}}arXiv preprints
{{Cite AV media}}audio and visual media
{{Cite AV media notes}}AV media liner notes
{{Cite bioRxiv}}bioRxiv preprints
{{Cite book}}books and chapters
{{Cite CiteSeerX}}CiteSeerX papers
{{Cite conference}}conference papers
{{Cite document}}short, stand-alone, offline documents
{{Cite encyclopedia}}edited collections
{{Cite episode}}radio or TV episodes
{{Cite interview}}interviews
{{Cite journal}}academic journals
{{Cite magazine}}magazines, periodicals
{{Cite mailing list}}public mailing lists
{{Cite map}}maps
{{Cite medRxiv}}medRxiv preprints
{{Cite news}}news articles
{{Cite newsgroup}}online newsgroups
{{Cite podcast}}podcasts
{{Cite press release}}press releases
{{Cite report}}reports
{{Cite serial}}audio or video serials
{{Cite sign}}signs, plaques
{{Cite speech}}speeches
{{Cite SSRN}}SSRN papers
{{Cite tech report}}technical reports
{{Cite thesis}}theses
{{Cite web}}web sources not covered by the above
See alsoSpecific-source templates
Citation Style 1 wrapper templates

Citation Style 1 (CS1) is a collection of reference citation templates used on Wikipedia. The various CS1 templates all use Module:Citation/CS1. Its purpose is to provide a set of default formats for references.Cite error: There are <ref> tags on this page without content in them (see the help page). The use of CS1 or of templates is not required.[1] CS1 also refers to the default style of rendering used by CS1 templates.

CS1's rendered citation is based on Wikipedia's own Manual of Style, elements of The Chicago Manual of Style, and the Publication Manual of the American Psychological Association, with adaptations.

How the templates work

[edit]

CS1 templates present a citation generally as:

With author
Author (14 November 2024). "Title". Work. Publisher. p. x. Identifiers.
Without author
"Title". Work. Publisher. 14 November 2024. p. x. Identifiers.

Authors

[edit]

You can add authors to a citation by placing their first and last name into the template's parameters. To add a single author, use |last= and |first=. If a cited source has multiple authors, use |last2= and |first2=, |last3= and |first3=, etc.[2] For symmetry with the other numbered parameters, |last1= and |first1= are available as well, as shown in the following example:

  • {{cite book |last1=Hawking |first1=Stephen |last2=Hawking |first2=Lucy |title=George's Secret Key to the Universe}}
  • Hawking, Stephen; Hawking, Lucy. George's Secret Key to the Universe.

In situations where "first" and "last" do not fit the authorship of the source you can use |author= and |authorn=.[3] An editor may be cited using separate parameters for the editor's last and first name. A single or first editor would use |editor-last= and |editor-first=; subsequent editors would use |editor2-last= and |editor2-first=, |editor3-last= and |editor3-first=, etc.[2] Similar to the |author= parameter, you can cite editors using |editor= and |editorn=. By default, the templates will use the author parameters to create link anchors for shortened footnotes. If an author parameter is not used, the template will render the editor in the author location and use the editors for shortened footnotes; if neither author nor editor parameters are used, the template will not automatically create an anchor for shortened footnotes. If the cited source does not credit an author, as is common with newswire reports, press releases or company websites use: |author=<!--Not stated-->[4]

Citation
Source
CS1 markup CS1 output Short citation
Author and editor, using last names {{cite book |title=Title |last=Last |first=First |editor-first=Editor-First |editor-last=Editor‐Last |date=1999}} Last, First (1999). Editor‐Last, Editor-First (ed.). Title. Last 1999
Author and editor {{cite book |title=Title |author=Author |editor=Editor |date=1999}} Author (1999). Editor (ed.). Title. Author 1999
Editor but no author {{cite book |title=Title |editor=Editor |date=1999}} Editor, ed. (1999). Title. Editor 1999
Neither {{cite book |title=Title |author=<!--Not stated--> |date=1999 |ref={{sfnref|Title|1999}}}} Title. 1999. Title 1999

Date

[edit]

The year or the full date can be placed in the |date= parameter. Available formats are shown in the "Acceptable date formats" table of the Manual of Style/Dates and numbers § Dates, months and years. For an approximate year, precede with "c. ", like this: |date=c. 1900. When a source does not have a publication date, use |date=n.d..

Citation Style 1 and 2 templates automatically render dates in the style specified by the article's {{use dmy dates}} or {{use mdy dates}} template. See those templates' documentation for details.

Title

[edit]

The title of the source will be displayed in italics or "quotes" depending on the type of source. Templates for longer works, like {{cite book}} will render the title in italics. Templates for shorter works, like {{cite journal}}, will render the title in quotation marks.[5]

The title of the source should be placed in the |title= parameter. For periodicals or web sources, this will be the name of the individual article. The name of the publication containing the article belongs in the |work= parameter. When citing a smaller section within a book or other longer source, use the |section= parameter or one of its aliases.[6] See below:

{{Cite book}}
{{cite book |title=Title |date={{date}} |section=Section}}
"Section". Title. 14 November 2024.
{{Cite journal}}
{{cite journal |title=Title |date={{date}} |work=Work}}
"Title". Work. 14 November 2024.

Work

[edit]

The |work= is the name of the larger work containing the cited source. It is used in templates that create citations to shorter pieces like articles in a journal, newspaper, magazine, or website. Do not confuse this with the "publisher" parameter, which is for the publishing organization. Some templates have descriptive aliases for the "work":

Aliases for "work"
Template Work alias
{{cite journal}} |journal=
{{cite magazine}} |magazine=
{{cite news}} |newspaper=
{{cite web}} |website=

For websites, "work" is usually the name of the website. Do not append ".com" or the like if the site's actual title does not include it (thus |work=[[Salon (magazine)|Salon]], not Salon.com). Many journals use highly abbreviated titles when citing other journals because specialists in the field the journal covers usually already know what these abbreviations mean. Our readers usually do not, so these abbreviations should always be expanded. For example, use |work=Journal of the American Veterinary Medical Association rather than J. Am. Vet. Med. for the Journal of the American Veterinary Medical Association.

Publisher

[edit]

The |publisher= is the organization that publishes the source. If the publisher has an article on Wikipedia, the parameter can include a wiki-link to that article, but should never externally link to the publisher's website. If the source is self-published, "self-published" can be placed into the parameter.

The publisher is an optional part of a citation. The type of source and the notability of the publisher are used to determine whether to include it. WP:Citing sources and off-Wikipedia citation guides suggest including the publisher of books. Periodicals, especially scholarly journals, may not need the publisher in the citation. The parameter should not be included for widely-known periodicals or when the publisher is synonymous with the publication; the publication itself will be in the |work= parameter. For example, the "publisher" parameter should be omitted in these examples:

  • |work=[[Amazon.⁠com]]|publisher=Amazon Inc.
  • |newspaper=The Aberdeen Times|publisher=The Aberdeen Times
  • |newspaper=[[The New York Times]]|publisher=The New York Times Company
  • |newspaper=[[USA Today]]|publisher=[[Gannett Company]]
  • |journal=[[Nature (journal)|Nature]]|publisher=[[Nature Research]]

Pages

[edit]

One of several parameters can indicate a location within a source. Only one of the parameters listed below can be used in a single citation.[7]

|p=
For a single page. For example, using |p=52 or |p=viii would generate p. 52 or p. viii
|pp=
For multiple pages. For example, using |pp=236-239 or |pp=157, 159 would generate pp. 236–239 or pp. 157, 159
|at=
For locations that cannot be adequately described in page numbers. Examples include |at=Column 2, |at=Back cover, or |at=Act III, Scene 2. It will rendered as typed so |at=Paragraph 5 generates Paragraph 5, and |at=para. 5 generates para. 5[8]

Non-textual citation templates may accept other in-source location parameters including |minutes=, |time=, |event=, or |inset=.

Identifiers

[edit]

A unique identifier is a number, name, or code assigned to one specific version of a specific source. Several types of identifiers can be included within a citation including ISBN, DOI, OCLC, and PMID. Any identifiers are appended to the end of the citation in alphabetic order. They are automatically linked to services that aid in locating the source.

CS1 style in other templates

[edit]

Apply CS1 to a single "Citation" template

[edit]

By default, the {{Citation}} template uses CS2 formatting. To use CS1 formatting, add |mode=cs1 to the template's parameters. For example, {{Citation}} uses CS2 formatting, but {{Citation |mode=cs1}} uses CS1 formatting.

Apply CS1 to all "Citation" templates in an article

[edit]

Add {{cs1 config |mode=cs1}} to the article, preferably near the top of the page,[9] to apply CS1 formatting to all citations on a page using Module:Citation/CS1.

Tools

[edit]

CS1 templates may be inserted manually or by use of tools:

  • RefToolbar is part of the the default source code editor.[10] It include a "Templates" menu with {{cite web}}, {{cite journal}}, {{cite book}}, and {{cite news}}. When filling out a template from the RefToolbar, select the magnifying glass icon to autofill the template's parameters.[11]
  • The default citation option in the Visual Editor attempts to build a full citation based on a URL or other identifier.[11] It will automatically select a citation template.
  • ProveIt provides an optional graphical interface for editing, adding, and citing references.[11]
  • Citation expander adds a button to pass the current article to the Wikipedia citation bot, a tool that will automatically fill out additional parameter of existing citations.
  • reFill Adds references to templates while updating/filling-in title/dates/publisher/accessdates etc.[12]
  • Zotero can export citations in Wikipedia-ready format.
  • Citer – generates full citation, shortened citation, and named reference for a given Google Books URL, ISBN, or DOI. It also supports some major news websites.
General-use CS1 templates
Template Use RefToolbar ProveIt Citation expander
{{Cite arXiv}} arXiv preprints
{{Cite AV media}} audio and visual sources supported
{{Cite AV media notes}} liner notes from albums, DVDs, CDs and similar audio-visual media
{{Cite book}} books supported supported supported
{{Cite conference}} conference papers supported
{{Cite encyclopedia}} edited collections supported
{{Cite episode}} television or radio programs and episodes supported
{{Cite interview}} interviews
{{Cite journal}} academic and scientific papers published in journals supported supported supported
{{Cite magazine}} magazines and newsletters supported
{{Cite mailing list}} archived public mailing lists
{{Cite map}} maps
{{Cite news}} news articles in print, video, audio or web supported supported Partially supported[13]
{{Cite newsgroup}} online newsgroups
{{Cite podcast}} audio or video podcast
{{Cite press release}} press releases supported
{{Cite report}} reports by government departments, instrumentalities, operated companies, etc. supported
{{Cite serial}} audio or video serials
{{Cite sign}} signs, plaques and other visual sources supported
{{Cite speech}} speeches
{{Cite tech report}} technical reports
{{Cite thesis}} theses supported
{{Cite web}} web sources not characterized by another template supported supported supported

Error checking scripts:

Reliability scripts:

Other:

Common issues

[edit]
|access-date= does not show.
If |url= is not supplied, then |access-date= does not show; by design.
The bare URL shows before the title.
If the |title= field includes a newline or an invalid character then the link will be malformed; see 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: www.example.org/ vs. http://www.example.org/.
A field is truncated.
A pipe (|) in the value will truncate it. Use {{!}} 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 |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 |last= or |last1= is not defined, then |last2= will not show. By design.
|page=, |pages= or |at= do not show.
These parameters are mutually exclusive, and only one will show; by design.

See also

[edit]

Notes

[edit]
  1. ^ Per WP:CITESTYLE:

    Wikipedia does not have a single 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 guides. However, citations within a given article should follow a consistent style.

  2. ^ a b The number of authors that can be listed in the citation and displayed when published is unlimited.
  3. ^ This includes organizational authors or authors from cultures where a "last" name does not correspond to a surname. |author= should never hold the name of more than one author.
  4. ^ 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.
  5. ^ {{cite report}} for reports published without a formal ISBN or ISSN is an exception that uses neither.
  6. ^ The following parameters are aliases of |section= and work the same: |chapter=, |contribution=, |entry=, and |article=.
  7. ^ If more than one of the following parameters are used in the same citation, the error message Extra |pages= or |at= (help) will display in the published citation. When more than one of the following parameters is used in error, |page= overrides both |pages= and |at=; |pages= overrides |at=. To resolve the error, remove extra parameters of this type until only one remains in the affected citation.
  8. ^ Common citation methods like Chicago, APA, MLA, and Bluebook include many standard abbreviations for elements of a text. Any of these can be used within the |at= parameter. For example, |at=ch. 7.
    Location Abbreviation
    Chapter ch. or chpt.
    Figure fig.
    Article art.
    Part pt.
    Section sec. or §
    Sections sec., secs., or §§
    Paragraph para. or ¶
    Paragraphs paras. or ¶¶
  9. ^ See MOS:ORDER.
  10. ^ The "Source Editing" WikiEditor includes refToolbar 2.0 and is the default editor.
  11. ^ a b c Autofill is handled by Citoid, a service which will automatically fill a templates parameters when provided the URL, DOI, ISBN, PMID, PMCID or QID.
  12. ^ This is an open source version of the older Reflinks tool.
  13. ^ Citation expander will only attempt to tidy up the citation and will not add new content