User talk:Gracefool/cite book

From Wikipedia, the free encyclopedia

Contents
Documentation - Discussion

[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:

Full version	Most common fields
{{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 = }}

Full version

Most common fields

{{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)

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)

[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.