Template:Infobox book/sandbox

Template documentation[view] [edit] [history] [purge]

This template is used to present a consistently formatted table for use in articles about books.

Usage

name

caption
Author	author
Audio read by	audio_read_by
Original title	title_orig
Working title	title_working
Translator	translator
Illustrator	illustrator
Cover artist	cover_artist
Language	language
Series	series
Release number	release_number
Subject	subject
Genre	genre
Set in	set_in
Published	published
Publisher	publisher, publisher2
Publication date	pub_date
Publication place	country
Published in English	english_pub_date
Media type	media_type
Pages	pages
Awards	awards
ISBN	123456789X
OCLC	oclc
Dewey Decimal	dewey
LC Class	congress
Preceded by	preceded_by
Followed by	followed_by
Original text	title_orig at Interlingua Wikisource
Translation	name at Wikisource
notes

{{Infobox book
| italic title      = <!--(see above)-->
| name              = 
| image             = 
| image_size        = 
| border            = 
| alt               = 
| caption           = 
| author            = 
| audio_read_by     = 
| title_orig        = 
| orig_lang_code    = 
| title_working     = 
| translator        = 
| illustrator       = 
| cover_artist      = 
| country           = 
| language          = 
| series            = 
| release_number    = 
| subject           = 
| genre             = 
| set_in            = 
| publisher         = 
| publisher2        = 
| pub_date          = 
| english_pub_date  = 
| published         = 
| media_type        = 
| pages             = 
| awards            = 
| isbn              = 
| isbn_note         = 
| oclc              = 
| dewey             = 
| congress          = 
| preceded_by       = <!-- for books in a series -->
| followed_by       = <!-- for books in a series -->
| native_wikisource = 
| wikisource        = 
| notes             = 
| exclude_cover     = 
| website           = 
}}

Parameters

Please see WikiProject Books and/or WikiProject Novels for standards on presenting names and other data.

• Parameters can be safely left blank. Note that you may include an image with no caption, but a caption will not be shown if there is no image.
• Wikilinks can be used in any of the infobox fields.

name

Book name or title. If parameter is left blank, name will be inherited from the Wikipedia page where this infobox is invoked.

image

Image (prefer 1st edition where permitted), use bare filename: Example.jpg
For a title page from a Commons PDF, specify the page and width in the syntax: [[File:Lissagaray - Histoire de la Commune de 1871, MS.djvu|page=9|220px]]

image_size

Uses image size set by user (default 220px). Use a number to override image size. However, this is discouraged per WP:THUMBSIZE.

border

Inserting yes here will result in a 1px grey border around the image, useful for instances where the image and the background will blend together (such as a book cover with a white background). If no border is necessary, this parameter should not be used. Note: does not apply if |image= uses the full image syntax (e.g. [[File:Example.jpg]]); in this case add the border in |image= (e.g. [[File:Example.jpg|border=yes]])

caption

Image caption (should describe the edition used)

alt

Image alternate text

editor/editors

Editor(s) only when they are the primary contributor, e.g. dictionaries, encyclopedias, anthologies

author/authors

Author(s)

audio_read_by

For audiobooks

title_orig

