Template:Citation Style documentation: Difference between revisions

From All Skies Encyclopaedia
imported>Gadget850
(encoding)
imported>Gadget850
(source)
Line 5: Line 5:
***The '''last''' and '''first''' parameters are not ideally suited to authors whose surname is usually written first (e.g. as in Chinese). Use '''last''' to include the same format as the source to handle these cases.
***The '''last''' and '''first''' parameters are not ideally suited to authors whose surname is usually written first (e.g. as in Chinese). Use '''last''' to include the same format as the source to handle these cases.
** '''authorlink''': Title of Wikipedia article about the author— not the author's website. Article should already exist. Must not be wikilinked itself. Must be used with '''author''' or '''first''' and '''last'''.
** '''authorlink''': Title of Wikipedia article about the author— not the author's website. Article should already exist. Must not be wikilinked itself. Must be used with '''author''' or '''first''' and '''last'''.
*OR: for multiple authors, use the parameters '''first1''', '''last1''' ... '''first''n'', last''n''''' to correctly record all the information about the book (the first nine authors are printed, then "et al." is appended if even more authors were specified). Do not wikilink as there are corresponding '''authorlink1''' ... '''authorlink9''' parameters as well. This usage is preferred to the use of '''coauthors'''.
*OR: for multiple authors, use the parameters '''first1''', '''last1''' ... '''first''n'', last''n''''' to correctly record all the information about the source (the first nine authors are displayed, then "et al." is appended if even more authors were specified). Do not wikilink as there are corresponding '''authorlink1''' ... '''authorlink9''' parameters as well. This usage is preferred to the use of '''coauthors'''.
*OR: '''author''': (deprecated) Full name of author, preferably surname first. Do not wikilink— use '''authorlink''' instead.
*OR: '''author''': (deprecated) Full name of author, preferably surname first. Do not wikilink— use '''authorlink''' instead.
** '''coauthors''': (deprecated) Full name of additional author or authors— e.g. ''Joe Bloggs, John F. Kennedy, H. R. Dent''. Use the same name order and separators as the author fields.
** '''coauthors''': (deprecated) Full name of additional author or authors— e.g. ''Joe Bloggs, John F. Kennedy, H. R. Dent''. Use the same name order and separators as the author fields.
|editor=
|editor=
* '''editor''': Name of editor(s). Do not Wikilink any values in the editor value but use '''editor-link''' instead. If '''chapter''' is not specified, then "ed." displays after the editor's name(s). If '''chapter''' is specified, then "In" shows before the editor's name(s). This implies that the author is responsible only for part of the book (including the cited chapter) and the editor responsible for the whole book. If, however, the author(s) and editor(s) are responsible for the whole book, then the '''editor''' parameter or its alternates described below should not be used if the '''chapter''' parameter is being used. Instead, the editor(s) should be included in an '''author''' parameter with possibly "(ed.)" after the surname(s). Alternatively, the '''editor''' parameter may be used if the chapter detail is included in the '''title''' parameter instead of using the '''chapter''' parameter.
* '''editor''': Name of editor(s). Do not Wikilink any values in the editor value but use '''editor-link''' instead. If '''chapter''' is not specified, then "ed." displays after the editor's name(s). If '''chapter''' is specified, then "In" shows before the editor's name(s). This implies that the author is responsible only for part of the source (including the cited chapter) and the editor responsible for the whole source. If, however, the author(s) and editor(s) are responsible for the whole source, then the '''editor''' parameter or its alternates described below should not be used if the '''chapter''' parameter is being used. Instead, the editor(s) should be included in an '''author''' parameter with possibly "(ed.)" after the surname(s). Alternatively, the '''editor''' parameter may be used if the chapter detail is included in the '''title''' parameter instead of using the '''chapter''' parameter.
*OR: alternatively '''editor-first''' and '''editor-last''' can be used in the same way as ''first'' and ''last''.
*OR: alternatively '''editor-first''' and '''editor-last''' can be used in the same way as ''first'' and ''last''.
*OR: for multiple editors up to four in number, use the parameters '''editor1-first''', '''editor1-last''' ... '''editor''n''-first''', '''editor''n''-last''' to correctly record all the information about the book in the same way as '''first''n''''' and '''last''n'''''.
*OR: for multiple editors up to four in number, use the parameters '''editor1-first''', '''editor1-last''' ... '''editor''n''-first''', '''editor''n''-last''' to correctly record all the information about the source in the same way as '''first''n''''' and '''last''n'''''.
** '''editor-link''' or '''editor1-link''' ... '''editor''n''-link''' is used in the same way as '''authorlink''' or '''authorlink''n'''''.
** '''editor-link''' or '''editor1-link''' ... '''editor''n''-link''' is used in the same way as '''authorlink''' or '''authorlink''n'''''.
|others=
|others=
Line 22: Line 22:
| space || [ || ] || |
| space || [ || ] || |
|}
|}
* '''title''': Title of book. Can be wikilinked but only to an existing Wikipedia article. Formatted in italics.
* '''title''': Title of source. Can be wikilinked to an existing Wikipedia article or '''url''' may be used to add an external link, but not both. Formatted in italics.
** '''trans_title''': If the book cited is in a foreign language, an English translation of the title can be given here. The template will display this in square brackets after the '''title''' field and it will link to the '''url''' field, if used. Use of the '''language''' parameter is recommended.
** '''trans_title''': If the source cited is in a foreign language, an English translation of the title can be given here. The template will display this in square brackets after the '''title''' field and it will link to the '''url''' field, if used. Use of the '''language''' parameter is recommended.
|title2=
|title2=
Titles containing certain characters will display and link incorrectly unless those characters are replaced or encoded.
* '''title''': Title of article.
{| class="wikitable"
! newline !! [ !! ] !! |
|-
| space || [ || ] || |
|}
* '''title''': Title of source. Can be wikilinked to an existing Wikipedia article or '''url''' may be used to add an external link, but not both. Formatted in quotes.
** '''trans_title''': If the source cited is in a foreign language, an English translation of the title can be given here. The template will display this in square brackets after the '''title''' field and it will link to the '''url''' field, if used. Use of the '''language''' parameter is recommended.
|chapter=
|chapter=
* '''chapter''': The chapter of the book, written in full. Formatted in quotations.
* '''chapter''': The chapter of the source, written in full. Formatted in quotations.
** '''trans_chapter''': Acts in the same way as '''trans_title'''. The parameter will be displayed in square brackets within the quotation marks which embrace the '''chapter''' field. Use of the '''language''' parameter is recommended.
** '''trans_chapter''': Acts in the same way as '''trans_title'''. The parameter will be displayed in square brackets within the quotation marks which embrace the '''chapter''' field. Use of the '''language''' parameter is recommended.
|type=
|type=
Line 50: Line 57:
** '''location''': Geographical place of publication.
** '''location''': Geographical place of publication.
|language=
|language=
* '''language''': The language the book is written in, if it is not English. Formatted in parentheses with "in" before the language name. Use the full language name and do not use icons or templates.
* '''language''': The language the source is written in, if it is not English. Formatted in parentheses with "in" before the language name. Use the full language name and do not use icons or templates.
|pages=
|pages=
* '''page''': Page in the source that supports the content.
* '''page''': Page in the source that supports the content.
Line 65: Line 72:
* '''doi''': [[Digital object identifier]]
* '''doi''': [[Digital object identifier]]
** '''doi_brokendate''': Date the DOI is broken
** '''doi_brokendate''': Date the DOI is broken
* '''isbn''': [[International Standard Book Number]] such as ''1-111-22222-9''. The template is insensitive to formatting so an ISBN number without dashes (-) may be used (e.g. {{para|isbn|1111222229}}), though ISBNs with correctly formatted dashes are preferred (see [[Wikipedia:ISBN]] and [[ISBN#Overview|ISBN]]). Please use the 13-digit ISBN where possible; this can normally be found beneath the barcode as a number beginning 978 or 979. For books with the older SBN system (9 digits), use this parameter but prefix the number with a zero; thus ''SBN 902888-45-5'' should be entered as {{para|isbn|0-902888-45-5}}. More information about this feature and its advantages is available at [[Wikipedia:ISBN]].
* '''isbn''': [[International Standard Book Number]] such as ''1-111-22222-9''. The template is insensitive to formatting so an ISBN number without dashes (-) may be used (e.g. {{para|isbn|1111222229}}), though ISBNs with correctly formatted dashes are preferred (see [[Wikipedia:ISBN]] and [[ISBN#Overview|ISBN]]). Please use the 13-digit ISBN where possible; this can normally be found beneath the barcode as a number beginning 978 or 979. For sources with the older SBN system (9 digits), use this parameter but prefix the number with a zero; thus ''SBN 902888-45-5'' should be entered as {{para|isbn|0-902888-45-5}}. More information about this feature and its advantages is available at [[Wikipedia:ISBN]].
* '''issn''': [[International Standard Serial Number]]
* '''issn''': [[International Standard Serial Number]]
* '''jfm''': [[Jahrbuch über die Fortschritte der Mathematik]]
* '''jfm''': [[Jahrbuch über die Fortschritte der Mathematik]]
Line 91: Line 98:


The link button [[File:Vector toolbar insert link button.png]] on the enhanced editing toolbar will encode a link.
The link button [[File:Vector toolbar insert link button.png]] on the enhanced editing toolbar will encode a link.
* '''url''': URL of an online location where the text of the publication can be found. Cannot be used if you wikilinked '''title'''. If applicable, the link may point to the specific page(s) referenced. Do not use this parameter to link to any commercial booksellers (such as Amazon.com). The [[Wikipedia:ISBN|ISBN link]] is a much better alternative which allows readers access to the books in their own countries or through their own choice of source, including Amazon, Google Books, thousands of libraries, and more.
* '''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. Do not use this parameter to link to any commercial booksellers (such as Amazon.com). The [[Wikipedia:ISBN|ISBN link]] is a much better alternative which allows readers access to the books in their own countries or through their own choice of source, including Amazon, Google Books, thousands of libraries, and more.
** '''format''': Format of the work referred to by '''url''', e.g. PDF. HTML implied if not specified.
** '''format''': Format of the work referred to by '''url''', e.g. PDF. HTML implied if not specified.
** '''accessdate''': Full date when url was accessed. Should be in the same format as other dates in citations in the same article. Must not be wikilinked.
** '''accessdate''': Full date when url was accessed. Should be in the same format as other dates in citations in the same article. Must not be wikilinked.
Line 99: Line 106:
* '''deadurl''': To change the order with the title retaining the original link and the archive linked at the end, set {{para|deadurl|no}}
* '''deadurl''': To change the order with the title retaining the original link and the archive linked at the end, set {{para|deadurl|no}}
|chapterurl=
|chapterurl=
* '''chapterurl''': URL of an individual chapter of online book. Should be at the same site as '''url''', if any. If '''chapterurl''' is used, '''url''' should only be used if the beginning of the work and the cited chapter are on separate webpages at the site.
* '''chapterurl''': URL of an individual chapter of online source. Should be at the same site as '''url''', if any. If '''chapterurl''' is used, '''url''' should only be used if the beginning of the work and the cited chapter are on separate webpages at the site.
|quote=
|quote=
* '''quote''': Relevant text quoted from the source; enclosed in quotes. When supplied, the citation terminator (a period by default) is suppressed, so the quote needs to include terminating punctuation.
* '''quote''': Relevant text quoted from the source; enclosed in quotes. When supplied, the citation terminator (a period by default) is suppressed, so the quote needs to include terminating punctuation.
Line 105: Line 112:
* '''ref''': ID for anchor. By default, no anchor is generated. The ordinary nonempty value {{para|ref|<var>ID</var>}} generates an anchor with the given <var>ID</var>; such a linkable reference can be made the target of [[Wikipedia:Citing sources/Further considerations#Wikilinks to full references|wikilinks to full references]], especially useful in short citations like [[Wikipedia:Citing sources#Shortened footnotes|shortened notes]] and [[Wikipedia:Parenthetical referencing|parenthetical referencing]]. The special value {{para|ref|harv}} generates an anchor suitable for the {{tl|harv}} template; see [[Template:Citation/doc#Anchors for Harvard referencing templates|anchors for Harvard referencing templates]].
* '''ref''': ID for anchor. By default, no anchor is generated. The ordinary nonempty value {{para|ref|<var>ID</var>}} generates an anchor with the given <var>ID</var>; such a linkable reference can be made the target of [[Wikipedia:Citing sources/Further considerations#Wikilinks to full references|wikilinks to full references]], especially useful in short citations like [[Wikipedia:Citing sources#Shortened footnotes|shortened notes]] and [[Wikipedia:Parenthetical referencing|parenthetical referencing]]. The special value {{para|ref|harv}} generates an anchor suitable for the {{tl|harv}} template; see [[Template:Citation/doc#Anchors for Harvard referencing templates|anchors for Harvard referencing templates]].
|lay=
|lay=
* '''laysummary''': Link to a non-technical summary (or review) of the book
* '''laysummary''': Link to a non-technical summary (or review) of the source.
** '''laysource''': Name of the source, such as the magazine or journal.
** '''laysource''': Name of the source, such as the magazine or journal.
** '''laydate''': Date of summary.
** '''laydate''': Date of summary.

Revision as of 12:00, 29 December 2011

Titles containing certain characters will display and link incorrectly unless those characters are replaced or encoded. {