Template:Cite arXiv/doc

< Template:Cite arXiv
Revision as of 19:43, 6 December 2020 by Juho Kunsola (talk | contribs) (1 revision imported: Importing CS-1 templates and Template:Citation with the "include templates ticked")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
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 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 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 techreport}}technical reports
{{Cite thesis}}theses
{{Cite web}}web sources not covered by the above
See alsoSpecific-source templates
Wrapper templates

This Citation Style 1 template is used to create citations for preprints at the arXiv. It links to the abstract at http://www.arxiv.org/abs/eprint.

UsageEdit

To use the template, you need only specify the arxiv or eprint parameter. Once you save the page, Citation bot will detect the citation and complete it automatically.

Common parameters, horizontal format
{{cite arXiv |last= |first= |author-link= |eprint= |title= |class= |date= }}
  • arxiv or eprint (Mandatory): arXiv/Eprint identifier, without any "arXiv:" prefix. Prior to April 2007, the identifiers included a classification, an optional two-letter subdivision, and a 7-digit YYMMNNN year, month, and sequence number of submission in that category. E.g. gr-qc/0610068 or math.GT/0309136. After April 2007, the format was changed to a simple YYMM.NNNN. Starting in January 2015, the identifier was changed to be 5 digits: YYMM.NNNNN.
  • class: arXiv classification, e.g. hep-th. Optional. To be used only with new-style (2007 and later) eprint identifiers that do not include the classification.
  • title: Title of the cited paper.

The template uses the style of {{cite journal}}. Once a paper is accepted in a peer-reviewed journal, it is recommended to use one of those templates, as the peer-reviewed status of the article is important, while preserving the arXiv link in order to guarantee open access to the previous version of the article. To preserve the arXiv link, add e.g. |arxiv=gr-qc/0610068 or |arxiv=math.GT/0309136 or |arxiv=YYMM.NNNN (following the above examples) to the {{citation}} or {{cite journal}} templates.

ExamplesEdit

  • {{cite arXiv |last=Sparling |first=George A. J. |date=2006 |title=Spacetime is spinorial; new dimensions are timelike |eprint=gr-qc/0610068}}
Sparling, George A. J. (2006). "Spacetime is spinorial; new dimensions are timelike". arXiv:gr-qc/0610068.
  • {{cite arXiv |last=Leinster |first=Tom |date=2007 |title=The Euler characteristic of a category as the sum of a divergent series |eprint=0707.0835 |class=math.CT}}
Leinster, Tom (2007). "The Euler characteristic of a category as the sum of a divergent series". arXiv:0707.0835 [math.CT].

ParametersEdit

DeprecatedEdit

