Template:Citation Style documentation/display: Difference between revisions

m
imported>Jason Quinn
(reworded description of display-authors to improve clarity)
 
(45 intermediate revisions by 15 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'''.
* '''<b 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 in''n'' em spaces wide; set '''author-mask''' to a text value to display the text without a wordtrailing author insteadseparator; for example, "with". You must still include the values for all authors for metadata purposes. Primarily intended for use inwith bibliographies foror somebibliography styles where multiple works by a single author are listed sequentially such as {{sfnote|lc=y}}. Do not use in a list generated by {{tltlx|reflist}}, {{tag|references|s}} or similar as there is no control as toof the order thatin which references willare displaydisplayed. 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.
* '''author-name-separator''': Changes the separator between last and first names; defaults to a comma and space (, ); if the parameter is present, but blank, no separator punctuation will be used; a space must be encoded as &amp;#32; do not use an asterisk (*), colon (:) or hash (#) 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'''.
* '''author-separator''': Changes the separator between authors; defaults to a semicolon and space (; ); if the parameter is present, but blank, no separator punctuation will be used; a space must be encoded as &amp;#32; do not use an asterisk (*), colon (:) or hash (#) as they will be interpreted as wikimarkup.
* '''<b id="csdoc_display-editors"><span id="csdoc_displayeditors"></span>display-authors'''editors</b>: By default,Controls the number of authorseditor displayednames isthat limitedare todisplayed 8;when ifa 9citation areis provided,published. theTo ninthchange isthe displayed asnumber "etof al."editors, This parameter allowsset '''display-editors''' of fewer authors beforeto the "etdesired alnumber."; forFor example, use {{para|display-authorseditors|2}} forwill display only the first two authors.editors Thein "eta alcitation." mayBy bedefault, suppressedall altogethereditors byare settingdisplayed. {{para|display-authorseditors|9etal}} displays all editors in the list followed by et al. Aliases: '''displayeditors'''.
* '''lastauthoramp'''<b id="csdoc_lastauthoramp">last-author-amp</b>: When set to any value, changesSwitches the separator to use between the last two names inof liststhe ofauthor authorslist to anspace ampersand space (<code> & </code>); defaultswhen set to a<code>y</code>, semicolon<code>yes</code>, andor space<code>true</code>. (;Example: ), else '''{{para|last-author-separator''' if set.amp|yes}}
* '''<b id="csdoc_postscript">postscript'''</b>: TheControls the closing punctuation for thea citation; defaults to {{#if: {{{cs2|}}}|defaults to none|defaults to a period (<code>.</code>); iffor theno terminating punctuation, specify {{para|postscript|none}} – leaving {{para|postscript}} parameterempty is presentthe same as omitting it, but blank,is noambiguous}}. Additional text or templates beyond the terminating punctuation willmay begenerate usedan error message. {{para|postscript}}. Ignoredis ignored if '''quote''' is defined.
* '''separator''': The punctuation used to separate lists of authors, editors, etc. Defaults to a {{#if: {{{cs2|}}}|comma (,)|period (.)}}; if the parameter is present but blank, no separator punctuation will be used; do not use an asterisk (*), colon (:) or hash (#) as they will be interpreted as wikimarkup.