Template:Citation Style documentation/names

Jump to navigation Jump to search

Author names

  • last#: Surname of a single author. May be enumerated. Do not wikilink—use author-link# instead. Aliases: author-last#, author#-last, author#, surname#, subject#, host# .
    • author#: Complete name of a single author (first and last), name of an author who goes by a single name (e.g. |author=Bono), name of a corporate or institutional author. May be enumerated. This parameter should never hold the names of more than one author.
  • first#: Given or first names of author; for example: Firstname Middlename or Firstname M. or Firstname M., Sr. May be enumerated. Do not wikilink—use author-link# instead. Requires last#; first name will not display if last# is empty. Aliases: author-first#, author#-first, given#.
  • vauthors: comma-separated list of author names in Vancouver style; enclose corporate or institutional author names in doubled parentheses:
    |vauthors=Smythe JB, ((Megabux Corp.))
    author-link# and author-mask# may be used for the individual names in vauthors.
  • collaboration: Name of a group of authors or collaborators; requires author-name parameter(s) to list the primary author(s); follows author-name list; appends et al. to author-name list. Aliases: none
  • authors: Free-form list of author names; use of this parameter is discouraged because it does not contribute to a citation's metadata; not an alias of last#. Aliases: people, credits
  • author-link#: See link option. Aliases: author#-link, authorlink#, author#link, subject-link#, subject#-link, subjectlink#, subject#link.
  • author-mask#: See mask option. Aliases: author#-mask, authormask#, author#mask.
  • display-authors: See display option. Aliases: displayauthors.

Editor names

  • editor-last#: Surname of a single editor. May be enumerated. Do not wikilink—use editor-link# instead. Aliases: editor#-last, editor#, editor-surname#, editor#-surname.
    • editor#: Complete name of a single editor (first and last), name of an editor who goes by a single name (e.g. |editor=Bono), name of a corporate or institutional editor. May be enumerated. This parameter should never hold the names of more than one editor.
  • editor-first#: Given or first names of editor; for example: Firstname Middlename or Firstname M. or Firstname M., Sr. May be enumerated. Do not wikilink—use editor-link# instead. Requires editor-last#; first name will not display if editor-last# is empty. Aliases: editor#-first, editor-given#, editor#-given.
  • veditors: comma-separated list of editor names in Vancouver style; enclose corporate or institutional editor names in doubled parentheses:
    |veditors=Smythe JB, ((Megabux Corp.))
    editor-link# and editor-mask# may be used for the individual names in veditors.
  • editors: Free-form list of editor names; use of this parameter is discouraged because it does not contribute to a citation's metadata.
  • editor-link#: See link option. Aliases: editor#-link, editorlink#, editor#link.
  • editor-mask#: See mask option. Aliases: editor#-mask, editormask#, editor#mask.
  • display-editors: See display option. Aliases: displayeditors.

Interviewer names

  • interviewer-last#: Surname of a single interviewer. May be enumerated. Do not wikilink—use interviewer-link# instead. Aliases: interviewer#-last, interviewer#.
    • interviewer#: Complete name of a single interviewer (first and last), name of an interviewer who goes by a single name (e.g. |interviewer=Bono), name of a corporate or institutional interviewer. May be enumerated. This parameter should never hold the names of more than one interviewer.
  • interviewer-first#: Given or first names of interviewer; for example: Firstname Middlename or Firstname M. or Firstname M., Sr. May be enumerated. Do not wikilink—use interviewer-link# instead. Requires interviewer-last#; first name will not display if interviewer-last# is empty. Aliases: interviewer#-first.
  • interviewer-link#: See link option. Aliases: interviewer#-link.
  • interviewer-mask#: See mask option. Aliases: interviewer#-mask.
  • display-interviewers: See display option. Aliases: none.

Translator names

  • translator-last#: Surname of a single translator. May be enumerated. Do not wikilink—use translator-link# instead. Aliases: translator#-last, translator#, translator-surname#, translator#-surname.
    • translator#: Complete name of a single translator (first and last), name of a translator who goes by a single name (e.g. |translator=Bono), name of a corporate or institutional translator. May be enumerated. This parameter should never hold the names of more than one translator.
  • translator-first#: Given or first names of translator; for example: Firstname Middlename or Firstname M. or Firstname M., Sr. May be enumerated. Do not wikilink—use translator-link# instead. Requires translator-last#; first name will not display if translator-last# is empty. Aliases: translator#-first, translator-given#, translator#-given.
  • translator-link#: See link option. Aliases: translator#-link.
  • translator-mask#: See mask option. Aliases: translator#-mask.
  • display-translators: See display option. Aliases: none.

Other names

  • others: To record other contributors to the work, including illustrators. For the parameter value, write Illustrated by John Smith.

Name-list display control

  • name-list-format: accepts the single value vanc; when set, displays name-lists using Vancouver style and when the list uses last/first parameters for the name list(s).
  • display-<name-list>: Controls the number of names that are displayed in <name-list> when a citation is published. By default, all are displayed. To change the number of names that are displayed, set display-<name-list> to the desired number. For example, |display-authors=2 will display the first two authors listed in the author-name list. Appends et al. to the list when the number of displayed names is less than the number of names in the list. |display-authors=etal displays all names in the list and appends et al. Omit when the number of names in the template is the same as the number of names to be displayed.
  • <name-list>-link#: Title of existing Wikipedia article about <name#>—not <name#>'s website. May be enumerated. Do not wikilink.
  • <name-list>-mask#: Replaces <name#> with em dashes or text. May be enumerated. Set <name-list>-mask# to a positive integer value n to replace <name#> with a dash that is n em spaces wide; set <name-list>-mask# to a text value to display the text ahead of the <name#>; for example, "with". You must still include a value for the matching name-list#> parameter for metadata purposes. Primarily intended for use with bibliographies or bibliography styles where multiple works by <name#> are listed sequentially such as shortened footnotes. Do not use in a list generated by {{reflist}}, <references /> or similar (in-line citations) as there is no control of the order in which such references are displayed.

Parameter enumeration

Parameter names that contain the placeholder character '#', may be enumerated. Enumerators are consecutive positive integers beginning at '1' and continuing without gaps; there is no upper limit. In use:

  • digits must replace the '#' placeholder:
    |last15= not |last#=Unknown parameter |last#= ignored
  • for all parameters that are enumerable, the absence of an enumerator has the same meaning as an enumerator of '1':
    |author-link= and |author-link1= have the same meaning → More than one of |author-link1= and |author-link= specified
  • simultaneous use of a non-enumerated parameter and its enumerator '1' equivalent is redundant:
    |translator-last= and |translator1-last= have the same meaning → More than one of |translator1-last= and |translator-last= specified
  • simultaneous use of same-parameter enumerations where the enumerators are in different positions is redundant:
    |editor-first3= and |editor3-first= have the same meaning → More than one of |editor3-first= and |editor-first3= specified
  • simultaneous use of same-enumeration aliases is redundant:
    |contributor-last1= and |contributor= have the same meaning → More than one of |contributor-last1= and |contributor= specified
  • simultaneous use of same-parameter enumerations where the enumerators are in the same position is redundant:
    |interviewer-link2= and |interviewer-link2= are identical; this condition not caught by cs1|2 error detection; see Help:Duplicate parameters

Notes