Difference between revisions of "Template:Book"

From The Coppermind
Jump to navigation Jump to search
m
(+collaborators)
(30 intermediate revisions by 5 users not shown)
Line 1: Line 1:
 
{{infobox
 
{{infobox
  +
|id=book
 
|title=<!--
 
|title=<!--
   
-->{{#if:{{{prequel|}}}|<span style="float: left;">[[{{{prev|{{{prequel}}}|}}}|<]]</span>|}}<!--
+
-->{{#if:{{{prequel|}}}|<span style="float: left; ">[[{{{prev|{{{prequel}}}|}}}|<]]</span>}}<!--
 
-->{{{title|{{PAGENAME}}|}}}<!--
 
-->{{{title|{{PAGENAME}}|}}}<!--
-->{{#if:{{{sequel|}}}|<span style="float: right;">[[{{{next|{{{sequel}}}|}}}|>]]</span>}}<!--
+
-->{{#if:{{{sequel|}}} |<span style="float: right;">[[{{{next|{{{sequel}}}| }}}|>]]</span>}}<!--
   
-->|1=<!--
+
-->|1=
  +
<!-- cover image -->
  +
{{#if:{{{cover|}}} |{{row/image+artist | {{{cover}}} |artist={{{cover-artist|}}} }}|}}
  +
<!-- series -->
  +
{{#if:{{{series|}}}{{{prequel|}}}{{{sequel|}}}|
  +
{{!}}-
  +
{{!}} colspan=2 style="padding: 0; margin: 0;" {{!}}
  +
{{{!}} width=100%
  +
{{!}}-
  +
! colspan=2 align=center {{!}} {{{series|Series}}}
  +
{{!}}-
  +
{{#if:{{{prequel|}}} |{{row/kv|Follows |''[[{{{prev|{{{prequel}}}|}}}|{{{prequel}}}]]'' }}|}}
  +
{{#if:{{{sequel|}}} |{{row/kv|Precedes |''[[{{{next|{{{sequel}}} |}}}|{{{sequel}}} ]]'' }}|}}
  +
{{!}}}
  +
}}
  +
{{!}}-
  +
<!-- series inclusion -->
  +
{{#if:{{{setting|}}} |{{row/kv|Setting |{{{setting}}} }}|}}
  +
<!-- collaborators -->
  +
{{#if:{{{collaborators|}}} |{{row/kv|Collaborators |{{{collaborators}}} }}|}}
  +
<!-- release date -->
  +
{{#if:{{{released|}}} |{{row/kv|Released |{{{released}}} }}|}}
  +
<!-- publisher's wikipedia page -->
  +
{{#if:{{{publisher-raw|}}} |{{row/kv|Publisher |{{{publisher-raw}}} }}|}}
  +
{{#if:{{{publisher|}}} |{{row/kv|Publisher |[[wikipedia:{{{publisher}}}|{{{publisher}}}]] }}|}}
  +
<!-- ISBN -->
  +
{{#if:{{{ISBN|}}} |{{row/kv|ISBN |[[Special: BookSources/{{{ISBN}}}|{{{ISBN}}}]] }}|}}
  +
<!-- page count -->
  +
{{#if:{{{page-count|}}} |{{row/kv|Page Count |{{{page-count}}} }}|}}
  +
<!-- word count -->
  +
{{#if:{{{word-count|}}} |{{row/kv|Word Count |{{{word-count}}} }}|}}
  +
<!-- annotations -->
  +
{{#if:{{{annotations|}}} |{{row/kv|Annotations |[[bws:{{{annotations}}}|{{{a-text|Portal}}}]] }}|}}
  +
{{#if:{{{annotation|}}} |{{row/kv|Annotation |[[bws:{{{annotation}}} |{{{a-text|here}}}]] }}|}}
  +
}}<includeonly><!--
   
  +
-->[[category: books]]<!--
cover image
 
  +
-->[[category: meta]]<!--
-->{{#if:{{{cover|}}}|{{row/image|{{{cover}}}|}}|}}<!--
 
   
  +
-->{{#if:{{{cover-artist|}}}|[[category: redundant artist attribution]]}}<!--
series
 
  +
-->{{#if:<!--
 
  +
--></includeonly><noinclude>
-->{{{hide-series|}}}{{{series|}}}{{{prequel|}}}{{{sequel|}}}<!--
 
  +
-->|{{#!:
 
  +
{{for|Template:Literature|the template describing in-world books|pre=This is the infobox template for real world books}}
  +
This template is used to describe actual books written by Brandon Sanderson. This includes published novels (e.g. ''[[The Way of Kings]]'', ''[[Legion (book)|Legion]]''), short stories (e.g. ''[[Perfect State]]''), anthologies (e.g. ''[[Arcanum Unbounded]]''), graphic novels (e.g. ''[[White Sand Volume 1|White Sand (vol. 1)]]''), and derivative works, such as the ''[[Mistborn Adventure Game (rule book)|Mistborn Adventure Game RPG]]'' and its expansions. In addition to any published works, this template also applies to books planned for the future (e.g. ''[[Nightblood (book)|Nightblood]]'') and books written in the past but not published (e.g. ''[[The Liar of Partinel]]'' or ''[[Aether of Night]]''). Notably, this template does not apply to Brandon's essays, blogs, annotations, or in-world books.
  +
  +
__TOC__
  +
  +
=== Template ===
  +
On lines with multiple parameters (e.g. <code>|publisher= / publisher-raw=</code>) pick only the one most appropriate.
  +
<pre class=mw-code>
  +
{{book
  +
|cover=
  +
|prequel=
  +
|sequel=
  +
|series=
  +
|setting=
  +
|collaborators=
  +
|released=
  +
|publisher= / publisher-raw=
  +
|ISBN=
  +
|annotation= / annotations=
  +
}}
  +
</pre>
  +
  +
  +
=== Parameters ===
  +
None of the parameters are mandatory.
  +
  +
{| class="wikitable" width=100%
  +
<!-- ------------- -->
  +
<!-- TABLE CAPTION -->
  +
<!-- ------------- -->
  +
|+ {{t|Book}} Parameters
  +
  +
<!-- -------------- -->
  +
<!-- COLUMN HEADERS -->
  +
<!-- -------------- -->
  +
|-
  +
! scope="col" style="font-weight: bold;" | Parameter
  +
! scope="col" style="font-weight: bold;" | Description
  +
! scope="col" style="font-weight: bold;" | Examples
  +
  +
<!-- ---------- -->
  +
<!-- ROW: title -->
  +
<!-- ---------- -->
 
|-
 
|-
| colspan=2 style="padding: 0; margin: 0;" |
+
| style="text-align: center;" | <code>title</code>
  +
| Rarely used, the <code>title</code> parameter allows you to overwrite the default title of the infobox (which is the same as the page name). This is mostly useful when the page name is somehow different from the actual title of the book. For example, ''Alcatraz Versus the Evil Librarians'' is both the name of a [[Alcatraz_Versus_the_Evil_Librarians_(book)|book]] and its [[Alcatraz Versus the Evil Librarians (series)|series]]. Since the default page title for the book is [[Alcatraz Versus the Evil Librarians (book)]], the infobox opts to overwrite this with a more sensible ''Alcatraz Versus the Evil Librarians''.
{| width=100% class="mw-collapsible {{{hide-family|mw-collapsed}}}"
 
  +
| style="white-space: nowrap;" |
|-
 
  +
<code><nowiki>|title=Alcatraz Versus the Evil Librarians</nowiki></code>
! colspan=2 align=center|{{{series|Series}}}
 
  +
|-
 
  +
<!-- ---------- -->
{{#if:{{{prequel|}}}|{{row/kv|Follows|''[[{{{prev|{{{prequel}}}|}}}|{{{prequel}}}]]''}}|}}
 
  +
<!-- ROW: cover -->
{{#if:{{{sequel|}}}|{{row/kv|Precedes|''[[{{{next|{{{sequel}}}|}}}|{{{sequel}}}]]''}}|}}
 
  +
<!-- ---------- -->
|}}}|}}
 
  +
|-
<!--
 
  +
| style="text-align: center;" | <code>cover</code>
  +
| Provide a filename to autogenerate a thumbnail and artist attribution using the {{t|row/image+artist}} template.
  +
| style="white-space: nowrap;" |
  +
<code><nowiki>|cover=Words of Radiance.jpg</nowiki></code>
  +
  +
<!-- ------------------- -->
  +
<!-- ROW: prequel & prev -->
  +
<!-- ------------------- -->
  +
|-
  +
| style="text-align: center;" | <code>prequel</code> <br><small>(and, optionally)</small><br> <code>prev</code>
  +
| If the book belongs to a series and is not the first book in it, <code>prequel</code> can be used to provide that first book. Using this parameter autogenerates a <code><</code> link to the prequel's page, and adds a '''Follows''' row in the infobox.<br>
  +
<code>prev</code> can be used in conjunction with <code>prequel</code> to provide an alternative name in the '''Follows''' row. In this scenario, <code>prev</code> should use the actual name of the target page, while <code>prequel</code> displays a more user-friendly name.<br>
  +
<small>'''Note:''' Infoboxes that make use of <code>prequel</code> should also have a <code>series</code>.</small>
  +
| style="white-space: nowrap;" |
  +
<code><nowiki>|prequel=The Way of Kings</nowiki></code><br>
  +
<code><nowiki>|prev=Legion (book)|prequel=Legion</nowiki></code>
  +
  +
<!-- ------------------ -->
  +
<!-- ROW: sequel & next -->
  +
<!-- ------------------ -->
  +
|-
  +
| style="text-align: center;" | <code>sequel</code> <br><small>(and, optionally)</small><br> <code>next</code>
  +
| If the book belongs to a series and has a known sequel, <code>sequel</code> can be used to provide it. Using this parameter autogenerates a <code>></code> link to the sequel's page, and adds a '''Precedes''' row in the infobox.<br>
  +
<code>next</code> can be used in conjunction with <code>sequel</code> to provide an alternative name in the '''Precedes''' row. In this scenario, <code>next</code> should use the actual name of the target page, while <code>sequel</code> displays a more user-friendly name.<br>
  +
<small>'''Note''': Infoboxes that make use of <code>sequel</code> should also have a <code>series</code>.</small>
  +
| style="white-space: nowrap;" |
  +
<code><nowiki>|sequel=Oathbringer</nowiki></code><br>
  +
<code><nowiki>|next=Legion: Skin Deep|sequel=Skin Deep</nowiki></code>
  +
  +
<!-- ----------- -->
  +
<!-- ROW: series -->
  +
<!-- ----------- -->
  +
|-
  +
| style="text-align: center;" | <code>series</code>
  +
| If the book belongs to a series, use this parameter to link to the series' page.
  +
| style="white-space: nowrap;" |
  +
<code><nowiki>|series=The Stormlight Archive</nowiki></code>
  +
  +
<!-- ------------ -->
  +
<!-- ROW: setting -->
  +
<!-- ------------ -->
  +
|-
  +
| style="text-align: center;" | <code>setting</code>
  +
| Use this to describes the setting of the book. Cosmere stories usually include both the [[Shardworld]] and [[Cosmere]]. This parameter is similar to the ''universe'' parameter in other templates.
  +
| style="white-space: nowrap;" |
  +
<code><nowiki>|setting=[[Roshar]], [[Cosmere]]</nowiki></code><br>
  +
<code><nowiki>|setting=[[Skyward (series)]]</nowiki></code><br>
  +
<code><nowiki>|setting=''Standalone''</nowiki></code>
  +
  +
<!-- ------------ -->
  +
<!-- ROW: collaborators -->
  +
<!-- ------------ -->
  +
|-
  +
| style="text-align: center;" | <code>collaborators</code>
  +
| Use this to list collaborators, including coauthors and authors who adapt a work into a new medium. For visual media, it should include the lead artist(s); for audio originals, it should include the narrator(s).
  +
| style="white-space: nowrap;" |
  +
<code><nowiki>|collaborators=[[Rik Hoskin]], [[Julius Gopez]], [[Julius Ohta]]</nowiki></code><br>
  +
<code><nowiki>|collaborators=[[Mary Robinette Kowal]], [[Julia Whelan]]</nowiki></code><br>
  +
  +
<!-- ------------- -->
  +
<!-- ROW: released -->
  +
<!-- ------------- -->
  +
|-
  +
| style="text-align: center;" | <code>released</code>
  +
| Use this to specify the release date for the book. Use the ''Month D, YEAR'' format.
  +
| style="white-space: nowrap;" |
  +
<code><nowiki>|released=March 14, 2014</nowiki></code>
  +
  +
<!-- ------------------------------ -->
  +
<!-- ROW: publisher / publisher-raw -->
  +
<!-- ------------------------------ -->
  +
|-
  +
| style="text-align: center; white-space: nowrap;" | <code>publisher</code> <br><small>or</small><br> <code>publisher-raw</code>
  +
| Use this to link to the publisher's Wikipedia page.<br>
  +
<small>To bypass the automatic linking or to link to a non-Wikipedia website, use <code>publisher-raw</code>.</small>
  +
| style="white-space: nowrap;" |
  +
<code><nowiki>|publisher=Tor books</nowiki></code><br>
  +
<code><nowiki>|publisher-raw=Subterranean Press</nowiki></code><br>
  +
<code><nowiki>|publisher-raw=[https://subterraneanpress.com/ Subterranean Press]</nowiki></code>
  +
  +
<!-- --------- -->
  +
<!-- ROW: ISBN -->
  +
<!-- --------- -->
  +
|-
  +
| style="text-align: center;" | <code>isbn</code>
  +
| Use this to specify the book's ISBN.
  +
| style="white-space: nowrap;" |
  +
<code><nowiki>|ISBN=978-0765326362</nowiki></code>
  +
  +
<!-- ----------------------------- -->
  +
<!-- ROW: annotation / annotations -->
  +
<!-- ----------------------------- -->
  +
|-
  +
| style="text-align: center;" | <code>annotation</code> <br><small>or</small><br> <code>annotations</code>
  +
| If the book has annotations on Brandon's website, this parameter can link to them. Navigate to the annotations page and pass everything after the <code>https://brandonsanderson.com/</code> as a value to this parameter.<br>
  +
<small>If the annotations reside on a single page (and there is no "hub" page), use <code>annotation</code> instead.
  +
| style="white-space: nowrap;" |
  +
<code><nowiki>|annotations=annotation-alcatraz-authors-foreword</nowiki></code><br>
  +
<code><nowiki>|annotation=annotation-recent-short-stories-defending-elysium/</nowiki></code>
   
  +
|}
release date
 
-->{{#if:{{{released|}}}|{{row/kv|Released|{{{released}}}|}}|}}<!--
 
publisher's wikipedia page
 
-->{{#if:{{{publisher|}}}|{{row/kv|Publisher|[[wikipedia:{{{publisher}}}|{{{publisher}}}]]|}}|}}<!--
 
ISBN
 
-->{{#if:{{{ISBN|}}}|{{row/kv|ISBN|[[Special:BookSources/{{{ISBN}}}|{{{ISBN}}}]]}}|}}<!--
 
annotations
 
-->{{#if:{{{annotations|}}}|{{row/kv|Annotations|[[bws:annotations/book/{{{annotations}}}|{{{a-text|Portal}}}]]}}|}}<!--
 
   
  +
=== Categories & Tags ===
--><!--
 
   
  +
Applying this template to a page will add the article to [[:Category: Books|Books]] category.
-->}}<includeonly>[[Category:Books]]</includeonly><!--
 
   
--><noinclude>{{cat|infoboxes}}
+
[[category: infoboxes]]
   
  +
== Articles using Template ==
This template is used to describe books. All the parameters are optional, though it is advised that most of them should be filled in. Passing a file name in {{{cover}}} will output a thumbnail at the top of the infobox. The release date can be added in {{{released}}}. The {{{series}}}, {{{prequel}}} and {{{sequel}}} parameters can be used where appropriate, the prequel and sequel links will add < or > links to the title at the top of the box. {{{publisher}}} link to the publisher's Wikipedia page and {{{ISBN}}} does something with the books ISBN number. Passing {{{annotations}}} will link to one of the annotations pages on [[Brandon]]'s website.
 
  +
{{for|Special:WhatLinksHere/{{FULLPAGENAME}}|a full listing|here|pre=This list is limited to 100 pages.}}
  +
{{Special:WhatLinksHere/{{FULLPAGENAME}}|namespace=0|limit=100}}

Revision as of 00:59, 26 February 2021

Book

This template is used to describe actual books written by Brandon Sanderson. This includes published novels (e.g. The Way of Kings, Legion), short stories (e.g. Perfect State), anthologies (e.g. Arcanum Unbounded), graphic novels (e.g. White Sand (vol. 1)), and derivative works, such as the Mistborn Adventure Game RPG and its expansions. In addition to any published works, this template also applies to books planned for the future (e.g. Nightblood) and books written in the past but not published (e.g. The Liar of Partinel or Aether of Night). Notably, this template does not apply to Brandon's essays, blogs, annotations, or in-world books.

Template

On lines with multiple parameters (e.g. |publisher= / publisher-raw=) pick only the one most appropriate.

{{book
|cover=
|prequel=
|sequel=
|series=
|setting=
|collaborators=
|released=
|publisher= / publisher-raw=
|ISBN=
|annotation= / annotations=
}}


Parameters

None of the parameters are mandatory.

{{Book}} Parameters
Parameter Description Examples
title Rarely used, the title parameter allows you to overwrite the default title of the infobox (which is the same as the page name). This is mostly useful when the page name is somehow different from the actual title of the book. For example, Alcatraz Versus the Evil Librarians is both the name of a book and its series. Since the default page title for the book is Alcatraz Versus the Evil Librarians (book), the infobox opts to overwrite this with a more sensible Alcatraz Versus the Evil Librarians.

|title=Alcatraz Versus the Evil Librarians

cover Provide a filename to autogenerate a thumbnail and artist attribution using the {{row/image+artist}} template.

|cover=Words of Radiance.jpg

prequel
(and, optionally)
prev
If the book belongs to a series and is not the first book in it, prequel can be used to provide that first book. Using this parameter autogenerates a < link to the prequel's page, and adds a Follows row in the infobox.

prev can be used in conjunction with prequel to provide an alternative name in the Follows row. In this scenario, prev should use the actual name of the target page, while prequel displays a more user-friendly name.
Note: Infoboxes that make use of prequel should also have a series.

|prequel=The Way of Kings
|prev=Legion (book)|prequel=Legion

sequel
(and, optionally)
next
If the book belongs to a series and has a known sequel, sequel can be used to provide it. Using this parameter autogenerates a > link to the sequel's page, and adds a Precedes row in the infobox.

next can be used in conjunction with sequel to provide an alternative name in the Precedes row. In this scenario, next should use the actual name of the target page, while sequel displays a more user-friendly name.
Note: Infoboxes that make use of sequel should also have a series.

|sequel=Oathbringer
|next=Legion: Skin Deep|sequel=Skin Deep

series If the book belongs to a series, use this parameter to link to the series' page.

|series=The Stormlight Archive

setting Use this to describes the setting of the book. Cosmere stories usually include both the Shardworld and Cosmere. This parameter is similar to the universe parameter in other templates.

|setting=[[Roshar]], [[Cosmere]]
|setting=[[Skyward (series)]]
|setting=''Standalone''

collaborators Use this to list collaborators, including coauthors and authors who adapt a work into a new medium. For visual media, it should include the lead artist(s); for audio originals, it should include the narrator(s).

|collaborators=[[Rik Hoskin]], [[Julius Gopez]], [[Julius Ohta]]
|collaborators=[[Mary Robinette Kowal]], [[Julia Whelan]]

released Use this to specify the release date for the book. Use the Month D, YEAR format.

|released=March 14, 2014

publisher
or
publisher-raw
Use this to link to the publisher's Wikipedia page.

To bypass the automatic linking or to link to a non-Wikipedia website, use publisher-raw.

|publisher=Tor books
|publisher-raw=Subterranean Press
|publisher-raw=[https://subterraneanpress.com/ Subterranean Press]

isbn Use this to specify the book's ISBN.

|ISBN=978-0765326362

annotation
or
annotations
If the book has annotations on Brandon's website, this parameter can link to them. Navigate to the annotations page and pass everything after the https://brandonsanderson.com/ as a value to this parameter.

If the annotations reside on a single page (and there is no "hub" page), use annotation instead.

|annotations=annotation-alcatraz-authors-foreword
|annotation=annotation-recent-short-stories-defending-elysium/

Categories & Tags

Applying this template to a page will add the article to Books category.

Articles using Template