Template:Citation/doc

From escforumwiki
Revision as of 20:17, 16 July 2017 by Santos (talk | contribs) (1 revision imported)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

The Citation template generates a citation for a book, periodical, contribution in a collective work, patent, or a web page. It determines the citation type by examining which parameters are used. As with other citation templates, this template can be used either in a footnote (between <ref>...</ref> tags) or in a section that lists sources. This template uses the same Lua code as citation style 1 (CS1) templates with parameters to change the displayed format to citation style 2 (CS2).

If the correct parameters are used, this template produces output identical to that of the Cite templates, such as {{Cite book}} and {{Cite web}}, with one important exception: By default, this Citation template uses commas in places where the Cite templates use periods (full stops) by default; either type of template can use periods (full stops) or commas by using an optional parameter. Also, this template by default generates anchors for Harvard references whereas the Cite templates by default do not (although they can be made to do so).

Regardless of which citation templates are used or even if none are used at all, all citations should have the same format throughout an article in the saved, rendered text.

Note: All parameter names must be lowercase.

Simple citations

This section covers the most commonly used parameters. You can copy the horizontal form or vertical form below and then add in extra parameters from the full list. Spacing and ordering of the parameters within the template is irrelevant and does not affect the final, rendered text.

{{Citation |last= |first= |year= |title= |publisher= |publication-place= |page= |url= |accessdate= }}

{{Citation
| last       =
| first      =
| year       =
| title      =
| publisher  =
| publication-place =
| page       =
| url        =
| accessdate =
}}
  • last: The author's surname or last name. Don't use with the author parameter.
  • first: The author's first or given name(s).
  • year: Year of authorship or publication. Mandatory for use with links from Template:Harvard citation, unless |date= specifies both month and year.
  • title: Title of the work. Mandatory for web references.
  • publisher: The name of the publisher. Omit terms such as Publishers, Co., Inc., Ltd., etc., but retain the words Books or Press. Not normally included where the publication is a periodical which has its own Wikipedia article (e.g. Newsweek, Billboard).
    • publication-place (or place or location): The city of publication. If more than one town/city is listed on the title page, give the first one or the location of the publisher's head office. Omit when the publication is a periodical whose name specifies the location (e.g. The New York Times, The Times of India)
  • page: For use when one page is cited. Adds "p." before the page number. Do not use with pages.
  • url: A url of an online location where the item can be found. If the url includes double quotes, these must be encoded as "%22".
    • accessdate: Date[n 1] when the url was accessed.

Example

{{Citation
| last      = Turner
| first     = Orsamus
| title     = History of the pioneer settlement of
Phelps and Gorham's purchase, and Morris' reserve
| publisher = William Alling
| place     = Rochester, New York
| year      = 1851
| ol        = 7120924W
}}
Turner, Orsamus (1851), History of the pioneer settlement of Phelps and Gorham's purchase, and Morris' reserve, Rochester, New York: William Alling, OL 7120924W

Full citation parameters

These can be used for all types of publication except patents. All are optional and indentation is used simply to group related items — these may be mutually exclusive where indicated. Some hyphenated names can also be placed without hyphens.

{{Citation
| author  =
| last    =
| first   =
| author2 =
| last2   =
| first2  =
| author-link  =
| author2-link =
| author-separator =
| author-name-separator =
| author-mask =
| display-authors =
| editor        =
| editor-last   =
| editor-first  =
| editor2       =
| editor2-last  =
| editor2-first =
| editor-link   =
| editor2-link  =
| translator-last =
| translator-first =
| translator-link = 
| translator2-last =
| translator2-first =
| translator2-link =
| others   =
| publication-date =
| date     =
| year     =
| origyear =
| title    =
| chapter  =
| chapter-url  =
| chapter-format  =
| contribution =
| contribution-url =
| type    =
| journal =
| periodical =
| newspaper  =
| magazine   =
| work =
| edition =
| series  =
| volume  =
| issue   =
| publisher =
| publication-place =
| place    =
| language =
| page  =
| pages =
| nopp  =
| at   =
| id   =
| isbn =
| issn =
| oclc =
| pmid =
| pmc  =
| bibcode =
| doi =
| doi_inactivedate =
| zbl =
| url =
| accessdate  =
| format      =
| archiveurl  =
| archivedate =
| dead-url    =
| quote      =
| layurl =
| laysource  =
| laydate    =
| separator  =
| postscript =
| ref =
}}

Parameters

Syntax

Nested parameters rely on their parent parameters:

  • parent
  • OR: parent2—may be used instead of parent
    • child—may be used with parent (and is ignored if parent is not used)
    • OR: child2—may be used instead of child (and is ignored if parent2 is not used)
Where aliases are listed, only one of the parameters may be defined; if multiple aliased parameters are defined, then only one will show.

By default, sets of fields are terminated with a comma (,).

COinS

This template embeds COinS metadata in the HTML output, allowing reference management software to retrieve bibliographic metadata.