More languages
More actions
mNo edit summary |
BE Comrade (talk | contribs) m (replaced with a bad but working example) |
||
(5 intermediate revisions by 2 users not shown) | |||
Line 1: | Line 1: | ||
< | <onlyinclude>{{Infobox | ||
|bodyclass = vcard | |bodyclass = vcard | ||
|bodystyle = {{#if:{{{infoboxwidth|{{{width|}}}}}} |width:{{{infoboxwidth|{{{width}}}}}} }} | |bodystyle = {{#if:{{{infoboxwidth|{{{width|}}}}}} |width:{{{infoboxwidth|{{{width}}}}}} }} | ||
<!---------------Title-----------------> | <!---------------Title----------------->|titlestyle = font-size:125%; font-style:italic; padding-bottom:0.2em<!--(so title doesn't touch border)-->; | ||
|titlestyle = font-size:125%; font-style:italic; padding-bottom:0.2em<!--(so title doesn't touch border)-->; | |||
|title = {{#if:{{{name|}}}{{{caption|{{{image_caption|}}}}}}{{{editors|{{{editor|}}}}}}{{{authors|{{{author|}}}}}}{{{audio_read_by|}}}{{{title_orig|}}}{{{title_working|}}}{{{translators|{{{translator|}}}}}}{{{illustrators|{{{illustrator|}}}}}}{{{cover_artist|}}}{{{language|}}}{{{series|}}}{{{release_number|}}}{{{subjects|{{{subject|}}}}}}{{{genres|{{{genre|}}}}}}{{{set_in|}}}{{{publication|}}}{{{media_type|}}}{{{pages|}}}{{{awards|{{{award|}}}}}}{{{dewey|}}}{{{congress|}}}| }}<!-- hack for ref ordering | |title = {{#if:{{{name|}}}{{{caption|{{{image_caption|}}}}}}{{{editors|{{{editor|}}}}}}{{{authors|{{{author|}}}}}}{{{audio_read_by|}}}{{{title_orig|}}}{{{title_working|}}}{{{translators|{{{translator|}}}}}}{{{illustrators|{{{illustrator|}}}}}}{{{cover_artist|}}}{{{language|}}}{{{series|}}}{{{release_number|}}}{{{subjects|{{{subject|}}}}}}{{{genres|{{{genre|}}}}}}{{{set_in|}}}{{{publication|}}}{{{media_type|}}}{{{pages|}}}{{{awards|{{{award|}}}}}}{{{dewey|}}}{{{congress|}}}| }}<!-- hack for ref ordering | ||
-->{{{name|{{PAGENAMEBASE}}}}} <!-- | -->{{{name|{{PAGENAMEBASE}}}}} <!-- | ||
<!---------------Image-----------------> | <!---------------Image-----------------> | ||
| imagestyle = {{#if:{{{image|}}}||display:none}} | | imagestyle = {{#if:{{{image|}}}||display:none}} | ||
| image = {{#if:{{{image|}}} <!-- | | image = {{#if:{{{image|}}} <!-- | ||
then:-->| {{#invoke:InfoboxImage|InfoboxImage |image={{{image|}}} |size={{{image_size|}}} |sizedefault=frameless |upright=1 |alt={{{alt|}}} |title={{{alt|}}} |border={{{border|}}} |suppressplaceholder=yes}}<!-- | then:-->| {{#invoke:InfoboxImage|InfoboxImage |image={{{image|}}} |size={{{image_size|}}} |sizedefault=frameless |upright=1 |alt={{{alt|}}} |title={{{alt|}}} |border={{{border|}}} |suppressplaceholder=yes}}<!-- | ||
else:-->| {{#ifeq:{{ | else:-->| {{#ifeq:{{#ifeq: {{lc:{{{exclude_cover|no}}}}} | yes | yes | no }}|yes | |{{main other|[[Category:Books with missing cover]]}} }} | ||
}} | }} | ||
| caption = {{{caption|{{{image_caption|}}}}}} | | caption = {{{caption|{{{image_caption|}}}}}} | ||
Line 47: | Line 38: | ||
| data8 = {{{cover_artist|}}} | | data8 = {{{cover_artist|}}} | ||
| | | label9 = Language | ||
| | | data9 = {{{language|}}} | ||
| | | label10 = Series | ||
| | | data10 = {{{series|}}} | ||
| | | label11 = {{longitem|Release number}} | ||
| | | data11 = {{{release_number|}}} | ||
| | | label12 = Subject{{#if:{{{subjects|}}}|s}} | ||
| | | data12 = {{{subjects|{{{subject|}}}}}} | ||
| | | label13 = Genre{{#if:{{{genres|}}}|s}} | ||
| | | data13 = {{{genres|{{{genre|}}}}}} | ||
| | | label14 = Set in | ||
| | | data14 = {{{set_in|}}} | ||
| | | label15 = Publication | ||
| | | data15 = {{{publication|}}} | ||
| | | label16 = Media type | ||
| | | data16 = {{{media_type|}}} | ||
| | | label17 = Pages | ||
| | | data17 = {{{pages|}}} | ||
| | | label18 = Award{{#if:{{{awards|}}}|s}} | ||
| | | data18 = {{{awards|{{{award|}}}}}} | ||
| | | label19 = [[ISBN (identifier)|<abbr title='International Standard Book Number'>ISBN</abbr>]] | ||
| | | data19 = {{{isbn|}}} | ||
| | | label20 = [[OCLC (identifier)|<abbr title='Online Computer Library Center'>OCLC<abbr/> Number]] | ||
| | | data20 = {{#if:{{{oclc|}}} |[https://www.worldcat.org/oclc/{{urlencode:{{{oclc}}}}} {{{oclc}}}]}} | ||
| | | label21 = [[Dewey Decimal Classification|Dewey Decimal]] | ||
| | | data21 = {{{dewey|}}} | ||
| | | label22 = [[LCC (identifier)|<abbr title='Library of Congress Classification'>LC Class</abbr>]] | ||
| | | data22 = {{{congress|}}} | ||
| | | label23 = Preceded by | ||
| | | data23 = {{#if:{{{preceded_by|}}} |''{{{preceded_by|}}} '' | ||
| {{#if:{{{preceded_by_quotation_marks|}}} |"{{{preceded_by_quotation_marks|}}}"}} | | {{#if:{{{preceded_by_quotation_marks|}}} |"{{{preceded_by_quotation_marks|}}}"}} | ||
}} | }} | ||
| | | label24 = Followed by | ||
| | | data24 = {{#if:{{{followed_by|}}} |''{{{followed_by|}}} '' | ||
| {{#if:{{{followed_by_quotation_marks|}}} |"{{{followed_by_quotation_marks|}}}"}} | | {{#if:{{{followed_by_quotation_marks|}}} |"{{{followed_by_quotation_marks|}}}"}} | ||
}} | }} | ||
| | | label25 = Website(s) | ||
| | | data25 = {{{websites|}}} | ||
| data60 = {{{module|}}} | | data60 = {{{module|}}} | ||
Line 106: | Line 97: | ||
| belowstyle = border-top:#aaa 1px solid;font-size:90%; | | belowstyle = border-top:#aaa 1px solid;font-size:90%; | ||
| below = {{{notes|{{{note|}}}}}} | | below = {{{notes|{{{note|}}}}}} | ||
}}{{#invoke:Check for unknown parameters|check|unknown={{main other|[[Category:Pages using infobox book with unknown parameters|_VALUE_{{PAGENAME}}]]}}|preview=Page using [[Template:Infobox book]] with unknown parameter "_VALUE_"|ignoreblank=y| alt | audio_read_by | author | authors | award | awards | border | caption | congress | cover_artist | dewey | editor | editors | exclude_cover | followed_by | followed_by_quotation_marks | genre | genres | illustrator | illustrators | image | image_caption | image_size | infoboxwidth | isbn | language | media_type | module | name | nocat_wdimage | note | notes | oclc | orig_lang_code | pages | preceded_by | preceded_by_quotation_marks | publication | release_number | series | set_in | subject | subjects | title_orig | title_working | translator | translators | website | width | }} | ||
}}</ | {{#invoke:Check for unknown parameters|check|unknown={{main other|[[Category:Pages using infobox book with unknown parameters|_VALUE_{{PAGENAME}}]]}}|preview=Page using [[Template:Infobox book]] with unknown parameter "_VALUE_"|ignoreblank=y| alt | audio_read_by | author | authors | award | awards | border | caption | congress | cover_artist | dewey | editor | editors | exclude_cover | followed_by | followed_by_quotation_marks | genre | genres | illustrator | illustrators | image | image_caption | image_size | infoboxwidth | isbn | language | media_type | module | name | nocat_wdimage | note | notes | oclc | orig_lang_code | pages | preceded_by | preceded_by_quotation_marks | publication | release_number | series | set_in | subject | subjects | title_orig | title_working | translator | translators | website | width | ||
}}</onlyinclude> | |||
<noinclude> | <noinclude> | ||
Line 154: | Line 146: | ||
; image: Image (prefer 1st edition where permitted), use bare filename: <code><nowiki>Example.jpg</nowiki></code><br>For a title page from a [[:Commons:|Commons]] PDF, specify the page and width in [[WP:EIS|the syntax]]: <code><nowiki>[[File:Lissagaray - Histoire de la Commune de 1871, MS.djvu|page=9|220px]]</nowiki></code> | ; image: Image (prefer 1st edition where permitted), use bare filename: <code><nowiki>Example.jpg</nowiki></code><br>For a title page from a [[:Commons:|Commons]] PDF, specify the page and width in [[WP:EIS|the syntax]]: <code><nowiki>[[File:Lissagaray - Histoire de la Commune de 1871, MS.djvu|page=9|220px]]</nowiki></code> | ||
; image_size: Uses image size set by user (default 220px). Use a number to override image size. However, this is discouraged per [[WP:THUMBSIZE]]. | ; 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 <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 {{ | ; 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 {{code|image}} uses the full image syntax (e.g. <code><nowiki>[[File:Example.jpg]]</nowiki></code>); in this case add the border in {{code|image}} (e.g. <code><nowiki>[[File:Example.jpg|border=yes]]</nowiki></code>) | ||
; author/authors: Author(s) | ; author/authors: Author(s) | ||
; audio_read_by: For [[audiobook]]s. | ; audio_read_by: For [[audiobook]]s. | ||
Line 170: | Line 162: | ||
; media_type: Print / Digital (then binding types etc., if relevant) | ; media_type: Print / Digital (then binding types etc., if relevant) | ||
; award/awards: Awards(s) the book has won | ; 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 [[International Standard Book Number|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 | ; 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 [[International Standard Book Number|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. | ||
; oclc: OCLC number (prefer 1st edition), use when book has no ISBN | ; oclc: OCLC number (prefer 1st edition), use when book has no ISBN | ||
; preceded_by_quotation_marks: Title of prior work | ; preceded_by_quotation_marks: Title of prior work ''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 | ; 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 | ; followed_by_quotation_marks: Title of subsequent work ''in a series or a 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) | ||
; 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 {{ | ; 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 {{code|exclude_cover|yes}}. | ||
== Example == | == Example == | ||
{{Infobox book | |||
{{Infobox book | | image = 71ZrrM0-AUL. AC UF1000,1000 QL80 .jpg | ||
| author = [[Xi Jinping]] | |||
| image | | isbn = 9787119105550 | ||
| | | language = [[Mandarin|Chinese]] | ||
| name = '''Up and Out of Poverty''' | |||
| image_size = | |||
| | |||
| language | |||
| | |||
| | |||
}} | }} | ||
<pre style="margin:3.0em 0 0;padding-right:0;overflow:auto;"> | <pre style="margin:3.0em 0 0;padding-right:0;overflow:auto;"> | ||
{{Infobox book | {{Infobox book | ||
| image = 71ZrrM0-AUL. AC UF1000,1000 QL80 .jpg | |||
| image | | author = [[Xi Jinping]] | ||
| | | isbn = 9787119105550 | ||
| language = [[Mandarin|Chinese]] | |||
| name = '''Up and Out of Poverty''' | |||
| | | image_size = | ||
| language | |||
| | |||
| | |||
}} | }} | ||
</pre> | </pre> |
Latest revision as of 21:32, 3 September 2024
This template is used to present a consistently-formatted table for use in articles about books.
Usage
{{Infobox book | name = | image = | image_size = | border = | alt = | caption = | author = | audio_read_by = | title_orig = | orig_lang_code = | title_working = | translator = | illustrator = | cover_artist = | language = | series = | release_number = | subject = | genre = | set_in = | publication = | media_type = | pages = | awards = | isbn = | oclc = | dewey = | congress = | preceded_by = <!-- for books in a series --> | followed_by = <!-- for books in a series --> | wikisource = | notes = | exclude_cover = | website = }}
Parameters
- 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 ifimage
uses the full image syntax (e.g.[[File:Example.jpg]]
); in this case add the border inimage
(e.g.[[File:Example.jpg|border=yes]]
) - author/authors
- Author(s)
- audio_read_by
- For audiobooks.
- title_orig
- Original title, if not in English.
- orig_lang_code
- ISO 639 code of original language.
- 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
- 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) See index term and library classification
- genre/genres
- (for fiction) See literary genre. Use {{hlist}} for sorting multiple entries.
- 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.
- media_type
- Print / Digital (then binding types etc., if relevant)
- 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.
- oclc
- OCLC number (prefer 1st edition), use when book has no ISBN
- 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)
- 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
.
Example
Author | Xi Jinping |
---|---|
Language | Chinese |
ISBN | 9787119105550 |
{{Infobox book | image = 71ZrrM0-AUL. AC UF1000,1000 QL80 .jpg | author = [[Xi Jinping]] | isbn = 9787119105550 | language = [[Mandarin|Chinese]] | name = '''Up and Out of Poverty''' | image_size = }}
TemplateData
Consistently-formatted table for presenting information about books
Parameter | Description | Type | Status | |
---|---|---|---|---|
Name | name | Book name or title. If parameter is left blank, ''name'' will be inherited from the [[Wikipedia:Article titles|Wikipedia page]] where this infobox is invoked.
| String | optional |
Image | image | Image (prefer 1st edition where permitted). Use bare filename. | File | suggested |
Alternate image text | alt | Alternate text to display if the image cannot be rendered. | String | optional |
Author | author | Author(s) of the book (should be link to their respective article if there is one). | String | suggested |
Language | language | Language of (original) book.
| String | optional |
Genre | genre | The book's genre
| String | optional |
Publication | publication | Information about the publishment of the book. The following format: year (publisher) (language, when originally written in a foreign language)
| Content | optional |
ISBN | isbn | Format: "ISBN 1-234-56789-0" (prefer 1st edition) | 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
| String | optional |
Series | series | Series the book is part of
| String | optional |
Image size | image_size | no description
| String | optional |
Image caption | caption | a caption for the image used | Content | optional |
Type of media | media_type | no description
| String | optional |
Preceded by | preceded_by | The previous installment in the series/from the author
| String | optional |
Followed by | followed_by | The next installment in the series/from the author
| String | optional |
infoboxwidth | infoboxwidth | no description | Unknown | optional |
width | width | no description | Unknown | optional |
image_caption | image_caption | no description | Unknown | optional |
Editor(s) | editors | Editor(s) '''only when they are the primary contributor''', e.g. dictionaries, encyclopedias, anthologies.
| Content | optional |
editor | editor | no description | Unknown | optional |
authors | authors | no description | Unknown | optional |
audio_read_by | audio_read_by | no description | Unknown | optional |
title_orig | title_orig | no description | Unknown | optional |
title_working | title_working | no description | Unknown | optional |
translators | translators | no description | Unknown | optional |
translator | translator | no description | Unknown | optional |
illustrators | illustrators | no description | Unknown | optional |
illustrator | illustrator | no description | Unknown | optional |
cover_artist | cover_artist | no description | Unknown | optional |
release_number | release_number | no description | Unknown | optional |
subjects | subjects | no description | Unknown | optional |
subject | subject | no description | Unknown | optional |
genres | genres | no description | Unknown | optional |
set_in | set_in | no description | Unknown | optional |
Pages | pages | Amount of pages in the book.
| Number | optional |
awards | awards | no description | Unknown | optional |
award | award | no description | Unknown | optional |
[[Dewey Decimal Classification]] | dewey | no description | String | optional |
Library of Congress Classification | congress | Library of Congress Classification ('''not''' to be confused with Library of Congress Control Number) | String | optional |
oclc | oclc | 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 |
Website(s) | websites | The publisher's or author's websites about the book.
| String | optional |
notes | notes | no description | Unknown | optional |
note | note | no description | Unknown | optional |
nocat_wdimage | nocat_wdimage | no description | Unknown | optional |