Template:Cite comic/doc

The cite comic template generates a citation for a comic book, web comic, or comic strip in a consistent and legible manner. As with other citation templates, this template can be used either in a footnote (between  tags) or in a section that lists sources.

Usage
This section covers the most commonly used parameters. You can copy an example below and then add in extra parameters from the full list. Use the "|" (pipe) character between each parameter. Unused parameters may be deleted to avoid clutter in the edit window. Spacing and ordering of the parameters within the template is irrelevant and does not affect the final, rendered text. Piped wikilinks are acceptable. Only one of  or   can be used, and will affect how the template renders; see below for examples.

Examples
This template allows for the full citation of comics. When given only the required information, it will not look much different from the typical templates:



Comics have more complex authorship than most written works. This template allows credits to be assigned based on role. These roles are typically listed in the indicia inside the front cover. See below for examples:

Work with one author
For example, the first issue of Bone:



Comic book with multiple authors
For example, citing the second panel of the third page of The Fantastic Four issue 1:



Story in a multi story issue
For example, the first chapter of Zenith:



Story arc in a series
For example, The Death of Gwen Stacy from The Amazing Spider-Man:



Collection of a story arc
In some instances, where storylines span separate titles it is usually better to cite the collection if one exists, for example "The Death of Superman":



Column in a comic book
For example, to cite one of Mark Gruenwald's Mark's Remarks columns:



Graphic novel or trade paperback
For example, the trade paperback collection of Watchmen:



Authors

 * cartoonist: Use this field for a work with only one creator, for example, Bone by Jeff Smith. Use a piped link to display the author in citation style,  .  Example,.
 * writer: On a collaborative work, use this field to enter the writer's name, again in piped form so that it displays the author in citation style, .  Example,.
 * cowriters: When citing a story arc that has multiple creators, perhaps due to crossing over into other titles, or being a collection of such a story arc, use this tag to identify up to two more writers. They should be entered in normal style,   rather than citation style, for example , not  .  If more than three writers in total contributed to the work, identify three, one using the writer tag, two using this tag, and follow with the phrase et al, as follows:.
 * artist: On a collaborative work, use this field to enter the artist's name, where the artist has provided both the pencilling and the inking, again in piped form so that it displays the author in citation style, .  Example,.
 * coartists: When citing a story arc that has multiple creators, perhaps due to crossing over into other titles, or being a collection of such a story arc, use this tag to identify up to two more artists. They should be entered in normal style,   rather than citation style, for example , not  .  If more than three artists in total contributed to the work, identify three, one using the artist tag, two using this tag, and follow with the phrase et al, as follows:.
 * OR: penciller: On a collaborative work, use this field to enter the penciller's name, again in piped form so that it displays the author in citation style, . (This field is ignored if the artist field is used.)  Example,.
 * copencillers: When citing a story arc that has multiple creators, perhaps due to crossing over into other titles, or being a collection of such a story arc, use this tag to identify up to two more pencillers. They should be entered in normal style,   rather than citation style, for example , not  .  If more than three pencillers in total contributed to the work, identify three, one using the penciller tag, two using this tag, and follow with the phrase et al, as follows:.
 * OR: inker: On a collaborative work, use this field to enter the inker's name, again in piped form so that it displays the author in citation style, . (This field is ignored if the artist field is used.) Example,
 * coinkers: When citing a story arc that has multiple creators, perhaps due to crossing over into other titles, or being a collection of such a story arc, use this tag to identify up to two more inkers. They should be entered in normal style,   rather than citation style, for example , not  .  If more than three inkers in total contributed to the work, identify three, one using the inker tag, two using this tag, and follow with the phrase et al, as follows:.
 * colorist: On a color work, use this field to enter the colorists's name, again in piped form so that it displays the colorist in citation style, .  Example,  . If the colorist is a company enter their name, using piped form as required. Example,
 * letterer: Use this field to enter the letterer name, again in piped form so that it displays the letterer in citation style, .  Example,  . If the letterer is a company enter their name, using piped form as required. Example,
 * editor: Use this field to enter the editor's name, again in piped form so that it displays the editor in citation style, .  Example,.
 * others: Use this field for other credits, again in piped form so that it displays the contributor in citation style, . Optionally add roles within parentheses. Example,

