Difference between revisions of "Template:Cite book/doc"

From Pathfinder Wiki
 
(4 intermediate revisions by the same user not shown)
Line 1: Line 1:
< | ref =
+
<includeonly>{{template doc page transcluded}}</includeonly><noinclude>{{template doc page viewed directly}}</noinclude><!-- EDIT TEMPLATE DOCUMENTATION BELOW THIS LINE -->
}}</pre>
+
{{important|1=Please ensure that you <spwwwwwn class=plainlinks>[http://en.wikipedia.org/w/index.php?title=Template:Cite_book/doc&action=edit update the documentation]</span> when adding or removing functionality to this template.}}
 +
This template is used to [[WP:CITE|cite sources]] in Wikipedia. It is specifically for books. This template replaces the deprecated {{tl|book reference}}. __NOTOC__
 +
==Usage==
 +
All field names '''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 templates or magic words are necessary when using an [[ISBN]], [[OCLC]] number, or [[DOI]] as an identifier.  Instead of using the <code>id</code> field in these instances, simply use the appropriate field.  For instance, type <code>isbn=</code> followed by the number instead of <code>id=ISBN</code>.  Templates are available for other identification number types to be used in the ID field ({{tl|ISSN}}, {{tl|LCCN}}, {{tl|LCC}}, etc.) if these aren't available.  See also the complete [[#Description of fields|description of fields]].
 +
 
 +
{| class="wikitable"
 +
! 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" |
 +
:<tt><nowiki>{{cite book |last= |first= |authorlink= |coauthors= |editor= |others= |title= |origdate= |origyear= |origmonth= |url= |format= |accessdate= |accessyear= |accessmonth= |edition= |series= |volume= |date= |year= |month= |publisher= |location= |language= |isbn= |oclc= |doi= |id= |pages= |chapter= |chapterurl= |quote= }}</nowiki></tt>
 +
|- 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" |
 +
:<tt><nowiki>{{cite book |title= |last= |first= |authorlink= |coauthors= |year= |publisher= |location= |isbn= |pages= }}</nowiki></tt>
 +
|- width="50%" valign="top" style="vertical-align:top;"
 +
! Example 1
 +
| style="vertical-align: top;" |
 +
<tt><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 |isbn= 0-7869-1850-8 }}</nowiki></tt>
 +
| 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 |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]]
 +
  | series = Lecture notes in mathematics 1358
 +
  | year = 1999
 +
  | doi = 10.1007/b62130
 +
  | 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]]
 +
  | series = Lecture notes in mathematics 1358
 +
  | year = 1999
 +
  | doi = 10.1007/b62130
 +
  | isbn = 354063293X }}
 +
|}
 +
 
 +
{| class="wikitable"
 +
|- width="50%" valign="top" style="vertical-align:top;"
 +
! Vertical list !! Prerequisites * !! Brief instructions
 +
|- width="50%" valign="top" style="vertical-align:top;"
 +
| style="vertical-align:top;padding:1ex;" |<pre>
 +
{{cite book
 +
|last=
 +
|first=
 +
|authorlink=
 +
|coauthors=
 +
|editor=
 +
|others=
 +
|title=
 +
|origdate=
 +
|origyear=
 +
|origmonth=
 +
|url=
 +
|format=
 +
|accessdate=
 +
|accessyear=
 +
|accessmonth=
 +
|edition=
 +
|series=
 +
|volume=
 +
|date=
 +
|year=
 +
|month=
 +
|publisher=
 +
|location=
 +
|language=
 +
|isbn=
 +
|oclc=
 +
|doi=
 +
|id=
 +
|pages=
 +
|chapter=7
 +
|chapterurl=
 +
|quote=
 +
|ref=
 +
}}</pre>
 
| style="vertical-align:top;padding:1ex;" |<pre>
 
| style="vertical-align:top;padding:1ex;" |<pre>
 
  &nbsp;  
 
  &nbsp;  
Line 16: Line 106:
 
  url
 
  url
 
  url
 
  url
 +
&nbsp;
 
  &nbsp;
 
  &nbsp;
 
  &nbsp;
 
  &nbsp;
Line 52: Line 143:
 
  &nbsp;alternative to accessdate
 
  &nbsp;alternative to accessdate
 
  &nbsp;alternative to accessdate
 
  &nbsp;alternative to accessdate
 +
&nbsp;
 
  &nbsp;
 
  &nbsp;
 
  &nbsp;
 
  &nbsp;
Line 76: Line 168:
 
&Dagger; If '''chapterurl''' is provided then '''chapter''' can not have wikilinks.
 
&Dagger; If '''chapterurl''' is provided then '''chapter''' can not have wikilinks.
  
== Fields ==
+
==Fields==
 
===Wikilinks===
 
===Wikilinks===
 
Most fields can be wikilinked (i.e. ''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>.
 
Most fields can be wikilinked (i.e. ''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>.
Line 90: Line 182:
  
 
====Description====
 
====Description====
* '''last''': Surname of author. Don't wikilink (use ''authorlink'' instead).
+
*'''last''': Surname of author. Don't wikilink (use ''authorlink'' instead).
** '''first''': First name(s) of author, including title(s) (e.g. ''Firstname Middlename'' or ''Firstname M.'' or ''Dr. Firstname M., Snr.''). Don't wikilink (use ''authorlink'' instead).
+
**'''first''': First name(s) of author, including title(s) (e.g. ''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).
+
***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".
+
**'''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, separated by ", " (e.g. ''Joe Bloggs, John F. Kennedy, H. R. Dent'').
+
**'''coauthors''': Full name of additional author or authors, separated by ", " (e.g. ''Joe Bloggs, John F. Kennedy, H. R. Dent'').
*** Whether the surname of the co-authors goes first or last is dependent on the citation style (see the [[#Citation_styles|citation style]] section below) preferred.
+
***Whether the surname of the co-authors goes first or last is dependent on the citation style (see the [[#Citation_styles|citation style]] section below) preferred.
** OR: '''author''': Full name of author, preferably surname first.
+
**OR: '''author''': Full name of author, preferably surname first.
* '''editor''': Name of editor/editors. No text is added beyond "''in''," so labels such as "(ed.)" have to be supplied by the user.
+
*'''editor''': Name of editor/editors. No text is added beyond "''in''," so labels such as "(ed.)" have to be supplied by the user.
 
**This field should only be used when the cited author and the book editor are different. If the whole book is cited, instead of a specific part, use the "author" fields (possibly with extra "(ed.)" instead)
 
**This field should only be used when the cited author and the book editor are different. If the whole book is cited, instead of a specific part, use the "author" fields (possibly with extra "(ed.)" instead)
* '''others''': For uses such as "illustrated by Smith" or "trans. Smith".
+
*'''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.
+
*'''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 location where the book can be found. Cannot be used if you wikilinked ''title''.
+
*'''url''': URL of an online location where the book can be found. Cannot be used if you wikilinked ''title''.
** '''format''': Format, e.g. PDF. HTML implied if not specified.
+
**'''format''': Format, e.g. PDF. HTML implied if not specified.
** '''accessdate''': Full date when url was accessed, in [[ISO 8601]] YYYY-MM-DD format, e.g. ''2006-02-17''. '''Required when ''url'' field is used.''' Must not be wikilinked.
+
**'''accessdate''': Full date when url was accessed, in [[ISO 8601]] YYYY-MM-DD format, e.g. ''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.
+
***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".
+
*'''edition''': When the book has more than one edition. ''eg:'' "2nd edition".
* '''series''': When the book is part of a series of publications
+
*'''series''': When the book is part of a series of publications
* '''origdate''': Full date of publication of original edition, in [[ISO 8601]] YYYY-MM-DD format, e.g. ''2004-06-27''. Must not be wikilinked.
+
*'''volume''': For 1 book with several volumes (there is a separate [[Template:Cite encyclopedia]])
** 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.
+
*'''origdate''': Full date of publication of original edition, in [[ISO 8601]] YYYY-MM-DD format, e.g. ''2004-06-27''. Must not be wikilinked.
* '''date''': Full date of publication edition being referenced, in [[ISO 8601]] YYYY-MM-DD format, e.g. ''2006-02-17''. 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.
** 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.
+
*'''date''': Full date of publication edition being referenced, in [[ISO 8601]] YYYY-MM-DD format, e.g. ''2006-02-17''. Must not be wikilinked.
* '''publisher''': Publisher should not include corporate designation such as "Ltd" or "Inc".
+
**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.
** '''location''': Place of publication.
+
*'''publisher''': Publisher should not include corporate designation such as "Ltd" or "Inc".
* '''language''': The language the book is written in, if it is not English.
+
**'''location''': Place of publication.
* '''isbn''': [[International Standard Book Number]] such as ''1-111-22222-9''.  Note that "isbn", like all field names, must be in lowercase.
+
*'''language''': The language the book is written in, if it is not English.
* '''oclc''': [[Online Computer Library Center]] ID number, such as ''3185581''
+
*'''isbn''': [[International Standard Book Number]] such as ''1-111-22222-9''.  Note that "isbn", like all field names, must be in lowercase.
* '''doi''': A [[digital object identifier]] such as ''<nowiki>10.1016/j.coi.2004.08.001</nowiki>''.
+
*'''oclc''': [[Online Computer Library Center]] ID number, such as ''3185581''
 +
*'''doi''': A [[digital object identifier]] such as ''<nowiki>10.1016/j.coi.2004.08.001</nowiki>''.
 
**'''doilabel''': If the doi contains some characters that must be [[Percent-encoding|escaped]], use "doilabel" for the unescaped version. See {{tl|doi}}: "id" is equivalent to "doi" and "label" is "doilabel"
 
**'''doilabel''': If the doi contains some characters that must be [[Percent-encoding|escaped]], use "doilabel" for the unescaped version. See {{tl|doi}}: "id" is equivalent to "doi" and "label" is "doilabel"
* '''id''': A [[unique identifier]], used if none of the above are applicable.  In this case, you need to specify the kind of identifier you are using, preferably with a template like {{tl|ISSN}}.  (Use one of the more specialized parameters if possible; they are linked automatically.  In other words, don't use ''<nowiki>id = ISBN 1-111-22222-9</nowiki>'' anymore.  Use ''isbn = 1-111-22222-9''.)
+
*'''id''': A [[unique identifier]], used if none of the above are applicable.  In this case, you need to specify the kind of identifier you are using, preferably with a template like {{tl|ISSN}}.  (Use one of the more specialized parameters if possible; they are linked automatically.  In other words, don't use ''<nowiki>id = ISBN 1-111-22222-9</nowiki>'' anymore.  Use ''isbn = 1-111-22222-9''.)
* '''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.
+
*'''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, e.g. ''chapter = Meet Dick and Jane.'' produces "Meet Dick and Jane." ahead of ''title''.
+
*'''chapter''': The chapter of the book, written in full. Punctuation other than quotes should be included in the value passed to the parameter, e.g. ''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.
+
**'''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.
+
*'''quote''': Relevant quote from the book.
* '''ref''': use this parameter to make the reference linkable. The variable is placed after the # in a hyperlink (the [[fragment identifier]]).
+
*'''ref''': use this parameter to make the reference linkable. The variable is placed after the # in a hyperlink (the [[fragment identifier]]).
  
 
==Examples==
 
==Examples==
Line 129: Line 222:
 
:<code><nowiki>* {{cite book | title=Mysterious book }}</nowiki></code>
 
:<code><nowiki>* {{cite book | title=Mysterious book }}</nowiki></code>
  
:* {{cite book | title = Mysterious book }}
+
:*{{cite book | title = Mysterious book }}
  
 
;Year and title:
 
;Year and title:
 
:<code><nowiki>* {{cite book | title=Mysterious book | year=1901 }}</nowiki></code>
 
:<code><nowiki>* {{cite book | title=Mysterious book | year=1901 }}</nowiki></code>
  
:* {{cite book | title = Mysterious book | year = 1901 }}
+
:*{{cite book | title = Mysterious book | year = 1901 }}
  
 
;Basic usage:
 
;Basic usage:
 
:<code><nowiki>* {{cite book | first=Joe | last=Bloggs | authorlink=Joe Bloggs | year=1974 | title=Book of Bloggs }}</nowiki></code>
 
:<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 }}
+
:*{{cite book | first=Joe | last=Bloggs | authorlink=Joe Bloggs | year=1974 | title=Book of Bloggs }}
  
 
;Basic usage with url:
 
;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>
 
:<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 }}
+
:*{{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
 
;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|1000 Acres]] | edition=2nd Edition }}</nowiki></code>
 
:<code><nowiki>* {{cite book | last=Bloggs | first=Joe | authorlink=Joe Bloggs | coauthors=John Smith, Jim Smythe | title=[[A Thousand Acres|1000 Acres]] | edition=2nd Edition }}</nowiki></code>
  
:* {{cite book | last=Bloggs | first=Joe | authorlink=Joe Bloggs | coauthors=John Smith, Jim Smythe | title=[[A Thousand Acres|1000 Acres]] | edition=2nd Edition }}
+
:*{{cite book | last=Bloggs | first=Joe | authorlink=Joe Bloggs | coauthors=John Smith, Jim Smythe | title=[[A Thousand Acres|1000 Acres]] | edition=2nd Edition }}
  
 
;Date without day, wikilinked title and publisher, id, pages, location
 
;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 | isbn=0-7869-1850-8 | pages=pp. 134-137 }}</nowiki></code>
 
:<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 | 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 | isbn=0-7869-1850-8 | pages=pp. 134-137 }}
+
:*{{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 | isbn=0-7869-1850-8 | pages=pp. 134-137 }}
  
 
;Date of first edition, other language, illustrator
 
;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>
 
:<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 }}
+
:*{{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|DOI]]
 
;Using a [[Digital object identifier|DOI]]
 
:<code><nowiki>*{{cite book
 
:<code><nowiki>*{{cite book
| last=Mumford
+
|last=Mumford
| first=David
+
|first=David
| authorlink=David Mumford
+
|authorlink=David Mumford
| year=1999
+
|year=1999
| title=The Red Book of Varieties and Schemes: Includes the Michigan Lectures (1974) on Curves and Their Jacobians
+
|title=The Red Book of Varieties and Schemes: Includes the Michigan Lectures (1974) on Curves and Their Jacobians
| edition=2nd ed.
+
|edition=2nd ed.
| publisher=[[Springer-Verlag]]
+
|publisher=[[Springer-Verlag]]
| doi=10.1007/b62130
+
|doi=10.1007/b62130
| isbn=354063293X
+
|isbn=354063293X
 
}}</nowiki></code>
 
}}</nowiki></code>
  
 
:*{{cite book
 
:*{{cite book
| last=Mumford
+
|last=Mumford
| first=David
+
|first=David
| authorlink=David Mumford
+
|authorlink=David Mumford
| year=1999
+
|year=1999
| title=The Red Book of Varieties and Schemes: Includes the Michigan Lectures (1974) on Curves and Their Jacobians
+
|title=The Red Book of Varieties and Schemes: Includes the Michigan Lectures (1974) on Curves and Their Jacobians
| edition=2nd ed.
+
|edition=2nd ed.
| publisher=[[Springer-Verlag]]
+
|publisher=[[Springer-Verlag]]
| doi=10.1007/b62130
+
|doi=10.1007/b62130
| isbn=354063293X
+
|isbn=354063293X
 
}}
 
}}
  
Line 197: Line 290:
 
Established citation styles for coauthors:
 
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/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.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/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.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.
+
*[http://www.library.uq.edu.au/training/citation/harvard.html Harvard]: Last, F., Last, F. & Last, F.
  
 
==COinS==
 
==COinS==
Line 207: Line 300:
  
 
==Tools==
 
==Tools==
 
 
See [[Wikipedia:Citing sources#Tools]] for a list of tools which can help create a reference in the 'cite book' format.
 
See [[Wikipedia:Citing sources#Tools]] for a list of tools which can help create a reference in the 'cite book' format.
  
 
==See also==
 
==See also==
* [[Wikipedia:Cite sources]]: Style guide
+
*[[Wikipedia:Cite sources]]: Style guide
* [[Wikipedia:Citation templates]]: Related templates
+
*[[Wikipedia:Citation templates]]: Related templates
* [[Wikipedia:WikiProject Wikicite]]
+
*[[Wikipedia:WikiProject Wikicite]]
* [[:Category:Citation templates]]
+
*[[:Category:Citation templates]]
  
 
<includeonly>
 
<includeonly>
 
 
[[Category:Citation templates|{{PAGENAME}}]]
 
[[Category:Citation templates|{{PAGENAME}}]]
 
[[Category:Book templates|{{PAGENAME}}]]
 
[[Category:Book templates|{{PAGENAME}}]]
Line 230: Line 321:
 
[[eo:Ŝablono:Citu libron]]
 
[[eo:Ŝablono:Citu libron]]
 
[[eu:Txantiloi:Liburu erreferentzia]]
 
[[eu:Txantiloi:Liburu erreferentzia]]
[[fr:Modèle:Écrit]]
+
[[fr:Modèle:Ouvrage]]
 
[[ko:틀:서적 인용]]
 
[[ko:틀:서적 인용]]
 
[[it:Template:Cita libro]]
 
[[it:Template:Cita libro]]
Line 241: Line 332:
 
[[ro:Format:Cite book]]
 
[[ro:Format:Cite book]]
 
[[ru:Шаблон:Книга]]
 
[[ru:Шаблон:Книга]]
[[sk:Šablóna:Cite book]]
+
[[sk:Šablóna:Cite book]]waaaaaaaaaaaaaaat
 
[[sl:Predloga:Cite book]]
 
[[sl:Predloga:Cite book]]
 
[[fi:Malline:Kirjaviite]]
 
[[fi:Malline:Kirjaviite]]

Revision as of 12:37, 26 March 2008

Template:Template doc page viewed directly Template:Important This template is used to cite sources in Wikipedia. It is specifically for books. This template replaces the deprecated {{book reference}}.

Usage

All field names 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 templates or magic words are necessary when using an ISBN, OCLC number, or DOI as an identifier. Instead of using the id field in these instances, simply use the appropriate field. For instance, type isbn= followed by the number instead of id=ISBN. Templates are available for other identification number types to be used in the ID field ({{ISSN}}, {{LCCN}}, {{LCC}}, etc.) if these aren't available. 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= |series= |volume= |date= |year= |month= |publisher= |location= |language= |isbn= |oclc= |doi= |id= |pages= |chapter= |chapterurl= |quote= }}
Most commonly used fields (or you can use this and not have to delete as much)
{{cite book |title= |last= |first= |authorlink= |coauthors= |year= |publisher= |location= |isbn= |pages= }}
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 |isbn= 0-7869-1850-8 }}

Cordell, Bruce R.; Jeff Grubb, David Yu (September 2001). Manual of the Planes. Wizards of the Coast. Template:Hide in printTemplate:Only in print.

Example 2
{{cite book
  | last = Mumford
  | first = David
  | authorlink = David Mumford
  | title = The Red Book of Varieties and Schemes
  | publisher = [[Springer-Verlag]]
  | series = Lecture notes in mathematics 1358
  | year = 1999
  | doi = 10.1007/b62130
  | isbn = 354063293X }}

Mumford, David (1999). The Red Book of Varieties and Schemes. Lecture notes in mathematics 1358. Springer-Verlag. Template:Hide in printTemplate:Only in print. Template:Hide in printTemplate:Only in print.

Vertical list Prerequisites * Brief instructions
{{cite book
|last=
|first=
|authorlink=
|coauthors=
|editor=
|others=
|title=
|origdate=
|origyear=
|origmonth=
|url=
|format=
|accessdate=
|accessyear=
|accessmonth=
|edition=
|series=
|volume=
|date=
|year=
|month=
|publisher=
|location=
|language=
|isbn=
|oclc=
|doi=
|id=
|pages=
|chapter=7
|chapterurl=
|quote=
|ref=
}}
   
  
 last
 last 
 last 
  
  
 REQUIRED**
  
  
  
  
 url
 url
  
  
  
  
  
  
  
  
  
 publisher
  
  
  
  
  
  
  
 chapter
  
  
   
 (no wikilink)
 (no wikilink)
  
  
  
  
  
 †preferred (no wikilink)
  alternative to origdate
  alternative to origdate
  
  
 †preferred (no wikilink)
  alternative to accessdate
  alternative to accessdate
  
  
  
 †preferred (no wikilink)
  alternative to date
  alternative to date
  
  
  
  
  
  
  
  
 ‡(no wikilink)
  
  
  

† This is the preferred field with its alternates listed below.

‡ If chapterurl is provided then chapter can not have wikilinks.

Fields

Wikilinks

Most fields can be wikilinked (i.e. 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

Syntax (for the technical-minded)

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

  • last: Surname of author. Don't wikilink (use authorlink instead).
    • first: First name(s) of author, including title(s) (e.g. 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, separated by ", " (e.g. Joe Bloggs, John F. Kennedy, H. R. Dent).
      • Whether the surname of the co-authors goes first or last is dependent on the citation style (see the citation style section below) preferred.
    • OR: author: Full name of author, preferably surname first.
  • editor: Name of editor/editors. No text is added beyond "in," so labels such as "(ed.)" have to be supplied by the user.
    • This field should only be used when the cited author and the book editor are different. If the whole book is cited, instead of a specific part, use the "author" fields (possibly with extra "(ed.)" instead)
  • 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 location where the book can be found. 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, e.g. 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".
  • series: When the book is part of a series of publications
  • volume: For 1 book with several volumes (there is a separate Template:Cite encyclopedia)
  • origdate: Full date of publication of original edition, in ISO 8601 YYYY-MM-DD format, e.g. 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, e.g. 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 as "Ltd" or "Inc".
    • location: Place of publication.
  • language: The language the book is written in, if it is not English.
  • isbn: International Standard Book Number such as 1-111-22222-9. Note that "isbn", like all field names, must be in lowercase.
  • oclc: Online Computer Library Center ID number, such as 3185581
  • doi: A digital object identifier such as 10.1016/j.coi.2004.08.001.
    • doilabel: If the doi contains some characters that must be escaped, use "doilabel" for the unescaped version. See {{doi}}: "id" is equivalent to "doi" and "label" is "doilabel"
  • id: A unique identifier, used if none of the above are applicable. In this case, you need to specify the kind of identifier you are using, preferably with a template like {{ISSN}}. (Use one of the more specialized parameters if possible; they are linked automatically. In other words, don't use id = ISBN 1-111-22222-9 anymore. Use isbn = 1-111-22222-9.)
  • 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, e.g. 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.
  • ref: use this parameter to make the reference linkable. The variable is placed after the # in a hyperlink (the fragment identifier).

Examples

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 }}
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 | isbn=0-7869-1850-8 | pages=pp. 134-137 }}
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 DOI
*{{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 |isbn=354063293X }}

Testing

See Template:cite book/regression tests.

Note

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

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.

COinS

Template:UF-COinS

Tools

See Wikipedia:Citing sources for a list of tools which can help create a reference in the 'cite book' format.

See also