When updating this template keep in mind that it is used on a number of template documentation pages. If the parameters in question are unique to a template, then either add it manually to the template documentation or create a new section here for transclusion. |
This template is used to build consistent documentation pages for Citation Style 1 templates.
((Citation Style documentation|author))
will show the author documentation.Where a particular section of documentation is not appropriate for a certain template, simply add the text manually or create a new subtemplate.
Each module of text is a subtemplate that can be edited using the link.
When creating template documentation, use the following order of sections and content:
Use ((csdoc|lead|content))
to create consistent content for the lead:
Henda Citation Style 1 fyrimyndin verður nýtt til at skapa citations fyri .
Options for this field:
One unnamed parameter is used to create the trailing text.
Markup | Renders as |
---|---|
((csdoc|lead|books)) |
Henda Citation Style 1 fyrimyndin verður nýtt til at skapa citations fyri books. |
Uses Lua: |
Start the usage section with ((csdoc|usage))
:
Parameters to copy are enclosed in tables created by sub-templates.
((csdoc|usage full))
:
to create an indent<code><nowiki>...</nowiki>
</code>
((end))
((csdoc|usage full)) :<code><nowiki>((cite book |last1= |first1= |authorlink1= |last2= |first2= |authorlink2= |editor1-first= |editor1-last= |editor1-link= |others= |title= |trans_title= |url= |archiveurl= |archivedate= |format= |accessdate= |type= |edition= |series= |volume= |date= |year= |origyear= |publisher= |location= |language= |isbn= |oclc= |doi= |id= |page= |pages= |at= |trans_chapter= |chapter= |chapterurl= |quote= |ref= |bibcode= |layurl= |laysource= |laydate= |author-mask= |display-authors= |postscript= |lastauthoramp=))</nowiki></code> ((end))
|
((csdoc|usage common))
:
to create an indent<code><nowiki>...</nowiki>
</code>
((end))
((csdoc|usage common)) :<code><nowiki>((cite book |last= |first= |authorlink= |title= |url= |accessdate= |year= |publisher= |location= |isbn= |page= |pages=))</nowiki></code> ((end))
|
The full vertical style is created in three columns: Vertical list, Prerequisites and Brief instructions / notes.
((csdoc|usage vertical)) <pre style="margin:0px;">
</pre> ((csdoc|usage vertical mid)) <pre style="margin:0px;">
</pre> ((csdoc|usage vertical mid)) <pre style="margin:0px;">
</pre> ((csdoc|usage vertical end))
Example:
((csdoc|usage vertical)) <pre style="margin:0px;"> ((cite book | last = | first = | authorlink = )) </pre> ((csdoc|usage vertical mid)) <pre style="margin:0px;"> last </pre> ((csdoc|usage vertical mid)) <pre style="margin:0px;"> same as last1 same as first1 </pre> ((csdoc|usage vertical end))
Vertical list | Prerequisites | Brief instructions / notes |
---|---|---|
((cite book | last = | first = | authorlink = )) |
last |
same as last1 same as first1 |
Copy a blank version to use. All parameter names must be in lowercase. Use the "|" (pipe) character between each parameter. Delete unused parameters to avoid clutter in the edit window. Some samples may include the current date. If the date is not current, then
the page. |}
Vertical list | Prerequisites | Brief instructions / notes |
---|---|---|
| style="vertical-align:top;" | |}
|}
Use ((markup2)) to format the examples; see the template documentation for use.
((markup2 |t=Basic usage with url (and accessdate) and edition |m=((cite book |title=Mysterious book)) |r=((cite book |title=Mysterious book)) ))
Basic usage with url (and accessdate) and edition
*((cite book |title=Mysterious book))
Nested parameters rely on their parent parameters:
This template embeds COinS metadata in the HTML output, allowing reference management software to retrieve bibliographic metadata. See: Wikipedia:COinS. As a general rule, only one data item per parameter. Do not include explanatory or alternate text:
|date=27 September 2007
not |date=27 September 2007 (print version 25 September)
Use of templates within the citation template, is discouraged because many of these templates will add extraneous HTML or CSS that will be rendered in the metadata. Also, HTML entities, for example
, –
, etc, should not be used in parameters that contribute to the metadata. Do not include Wiki markup ''
(italic font) or '''
(bold font) because these markup characters will contaminate the metadata.
|periodical=
, |journal=
, |newspaper=
, |magazine=
, |work=
, |website=
, |encyclopedia=
, |encyclopaedia=
, |dictionary=
|chapter=
, |contribution=
, |entry=
, |article=
, |section=
|title=
|publicationplace=
, |publication-place=
, |place=
, |location=
|date=
, |year=
, |publicationdate=
, |publication-date=
|series=
, |version=
|volume=
|issue=
, |number=
|page=
, |pages=
, |at=
|edition=
|publisher=
, |distributor=
, |institution=
|url=
|chapterurl=
, |chapter-url=
, |contributionurl=
, |contribution-url=
, |sectionurl=
, |section-url=
|author#=
, |Author#=
, |authors#=
, |author#-last=
, |author-last#=
, |last#=
, |surname#=
|"author#-first=
, |author-first#=
, |first#=
, |given#=
|isbn=
, |issn=
, |doi=
, |pmc=
, etc)
By default, sets of fields are terminated with a period (.).
By default, sets of fields are terminated with a comma (,).
|template-doc-demo=true
to disable categorization; mainly used for documentation where the error is demonstrated.
The following parameters are deprecated. Their use will place the page into Category:Pages containing cite templates with deprecated parameters:
Options for this field:
|date2=yes
adds:
- date2
- month2
- year2
vanc
and when the list uses last
/first
parameters for the name list(s)Options for this field:
|coauthors=yes
adds "coauthors: (deprecated) Names of coauthors. Use the same format as the authors."|others=yes
adds "others: To record other contributors to the work, such as "Illustrated by Smith" or "Trans. Smith"."|aliases=
add aliases for last.
vanc
and when the list uses last
/first
parameters for the name list(s)
... |title=Tōkyō tawā |script-title=ja:東京タワー |trans-title=Tokyo Tower ...
newline | [ | ] | | |
---|---|---|---|
space | [ | ] | | |
((bracket|text)) | ((pipe)) – see also: rendering vertical bars in tables |
Options for this field:
title_title sets the display title:
- encyclopedia = encyclopedia
- default = title
... |title=Tōkyō tawā |script-title=ja:東京タワー |trans-title=Tokyo Tower ...
newline | [ | ] | | |
---|---|---|---|
space | [ | ] | | |
((bracket|text)) | ((pipe)) – see also: rendering vertical bars in tables |
|template-doc-demo=true
to disable categorization; mainly used for documentation where the error is demonstrated.
Options for this field:
title_format sets the display format:
- italics = Displays in italics.
- work = If work is defined, then title is displayed in quotes, else displays in italics.
- default = Displays in quotes.
title_title sets the display title:
- booktitle = booktitle
- default = chapter
Options for this field:
- type_default: Adds "Defaults to type_default"
Options for this field:
- department adds:
- department: Regular department or section within the periodical or journal. Examples include "Communication", "Editorial", "Letter to the Editor", and "Review". Displays after title and is in plain text.
|edition=2nd
produces "2nd ed." Does not display if a periodical field is defined.
((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.c.
", like this: |date=c. 1900
; for no date, add as |date=n.d.
|date=
is recommended unless all of the following conditions are met:|ref=harv
, or the template is ((citation))
, or |mode=cs2
|date=
format is YYYY-MM-DD.CITEREF
disambiguator.|orig-year=First published 1859
or |orig-year=Composed 1904
.Options for this field:
- aliases includes aliases for date
- began adds:
- OR: began: Full date the first part of the program or episode aired.
- AND: ended: Full date the last part of the program or episode aired.
Options for this field:
|work=no
suppresses "; if work is defined, then publisher and location are enclosed in parentheses"|map=yes
changes:
- publisher: Name of publisher. The publisher is the company that publishes the work being cited. Do not use the publisher parameter for the name of a work (e.g., a book, encyclopedia, newspaper, magazine, journal, website). Displays before title. Do not wikilink—use publisher-link instead.
- publisher-link: Title of existing Wikipedia article about the publisher—not the publisher's website; do not wikilink.
Fyrimynd:Citation Style documentation/newsgroup
|language=French, German
. The use of language names or language codes recognized by Wikimedia adds the page to the appropriate subcategory of Bólkur:CS1 foreign language sources; do not use templates or wikilinks.
|page=
or |pages=
, but not both. Displays preceded by p.
unless |nopp=y
.|page=
or |pages=
, but not both. Separate using an en dash (–); separate non-sequential pages with a comma (,); do not use to indicate the total number of pages in the source. Displays preceded by pp.
unless |nopp=y
. Hyphens are automatically converted to en dashes; if hyphens are appropriate, for example: pp. 3-1–3-15, use |at=
.
p.
or pp.
notations where this is inappropriate; for example, where |page=Front cover
.|page=
or |pages=
. Use only one of |page=
, |pages=
, or |at=
.Options for this field:
- work adds "or work (or an alias) is defined"
Fyrimynd:Citation Style documentation/time
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=hep-th/9205027
(before April 2007) or arxiv=0706.0001 or arxiv=1501.00001 (since April 2007). 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.
- 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
- doi: Digital object identifier; 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 http://dx.doi.org. Use the same format as other dates in the article. Alias: doi_brokendate, 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. Alias: EISSN
- hdl: Handle System identifier for digital objects and other resources on the Internet. Alias: HDL
- isbn: International Standard Book Number; for example:
978-0-8126-9593-9
. (See Wikipedia:ISBN and ISBN § Overview.) Dashes in the ISBN are optional, but preferred. Use the ISBN actually printed on or in the book. Use the 13-digit ISBN – beginning with 978 or 979 – when it is available. If only a 10-digit ISBN is printed on or in the book, use it. ISBNs can be found on the page with the publisher's information – usually the back of the title page – or beneath the barcode as a number beginning with 978 or 979 (barcodes beginning with any other numbers are not ISBNs). For sources with the older 9-digit SBN system, prefix the number with a zero; thus, SBN 902888-45-5 should be entered as |isbn=0-902888-45-5
. Do not convert a 10-digit ISBN to 13-digit by just adding the 978 prefix; the last digit is a calculated check digit and just making changes to the numbers will make the ISBN invalid. This parameter should hold only the ISBN without any additional characters. It is checked for length, invalid characters – anything other than numbers, spaces, and hyphens, with "X" permitted as the last character in a 10-digit ISBN – and the proper check digit. Alias: ISBN
- 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. Alias: ISSN
- jfm: Jahrbuch über die Fortschritte der Mathematik
- 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.
- mr: Mathematical Reviews
- oclc: OCLC; WorldCat's Online Computer Library Center
- ol: Open Library identifier; do not include "OL" in the value.
- osti: Office of Scientific and Technical Information
- 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. See also the pmid parameter, below; these are two different identifiers.
- embargo: Date that pmc goes live; if this date is in the future, then pmc is not linked until that date.
- pmid: PubMed; use unique identifier. See also the pmc parameter, above; these are two different identifiers.
- rfc: Request for Comments
- ssrn: Social Science Research Network
- zbl: Zentralblatt MATH
url
- url: URL of an online location where the text of the publication can be found. Cannot be used if title is wikilinked. If applicable, the link may point to the specific page(s) referenced. Remove spurious tracking parameters from URLs, e.g.
#ixzz2rBr3aO94
or ?utm_source=google&utm_medium=...&utm_term=...&utm_campaign=...
. Do not link to any commercial booksellers, such as Amazon.com. See: WP:PAGELINKS.
- access-date: 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.[date 1] 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 web sites (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 hidden or styled by registered editors. Alias: accessdate.
- archive-url: The URL of an archived copy of a web page, if or in case the url becomes unavailable. Typically used to refer to services like WebCite (see: Wikipedia:Using WebCite) and Internet Archive (see: Wikipedia:Using the Wayback Machine); requires archive-date and url. Alias: archiveurl.
- archive-date: Date when the original URL was archived; preceded by default text "archived from the original on". Use the same format as other access and archive dates in the citations. This does not necessarily have to be the same format that was used for citing publication dates.[date 1] Do not wikilink. Alias: archivedate.
- dead-url: When the URL is still live, but pre-emptively archived, then set
|dead-url=no
. This changes the display order with the title retaining the original link and the archive linked at the end. Alias: deadurl.
- template-doc-demo: The archive parameters will be error checked to ensure that all the required parameters are included, or else ((citation error)) is invoked. With errors, main, help and template pages are placed into one of the subcategories of Category:Articles with incorrect citation syntax. Set
|template-doc-demo=true
to disable categorization; mainly used for documentation where the error is demonstrated.
- format: Format of the work referred to by url; for example: PDF, DOC, or XLS; displayed in parentheses after title. HTML is implied and should not be specified. Automatically added when a PDF icon is displayed. Does not change the external link icon. Note: External link icons do not include alt text; thus, they do not add format information for the visually impaired.
- URLs must begin with a supported URI scheme.
http://
and https://
will be supported by all browsers; however, ftp://
, gopher://
, irc://
, ircs://
, mailto:
and news:
will require a plug-in or an external application and should normally be avoided. IPv6 host-names are currently not supported.
- If URLs in citation template parameters contain certain characters, then they will not display and link correctly. Those characters need to be percent-encoded. For example, a space must be replaced by
%20
. To encode the URL, replace the following characters with:
sp
"
'
<
>
[
]
{
|
}
%20
%22
%27
%3c
%3e
%5b
%5d
%7b
%7c
%7d
- Single apostrophes do not need to be encoded; however, unencoded multiples will be parsed as italic or bold markup. Single curly closing braces also do not need to be encoded; however, an unencoded pair will be parsed as the double closing braces for the template transclusion.
Options for this field:
- pmc adds:
" If url is not defined but pmc is, then url is set to the pmc link.
- Embargo: Date that pmc goes live; if this is in the future, then url is not set to the pmc link until that date."
chapterurl
Fyrimynd:Citation Style documentation/chapterurl
lay
- 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, laysummary.
- 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.
quote
- quote: Relevant text quoted from the source. Displays enclosed in quotes. When supplied, the citation terminator (a period by default) is suppressed, so the quote needs to include terminating punctuation.
Options for this field:
|cs2=yes
suppresses "When supplied, the citation terminator (a period by default) is suppressed, so the quote needs to include terminating punctuation."
ref
- ref: ID for anchor. By default, no anchor is generated. The ordinary nonempty value
|ref=ID
generates an anchor with the given ID; such a linkable reference can be made the target of wikilinks to full references, especially useful in short citations like shortened notes and parenthetical referencing. The special value |ref=harv
generates an anchor suitable for the ((harv)) template. See: Anchors for Harvard referencing templates.
ref2
- ref: ID for anchor. By default, anchors are always generated. The ordinary nonempty value
|ref=ID
generates an anchor with the given ID; such a linkable reference can be made the target of wikilinks to full references, especially useful in short citations like shortened notes and parenthetical referencing.
display
Fyrimynd:Citation Style documentation/display
Options for this field:
- cs2: When set, changes:
- postscript to "defaults to none"
- separator to "Defaults to a comma (,)"
Subscription or registration required
- conference: Name of the conference, may include location if different from location and date if different from date or year.
- conference-url: URL of conference proceedings, if different from url. Alias: conferenceurl.
map_series
Fyrimynd:Citation Style documentation/map series
map_pages
- page: Page in the source that supports the content; overridden by at.
- OR: pages: Pages in the source that supports the content; separate page ranges with an en dash (–); separate non-sequential pages with a comma (,); do not use to indicate the total number of pages in the source.
- inset: The name of the focused inset referenced; example: Downtown Fooburg. Output appends "inset" after the input,
|inset=Downtown Fooburg
becomes "Downtown Fooburg inset."; overridden by at.
- section: The map section(s) of the feature referenced; example: A6, B9, L11, etc; overridden by at.
- at: For sources where a single set of the above parameters is inappropriate or insufficient to describe the in-source location(s).
- Examples: page (p.) or pages (pp.); inset(s); section (§) or sections (§§); other custom location on the map or in the atlas.
interview_id
Fyrimynd:Citation Style documentation/interview id
interview_author
Fyrimynd:Citation Style documentation/interview author
interview_interviewer
Fyrimynd:Citation Style documentation/interview interviewer
album_name
Fyrimynd:Citation Style documentation/album name
season
Fyrimynd:Citation Style documentation/season
network
- network: The network the episode was aired on. (e.g. ABC, NBC, CBS, Fox, Disney, USA Network, BBC)
- station: Call letters of the local station (if any).
transcript
Fyrimynd:Citation Style documentation/transcript
conference
- conference: Name of the conference, may include location if different from location and date if different from date or year.
- conference-url: URL of conference proceedings, if different from url. Alias: conferenceurl.
See also
Dokumentatiónin omanfyri er tikin frá Fyrimynd:Citation Style documentation/doc. (rætta | søga) Editors can experiment in this template's sandkassi (upprætta | mirror) and testcases (upprætta) pages. Please add categories to the /doc subpage. Undirsíður til hesa/hetta fyrimyndina. |