Difference between revisions of "Template:Cover Image Data1-3/Doc"
DESiegel60 (talk | contribs) (→Parameter definitions: Id) |
(add ArtistIds) |
||
| Line 3: | Line 3: | ||
| − | Documentation for the template: '''[[:Template:Cover Image Data1- | + | Documentation for the template: '''[[:Template:Cover Image Data1-3|Cover Image Data1-3]]''' (transcluded from [[:Template:Cover Image Data1-3/Doc]] |
==Purpose== | ==Purpose== | ||
| Line 35: | Line 35: | ||
|Publisher=<Name of publisher> <br /> | |Publisher=<Name of publisher> <br /> | ||
|Artist1=<name of 1st cover artist> <br /> | |Artist1=<name of 1st cover artist> <br /> | ||
| + | |Artist1Id=<id of 1st cover artist> <br /> | ||
|Artist2=<name of 2nd cover artist> <br /> | |Artist2=<name of 2nd cover artist> <br /> | ||
| + | |Artist2Id=<id of 2nd cover artist> <br /> | ||
|Artist3=<name of 3rd cover artist> <br /> | |Artist3=<name of 3rd cover artist> <br /> | ||
| + | |Artist3Id=<id of 3rd cover artist> <br /> | ||
|CpyrtHolder=<name of the actual copyright holder> <br /> | |CpyrtHolder=<name of the actual copyright holder> <br /> | ||
|Source=<origin of image> <br /> | |Source=<origin of image> <br /> | ||
| Line 64: | Line 67: | ||
|- | |- | ||
|'''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. | |'''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 "Artist" 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. | |'''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 "Artist" field also has to be filled in. || Defaults to unused. | ||
|- | |- | ||
|'''Artist3''' || The name of the 3rd 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. | |'''Artist3''' || The name of the 3rd 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. | ||
| + | |- | ||
| + | |'''Artist3Id''' ||The record number of the 3rd 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 "Artist" 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". | |'''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". | ||
Revision as of 10:57, 8 April 2017
Documentation for the template: Cover Image Data1-3 (transcluded from Template:Cover Image Data1-3/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 3 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>
|Artist3=<name of 3rd 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>
|Artist1Id=<id of 1st cover artist>
|Artist2=<name of 2nd cover artist>
|Artist2Id=<id of 2nd cover artist>
|Artist3=<name of 3rd cover artist>
|Artist3Id=<id of 3rd 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. |
| 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 "Artist" 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 "Artist" field also has to be filled in. | Defaults to unused. |
| Artist3 | The name of the 3rd 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. |
| Artist3Id | The record number of the 3rd 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 "Artist" 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 omitted for front covers. |
| AddRat | Additional rationale. Any text spelling out additional reasons why this image qualifies for fair use. | Defaults to blank. Should be omitted 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 4 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.