Chapter URL

வார்ப்புரு:Citation Style documentation/chapterurl

Anchor

• ref: the citation's HTML anchor identifier. When set, |ref=ID generates an anchor with the given ID (the id attribute in the citation's HTML tag). Setting |ref=ID identifies the template as a target and allows wikilinking to full references, especially useful with short-form citations like shortened notes and parenthetical referencing. The special value |ref=harv generates an anchor identifier suitable for use with {{sfn}} and {{harv}} templates. For |mode=cs2 |ref= defaults to |ref=harv.

Identifiers

• id: A unique identifier, used where none of the specialized identifiers are applicable; wikilink or use a template as applicable. For example, |id=NCJ 122967 will append "NCJ 122967" at the end of the citation. You can use templates such as |id={{NCJ|122967}} to append NCJ 122967 instead.

These identifiers create links and are designed to accept a single value. Using multiple values or other text will break the link and/or invalidate the identifier. In general, the parameters should include only the variable part of the identifier, e.g. rfc=822 or pmc=345678.

• arxiv: arXiv identifier; for example: arxiv=hep-th/9205027 (before April 2007) or arxiv=0706.0001 (April 2007 – December 2014) or arxiv=1501.00001 (since January 2015). Do not include extraneous file extensions like ".pdf" or ".html".
• asin: Amazon Standard Identification Number; if first character of asin value is a digit, use isbn. Because this link favours one specific distributor, include it only if standard identifiers are not available. Example asin=B00005N5PF
  • asin-tld: ASIN top-level domain for Amazon sites other than the US; valid values: au, br, ca, cn, co.jp, co.uk, de, es, fr, it, mx
