Template:Voicing: Difference between revisions

From ChoralWiki
Jump to navigation Jump to search
mNo edit summary
No edit summary
(One intermediate revision by the same user not shown)
Line 24: Line 24:
<u><b>Coding for a single voice</b></u>
<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.  
* 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.  
* If one of the choirs
* 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">SStATB</font>}}
*'''Example 1.''' {{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}}
:and inserts the page in [[:category:SSATB]] and [[:category:5-part choral music]]
: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&nbsp;&nbsp;&nbsp;'''Voicings:''' {{CC|ATB}}, {{CC|SSA}} or {{CC|STB}}
:: '''Number of voices:''' 3vv&nbsp;&nbsp;&nbsp;'''Voicings:''' {{CC|ATB}}, {{CC|SSA}} or {{CC|STB}}
:and inserts the page in [[:category:ATB]], [[:category:SSA]], [[:category:STB]], and [[:category:3-part choral music]]
: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&nbsp;&nbsp;&nbsp;'''Voicing:''' {{CC|SATB|SATB divisi}}
:: '''Number of voices:''' 4vv&nbsp;&nbsp;&nbsp;'''Voicing:''' {{CC|SATB|SATB divisi}}
:and inserts the page in [[:category:SATB]] and [[:category:4-part choral music]]
:and inserts the page in [[:Category:SATB]] and [[:Category:4-part choral music]]


'''Optional 'add' parameter'''
'''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; e.g.
: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&nbsp;&nbsp;'''Voicing:''' {{CC|SATBB|SATBarB}}, with optional S {{CC|descants|descant}}.  
:: '''Number of voices:''' 5vv&nbsp;&nbsp;'''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]]
: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&nbsp;&nbsp;'''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]]
* [[Template:MultiVoicing]] – A more complex way
* [[Help:Voicing]]
* [[:Category:Voicing]] – The top category
* [[ChoralWiki:Voicing categories]] – A list of all categories available for use in voicing
* [[Help:Voicing]] – A few instructions
}}
}}



Revision as of 15:49, 20 July 2021

Documentation

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 {{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:

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
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
  • 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
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
  • Example 5. {{Voicing|8|SATB.SATB|add=with {{cat|Solo Alto|Alto}} and {{cat|Solo Tenor|Tenor}} solos.}}
which produces the text
Number of voices: 8vv  Voicing: SATB.SATB, with Alto and Tenor solos.
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 single voices

You enter Resulting category Display
Solo AA Solo AA Alto duo
Solo AB Solo AB Solo AB
Solo Alto Solo Alto Alto solo
Solo AT Solo AT Alto-Tenor duo
Solo ATB Solo ATB ATB soli
Solo BarB Solo BarB Baritone-Bass duo
Solo Baritone Solo Baritone Baritone solo
Solo Bass Solo Bass Bass solo
Solo BB Solo BB Bass duo
Solo BBB Solo BBB BBB soli
Solo Countertenor Solo Countertenor Countertenor solo
Solo CtCt Solo CtCt Countertenor duo
Solo high Solo high Solo high
Solo low Solo low Solo low
Solo medium Solo medium Solo medium
Solo Mezzo-soprano Solo Mezzo-soprano Mezzo-Soprano solo
Solo SA Solo SA Soprano-Alto duo
Solo SAB Solo SAB SAB soli
Solo SATB Solo SATB SATB soli
Solo SATTB Solo SATTB SATTB soli
You enter Resulting category Display
Solo SB Solo SB Soprano-Bass duo
Solo SCtB Solo SCtB SCtB soli
Solo Soprano Solo Soprano Soprano solo
Solo SS Solo SS Soprano duo
Solo SSATB Solo SSATB SSATB soli
Solo SSB Solo SSB SSB soli
Solo SSBB Solo SSBB SSBB soli
Solo SSSB Solo SSSB SSSB soli
Solo SST Solo SST SST soli
Solo SSTB Solo SSTB Solo SSTB
Solo SSTT Solo SSTT SSTT soli
Solo ST Solo ST Soprano-Tenor duo
Solo STB Solo STB STB soli
Solo STTB Solo STTB STTB soli
Solo TB Solo TB Tenor-Bass duo
Solo Tenor Solo Tenor Tenor solo
Solo TT Solo TT Tenor duo
Solo TTB Solo TTB TTB soli
Solo voice Solo voice Solo voice