Template:Voicing: Difference between revisions
Jump to navigation
Jump to search
Documentation
(Further documentation) |
No edit summary |
||
(18 intermediate revisions by 2 users not shown) | |||
Line 9: | Line 9: | ||
|{{#if:{{#explode:{{{2}}}|,|4}} |'''Voicings:''' {{vcat|{{#explode:{{{2}}}|,|0}}}}, {{vcat|{{#explode:{{{2}}}|,|1}}}}, {{vcat|{{#explode:{{{2}}}|,|2}}}}, {{vcat|{{#explode:{{{2}}}|,|3}}}} or {{vcat|{{#explode:{{{2}}}|,|4}}}} | |{{#if:{{#explode:{{{2}}}|,|4}} |'''Voicings:''' {{vcat|{{#explode:{{{2}}}|,|0}}}}, {{vcat|{{#explode:{{{2}}}|,|1}}}}, {{vcat|{{#explode:{{{2}}}|,|2}}}}, {{vcat|{{#explode:{{{2}}}|,|3}}}} or {{vcat|{{#explode:{{{2}}}|,|4}}}} | ||
|{{#if:{{#explode:{{{2}}}|,|3}} |'''Voicings:''' {{vcat|{{#explode:{{{2}}}|,|0}}}}, {{vcat|{{#explode:{{{2}}}|,|1}}}}, {{vcat|{{#explode:{{{2}}}|,|2}}}} or {{vcat|{{#explode:{{{2}}}|,|3}}}} | |{{#if:{{#explode:{{{2}}}|,|3}} |'''Voicings:''' {{vcat|{{#explode:{{{2}}}|,|0}}}}, {{vcat|{{#explode:{{{2}}}|,|1}}}}, {{vcat|{{#explode:{{{2}}}|,|2}}}} or {{vcat|{{#explode:{{{2}}}|,|3}}}} | ||
|{{#if:{{#explode:{{{2}}}|,|2}} |'''Voicings:''' {{vcat|{{#explode:{{{2}}}|,|0}}}}, {{vcat|{{#explode:{{{2}}}|,|1}}}} or {{vcat|{{#explode:{{{2}}}|,|2}}}} | |{{#if:{{#explode:{{{2}}}|,|2}} |'''Voicings:''' {{vcat|{{#explode:{{{2}}}|,|0}}}}, {{vcat|{{#explode:{{{2}}}|,|1}}}} or {{vcat|{{#explode:{{{2}}}|,|2}}}} | ||
|{{#if:{{#explode:{{{2}}}|,|1}} |'''Voicings:''' {{vcat|{{#explode:{{{2}}}|,|0}}}} or {{vcat|{{#explode:{{{2}}}|,|1}}}} | |{{#if:{{#explode:{{{2}}}|,|1}} |'''Voicings:''' {{vcat|{{#explode:{{{2}}}|,|0}}}} or {{vcat|{{#explode:{{{2}}}|,|1}}}} | ||
|'''Voicing:''' {{#if:{{{3|}}} | {{vcat|{{{2}}}|{{{3}}}}} | {{vcat|{{{2}}}}} }} }} }} }} }} }}<!-- else --> | |'''Voicing:''' {{#if:{{{3|}}} | {{vcat|{{{2}}}|{{{3}}}}} | {{vcat|{{{2}}}}} }} }} }} }} }} }}<!-- else --> | ||
|'''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. Please do not use this template inside a template (such as {{tl|Descr}}, {{tl|EdNotes}}, or {{tl|Voicing}}): consider using {{tl|Vcat}} instead. 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> | ||
# '''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. | |||
# '''Identification of parts'''. If the music is for more than one voice, 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,SAB,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). | |||
# '''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> & # $ / \ | [ ] { } </nowiki></big></tt>'''). | |||
:'''<tt>add{{=}}</tt>'''. Text that will display after the voicing. It could include links or templates. | |||
<u><b>Coding for a single voice</b></u> | |||
* 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><nowiki>{{Voicing|1|Solo Tenor}}</nowiki></tt> or <tt><nowiki>{{Voicing|1|Solo Mezzo-Soprano}}</nowiki></tt>. See table below for a list of substitutions; for example, the words <tt>Solo Bass</tt> will assign the work to [[:Category:Solo Bass]] and display <font color=blue>Bass solo</font>. If you specify just one letter in parameter 2, for example <tt><nowiki>{{Voicing|1|S}}</nowiki></tt> or <tt><nowiki>{{Voicing|1|A}}</nowiki></tt>, this is for a unison choir of Sopranos or Altos, respectively. | |||
:'''<tt>add{{=}}</tt>'''. Text that will display after the voicing. It could include links or templates. | * If solos have been added to a choral work, you can use the <tt>add{{=}}</tt> parameter to designate which solos have been added (Example 5 below). | ||
'''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>}} | *'''Example 1.''' {{tl|Voicing|2=<font color="orange">5</font>|3=<font color="green">SSATB</font>}} | ||
:which produces the text | :which produces the text | ||
:: '''Number of voices:''' 5vv '''Voicing:''' {{CC|SSATB}} | :: '''Number of voices:''' 5vv '''Voicing:''' {{CC|SSATB}} | ||
:and inserts the page in [[: | :and inserts the page in [[:Category:SSATB]] and [[:Category:5-part choral music]] | ||
*{{tl|Voicing|2=<font color="orange">3</font>|3=<font color="green">ATB,SSA,STB</font>}} | *'''Example 2.''' {{tl|Voicing|2=<font color="orange">3</font>|3=<font color="green">ATB,SSA,STB</font>}} | ||
:which produces the text | :which produces the text | ||
:: '''Number of voices:''' 3vv '''Voicings:''' {{CC|ATB}}, {{CC|SSA}} or {{CC|STB}} | :: '''Number of voices:''' 3vv '''Voicings:''' {{CC|ATB}}, {{CC|SSA}} or {{CC|STB}} | ||
:and inserts the page in [[: | :and inserts the page in [[:Category:ATB]], [[:Category:SSA]], [[:Category:STB]], and [[:Category:3-part choral music]] | ||
'''Syntax with required parameters and optional <font color="green">third</font> parameter''' | '''Syntax with required parameters and optional <font color="green">third</font> parameter''' | ||
: The third parameter is plain text (no templates or links) which will be the display for the category linked to the <u>second</u> parameter | : The third parameter is plain text (no templates or links) which will be the display for the category linked to the <u>second</u> parameter | ||
*<tt><nowiki>{{Voicing|4|SATB|</nowiki><font color="green">SATB divisi</font><nowiki>}}</nowiki></tt> | *'''Example 3.''' <tt><nowiki>{{Voicing|4|SATB|</nowiki><font color="green">SATB divisi</font><nowiki>}}</nowiki></tt> | ||
:which produces the text | :which produces the text | ||
:: '''Number of voices:''' 4vv '''Voicing:''' {{CC|SATB|SATB divisi}} | :: '''Number of voices:''' 4vv '''Voicing:''' {{CC|SATB|SATB divisi}} | ||
:and inserts the page in [[: | :and inserts the page in [[:Category:SATB]] and [[:Category:4-part choral music]] | ||
''' | '''Syntax with optional 'add' parameter''' | ||
:Use <nowiki>add=<any text></nowiki> to append any text (which may include links or templates such as {{tl|Vcat}}); this parameter will display at the end of the voicing specification | :Use <nowiki>add=<any text></nowiki> to append any text (which may include links or templates such as {{tl|Vcat}}); this parameter will display at the end of the voicing specification | ||
*<tt><nowiki>{{Voicing|5|SATBB|SATBarB|add=with optional S {{pcat|descant|s}} }}</nowiki></tt> | *'''Example 4.''' <tt><nowiki>{{Voicing|5|SATBB|SATBarB|add=with optional S {{pcat|descant|s}} }}</nowiki></tt> | ||
:which produces the text | :which produces the text | ||
:: '''Number of voices:''' 5vv '''Voicing:''' {{CC|SATBB|SATBarB}}, with optional S {{CC|descants|descant}}. | :: '''Number of voices:''' 5vv '''Voicing:''' {{CC|SATBB|SATBarB}}, with optional S {{CC|descants|descant}}. | ||
:and inserts the page in [[:Category:SATBB]], [[:Category:5-part choral music]], and [[:Category:Descants]] | |||
*'''Example 5.''' <tt><nowiki>{{Voicing|8|SATB.SATB|add=with {{cat|Solo Alto|Alto}} and {{cat|Solo Tenor|Tenor}} solos.}}</nowiki></tt> | |||
:which produces the text | |||
:: '''Number of voices:''' 8vv '''Voicing:''' {{CC|SATB.SATB}}, with {{CC|Solo Alto|Alto}} and {{CC|Solo Tenor|Tenor}} solos. | |||
:and inserts the page in [[:Category:SATB.SATB]], [[:Category:8-part choral music]], [[:Category:Solo Alto]], and [[:Category:Solo Tenor]] | |||
===See also=== | ===See also=== | ||
* [[Template:MultiVoicing]] | {{top}} | ||
* [[Help:Voicing]] | * [[Template:MultiVoicing]] – A more complex way | ||
* [[:Category:Voicing]] – The top category | |||
* [[ChoralWiki:Voicing categories]] – A list of all categories available for use in voicing | |||
* [[Help:Voicing]] – A few instructions | |||
{{mdl}} | |||
* [[Template:Vcat]] – For adding a voice category and a category for number of voices | |||
* [[Template:Pcat]] – For adding a plural category that displays as singular (e. g., {{CC|Descants}}) | |||
{{btm}} | |||
}} | }} | ||
===Words to use when coding parameter 2 for solo voices=== | |||
{{top}} | |||
{|class=wikitable sortable align="center" | |||
!You enter | |||
!Resulting category | |||
!Display | |||
|- | |||
|Solo AA||Solo AA||<font color=blue>Alto duo</font> | |||
|- | |||
|Solo AB||Solo AB||<font color=blue>Solo AB</font> | |||
|- | |||
|Solo Alto||Solo Alto||<font color=blue>Alto solo</font> | |||
|- | |||
|Solo AT||Solo AT||<font color=blue>Alto-Tenor duo</font> | |||
|- | |||
|Solo ATB||Solo ATB||<font color=blue>ATB soli</font> | |||
|- | |||
|Solo BarB||Solo BarB||<font color=blue>Baritone-Bass duo</font> | |||
|- | |||
|Solo Baritone||Solo Baritone||<font color=blue>Baritone solo</font> | |||
|- | |||
|Solo Bass||Solo Bass||<font color=blue>Bass solo</font> | |||
|- | |||
|Solo BB||Solo BB||<font color=blue>Bass duo</font> | |||
|- | |||
|Solo BBB||Solo BBB||<font color=blue>BBB soli</font> | |||
|- | |||
|Solo Countertenor||Solo Countertenor||<font color=blue>Countertenor solo</font> | |||
|- | |||
|Solo CtCt||Solo CtCt||<font color=blue>Countertenor duo</font> | |||
|- | |||
|Solo high||Solo high||<font color=blue>Solo high</font> | |||
|- | |||
|Solo low||Solo low||<font color=blue>Solo low</font> | |||
|- | |||
|Solo medium||Solo medium||<font color=blue>Solo medium</font> | |||
|- | |||
|Solo Mezzo-soprano||Solo Mezzo-soprano||<font color=blue>Mezzo-Soprano solo</font> | |||
|- | |||
|Solo SA||Solo SA||<font color=blue>Soprano-Alto duo</font> | |||
|- | |||
|Solo SAB||Solo SAB||<font color=blue>SAB soli</font> | |||
|- | |||
|Solo SATB||Solo SATB||<font color=blue>SATB soli</font> | |||
|- | |||
|Solo SATTB||Solo SATTB||<font color=blue>SATTB soli</font> | |||
|- | |||
|} | |||
{{mdl}} | |||
{|class=wikitable sortable | |||
!You enter | |||
!Resulting category | |||
!Display | |||
|- | |||
|Solo SB||Solo SB||<font color=blue>Soprano-Bass duo</font> | |||
|- | |||
|Solo SCtB||Solo SCtB||<font color=blue>SCtB soli</font> | |||
|- | |||
|Solo Soprano||Solo Soprano||<font color=blue>Soprano solo</font> | |||
|- | |||
|Solo SS||Solo SS||<font color=blue>Soprano duo</font> | |||
|- | |||
|Solo SSATB||Solo SSATB||<font color=blue>SSATB soli</font> | |||
|- | |||
|Solo SSB||Solo SSB||<font color=blue>SSB soli</font> | |||
|- | |||
|Solo SSBB||Solo SSBB||<font color=blue>SSBB soli</font> | |||
|- | |||
|Solo SSSB||Solo SSSB||<font color=blue>SSSB soli</font> | |||
|- | |||
|Solo SST||Solo SST||<font color=blue>SST soli</font> | |||
|- | |||
|Solo SSTB||Solo SSTB||<font color=blue>Solo SSTB</font> | |||
|- | |||
|Solo SSTT||Solo SSTT||<font color=blue>SSTT soli</font> | |||
|- | |||
|Solo ST||Solo ST||<font color=blue>Soprano-Tenor duo</font> | |||
|- | |||
|Solo STB||Solo STB||<font color=blue>STB soli</font> | |||
|- | |||
|Solo STTB||Solo STTB||<font color=blue>STTB soli</font> | |||
|- | |||
|Solo STBB||Solo STBB||<font color=blue>STBB soli</font> | |||
|- | |||
|Solo TB||Solo TB||<font color=blue>Tenor-Bass duo</font> | |||
|- | |||
|Solo Tenor||Solo Tenor||<font color=blue>Tenor solo</font> | |||
|- | |||
|Solo TT||Solo TT||<font color=blue>Tenor duo</font> | |||
|- | |||
|Solo TTB||Solo TTB||<font color=blue>TTB soli</font> | |||
|- | |||
|Solo voice||Solo voice||<font color=blue>Solo voice</font> | |||
|- | |||
|} | |||
[[Category:Templates]]</noinclude> | [[Category:Templates]]</noinclude> |
Latest revision as of 19:28, 16 April 2023
This high-risk template has been protected from editing to prevent vandalism. Please use the talk page to ask an administrator about making an edit to change this template. |
This template is intended for use in a work page, to display the number of voices and the voicing of the original work. Please do not use this template inside a template (such as {{Descr}}, {{EdNotes}}, or {{Voicing}}): consider using {{Vcat}} instead. It has two required parameters and two optional parameters. The second and third parameters are converted to links pointing to voicing categories.
Parameters
- 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.
- Identification of parts. If the music is for more than one voice, 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,SAB,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). - 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 {{Voicing|1|Solo Tenor}} or {{Voicing|1|Solo Mezzo-Soprano}}. See table below for a list of substitutions; for example, the words Solo Bass will assign the work to Category:Solo Bass and display Bass solo. If you specify just one letter in parameter 2, for example {{Voicing|1|S}} or {{Voicing|1|A}}, this is for a unison choir of Sopranos or Altos, respectively.
- If solos have been added to a choral work, you can use the add= parameter to designate which solos have been added (Example 5 below).
Syntax with required first and second parameters:
- Example 1. {{Voicing|5|SSATB}}
- which produces the text
- Number of voices: 5vv Voicing: SSATB
- and inserts the page in Category:SSATB and Category:5-part choral music
- Example 2. {{Voicing|3|ATB,SSA,STB}}
- which produces the text
- 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
- Example 3. {{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
Syntax with 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
- Example 4. {{Voicing|5|SATBB|SATBarB|add=with optional S {{pcat|descant|s}} }}
- which produces the text
- and inserts the page in Category:SATBB, Category:5-part choral music, and Category:Descants
- Example 5. {{Voicing|8|SATB.SATB|add=with {{cat|Solo Alto|Alto}} and {{cat|Solo Tenor|Tenor}} solos.}}
- which produces the text
- and inserts the page in Category:SATB.SATB, Category:8-part choral music, Category:Solo Alto, and Category:Solo Tenor
See also
|
|
Words to use when coding parameter 2 for solo voices
|
|