• bibcode: Bibcode; used by a number of astronomical data systems; for example: 1974AJ.....79..819H. Comment: Techies are aware of the 2019 switch from old to new ADS URLs: the old URLs should continue working after October 2019 even though deprecated; see the April/May 2019 and June 2019 discussions.
• biorxiv: bioRxiv id, a 6-digit number at the end of the biorXiv URL (e.g. 078733 for http://biorxiv.org/content/early/2016/10/01/078733 or https://dx.doi.org/10.1101/078733)
• citeseerx: CiteSeerX id, a string of digits and dots found in a CiteSeerX URL (e.g. 10.1.1.176.341 for http://citeseerx.ist.psu.edu/viewdoc/summary?doi=10.1.1.176.341 )
• doi: எண்ணிம ஆவணச் சுட்டி; for example: 10.1038/news070508-7. It is checked to ensure it begins with (10.).
  • doi-broken-date: Date the DOI was found to be non-working at https://dx.doi.org. Use the same format as other dates in the article. Alias: doi-inactive-date
• eissn: International Standard Serial Number for the electronic media of a serial publication; eight characters may be split into two groups of four using a hyphen, but not an en dash or a space; example eissn=1557-2986 Alias: EISSN
• hdl: Handle System identifier for digital objects and other resources on the Internet; example hdl=20.1000/100 Alias: HDL
• isbn: International Standard Book Number; for example: 978-0-8126-9593-9.
• ismn: International Standard Music Number; for example: 979-0-9016791-7-7. Hyphens or spaces in the ISMN are optional. Use the ISMN actually printed on or in the work. This parameter should hold only the ISMN without any additional characters. It is checked for length, invalid characters – anything other than numbers, spaces, and hyphens – and the proper check digit. Alias: ISMN
• issn: International Standard Serial Number; eight characters may be split into two groups of four using a hyphen, but not an en dash or a space; example issn=2049-3630 Alias: ISSN
• jfm: Jahrbuch über die Fortschritte der Mathematik; example jfm=53.0144.01
• jstor: JSTOR reference number; for example: jstor=3793107 will generate JSTOR 3793107.
• lccn: Library of Congress Control Number. When present, alphabetic prefix characters are to be lower case; example lccn=2004042477
• mr: Mathematical Reviews; example mr=630583
• oclc: OCLC; WorldCat's Online Computer Library Center; example oclc=9355469
• ol: Open Library identifier; do not include "OL" in the value; example ol=7030731M
• osti: Office of Scientific and Technical Information; example osti=4367507
• pmc: PubMed Central; use article number for full-text free repository of a journal article, e.g. pmc=345678. Do not include "PMC" in the value.
• pmid: PubMed; use unique identifier; example pmid=17322060
• rfc: Request for Comments; example rfc=3143
• ssrn: Social Science Research Network; example ssrn=1900856
• zbl: Zentralblatt MATH; example zbl=0472.53010 For zbMATH search results like JFM 35.0387.02 use jfm=35.0387.02

Quote

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

Editors

• editor-last: Surname of editor. Do not wikilink—use editor-link instead. Where the surname is usually written first—as in Chinese—or for corporate authors, simply use editor-last to include the same format as the source. Aliases: editor-last1, editor1-last, editor-surname, editor-surname1, editor1-surname, editor, editor1.
  • editor: this parameter is used to hold the complete name of a single editor (first and last), or the name of an editorial committee. This parameter should never hold the names of more than one editor.
  • editor-first: Given or first names of editor, including title(s); example: Firstname Middlename or Firstname M. or Dr. Firstname M., Sr. Do not wikilink—use editor-link instead. Aliases: editor-first1, editor1-first, editor-given, editor-given1, editor1-given.
  • OR: for multiple editors, use editor-last1, editor-first1 through editor-lastn, editor-firstn (Aliases: editorn-last, editor-surnamen or editorn-surname; editorn-first, editor-givenn or editorn-given; editorn). For an individual editor plus an institutional editor, you can use |editor-first1=...|editor-last1=... |editor2=....

• editor-link: Title of existing Wikipedia article about the editor—not the editor's website; do not wikilink. Aliases: editor-link1.
• OR: for multiple editors, use editor-link1 through editor-linkn (alias editorn-link).
• name-list-format: displays authors and editors in Vancouver style when set to vanc and when the list uses last/first parameters for the name list(s)

• veditors: comma separated list of editor names in Vancouver style; enclose corporate or institutional names in doubled parentheses:
  |veditors=Smythe JB ((Megabux Corp.))

• editor-linkn and editor-maskn may be used for the individual names in |veditors=, as described above

• editors: Free-form list of editor names; use of this parameter is discouraged; not an alias of editor-last

Display:
Use display-editors to control the length of the displayed editor name list and to specify when "et al." is included.
If authors: Authors are first, followed by the included work, then "In" and the editors, then the main work.
If no authors: Editors appear before the included work; a single editor is followed by "ed."; multiple editors are followed by "eds."

Laysummary

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

Display options

• mode: Sets element separator, default terminal punctuation, and certain capitalization according to the value provided. For |mode=cs1, element separator and terminal punctuation is a period (.); where appropriate, initial letters of certain words are capitalized ('Retrieved...'). For |mode=cs2, element separator is a comma (,); terminal punctuation is omitted; where appropriate, initial letters of certain words are not capitalized ('retrieved...'). To override default terminal punctuation use postscript.
• author-mask: Replaces the name of the first author with em dashes or text. Set author-mask to a numeric value n to set the dash n em spaces wide; set author-mask to a text value to display the text without a trailing author separator; for example, "with". You must still include the values for all authors for metadata purposes. Primarily intended for use with bibliographies or bibliography styles where multiple works by a single author are listed sequentially such as shortened footnotes. Do not use in a list generated by {{reflist}}, or similar as there is no control of the order in which references are displayed. You can also use editor-mask and translator-mask in the same way. Mask parameters can take a number in the name of the parameter (e.g. |authorn-mask=) to specify which author the mask should apply to.
• display-authors: Controls the number of author names that are displayed when a citation is published. To change the displayed number of authors, set display-authors to the desired number. For example, |display-authors=2 will display only the first two authors in a citation. By default, all authors are displayed. |display-authors=etal displays all authors in the list followed by et al. Aliases: displayauthors.
• display-editors: Controls the number of editor names that are displayed when a citation is published. To change the displayed number of editors, set display-editors to the desired number. For example, |display-editors=2 will display only the first two editors in a citation. By default, all editors are displayed. |display-editors=etal displays all editors in the list followed by et al. Aliases: displayeditors.
• last-author-amp: Switches the separator between the last two names of the author list to space ampersand space ( & ) when set to y, yes, or true. Example: |last-author-amp=yes
• postscript: Controls the closing punctuation for a citation; defaults to a period (.); for no terminating punctuation, specify |postscript=none – leaving |postscript= empty is the same as omitting it, but is ambiguous. Additional text or templates beyond the terminating punctuation may generate an error message. |postscript= is ignored if quote is defined.

Subscription or registration required

Citations of online sources that require registration or a subscription are acceptable in Wikipedia as documented in Verifiability – Access to sources. As a courtesy to readers and other editors, editors should signal the access restrictions of the external links included in a citation. Nota bene: access icons do not display correctly for editors who use Modern skin.

Four access levels can be used:

• free: the source is free to read for anyone (this applies in particular to articles in open access)
• registration: a free registration is required to access the source
• limited: there are other constraints (such as a cap on daily views) to freely access this source
• subscription: the source is only accessible via a paid subscription ("paywall")

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 indicators for url-holding parameters

Sources linked by |url=, |chapter-url=, |entry-url=, |article-url=, and |section-url= are presumed to be free-to-read. When they are not free-to-read, editors should mark those sources with the matching access-indicator parameter so that an appropriate icon is included in the rendered citation. Because the sources linked by these url-holding parameters are presumed to be free-to-read, they may not be marked as free.

url-holding and access-indicator parameters

url	access	allowed keywords
|url=	|url-access=	registration limited subscription
|article-url=	|article-url-access=
|chapter-url=	|chapter-url-access=
|contribution-url=	|chapter-url-access=
|entry-url=	|entry-url-access=
|section-url=	|section-url-access=

|contribution-url-access= not currently defined; use its alias |chapter-url-access=

Access indicators for named identifiers

Links inserted by named identifiers are presumed to lie behind a paywall or registration barrier – exceptions listed below. When they are free-to-read, editors should mark those sources with the matching access-indicator parameter so that an appropriate icon is included in the rendered citation. Because the sources linked by these named-identifier parameters are not presumed to be free-to-read, they may not be marked as limited, registration, or subscription.

named-identifier and access-indicator parameters

identifier	access	allowed keywords
|bibcode=	|bibcode-access=	free
|doi=	|doi-access=
|hdl=	|hdl-access=
|jstor=	|jstor-access=
|ol=	|ol-access=
|osti=	|osti-access=

Some named-identifiers are always free-to-read. For those named-identifiers there are no access-indicator parameters, the access level is automatically indicated by the template. These named identifiers are:

• |arxiv=
• |biorxiv=
• |citeseerx=
• |pmc=
• |rfc=
• |ssrn=

Ambiguous access parameters

The parameters |registration=yes and |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 |url-access=registration and |url-access=subscription instead, when the restriction applies to |url=. If the restriction applies to an identifier, these parameters should be omitted.

These parameters add a link note to the end of the citation:

• registration: (deprecated) For online sources that require registration, set |registration=yes (or y, or true); yields to subscription if both are set. Use the appropriate access-indicator parameter
• subscription: (deprecated) For online sources that require a subscription, set |subscription=yes (or y, or true); supersedes registration if both are set. Use the appropriate access-indicator parameter

Setting |registration= or |subscription= to any value other than y, yes, or true will generate an error message.

TemplateData

See Template:Cite book/TemplateData.

See also

• Reftag, tool for translating Google Books permalinks into Wikipedia references

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