View source for Template:Infobox book/doc

{{Documentation subpage}}
{{Auto italic title}}
{{Generic template demo |_template={{BASEPAGENAME}}{{\sandbox}} |_display=italics
|name |image=Example-serious.jpg |alt |caption |author |audio_read_by |title_orig='''title_orig''' |orig_lang_code=ia |title_working='''title_working''' |translator |illustrator |cover_artist |country |language |series |edition |subject |genre |set_in |published |publisher |publisher2 |pub_date |english_pub_date |media_type |pages |awards |isbn |oclc |dewey |congress |preceded_by='''preceded_by''' |followed_by='''followed_by''' |native_wikisource=Wikisource:About |wikisource=Wikisource:About |notes
}}
<!-- EDIT TEMPLATE DOCUMENTATION BELOW THIS LINE -->

This template is used to present a consistently-formatted table for use in articles about [[book]]s.

== Usage ==

<pre style="overflow:auto;">
{{Infobox book
| italic title   = <!--(see above)-->
| name           = 
| image          = 
| image_size     = 
| alt            = 
| caption        = 
| author         = 
| audio_read_by  = 
| title_orig     = 
| orig_lang_code = 
| title_working  = 
| translator     = 
| illustrator    = 
| cover_artist   = 
| country        = 
| language       = 
| series         = 
| edition        = 
| subject        = 
| genre          = 
| set_in         = 
| published      = 
| publisher      = 
| publisher2     = 
| pub_date       = 
| english_pub_date = 
| printer        =
| media_type     = 
| pages		 = 
| cost           = 
| height         = 
| distributed_by = 
| awards         = 
| isbn           = 
| oclc           = 
| dewey          = 
| congress       = 
| preceded_by    = 
| followed_by    = 
| native_wikisource = 
| wikisource     = 
| notes          =
| exclude_cover  =  
}}</pre>

== Parameters ==

''Please see [[Wikipedia:WikiProject Books|WikiProject Books]] and/or [[Wikipedia:WikiProject Novels|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.
* [[Help:Link#Wikilinks|Wikilinks]] can be used in any of the infobox fields.

; name: Book name. If parameter is left blank, ''name'' will be inherited from page title.
; image: Image (prefer 1st edition – where permitted), use bare filename: <code><nowiki>Example.jpg</nowiki></code>
; image_size: Default size is 250px. Use a number to change image size
; border: Inserting <code>yes</code> 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 {{para|image}} uses the full image syntax (e.g. <code><nowiki>[[Image:Example.jpg]]</nowiki></code>); in this case add the border in {{para|image}} (e.g. <code><nowiki>[[Image:Example.jpg|border=yes]]</nowiki></code>)
; 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 [[audiobook]]s.
; title_orig: Original title, if not in English
; orig_lang_code: [[Template:ISO 639 name|ISO code]] of original language, required if using {{para|title_orig}}, {{para|native_wikisource}} or {{para|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
; country: Country of original publication
; language: Language of original book
; series: Series (if any)
; subject/subjects: (for non-fiction) ''See [[index term]] and [[library classification]]''
; genre/genres: (for fiction) ''See [[literary genre]]''
; set_in: can be both time and place as [[Setting (narrative)|setting]]. No need to create long lists.
; published: Using the following format: year (publisher) (language, when originally written in a foreign language); use {{tl|plainlist}} when there is more than one notable edition
; publisher/publisher2/pub_date/release_date/english_pub_date/english_release_date: [[:Category:Infobox book using deprecated parameters|Deprecated]] (use published instead)
; media_type: Print / On-line (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: "ISBN 1-234-56789-0" (10-digit) or "ISBN 978-1-234-56789-0" (13-digit). If the book has a [[International Standard Book Number|standard book number]] (9&nbsp;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. The last digit is a calculated check-digit which will be wrong. Same for removing "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 put "ISBN " in front of the number so that the ISBN is automatically linked to [[Special:BookSources]].
; 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 {{em|in series}}; will be italicised by template code (do not use to connect separate books chronologically)
; preceded_by_quotation_marks: Title of prior work {{em|in series}} if a [[Wikipedia:Manual of Style/Text formatting#When not to use italics|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 {{em|in series or sequel}}; will be italicised by template code (do not use to connect separate books chronologically)
; followed_by_quotation_marks: Title of subsequent work {{em|in series or sequel}} if a [[Wikipedia:Manual of Style/Text formatting#When not to use italics|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 {{para|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 {{para|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 {{para|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 [[:Category:Books with missing cover|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 {{para|exclude_cover|yes}}.

== Example ==

{{Infobox book{{\sandbox}}
| italic title = no <!--(lest the title of this template is italicised)-->
| name = Anne of Green Gables
| image = FirstPageGreenGables.gif
| caption = The front (first) page of the first edition
| alt = Cover
| 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 = 
| subject = 
| genre = [[Children's literature|Children's novel]]
| published = 1908 by [[L. C. Page & Co.]]
| 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
}}
<pre style="margin:3.0em 0 0;padding-right:0;overflow:auto;">
{{Infobox book
| name = Anne of Green Gables
| image = FirstPageGreenGables.gif
| caption = The front (first) page of the first edition
| alt = Cover
| 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 = 
| subject = 
| genre = [[Children's literature|Children's novel]]
| published = 1908 by [[L. C. Page & Co.]]
| 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
}}
</pre>

== TemplateData ==
{{TemplateDataHeader}}
<templatedata>{
	"description": "Consistently-formatted table for presenting information about books",
	"params": {
		"name": {
			"label": "Name",
			"type": "string",
			"required": false,
			"description": "Book name.",
			"default": "Pagename"
		},
		"author": {
			"label": "Author",
			"type": "string",
			"required": false,
			"description": "Author(s) of the book (should be link to their respective article if there is one)."
		},
		"language": {
			"label": "Language",
			"type": "string",
			"required": false,
			"description": "Language of (original) book. Full language name (not a language code)."
		},
		"country": {
			"label": "Country",
			"type": "string",
			"required": false,
			"description": "Country of (original) publication."
		},
		"genre": {
			"label": "Genre",
			"type": "string",
			"required": false,
			"description": ""
		},
		"published": {
			"label": "Published",
			"type": "string",
			"required": false,
			"description": "Using the following format: year (publisher) (language, when originally written in a foreign language)"
		},
		"publisher": {
			"label": "Publisher",
			"type": "string",
			"deprecated": "Add the publisher to the Published field instead.",
			"description": "Name of publisher."
		},
		"isbn": {
			"label": "ISBN",
			"type": "string",
			"description": "Format: \"ISBN 1-234-56789-0\" (prefer 1st edition)"
		},
                "exclude_cover": {
                        "label": "",
                        "type": "string",
                        "description": "\"yes\" if no image is present and adding this article to \"Category:Books with missing cover\" is not desired"
               }
	}
}</templatedata>

== Translated books ==
About how to handle translated books, see the [[Template talk:Infobox book/Archive 4#Translated books case study|Translated books case study]].

== COinS ==
{{UF-COinS}}

== Tracking ==
Instances without images cause the article to be added to [[:Category:Books with missing cover]].

== See also ==
* {{tl|Infobox book series}}
* [[Wikipedia:WikiProject Novels/InfoboxCode]]
* [[Wikipedia:WikiProject Novels/ArticleTemplate#Pattern template]]

<includeonly>{{#ifeq:{{SUBPAGENAME}}|sandbox | |
[[Category:Book infobox templates| ]]
[[Category:WikiProject Books| {{PAGENAME}}]]
[[Category:WikiProject Novels| {{PAGENAME}}]]
}}</includeonly>