Difference between revisions of "Template:Citation Style documentation/author"

From Timelines
Jump to: navigation, search
(Undid revision 533687675 by Gadget850 (talk))
(add aliases)
 
(45 intermediate revisions by 16 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: '''last1''', '''author''', '''authors''', '''author1'''{{#if:{{{aliases|}}}|, {{{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}}}}}.
** '''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. Aliases: '''first1'''.
+
** '''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.
** OR: for multiple authors, use '''last1''', '''first1''' through '''last9''', '''first9''' 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: '''author1''' through '''author9'''.
+
** '''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.  
:* '''authorlink''': Title of existing Wikipedia article about the author—not the author's website; do not wikilink. Aliases: '''authorlink1''', '''author-link''', '''author1-link'''.
+
** 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>'''). {{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|...}}.
:*OR: for multiple authors, use '''authorlink1''' through '''authorlink9'''. Aliases: '''author1-link''' through '''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''', '''authorlink''', '''authorlink1''', '''author1-link''', '''author1link'''.
* '''coauthors''': (deprecated) Names of of coauthors. Use the same format as the authors.}}{{#if: {{{others|}}}|
+
**OR: for multiple authors, use '''author-link1''' through '''author-link<var>n</var>'''. Aliases: '''authorlink1''' through '''authorlink<var>n</var>''', or '''author1-link''' through '''author<var>n</var>-link''', or '''author1link''' through '''author<var>n</var>link'''.
* '''others''': To record other contributors to the work, such as "Illustrated by John Smith" or "Translated by John Smith."}}
+
**'''name-list-format''': displays authors and editors in [[Vancouver style]] when set to <code>vanc</code> and when the list uses <code>last</code>/<code>first</code> parameters for the name list(s).
: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.
+
*'''vauthors''': comma-separated list of author names in [[Vancouver style]]; enclose corporate or institutional author names in doubled parentheses:
 +
*:{{para|vauthors|Smythe JB, ((Megabux Corporation))}}
 +
** '''author-link''' and '''author-mask''' may be used for the individual names in {{para|vauthors}} as described above{{#if:{{{arxiv|}}}||
 +
*'''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: {{{coauthors|}}}|
 +
* {{xtd|'''coauthors'''}}: (deprecated) <s>Names of coauthors. Requires '''author''', '''authors''', or '''last''n'''''</s> Include coauthors in '''author''' or '''authors''' or use separate '''author''n''''' or '''last''n'''''/'''first''n''''' to list coauthors.}}{{#if: {{{contributor|}}}|
 +
* '''contributor-last''': Surname of contributor. Do not wikilink—use '''contributor-link''' instead. For book cites only, requires '''contribution'''; used primarily to cite afterword, foreword, introduction, or preface to '''author'''{{'s}} work. 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>'''). 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'''.}}
 +
* <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>'''). 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 17:53, 29 January 2017

  • 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.
    • 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). 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, authorlink, authorlink1, author1-link, author1link.
    • OR: for multiple authors, use author-link1 through author-linkn. Aliases: authorlink1 through authorlinkn, or author1-link through authorn-link, or author1link through authornlink.
    • name-list-format: displays authors and editors in Vancouver style when set to vanc and when the list uses last/first parameters for the name list(s).
  • vauthors: comma-separated list of author names in Vancouver style; enclose corporate or institutional author names in doubled parentheses:
    |vauthors=Smythe JB, ((Megabux Corporation))
    • 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). 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.