Template:MultiVoicing: Difference between revisions

From ChoralWiki
Jump to navigation Jump to search
m (put long voicing code inside "includeonly")
(documentation more-or-less finished)
Line 18: Line 18:


The purpose of this template is to provide for alternate/multiple (up to five) voicings on choral works pages, eg. pages for which there are, say, SSAA, SATB, and TTBB editions of a work.
The purpose of this template is to provide for alternate/multiple (up to five) voicings on choral works pages, eg. pages for which there are, say, SSAA, SATB, and TTBB editions of a work.
Here are all the parameters, with descriptive values:
<pre>{{Multicat
|v=numvoices|v_add=, with extra info
|n=numvoicings
|1st=1st voicing cat
|alt1st=alternate way to display 1st voicing cat link (defaults to 1st)
|1st_add=additional info after 1st/alt1st
|2nd=2nd voicing cat
|alt2nd=alternate way to display 2nd voicing cat link (defaults to 2nd)
|2nd_add=additional info after 2nd/alt2nd
...
|5th=5th voicing cat
|alt5th=alternate way to display 5th voicing cat link (defaults to 5th)
|5th_add=additional info after 5th/alt5th
|9=sortkey
}}</pre>
'''Notes:'''
* The "<nowiki>v=</nowiki>" part of, say "v=4-7", is optional, as long as the number of voices (4-7) is given as the first parameter.
* The parameter n (number of different voicings) if omitted, defaults to 1 voicing.
* If you want a space after, say 1st_add, then you must add it explicitly, either by typing "{{nbsp}}" (nonbreakable space) or the template "{{CiteTemp|sp|br=}}" (this template produces an ordinary space).


'''Syntax examples:'''
'''Syntax examples:'''
Line 28: Line 50:
|n=2
|n=2
|1st=SAATTTBB
|1st=SAATTTBB
|var1st=TrMzCtCtTBarBarB
|var1st=TrMACtTCtBB
|1st_add={{sp}}(SAATTTBB)
|2nd=SSAATTBB
|2nd=SSAATTBB
|var2nd=SSMzATTBarB
|var2nd=SSMzATTBarB
|2nd_add=, both with soli in each part
|2nd_add= (SSAATTBB), both with soli in each part
|9=Maria salvatoris Mater, O}}</pre>
|9=Maria salvatoris Mater, O}}</pre>


This produces:
This produces:


'''Number of voices:''' 8vv plus 8 soli. &nbsp; '''Voicings:''' {{CiteCat|SAATTTBB|TrMzCtCtTBarBarB}} and {{CiteCat|SSAATTBB|SSMzATTBarB}}, both with soli in each part.
'''Number of voices:''' 8vv plus 8 soli. &nbsp; '''Voicings:''' {{CiteCat|SAATTTBB|TrMACtTCtBB}} (SAATTTBB) and {{CiteCat|SSAATTBB|SSMzATTBarB}} (SSAATTBB), both with soli in each part.


The work is categorized in {{CiteCat|SAATTTBB}} and in {{CiteCat|SSAATTBB}}, both with sortkey "Maria salvatoris Mater, O".
The work is categorized in {{CiteCat|SAATTTBB}} and in {{CiteCat|SSAATTBB}}, both with sortkey "Maria salvatoris Mater, O".
For another example (which would be germaine to the Obrect ''Missa Sub presidium tuum''), we have:
<pre>{{MultiVoicing
|3-7|v_add={{sp}}increasing by one voice with each movement
|n=5
|1st=SAT|1st_add={{sp}}(''Kyrie'')
|2nd=SATB|2nd_add={{sp}}(''Gloria'')
|3rd=SSATB|3rd_add={{sp}}(''Credo'')
|4th=SSATTB|4th_add={{sp}}(''Sanctus'')
|5th=SSAATTB|5th_add={{sp}}(''Agnus Dei'')
}}</pre>
Note the use of {{CiteTemp|sp|br}} is preferred here to {{nbsp}}, because of the possibility of bad linebreaks.
{{MultiVoicing
|3-7|v_add={{sp}}increasing by one voice with each movement
|n=5
|1st=SAT|1st_add={{sp}}(''Kyrie'')
|2nd=SATB|2nd_add={{sp}}(''Gloria'')
|3rd=SSATB|3rd_add={{sp}}(''Credo'')
|4th=SSATTB|4th_add={{sp}}(''Sanctus'')
|5th=SSAATTB|5th_add={{sp}}(''Agnus Dei'')
}}


