Difference between revisions of "Template:Infobox book/doc"

From Wikispooks
Jump to navigation Jump to search
m (1 revision: infobox templates for inclusion)
 
m (Text replacement - "image_size" to "image_width")
 
Line 10: Line 10:
 
| name              = ''name''
 
| name              = ''name''
 
| image            = Example.jpg
 
| image            = Example.jpg
| image_size       =  
+
| image_width       =  
 
| border            =  
 
| border            =  
 
| caption          = ''caption''
 
| caption          = ''caption''
Line 79: Line 79:
 
; name: Book name. If parameter is left blank, ''name'' will be inherited from page title.
 
; 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: Image (prefer 1st edition – where permitted), use bare filename: <code><nowiki>Example.jpg</nowiki></code>
; image_size: Default size is 200px. Use a number to change image size
+
; image_width: Default size is 200px. 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>)
 
; 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)
 
; caption: Image caption (should describe the edition used)

Latest revision as of 06:13, 26 October 2014

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

Usage

name
Authorauthor
Original title[title_orig] error: {{lang}}: text has italic markup (help)
Working titletitle_working
Translatortranslator
Illustratorillustrator
Cover artistcover_artist
Countrycountry
Languagelanguage
Seriesseries
Subjectsubject
Genregenre
Publishedpublished
Media typemedia_type
Pagespages
Awardsawards
ISBNisbn
OCLCoclc
Dewey Decimaldewey
LC Classcongress
Preceded bypreceded_by
Followed byfollowed_by
Original text
title_orig at Interlingua Wikisource
Translationname at Wikisource
{{Infobox book
<!-- |italic title  = (see above) -->
| name              = 
| image             = 
| caption           = 
| alt               = 
| author            = 
| title_orig        = 
| orig_lang_code    = 
| title_working     = 
| translator        = 
| illustrator       = 
| cover_artist      = 
| country           = 
| language          = 
| series            = 
| subject           = 
| genre             = 
| published         = 
| media_type        = 
| pages             = 
| awards            = 
| isbn              = 
| oclc              = 
| dewey             = 
| congress          = 
| preceded_by       = 
| followed_by       = 
| wikisource        = 
}}

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. If parameter is left blank, name will be inherited from page title.
image
Image (prefer 1st edition – where permitted), use bare filename: Example.jpg
image_width
Default size is 200px. Use a number to change image size
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. [[Image:Example.jpg]]); in this case add the border in |image= (e.g. [[Image: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)
title_orig
Original title, if not in English
orig_lang_code
ISO 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
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
published
Using the following format: year (publisher) (language, when originally written in a foreign language); use {{plainlist}} when there is more than one notable edition
publisher/publisher2/pub_date/english_pub_date
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 123-4-567-89012-3" (13-digit). If the book was published before the use of ISBN, do not include this parameter.
oclc
OCLC number (prefer 1st edition), use when book has no ISBN
dewey
Dewey Decimal System 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 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 in series or 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

Example

Anne of Green Gables
Cover
First page of Anne of Green Gables.
AuthorLucy Maud Montgomery
IllustratorM. A. and W. A. J. Claus
CountryUnited States
LanguageEnglish
GenreChildren's novel
Published1908 (L. C. Page & Co.)
Media typePrint (hardcover)
Pages429 pp (first edition)
ISBNN/A
OCLC367111
LC ClassPR6025.O45 A53
Followed byAnne of Avonlea
TextAnne of Green Gables at Wikisource
{{Infobox book
| name           = Anne of Green Gables
| image          = FirstPageGreenGables.gif
| caption        = First page of ''Anne of Green Gables''.
| 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 ([[L. C. Page & Co.]])
| media_type     = Print ([[hardcover]])
| pages          = 429 pp ''(first edition)''
| awards         = 
| isbn           = N/A
| oclc           = 367111
| congress       = PR6025.O45 A53
| preceded_by    = 
| followed_by    = [[Anne of Avonlea]]
| wikisource     = Anne of Green Gables
}}

Template data

This is the TemplateData documentation for this template used by VisualEditor and other tools; see the monthly parameter usage report for this template.

TemplateData for Infobox book

<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": "number", "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)" } } }</templatedata>

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

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

See also