Template:Citation Style documentation/display: Difference between revisions

< Template:Citation Style documentation Browse history interactively ← Previous edit Next edit →Content deleted Content addedVisual WikitextInline

Revision as of 08:07, 16 August 2020 editMatthiaspaul (talk \| contribs)Autopatrolled, Extended confirmed users, Page movers, New page reviewers, Pending changes reviewers, Rollbackers, Template editors137,492 edits mentioned special case of \|*-mask=0← Previous edit		Revision as of 18:48, 19 August 2020 edit undoMatthiaspaul (talk \| contribs)Autopatrolled, Extended confirmed users, Page movers, New page reviewers, Pending changes reviewers, Rollbackers, Template editors137,492 edits combined mostly redundant doc for \|display-authors= and \|display-editors=Next edit →
Line 6:		Line 6:
	* <b id="csdoc_translator-mask">translator-mask</b>:		* <b id="csdoc_translator-mask">translator-mask</b>:
	*: Replaces the name of the (first) author with ] or text. Set '''<{{var\|name}}>-mask''' to a numeric value ''n'' to set the dash ''n'' em spaces wide; set '''<{{var\|name}}>-mask''' to a text value to display the text without a trailing author separator; for example, "with". The numeric value 0 is a special case to be used in conjunction with '''<{{var\|name}}>-link'''—in this case, the value of '''<{{var\|name}}>-link''' will be used as (linked) text. In either case, you must still include the values for all names for metadata purposes. Primarily intended for use with bibliographies or bibliography styles where multiple works by a single author are listed sequentially such as {{sfnote\|lc=y}}. Do not use in a list generated by {{tlx\|reflist}}, {{tag\|references\|s}} or similar as there is no control of the order in which references are displayed. Mask parameters can take an enumerator in the name of the parameter (e.g. {{para\|author{{var\|n}}-mask}}) to apply the mask to a specific {{var\|name}}.		*: Replaces the name of the (first) author with ] or text. Set '''<{{var\|name}}>-mask''' to a numeric value ''n'' to set the dash ''n'' em spaces wide; set '''<{{var\|name}}>-mask''' to a text value to display the text without a trailing author separator; for example, "with". The numeric value 0 is a special case to be used in conjunction with '''<{{var\|name}}>-link'''—in this case, the value of '''<{{var\|name}}>-link''' will be used as (linked) text. In either case, you must still include the values for all names for metadata purposes. Primarily intended for use with bibliographies or bibliography styles where multiple works by a single author are listed sequentially such as {{sfnote\|lc=y}}. Do not use in a list generated by {{tlx\|reflist}}, {{tag\|references\|s}} or similar as there is no control of the order in which references are displayed. Mask parameters can take an enumerator in the name of the parameter (e.g. {{para\|author{{var\|n}}-mask}}) to apply the mask to a specific {{var\|name}}.
	* <b id="csdoc_display-authors"><span id="csdoc_displayauthors"></span>display-authors</b>: Controls the number of author names that are displayed when a citation is published. To change the displayed number of ~~authors~~, set '''display-authors''' to the desired number. For example, {{para\|display-authors\|2}} will display only the first two authors in a citation. {{para\|display-authors\|0}} is a special ~~case~~ suppressing the display of all authors including the et al. By default, all authors are displayed. {{para\|display-authors\|etal}} displays all authors in the list followed by et al. Aliases: '''displayauthors'''.		* <b id="csdoc_display-authors"><span id="csdoc_displayauthors"></span>display-authors</b>:
			* <b id="csdoc_display-editors"><span id="csdoc_displayeditors"></span>display-editors</b>:
			*: Controls the number of author or editor names that are displayed when a citation is published. To change the displayed number of names, set '''display-authors''' and/or '''display-editors''' to the desired number. For example, {{para\|display-authors\|2}} will display only the first two authors in a citation (and not affect the display of editors). Likewise, {{para\|display-editors\|2}} will display only the first two editors (and all authors). {{para\|display-authors\|0}} and {{para\|display-editors\|0}} are special cases suppressing the display of all authors or editors including the et al. By default, all authors and editors are displayed. {{para\|display-authors\|etal}} displays all authors in the list followed by et al. Aliases: '''displayauthors''', '''displayeditors''', respectively.
	* <b id="csdoc_display-editors"><span id="csdoc_displayeditors"></span>display-editors</b>: Controls the number of editor names that are displayed when a citation is published. To change the displayed number of editors, set '''display-editors''' to the desired number. For example, {{para\|display-editors\|2}} will display only the first two editors in a citation. By default, all editors are displayed. {{para\|display-editors\|etal}} displays all editors in the list followed by et al. Aliases: '''displayeditors'''.
	* <b id="csdoc_lastauthoramp">last-author-amp</b>: Switches the separator between the last two names of the author list to space ampersand space (<code> & </code>) when set to <code>y</code>, <code>yes</code>, or <code>true</code>. Example: {{para\|last-author-amp\|yes}}		* <b id="csdoc_lastauthoramp">last-author-amp</b>: Switches the separator between the last two names of the author list to space ampersand space (<code> & </code>) when set to <code>y</code>, <code>yes</code>, or <code>true</code>. Example: {{para\|last-author-amp\|yes}}
	* <b id="csdoc_postscript">postscript</b>: Controls the closing punctuation for a citation; defaults to {{#if: {{{cs2\|}}}\|none\|a period (<code>.</code>); for no terminating punctuation, specify {{para\|postscript\|none}} – leaving {{para\|postscript}} empty is the same as omitting it, but is ambiguous}}. Additional text or templates beyond the terminating punctuation may generate an error message. {{para\|postscript}} is ignored if '''quote''' is defined.		* <b id="csdoc_postscript">postscript</b>: Controls the closing punctuation for a citation; defaults to {{#if: {{{cs2\|}}}\|none\|a period (<code>.</code>); for no terminating punctuation, specify {{para\|postscript\|none}} – leaving {{para\|postscript}} empty is the same as omitting it, but is ambiguous}}. Additional text or templates beyond the terminating punctuation may generate an error message. {{para\|postscript}} is ignored if '''quote''' is defined.

Revision as of 18:48, 19 August 2020

mode: Sets element separator, default terminal punctuation, and certain capitalization according to the value provided. For |mode=cs1, element separator and terminal punctuation is a period (.); where appropriate, initial letters of certain words are capitalized ('Retrieved...'). For |mode=cs2, element separator is a comma (,); terminal punctuation is omitted; where appropriate, initial letters of certain words are not capitalized ('retrieved...'). To override default terminal punctuation use postscript.
author-mask:
contributor-mask:
editor-mask:
interviewer-mask:
translator-mask:
Replaces the name of the (first) author with em dashes or text. Set <name>-mask to a numeric value n to set the dash n em spaces wide; set <name>-mask to a text value to display the text without a trailing author separator; for example, "with". The numeric value 0 is a special case to be used in conjunction with <name>-link—in this case, the value of <name>-link will be used as (linked) text. In either case, you must still include the values for all names for metadata purposes. Primarily intended for use with bibliographies or bibliography styles where multiple works by a single author are listed sequentially such as shortened footnotes. Do not use in a list generated by {{reflist}}, <references /> or similar as there is no control of the order in which references are displayed. Mask parameters can take an enumerator in the name of the parameter (e.g. |authorn-mask=) to apply the mask to a specific name.
display-authors:
display-editors:
Controls the number of author or editor names that are displayed when a citation is published. To change the displayed number of names, set display-authors and/or display-editors to the desired number. For example, |display-authors=2 will display only the first two authors in a citation (and not affect the display of editors). Likewise, |display-editors=2 will display only the first two editors (and all authors). |display-authors=0 and |display-editors=0 are special cases suppressing the display of all authors or editors including the et al. By default, all authors and editors are displayed. |display-authors=etal displays all authors in the list followed by et al. Aliases: displayauthors, displayeditors, respectively.
last-author-amp: Switches the separator between the last two names of the author list to space ampersand space ( & ) when set to y, yes, or true. Example: |last-author-amp=yes
postscript: Controls the closing punctuation for a citation; defaults to a period (.); for no terminating punctuation, specify |postscript=none – leaving |postscript= empty is the same as omitting it, but is ambiguous. Additional text or templates beyond the terminating punctuation may generate an error message. |postscript= is ignored if quote is defined.

Revision as of 08:07, 16 August 2020 editMatthiaspaul (talk \| contribs)Autopatrolled, Extended confirmed users, Page movers, New page reviewers, Pending changes reviewers, Rollbackers, Template editors137,492 edits mentioned special case of \|*-mask=0← Previous edit		Revision as of 18:48, 19 August 2020 edit undoMatthiaspaul (talk \| contribs)Autopatrolled, Extended confirmed users, Page movers, New page reviewers, Pending changes reviewers, Rollbackers, Template editors137,492 edits combined mostly redundant doc for \|display-authors= and \|display-editors=Next edit →
Line 6:		Line 6:
	* <b id="csdoc_translator-mask">translator-mask</b>:		* <b id="csdoc_translator-mask">translator-mask</b>:
	*: Replaces the name of the (first) author with ] or text. Set '''<{{var\|name}}>-mask''' to a numeric value ''n'' to set the dash ''n'' em spaces wide; set '''<{{var\|name}}>-mask''' to a text value to display the text without a trailing author separator; for example, "with". The numeric value 0 is a special case to be used in conjunction with '''<{{var\|name}}>-link'''—in this case, the value of '''<{{var\|name}}>-link''' will be used as (linked) text. In either case, you must still include the values for all names for metadata purposes. Primarily intended for use with bibliographies or bibliography styles where multiple works by a single author are listed sequentially such as {{sfnote\|lc=y}}. Do not use in a list generated by {{tlx\|reflist}}, {{tag\|references\|s}} or similar as there is no control of the order in which references are displayed. Mask parameters can take an enumerator in the name of the parameter (e.g. {{para\|author{{var\|n}}-mask}}) to apply the mask to a specific {{var\|name}}.		*: Replaces the name of the (first) author with ] or text. Set '''<{{var\|name}}>-mask''' to a numeric value ''n'' to set the dash ''n'' em spaces wide; set '''<{{var\|name}}>-mask''' to a text value to display the text without a trailing author separator; for example, "with". The numeric value 0 is a special case to be used in conjunction with '''<{{var\|name}}>-link'''—in this case, the value of '''<{{var\|name}}>-link''' will be used as (linked) text. In either case, you must still include the values for all names for metadata purposes. Primarily intended for use with bibliographies or bibliography styles where multiple works by a single author are listed sequentially such as {{sfnote\|lc=y}}. Do not use in a list generated by {{tlx\|reflist}}, {{tag\|references\|s}} or similar as there is no control of the order in which references are displayed. Mask parameters can take an enumerator in the name of the parameter (e.g. {{para\|author{{var\|n}}-mask}}) to apply the mask to a specific {{var\|name}}.
	* <b id="csdoc_display-authors"><span id="csdoc_displayauthors"></span>display-authors</b>: Controls the number of author names that are displayed when a citation is published. To change the displayed number of ~~authors~~, set '''display-authors''' to the desired number. For example, {{para\|display-authors\|2}} will display only the first two authors in a citation. {{para\|display-authors\|0}} is a special ~~case~~ suppressing the display of all authors including the et al. By default, all authors are displayed. {{para\|display-authors\|etal}} displays all authors in the list followed by et al. Aliases: '''displayauthors'''.		* <b id="csdoc_display-authors"><span id="csdoc_displayauthors"></span>display-authors</b>:
			* <b id="csdoc_display-editors"><span id="csdoc_displayeditors"></span>display-editors</b>:
			*: Controls the number of author or editor names that are displayed when a citation is published. To change the displayed number of names, set '''display-authors''' and/or '''display-editors''' to the desired number. For example, {{para\|display-authors\|2}} will display only the first two authors in a citation (and not affect the display of editors). Likewise, {{para\|display-editors\|2}} will display only the first two editors (and all authors). {{para\|display-authors\|0}} and {{para\|display-editors\|0}} are special cases suppressing the display of all authors or editors including the et al. By default, all authors and editors are displayed. {{para\|display-authors\|etal}} displays all authors in the list followed by et al. Aliases: '''displayauthors''', '''displayeditors''', respectively.
	* <b id="csdoc_display-editors"><span id="csdoc_displayeditors"></span>display-editors</b>: Controls the number of editor names that are displayed when a citation is published. To change the displayed number of editors, set '''display-editors''' to the desired number. For example, {{para\|display-editors\|2}} will display only the first two editors in a citation. By default, all editors are displayed. {{para\|display-editors\|etal}} displays all editors in the list followed by et al. Aliases: '''displayeditors'''.
	* <b id="csdoc_lastauthoramp">last-author-amp</b>: Switches the separator between the last two names of the author list to space ampersand space (<code> & </code>) when set to <code>y</code>, <code>yes</code>, or <code>true</code>. Example: {{para\|last-author-amp\|yes}}		* <b id="csdoc_lastauthoramp">last-author-amp</b>: Switches the separator between the last two names of the author list to space ampersand space (<code> & </code>) when set to <code>y</code>, <code>yes</code>, or <code>true</code>. Example: {{para\|last-author-amp\|yes}}
	* <b id="csdoc_postscript">postscript</b>: Controls the closing punctuation for a citation; defaults to {{#if: {{{cs2\|}}}\|none\|a period (<code>.</code>); for no terminating punctuation, specify {{para\|postscript\|none}} – leaving {{para\|postscript}} empty is the same as omitting it, but is ambiguous}}. Additional text or templates beyond the terminating punctuation may generate an error message. {{para\|postscript}} is ignored if '''quote''' is defined.		* <b id="csdoc_postscript">postscript</b>: Controls the closing punctuation for a citation; defaults to {{#if: {{{cs2\|}}}\|none\|a period (<code>.</code>); for no terminating punctuation, specify {{para\|postscript\|none}} – leaving {{para\|postscript}} empty is the same as omitting it, but is ambiguous}}. Additional text or templates beyond the terminating punctuation may generate an error message. {{para\|postscript}} is ignored if '''quote''' is defined.