Difference between revisions of "Template:Cover Image Data1-2/Doc"

From ISFDB
Jump to navigation Jump to search
(consolidate templates)
 
Line 1: Line 1:
−
-----
+
#REDIRECT [[Template:Cover Image Data/Doc]]
−
<!--  * * * -->
 
−
 
 
−
 
 
−
Documentation for the template: '''[[:Template:Cover Image Data1-2|Cover Image Data1-2]]''' (transcluded from [[:Template:Cover Image Data1-2/Doc]]
 
−
 
 
−
==Purpose==
 
−
This template is to be placed on the image description page of a book, magazine, or other publication cover image used under fair use.
 
−
 
 
−
This version of {{tl|Cover Image Data}} is specifically intended to separately credit 2 cover artists.
 
−
 
 
−
==Usage==
 
−
A minimal call (omitting parameters that can safely be left to their defaults) to the template would be:
 
−
 
 
−
<code>
 
−
<nowiki>{{Cover Image Data </nowiki> <br />
 
−
|Title=<publication title> <br />
 
−
|Edition=<date and/or publisher> <br />
 
−
|Pub=<the publication record number or tag> <br />
 
−
|Publisher=<Name of publisher> <br />
 
−
|Artist1=<name of 1st cover artist> <br />
 
−
|Artist2=<name of 2nd cover artist> <br />
 
−
|Source=<origin of image> <br />
 
−
<nowiki>}}</nowiki>
 
−
</code>
 
−
 
 
−
A maximal call, including all parameters, would be:
 
−
 
 
−
<code>
 
−
<nowiki>{{Cover Image Data </nowiki> <br />
 
−
|Title=<publication title> <br />
 
−
|Edition=<date and/or publisher> <br />
 
−
|Pub=<the publication record number or tag> <br />
 
−
|Publisher=<Name of publisher> <br />
 
−
|Artist1=<name of 1st cover artist> <br />
 
−
|Artist1Id=<id of 1st cover artist> <br />
 
−
|Artist2=<name of 2nd cover artist> <br />
 
−
|Artist2Id=<id of 2nd cover artist> <br />
 
−
|CpyrtHolder=<name of the actual copyright holder> <br />
 
−
|Source=<origin of image> <br />
 
−
|Side=<back or front or spine> <br />
 
−
|AddRat=<Additional fair use rationale> <br />
 
−
|LowRes=<Yes or No> <br />
 
−
<nowiki>}}</nowiki>
 
−
</code>
 
−
 
 
−
All parameter names have an initial capital letter. Case is significant in a parameter name. The order of the parameters is not significant, but the order above is suggested, as it is the order of use within the template.
 
−
 
 
−
{{AngleBracketDoc}}
 
−
 
 
−
===Parameter definitions===
 
−
{| border="1" cellspacing="1" cellpadding="2" bgcolor="#FFFFD0"
 
−
 
 
−
!Parameter !! Description !! Default
 
−
|-
 
−
|'''Title''' || Should specify the actual title of the book or other publication whose image is being displayed. ||'''Required Field'''
 
−
|-
 
−
|'''Edition''' || Ideally should specify the year and publisher, as "Ace 1983", or some other text string which will distinguish the pictured edition from other publications of the same title. ||'''Required Field'''
 
−
|-
 
−
|'''Pub'''|| The publication record number or tag. Must be a valid argument to {{tl|P}}. ('''Id''' may be used as an alias for Pub, with the same effect.)||'''Strongly encouraged.''' No default.
 
−
|-
 
−
|'''Publisher''' || Should specify the name of the publisher of the publication displayed, for proper attribution. ||'''Required Field'''
 
−
|-
 
−
|'''CpyrtHolder''' || The name of the copyright holder of the image, if known with reasonable assurance, particularly if this is not the publisher. For example if a movie tie-in edition has a cover that is a still or poster for the movie, this would be the production company (such as "Paramount Pictures"). || Defaults to "the publisher or the cover artist". Ommit if not known.
 
−
|-
 
−
|'''Artist1''' || The name of the 1st cover artist. ||If omitted, defaults to "Unknown". Links to the artist's DB page unless the artist is "Unknown". Should be the artist as credited on the pub, or the artist's canonical name.
 
−
|-
 
−
|'''Artist1Id''' ||The record number of the 1st cover artist, if known. Used to link to artist summary page via the record number when artist's name has characters (single quotes, non-ASCII) that cause linking by name to fail. In order for this field to work, the "Artist1" field also has to be filled in.  || Defaults to unused.
 
−
|-
 
−
|'''Artist2''' || The name of the 2nd cover artist. ||If omitted, defaults to "Unknown". Links to the artist's DB page unless the artist is "Unknown". Should be the artist as credited on the pub, or the artist's canonical name.
 
−
|-
 
−
|'''Artist2Id''' ||The record number of the 2nd cover artist, if known. Used to link to artist summary page via the record number when artist's name has characters (single quotes, non-ASCII) that cause linking by name to fail. In order for this field to work, the "Artist2" field also has to be filled in.  || Defaults to unused.
 
−
|-
 
−
|'''Source''' || Website where the image was obtained, or name or handle of user who scanned the image. May also include scanner resolution in dpi. || If omitted, defaults to "Unknown".
 
−
|-
 
−
|'''Side''' || should be "back" if this is a (rare) back-cover image, or "spine" for an image of the cover spine. Use "both" if both sides of a Dos-a-Dos book are included. || If omitted, defaults to "front". Can safely be ommitted for front covers.
 
−
|-
 
−
|'''AddRat''' || Additional rationale. Any text spelling out additional reasons why this image qualifies for fair use. || Defaults to blank. Should be ommitted unless there is an additional rationale to specify.
 
−
|-
 
−
|'''LowRes''' ||Should normally be "Yes", to indicate that this is a relatively low-res image. If the value is "Yes" a statement to this effect is displayed. If the value is "No", or if the parameter is omitted, a warning text will be displayed instead. Values other than "Yes" or "No" may cause the template to malfunction. || Defaults to "Yes", can be omitted for images under 600 pixels.
 
−
|-
 
−
 
 
−
|}
 
−
 
 
−
==Example==
 
−
For a usage example, see the [[:Template:Cover Image Data1-2/Example|example page]].
 
−
 
 
−
==Categories==
 
−
This template places all pages it is used on into [[:Category:Fair use images]] and [[:Category:Cover images]]. It will also place each page into a Publisher category, the names being derived from the Publisher parameter. It will also place each page into 3 Artist categories, one for each artist, and a joint works category. If the '''Pub''' parameter is not supplied, the image is also placed in [[:Category:Cover images without publication links]].
 

Latest revision as of 19:00, 6 April 2020

Redirect to:

Retrieved from "https://isfdb.org/wiki/index.php?title=Template:Cover_Image_Data1-2/Doc&oldid=577634"