Difference between revisions of "Template:Citation/core/doc"
imported>Gadget850 (Citation class) |
imported>Gadget850 (→Parameter details: add missing identifiers; mark parameters that support COinS) |
||
| Line 34: | Line 34: | ||
== Parameter details == | == Parameter details == | ||
| − | Note that the examples below are common uses of each parameter, intended to help editors understand the functioning of this template. In the most part, there is nothing wrong with passing different data to any of the parameters below if it produces the output that is desired. The exception is in parameters which are associated with a [[COinS]] | + | Note that the examples below are common uses of each parameter, intended to help editors understand the functioning of this template. In the most part, there is nothing wrong with passing different data to any of the parameters below if it produces the output that is desired. The exception is in parameters which are associated with a [[COinS]] field— these parameters are indicated by ⊗. |
*{{para|AccessDate}} date when the {{para|URL}} was accessed. Should not be wikilinked. | *{{para|AccessDate}} date when the {{para|URL}} was accessed. Should not be wikilinked. | ||
| Line 41: | Line 41: | ||
** {{para|ArchiveDate}} date when the item was archived. Should not be wikilinked. | ** {{para|ArchiveDate}} date when the item was archived. Should not be wikilinked. | ||
*{{para|OriginalURL}} If an archived URL is provided elsewhere, the original URL should be specified here. | *{{para|OriginalURL}} If an archived URL is provided elsewhere, the original URL should be specified here. | ||
| − | *{{para|At}} page reference within the source. | + | * ⊗ {{para|ARXIV}} [[ArXiv]] ID. |
| − | *{{para|AuthorBlock}} replaces the first author with a score of length ''AuthorBlock'' em. Metadata is still produced from {{para|Surname}} and {{para|Forename}}. | + | * ⊗ {{para|ASIN}} [[Amazon Standard Identification Number]]. |
| + | * ⊗ {{para|At}} page reference within the source. | ||
| + | *{{para|AuthorBlock}} replaces the first author with a score of length ''AuthorBlock'' em. Metadata is still produced from {{para|Surname}} and {{para|Forename}}. | ||
*{{para|Authorlink1}} title of an existing Wikipedia article about the first author. | *{{para|Authorlink1}} title of an existing Wikipedia article about the first author. | ||
*{{para|Authorlink2}}, {{para|Authorlink3}}, ..., {{para|Authorlink8}} title of an existing Wikipedia article about up to seven additional authors. | *{{para|Authorlink2}}, {{para|Authorlink3}}, ..., {{para|Authorlink8}} title of an existing Wikipedia article about up to seven additional authors. | ||
| − | *{{para| | + | *{{para|BIBCODE}} A [[Bibcode]] ID. |
*{{para|Citation class}} adds the specified HTML class to the span that encloses the citation. The name must be one word (separate words are separate classes) and must meet the name rules.<ref>{{Cite web|title=HTML class Attribute|url=http://www.w3schools.com/tags/att_standard_class.asp|work=w3schools.com}}</ref> | *{{para|Citation class}} adds the specified HTML class to the span that encloses the citation. The name must be one word (separate words are separate classes) and must meet the name rules.<ref>{{Cite web|title=HTML class Attribute|url=http://www.w3schools.com/tags/att_standard_class.asp|work=w3schools.com}}</ref> | ||
| − | *{{para|DOI}} [[Digital object identifier]]. | + | * ⊗ {{para|DOI}} [[Digital object identifier]]. |
| − | *{{para|Date}} date of the authorship, if different from date of publication. | + | * ⊗ {{para|Date}} date of the authorship, if different from date of publication. |
*{{para|DeadURL}} indicates if the original link is [[WP:LINKROT|dead]] or live ({{para|DeadURL|no}}). Used to change the main citation link when {{para|ArchiveURL}} is set. | *{{para|DeadURL}} indicates if the original link is [[WP:LINKROT|dead]] or live ({{para|DeadURL|no}}). Used to change the main citation link when {{para|ArchiveURL}} is set. | ||
*{{para|DoiBroken}} Date the DOI is broken | *{{para|DoiBroken}} Date the DOI is broken | ||
| − | *{{para|Edition}} number or name of the edition, if not the first; for example: {{para|Edition|2nd.}} | + | * ⊗ {{para|Edition}} number or name of the edition, if not the first; for example: {{para|Edition|2nd.}} |
*{{para|EditorGiven1}} first editor's first or given name(s). | *{{para|EditorGiven1}} first editor's first or given name(s). | ||
*{{para|EditorGiven2}}, {{para|EditorGiven3}} second and third editors’ first or given name(s). | *{{para|EditorGiven2}}, {{para|EditorGiven3}} second and third editors’ first or given name(s). | ||
| Line 59: | Line 61: | ||
*{{para|Editorlink2}}, {{para|Editorlink3}} title of existing Wikipedia articles about the second and third editors. | *{{para|Editorlink2}}, {{para|Editorlink3}} title of existing Wikipedia articles about the second and third editors. | ||
*{{para|format}} file format of the source, if not the common format. Or; "Free full text", "abstract", or similar descriptor | *{{para|format}} file format of the source, if not the common format. Or; "Free full text", "abstract", or similar descriptor | ||
| − | *{{para|Given1}} first author's first or given name(s). | + | * ⊗ {{para|Given1}} first author's first or given name(s). |
| − | *{{para|Given2}}, {{para|Given3}}, ..., {{para|Given8}} up to seven additional authors' first or given name(s). | + | * ⊗ {{para|Given2}}, {{para|Given3}}, ..., {{para|Given8}} up to seven additional authors' first or given name(s). |
*{{para|ID}} miscellaneous identifier, other than {{para|DOI}}, {{para|ISBN}}, {{para|ISSN}}, {{para|OCLC}}, {{para|PMID}}, or {{para|PMC}}. | *{{para|ID}} miscellaneous identifier, other than {{para|DOI}}, {{para|ISBN}}, {{para|ISSN}}, {{para|OCLC}}, {{para|PMID}}, or {{para|PMC}}. | ||
| − | *{{para|ISBN}} [[International Standard Book Number]]. | + | * ⊗ {{para|ISBN}} [[International Standard Book Number]]. |
| − | *{{para|ISSN}} [[International Standard Serial Number]] identifying the periodical. | + | * ⊗ {{para|ISSN}} [[International Standard Serial Number]] identifying the periodical. |
| − | *{{para|IncludedWorkTitle}} Specific title, to be displayed in quotation marks. Contrast with {{para|Title}}, which is displayed in italics. In some cases (e.g. [[Template:Cite web]]) it may be desirable to use IncludedWorkTitle for the title, and not use the Title parameter at all. | + | * ⊗ {{para|IncludedWorkTitle}} Specific title, to be displayed in quotation marks. Contrast with {{para|Title}}, which is displayed in italics. In some cases (e.g. [[Template:Cite web]]) it may be desirable to use IncludedWorkTitle for the title, and not use the Title parameter at all. |
| − | *{{para|IncludedWorkURL}} [[Uniform Resource Locator|URL]] of the contribution or chapter, or other included work. | + | * ⊗ {{para|IncludedWorkURL}} [[Uniform Resource Locator|URL]] of the contribution or chapter, or other included work. |
| − | *{{para|Issue}} issue number of the periodical. | + | * ⊗ {{para|Issue}} issue number of the periodical. |
| + | * ⊗ {{para|JFM}} [[Jahrbuch über die Fortschritte der Mathematik]] | ||
| + | * ⊗ {{para|JSTOR}} [[JSTOR]] ID. | ||
*{{para|language}} specifies the language in which the source is written, if not English. | *{{para|language}} specifies the language in which the source is written, if not English. | ||
| − | *{{para|laydate}} Date of a lay summary | + | *{{para|laydate}} Date of a lay summary. |
*{{para|laysummary}} Summary of the source in a [[layman]]-friendly journal - for instance a BBC news article about a paper in [[Nature (journal)|Nature]]. | *{{para|laysummary}} Summary of the source in a [[layman]]-friendly journal - for instance a BBC news article about a paper in [[Nature (journal)|Nature]]. | ||
| − | *{{para|OCLC}}[[Online Computer Library Center]] ID number. | + | * ⊗ {{para|LCCN}} [[Library of Congress Control Number]] ID. |
| − | *{{para|Other}} Other details to be inserted in a particular place | + | * ⊗ {{para|MR}} [[Mathematical Reviews]] ID. |
| − | *{{para|PMC}} [[PubMed Central]] article number for full-text free repository of an article. | + | * ⊗ {{para|OCLC}}[[Online Computer Library Center]] ID number. |
| − | *{{para|PMID}} [[PMID|PubMed Unique Identifier]]. | + | * ⊗ {{para|OL}} [[Open Library]] ID. |
| + | * ⊗ {{para|OSTI}} [[Office of Scientific and Technical Information]] ID. | ||
| + | *{{para|Other}} Other details to be inserted in a particular place. | ||
| + | * ⊗ {{para|PMC}} [[PubMed Central]] article number for full-text free repository of an article. | ||
| + | * ⊗ {{para|PMID}} [[PMID|PubMed Unique Identifier]]. | ||
*{{para|Periodical}} name of the periodical, journal, or magazine. This parameter controls whether or not the template will generate a citation in the style appropriate to a periodical, journal, magazine, or other serial publication. | *{{para|Periodical}} name of the periodical, journal, or magazine. This parameter controls whether or not the template will generate a citation in the style appropriate to a periodical, journal, magazine, or other serial publication. | ||
*{{para|Place}} place where the item was created (outputs "written at <var>location</var>"; this parameter should not be used for location of publication; see {{para|PublicationPlace}}, below. | *{{para|Place}} place where the item was created (outputs "written at <var>location</var>"; this parameter should not be used for location of publication; see {{para|PublicationPlace}}, below. | ||
*{{para|PublicationDate}} date of publication. | *{{para|PublicationDate}} date of publication. | ||
| − | *{{para|PublicationPlace}} city of publication. | + | * ⊗ {{para|PublicationPlace}} city of publication. |
| − | *{{para|Publisher}} name of the publisher. | + | * ⊗ {{para|Publisher}} name of the publisher. |
*{{para|quote}} text to be quoted from the source. If supplied, this is enclosed in double-quotes. | *{{para|quote}} text to be quoted from the source. If supplied, this is enclosed in double-quotes. | ||
*{{para|PS}} postscript terminating the citation. This is empty by default. | *{{para|PS}} postscript terminating the citation. This is empty by default. | ||
*{{para|Ref}} A reference name - if the citation is referred to using the [[Template:Harv|Harvard referencing suite of templates]]. | *{{para|Ref}} A reference name - if the citation is referred to using the [[Template:Harv|Harvard referencing suite of templates]]. | ||
| + | * ⊗ {{para|RFC}} [[Request for Comments]] ID. | ||
*{{para|Sep}} specifies the punctuation mark used to separate fields. This usually defaults to a period, but may occasionally be a comma. For technical reasons, the template will malfunction if a semicolon is passed as a separator. To circumvent this, the calling template should encode semicolons:<br/><code><nowiki>|Sep = {{#ifeq:{{{separator}}}|;|&#059;|{{{separator|!}}}}}</nowiki></code><br/>Replace the exclamation mark with a default separator, if one different to a period is desired. | *{{para|Sep}} specifies the punctuation mark used to separate fields. This usually defaults to a period, but may occasionally be a comma. For technical reasons, the template will malfunction if a semicolon is passed as a separator. To circumvent this, the calling template should encode semicolons:<br/><code><nowiki>|Sep = {{#ifeq:{{{separator}}}|;|&#059;|{{{separator|!}}}}}</nowiki></code><br/>Replace the exclamation mark with a default separator, if one different to a period is desired. | ||
| − | *{{para|Series}} series of which this periodical is a part. | + | * ⊗ {{para|Series}} series of which this periodical is a part. |
| − | *{{para|Surname1}} first author's surname or last name. | + | * ⊗ {{para|SSRN}} [[Social Science Research Network]] ID. |
| − | *{{para|Surname2}}, {{para|Surname3}}, ..., {{para|Surname9}} up to eight additional authors’ surnames or last names. The ninth is not actually used, but causes ''et al.'' to be generated. | + | * ⊗ {{para|Surname1}} first author's surname or last name. |
| − | *{{para|Title}} Title, to be displayed in italics after {{para|IncludedWorkTitle}}. Used, for example, when citing the title of a book; the chapter title would be passed to IncludedWorkTitle | + | * ⊗ {{para|Surname2}}, {{para|Surname3}}, ..., {{para|Surname9}} up to eight additional authors’ surnames or last names. The ninth is not actually used, but causes ''et al.'' to be generated. |
| + | * ⊗ {{para|Title}} Title, to be displayed in italics after {{para|IncludedWorkTitle}}. Used, for example, when citing the title of a book; the chapter title would be passed to IncludedWorkTitle | ||
*{{para|TitleType}} specific type of item cited. Example: PhD thesis. Appears in parentheses immediately after Title (or TransTitle). | *{{para|TitleType}} specific type of item cited. Example: PhD thesis. Appears in parentheses immediately after Title (or TransTitle). | ||
*{{para|TransItalic}} Translated italicized title, in case the original title is in a foreign language. Can be used in conjunction with TransTitle, e.g. for book and chapter title, respectively. This translated string will appear in square brackets, following the italicized book title, with the same URL link. | *{{para|TransItalic}} Translated italicized title, in case the original title is in a foreign language. Can be used in conjunction with TransTitle, e.g. for book and chapter title, respectively. This translated string will appear in square brackets, following the italicized book title, with the same URL link. | ||
*{{para|TransTitle}} Translated title, in case the original title is in a foreign language. The translated title will appear inside square brackets, enclosed within the quotation marks of the IncludedWorkTitle. | *{{para|TransTitle}} Translated title, in case the original title is in a foreign language. The translated title will appear inside square brackets, enclosed within the quotation marks of the IncludedWorkTitle. | ||
| − | *{{para|URL}} [[Uniform Resource Locator]] of an online location where the article can be found. | + | * ⊗ {{para|URL}} [[Uniform Resource Locator]] of an online location where the article can be found. |
| − | *{{para|Volume}} volume number of a multi-volume book or compilation. | + | * ⊗ {{para|Volume}} volume number of a multi-volume book or compilation. |
| − | *{{para|YearNote}} Note to accompany the year. Example: First published 1886 | + | *{{para|YearNote}} Note to accompany the year. Example: First published 1886. |
*{{para|Year}} year of authorship or publication. | *{{para|Year}} year of authorship or publication. | ||
| + | * ⊗ {{para|ZBL}} [[Zentralblatt MATH]] ID. | ||
==References== | ==References== | ||
Revision as of 00:40, 16 October 2011
| This is a documentation subpage for Template:Citation/core. It contains usage information, categories and other content that is not part of the original template page. |
About this template
Template:Citation/core can be thought of as an engine producing consistent output for Wikipedia's citations. Templates such as {{Citation}} provide this core template with a list of parameters, which it uses to produce a formatted text (HTML) output, which contains embedded COinS metadata. This metadata allows many readers to find cited references more easily, or to extract their details to a reference manager.
The presence of a central template makes individual citation templates simpler to code and amend, and produces a consistent look throughout the encyclopaedia.
Templates using this 'engine'
Changes to this central template can affect the output of several 'upstream' templates. A list of templates using citation/core is provided below for testing purposes.
- Template:Citation
- Template:Cite arXiv
- Template:Cite book
- Template:Cite conference
- Template:Cite encyclopedia
- Template:Cite IETF
- Template:Cite journal
- Template:Cite mailing list
- Template:Cite manual
- Template:Cite news
- Template:Cite press release
- Template:Cite report
- Template:Cite sign
- Template:Cite speech
- Template:Cite techreport
- Template:Cite thesis
- Template:Cite video
- Template:Cite web
Parameter details
Note that the examples below are common uses of each parameter, intended to help editors understand the functioning of this template. In the most part, there is nothing wrong with passing different data to any of the parameters below if it produces the output that is desired. The exception is in parameters which are associated with a COinS field— these parameters are indicated by ⊗.
|AccessDate=date when the|URL=was accessed. Should not be wikilinked.- archive parameters (if used, must be used both of them together)
|ArchiveURL=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 and Archive.org.|ArchiveDate=date when the item was archived. Should not be wikilinked.
|OriginalURL=If an archived URL is provided elsewhere, the original URL should be specified here.- ⊗
|ARXIV=ArXiv ID. - ⊗
|ASIN=Amazon Standard Identification Number. - ⊗
|At=page reference within the source. |AuthorBlock=replaces the first author with a score of length AuthorBlock em. Metadata is still produced from|Surname=and|Forename=.|Authorlink1=title of an existing Wikipedia article about the first author.|Authorlink2=,|Authorlink3=, ...,|Authorlink8=title of an existing Wikipedia article about up to seven additional authors.|BIBCODE=A Bibcode ID.|Citation class=adds the specified HTML class to the span that encloses the citation. The name must be one word (separate words are separate classes) and must meet the name rules.[1]- ⊗
|DOI=Digital object identifier. - ⊗
|Date=date of the authorship, if different from date of publication. |DeadURL=indicates if the original link is dead or live (|DeadURL=no). Used to change the main citation link when|ArchiveURL=is set.|DoiBroken=Date the DOI is broken- ⊗
|Edition=number or name of the edition, if not the first; for example:|Edition=2nd. |EditorGiven1=first editor's first or given name(s).|EditorGiven2=,|EditorGiven3=second and third editors’ first or given name(s).|EditorSurname1=first editor's surname or last name.|EditorSurname2=,|EditorSurname3=,|EditorSurname4=second, third, and fourth editors’ surname or last name. The fourth is not actually used, but causes et al. to be generated.|Editorlink1=title of an existing Wikipedia article about the first editor.|Editorlink2=,|Editorlink3=title of existing Wikipedia articles about the second and third editors.|format=file format of the source, if not the common format. Or; "Free full text", "abstract", or similar descriptor- ⊗
|Given1=first author's first or given name(s). - ⊗
|Given2=,|Given3=, ...,|Given8=up to seven additional authors' first or given name(s). |ID=miscellaneous identifier, other than|DOI=,|ISBN=,|ISSN=,|OCLC=,|PMID=, or|PMC=.- ⊗
|ISBN=International Standard Book Number. - ⊗
|ISSN=International Standard Serial Number identifying the periodical. - ⊗
|IncludedWorkTitle=Specific title, to be displayed in quotation marks. Contrast with|Title=, which is displayed in italics. In some cases (e.g. Template:Cite web) it may be desirable to use IncludedWorkTitle for the title, and not use the Title parameter at all. - ⊗
|IncludedWorkURL=URL of the contribution or chapter, or other included work. - ⊗
|Issue=issue number of the periodical. - ⊗
|JFM=Jahrbuch über die Fortschritte der Mathematik - ⊗
|JSTOR=JSTOR ID. |language=specifies the language in which the source is written, if not English.|laydate=Date of a lay summary.|laysummary=Summary of the source in a layman-friendly journal - for instance a BBC news article about a paper in Nature.- ⊗
|LCCN=Library of Congress Control Number ID. - ⊗
|MR=Mathematical Reviews ID. - ⊗
|OCLC=Online Computer Library Center ID number. - ⊗
|OL=Open Library ID. - ⊗
|OSTI=Office of Scientific and Technical Information ID. |Other=Other details to be inserted in a particular place.- ⊗
|PMC=PubMed Central article number for full-text free repository of an article. - ⊗
|PMID=PubMed Unique Identifier. |Periodical=name of the periodical, journal, or magazine. This parameter controls whether or not the template will generate a citation in the style appropriate to a periodical, journal, magazine, or other serial publication.|Place=place where the item was created (outputs "written at location"; this parameter should not be used for location of publication; see|PublicationPlace=, below.|PublicationDate=date of publication.- ⊗
|PublicationPlace=city of publication. - ⊗
|Publisher=name of the publisher. |quote=text to be quoted from the source. If supplied, this is enclosed in double-quotes.|PS=postscript terminating the citation. This is empty by default.|Ref=A reference name - if the citation is referred to using the Harvard referencing suite of templates.- ⊗
|RFC=Request for Comments ID. |Sep=specifies the punctuation mark used to separate fields. This usually defaults to a period, but may occasionally be a comma. For technical reasons, the template will malfunction if a semicolon is passed as a separator. To circumvent this, the calling template should encode semicolons:|Sep = {{#ifeq:{{{separator}}}|;|;|{{{separator|!}}}}}
Replace the exclamation mark with a default separator, if one different to a period is desired.- ⊗
|Series=series of which this periodical is a part. - ⊗
|SSRN=Social Science Research Network ID. - ⊗
|Surname1=first author's surname or last name. - ⊗
|Surname2=,|Surname3=, ...,|Surname9=up to eight additional authors’ surnames or last names. The ninth is not actually used, but causes et al. to be generated. - ⊗
|Title=Title, to be displayed in italics after|IncludedWorkTitle=. Used, for example, when citing the title of a book; the chapter title would be passed to IncludedWorkTitle |TitleType=specific type of item cited. Example: PhD thesis. Appears in parentheses immediately after Title (or TransTitle).|TransItalic=Translated italicized title, in case the original title is in a foreign language. Can be used in conjunction with TransTitle, e.g. for book and chapter title, respectively. This translated string will appear in square brackets, following the italicized book title, with the same URL link.|TransTitle=Translated title, in case the original title is in a foreign language. The translated title will appear inside square brackets, enclosed within the quotation marks of the IncludedWorkTitle.- ⊗
|URL=Uniform Resource Locator of an online location where the article can be found. - ⊗
|Volume=volume number of a multi-volume book or compilation. |YearNote=Note to accompany the year. Example: First published 1886.|Year=year of authorship or publication.- ⊗
|ZBL=Zentralblatt MATH ID.
References
- ↑ "HTML class Attribute". w3schools.com.