Template:Citation Style documentation/display: Difference between revisions

m
imported>Funandtrvl
(fx fmt)
 
(29 intermediate revisions by 13 users not shown)
Line 1:
* <span id="csdoc_display"></span><b id="csdoc_mode">mode</b>: Sets element separator, default terminal punctuation, and certain capitalization according to the value provided. For {{para|mode|cs1}}, element separator and terminal punctuation is a period (<code>.</code>); where appropriate, initial letters of certain words are capitalized ('Retrieved...'). For {{para|mode|cs2}}, element separator is a comma (<code>,</code>); terminal punctuation is omitted; where appropriate, initial letters of certain words are not capitalized ('retrieved...'). To override default terminal punctuation use '''postscript'''.
* <span id="csdoc_display" /><spanb id="csdoc_author-mask" />'''author-mask'''</b>: Replaces the name of the first author with [[dash#Em dash|em dashes]] or text. Set '''author-mask''' to a numeric value ''n'' to set the dash ''n'' em spaces wide; set '''author-mask''' to a text value to display the text without a trailing author separator; for example, "with". You must still include the values for all authors 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. You can also use '''editor-mask''' and '''translator-mask''' in the same way. Mask parameters can take a number in the name of the parameter (e.g. {{para|author<sub>n</sub>-mask}}) to specify which author the mask should apply to.
* <span id="csdoc_author-name-separator" />'''author-name-separator''': Changes the separator between last and first names; defaults to a comma and space (<code>, </code>); {{#if: {{{lua|}}}|if the parameter is present, but blank, separator punctuation is set to the default|if the parameter is present, but blank, no separator punctuation will be used}}; a space must be encoded as <code>&amp;#32;</code>{{#if: {{{lua|}}}|.|&#32;do not use an asterisk (<code>*</code>), colon (<code>:</code>) or hash (<code>#</code>) as they will be interpreted as wikimarkup.}}
* <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. By default, all authors are displayed. {{para|display-authors|etal}} displays all authors in the list followed by et al. Aliases: '''displayauthors'''.
* <span id="csdoc_author-separator" />'''author-separator''': Changes the separator between authors; defaults to a semicolon and space (<code>; </code>); {{#if: {{{lua|}}}|if the parameter is present, but blank, separator punctuation is set to the default|if the parameter is present, but blank, no separator punctuation will be used}}; a space must be encoded as <code>&amp;#32;</code>{{#if: {{{lua|}}}|.|&#32;do not use an asterisk (<code>*</code>), colon (<code>:</code>) or hash (<code>#</code>) as they will be interpreted as wikimarkup.}}
* <spanb id="csdoc_display-authorseditors" /><span id="csdoc_displayauthorscsdoc_displayeditors" ></span>'''display-authors'''editors</b>: {{#if:Controls {{{lua|}}}|Bythe default,number allof authorseditor are shown unlessnames therethat are nine,displayed thenwhen thea author listcitation is truncated to eight authors and followed by "et al." This mimics the older version of the template for compatibilitypublished. To change the displayed number of authorseditors, set '''display-authorseditors''' to the desired number. WhereFor thereexample, are{{para|display-editors|2}} ninewill authorsdisplay only the first two editors in a citation. By default, setall editors are displayed. {{para|display-authorseditors|9etal}} to showdisplays all authorseditors in the list followed by et al. Aliases: '''displayauthorsdisplayeditors'''.
* <spanb id="csdoc_lastauthoramp" >last-author-amp</b>'''lastauthoramp''': When set to any value, changesSwitches 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}}
|By default, the number of authors displayed is limited to 8; if 9 are provided, the ninth is displayed as "et al." This parameter allows display of fewer authors before the "et al."; for example, use {{para|display-authors|2}} for only two authors. The "et al." may be suppressed altogether by setting {{para|display-authors|9}}. Aliases: '''displayauthors'''.}}
* <spanb id="csdoc_postscript" />'''postscript'''</b>: TheControls the closing punctuation for thea citation; defaults to {{#if: {{{cs2|}}}|none|a period (<code>.</code>); {{#if: {{{lua|}}}|for no terminating punctuation, specify {{para|postscript|none}} – leaving {{para|postscript}} empty hasis the same effectas omitting it, but is ambiguous|if}}. theAdditional parametertext isor present,templates butbeyond blank, nothe terminating punctuation willmay begenerate usedan error message. {{para|postscript}}}}. Ignoredis ignored if '''quote''' is defined.
{{#if: {{{lua|}}}|
* <span id="csdoc_display-editors" /><span id="csdoc_displayeditors" />'''display-editors''': By default, all editors are shown unless there are four, then the editor list is truncated to four editors and followed by "et al." This mimics the older version of the template for compatibility. To change the displayed number of editors, set '''display-editors''' to the desired number. Where there are four editors, set {{para|display-editors|4}} to show all editors. Aliases: '''displayeditors'''.}}
* <span id="csdoc_lastauthoramp" />'''lastauthoramp''': When set to any value, changes the separator between the last two names of the author list to space ampersand space (<code> & </code>).
* <span id="csdoc_postscript" />'''postscript''': The closing punctuation for the citation; defaults to {{#if: {{{cs2|}}}|none|a period (<code>.</code>); {{#if: {{{lua|}}}|for no terminating punctuation, specify {{para|postscript|none}} – leaving {{para|postscript}} empty has the same effect but is ambiguous|if the parameter is present, but blank, no terminating punctuation will be used}}}}. Ignored if '''quote''' is defined.
* <span id="csdoc_separator" />'''separator''': The punctuation used to separate lists of authors, editors, etc. Defaults to a {{#if: {{{cs2|}}}|comma and space (<code>, </code>)|period (<code>.</code>)}}; {{#if: {{{lua|}}}|if the parameter is present, but blank, separator punctuation is set to the default|if the parameter is present, but blank, no separator punctuation will be used}}; a space must be encoded as <code>&amp;#32;</code>{{#if: {{{lua|}}}|.|{{#if: {{{cs2|}}}|.|&#32;do not use an asterisk (<code>*</code>), colon (<code>:</code>) or hash (<code>#</code>) as they will be interpreted as wikimarkup.}} }}