Template:Citation Style documentation/author: Difference between revisions

imported>Jonesey95
wrap word to clarify
m remove double double name name
Line 1: Line 1:
* <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}}}}}.
* <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 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.
** '''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; 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 only in accordance with [[MOS:HON]].
** '''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 only in accordance with [[MOS:HON]].
** 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|...}}.
** 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|...}}.
Line 9: Line 9:
*:{{para|vauthors|Smythe JB, ((Megabux Corp.)), etal}}
*:{{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|}}}||
** '''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|}}}|
*'''{{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'''.
* '''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'''.
**'''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>'''.
** 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'''.
** '''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|}}}||
**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'''.
* <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'''.
**'''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>'''.
** 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>'''.
Line 22: Line 22:
* <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_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''.}}
* <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.
*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.