From Wikipedia, the free encyclopedia

[edit] Documentation

The stable version of this template (ie. what you should use) is {{cite book}}.

This template replaces the deprecated {{book reference}}. It is compatible with book reference but only allows lowercase fields (as is standard). Additionally, {{cite book}} provides seven new parameters: origdate, origyear, origmonth, language, accessdate, accessyear and accessmonth (see below for a description).

[edit] Usage

All fields must be lowercase. Copy a blank version to use:

{{User:gracefool/cite book
 | last = 
 | first = 
 | authorlink = 
 | coauthors = 
 | editor = 
 | others = 
 | title = '''REQUIRED'''
 | origdate = 
 | origyear = 
 | origmonth = 
 | url = 
 | format = 
 | accessdate = 
 | accessyear = 
 | accessmonth = 
 | edition = 
 | date = 
 | year = 
 | month = 
 | publisher = 
 | location = 
 | language = 
 | id = 
 | pages = 
 | chapter = 
 | chapterURL = 
}}

{{User:gracefool/cite book
 | last = 
 | first = 
 | authorlink = 
 | coauthors = 
 | year = 
 | title = '''REQUIRED'''
 | publisher = 
 | location = 
 | id = 
}}

[edit] Fields

[edit] Wikilinks

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 <>[]{}.

[edit] Description of fields

[edit] Syntax (for the technical-minded)

[edit] 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).
  • authorlink: Title of Wikipedia article about author. Article should already exist. Must not be wikilinked itself.
  • coauthors: Full name of additional author or authors, surname last, separated by ", " (eg. Joe Bloggs, John F. Kennedy, H. R. Dent).
• editor: 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.
• url: URL of an online book. Cannot be used if you wikilinked title.
  • format: Format, i.e. PDF. HTTP implied if not specified.
  • accessdate: Full date when item 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, in ISO 8601 YYYY-MM-DD format, eg. 2006-02-17. Must not be wikilinked.
  • OR: year: Year of publication, and month: 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 or {{LCC|Z253.U69}}. Remember, you must specify the kind of identifier, not just give a number.
• pages: 1–2: first page, and optional last page.
• chapter: Produces:"Chapter" ahead of title. Punctuation other than quotes should be included in the value passed to the parameter (e.g., chapter = Meet Dick and Jane.)
  • chapterurl: URL of an individual chapter of online book. Should be at the same site as url, if any.

[edit] Deprecated

The following field is provided only for backward compatibility with {{book reference}}. Don't use it.

• author: Full name of author, preferably surname first.

[edit] Examples

• Just a title

Mysterious book.

• Year and title

(1901) Mysterious book.

• Basic usage

Joe, Bloggs (1974). Book of Bloggs.

• Basic usage with url

Bloggs, Joe (1974). Book of Bloggs, 1st Edition. Retrieved on 2006-02-17.

• Three authors, title with a piped wikilink, edition

Bloggs, Joe, John Smith, Jim Smythe. 1000 Acres, 2nd Edition.

• Date without day, wikilinked title and publisher, id

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

• Date of first edition, other language, illustrator

Bloggs, Joe [1463] (1974). Book of Bloggs, illustrated by Smith, 1st Edition (in German). URL accessed 2006-02-17.

[edit] Tests

• Author, year and title

Invisible, M. (1901). Mysterious book.

• Author and title

Invisible, Man. Mysterious book.

• Basic usage, wrong date format

Bloggs, Joe (1974). Book of Bloggs, 1st Edition. URL accessed 10 February 2006.

• Without accessdate

Bloggs, Joe. Book of Bloggs (PDF). URL accessed on February 2006.

• Full date of first edition

Bloggs, Joe [1963-06-27] (1974). Book of Bloggs, 1st Edition. URL accessed 2006-02-17.

[edit] Deprecated usage

• Author, year and title

Invisible, M. (1901) Mysterious book.

• Two authors

Invisible, M., Accomplice, A. Mysterious book.

[edit] Incorrect usage

• [ character in linked title

[[I smoke a ] bracket]]. ISBN 0-7869-1850-8.

• < character in linked title

[[I smoke a < bracket]]. ISBN 0-7869-1850-8.

[edit] 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?

[edit] Discussion

[edit] To do when breaking compatibility

• Add "Edited by" before editor instead of making the user do it.

··gracefool |☺ 02:11, 20 February 2006 (UTC)