Difference between revisions of "Template:Voicing"

From ChoralWiki
Jump to navigation Jump to search
(Removed extraneous ;)
(6 intermediate revisions by the same user not shown)
Line 14: Line 14:
 
|'''Voicing:''' {{cat|Unknown voicing|{{{3|Unknown}}} }} }}{{#if:{{{add|}}} | , {{{add}}} }}<br></includeonly><noinclude>{{prot-temp}}
 
|'''Voicing:''' {{cat|Unknown voicing|{{{3|Unknown}}} }} }}{{#if:{{{add|}}} | , {{{add}}} }}<br></includeonly><noinclude>{{prot-temp}}
 
{{Doc|1=
 
{{Doc|1=
<big>This template</big> is intended for use in a work page, to display the number of voices and the voicing of the <u>original</u> work. It has two required parameters and two optional parameters.
+
<big>This template</big> is intended for use in a work page, to display the number of voices and the voicing of the <u>original</u> work. It has two required parameters and two optional parameters. The second and third parameters are converted to links pointing to voicing categories.
  
<u>Parameters</u>
+
<u><b>Parameters</b></u>
:'''1. Number of voices'''. An integer number (42 or less) or combination of integer numbers with possible punctuation; the letters <tt>vv</tt> will be displayed to the end of what you enter.
+
# '''Number of voices'''. An integer number (42 or less) or combination of integer numbers with possible punctuation; the letters <tt>vv</tt> will be displayed to the end of what you enter. This parameter is not standardized; it is recommended to use one or a few integers (e.g., <tt>8</tt> ''or'' <tt>12-16</tt>), and explain further in following parameters.
:::This parameter is not standardized: but it is recommended to use one integer (e.g., <tt>8</tt> ''or'' <tt>16</tt>), and explain further in following parameters.
+
# '''Identification of parts'''. If the music is for more than one voices, enter a string of letters including <u>only</u> the letters <tt>S A T B</tt>, with no spaces (for single voice, see "Coding for a single voice" below). It is possible to use one of two punctuation marks within the string: period (.) or comma (,).<br><u>Periods</u> indicate multiple choirs (e.g., <tt>SATTB.SATTB.SATTB</tt> – three five-voice choirs), which will display as written; in this case, the total number of letters should be the number in the first parameter (15 in this example). Assigns page to a category of the same name ({{CC|SATTB.SATTB.SATTB}} in this example), and to a category for number of voices ({{CC|15-part choral music}} in this example).<br><u>Commas</u> indicate up to six alternate voicings (e.g., <tt>SAT,SATB,SST</tt>  ''or'' <tt>SATB,SATTB</tt>), which will display with an <tt>or</tt> between them. The number of letters delimited by commas are usually the same (first example), but they could be different (second example). Assigns page to all the categories delimited by the commas ({{CC|SAT}}, {{CC|SAB}}, and {{CC|SST}} in the first example, {{CC|SATB}} and {{CC|SATTB}} in the second), and to a category (or categories) for number of voices ({{CC|3-part choral music}} in the first example; {{CC|4-part choral music}} and {{CC|5-part choral music}} in the second example).
:'''2. Identification of parts'''. A string of letters <u>only</u> the letters <tt>S A T B</tt>, with no spaces. It is possible to use one of two punctuation marks within the string: period (.) or comma (,).  
+
# '''Optional substitute text'''. Plain text that will display in place of the second parameter. Cannot include a link or a template. Permissible punctuation marks: period ('''.''') and comma (''','''). Please do not use special characters (such as '''<tt><big><nowiki>&nbsp;& # $ / \ | [ ] { } </nowiki></big></tt>''').
::*Periods indicate multiple choirs (e.g., <tt>SATTB.SATTB.SATTB</tt> – three five-voice choirs), which will display as written; in this case, the total number of letters should be the number in the first parameter (15 in this example). Assigns page to a category of the same name ({{CC|SATTB.SATTB.SATTB}} in this example), and to a category for number of voices ({{CC|15-part choral music}} in this example).
+
:'''<tt>add{{=}}</tt>'''. Text that will display after the voicing. It could include links or templates.
::*Commas indicate up to six alternate voicings (e.g., <tt>SAT,SAB,SST</tt>), which will display with <tt>or</tt> between; the number of letters delimited by commas should be the same, which is the number in the first parameter (3 in this example). Assigns page to all the categories delimited by the commas ({{CC|SAT}}, {{CC|SAB}}, and {{CC|SST}} in this example), and to a category for number of voices ({{CC|3-part choral music}} in this example).
+
 
:'''3. Optional substitute text'''. Plain text that will display for the category specified in the second parameter. Cannot include a link or a template.
+
<u><b>Coding for a single voice</b></u>
:::Please do not use special characters (such as '''<tt><big><nowiki> & # $ / \ | [ ] </nowiki></big></tt>''').
+
* If the work is for one voice, the second parameter could assign the work to a solo category, if you use code such as <tt>Solo Tenor</tt> or <tt>Solo Mezzo-Soprano</tt>. See [[:Category:Solo vocal music]] for a list of possible categories, and template {{tl|Solo}} for a list of substitutions; for example, the words <tt>solo bass</tt> will assign the work to {{:Category:Bass solo]]. Alternatively
:'''<tt>add{{=}}</tt>'''. Text that will display after the voicing. It could include links or templates. Please do not use special characters.
+
* If one of the choirs
  
 
'''Syntax with required <font color="orange">first</font> and <font color="green">second</font> parameters:'''
 
'''Syntax with required <font color="orange">first</font> and <font color="green">second</font> parameters:'''
*{{tl|Voicing|2=<font color="orange">5</font>|3=<font color="green">SSATB</font>}}
+
*{{tl|Voicing|2=<font color="orange">5</font>|3=<font color="green">SStATB</font>}}
 
:which produces the text
 
:which produces the text
 
:: '''Number of voices:''' 5vv&nbsp;&nbsp;&nbsp;'''Voicing:''' {{CC|SSATB}}
 
:: '''Number of voices:''' 5vv&nbsp;&nbsp;&nbsp;'''Voicing:''' {{CC|SSATB}}

Revision as of 20:14, 12 July 2021

{{Doc|1= This template is intended for use in a work page, to display the number of voices and the voicing of the original work. It has two required parameters and two optional parameters. The second and third parameters are converted to links pointing to voicing categories.

Parameters

  1. Number of voices. An integer number (42 or less) or combination of integer numbers with possible punctuation; the letters vv will be displayed to the end of what you enter. This parameter is not standardized; it is recommended to use one or a few integers (e.g., 8 or 12-16), and explain further in following parameters.
  2. Identification of parts. If the music is for more than one voices, enter a string of letters including only the letters S A T B, with no spaces (for single voice, see "Coding for a single voice" below). It is possible to use one of two punctuation marks within the string: period (.) or comma (,).
    Periods indicate multiple choirs (e.g., SATTB.SATTB.SATTB – three five-voice choirs), which will display as written; in this case, the total number of letters should be the number in the first parameter (15 in this example). Assigns page to a category of the same name (SATTB.SATTB.SATTB in this example), and to a category for number of voices (15-part choral music in this example).
    Commas indicate up to six alternate voicings (e.g., SAT,SATB,SST or SATB,SATTB), which will display with an or between them. The number of letters delimited by commas are usually the same (first example), but they could be different (second example). Assigns page to all the categories delimited by the commas (SAT, SAB, and SST in the first example, SATB and SATTB in the second), and to a category (or categories) for number of voices (3-part choral music in the first example; 4-part choral music and 5-part choral music in the second example).
  3. Optional substitute text. Plain text that will display in place of the second parameter. Cannot include a link or a template. Permissible punctuation marks: period (.) and comma (,). Please do not use special characters (such as  & # $ / \ | [ ] { } ).
add=. Text that will display after the voicing. It could include links or templates.

Coding for a single voice

  • If the work is for one voice, the second parameter could assign the work to a solo category, if you use code such as Solo Tenor or Solo Mezzo-Soprano. See Category:Solo vocal music for a list of possible categories, and template {{Solo}} for a list of substitutions; for example, the words solo bass will assign the work to {{:Category:Bass solo]]. Alternatively
  • If one of the choirs

Syntax with required first and second parameters:

which produces the text
Number of voices: 5vv   Voicing: SSATB
and inserts the page in category:SSATB and category:5-part choral music
which produces the text
Number of voices: 3vv   Voicings: ATB, SSA or STB
and inserts the page in category:ATB, category:SSA, category:STB, and category:3-part choral music

Syntax with required parameters and optional third parameter

The third parameter is plain text (no templates or links) which will be the display for the category linked to the second parameter
  • {{Voicing|4|SATB|SATB divisi}}
which produces the text
Number of voices: 4vv   Voicing: SATB divisi
and inserts the page in category:SATB and category:4-part choral music

Optional 'add' parameter

Use add=<any text> to append any text (which may include links or templates such as {{Vcat}}); this parameter will display at the end of the voicing specification; e.g.
  • {{Voicing|5|SATBB|SATBarB|add=with optional S {{pcat|descant|s}} }}
which produces the text
Number of voices: 5vv  Voicing: SATBarB, with optional S descant.
and inserts the page in category:SATBB, category:5-part choral music, and category:Descants

See also

}}