Template:Citation Style documentation/author: Difference between revisions

From All Skies Encyclopaedia
imported>Gadget850
(split aliases for comprehension)
imported>HyRotor
(Added clarification on the honorifics referred to; revert if unwanted)
 
(93 intermediate revisions by 27 users not shown)
Line 1: Line 1:
* '''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. Aliases: '''last''', '''author''', '''authors''', '''last1''', '''author1''' {{{aliases|}}}
* <b id="csdoc_author">last</b>: Surname of a single author. Do not wikilink—use '''author-link''' instead. For corporate authors or authors for whom only one name is listed by the source, use '''last''' or one of its aliases (e.g. {{para|author|Bono}}). Aliases: '''surname''', '''author''', '''last1''', '''surname1''', '''author1'''{{#if:{{{aliases|}}}|, {{{aliases}}}}}.
** '''author''': this parameter is used to hold the name of an organizational author (e.g. a committee) or the complete name (first and last) of a single person; for the latter, prefer the use of {{para|first}} and {{para|last}}. This parameter should never hold the names of more than one author. Supports [[Help:Citation_Style_1#Accept-this-as-written_markup|accept-this-as-written markup]]. Do not use italics in this field, as doing so produces corrupt metadata.
** '''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.
** '''first''': Given or first names of author; for example: ''Firstname Middlename'' or ''Firstname M.'' or ''Firstname M. Sr.'' Do not wikilink—use '''author-link''' instead. Aliases: '''given''', '''first1''', '''given1'''. Requires '''last'''; first name will not display if '''last''' is empty. Use generational and {{notatypo|regnal}} suffixes only in accordance with [[MOS:JRSR]] and use honorifics (including [[Doctor (title)|Dr.]], [[Sir]], and similar) only in accordance with [[MOS:HON]].
** 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. Aliases: '''last1''', '''author1''' through '''last9''', '''author9'''.
** OR: for multiple authors, use '''last1''', '''first1''' through '''last<var>n</var>''', '''first<var>n</var>''', where ''n'' is any consecutive number for an unlimited number of authors (each '''first<var>n</var>''' requires a corresponding '''last<var>n</var>''', but not the other way around). {{Crossref|See the [[#csdoc_display|'''display''']] parameters to change how many authors are displayed.}} Aliases: '''surname1''', '''given1''' through '''surname<var>n</var>''', '''given<var>n</var>''', or '''author1''' through '''author<var>n</var>'''. For an individual author plus an institutional author, you can use {{para|first1|...}}{{para|last1|...}}{{para|author2|...}}.
:* '''authorlink''': Title of existing Wikipedia article about the author—not the author's website; do not wikilink. Aliases: '''authorlink''', '''authorlink1''', '''author-link''', '''author1-link'''.
:*OR: for multiple authors, use '''authorlink1''' through '''authorlink9'''. Aliases: '''authorlink1''', '''author1-link''' through '''authorlink9''', '''author9-link'''.{{#if: {{{coauthors|}}}|
** '''author-link''': Title of existing Wikipedia article about the author—not the author's website; do not wikilink. Aliases: '''author-link1''', '''author1-link''', '''authorlink'''.
**OR: for multiple authors, use '''author-link1''' through '''author-link<var>n</var>'''. Aliases: '''author1-link''' through '''author<var>n</var>-link'''.
* '''coauthors''': (deprecated) Names of of coauthors. Use the same format as the authors.}}{{#if: {{{others|}}}|
**'''name-list-style''': accepts a limited list of keywords as value; when set to <code>amp</code>, <code>ampersand</code>, or <code>&</code>, inserts an ampersand between the last two names in a name list; when set to <code>and</code>, inserts the conjunction 'and' between the last two names of a name list; when set to <code>vanc</code>displays name lists in [[Vancouver style]] when the lists use the <code>last</code>/<code>first</code> forms of name parameters.
* '''others''': To record other contributors to the work, such as "Illustrated by Smith" or "Trans. Smith".}}
*{{anchor|para_vauthors}}'''vauthors''': comma-separated list of author names in [[Vancouver style]]; enclose corporate or institutional author names in [[Help:Citation_Style_1#Accept-this-as-written_markup|doubled parentheses]]. End with etal if appropriate:
:When using {{sfnote}} or {{paren}} styles with templates, do not use multiple names in one field else the anchor will not match the inline link.
*:{{para|vauthors|Smythe JB, ((Megabux Corp.)), etal}}
** '''author-link''' and '''author-mask''' may be used for the individual names in {{para|vauthors}} as described above{{#if:{{{limited_param_list|}}}||
*'''{{xtd|authors}}''': deprecated <s>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'''.</s>}}{{#if: {{{contributor|}}}|
* '''contributor-last''': (book cites only) surname of the author of '''contribution''' (which is required). Aliases: '''contributor-surname''', '''contributor1''', '''contributor1-last''', '''contributor-last1'''. Supports [[Help:Citation_Style_1#Accept-this-as-written_markup|accept-this-as-written markup]].
**'''contributor-first''': Given or first names of contributor. Do not wikilink—use '''contributor-link''' instead. Aliases: '''contributor-given''', '''contributor1-first''', '''contributor-first1'''.
** OR: for multiple contributors, use '''contributor-last1''', '''contributor-first1''' through '''contributor-last<var>n</var>''', '''contributor-first<var>n</var>''' where ''n'' is any consecutive number for an unlimited number of contributors (each '''contributor-first<var>n</var>''' requires a corresponding '''contributor-last<var>n</var>''', but not the other way around). Aliases: '''contributor1-last''', '''contributor1-first''' through '''contributor<var>n</var>-last''', '''contributor<var>n</var>-first''', or '''contributor1''' through '''contributor<var>n</var>'''.
** '''contributor-link''': Title of existing Wikipedia article about the contributor—not the contributor's website; do not wikilink. Aliases: '''contributor-link1''', '''contributor1-link'''.
**OR: for multiple contributors, use '''contributor-link1''' through '''contributor-link<var>n</var>'''. Aliases: '''contributor1-link''' through '''contributor<var>n</var>-link'''.}}{{#if:{{{limited_param_list|}}}||
* <b id="csdoc_translator">translator-last</b>: Surname of translator. Do not wikilink—use '''translator-link''' instead. Aliases: '''translator-surname''', '''translator1''', '''translator1-last''', '''translator-last1'''. Supports [[Help:Citation_Style_1#Accept-this-as-written_markup|accept-this-as-written markup]].
**'''translator-first''': Given or first names of translator. Do not wikilink—use '''translator-link''' instead. Aliases: '''translator-given''', '''translator1-first''', '''translator-first1'''.
** OR: for multiple translators, use '''translator-last1''', '''translator-first1''' through '''translator-last<var>n</var>''', '''translator-first<var>n</var>''', where ''n'' is any consecutive number for an unlimited number of translators (each '''translator-first<var>n</var>''' requires a corresponding '''translator-last<var>n</var>''', but not the other way around). Aliases: '''translator1-last''', '''translator1-first''' through '''translator<var>n</var>-last''', '''translator<var>n</var>-first''', or '''translator1''' through '''translator<var>n</var>'''.
** '''translator-link''': Title of existing Wikipedia article about the translator—not the translator's website; do not wikilink. Aliases: '''translator-link1''', '''translator1-link'''.
**OR: for multiple translators, use '''translator-link1''' through '''translator-link<var>n</var>'''. Aliases: '''translator1-link''' through '''translator<var>n</var>-link'''.}}
* <b id="csdoc_collaboration">collaboration</b>: Name of a group of authors or collaborators; requires '''author''', '''last''', or '''vauthors''' listing one or more primary authors; follows author name-list; appends "et al." to author name-list.{{#if: {{{others|}}}|
* <b id="csdoc_others">others</b>: To record other contributors to the work, including illustrators. For the parameter value, write ''Illustrated by John Smith''.}}
{{#if: {{{avothers|}}}|
* <b id="csdoc_others">others</b>: To record other contributors to the work, including illustrators. For the parameter value, write ''Illustrated by John Smith''. Note that specifying others= without an author= (or one of its aliases) will place the article in [[:Category:CS1 maint: others in cite AV media (notes)]].}}
*Note: When using {{sfnote|lc=y}} or {{paren|lc=y}} styles with templates, do not use multiple names in one field, or else the anchor will not match the inline link.

Latest revision as of 02:51, 29 December 2024

  • last: Surname of a single author. Do not wikilink—use author-link instead. For corporate authors or authors for whom only one name is listed by the source, use last or one of its aliases (e.g. |author=Bono). Aliases: surname, author, last1, surname1, author1.
    • author: this parameter is used to hold the name of an organizational author (e.g. a committee) or the complete name (first and last) of a single person; for the latter, prefer the use of |first= and |last=. This parameter should never hold the names of more than one author. Supports accept-this-as-written markup. Do not use italics in this field, as doing so produces corrupt metadata.
    • first: Given or first names of author; for example: Firstname Middlename or Firstname M. or Firstname M. Sr. Do not wikilink—use author-link instead. Aliases: given, first1, given1. Requires last; first name will not display if last is empty. Use generational and regnal suffixes only in accordance with MOS:JRSR and use honorifics (including Dr., Sir, and similar) only in accordance with MOS:HON.
    • OR: for multiple authors, use last1, first1 through lastn, firstn, where n is any consecutive number for an unlimited number of authors (each firstn requires a corresponding lastn, but not the other way around). See the display parameters to change how many authors are displayed. Aliases: surname1, given1 through surnamen, givenn, or author1 through authorn. For an individual author plus an institutional author, you can use |first1=...|last1=...|author2=....
    • author-link: Title of existing Wikipedia article about the author—not the author's website; do not wikilink. Aliases: author-link1, author1-link, authorlink.
    • OR: for multiple authors, use author-link1 through author-linkn. Aliases: author1-link through authorn-link.
    • name-list-style: accepts a limited list of keywords as value; when set to amp, ampersand, or &, inserts an ampersand between the last two names in a name list; when set to and, inserts the conjunction 'and' between the last two names of a name list; when set to vancdisplays name lists in Vancouver style when the lists use the last/first forms of name parameters.
  • vauthors: comma-separated list of author names in Vancouver style; enclose corporate or institutional author names in doubled parentheses. End with etal if appropriate:
    |vauthors=Smythe JB, ((Megabux Corp.)), etal
    • author-link and author-mask may be used for the individual names in |vauthors= as described above
  • authors: deprecated 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.
  • translator-last: Surname of translator. Do not wikilink—use translator-link instead. Aliases: translator-surname, translator1, translator1-last, translator-last1. Supports accept-this-as-written markup.
    • translator-first: Given or first names of translator. Do not wikilink—use translator-link instead. Aliases: translator-given, translator1-first, translator-first1.
    • OR: for multiple translators, use translator-last1, translator-first1 through translator-lastn, translator-firstn, where n is any consecutive number for an unlimited number of translators (each translator-firstn requires a corresponding translator-lastn, but not the other way around). Aliases: translator1-last, translator1-first through translatorn-last, translatorn-first, or translator1 through translatorn.
    • translator-link: Title of existing Wikipedia article about the translator—not the translator's website; do not wikilink. Aliases: translator-link1, translator1-link.
    • OR: for multiple translators, use translator-link1 through translator-linkn. Aliases: translator1-link through translatorn-link.
  • collaboration: Name of a group of authors or collaborators; requires author, last, or vauthors listing one or more primary authors; follows author name-list; appends "et al." to author name-list.