Difference between revisions of "Template:Voicing"

From ChoralWiki
Jump to navigation Jump to search
(More documentation)
m
Line 19: Line 19:
 
:'''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.
 
:'''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.
 
:::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.
 
:::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.
:'''2. Identification of parts'''. A string of letters <u>only</u> the letters <tt>B T A S</tt>, with no spaces. It is possible to use one of two punctuation marks within the string: period (.) or comma (,).  
+
:'''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 (,).  
 
::*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).
 
::*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).
 
::*Commas indicate up to six optional 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).
 
::*Commas indicate up to six optional 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).

Revision as of 18:13, 5 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.

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: but it is recommended to use one integer (e.g., 8 or 16), and explain further in following parameters.
2. Identification of parts. A string of letters only the letters S A T B, with no spaces. 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).
  • Commas indicate up to six optional voicings (e.g., SAT,SAB,SST), which will display with or 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 (SAT, SAB, and SST 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.
Please do not use special characters (such as & # $ / \ | [ ] ).
add=. Text that will display after the voicing. It could include links or templates. Please do not use special characters.

Syntax with required first and second parameters:

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

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

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.

See also