Deprecated CS1/CS2 parameters
Deprecated parameter Replace with Date
|authormask= |author-mask= October 2020
|authormaskn= |author-maskn= October 2020
|authornmask= |authorn-mask= October 2020
|displayauthors= |display-authors= October 2020
|editorlink= |editor-link= October 2020
|editorlinkn= |editor-linkn= October 2020
|editornlink= |editorn-link= October 2020
|editors= |editor= (1 editor) or |editorn= (more than 1 editor) or |veditors= (for Vancouver style editors). Consider |editor-maskn= if annotation is required. October 2020
|ignore-isbn-error= |isbn=((<isbn>)) October 2020
|last-author-amp= |name-list-style=amp October 2020
|lastauthoramp= |name-list-style=amp October 2020
|subjectlink= |subject-link= October 2020
|subjectlinkn= |subject-linkn= October 2020
|subjectnlink= |subjectn-link= October 2020
Recently removed CS1/CS2 parameters
Removed parameter Replace with Date
|authorfirst= |author-first= October 2020
|authorfirstn= |author-firstn= October 2020
|authornfirst= |authorn-first= October 2020
|authorlast= |author-last= October 2020
|authorlastn= |author-lastn= October 2020
|authornlast= |authorn-last= October 2020
|authorgiven= |author-given= October 2020
|authorgivenn= |author-givenn= October 2020
|authorngiven= |authorn-given= October 2020
|authorsurname= |author-surname= October 2020
|authorsurnamen= |author-surnamen= October 2020
|authornsurname= |authorn-surname= October 2020
|deadurl=yes |url-status=dead September 2019
|dead-url=yes |url-status=dead September 2019
|displayeditors= |display-editors= October 2020
|doi-broken= |doi-broken-date= October 2020
|doi-inactive-date= |doi-broken-date= October 2020
|editorfirst= |editor-first= October 2020
|editorfirstn= |editor-firstn= October 2020
|editornfirst= |editorn-first= October 2020
|editorlast= |editor-last= October 2020
|editorlastn= |editor-lastn= October 2020
|editornlast= |editorn-last= October 2020
|editorgiven= |editor-given= October 2020
|editorgivenn= |editor-givenn= October 2020
|editorngiven= |editorn-given= October 2020
|editorsurname= |editor-surname= October 2020
|editorsurnamen= |editor-surnamen= October 2020
|editornsurname= |editorn-surname= October 2020
|editormask= |editor-mask= October 2020
|editormaskn= |editor-maskn= October 2020
|editornmask= |editorn-mask= October 2020
|embargo= |pmc-embargo-date= October 2020
|ignoreisbnerror= |isbn=((<isbn>)) October 2020
|interviewerlink= |interviewer-link= October 2020
|interviewerlinkn= |interviewer-linkn= October 2020
|interviewernlink= |interviewern-link= October 2020
|interviewermask= |interviewer-mask= October 2020
|interviewermaskn= |interviewer-maskn= October 2020
|interviewernmask= |interviewern-mask= October 2020
|no-cat= |no-tracking= October 2020
|notracking= |no-tracking= October 2020
|registration= |url-access=registration January 2020
|series-separator= (delete) October 2020
|subscription= |url-access=subscription January 2020

In addition to the above list(s) of deprecated and removed parameters, all non-hyphenated aliases of parameters with hyphens are discouraged to be used in citation templates and are kept only for legacy support. They are subject to becoming deprecated and unsupported in the future as well. To streamline the appearance and improve consistency across the project, these variants should no longer be used when adding parameters to citation templates. Instead, select the hyphenated parameter variants and also consider switching other non-hyphenated parameters, which may be present in a citation already, to their hyphenated equivalents at the same time.

DescriptionEdit

AuthorsEdit

  • last: Surname of a single author. Do not wikilink—use author-link instead. For corporate authors or authors for whom only one name is listed by the source, use last or one of its aliases (e.g. |author=Bono). Aliases: surname, author, last1, surname1, author1.
    • author: this parameter is used to hold the complete name of a single author (first and last) or to hold the name of a corporate author. This parameter should never hold the names of more than one author. Do not wikilink—use author-link instead.
    • first: Given or first names of author; for example: Firstname Middlename or Firstname M. or Firstname M., Sr. Do not wikilink—use author-link instead. Aliases: given, first1, given1. Requires last; first name will not display if last is empty.
    • OR: for multiple authors, use last1, first1 through lastn, firstn, where n is any consecutive number for an unlimited number of authors (each firstn requires a corresponding lastn, but not the other way around). See the display parameters to change how many authors are displayed. Aliases: surname1, given1 through surnamen, givenn, or author1 through authorn. For an individual author plus an institutional author, you can use |first1=...|last1=...|author2=....
    • author-link: Title of existing Wikipedia article about the author—not the author's website; do not wikilink. Aliases: author-link1, authorlink, authorlink1, author1-link, author1link.
    • OR: for multiple authors, use author-link1 through author-linkn. Aliases: authorlink1 through authorlinkn, or author1-link through authorn-link, or author1link through authornlink.
    • name-list-style: accepts a limited list of keywords as value; when set to amp, ampersand, or &, inserts an ampersand between the last two names in a name list; when set to and, inserts the conjunction 'and' between the last two names of a name list; when set to vancdisplays name lists in Vancouver style when the lists use the last/first forms of name parameters. Alias: name-list-format (deprecated)
  • vauthors: comma-separated list of author names in Vancouver style; enclose corporate or institutional author names in doubled parentheses. End with etal if appropriate:
    |vauthors=Smythe JB, ((Megabux Corp.)), etal
    • author-link and author-mask may be used for the individual names in |vauthors= as described above
  • collaboration: Name of a group of authors or collaborators; requires author, last, or vauthors listing one or more primary authors; follows author name-list; appends "et al." to author name-list.
  • Note: When using shortened footnotes or parenthetical referencing styles with templates, do not use multiple names in one field, or else the anchor will not match the inline link.

