Difference between revisions of "Template:Cite book"

From CycleChaos
Jump to navigation Jump to search
m
 
Line 1: Line 1:
<includeonly><cite class="book" style="font-style:normal" {{
{{Citation/core
  #if: {{{ref|}}}
|Citation class=book
   |{{#ifeq:{{{ref}}}|none||id="{{{ref}}}"}}
   |AuthorMask = {{{authormask|{{{author-mask|}}}}}}
  |{{#if:{{{last|}}} | {{#if:{{{year|}}} | id="Reference-{{{last}}}-{{{year}}}" }} }}
   |Surname1 = {{{last|{{{surname|{{{last1|{{{surname1|{{{author1|{{{author|{{{authors|{{{author|}}}}}}}}}}}}}}}}}}}}}}}}
}}>{{
   |Surname2 = {{{last2|{{{surname2|{{{author2|}}}}}}}}}
   #if: {{{author|{{{last|}}}}}}
   |Surname3 = {{{last3|{{{surname3|{{{author3|}}}}}}}}}
  | {{
   |Surname4 = {{{last4|{{{surname4|{{{author4|}}}}}}}}}
    #if: {{{authorlink|}}}
   |Surname5 = {{{last5|{{{surname5|{{{author5|}}}}}}}}}
    | {{{authorlink}}}|{{
   |Surname6 = {{{last6|{{{surname6|{{{author6|}}}}}}}}}
      #if: {{{last|}}}
  |Surname7 = {{{last7|{{{surname7|{{{author7|}}}}}}}}}
      | {{{last}}}{{ #if: {{{first|}}} | , {{{first}}} }}
   |Surname8 = {{{last8|{{{surname8|{{{author8|}}}}}}}}}
      | {{{author}}}
   |Surname9 = {{{last9|{{{surname9|{{{author9|}}}}}}}}}
    }}
  |Given1 = {{{first1|{{{given1|{{{first|{{{given|}}}}}}}}}}}}
    | {{
      #if: {{{last|}}}
      | {{{last}}}{{ #if: {{{first|}}} | , {{{first}}} }}
      | {{{author}}}
    }}
  }}
}}{{
  #if: {{{author|{{{last|}}}}}}
  | {{ #if: {{{coauthors|}}} | ,&#32;{{{coauthors}}} }}
}}{{
   #if: {{{origdate|}}}
  | &#32;<nowiki>[</nowiki>{{{origdate}}}]
  | {{
    #if: {{{origyear|}}}
    | {{
      #if: {{{origmonth|}}}
      | &#32;<nowiki>[</nowiki>{{{origmonth}}} {{{origyear}}}]
      | &#32;<nowiki>[</nowiki>{{{origyear}}}]
    }}
   }}
}}{{
  #if: {{{date|}}}
  | &#32;({{{date}}})
  | {{
    #if: {{{year|}}}
    | {{
      #if: {{{month|}}}
      | &#32;({{{month}}} {{{year}}})
      | &#32;({{{year}}})
    }}
   }}
}}{{ #if: {{{author|{{{last|}}}}}} | .
}}{{
  #if: {{{chapter|}}}
  | &#32;“{{
    #if: {{{chapterurl|}}}
    | [{{{chapterurl}}} {{{chapter}}}]
    | {{{chapter}}}
}}”,}}{{
  #if: {{{editor|}}}
   | &#32;{{{editor}}}:
}} <i>{{
  #if: {{{url|}}} | [{{{url}}} {{{title}}}] | {{{title}}}
}}</i>{{
  #if: {{{format|}}} | &#32;({{{format}}})
}}{{
  #if: {{{others|}}} | , {{{others}}}
}}{{
   #if: {{{edition|}}} | , {{{edition}}}
}}{{
  #if: {{{language|}}} | &#32;(in {{{language}}})
}}{{
  #if: {{{publisher|}}}
  | {{#if: {{{format|}}}{{{others|}}}{{{edition|}}} | ,&#32; | .&#32; }}{{
    #if: {{{location|}}}  
    | {{{location}}}:&#32;
  }}{{{publisher}}}
}}{{
  #if: {{{pages|}}} | ,&#32;{{{pages}}}
}}{{
  #if: {{{doi|}}} | . DOI:[http://dx.doi.org/{{{doi}}} {{{doi}}}]
}}{{
  #if: {{{id|}}} | . {{{id}}}
}}{{
  #if: {{{accessdate|}}}
   | . Retrieved on {{{accessdate}}}
  | {{
    #if: {{{accessyear|}}}
    | . Retrieved {{
      #if: {{{accessmonth|}}}
      | on [[{{{accessmonth}}} {{{accessyear}}}]]
      | during [[{{{accessyear}}}]]
    }}
   }}
}}.{{ #if: {{{quote|}}} | &nbsp;“{{{quote}}}”
}}</cite></includeonly><noinclude>
 
This template is used to Cite books. It is specifically for books. __NOTOC__
 
== Usage ==
All fields '''''must''''' be lowercase.
 
Copy a blank version to use. Remember to use the "|" (pipe) character between each field.  Please delete any unused fields to avoid clutter in the edit window.
 
No template is necessary in the <code>id</code> field when using an ISBN (see WP:ISBN).  Simply use the keyword <code>ISBN</code>, followed by the number (separated by a space).  Templates are available for other identification number types (ISSN, Library of Congress Classification, etc.)  See also the complete [[#Description of fields|description of fields]].
{| class="wikitable" cellpadding="6"
! colspan="3" | Full version (copy and paste text below and delete parameters you don't need)
|- width="50%" valign="top" style="vertical-align:top;"
| colspan="3" |
:<span style="font-family:Courier; "><nowiki>{{cite book |last= |first= |authorlink= |coauthors= |editor= |others= |title= |origdate= |origyear= |origmonth= |url= |format= |accessdate= |accessyear= |accessmonth= |edition= |date= |year= |month= |publisher= |location= |language= |id= |doi = |pages= |chapter= |chapterurl= |quote = }}</nowiki></span>
|- width="50%" valign="top" style="vertical-align:top;"
! colspan="3" | Most commonly used fields (or you can use this and not have to delete as much)
|- width="50%" valign="top" style="vertical-align:top;"
| colspan="3" |
:<span style="font-family:Courier; "><nowiki>{{cite book |last= |first= |authorlink= |coauthors= |title= |year= |publisher= |location= |id= }}</nowiki></span>
|- width="50%" valign="top" style="vertical-align:top;"
! Example 1
| style="vertical-align: top;" |
<span style="font-family:Courier; "><nowiki>{{cite book |last= Cordell |first= Bruce R. |coauthors= Jeff Grubb, David Yu |title= Manual of the Planes |publisher= Wizards of the Coast |year= 2001 |month= September |id= ISBN 0-7869-1850-8 }}</nowiki></span>
| style="vertical-align: top;" |  
{{cite book |last= Cordell |first= Bruce R. |coauthors= Jeff Grubb, David Yu |title= Manual of the Planes |publisher= Wizards of the Coast |year= 2001 |month= September |id= ISBN 0-7869-1850-8 }}
|- width="50%" valign="top" style="vertical-align:top;"
! Example 2
| style="vertical-align: top;" |<pre>
{{cite book
  | last = Mumford
  | first = David
  | authorlink = David Mumford
  | title = The Red Book of Varieties and Schemes
  | publisher = Springer-Verlag
  | year = 1999
  | doi = 10.1007/b62130
  | id = ISBN 354063293X }}</pre>
| style="vertical-align: top;" |
{{cite book
  | last = Mumford
  | first = David
  | authorlink = David Mumford
  | title = The Red Book of Varieties and Schemes
  | publisher = Springer-Verlag
  | year = 1999
  | doi = 10.1007/b62130
  | id = ISBN 354063293X }}
|- width="50%" valign="top" style="vertical-align:top;"
! Vertical list !! Prerequisites and Brief Instructions
| rowspan="2" width="100%" | &nbsp;
|- width="50%" valign="top" style="vertical-align:top;"
| style="vertical-align:top;padding:1ex;" |<pre>
&nbsp;
&nbsp;
{{cite book
| last =
| first =
| authorlink =
| coauthors =
| editor =
| others =
| title =
| origdate =
| origyear =
| origmonth =
| url =
| format =
| accessdate =
| accessyear =
| accessmonth =
| edition =
| date =
| year =
| month =
| publisher =
| location =
| language =
| id =
| doi =
| pages =
| chapter =
| chapterurl =
| quote =
}}</pre>
| style="vertical-align:top;padding:1ex;" |<pre>
Prerequisites* Brief Instructions
-------------- -----------------------
&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;(no wikilink)
last&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; (no wikilink)
last
last
&nbsp;
&nbsp;
REQUIRED**
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;†preferred (no wikilink)
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;alternative to origdate
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;alternative to origdate
&nbsp;
url
url&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;†preferred (no wikilink)
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;alternative to accessdate
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;alternative to accessdate
&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;†preferred (no wikilink)
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;alternative to date
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;alternative to date
&nbsp;
publisher
&nbsp;
&nbsp;
&nbsp;
&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;(no wikilink)&Dagger;
chapter
&nbsp;
&nbsp;</pre>
|}
{| style="background:none;"
|- valign="top"
| style="text-align:right;" | &lowast; || The field listed below is a prerequisite for the field to the left. For example '''last''' is a prerequisite to '''first''' meaning '''first''' will NOT be displayed even if it has a value unless '''last''' also has a value.
|- valign="top"
| style="text-align:right;" | &lowast;&lowast; || Wikilinks '''''must''''' link to an existing article, and cannot be used if '''url''' is used below.
|- valign="top"
| style="text-align:right;" | † || This is the preferred field with its alternates listed below.
|- valign="top"
| style="text-align:right;" | &Dagger; || If '''chapterurl''' is provided then '''chapter''' can not have wikilinks.
|}
 
== Fields ==
===Wikilinks===
Most fields can be wikilinked (ie. ''title'' = <nowiki>[[book article|book title]]</nowiki>), but should generally only be linked to an existing Wikipedia article. Any wikilinked field '''must not''' contain any brackets apart from normal round brackets <code>()</code> &mdash; don't use <code><nowiki><>[]{}</nowiki></code>.
 
===Description of fields===
====<small>Syntax (for the technical-minded)</small>====
<div style="font-size: 90%;">
Nested fields either rely on their parent fields, or replace them:
*''parent''
**''child'' &mdash; may be used '''with''' ''parent'' (and is ignored if ''parent'' is not used)
**OR:  ''child2'' &mdash; may be used '''instead''' of ''parent'' (and is ignored if ''parent'' is used)
</div>
 
====Description====
* '''last''': Surname of author. Don't wikilink (use ''authorlink'' instead).
** '''first''': First name(s) of author, including title(s) (eg. ''Firstname Middlename'' or ''Firstname M.'' or ''Dr. Firstname M., Snr.''). Don't wikilink (use ''authorlink'' instead).
*** The `last' and `first' fields are poorly named for the case of an author whose surname is usually written first (e.g. as in Chinese).  They also have the problem of only communicating which is the surname, not communicating where the surname is usually written.  Consider deprecating first,last fields, and reinstating author field, using the notation "Smith, John" or "Hu Ke Jie" as appropriate (i.e. always writing surname first, and using comma or not depending on whether the name is usually written surname last or first).
** '''authorlink''': Title of Wikipedia article about author. Article should already exist. Must not be wikilinked itself. Do not use this on its own, but along with "author" or "first" and "last".
** '''coauthors''': Full name of additional author or authors, surname last, separated by ", " (eg. ''Joe Bloggs, John F. Kennedy, H. R. Dent'').
*** Someone please confirm that surname is to go last even for people whose name is usually written surname first. Consider rethinking this field, e.g. using ''Bloggs, Joe and Kennedy, John F. and Dent, H. R. and Hu Ke Jie''.
** OR: '''author''': Full name of author, preferably surname first.
* '''editor''': Name of editor/editors. No text is added, so labels such as "(ed.)" have to be supplied by the user.
* '''others''': For uses such as "illustrated by Smith" or "trans. Smith".
* '''title''': Title of book. '''''This is the only required parameter.''''' Can be wikilinked '''only''' to an existing Wikipedia article. Do not use italics.
* '''url''': URL of an online book. Cannot be used if you wikilinked ''title''.
** '''format''': Format, e.g. PDF. HTML implied if not specified.
** '''accessdate''': Full date when url was accessed, in ISO 8601 YYYY-MM-DD format, eg. ''2006-02-17''. '''Required when ''url'' field is used.''' Must not be wikilinked.
*** OR:  '''accessyear''': Year when item was accessed, and '''accessmonth''': Month when item was accessed. If you also have the day, use ''accessdate'' instead. Must not be wikilinked.
* '''edition''': When the book has more than one edition. ''eg:'' "2nd edition".
* '''origdate''': Full date of publication of original edition, in ISO 8601 YYYY-MM-DD format, eg. ''2004-06-27''. Must not be wikilinked.
** OR:  '''origyear''': Year of publication of original edition, and '''origmonth''': Month of publication of original edition. If you also have the day, use ''date'' instead. Must not be wikilinked.
* '''date''': Full date of publication edition being referenced, in ISO 8601 YYYY-MM-DD format, eg. ''2006-02-17''. Must not be wikilinked.
** OR:  '''year''': Year of publication edition being referenced, and '''month''': Name of the month of publication. If you also have the day, use ''date'' instead. Must not be wikilinked.
* '''publisher''': Publisher should not include corporate designation such is "Ltd" or "Inc".
** '''location''': Place of publication.
* '''language''': The language the book is written in, if it is not English.
* '''id''': Identifier such as ''<nowiki>ISBN 1-111-22222-9</nowiki>'', ''<nowiki>{{</nowiki>|Z253.U69}}'' or ''<nowiki>{{</nowiki>|123456789}}''. Remember, you '''must''' specify the kind of identifier, not just give a number.
* '''doi''': A digital object identifier such as ''<nowiki>10.1016/j.coi.2004.08.001</nowiki>''.
* '''pages''': ''<nowiki>pp. 5&ndash;7</nowiki>'': first page and optional last page. This is for listing the pages relevant to the citation, not the total number of pages in the book.
* '''chapter''': The chapter of the book, written in full. Punctuation other than quotes should be included in the value passed to the parameter, eg. ''chapter = Meet Dick and Jane.'' produces "Meet Dick and Jane." ahead of ''title''.
** '''chapterurl''': URL of an individual chapter of online book. Should be at the same site as ''url'', if any.
* '''quote''': Relevant quote from the book.
 
==Examples==
;Just a title:
:<code><nowiki>* {{cite book | title=Mysterious book }}</nowiki></code>
 
:* {{cite book | title = Mysterious book }}
 
;Year and title:
:<code><nowiki>* {{cite book | title=Mysterious book | year=1901 }}</nowiki></code>
 
:* {{cite book | title = Mysterious book | year = 1901 }}
 
;Basic usage:
:<code><nowiki>* {{cite book | first=Joe | last=Bloggs | authorlink=Joe Bloggs | year=1974 | title=Book of Bloggs }}</nowiki></code>
 
:* {{cite book | first=Joe | last=Bloggs | authorlink=Joe Bloggs | year=1974 | title=Book of Bloggs }}
 
;Basic usage with url:
:<code><nowiki>* {{cite book | last=Bloggs | first=Joe | authorlink=Joe Bloggs | year=1974 | title=Book of Bloggs | edition=1st Edition | url=http://en.wikipedia.org/ | accessdate=2006-02-17 }}</nowiki></code>
 
:* {{cite book | last=Bloggs | first=Joe | authorlink=Joe Bloggs | year=1974 | title=Book of Bloggs | edition=1st Edition | url=http://en.wikipedia.org/ | accessdate=2006-02-17 }}
 
;Three authors, title with a piped wikilink, edition
:<code><nowiki>* {{cite book | last=Bloggs | first=Joe | authorlink=Joe Bloggs | coauthors=John Smith, Jim Smythe | title=A Thousand Acres | edition=2nd Edition }}</nowiki></code>
 
:* {{cite book | last=Bloggs | first=Joe | authorlink=Joe Bloggs | coauthors=John Smith, Jim Smythe | title=A Thousand Acres | edition=2nd Edition }}
 
;Date without day, wikilinked title and publisher, id, pages, location
:<code><nowiki>* {{cite book | last=Cordell | first=Bruce R. | coauthors=Jeff Grubb, David Noonan | year=2001 | month=September | title=Manual of the Planes | publisher=Wizards of the Coast | location=Timbuktu | id=ISBN 0-7869-1850-8 | pages=pp. 134-137 }}</nowiki></code>
 
:* {{cite book | last=Cordell | first=Bruce R. | coauthors=Jeff Grubb, David Noonan | year=2001 | month=September | title=Manual of the Planes | publisher=[[Wizards of the Coast]] | location=Timbuktu | id=ISBN 0-7869-1850-8 | pages=pp. 134-137 }}
 
;Date of first edition, other language, illustrator
:<code><nowiki>* {{cite book | last=Bloggs | first=Joe | origyear=1463 | year=1974 | title=Book of Bloggs | edition=1st Edition | others=illustrated by Smith | language=German | url=http://en.wikipedia.org/ | accessdate=2006-02-17 }}</nowiki></code>
 
:* {{cite book | last=Bloggs | first=Joe | origyear=1463 | year=1974 | title=Book of Bloggs | edition=1st Edition | others=illustrated by Smith | language=German | url=http://en.wikipedia.org/ | accessdate=2006-02-17 }}
 
;Using a Digital object identifier
:<code><nowiki>*{{cite book
| last=Mumford
| first=David
| authorlink=David Mumford
| year=1999
| title=The Red Book of Varieties and Schemes: Includes the Michigan Lectures (1974) on Curves and Their Jacobians
| edition=2nd ed.
| publisher=Springer-Verlag
| doi=10.1007/b62130
| id=ISBN 354063293X
}}</nowiki></code>
 
:*{{cite book
| last=Mumford
| first=David
| authorlink=David Mumford
| year=1999
| title=The Red Book of Varieties and Schemes: Includes the Michigan Lectures (1974) on Curves and Their Jacobians
| edition=2nd ed.
| publisher=Springer-Verlag
| doi=10.1007/b62130
| id=ISBN 354063293X
}}
 
==Note==
Note the extra full-stop when the last author ends with an initial, and there is no date:
*{{cite book | last = Invisible | first = M. | title = Mysterious book }}
We don't know of a practical solution to this &mdash; unless there is a way to test the characters of a field?
 
==Citation styles==
Established citation styles for coauthors:
 
* [http://www.english.uiuc.edu/cws/wworkshop/writer_resources/citation_styles/mla/mla.htm MLA style]: Last, First and First Last. "If there are more than three authors, you may list only the first author followed by the phrase ''et al''."
* [http://www.english.uiuc.edu/cws/wworkshop/writer_resources/citation_styles/apa/apa.htm APA style]: Last, F. & Last, F.
* [http://www.liunet.edu/cwis/cwp/library/workshop/citchi.htm Chicago Manual of Style]: Last, First, and First Last.
* [http://www.liunet.edu/cwis/cwp/library/workshop/cittur.htm Turabian]: same as Chicago Reference List, above.
* [http://www.library.uq.edu.au/training/citation/harvard.html Harvard]: Last, F., Last, F. & Last, F.


  |Given2 = {{{first2|{{{given2|}}}}}}
  |Given3 = {{{first3|{{{given3|}}}}}}
  |Given4 = {{{first4|{{{given4|}}}}}}
  |Given5 = {{{first5|{{{given5|}}}}}}
  |Given6 = {{{first6|{{{given6|}}}}}}
  |Given7 = {{{first7|{{{given7|}}}}}}
  |Given8 = {{{first8|{{{given8|}}}}}}
  |Given9 = {{{first9|{{{given9|}}}}}}
  |Authorlink1 = {{{author-link|{{{author1-link|{{{authorlink|{{{authorlink1|}}}}}}}}}}}}
  |Authorlink2 = {{{author2-link|{{{authorlink2|}}}}}}
  |Authorlink3 = {{{author3-link|{{{authorlink3|}}}}}}
  |Authorlink4 = {{{author4-link|{{{authorlink4|}}}}}}
  |Authorlink5 = {{{author5-link|{{{authorlink5|}}}}}}
  |Authorlink6 = {{{author6-link|{{{authorlink6|}}}}}}
  |Authorlink7 = {{{author7-link|{{{authorlink7|}}}}}}
  |Authorlink8 = {{{author8-link|{{{authorlink8|}}}}}}
  |Authorlink9 = {{{author9-link|{{{authorlink9|}}}}}}
  |Coauthors = {{{coauthor|{{{coauthors|}}}}}}
  |Year={{{year|{{    <!-- attempt to derive year from date, if possible -->
            #if: {{{date|}}}
            |{{
                #iferror:{{#time:Y|{{{date|}}} }}
                |{{#iferror:{{#time:Y|{{{publication-date|einval}}} }}||{{#time:Y|{{{publication-date|}}} }}}}
                |{{#time:Y|{{{date|}}} }}
              }}
            |{{{publication-date|}}} <!-- last resort -->
          }}
        }}}
  |YearNote = {{{origyear|}}}
  |Date = {{#if:{{{date|}}}|{{{date}}}|{{{day|}}} {{{month|}}} {{{year|{{{publication-date|}}}}}}}}
  |Title={{{title|}}}
  |TransTitle={{{trans_chapter|}}}
  |TransItalic={{{trans_title|}}}
  |URL={{#if:{{{archiveurl|}}}|{{{archiveurl|}}}|{{{url|}}}}}
  |ArchiveURL = {{{archiveurl|}}}
  |OriginalURL = {{{url|}}}
  |ArchiveDate= {{{archivedate|}}}
  |TitleType={{{type|}}}
  |Series={{{series|}}}
  |Volume = {{{volume|}}}
  |Issue = {{{issue|{{{number|}}}}}}
  |At = {{
          #if: {{{journal|{{{periodical|{{{newspaper|{{{magazine|}}}}}}}}}}}}
          |{{{pages|{{{page|{{{at|}}}}}}}}}
          |{{
            #if: {{{page|}}}
            |{{#if:{{{nopp|}}}||p.&nbsp;}}{{{page}}}
            |{{
                #if: {{{pages|}}}
                |{{#if:{{{nopp|}}}||pp.&nbsp;}}{{{pages}}}
                |{{{at|}}}
              }}
          }}
        }}
  |IncludedWorkTitle = {{{chapter|{{{contribution|}}}}}}
  |IncludedWorkURL = {{{chapter-url|{{{chapterurl|{{{contribution-url|}}}}}}}}}
  |Other = {{{others|}}}
  |Edition = {{{edition|}}}
  |Place = {{{place|{{{location|}}}}}}
  |PublicationPlace = {{{publication-place|{{{place|{{{location|}}}}}}}}}
  |Publisher = {{{publisher|}}}
  |PublicationDate = {{{publication-date|}}}
  |EditorSurname1 = {{{editor-last|{{{editor-surname|{{{editor1-last|{{{editor1-surname|{{{editor|{{{editors|}}}}}}}}}}}}}}}}}}
  |EditorSurname2 = {{{editor2-last|{{{editor2-surname|}}}}}}
  |EditorSurname3 = {{{editor3-last|{{{editor3-surname|}}}}}}
  |EditorSurname4 = {{{editor4-last|{{{editor4-surname|}}}}}}
  |EditorGiven1 = {{{editor-first|{{{editor-given|{{{editor1-first|{{{editor1-given|}}}}}}}}}}}}
  |EditorGiven2={{{editor2-first|{{{editor2-given|}}}}}}
  |EditorGiven3={{{editor3-first|{{{editor3-given|}}}}}}
  |EditorGiven4={{{editor4-first|{{{editor4-given|}}}}}}
  |Editorlink1={{{editor-link|{{{editor1-link|}}}}}}
  |Editorlink2={{{editor2-link|}}}
  |Editorlink3={{{editor3-link|}}}
  |Editorlink4={{{editor4-link|}}}
  |language = {{{language|{{{in|}}}}}}
  |format = {{{format|}}}
  |ID={{{id|{{{ID|}}}}}}
  |ISBN={{{isbn|{{{ISBN|}}}}}}
  |OCLC={{{oclc|{{{OCLC|}}}}}}
  |Bibcode={{{bibcode|}}}
  |DOI={{{doi|{{{DOI|}}}}}}
  |DoiBroken={{{doi_brokendate|}}}
  |AccessDate={{{access-date|{{{accessdate|}}}}}}
  |DateFormat={{{dateformat|none}}}
  |quote = {{{quote|}}}
  |laysummary = {{{laysummary|}}}
  |laydate = {{{laydate|}}}
  |Ref={{{ref|}}}
  |Sep = {{{separator|{{{seperator|.}}}}}}
  |PS = {{#if:{{{quote|}}}||{{{postscript|.}}}}}
  |AuthorSep = {{#ifeq:{{{author-separator|}}}|;|&#059;|{{{author-separator|&#059;}}}}}&#32;
  |NameSep = {{{author-name-separator|,}}}&#32;
  |Trunc = {{{display-authors|8}}}
  |amp = {{{lastauthoramp|}}}
}}{{#if:{{{accessdaymonth|}}}{{{accessmonthday|}}}{{{accessday|}}}{{{accessmonth|}}}{{{accessyear|}}}{{{day|}}}{{{access-date|}}}{{{dateformat|}}}|[[Category:Pages containing cite templates with deprecated parameters|{{NAMESPACE}} {{PAGENAME}}]]}}<noinclude>
{{documentation}}
</noinclude>
</noinclude>

Latest revision as of 18:27, 4 December 2010

. 

[edit] [[[:Template:Purge]]] Template documentation


Usage[edit source]

All fields must be lowercase.

Copy a blank version to use. Remember to use the "|" (pipe) character between each field. Please delete any unused fields to avoid clutter in the edit window.

No template is necessary in the id field when using an International Standard Book Number(ISBN). Simply use the keyword ISBN, followed by the number (separated by a space). Templates are available for other identification number types (ISSN, Library of Congress Classification, etc.) See also the complete description of fields.

Full version (copy and paste text below and delete parameters you don't need)
{{cite book |last= |first= |authorlink= |coauthors= |editor= |others= |title= |origdate= |origyear= |origmonth= |url= |format= |accessdate= |accessyear= |accessmonth= |edition= |date= |year= |month= |publisher= |location= |language= |id= |doi = |pages= |chapter= |chapterurl= |quote = }}
Most commonly used fields (or you can use this and not have to delete as much)
{{cite book |last= |first= |authorlink= |coauthors= |title= |year= |publisher= |location= |id= }}
Example 1

{{cite book |last= Cordell |first= Bruce R. |coauthors= Jeff Grubb, David Yu |title= Manual of the Planes |publisher= Wizards of the Coast |year= 2001 |month= September |id= ISBN 0-7869-1850-8 }}

Cordell, Bruce R.; Jeff Grubb, David Yu (September 2001). Manual of the Planes. Wizards of the Coast. ISBN 0-7869-1850-8. 

Example 2
{{cite book
  | last = Mumford
  | first = David
  | authorlink = David Mumford
  | title = The Red Book of Varieties and Schemes
  | publisher = Springer-Verlag
  | year = 1999
  | doi = 10.1007/b62130
  | id = ISBN 354063293X }}

Mumford, David (1999). The Red Book of Varieties and Schemes. Springer-Verlag. doi:10.1007/b62130. ISBN 354063293X. 

Vertical list Prerequisites and Brief Instructions  
  
  
 {{cite book
 | last = 
 | first = 
 | authorlink = 
 | coauthors = 
 | editor = 
 | others = 
 | title = 
 | origdate = 
 | origyear = 
 | origmonth = 
 | url = 
 | format = 
 | accessdate = 
 | accessyear = 
 | accessmonth = 
 | edition = 
 | date = 
 | year = 
 | month = 
 | publisher = 
 | location = 
 | language = 
 | id = 
 | doi =
 | pages = 
 | chapter = 
 | chapterurl = 
 | quote =
 }}
 Prerequisites* Brief Instructions
 -------------- -----------------------
   
               (no wikilink)
 last           (no wikilink)
 last 
 last 
  
  
 REQUIRED**
               †preferred (no wikilink)
                alternative to origdate
                alternative to origdate
  
 url
 url           †preferred (no wikilink)
                alternative to accessdate
                alternative to accessdate
  
               †preferred (no wikilink)
                alternative to date
                alternative to date
  
 publisher
  
  
  
  
               (no wikilink)‡
 chapter
  
  
The field listed below is a prerequisite for the field to the left. For example last is a prerequisite to first meaning first will NOT be displayed even if it has a value unless last also has a value.
∗∗ Wikilinks must link to an existing article, and cannot be used if url is used below.
This is the preferred field with its alternates listed below.
If chapterurl is provided then chapter can not have wikilinks.

Fields[edit source]

Wikilinks[edit source]

Most fields can be wikilinked (ie. title = [[book article|book title]]), but should generally only be linked to an existing Wikipedia article. Any wikilinked field must not contain any brackets apart from normal round brackets () — don't use <>[]{}.

Description of fields[edit source]

Syntax (for the technical-minded)[edit source]

Nested fields either rely on their parent fields, or replace them:

  • parent
    • child — may be used with parent (and is ignored if parent is not used)
    • OR: child2 — may be used instead of parent (and is ignored if parent is used)

Description[edit source]

  • last: Surname of author. Don't wikilink (use authorlink instead).
    • first: First name(s) of author, including title(s) (eg. Firstname Middlename or Firstname M. or Dr. Firstname M., Snr.). Don't wikilink (use authorlink instead).
      • The `last' and `first' fields are poorly named for the case of an author whose surname is usually written first (e.g. as in Chinese). They also have the problem of only communicating which is the surname, not communicating where the surname is usually written. Consider deprecating first,last fields, and reinstating author field, using the notation "Smith, John" or "Hu Ke Jie" as appropriate (i.e. always writing surname first, and using comma or not depending on whether the name is usually written surname last or first).
    • authorlink: Title of Wikipedia article about author. Article should already exist. Must not be wikilinked itself. Do not use this on its own, but along with "author" or "first" and "last".
    • coauthors: Full name of additional author or authors, surname last, separated by ", " (eg. Joe Bloggs, John F. Kennedy, H. R. Dent).
      • Someone please confirm that surname is to go last even for people whose name is usually written surname first. Consider rethinking this field, e.g. using Bloggs, Joe and Kennedy, John F. and Dent, H. R. and Hu Ke Jie.
    • OR: author: Full name of author, preferably surname first.
  • editor: Name of editor/editors. No text is added, so labels such as "(ed.)" have to be supplied by the user.
  • others: For uses such as "illustrated by Smith" or "trans. Smith".
  • title: Title of book. This is the only required parameter. Can be wikilinked only to an existing Wikipedia article. Do not use italics.
  • url: URL of an online book. Cannot be used if you wikilinked title.
    • format: Format, e.g. PDF. HTML implied if not specified.
    • accessdate: Full date when url was accessed, in ISO 8601 YYYY-MM-DD format, eg. 2006-02-17. Required when url field is used. Must not be wikilinked.
      • OR: accessyear: Year when item was accessed, and accessmonth: Month when item was accessed. If you also have the day, use accessdate instead. Must not be wikilinked.
  • edition: When the book has more than one edition. eg: "2nd edition".
  • origdate: Full date of publication of original edition, in ISO 8601 YYYY-MM-DD format, eg. 2004-06-27. Must not be wikilinked.
    • OR: origyear: Year of publication of original edition, and origmonth: Month of publication of original edition. If you also have the day, use date instead. Must not be wikilinked.
  • date: Full date of publication edition being referenced, in ISO 8601 YYYY-MM-DD format, eg. 2006-02-17. Must not be wikilinked.
    • OR: year: Year of publication edition being referenced, and month: Name of the month of publication. If you also have the day, use date instead. Must not be wikilinked.
  • publisher: Publisher should not include corporate designation such is "Ltd" or "Inc".
    • location: Place of publication.
  • language: The language the book is written in, if it is not English.
  • id: Identifier such as ISBN 1-111-22222-9, {{LCC|Z253.U69}} or {{OCLC|123456789}}. Remember, you must specify the kind of identifier, not just give a number.
  • doi: A digital object identifier such as 10.1016/j.coi.2004.08.001.
  • pages: pp. 5–7: first page and optional last page. This is for listing the pages relevant to the citation, not the total number of pages in the book.
  • chapter: The chapter of the book, written in full. Punctuation other than quotes should be included in the value passed to the parameter, eg. chapter = Meet Dick and Jane. produces "Meet Dick and Jane." ahead of title.
    • chapterurl: URL of an individual chapter of online book. Should be at the same site as url, if any.
  • quote: Relevant quote from the book.

Examples[edit source]

Just a title
* {{cite book | title=Mysterious book }}
  • Mysterious book. 
Year and title
* {{cite book | title=Mysterious book | year=1901 }}
  • Mysterious book. 1901. 
Basic usage
* {{cite book | first=Joe | last=Bloggs | authorlink=Joe Bloggs | year=1974 | title=Book of Bloggs }}
Basic usage with url
* {{cite book | last=Bloggs | first=Joe | authorlink=Joe Bloggs | year=1974 | title=Book of Bloggs | edition=1st Edition | url=http://en.wikipedia.org/ | accessdate=2006-02-17 }}
Three authors, title with a piped wikilink, edition
* {{cite book | last=Bloggs | first=Joe | authorlink=Joe Bloggs | coauthors=John Smith, Jim Smythe | title=[[A Thousand Acres|1000 Acres]] | edition=2nd Edition }}
  • Bloggs, Joe; John Smith, Jim Smythe. 1000 Acres (2nd Edition ed.). 
Date without day, wikilinked title and publisher, id, pages, location
* {{cite book | last=Cordell | first=Bruce R. | coauthors=Jeff Grubb, David Noonan | year=2001 | month=September | title=Manual of the Planes | publisher=Wizards of the Coast | location=Timbuktu | id=ISBN 0-7869-1850-8 | pages=pp. 134-137 }}
  • Cordell, Bruce R.; Jeff Grubb, David Noonan (September 2001). Manual of the Planes. Timbuktu: Wizards of the Coast. pp. pp. 134-137. ISBN 0-7869-1850-8. 
Date of first edition, other language, illustrator
* {{cite book | last=Bloggs | first=Joe | origyear=1463 | year=1974 | title=Book of Bloggs | edition=1st Edition | others=illustrated by Smith | language=German | url=http://en.wikipedia.org/ | accessdate=2006-02-17 }}
Using a Digital object identifier
*{{cite book | last=Mumford | first=David | authorlink=David Mumford | year=1999 | title=The Red Book of Varieties and Schemes: Includes the Michigan Lectures (1974) on Curves and Their Jacobians | edition=2nd ed. | publisher=Springer-Verlag | doi=10.1007/b62130 | id=ISBN 354063293X }}
  • Mumford, David (1999). The Red Book of Varieties and Schemes: Includes the Michigan Lectures (1974) on Curves and Their Jacobians (2nd ed. ed.). Springer-Verlag. doi:10.1007/b62130. ISBN 354063293X. 

Testing[edit source]

Note[edit source]

Note the extra full-stop when the last author ends with an initial, and there is no date:

  • Invisible, M.. Mysterious book. 

We don't know of a practical solution to this — unless there is a way to test the characters of a field?

Citation styles[edit source]

Established citation styles for coauthors:

  • MLA style: Last, First and First Last. "If there are more than three authors, you may list only the first author followed by the phrase et al."
  • APA style: Last, F. & Last, F.
  • Chicago Manual of Style: Last, First, and First Last.
  • Turabian: same as Chicago Reference List, above.
  • Harvard: Last, F., Last, F. & Last, F.

See also[edit source]