Original title, if not in English; recommended if using |native_external_url= or |native_wikisource=, unless |name= (or the article's title if |name= is not used) is the original non-English title

orig_lang_code

ISO 639 code of original language, required if using |title_orig=, |native_wikisource= or |native_external_url=

working_title

Working title, when different from published title

translator

Translator(s), if original not in English

illustrator

Illustrator (where used throughout and a major feature)

cover_artist

Cover artist, if any

country

Country of original publication

language

Language of original book. Do not link unless it is an unusual language.

series

Series (if any)

release_number

The "release number" of a book within the "series" (also would be called a "volume") – n.b. only relevant for an article where "series" is populated

subject/subjects

(for non-fiction) A word or phrase that captures the essence of the topic of the work. See index term and library classification. Should not generally be combined with genre/genres (i. e., cooking as the subject or cookbook as the genre, but not both).

genre/genres

See literary genre. Use {{hlist}} for sorting multiple entries. Should not generally be combined with subject/subjects (i. e., cooking as the subject or cookbook as the genre, but not both). Should be both specific (e. g., memoir rather than nonfiction) and reliably sourced.

set_in

can be both time and place as setting. No need to create long lists. Use approximate dates/places if it is not clearly specified in the text.

publisher

Publisher of primary publication (prefer 1st edition); also |publisher2= for additional publishers.

pub_date

Date published (1st edition)

english_pub_date

Date first published in English if 1st edition is in another language.

published

Alternate parameter, using the following composite format: year (publisher) (language, when originally written in a foreign language); use {{plainlist}} when there is more than one notable edition

Note: |published= is acceptable, but no longer preferred to |publisher= and |pub_date=, which have been restored to common usage. No consensus has yet been reached regarding the migration of infoboxes to a common format, and none should be "fixed" one way or the other en masse until such consensus is reached.

media_type

Print / Digital (then binding types etc., if relevant)

pages

Pages (prefer 1st edition, specify edition as needed)

award/awards

Awards(s) the book has won

isbn

(prefer ISBN of 1st edition). Format: "1-234-56789-0" (10-digit) or "978-1-234-56789-0" (13-digit). If the book has a standard book number (9 digits) add a "0" to the beginning of the number. Do not change a 10-digit to a 13-digit ISBN by prefixing a "978" by hand, because the last digit is a calculated check digit, which will be wrong. Similarly, do not remove "978-" from a 13-digit ISBN to make a 10-digit ISBN. If the book was published before the use of ISBN, do not include this parameter. If the 13-digit number you have does not start with "978", "979-10", or "979-11", then it is not an ISBN and should not be used in this parameter. Change spaces in the ISBN to hyphens. The rules for hyphenating an ISBN are complex (currently 29 pages). Do not add spaces or hyphens to an unformatted ISBN which are likely to be wrong if you are guessing. However the "978" prefix of a 13-digit ISBN is always separated by a hyphen and the check digit – the last character – is always separated by a hyphen. The last character of a 10-character ISBN may be an "X". In such case, use the uppercase "X" character, not any alternate character. Do not put "ISBN" in front of the number. ISBNs are checked for validity; articles with invalid ISBNs are placed in Category:Pages with ISBN errors and display a red error message.

isbn_note

May be used to add a note following the ISBN.

oclc

OCLC number (prefer 1st edition), use when book has no ISBN

dewey

Dewey Decimal Classification

congress

Library of Congress Classification (not to be confused with Library of Congress Control Number)

preceded_by

Title of prior book in series; will be italicised by template code (do not use to connect separate books chronologically)

preceded_by_quotation_marks

Title of prior work in series if a minor work; will be surrounded with quotation marks by template code (do not use to connect separate books chronologically)

followed_by

Title of subsequent book in a series or a sequel; will be italicised by template code (do not use to connect separate books chronologically)

followed_by_quotation_marks

Title of subsequent work in a series or a sequel if a minor work; will be surrounded with quotation marks by template code (do not use to connect separate books chronologically)

native_wikisource

Page name of original text at a foreign language Wikisource (if applicable); use |orig_lang_code= to specify which Wikisource. Tracked in Category:Articles that link to foreign-language Wikisources

native_external_url

URL to a site hosting the original text when in a foreign language, and in the public domain but not yet on Wikisource. Non-commercial, open and accessible sites should be used in preference, sites which rip the text from other sites should be avoided, and illegal content is never to be linked to

native_external_host

The name of the website linked to by |native_external_url=, e.g. Project Gutenberg, Internet Archive. Should be wikilinked if possible

wikisource

Title of work if in the public domain and hosted at English Wikisource:. Tracked in Category:Articles that link to Wikisource

external_url

URL to a site hosting the text in English (whether the original or a translation), when in the public domain but not yet on Wikisource. Non-commercial, open and accessible sites should be used in preference, sites which rip the text from other sites should be avoided, and illegal content is never to be linked to

external_host

The name of the website linked to by |external_url=, e.g. Project Gutenberg, Internet Archive. Should be wikilinked if possible

exclude_cover

This template will place articles with this infobox where no image has been specified into the category Books with missing cover; where this is not desired, e.g because the cover is shown elsewhere in the article, this parameter should be set to |exclude_cover=yes.

website

for the publisher's or author's website about the book.

Example

Anne of Green Gables

Title page of the first edition
Author	Lucy Maud Montgomery
Illustrator	M. A. and W. A. J. Claus
Language	English
Genre	Children's novel
Publisher	L. C. Page & Co.
Publication date	1908
Publication place	United States
Pages	429 (first edition)
OCLC	367111
LC Class	PR6025.O45 A53
Followed by	Anne of Avonlea
Text	Anne of Green Gables at Wikisource

{{Infobox book
| name           = Anne of Green Gables
| image          = Lucy Maud Montgomery, Anne of Green Gables, 1908, title page.jpg
| caption        = Title page of the first edition
| alt            = Title page
| author         = [[Lucy Maud Montgomery]]
| title_orig     = 
| working_title = 
| translator     = 
| illustrator    = M. A. and W. A. J. Claus
| cover_artist   = 
| country        = United States
| language       = English
| series         = 
| release_number = 
| subject        = 
| genre          = [[Children's literature|Children's novel]]
| publisher      = [[L. C. Page & Co.]]
| pub_date       = 1908
| pages          = 429 ''(first edition)''
| awards         = 
| isbn           = <!-- N/A -->
| oclc           = 367111
| congress       = PR6025.O45 A53
| preceded_by    = 
| followed_by    = [[Anne of Avonlea]]
| wikisource     = Anne of Green Gables
}}

TemplateData

TemplateData documentation used by VisualEditor and other tools

See a monthly parameter usage report for Template:Infobox book in articles based on its TemplateData. TemplateData for Infobox book Consistently-formatted table for presenting information about books Template parameters[Edit template data] This template has custom formatting. Parameter Description Type Status Name name Book title Default Pagename String optional Image image Image (prefer 1st edition where permitted). Use bare filename. File suggested Author author authors Author(s) of the book (should be link to their respective article if there is one). String suggested Language language Language of (original) book. Full language name (not a language code). Example English String optional Country country Country of (original) publication. String optional Genre(s) genre genres The book's genre Example Science fiction String optional Published published Using the following format: year (publisher) (language, when originally written in a foreign language) String optional Publisher publisher Name of publisher. String optional ISBN isbn ISBN Format: "ISBN 1-234-56789-0" (prefer 1st edition) Example "1-234-56789-0" (if 10-digit) or "978-1-234-56789-0" (if 13-digit) String suggested exclude cover? exclude_cover "yes" if no image is present and adding this article to "Category:Books with missing cover" is not desired Example yes String optional Series series Series the book is part of Example [[The Federalist Papers]] String optional Image size image_size no description Example 200 px String optional Image caption caption image_caption a caption for the image used Content optional Type of media media_type no description Example [[Newspaper]] String optional Date of publication pub_date Date the book or work was published Example December 21, 1787 Date suggested Preceded by preceded_by The previous installment in the series/from the author Example [[Federalist No. 4]] String optional Followed by followed_by The next installment in the series/from the author Example [[Federalist No. 6]] String optional Italicize title? italic title If set to "no", the title is never italicized. If set to "force", the title is always italicized. If not specified, the title should usually be italicized automatically. Suggested values no force Example no String optional infoboxwidth infoboxwidth no description Unknown optional width width no description Unknown optional Editor(s) editor editors Editor or editors of the book. Use this template if they are a PRIMARY contributor (eg for dictionaries or encyclopedias). Example John Doe Content optional Audio read by audio_read_by The person who read the audio, if this is an audiobook. Example Jane Smith Content optional Original title title_orig The original title of the book, if it was not in English. Example Exemple d'une Livre Content optional Working title title_working The working title of the book, if this was different from the title the book was ultimately published as. Example Example Working Book Title Content optional Translator(s) translator translators The person or people who translated the book to English, if it was not originally in English. Example Joe Bloggs Content optional Illustrator(s) illustrator illustrators The person or people who illustrated this book, if applicable. Example John Doe Content optional Cover artist cover_artist The person who made the cover art, if applicable. Example Jane Smith Content optional Release number release_number Ordinal index of the book, if it was released within a series String optional Subjects subject subjects Topics discussed by the book. For non-fiction books only. Example chemistry Content optional Set in set_in The time and/or place where the book is set in, if it's a work of fiction Example 21st-century Earth Content optional Second publisher publisher2 An additional publisher that published this book (not the primary publisher). Example Penguin Random House Content optional release_date release_date no description Unknown optional english_pub_date english_pub_date no description Unknown optional english_release_date english_release_date no description Unknown optional pages pages no description Unknown optional awards awards no description Unknown optional award award no description Unknown optional isbn_note isbn_note ISBN_note no description Unknown optional dewey dewey no description Unknown optional congress congress no description Unknown optional last last no description Unknown optional first first no description Unknown optional location location no description Unknown optional oclc oclc no description Unknown optional alt alt no description Unknown optional border border no description Unknown optional orig_lang_code orig_lang_code no description Unknown optional preceded_by_quotation_marks preceded_by_quotation_marks no description Unknown optional followed_by_quotation_marks followed_by_quotation_marks no description Unknown optional native_wikisource native_wikisource no description Unknown optional native_external_url native_external_url no description Unknown optional native_external_host native_external_host no description Unknown optional wikisource wikisource no description Unknown optional external_url external_url no description Unknown optional external_host external_host no description Unknown optional website website no description Unknown optional homepage homepage no description Unknown optional URL URL no description Unknown optional notes notes no description Unknown optional note note no description Unknown optional nocat_wdimage nocat_wdimage no description Unknown optional module module no description Unknown optional

Translated books

About how to handle translated books, see the Translated books case study.

COinS

This template produces COinS metadata; see COinS in Wikipedia for background information.

Tracking categories

• Category:Articles that link to Wikisource (693)
• Category:Articles that link to foreign-language Wikisources (204)
• Category:Books with missing cover (3,861) – instances without images
• Category:Pages using infobox book with unknown parameters (96)
• Category:No local image but image on Wikidata (8,839) – Used by Template:Wikidata image to track articles where an infobox has no image but Wikidata has an image name. To exclude articles from this category, add an image or |nocat_wdimage=yes to the infobox.

See also

• {{Infobox book series}}
• {{Infobox novella}}
• {{Infobox short story}}
• Wikipedia:WikiProject Novels/InfoboxCode
• Wikipedia:WikiProject Novels/ArticleTemplate#Pattern template

The above documentation is transcluded from Template:Infobox book/doc. (edit | history)
Editors can experiment in this template's sandbox (edit | diff) and testcases (edit) pages.
Add categories to the /doc subpage. Subpages of this template.