Editing Template:Cover

<onlyinclude>{| class=infobox align=center
<!--                             -->{{row/kv|Book             |{{#if:{{{book|}}}|''{{book tag|{{{book}}}|}}''|{{{'book}}}}}  }}
{{#if:{{{#artist|}}}               |{{row/kv|Artist           |[[Coppermind: Artists/{{{#artist}}} | {{{#artist}}} ]]        }}
<!--                      ELSE  -->|{{row/kv|Artist           |{{{artist|''unknown''}}}                                      }}|}}
{{#if:{{{artwork|}}}               |{{row/kv|Artwork          |[[:File:{{{artwork}}}|{{{artwork}}}]]                         }}|}}
<!--                             -->{{row/kv|Country          |{{{country|''unknown''}}}                                     }}
{{#if:{{{type|}}}                  |{{row/kv|Type             |{{{type}}}                                                    }}|}}
{{#if:{{{year|}}}                  |{{row/kv|Year             |{{{year}}}                                                    }}|}}
{{#if:{{{ISBN|{{{isbn|}}}}}}       |{{row/kv|ISBN             |{{{ISBN|{{{isbn|}}}}}}                                        }}|}}
{{#if:{{{also|}}}                  |{{row/kv|Also in          |{{{also}}}                                                    }}|}}
<!--                             -->{{row/kv|Source           |{{{source|''unknown''}}}                                      }}
|}<includeonly><!--

-->{{#if:{{{#artist|}}}<!--
     -->|<set-property key="artist">[[Coppermind: Artists/{{{#artist}}} | {{{#artist}}} ]]</set-property><!--
    ELSE:
     -->|{{#if:{{{artist|}}}<!--
           -->|<set-property key="artist">{{{artist}}}</set-property>[[category: file with manual artist link]]<!--
    ELSE:
     -->|[[category: missing artist 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]]<!--

--></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.

__TOC__

=== Template ===
<pre class=mw-code>
{{cover
|book=
|series=
|#artist=
|artwork=
|country=
|type=
|year=
|ISBN=
|also=
|source=
}}
</pre>

=== Parameters ===

{{docs|title={{t|cover}} Parameters}}

<!-- -------- -->
<!-- ROW: book -->
<!-- -------- -->
{{docs/row/required
|'param=<code>book</code><br />or<br /><code>'book</code>
|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. If the artwork is the cover for multiple books, use <code>'book</code>
|eg=
<code><nowiki>|book=sa1</nowiki></code><br />
<code><nowiki>|book=wb</nowiki></code><br />
<code><nowiki>|'book=''[[Legion (book)|]]'' and ''[[The Emperor's Soul]]'' collection</nowiki></code>
}}

<!-- -------- -->
<!-- ROW: series -->
<!-- -------- -->
{{docs/row/optional
|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. 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:''' This row won't appear in the template, but that's the desired behavior; it's used only for categorization.
|eg=
<code><nowiki>|series=Stormlight Archive</nowiki></code><br />
<code><nowiki>|series=Mistborn Era 1</nowiki></code><br />
<code><nowiki>|series=The Reckoners</nowiki></code>
}}

<!-- -------- -->
<!-- ROW: #artist/artist -->
<!-- -------- -->
{{docs/row/required
|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.
|eg=All these are equivalent:<br />
<code><nowiki>|#artist=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>
}}

<!-- -------- -->
<!-- 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>
}}

<!-- -------- -->
<!-- ROW: country -->
<!-- -------- -->
{{docs/row/required
|param=country
|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=
<code><nowiki>|country=United States</nowiki></code><br />
<code><nowiki>|country=Brazil</nowiki></code>
}}

<!-- -------- -->
<!-- ROW: type -->
<!-- -------- -->
{{docs/row/optional
|param=type
|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=
<code><nowiki>|type=Hardcover</nowiki></code><br />
<code><nowiki>|type=Ebook</nowiki></code><br />
<code><nowiki>|type=Leatherbound</nowiki></code>
}}

<!-- -------- -->
<!-- ROW: year -->
<!-- -------- -->
{{docs/row/optional
|param=year
|desc=The year this specific edition of the book came out.
|eg=
<code><nowiki>|year=2019</nowiki></code>
}}

<!-- -------- -->
<!-- ROW: ISBN -->
<!-- -------- -->
{{docs/row/optional
|param=ISBN
|desc=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.
|eg=
<code><nowiki>|ISBN=0765326353</nowiki></code>
}}

<!-- -------- -->
<!-- ROW: also -->
<!-- -------- -->
{{docs/row/optional
|param=also
|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=
<code><nowiki>|also=Brazil, Poland</nowiki></code><br />
<code><nowiki>|also=Graphic Audio</nowiki></code>
}}

<!-- -------- -->
<!-- ROW: source -->
<!-- -------- -->
{{docs/row/required
|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 />
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=
<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>
}}

|}

=== Categories & tags ===
Pages that make use of the {{t|cover}} template will be added to [[:Category:Book covers]].

=== Series Aliases ===
The following aliases are valid for the <code>series</code> parameter:
{| 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]]

== Files using Template ==
{{for|Special:WhatLinksHere/{{FULLPAGENAME}}|a full listing|here|pre=This list is limited to 100 files.}}
{{Special:WhatLinksHere/{{FULLPAGENAME}}|namespace=6|limit=100}}