Template:Citation Style documentation/author: Difference between revisions

From Lojban
Jump to navigation Jump to search
m (1 revision)
 
m (1 revision imported)
 
(3 intermediate revisions by 2 users not shown)
Line 1: Line 1:
float:right; margin-left:1em; margin-bottom:0.5em; clear:right;<noinclude>
* <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}}}}}.
{{doc}}
** '''author''': this parameter is used to hold the complete name of a single author (first and last) or to hold the name of a corporate author.  This parameter should never hold the names of more than one author. Do not wikilink—use '''author-link''' instead.
</noinclude>
** '''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.
** 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|...}}.
** '''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'''.
**'''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.
*{{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:
*:{{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|}}}||
*'''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'''.}}{{#if: {{{contributor|}}}|
* '''contributor-last''': (book cites only) surname of the author of '''contribution''' (which is required). Aliases:  '''contributor-surname''', '''contributor1''', '''contributor1-last''', '''contributor-last1'''.
**'''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'''.
**'''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''.}}
*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 16:14, 4 August 2021

  • 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 complete name of a single author (first and last) or to hold the name of a corporate author. This parameter should never hold the names of more than one author. Do not wikilink—use author-link 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.
    • 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). <templatestyles src="Crossreference/styles.css" />Template:Hatnote inline 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: 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.
    • 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.
  • Note: When using shortened footnotes or parenthetical referencing styles with templates, do not use multiple names in one field, or else the anchor will not match the inline link.