Difference between revisions of "Template:Cover"

Jump to navigation Jump to search
5,013 bytes added ,  4 years ago
More includeonly tags, move artwork row placement, country param default value and tracking cat, remove series row, close break tags, tweak source examples, remove test infoboxes
m (+artwork param)
(More includeonly tags, move artwork row placement, country param default value and tracking cat, remove series row, close break tags, tweak source examples, remove test infoboxes)
(3 intermediate revisions by 2 users not shown)
<includeonly><onlyinclude>{| class=infobox align=center
<!-- -->{{row/kv|Book |{{book tag|{{{book}}}|}} }}| }}
{{#if:{{{series#artist|}}} |{{row/kv|SeriesArtist |{{series[[Coppermind: tag|Artists/{{{series#artist}}} |}} {{{#artist}}|} ]] }}
{{#if:{{{#artist|}}}<!-- ELSE -->|{{row/kv|Artist |[[Coppermind: Artists/{{{#artist|''unknown''}}} | {{{#artist}}} ]] }}|}}
<!--{{#if:{{{artwork|}}} ELSE -->|{{row/kv|Artist Artwork |[[:File:{{{artistartwork}}}|''unknown''{{{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 usedin by |{{{also}}} }}|}}
{{#if:{{{artwork|}}}<!-- | -->{{row/kv|ArtworkSource |[[:{{{artworksource|''unknown''}}}]] }}| }}
|}<includeonly><!--
<!-- -->{{row/kv|Source |{{{source|''unknown''}}} }}
|}<!--
 
-->{{#if:{{{#artist|}}}<!--
-->}}|}}<!--
 
-->{{#if:{{{sourcecountry|}}}|<!-- -->|[[Category: missingbook sourcecover missing linkcountry]]}}<!--
-->{{#if:{{{source|}}}|<!-- -->|[[Category: missing source link]]}}<!--
 
-->{{#if:{{{series|}}}|{{series tag|{{{series}}}|}}|<!-- -->}}<!--
-->[[Category:Book covers]]<!--
 
--></onlyincludeincludeonly></includeonlyonlyinclude>
The '''cover''' template is used in the place of {{t|art}} on the File pages for all cover artworkart fromof [[Brandon Sanderson|Brandon]]'s books, regardless of whether they're traditional books, audiobooks, comics or ebooks.
 
__TOC__
|series=
|#artist=
|artwork=
|country=
|type=
|ISBN=
|also=
|artwork=
|source=
}}
</pre>
 
=== Parameters ===
<center>'''Without parameters passed'''</center>
{{User:Stargazer/Cover}}
 
{{docs|title={{t|cover}} Parameters}}
<center>'''With parameters passed'''</center>
 
{{User:Stargazer/Cover
<!-- -------- -->
|book=sa1
<!-- ROW: book -->
|series=sa
<!-- -------- -->
|artist=[[Isaac Stewart]]
{{docs/row/required
|country=United States
|param=book
|type=Hardcover
|desc= Use this to associate the cover with the book it belongs to.<br />
|year=2011
'''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.
|ISBN=lorem ipsum
|eg=
|also=Somewhere
<code><nowiki>|book=sa1</nowiki></code><br />
|artwork=File:TheWayOfKings.png
<code><nowiki>|book=wb</nowiki></code><br />
|source=[https://coppermind.net/wiki/File:TheWayOfKings.png Coppermind]
<code><nowiki>|book=sky2</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. This row won't appear in the template, but that's the desired behavior; it's used only for categorization.<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.
|eg=
<code><nowiki>|series=stormlight</nowiki></code><br />
<code><nowiki>|series=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]].
 
[[:Category:Infoboxes]]

Navigation menu