Template:Art caption/doc
Description
This template is used to standardize and simplify the addition of image credits, whether used as a caption for an image thumbnail or article infobox, or used as in the image's description page on the File: namespace.
This template is designed to behave differently based on where it is used and what parameters are defined.
- When used in the File: namespace, it detects that a <ref> tag is not needed, so all of the content appears on one line, and the image's description page is automatically added to the artist's category under Category:Fan art.
- When used in other namespaces, {{art caption}} will generate a reference in the group "art".
- When the artist, source, or permission is missing, then an error message will generate and the page will be autocategorized as needing attention.
Dependencies
- Requires
{{Reflist|<group="art">}}
or<references group="art" />
to be included somewhere in the article when a reference is included. - Used within {{New artist category}}.
- The new artist category template contains a standardized format for File: page image descriptions. When used, those image descriptions are actually transcludable, meaning that instead of copy/pasting the art caption from an image page, you can just transclude the file page. Comparison example:
[[File:Example.jpg|thumb|left|250px|{{art caption|subject=an example image|artist=Leonardo da Vinci|source=http://www.google.com/}}]]
[[File:Example.jpg|thumb|left|250px|{{File:Example.jpg}}]]
Syntax
To create an art caption, paste this code where desired:
{{art caption |screenshot= |nofanart= |subject= |artist= |source= |more= |permission= |noref= }}
Parameters
- {{{screenshot}}}: Indicates whether the image is a screenshot, in which case the "Fan art of " phrase will be omitted, and permission will not be needed (under the assumption that the screenshot is a part of a larger work, used as "fair use" for illustrative purposes). Entering any value (such as "1" or "true", or even "0" or "false") will activate this setting.
- For screenshots, the {{{source}}} may include wikimarkup, such as an {{ep ref}}. End-of-sentence punctuation must be added manually, unless using {{ep ref}}, which includes a terminal period.
- Warning: If no artist is provided for a screenshot (since it is optional), then the template may confuse the unnamed parameter containing a source for the artist. To avoid this confusion, always use "source=" to specify which parameter contains the source information.
- {{{nofanart}}}: Indicates whether to omit the "Fan art of " phrase. Entering any value (such as "1" or "true", or even "0" or "false") will omit the fan art phrase, otherwise it is applied. This is useful in the case of photographs or official artwork, and any desired introductory text may then be added to {{{subject}}}.
- {{{screenshot}}}: Indicates whether to format the caption as a screenshot. Entering any value (such as "1" or "true", or even "0" or "false") will use the {{{subject}}} or {{{1}}} parameter only, and everything else will be omitted. No artist, source, or permission is needed.
- {{{subject}}}: The subject of the art, i.e., the name of the person or item, a description of the event, or the artist's title. Accepts wikilinks and other wikimarkup.
- {{{artist}}}: The name by which the artist wishes to be credited, or if not known, the artist's real name, or if not known, the artist's common username. Automatically links to the artist's category on this wiki.
- {{{source}}}: The URL for the page or post where the artist shared the work, preferring the original version or version most directly controlled by the artist.
- If the work was uploaded to the wiki by the artist, i.e. {{{permission}}} is set to "self-upload" (see below) and no URL is provided as the source, thus the wiki itself is the source of the image, the template will instead display "Work contributed to the Critical Role Wiki by the artist." to indicate that the wiki is the source. Providing a URL takes precedence over this language and will override this.
- {{{more}}}: Any additional information, which will be omitted from the caption but included in the reference. However, if the reference is omitted due to {{{noref}}} being defined, then {{{more}}} will be displayed in the caption.
- {{{permission}}}: The URL evidence of the artist granting permission for the piece to be used on this wiki.
- If an artist has granted blanket permission, then do not include {{{permission}}}. This template will automatically collect the permission from the artist's category page, where the URL will be surrounded in "onlyinclude" tags: <onlyinclude>http://www.artistpermission.url</onlyinclude>
- The {{{permission}}} parameter will override the category-based blanket permission.
- Setting {{{permission}}} as "self-upload", in the case where an artist uploaded the image to the wiki themselves, will replace the usual permissions language with "Work contributed to the Critical Role Wiki by the artist." This will override the category-based blanket permission.
- {{{noref}}}: Indicates whether to omit a reference. Entering any value (such as "1" or "true", or even "0" or "false") will omit the ref tag, otherwise it is applied. On a [[File:Example.jpg]] page, {{{noref}}} forces to true, which allows the image's page to be transcluded into other articles with full {{art caption}} functionality.
Using Unnamed Parameters
For convenience, this template will substitute unnamed parameters for {{{subject}}}, {{{artist}}}, or {{{source}}}, in that order. For example:
- If {{{subject}}}, {{{artist}}}, and {{{source}}} are all three omitted, but unnamed parameters {{{1}}}, {{{2}}}, and {{{3}}} are used, then subject=1, artist=2, and source=3.
- If {{{subject}}} and {{{artist}}} are defined but {{{source}}} is not, then source=1.
Examples
Basic Fan Art Caption
Standard usage as a caption on an article:
{{art caption |[[Gern Blanston]] |Jessica Huegel (@Cryptobaffling) |https://twitter.com/Cryptobaffling/status/713249821105254400 }}
- ...produces...
Fan art of Gern Blanston, by Jessica Huegel (@Cryptobaffling).[art 1] References:
- ↑ Fan art of Gern Blanston, by Jessica Huegel (@Cryptobaffling) (source). Permission needed.
Image Page Description
This template can be used as the description on an image's description page, like this:
{{art caption |[[Gern Blanston]] |Jessica Huegel (@Cryptobaffling) |https://twitter.com/Cryptobaffling/status/713249821105254400 }}
- ...produces...
Official Art, Photos, and Otherwise Not Fan Art
This template can be used for images that are not fan art, such as photographs:
{{art caption |nofanart=true |Photograph of the contract from {{ep|1x18}} |Taliesin Jaffe |https://www.instagram.com/p/6WLmjXw15A/ |more=Contract written by [[Matthew Mercer]] and "signed" by the player characters. }}
- ...produces...
Photograph of the contract from "Risky Business" (1x18), by Taliesin Jaffe.[art 1] References:
- ↑ Photograph of the contract from "Risky Business" (1x18), by Taliesin Jaffe (source). Contract written by Matthew Mercer and "signed" by the player characters. Permission needed.
Screenshot
Captioning a screenshot is much like non-fan art, but it does not require an artist or permission:
{{art caption |screenshot=true |Screenshot of [[Laura Bailey]] as she activates [[Death from Above]]}} |source={{ep time|ep=47|0:40:51}} }}
- ...produces...
Screenshot of Laura Bailey as she activates Death from Above.[art 1] References:
- ↑ Screenshot of Laura Bailey as she activates Death from Above.See Template:Ep time.
Missing Source: Citation Needed
If no source is given, this template automatically includes the {{cite}} template:
{{art caption |[[Gern Blanston]] |Jessica Huegel (@Cryptobaffling) }}
- ...produces...
Permission Needed
If permission is not detected on the artist's category page, and if {{{permission}}} does not provide a URL, then a note will display that permission is needed:
{{art caption |[[Gern Blanston]] |Random Name Without Permission |https://twitter.com/Cryptobaffling/status/713249821105254400 |noref=true }}
- ...produces...