DateEdit

  • date: Date of referenced source. Can be full date (day, month, and year) or partial date (month and year, season and year, or year). Use same format as other publication dates in the citations.[date 1] Required when year is used to disambiguate {{sfn}} links to multiple-work citations by the same author in the same year.[more] Do not wikilink. Displays after the authors and is enclosed in parentheses. If there is no author, then displays after publisher.. For acceptable date formats, see Help:Citation Style 1 § Dates.
For approximate year, precede with "c. ", like this: |date=c. 1900.

For no date, or "undated", use |date=n.d.
Automatic date formatting: Citation Style 1 and 2 templates, including this template, automatically render dates in all date parameters (such as |date=, |publication-date=, |access-date=, |archive-date=, etc.) except for |orig-date= in the style specified by the article's {{use dmy dates}} or {{use mdy dates}} template. See those templates' documentation for details.
  • year: Year of source being referenced. The usage of this parameter is discouraged; use the more flexible |date= parameter instead unless both of the following conditions are met:
    1. The |date= format is YYYY-MM-DD.
    2. The citation requires a CITEREF disambiguator.
  • orig-date: Original publication date or year; displays in square brackets after the date (or year). For clarity, please supply specifics. For example: |orig-date=First published 1859 or |orig-date=Composed 1904. As |orig-date= does not support automatic date formatting, use the same date format as defined by |df= (or, if it exists in the article, by |cs1-dates= of a {{use dmy dates}} or {{use mdy dates}} template), or as used in the |date= parameter. Alias: orig-year, origyear
  • df: date format; sets rendered dates to the specified format; does not support date ranges or seasonal dates; overrides the automatic date formatting described above. Accepts one value which may be one of these:
    dmy – set publication dates to day month year format; access- and archive-dates are not modified;
    mdy – as above for month day, year format
    ymd – as above for year initial numeric format YYYY-MM-DD
    dmy-all – set publication, access-, and archive-dates to day month year format;
    mdy-all – as above for month day, year format
    ymd-all – as above for year initial numeric format YYYY-MM-DD
  1. Publication dates in references within an article should all have the same format. This may be a different format from that used for archive and access dates. See MOS:DATEUNIFY.

TitleEdit

(See also Help:Citation Style 1 § Titles and chapters.)

  • title: Title of source. Displays in quotes.
Titles containing certain characters will not display and link correctly unless those characters are encoded.
newline [ ] |
space &#91; &#93; {{!}} (preferred)
{{bracket|text}} &#124; or {{pipe}}see also Help:Table § Rendering the pipe
  • language: The language (or a comma-separated list of the languages) in which the source is written, as either the ISO 639 language code (preferred) or the full language name. Examples: |language=ru;, |lang=fr, pt-br; |lang=Russian; |language=French, Portuguese. See the list of supported codes and names. Do not use templates or wikilinks. Displays in parentheses with "in" before the language name or names. When the only source language is English, no language is displayed in the citation. The use of languages recognized by the citation module adds the page to the appropriate subcategory of Category:CS1 foreign language sources. Because cs1|2 templates are often copied from en.wiki to other wikis, use of language codes is preferred so that language names render in the correct language and form: espagnol at a French-language wiki instead of the English word "Spanish". Aliases: lang

TemplateDataEdit

This is the TemplateData documentation for this template used by VisualEditor and other tools; see the monthly parameter usage report for this template.

TemplateData for Cite arXiv

