Template:Cover Image Data1-2/Doc

From ISFDB
Jump to navigation Jump to search


Documentation for the template: 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 {{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:

{{Cover Image Data
|Title=<publication title>
|Edition=<date and/or publisher>
|Pub=<the publication record number or tag>
|Publisher=<Name of publisher>
|Artist1=<name of 1st cover artist>
|Artist2=<name of 2nd cover artist>
|Source=<origin of image>
}}

A maximal call, including all parameters, would be:

{{Cover Image Data
|Title=<publication title>
|Edition=<date and/or publisher>
|Pub=<the publication record number or tag>
|Publisher=<Name of publisher>
|Artist1=<name of 1st cover artist>
|Artist2=<name of 2nd cover artist>
|CpyrtHolder=<name of the actual copyright holder>
|Source=<origin of image>
|Side=<back or front or spine>
|AddRat=<Additional fair use rationale>
|LowRes=<Yes or No>
}}

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.

Note: In all the above examples, when a parameter is shown in angle brackets, like:

<Parameter>

then the parameter, and the angle brackets, should be replaced by the value of the parameter. For example: Title=<TITLE> should become Title=The Name of the Book (or whatever the name might be).

Parameter definitions

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