Difference between revisions of "Template:Cover"

From The Coppermind
Jump to navigation Jump to search
m (+White Sand)
 
(13 intermediate revisions by 3 users not shown)
Line 1: Line 1:
−
<includeonly><onlyinclude>{| class=infobox align=center
 +
<onlyinclude>{| class=infobox align=center
−
<!-- -->{{row/kv|Book |{{book tag|{{{book}}}|}} }}
 +
<!-- -->{{row/kv|Book |{{#if:{{{book|}}}|''{{book tag|{{{book}}}|}}''|{{{'book}}}}} }}
−
{{#if:{{{series|}}} |{{row/kv|Series |{{series tag|{{{series}}}|}} }}|}}
 +
{{#if:{{{#artist|}}} |{{row/kv|Artist |[[Coppermind: Artists/{{{#artist}}} | {{{#artist}}} ]] }}
−
{{#if:{{{#artist|}}} |{{row/kv|Artist |[[Coppermind: Artists/{{{#artist}}} | {{{#artist}}} ]] }}
 +
<!-- ELSE -->|{{row/kv|Artist |{{{artist|''unknown''}}} }}|}}
−
<!-- ELSE -->|{{row/kv|Artist |{{{artist|''unknown''}}} }}|}}
 +
{{#if:{{{artwork|}}} |{{row/kv|Artwork |[[:File:{{{artwork}}}|{{{artwork}}}]] }}|}}
−
<!-- -->{{row/kv|Country |{{{country}}} }}
 +
<!-- -->{{row/kv|Country |{{{country|''unknown''}}} }}
−
{{#if:{{{type|}}} |{{row/kv|Type |{{{type}}} }}|}}
 +
{{#if:{{{type|}}} |{{row/kv|Type |{{{type}}} }}|}}
−
{{#if:{{{year|}}} |{{row/kv|Year |{{{year}}} }}|}}
 +
{{#if:{{{year|}}} |{{row/kv|Year |{{{year}}} }}|}}
−
{{#if:{{{ISBN|{{{isbn|}}}}}} |{{row/kv|ISBN |{{{ISBN|{{{isbn|}}}}}} }}|}}
 +
{{#if:{{{ISBN|{{{isbn|}}}}}} |{{row/kv|ISBN |{{{ISBN|{{{isbn|}}}}}} }}|}}
−
{{#if:{{{also|}}} |{{row/kv|Also in |{{{also}}} }}|}}
 +
{{#if:{{{also|}}} |{{row/kv|Also in |{{{also}}} }}|}}
−
{{#if:{{{artwork|}}} |{{row/kv|Artwork |[[:File:{{{artwork}}}|{{{artwork}}}]] }}|}}
 +
<!-- -->{{row/kv|Source |{{{source|''unknown''}}} }}
  +
|}<includeonly><!--
−
<!-- -->{{row/kv|Source |{{{source|''unknown''}}} }}
  
−
|}<!--
  
   
 
-->{{#if:{{{#artist|}}}<!--
  
-->{{#if:{{{#artist|}}}<!--
Line 22: Line 21:
 
-->}}|}}<!--
  
-->}}|}}<!--
   
−
-->{{#if:{{{source|}}}|<!-- -->|[[Category: missing source link]]}}<!--
 +
-->{{#if:{{{country|}}}|<!-- -->|[[Category: book cover missing country]]}}<!--
  +
-->{{#if:{{{source|}}}|<!-- -->|[[Category: missing source link]]}}<!--
  +
  +
-->{{#if:{{{series|}}}|[[Category:{{#switch:{{lc:{{{series}}}}}<!--
  +
-->|sa|stormlight|stormlight archive|the stormlight archive=Stormlight Archive<!--
  +
-->|mbe1|mistborn era 1=Mistborn Era 1<!--
  +
-->|mbe2|mistborn era 2=Mistborn Era 2<!--
  +
-->|skyward|skyward series=Skyward<!--
  +
-->|legion|legion series=Legion<!--
  +
-->|reckoners|the reckoners=The Reckoners<!--
  +
-->|alcatraz=Alcatraz<!--
  +
-->|do|dark one=Dark One<!--
  +
-->|ws|white sand=White Sand<!--
  +
-->|{{{series}}}{{cover/unrecognized series}}<!--
  +
-->}}]]|}}<!--
 
-->[[Category:Book covers]]<!--
  
-->[[Category:Book covers]]<!--
   
−
--></onlyinclude></includeonly>
 +
--></includeonly></onlyinclude>
−
The '''cover''' template is used in the place of {{t|art}} on the File pages for all cover art of [[Brandon Sanderson|Brandon]]'s books, regardless of whether they're traditional books, audiobooks, comics or ebooks.
 +
The '''cover''' template is used in the place of {{t|art}} on the File pages for all cover art of [[Brandon Sanderson|Brandon]]'s works, regardless of whether they're traditional books, audiobooks, comics or ebooks.
   
 
__TOC__
  
__TOC__
Line 36: Line 49:
 
|series=
  
|series=
 
|#artist=
  
|#artist=
  +
|artwork=
 
|country=
  
|country=
 
|type=
  
|type=
Line 41: Line 55:
 
|ISBN=
  
|ISBN=
 
|also=
  
|also=
−
|artwork=
  
 
|source=
  
|source=
 
}}
  
}}
Line 47: Line 60:
   
 
=== Parameters ===
  
=== Parameters ===
  +
Highlighted lines indicate '''mandatory''' parameters. If not used, they will either appear as "''unknown''" or produce an error.
   
 
{{docs|title={{t|cover}} Parameters}}
  
{{docs|title={{t|cover}} Parameters}}
Line 54: Line 68:
 
<!-- -------- -->
  
<!-- -------- -->
 
{{docs/row/required
  
{{docs/row/required
  +
|'param=<code>book</code><br />or<br /><code>'book</code>
−
|param=book
  
−
|desc= Use this to associate the cover with the book it belongs to.<br>
 +
|desc= Use this to associate the cover with the book it belongs to.<br />
−
'''Note:''' The value here is forwarded to the {{t|book tag}} template, which then forwards it to {{t|b}}. This means the original value must be valid for those templates as well. See their pages for details.
 +
'''Note:''' The value here is forwarded to the {{t|book tag}} template, which then forwards it to {{t|b}}. This means the original value must be valid for those templates as well. See their pages for details. If the artwork is the cover for multiple books, use <code>'book</code>
 
|eg=
  
|eg=
−
<code><nowiki>|book=sa1</nowiki></code><br>
 +
<code><nowiki>|book=sa1</nowiki></code><br />
−
<code><nowiki>|book=wb</nowiki></code><br>
 +
<code><nowiki>|book=wb</nowiki></code><br />
−
<code><nowiki>|book=sky2</nowiki></code><br>
 +
<code><nowiki>|'book=''[[Legion (book)|]]'' and ''[[The Emperor's Soul]]'' collection</nowiki></code>
 
}}
  
}}
   
Line 68: Line 82:
 
{{docs/row/optional
  
{{docs/row/optional
 
|param=series
  
|param=series
−
|desc=Use this to associate the cover with a book series. '''Adds the image to that series' category''', so it's advisable to add it. This row won't appear in the template, but that's the desired behavior; it's used only for categorization.<br>
 +
|desc=Use this to associate the cover with a book series. '''Adds the image to that series' category''', so it's advisable to add it. The value you pass must either be one of the aliases listed below at [[#Series Aliases]] or ''exactly'' match the name of the series category (see the subcategories of [[:Category:Series]] for a list of series categories).<br />
−
'''Note:''' The value here is forwarded to the {{t|series tag}} template, which means it must be one of the valid values for that template. See the {{t|series tag}} page for more details.
 +
'''Note:''' This row won't appear in the template, but that's the desired behavior; it's used only for categorization.
 
|eg=
  
|eg=
−
<code><nowiki>|series=stormlight</nowiki></code><br>
 +
<code><nowiki>|series=Stormlight Archive</nowiki></code><br />
−
<code><nowiki>|series=reckoners</nowiki></code>
 +
<code><nowiki>|series=Mistborn Era 1</nowiki></code><br />
  +
<code><nowiki>|series=The Reckoners</nowiki></code>
 
}}
  
}}
   
Line 79: Line 94:
 
<!-- -------- -->
  
<!-- -------- -->
 
{{docs/row/required
  
{{docs/row/required
−
|param=<code>#artist</code> <br><small>or</small><br> <code>artist</code>
 +
|param=<code>#artist</code><br /><small>or</small><br /><code>artist</code>
 
|desc=Use <code>#artist</code> to automatically link to the artist's Coppermind page (<small>under <code>Coppermind:Artists</code></small>) by just supplying their name. If necessary, <code>artist</code> can be used to manually link to their page.
  
|desc=Use <code>#artist</code> to automatically link to the artist's Coppermind page (<small>under <code>Coppermind:Artists</code></small>) by just supplying their name. If necessary, <code>artist</code> can be used to manually link to their page.
−
|eg=All these are equivalent:<br>
 +
|eg=All these are equivalent:<br />
−
<code><nowiki>|#artist=Alex Allen</nowiki></code><br>
 +
<code><nowiki>|#artist=Alex Allen</nowiki></code><br />
−
<code><nowiki>|artist={{a|Alex Allen}}</nowiki></code><br>
 +
<code><nowiki>|artist={{a|Alex Allen}}</nowiki></code><br />
 
<code><nowiki>|artist=[[Coppermind:Artists/Alex Allen|Alex Allen]]</nowiki></code>
  
<code><nowiki>|artist=[[Coppermind:Artists/Alex Allen|Alex Allen]]</nowiki></code>
  +
}}
  +
  +
<!-- -------- -->
  +
<!-- ROW: artwork -->
  +
<!-- -------- -->
  +
{{docs/row/optional
  +
|param=artwork
  +
|desc=If the text-less cover artwork has been uploaded to the Coppermind, you can use this parameter to link to it.
  +
|eg=
  +
<code><nowiki>|artwork=Kaladin Allen.jpg</nowiki></code><br />
  +
<code><nowiki>|artwork=Emperor's Soul Polish Cover.jpg</nowiki></code>
 
}}
  
}}
   
Line 94: Line 120:
 
|desc=What country had the book with this cover. If the same cover has been used by multiple different translations, put the country that used it first here (in most such cases, this will be the USA).
  
|desc=What country had the book with this cover. If the same cover has been used by multiple different translations, put the country that used it first here (in most such cases, this will be the USA).
 
|eg=
  
|eg=
−
<code><nowiki>|country=United States</nowiki></code><br>
 +
<code><nowiki>|country=United States</nowiki></code><br />
 
<code><nowiki>|country=Brazil</nowiki></code>
  
<code><nowiki>|country=Brazil</nowiki></code>
 
}}
  
}}
Line 105: Line 131:
 
|desc=What type of book had this cover. In many places, different editions of the same book, such as hardcover, paperback and ebook, will have different covers; that's why this parameter is important to use. There's no need to use it if you don't know which version used this artwork, or if this is the only artwork the book had in its country.
  
|desc=What type of book had this cover. In many places, different editions of the same book, such as hardcover, paperback and ebook, will have different covers; that's why this parameter is important to use. There's no need to use it if you don't know which version used this artwork, or if this is the only artwork the book had in its country.
 
|eg=
  
|eg=
−
<code><nowiki>|type=hardcover</nowiki></code><br>
 +
<code><nowiki>|type=Hardcover</nowiki></code><br />
−
<code><nowiki>|type=ebook</nowiki></code><br>
 +
<code><nowiki>|type=Ebook</nowiki></code><br />
−
<code><nowiki>|type=leatherbound</nowiki></code>
 +
<code><nowiki>|type=Leatherbound</nowiki></code>
 
}}
  
}}
   
Line 137: Line 163:
 
|desc=What other editions of the book used this cover artwork. This can include both different formats (for example, if the cover was made for ebook, and later cropped for an audiobook version) and different countries (often, a translation of a book will use original artwork with different text).
  
|desc=What other editions of the book used this cover artwork. This can include both different formats (for example, if the cover was made for ebook, and later cropped for an audiobook version) and different countries (often, a translation of a book will use original artwork with different text).
 
|eg=
  
|eg=
−
<code><nowiki>|also=Brazil, Poland</nowiki></code><br>
 +
<code><nowiki>|also=Brazil, Poland</nowiki></code><br />
 
<code><nowiki>|also=Graphic Audio</nowiki></code>
  
<code><nowiki>|also=Graphic Audio</nowiki></code>
−
}}
  
−  
−
<!-- -------- -->
  
−
<!-- ROW: artwork -->
  
−
<!-- -------- -->
  
−
{{docs/row/optional
  
−
|param=artwork
  
−
|desc=If the text-less cover artwork has been uploaded to the Coppermind, you can use this parameter to link to it.
  
−
|eg=
  
−
<code><nowiki>|artwork=Kaladin Allen.jpg</nowiki></code><br>
  
−
<code><nowiki>|artwork=Emperor's Soul Polish Cover.jpg</nowiki></code>
  
 
}}
  
}}
   
Line 157: Line 172:
 
{{docs/row/required
  
{{docs/row/required
 
|param=source
  
|param=source
−
|desc=Use this to link to a publicly viewable webpage where the image can be found, preferably the publisher's website, or the artist's.<br>
 +
|desc=Use this to link to a publicly viewable webpage where the image can be found, preferably the publisher's website, or the artist's.<br />
 
When naming the source, use just the website's name (e.g. '''Facebook''' instead of '''Facebook post''', or '''Amazon''' instead of '''Warbreaker on Amazon''').
  
When naming the source, use just the website's name (e.g. '''Facebook''' instead of '''Facebook post''', or '''Amazon''' instead of '''Warbreaker on Amazon''').
 
|eg=
  
|eg=
−
<code><nowiki>|source=[https://coppermind.net/wiki/File:TheWayOfKings.png Coppermind]</nowiki></code>
 +
<code><nowiki>|source=[https://gollancz.co.uk/2016/08/cover-reveal-arcanum-unbounded Gollancz]</nowiki></code><br />
  +
<code><nowiki>|source=[[bws:the-stormlight-archive-series/#THEWAYOFKINGS|Brandon's website]]</nowiki></code>
 
}}
  
}}
   
Line 166: Line 182:
   
 
=== Categories & tags ===
  
=== Categories & tags ===
−
Pages that make use of the {{t|cover}} template will be added to [[:Category: Book covers]].
 +
Pages that make use of the {{t|cover}} template will be added to [[:Category:Book covers]].
   
−
=== Examples ===
 +
=== Series Aliases ===
  +
The following aliases are valid for the <code>series</code> parameter:
−
Those won't go to the formal template page.
  
  +
{| class=infobox style="margin:auto"
  +
|-
  +
!Series
  +
!Aliases
  +
|-
  +
! [[Alcatraz Versus the Evil Librarians (series)|Alcatraz]]
  +
| <code>alcatraz</code>
  +
|-
  +
! [[Dark One (franchise)|Dark One]]
  +
| <code>do</code>, <code>dark one</code>
  +
|-
  +
! [[Legion (series)]]
  +
| <code>legion</code>, <code>legion series</code>
  +
|-
  +
! [[Mistborn Era 1]]
  +
| <code>mbe1</code>, <code>mistborn era 1</code>
  +
|-
  +
! [[Mistborn Era 2]]
  +
| <code>mbe2</code>, <code>mistborn era 2</code>
  +
|-
  +
! [[The Reckoners]]
  +
| <code>reckoners</code>, <code>the reckoners</code>
  +
|-
  +
! [[Skyward (series)]]
  +
| <code>skyward</code>, <code>skyward series</code>
  +
|-
  +
! [[The Stormlight Archive]]
  +
| <code>stormlight</code>, <code>stormlight archive</code>, <code>the stormlight archive</code>, <code>sa</code>
  +
|-
  +
! [[White Sand]]
  +
| <code>ws</code>, <code>white sand</code>
  +
|}
   
  +
[[Category:Infoboxes]]
−
<center>'''Without parameters passed'''</center>
  
−
{{User:Stargazer/Cover}}
  
−  
−
<center>'''With parameters passed'''</center>
  
−
{{User:Stargazer/Cover
  
−
|book=sa1
  
−
|series=sa
  
−
|artist=[[Isaac Stewart]]
  
−
|country=United States
  
−
|type=Hardcover
  
−
|year=2011
  
−
|ISBN=lorem ipsum
  
−
|also=Somewhere
  
−
|artwork=TheWayOfKings.png
  
−
|source=[https://coppermind.net/wiki/File:TheWayOfKings.png Coppermind]
  
−
}}
  
   
  +
== Files using Template ==
−
[[:Category:Infoboxes]]
  
  +
{{for|Special:WhatLinksHere/{{FULLPAGENAME}}|a full listing|here|pre=This list is limited to 100 files.}}
  +
{{Special:WhatLinksHere/{{FULLPAGENAME}}|namespace=6|limit=100}}

Latest revision as of 19:10, 24 July 2020

Book {{{'book}}}
Artist unknown
Country unknown
Source unknown

The cover template is used in the place of {{art}} on the File pages for all cover art of Brandon's works, regardless of whether they're traditional books, audiobooks, comics or ebooks.

Template[edit]

{{cover
|book=
|series=
|#artist=
|artwork=
|country=
|type=
|year=
|ISBN=
|also=
|source=
}}

Parameters[edit]

Highlighted lines indicate mandatory parameters. If not used, they will either appear as "unknown" or produce an error.

{{cover}} Parameters
Parameter Description Examples
book
or
'book 		Use this to associate the cover with the book it belongs to.

Note: The value here is forwarded to the {{book tag}} template, which then forwards it to {{b}}. This means the original value must be valid for those templates as well. See their pages for details. If the artwork is the cover for multiple books, use 'book

|book=sa1
|book=wb
|'book=''[[Legion (book)|]]'' and ''[[The Emperor's Soul]]'' collection

series Use this to associate the cover with a book series. Adds the image to that series' category, so it's advisable to add it. The value you pass must either be one of the aliases listed below at #Series Aliases or exactly match the name of the series category (see the subcategories of Category:Series for a list of series categories).

Note: This row won't appear in the template, but that's the desired behavior; it's used only for categorization.

|series=Stormlight Archive
|series=Mistborn Era 1
|series=The Reckoners

#artist
or
artist 		Use #artist to automatically link to the artist's Coppermind page (under Coppermind:Artists) by just supplying their name. If necessary, artist can be used to manually link to their page.

All these are equivalent:
|#artist=Alex Allen
|artist={{a|Alex Allen}}
|artist=[[Coppermind:Artists/Alex Allen|Alex Allen]]

artwork If the text-less cover artwork has been uploaded to the Coppermind, you can use this parameter to link to it.

|artwork=Kaladin Allen.jpg
|artwork=Emperor's Soul Polish Cover.jpg

country What country had the book with this cover. If the same cover has been used by multiple different translations, put the country that used it first here (in most such cases, this will be the USA).

|country=United States
|country=Brazil

type What type of book had this cover. In many places, different editions of the same book, such as hardcover, paperback and ebook, will have different covers; that's why this parameter is important to use. There's no need to use it if you don't know which version used this artwork, or if this is the only artwork the book had in its country.

|type=Hardcover
|type=Ebook
|type=Leatherbound

year The year this specific edition of the book came out.

|year=2019

ISBN The International Standard Book Number of this particular edition. Every edition will have its own ISBN; if you're unsure what it is, you can usually find it on sites like BookFinder or Goodreads.

|ISBN=0765326353

also What other editions of the book used this cover artwork. This can include both different formats (for example, if the cover was made for ebook, and later cropped for an audiobook version) and different countries (often, a translation of a book will use original artwork with different text).

|also=Brazil, Poland
|also=Graphic Audio

source Use this to link to a publicly viewable webpage where the image can be found, preferably the publisher's website, or the artist's.

When naming the source, use just the website's name (e.g. Facebook instead of Facebook post, or Amazon instead of Warbreaker on Amazon).

|source=[https://gollancz.co.uk/2016/08/cover-reveal-arcanum-unbounded Gollancz]
|source=[[bws:the-stormlight-archive-series/#THEWAYOFKINGS|Brandon's website]]

Categories & tags[edit]

Pages that make use of the {{cover}} template will be added to Category:Book covers.

Series Aliases[edit]

The following aliases are valid for the series parameter:

Series Aliases
Alcatraz alcatraz
Dark One do, dark one
Legion (series) legion, legion series
Mistborn Era 1 mbe1, mistborn era 1
Mistborn Era 2 mbe2, mistborn era 2
The Reckoners reckoners, the reckoners
Skyward (series) skyward, skyward series
The Stormlight Archive stormlight, stormlight archive, the stormlight archive, sa
White Sand ws, white sand

Files using Template[edit]

This list is limited to 100 files.. For a full listing, see here.
Retrieved from "https://coppermind.net/wiki/Template:Cover?&oldid=127544"