Misplaced Pages

Template:Infobox book

Article snapshot taken from Wikipedia with creative commons attribution-sharealike license. Give it a read and then ask your questions in the chat. We can research this topic together.

This is an old revision of this page, as edited by DePiep (talk | contribs) at 10:28, 18 November 2014 (Undid revision 634322125 by Plastikspork (talk) Not discussed; see User talk:Plastikspork#Infobox book merge). The present address (URL) is a permanent link to this revision, which may differ significantly from the current revision.

Revision as of 10:28, 18 November 2014 by DePiep (talk | contribs) (Undid revision 634322125 by Plastikspork (talk) Not discussed; see User talk:Plastikspork#Infobox book merge)(diff) ← Previous revision | Latest revision (diff) | Newer revision → (diff) Template documentation[view] [edit] [history] [purge]
WarningThis template is used on approximately 56,000 pages and changes may be widely noticed. Test changes in the template's /sandbox or /testcases subpages, or in your own user subpage. Consider discussing changes on the talk page before implementing them.
This infobox should italicize the article title automatically. If this is not required, add |italic_title=no to the list of parameters. If this is required but the title is not being italicized, try |italic_title=force.
This template uses Lua:

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

Usage

name
altcaption
Authorauthor
Audio read byaudio_read_by
Original title Error: {{Lang}}: text has italic markup (help)
Working titletitle_working
Translatortranslator
Illustratorillustrator
Cover artistcover_artist
Countrycountry
Languagelanguage
Seriesseries
Subjectsubject
Genregenre
Set inset_in
Publishedpublished
Publisherpublisher, publisher2
Publication datepub_date
Published in Englishenglish_pub_date
Media typemedia_type
Pagespages
Awardsawards
ISBN123456789X
OCLCoclc
Dewey Decimaldewey
LC Classcongress
Preceded bypreceded_by
Followed byfollowed_by
Original texttitle_orig at Interlingua Wikisource
Translationname 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 Misplaced Pages 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: ]
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. ]); in this case add the border in |image= (e.g. ])
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 pageTitle page of the first edition
AuthorLucy Maud Montgomery
IllustratorM. A. and W. A. J. Claus
CountryUnited States
LanguageEnglish
GenreChildren's novel
PublisherL. C. Page & Co.
Publication date1908
Pages429 (first edition)
OCLC367111
LC ClassPR6025.O45 A53
Followed byAnne of Avonlea
TextAnne 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         = ]
| 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          = ]
| publisher      = ]
| pub_date       = 1908
| pages          = 429 ''(first edition)''
| awards         = 
| isbn           = <!-- N/A -->
| oclc           = 367111
| congress       = PR6025.O45 A53
| preceded_by    = 
| followed_by    = ]
| 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

This template has custom formatting.

ParameterDescriptionTypeStatus
Namename

Book title

Default
Pagename
Stringoptional
Imageimage

Image (prefer 1st edition where permitted). Use bare filename.

Filesuggested
Authorauthor authors

Author(s) of the book (should be link to their respective article if there is one).

Stringsuggested
Languagelanguage

Language of (original) book. Full language name (not a language code).

Example
English
Stringoptional
Countrycountry

Country of (original) publication.

Stringoptional
Genre(s)genre genres

The book's genre

Example
Science fiction
Stringoptional
Publishedpublished

Using the following format: year (publisher) (language, when originally written in a foreign language)

Stringoptional
Publisherpublisher

Name of publisher.

Stringoptional
ISBNisbn 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)
Stringsuggested
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
Stringoptional
Seriesseries

Series the book is part of

Example
]
Stringoptional
Image sizeimage_size

no description

Example
200 px
Stringoptional
Image captioncaption image_caption

a caption for the image used

Contentoptional
Type of mediamedia_type

no description

Example
]
Stringoptional
Date of publicationpub_date

Date the book or work was published

Example
December 21, 1787
Datesuggested
Preceded bypreceded_by

The previous installment in the series/from the author

Example
]
Stringoptional
Followed byfollowed_by

The next installment in the series/from the author

Example
]
Stringoptional
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
Stringoptional
infoboxwidthinfoboxwidth

no description

Unknownoptional
widthwidth

no description

Unknownoptional
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
Contentoptional
Audio read byaudio_read_by

The person who read the audio, if this is an audiobook.

Example
Jane Smith
Contentoptional
Original titletitle_orig

The original title of the book, if it was not in English.

Example
Exemple d'une Livre
Contentoptional
Working titletitle_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
Contentoptional
Translator(s)translator translators

The person or people who translated the book to English, if it was not originally in English.

Example
Joe Bloggs
Contentoptional
Illustrator(s)illustrator illustrators

The person or people who illustrated this book, if applicable.

Example
John Doe
Contentoptional
Cover artistcover_artist

The person who made the cover art, if applicable.

Example
Jane Smith
Contentoptional
Release numberrelease_number

Ordinal index of the book, if it was released within a series

Stringoptional
Subjectssubject subjects

Topics discussed by the book. For non-fiction books only.

Example
chemistry
Contentoptional
Set inset_in

The time and/or place where the book is set in, if it's a work of fiction

Example
21st-century Earth
Contentoptional
Second publisherpublisher2

An additional publisher that published this book (not the primary publisher).

Example
Penguin Random House
Contentoptional
release_daterelease_date

no description

Unknownoptional
english_pub_dateenglish_pub_date

no description

Unknownoptional
english_release_dateenglish_release_date

no description

Unknownoptional
pagespages

no description

Unknownoptional
awardsawards

no description

Unknownoptional
awardaward

no description

Unknownoptional
isbn_noteisbn_note ISBN_note

no description

Unknownoptional
deweydewey

no description

Unknownoptional
congresscongress

no description

Unknownoptional
lastlast

no description

Unknownoptional
firstfirst

no description

Unknownoptional
locationlocation

no description

Unknownoptional
oclcoclc

no description

Unknownoptional
altalt

no description

Unknownoptional
borderborder

no description

Unknownoptional
orig_lang_codeorig_lang_code

no description

Unknownoptional
preceded_by_quotation_markspreceded_by_quotation_marks

no description

Unknownoptional
followed_by_quotation_marksfollowed_by_quotation_marks

no description

Unknownoptional
native_wikisourcenative_wikisource

no description

Unknownoptional
native_external_urlnative_external_url

no description

Unknownoptional
native_external_hostnative_external_host

no description

Unknownoptional
wikisourcewikisource

no description

Unknownoptional
external_urlexternal_url

no description

Unknownoptional
external_hostexternal_host

no description

Unknownoptional
websitewebsite

no description

Unknownoptional
homepagehomepage

no description

Unknownoptional
URLURL

no description

Unknownoptional
notesnotes

no description

Unknownoptional
notenote

no description

Unknownoptional
nocat_wdimagenocat_wdimage

no description

Unknownoptional
modulemodule

no description

Unknownoptional

Translated books

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

COinS

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

Tracking categories

See also

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. Categories: