Mal:Citation Style documentation/dok

Usage

This template is used to build consistent documentation pages for CS1 templates.

For example: {{Citation Style documentation|author}} will show the author documentation.

Where a particular section of documentation is not appropriate for a certain template, simply add the text manually or create a new subtemplate.

Each module of text is a subtemplate that can be edited using the link.

Parameters

syntax

Nested parameters rely on their parent parameters:

• parent
• OR: parent2—may be used instead of parent
  • child—may be used with parent (and is ignored if parent is not used)
  • OR: child2—may be used instead of child (and is ignored if parent2 is not used)

Where aliases are listed, only one of the parameters may be defined; if aliased parameters are defined, then only one will show.

coins

This template embeds COinS metadata in the HTML output, allowing reference management software to retrieve bibliographic metadata; see Wikipedia:COinS.

• Be careful using templates within the citation template, as many will add a lot of extraneous HTML or CSS that will be rendered in the meta-data.
  • Known templates that should not be used: {{smallcaps}}.

sep_period

By default, sets of fields are terminated with a period (.); this can be an issue when the last field in an abbreviation or initial with a period, as two periods then display. The only solution is to not include the last period in the value for the set of fields.

sep_comma

By default, sets of fields are terminated with a comma (,).

required

This parameter is required and will generate an error if not defined. On errors, main, help and template pages are placed into Category:Articles with incorrect citation syntax. Set |template doc demo=true to disable categorization; mainly used for documentation where the error is demonstrated.

author

• last: Surname of author. Do not wikilink—use authorlink instead. Where the surname is usually written first—as in Chinese—or for corporate authors, simply use last to include the same format as the source.
  • first: Given or first names of author, including title(s); for example: Firstname Middlename or Firstname M. or Dr. Firstname M., Sr. Do not wikilink—use authorlink instead.
  • OR: for multiple authors, use first1, last1 through first9, last9 for up to nine authors. By default, if nine authors are defined, then only eight will show and "et al." will show in place of the last author.

• authorlink: Title of existing Wikipedia article about the author—not the author's website; do not wikilink.
• OR: for multiple authors, use authorlink1 through authorlink9.

Aliases: last, last1, author, authors; last1, author1 through last9, author9

When using Mal:Sfnote or Mal:Paren styles with templates, do not use multiple names in one parameter else the anchor will not match the inline link.

coauthors

• coauthors: Names of of coauthors. Use the same format as the authors.

When using Mal:Sfnote or Mal:Paren styles with templates, do not use this parameter else the anchor will not match the inline link.

editor

• editor-last: Surname of editor. Do not wikilink—use editor-link instead. Where the surname is usually written first—as in Chinese—or for corporate authors, simply use editor-last to include the same format as the source.
  • editor-first: Given or first names of editor, including title(s); example: Firstname Middlename or Firstname M. or Dr. Firstname M., Sr. Do not wikilink—use editor-link instead.
  • OR: for multiple editors, use editor1-first, editor1-last through editor4-first, editor4-last for up to four editors.

• editor-link: Title of existing Wikipedia article about the editor—not the editor's website; do not wikilink.
• OR: for multiple editors, use editor1-link through editor4-link.

Format:

If authors: Authors are first, followed by the included work, then "In" and the editors, then the main work.

If no authors: Editors appear before the included work; a single editor is followed by "ed."; multiple editors are followed by "eds."; more than three editors will be followed by "et al., eds.".

others

• others: To record other contributors to the work, such as "Illustrated by Smith" or "Trans. Smith".

title_italics

• title: Title of source. Can be wikilinked to an existing Wikipedia article or url may be used to add an external link, but not both. Formatted in italics.
  • trans_title: If the source cited is in a foreign language, an English translation of the title can be given here. The template will display this in square brackets after the title field and it will link to the url field, if used. Use of the language parameter is recommended.

Titles containing certain characters will display and link incorrectly unless those characters are encoded.

newline	[	]	|
space	[	]	|

title_quotes

• title: Title of source. Can be wikilinked to an existing Wikipedia article or url may be used to add an external link, but not both. Formatted in quotes.
  • trans_title: If the source cited is in a foreign language, an English translation of the title can be given here. The template will display this in square brackets after the title field and it will link to the url field, if used. Use of the language parameter is recommended.

Titles containing certain characters will display and link incorrectly unless those characters are encoded.

newline	[	]	|
space	[	]	|

encyclopedia

• encyclopedia: Title of source. Can be wikilinked to an existing Wikipedia article or url may be used to add an external link, but not both. Formatted in italics.
  • trans_title: If the source cited is in a foreign language, an English translation of the title can be given here. The template will display this in square brackets after the encyclopedia field and it will link to the url field, if used. Use of the language parameter is recommended.

Titles containing certain characters will display and link incorrectly unless those characters are encoded.

newline	[	]	|
space	[	]	|

work

• work: Title of website; can be wikilinked to an existing Wikipedia article or url may be used to add an external link, but not both; formatted in italics.
  • trans_title: If the source cited is in a foreign language, an English translation of the title can be given here. The template will display this in square brackets after the work field and it will link to the url field, if used. Use of the language parameter is recommended.
• title: Title of web page; formatted in quotes.

Titles containing certain characters will display and link incorrectly unless those characters are encoded.

newline	[	]	|
space	[	]	|

chapter

• chapter: The chapter title or the title of the shorter work within the source, written in full. May be wikilinked or may use chapter-url, but not both. Formatted in quotations.
  • trans_chapter: If the source cited is in a foreign language, an English translation of the chapter can be given here. The template will display this in square brackets after the chapter field and it will link to the chapter-url field, if used. Use of the language parameter is recommended.

type

• type: Provides additional information about the media type of the source; format in sentence case; appears in parentheses following the title; examples: Thesis, Booklet, CD liner; Press release.

Options for this display:

• type_default: Adds: "Defaults to type_default"

journal

• work: Name of the periodical; formatted in italics; aliases: work, journal, periodical, magazine
  • issue: When the publication is one of a series that is published periodically.

When set, work changes the formatting of other parameters:

title is not italicized and is enclosed in quotes.

chapter is italicized and is not enclosed in quotes.

location and publisher are enclosed in parentheses.

page and pages do not show p. or pp.

edition does not show.

edition

• edition: When the publication has more than one edition; for example: "2nd", "Revised" etc. Displays " ed." after this field, so |edition=2nd produces "2nd ed."

series

• series or version: When the source is part of a series, such as a book series or a journal where the issue numbering has restarted.

series_episode

• series: The name of the series the episode belongs to; may be wikilinked.

event

• event: Event where the speech was given.

agency

• agency: The news agency (wire service) that provided the content; examples: Associated Press, Reuters, Agence France-Presse.

volume

• volume: For one publication published in several volumes; displayed in bold after the title and series fields; if bolding is not desired, then include the volume information in the title field.

date

• date: Full date of source being referenced; in same format as other dates in the article; do not wikilink. The date is placed after the authors and in parentheses; if there is no author, then the date is placed after the publisher.
• OR: year: Year of source being referenced.
  • month: Name of the month of publication. If you also have the day, use date instead; do not wikilink.
  • origyear: Original publication year; displayed after the date or year. For clarity, please supply specifics; example: |origyear=First published 1859 or |origyear=Composed 1904.

publisher

• publisher: Name of publisher; corporate designations such as "Ltd" or "Inc" are not usually included; may be wikilinked if relevant.
  • location: Geographical place of publication; generally not wikilinked.
  • publication-date: Date of publication; in same format as other dates in the article; do not wikilink.

publisher_periodical

• publisher: Name of publisher; corporate designations such as "Ltd" or "Inc" are not usually included; may be wikilinked if relevant; formatted in parentheses with location.
  • location: Geographical place of publication; generally not wikilinked.
• publication-date: Date of publication, if different from date written; shows only if year or date are defined and only if different; use the same format as other dates in the article; do not wikilink.

newsgroup

• newsgroup: Name of newsgroup; a link is automatically created; do not wikilink.

language

• language: The language the source is written in, if not English. Formatted in parentheses with "in" before the language name. Use the full language name; do not use icons or templates.

pages

• page: Page in the source that supports the content; preceded with p. unless |nopp=y.
• OR: pages: Pages in the source that supports the content; separate page ranges with an en dash (–); separate non-sequential pages with a comma (,); do not use to indicate the total number of pages in the source; preceded with pp. unless |nopp=y.
  • nopp: Set to y to suppress the p. or pp. notations where this is inappropriate; for example, where |page=Front cover.
• OR: at: For sources where a page number is inappropriate or insufficient; overridden by |page= or |pages=.

Examples: page (p.) or pages (pp.); section (sec.), column (col.), paragraph (para.); track; hours, minutes and seconds; act, scene, canto, book, part, folio, stanza, back cover, liner notes, indicia, colophon, dust jacket, verse.

pages_periodical

• page: Page in the source that supports the content; preceded with p. unless |nopp=y or journal, periodical, magazine or para are defined.
• OR: pages: Pages in the source that supports the content; separate page ranges with an en dash (–); separate non-sequential pages with a comma (,); do not use to indicate the total number of pages in the source; preceded with pp. unless |nopp=y or journal, periodical, magazine or para are defined.
  • nopp: Set to y to suppress the p. or pp. notations where this is inappropriate; for example, where |page=Front cover.
• OR: at: For sources where a page number is inappropriate or insufficient; overridden by |page= or |pages=.

Examples: page (p.) or pages (pp.); section (sec.), column (col.), paragraph (para.); track; hours, minutes and seconds; act, scene, canto, book, part, folio, stanza, back cover, liner notes, indicia, colophon, dust jacket, verse.

time

• minutes: Time the event occurs in the source; followed by "minutes in".
• OR: time: Time the event occurs in the source; preceded by default text "Event occurs at time".
  • timecaption: Set the text before time.

id1

• id: A unique identifier, used where none of the specialized identifiers are applicable; wikilink or use a template as applicable.

id2

• arxiv: ArXiv; do not wikilink.
• asin: Amazon Standard Identification Number; do not wikilink.
  • asin-tld: ASIN top-level domain for Amazon sites other than the US; valid values: co.jp, co.uk, ca, cn, fr, de, it, es
• bibcode: Bibcode; used by a number of astronomical data systems; example: 1924MNRAS..84..308E; do not wikilink.
• doi: Digital object identifier; example: 10.1038/news070508-7; do not wikilink; checked to ensure it begins with 10.; if not an error shows and the page is placed in Category:Pages with DOI errors.
  • doi_brokendate: Date the DOI is broken; use the same format as other dates in the article; do not wikilink.
• isbn: International Standard Book Number such as 978-0812695939; see Wikipedia:ISBN and ISBN. Dashes in the ISBN are optional, but preferred. Use the 13-digit ISBN where possible; this can normally be found beneath the barcode as a number beginning 978 or 979. For sources with the older 9 digit SBN system, prefix the number with a zero; thus SBN 812695-93-3 should be entered as |isbn=0812695-93-3; do not wikilink.
• issn: International Standard Serial Number; eight characters may be split into two groups of four using a hyphen, but not an N-dash or a space; do not wikilink.
• jfm: Jahrbuch über die Fortschritte der Mathematik; do not wikilink.
• jstor: JSTOR; mainly for use as part of an id option in a {{cite journal}} reference; do not wikilink.
• lccn: Library of Congress Control Number; do not wikilink.
• mr: Mathematical Reviews; do not wikilink.
• oclc: Online Computer Library Center; do not wikilink.
• ol: Open Library; do not wikilink.
• osti: Office of Scientific and Technical Information; do not wikilink.
• pmc: PubMed Central article number for full-text free repository of an article; do not wikilink.
• pmid: PubMed Unique Identifier; do not wikilink.
• rfc: Request for Comments; do not wikilink.
• ssrn: Social Science Research Network; do not wikilink.
• zbl: Zentralblatt MATH; do not wikilink.

url

• url: URL of an online location where the text of the publication can be found. Cannot be used if title is wikilinked. If applicable, the link may point to the specific page(s) referenced. Do not link to any commercial booksellers such as Amazon.com; see WP:PAGELINKS.
  • accessdate: Full date when URL was accessed; use the same format as other dates in the article; do not wikilink.
  • archiveurl: The URL of an archived copy of a web page, if or in case the url becomes unavailable. Typically used to refer to services like WebCite and the Internet Archive; requires archivedate.
    • archivedate: Date when the item was archived; use the same format as other dates in the article; do not wikilink; requires archiveurl.
    • deadurl: To change the order with the title retaining the original link and the archive linked at the end, set |deadurl=no.
  • template doc demo: The archive parameters have error checking to ensure that all the required parameters are included, else {{citation error}} is invoked. On errors, main, help and template pages are placed into Category:Articles with incorrect citation syntax. Set |template doc demo=true to disable categorization; mainly used for documentation where the error is demonstrated.
• format: Format of the work referred to by url; examples: PDF, DOC, XLS; HTML is implied and should not be specified; displayed in parentheses after title.

url_periodical

• url: URL of an online location where the text of the publication can be found. Cannot be used if title is wikilinked. If applicable, the link may point to the specific page(s) referenced. Do not link to any commercial booksellers such as Amazon.com; see WP:BOOKLINKS. If url is not defined but pmc is, then url is set to the pmc link.
  • Embargo: Date that pmc goes live; if this is in the future, then then url is not set to the pmc link until that date.
  • accessdate: Full date when URL was accessed; use the same format as other dates in the article; do not wikilink.
  • archiveurl: The URL of an archived copy of a web page, if or in case the url becomes unavailable. Typically used to refer to services like WebCite and the Internet Archive; requires archivedate.
    • archivedate: Date when the item was archived; use the same format as other dates in the article; do not wikilink; requires archiveurl.
    • deadurl: To change the order with the title retaining the original link and the archive linked at the end, set |deadurl=no.
  • template doc demo: The archive parameters have error checking to ensure that all the required parameters are included, else {{citation error}} is invoked. On errors, main, help and template pages are placed into Category:Articles with incorrect citation syntax. Set |template doc demo=true to disable categorization; mainly used for documentation where the error is demonstrated.
• format: Format of the work referred to by url; examples: PDF, DOC, XLS; HTML is implied and should not be specified; displayed in parentheses after title.

chapterurl

• chapter-url: URL of an individual chapter of online source. Should be at the same site as url, if any. If chapter-url is used, url should only be used if the beginning of the work and the cited chapter are on separate webpages at the site. chapter may be wikilinked or chapter-url used, but not both.

Aliases: chapter-url, chapterurl

lay

• laysummary: URL link to a non-technical summary or review of the source; the URL title is set to "Lay summary".
  • laysource: Name of the source of the laysummary; formatted in italics and preceded by an endash.
  • laydate: Date of the summary; enclosed in parentheses.

quote

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

ref

• ref: ID for anchor. By default, no anchor is generated. The ordinary nonempty value |ref=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. The special value |ref=harv generates an anchor suitable for the {{harv}} template; see anchors for Harvard referencing templates.

ref2

• ref: ID for anchor. By default, anchors are always generated. The ordinary nonempty value |ref=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.

display

• author-mask: Replaces the name of the first author with a strike-through dash (—) author-mask em in length. If |author-mask=1 then the dash will be one em in length and so on. Set author-mask to a text value to display a word instead:– for example, 'with'. You must still include the values for all authors for metadata purposes. Primarily intended for use in bibliographies for some styles where multiple works by a single author are listed. Do not use in a list generated by {{reflist}}, <references></references> or similar as there is no control as to the order that references will display.
• author-name-separator: Changes the separator between last and first names; defaults to a comma and space (, ); if the parameter is present, but blank, no separator punctuation will be used; a space must be encoded as   do not use an asterisk (*), colon (:) or hash (#) as they will be interpreted as wikimarkup.
• author-separator: Changes the separator between authors; defaults to a semicolon and space (; ); if the parameter is present, but blank, no separator punctuation will be used; a space must be encoded as   do not use an asterisk (*), colon (:) or hash (#) as they will be interpreted as wikimarkup.
• display-authors: By default, the number of authors displayed is limited to 8; if 9 are provided, the ninth is displayed as "et al." This parameter allows display of fewer authors before the "et al."; example: |display-authors=2; if there are 8 or fewer authors, then "et al." may be suppressed by setting |display-authors=9.
• lastauthoramp: When set to any value, changes the separator to use between the last two names in lists of authors to an ampersand (&); defaults to a semicolon and space (; ), else |author-separator= if set.
• postscript: The closing punctuation for the citation; defaults to a period (.); if the parameter is present, but blank, no terminating punctuation will be used. Ignored if |quote= is specified.
• separator: The punctuation used to separate lists of authors, editors, etc. Defaults to a period (.); if the parameter is present, but blank, no separator punctuation will be used; do not use an asterisk (*), colon (:) or hash (#) as they will be interpreted as wikimarkup.

• cs2: When set, changes the separator to "comma (,)"}}

map_series

• scale: Scale of map.
• series: Title of map series.
• version: Version of map.
• cartography: Person or entity that did the cartography; shows as "Cartography by cartography."

map_id

• section: The map section of the feature referenced; example: 6A, 9B, 11L, etc.
• inset: The name of the focused inset referenced; example: Downtown Fooburg.

map_pages

• page: Page in the source that supports the content; overridden by at.
• OR: pages: Pages in the source that supports the content; separate page ranges with an en dash (–); separate non-sequential pages with a comma (,); do not use to indicate the total number of pages in the source.
• OR: at: For sources where a page number is inappropriate or insufficient.

Examples: page (p.) or pages (pp.); section (Section), inset or other custom location on the map or in the atlas.

interview_id

• program: News program or event.
• callsign: Radio or TV callsign.

interview_author

• last: Surname of subject. Do not wikilink—use authorlink instead. Where the surname is usually written first—as in Chinese—or for corporate authors, simply use last to include the same format as the source.
  • first: Given or first names of author, including title(s); example: Firstname Middlename or Firstname M. or Dr. Firstname M., Sr.. Do not wikilink—use authorlink instead.
  • OR: for multiple subjects, use first1, last1 through first9, last9 for up to nine subjects. By default, if nine subjects are defined, then only eight will show and "et al." will show in place of the last author.

• authorlink: Title of existing Wikipedia article about the subject—not the subject's website; do not wikilink.
• OR: for multiple subjects, use subjectlink1 through subjectlink9.

Aliases: subject, last, last1, author1, author, authors; subject2, last2, author2 through subject9, last9, author9; subjectlink, authorlink, authorlink1; subjectlink2, authorlink2 through subjectlink9, authorlink9.

interview_interviewer

• interviewer: Full name of interviewer(s); separate interviewers with a semicolon (;); wikilink as desired.

• cointerviewers: (deprecated) Full names of co-interviewers

DVD-notes_date

Note: The date parameters in this template differ from other templates in this series.

• date: Full date of the video was originally released; in same format as other dates in the article; do not wikilink. Use only the full date including month, day and year, else the anchor may be malformed.
• OR: titleyear: Year of source being referenced.
  • month: Name of the month of publication. If you also have the day, use date instead; do not wikilink.
  • year: Year DVD published if different from the release year.

album_name

• name: Name of the release; may be wikilinked; defaults to formatted in italics.
  • type: Set |type=single to format name in quotes.

album_artist

• artist: The artist or band name; may be wikilinked; Various artists may be used as needed.

season

• season: Season number, usually for US shows.
• OR: seriesno: Series number, usually for British shows.
• number: Many episodic shows are identified by separate season and episode numbers. Alternately, some shows prefer the format of a single episode number that includes the season within it; this format can be used by omitting the season field.

network

• network: The network the episode was aired on. (e.g. ABC, NBC, CBS, Fox, Disney, USA Network, BBC)
  • station: Call letters of the local station (if any).

airdate

• date: Full date of source being referenced; in same format as other dates in the article; do not wikilink. Use only the full date including month, day and year, else the anchor may be malformed.

Aliases: airdate, date.

• OR: year: Year of source being referenced.
  • month: Name of the month of publication. If you also have the day, use date instead; do not wikilink.
  • origyear: Original publication year; displayed after the date or year. For clarity, please supply specifics; example: |origyear=First published 1859 or |origyear=Composed 1904.
• OR: began: Full date the first part of the program or episode aired.
  • AND: ended: Full date the last part of the program or episode aired.

transcript

• transcript: Transcript of the original source.
  • transcripturl: URL of the transcript.

notestitle

• notestitle: The title of the notes, if different from the title of the album.

conference

• conference: Name of the conference, may include location if different from location and date if different from date or year.
  • conferenceurl: URL of conference proceedings, if different from url.

conference_title

• title: Title of the conference. Can be wikilinked to an existing Wikipedia article or url may be used to add an external link, but not both. Formatted in quotes.
  • trans_chapter: If the source cited is in a foreign language, an English translation of the title can be given here. The template will display this in square brackets after the title field and it will link to the url field, if used. Use of the language parameter is recommended.

Titles containing certain characters will display and link incorrectly unless those characters are encoded.

newline	[	]	|
space	[	]	|

• type: Provides additional information about the media type of the source; format in sentence case; appears in parentheses following the title; examples: Thesis, Booklet, CD liner; Press release.
• booktitle: The title of the published version of the converence, written in full. May be wikilinked or may use chapter-url, but not both. Formatted in italics.
  • trans_title: If the source cited is in a foreign language, an English translation of the chapter can be given here. The template will display this in square brackets after the chapter field and it will link to the chapter-url field, if used. Use of the language parameter is recommended.
• language: The language the source is written in, if not English. Formatted in parentheses with "in" before the language name. Use the full language name; do not use icons or templates.