User talk:Gracefool/cite book

{{documentation|content=

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

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

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

Wikilinks
Most fields can be wikilinked (ie. title = 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  &mdash; don't use.

Syntax (for the technical-minded)
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)
 * child2 &mdash; 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) (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.
 * 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.
 * 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.
 * 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  . 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.

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.

Examples

 * Just a title


 * Year and title


 * Basic usage


 * Basic usage with url


 * Three authors, title with a piped wikilink, edition


 * Date without day, wikilinked title and publisher, id


 * Date of first edition, other language, illustrator

Tests

 * Author, year and title


 * Author and title


 * Basic usage, wrong date format


 * Without accessdate


 * Full date of first edition

Deprecated usage

 * Author, year and title


 * Two authors

Incorrect usage

 * [ character in linked title


 * < character in linked title

Note
Note the extra full-stop when the last author ends with an initial, and there is no date: We don't know of a practical solution to this &mdash; unless there is a way to test the characters of a field?

}}

To do when breaking compatibility
··gracefool |&#9786; 02:11, 20 February 2006 (UTC)
 * Add "Edited by" before editor instead of making the user do it.