<templatedata> { "params": { "arxiv": { "aliases": [ "eprint" ], "label": "arXiv ", "description": "arXiv identifier without the \"arXiv:\" prefix; can include version number", "type": "string", "required": true, "example": "1612.00008v1" }, "title": { "label": "Title", "description": "Title of the paper cited", "type": "string", "suggested": true }, "first": { "aliases": [ "first1", "given", "given1" ], "label": "First name", "description": "First name of first author", "type": "string", "suggested": true }, "last": { "aliases": [ "last1", "surname", "surname1" ], "label": "Last name", "description": "Last name of first author", "type": "string", "suggested": true }, "author": { "aliases": [ "author1" ], "label": "Author", "description": "Complete name of the first author", "type": "string" }, "author-link": { "aliases": [ "author-link1", "authorlink", "authorlink1", "author1-link", "author1link." ], "label": "Author's article", "description": "Title of the Wikipedia article about the first author", "type": "wiki-page-name" }, "first2": { "aliases": [ "given2" ], "label": "Author 2's first name", "description": "First name of second author", "type": "string" }, "last2": { "aliases": [ "surname2" ], "label": "Author 2's last name", "description": "Last name of second author", "type": "string" }, "author2": { "label": "Author 2", "description": "Full name of second author", "type": "string" }, "author-link2": { "aliases": [ "authorlink2", "author2-link", "author2link" ], "label": "Author 2's article", "description": "Title of Wikipedia article about the second author", "type": "wiki-page-name" }, "authors": { "label": "Authors", "description": "Full list of all authors", "type": "string" }, "collaboration": { "label": "collaboration", "description": "Name of a group of authors, in addition to the ones listed in the Author parameters", "type": "string" }, "class": { "label": "arXiv class", "description": "arXiv classification, for post-2007 ids ", "type": "string" }, "translator-last": { "aliases": [ "translator1-last", "translator-last1" ], "label": "Translator's last name", "description": "Translator's last name", "type": "string" }, "translator-first": { "aliases": [ "translator1-first", "translator-first1" ], "label": "Translator's first name", "description": "Translator's first name", "type": "string" }, "translator": { "aliases": [ "translator1" ], "label": "Translator", "description": "Full name of first translator", "type": "string" }, "translator-link": { "aliases": [ "translator-link1", "translator1-link" ], "label": "Translator's article", "description": "Title of Wikipedia article of the (first) translator", "type": "wiki-page-name" }, "translator-first2": { "aliases": [ "translator2-first" ], "label": "Translator 2's First name", "description": "Translator 2's First name", "type": "string" }, "translator-last2": { "aliases": [ "translator2-last" ], "label": "Translator 2's last name", "description": "Translator 2's last name", "type": "string" }, "translator2": { "label": "Translator 2", "description": "Full name of second translator", "type": "string" }, "translator-link2": { "aliases": [ "translator2-link" ], "label": "Translator 2's article", "description": "Title of WIkipedia article about second translator", "type": "wiki-page-name" }, "date": { "label": "Date", "description": "Date of the source being cited. Use n.d. for no date, and c. for inexact dated", "type": "string" }, "orig-year": { "aliases": [ "origyear" ], "label": "Original publication year", "description": "Original publication year, which displays after the main date. Be specific", "example": "First published 1859", "type": "string" }, "df": { "label": "Date format for publication dates", "description": "Either ymd (Year-Month-Day), dmy (Day-Month-Year), or mdy (Month-Day-Year) add -all at end to also affect access and archive dates", "example": "dmy", "type": "string" }, "trans-title": { "label": "Translated title", "description": "English translation of title", "type": "string" }, "language": { "label": "Language(s)", "description": "Language(s) the source is written in. Separate by commas, and do not include 'and'", "type": "string" }, "version": { "label": "Version", "description": "arXiv version", "deprecated": "Append to arXiv parameter", "type": "string" } }, "format": "inline", "description": "Formats a citation to a paper with an arXiv id", "paramOrder": [ "arxiv", "class", "version", "author", "first", "last", "first2", "last2", "author2", "author-link", "author-link2", "authors", "title", "translator", "translator-last", "translator-first", "translator-link", "translator-first2", "translator-last2", "translator2", "translator-link2", "collaboration", "date", "orig-year", "df", "trans-title", "language" ] } </templatedata>

External linksEdit