Title

 * story: The title of the individual story within the comic; analogous to the title parameter in cite news or cite web. Example:  . Pipe only if we have an article, and do not pipe if the url field is used. Displays in quotation marks.
 * title: Title of the comic. Title or strip is required. Either 'strip' or 'title' must be filled out but not both; this will affect how other parameters are displayed. This may be linked in piped form unless a url is entered and the story field is not used. For example:.
 * strip: The title of a comic strip. This will override the  parameter. Either 'strip' or 'title' must be filled out but not both; this will affect how other parameters are displayed. The paper and supplement parameters are only used if this parameter is set.  Example:  . This is a required parameter for comic strips.
 * paper: Title of the newspaper, magazine, or periodical; for example . (Only used if the strip parameter is set.) In the case of a webcomic the website where the strip was published, also giving the url, for example  . Alias: newspaper
 * supplement: If a comic strip was published in a supplement to a newspaper, the name or nature of the supplement should be given. (Only used if the strip paramter is set.)
 * syndicate: The syndicator of a comic strip. (If the strip parameter is not used, this will be treated as an alias of .)  Use name of company at time of publication. This is a required parameter for comic strips.
 * language: Use a valid ISO-639 language code (e.g. ) or a valid IETF language tag. English  is not rendered. Refer to the List of ISO 639-2 codes.

Date

 * date:  (US),   (non-US). Full date of publication, found in the indicia. Also known as the "cover date". This is a required parameter.

Publisher

 * publisher: Name of publisher; may be wikilinked if relevant. The publisher is the company, organization or other legal entity that publishes the work being cited. Use name of company at time of publication. (Use  for syndicated comic strips.)
 * location: Geographical place of publication; generally not wikilinked; omit when the name of the newspaper, magazine, or periodical includes the publication place, for example, The Boston Globe, The Times of India. For example:

URL

 * url: the url of any web-based comic. Note this field will turn either the story field or the title field into an external link, so it is important not to wikilink those fields using piping when using the url field. Note: Wikipedia does not link to sites which violate the copyrights of others. Linking to websites that display copyrighted works is acceptable as long as the website has licensed the work. See guidance for more details.
 * access-date: Full date when the content pointed to by url was last verified to support the text in the article; do not wikilink; requires url; use the same format as other access and archive dates in the citations. Not required for linked documents that do not change. For example, access-date is required for online sources, such as personal websites, that do not have a publication date; see WP:CITEWEB. Access dates are not required for links to published research papers or published books. Note that access-date is the date that the URL was found to be working and to support the text being cited.
 * archive-url: The URL of an archived snapshot of a web page. Typically used to refer to services such as Internet Archive (see Using the Wayback Machine) and archive.today (see Help:Using archive.today); requires archive-date and url. By default (overridden by ) the archived link is displayed first, with the original link at the end.
 * archive-date: Archive-service snapshot-date; preceded in display by default text "archived from the original on".
 * url-status: the  parameter should only be included if an |archive-url= is set (dead links without an archive URL can be marked with dead link). If   is omitted, or is specified with a null value, the default value is  . When the URL is still live, but pre-emptively archived, then set  ; this changes the display order, with the title retaining the original link and the archive linked at the end.
 * format: the format of the url. Do not enter HTML as this is the default. Example,.

Volume, issue

 * volume: Volume number of a comic book series if given.
 * issue: Issue number of a comic book.

In-source locations

 * page: First page, and optional last page. If pages are not identified, count from first page, ignoring covers and adverts, and place the number in square brackets. Examples: ,  ,  ,  ,  ,
 * OR: pages: A range of pages in the source that supports the content. Use either  or , but not both. When both are used, the template will only display the   value. A page range will use the "pp." prefix and convert hypens to en dashes. To preserve a hyphen in a page range, use the hyphen template.
 * OR: at: For sources where a page number is inappropriate or insufficient. Overridden by  or  . Use only one of ,  , or  . Examples: page (p.) or pages (pp.); section (sec.), column (col.), paragraph (para.); front cover, indicia, dust jacket; fold-out.
 * panel: Panel number, if referencing a specific panel. Panels should be identified by counting left to right, top to bottom for American and European works, and right to left, top to bottom for Japanese and other foreign language works where appropriate.

Anchors

 * ref: ID for anchor. The value for this field will usually be an sfnref or harvid template. By default, no anchor is generated. The ordinary nonempty value ID generates an anchor with the given ID ; such a linkable reference can be made the target of wikilinks to full references, especially useful in short citations like shortened notes and parenthetical referencing.