This example shows how [[Template:MultiVoicing]] can emulate [[Template:Voicing]]:
This example shows how [[Template:MultiVoicing]] can emulate [[Template:Voicing]]:

Revision as of 16:52, 20 November 2008

Number of voices: {{{1}}}vv.   Voicing:

Documentation

The purpose of this template is to provide for alternate/multiple (up to five) voicings on choral works pages, eg. pages for which there are, say, SSAA, SATB, and TTBB editions of a work.

Here are all the parameters, with descriptive values:

{{Multicat
|v=numvoices|v_add=, with extra info
|n=numvoicings
|1st=1st voicing cat
|alt1st=alternate way to display 1st voicing cat link (defaults to 1st)
|1st_add=additional info after 1st/alt1st
|2nd=2nd voicing cat
|alt2nd=alternate way to display 2nd voicing cat link (defaults to 2nd)
|2nd_add=additional info after 2nd/alt2nd
...
|5th=5th voicing cat
|alt5th=alternate way to display 5th voicing cat link (defaults to 5th)
|5th_add=additional info after 5th/alt5th
|9=sortkey
}}

Notes:

  • The "v=" part of, say "v=4-7", is optional, as long as the number of voices (4-7) is given as the first parameter.
  • The parameter n (number of different voicings) if omitted, defaults to 1 voicing.
  • If you want a space after, say 1st_add, then you must add it explicitly, either by typing "&nbsp;" (nonbreakable space) or the template "{{sp}}" (this template produces an ordinary space).

Syntax examples:

Here is a rather comprehensive (albeit probably arcane) example:

{{MultiVoicing
|v=8
|v_add= plus 8 soli
|n=2
|1st=SAATTTBB
|var1st=TrMACtTCtBB
|1st_add={{sp}}(SAATTTBB)
|2nd=SSAATTBB
|var2nd=SSMzATTBarB
|2nd_add= (SSAATTBB), both with soli in each part
|9=Maria salvatoris Mater, O}}

This produces:

Number of voices: 8vv plus 8 soli.   Voicings: TrMACtTCtBB (SAATTTBB) and SSMzATTBarB (SSAATTBB), both with soli in each part.

The work is categorized in SAATTTBB and in SSAATTBB, both with sortkey "Maria salvatoris Mater, O".

For another example (which would be germaine to the Obrect Missa Sub presidium tuum), we have:

{{MultiVoicing
|3-7|v_add={{sp}}increasing by one voice with each movement
|n=5
|1st=SAT|1st_add={{sp}}(''Kyrie'')
|2nd=SATB|2nd_add={{sp}}(''Gloria'')
|3rd=SSATB|3rd_add={{sp}}(''Credo'')
|4th=SSATTB|4th_add={{sp}}(''Sanctus'')
|5th=SSAATTB|5th_add={{sp}}(''Agnus Dei'')
}}

Note the use of br is preferred here to &nbsp;, because of the possibility of bad linebreaks.

Number of voices: 3-7vv increasing by one voice with each movement.   Voicings: SAT (Kyrie), SATB (Gloria), SSATB (Credo), SSATTB (Sanctus) and SSAATTB (Agnus Dei)


This example shows how Template:MultiVoicing can emulate Template:Voicing:

{{MultiVoicing|4|1st=SATB|var1st=SATB ''divisi''|9=Haven, The}}

produces

Number of voices: 4vv.   Voicing: SATB divisi

and categorizes the page in SATB with sortkey="Haven, The"

This construct is completely equivalent to

{{Voicing|4|SATB|SATB ''divisi''|9=The Haven}}