Identifiers

 * id: Use this field to enter an ISBN or ISSN if known, in the form  (don't link it – the MediaWiki software will do that for you) or.

Quote

 * quote: Relevant text quoted from the source. Displays enclosed in quotes. When supplied, the citation terminator (a period by default) is suppressed, so the quote must include terminating punctuation.

Error messages
Cite comic will generate a preview warning if it used without a title, without a date, or with unknown parameters.

Tracking categories

 * Category:Pages using cite comic with unknown parameters
 * Category:Pages using cite comic with no date
 * Category:Pages using cite comic with no title

Template data
{	"description": "This template generates a citation for a comic book, web comic, or comic strip.", "params": { "date": { "label": "Date", "description": "Full date of publication, also known as the 'cover date'.", "example": "January 1, 2006", "type": "date", "required": true, "aliases": [ "Date", "year" ]		},		"title": { "label": "Series title", "description": "Title of the comic series; will display in italics. Use 'story' for the titles of individual releases. Either 'strip' or 'title' must be filled out but not both; this will affect how other parameters are displayed.", "suggested": true, "aliases": [ "Title" ],			"type": "string" },		"story": { "label": "Story title", "description": "The title of the story within the comic book; will display in quotation marks. Pipe only if we have an article, and do not pipe if the url field is used.", "example": "Fall of the Mutants", "aliases": [ "Story" ],			"suggested": true, "type": "string" },		"strip": { "label": "Strip", "description": "Title of a comic strip. Either 'strip' or 'title' must be filled out but not both; this will affect how other parameters are displayed.", "example": "Peanuts", "aliases": [ "Strip" ],			"type": "string" },		"url": { "label": "URL", "description": "The URL of any web-based comic.", "type": "url" },		"access-date": { "label": "Access date", "description": "Used with URL, the full date when the original URL was accessed; do not wikilink.", "aliases": [ "accessdate" ],			"type": "date" },		"format": { "label": "Format", "description": "The format of the URL.", "example": "PDF", "default": "HTML", "type": "string" },		"publisher": { "label": "Publisher or Syndicate", "description": "Name of the publisher, or for a comic strip, the syndicator; may be wikilinked. Use name of company at time of publication.", "suggested": true, "aliases": [ "Publisher", "Syndicate", "syndicate" ],			"type": "string" },		"location": { "label": "Location", "description": "Place of publication; generally not wikilinked.", "example": "London, England", "aliases": [ "Location" ],			"type": "string" },		"paper": { "label": "Newspaper", "description": "Title of the newspaper or magazine where a comic strip was published. In the case of a webcomic use the website where the strip was published, also giving the url, for example Keenspot.", "example": "Keenspot", "type": "content", "aliases": [ "Paper", "newspaper" ]		},		"supplement": { "label": "Supplement", "description": "If a comic strip was published in a supplement to the newspaper, the name or nature of the supplement", "aliases": [ "Supplement" ],			"type": "string" },		"writer": { "label": "Writer", "description": "Writer's name; used for a work with separate writer(s) and artist(s). Enter in piped form so that it displays the author in citation style, Last, First", "example": "Falk, Lee", "type": "string", "aliases": [ "Writer" ],			"suggested": true },		"cowriters": { "label": "Cowriters", "description": "When citing a comic with multiple writers, or when citing an entire run that includes multiple writers, use this tag to identify up to two more writers. They should be entered in normal style, First name Last name rather than citation style, for example Mark Schultz, not Schultz, Mark. If more than three writers in total contributed to the work, identify three, one using the writer tag, two using this tag, and follow with the phrase 'et al'.", "example": "Mark Schultz, Cullen Murphy et al", "type": "content", "aliases": [ "Cowriters" ]		},		"artist": { "label": "Artist", "description": "Artist's name; used for a work with separate writer(s) and artist(s). Enter in piped form so that it displays the artist in citation style, Last, First", "example": "Moore, Ray", "type": "string", "aliases": [ "Artist" ],			"suggested": true },		"coartists": { "label": "Coartists", "description": "When citing a comic with multiple artists, or when citing an entire run that includes multiple artists, use this tag to identify up to two more artists. They should be entered in normal style, First name Last name rather than citation style, for example Brant Parker, not Parker, Brant. If more than three pencillers contributed to the work, identify one using the penciller tag, two using this tag, and follow with the phrase 'et al'.", "example": "Brant Parker, Johnny Hart et al", "type": "content", "aliases": [ "Coartists" ]		},		"penciller": { "label": "Penciller", "description": "Penciller's name; used for a work with separate artists for inking, penciling, or coloring. Enter in piped form so that it displays the artist in citation style, Last, First", "example": "Kirby, Jack", "aliases": [ "Penciller" ],			"type": "string", "suggested": true },		"copencillers": { "label": "Copencillers", "description": "On a collaborative work, that has multiple creators, use this tag to identify up to two more pencillers. They should be entered in normal style, First name Last name rather than citation style, for example John Byrne, not Byrne, John. If more than three pencillers in total contributed to the work, identify one using the penciller tag, two using this tag, and follow with the phrase 'et al'.", "example": "John Byrne, Walt Simonson et al", "aliases": [ "Copencillers" ],			"type": "content" },		"inker": { "label": "Inker", "description": "Inker's name; used for a work with separate artists for inking, penciling, or coloring. Enter in piped form so that it displays the artist in citation style, Last, First", "example": "Sinnott, Joe", "aliases": [ "Inker" ],			"type": "string", "suggested": true },		"coinkers": { "label": "Coinkers", "description": "When citing a work that has multiple creators, use this tag to identify up to two more inkers. They should be entered in normal style, First name Last name rather than citation style, for example Joe Sinnott, not Sinnott, Joe. If more than three inkers in total contributed to the work, identify three, one using the inker tag, two using this tag, and follow with the phrase 'et al'.", "example": "Joe Sinnot, Terry Austin et al", "aliases": [ "Coinkers" ],			"type": "content" },		"colorist": { "label": "Colorist", "description": "Colorist's name or colorist company's name; used for a work with separate artists for inking, penciling, or coloring. Enter in piped form so that it displays the artist in citation style, Last, First", "example": "Wood, Tatjana", "aliases": [ "Colorist" ],			"type": "string" },		"letterer": { "label": "Letterer", "description": "Letterer's name or letterer company's name. Enter in piped form so that it displays the artist in citation style, Last, First", "example": "Constanza, John", "aliases": [ "Letterer" ],			"type": "string" },		"editor": { "label": "Editor", "description": "Use this field to enter the editor's name, again in piped form so that it displays the editor in citation style", "example": "Schwartz, Julius", "aliases": [ "Editor" ],			"type": "string" },		"volume": { "label": "Volume", "description": "Volume number of the comic book series if given.", "aliases": [ "Volume" ],			"type": "number" },		"issue": { "label": "Issue", "description": "Issue number of the comic book.", "aliases": [ "Issue" ],			"suggested": true, "type": "number" },		"page": { "label": "Page", "description": "Page in the source that supports the content; displays after 'p.' If pages are not identified, count from first page, ignoring covers, and place the number in square brackets", "example": "45", "aliases": [ "Page" ],			"type": "string" },		"pages": { "label": "Pages", "description": "Pages in the source that support the content (not an indication of the number of pages in the source); displays after 'pp.'", "aliases": [ "Pages" ],			"type": "string" },		"at": { "label": "At", "description": "May be used instead of 'page' or 'pages' where a page number is inappropriate or insufficient", "type": "string" },		"panel": { "label": "Panel", "description": "Panel number, if referencing a specific panel. Panels should be identified by counting left to right, and top to bottom where necessary.", "aliases": [ "Panel" ],			"type": "number" },		"id": { "label": "ID", "description": "Use this field to enter an ISBN if known", "example": "ISBN 0198749872", "aliases": [ "ID" ]		},		"archive-url": { "label": "Archive URL", "description": "The URL of an archived copy, if or in case the URL becomes unavailable; requires 'archive-date'", "type": "url" },		"archive-date": { "label": "Archive date", "description": "Date when the original URL was archived; do not wikilink", "type": "date" },		"url-status": { "label": "URL status", "description": "If set to 'live', the title/strip display is adjusted; useful for when the URL is archived preemptively but still live. Set to \"dead\" for broken links.", "example": "'dead' or 'live'", "default": "'dead' if an Archive URL is entered", "suggestedvalues": [ "dead", "live" ]		},		"quote": { "label": "Quote", "description": "Relevant text quoted from the source; displays last, enclosed in quotes; must include terminating punctuation", "type": "content" },		"ref": { "label": "Ref", "description": "ID for anchor; used with shortened footnotes", "example": "", "type": "string", "suggestedvalues": [ ""			]		},		"language": { "label": "Language", "description": "The language in which the source is written, if not English. Use a 2-letter ISO-639 language code, or if necessary, a 3-letter ISO 639-3 code. Do not use icons or templates; use only one language code.", "aliases": [ "Language" ],			"type": "string" },		"creator": { "aliases": [ "Cartoonist", "cartoonist" ],			"label": "Cartoonist (creator)", "description": "Used for a work with only one creator. Enter in piped form so that it displays the author in citation style, Last, First", "example": "Schulz, Charles", "type": "string", "suggested": true },		"others": { "label": "Other credits", "description": "Use this field to enter the other credits, again in piped form so that it displays the editor in citation style. Optionally add roles within parentheses.", "example": "Gaudiano, Stefano (translator)", "type": "string" }	},	"paramOrder": [ "date", "title", "strip", "story", "issue", "volume", "publisher", "location", "paper", "supplement", "url", "access-date", "format", "creator", "writer", "cowriters", "artist", "coartists", "penciller", "copencillers", "inker", "coinkers", "colorist", "letterer", "editor", "others", "page", "pages", "at", "panel", "id", "archive-url", "archive-date", "url-status", "quote", "ref", "language" ],	"maps": { "citoid": { "title": "story", "url": "url", "publisher": "publisher", "date": "date", "accessDate": "access-date", "location": "location", "ISSN": "id", "ISBN": "id", "pages": "pages", "volume": "volume", "series": "title", "publicationTitle": "title", "bookTitle": "title", "seriesTitle": "title", "issue": "issue", "editor": "editor" }		},	"format": "" }