Help:CPDL Templates: Difference between revisions

From ChoralWiki
Jump to navigation Jump to search
m (Some more templates)
(added symbol for Capella Files)
(47 intermediate revisions by 6 users not shown)
Line 1: Line 1:
Welcome to the ChoralWiki Template page. Here are a list of useful templates that exist on CPDL.  
This is a shorthand reference to the most useful templates that exist on CPDL; for exact syntax and usage, there may be a discussion page associated with the particular template. Click on the template names for more details. Text in examples ''in italics'' indicates where you should enter a variable, ie. a value which is different depending on the situation.
 
'''See also:''' [[:Category:Templates|Category of frequently used templates]].


===General purpose templates===
===General purpose templates===
''These templates are found on many different pages.''
''These templates are found on many different pages.''


{| border="1" valign="top"  
{| border="1" valign="top" cellspacing="0" cellpadding="5"
|-
| {{tl|Legend}}
| A ubiquitous template used on composer and works pages to describe common icons and symbols for obtaining CPDL editions.
|-
| {{tl|Broken}}
| A template used to mark broken links to PDF, MIDI or any other types of files.
|-
| {{tl|PermBroken}}
| A template used to mark permanently broken links to PDF, MIDI or any other types of files.
|-
| {{tl|Merge}}
| A template for marking 2 or more pages to be merged. If necessary, discussion should take place on the article talk page.
|-
| {{tl|Split}}
| A template for marking a page to be split into 2 or more separate pages. If necessary, discussion should take place on the article talk page.
|-
|-
| <nowiki>{{Legend}}</nowiki>
| {{tl|Delnow}}
| A ubiqitous template used on composer and works pages to describe common icons and symbols for obtaining CPDL editions.
| A template used to mark a page for immediate deletion.
|-
| {{tl|Delreq}}
| A template used to propose a page for deletion. Discussion should take place on the article talk page.
|}
|}


===Composer templates===
===Composer templates===
''These templates are usually found on composer pages.''
''These templates are usually found on composer pages.''
{| border="1" valign="top" cellspacing="0" cellpadding="5"
|-
| {{tl|NoWorks}}
| A template to state that there are currently no editions of any works by the composer on CPDL. It should be added to a composer page below <tt><nowiki>{{Legend}}</nowiki></tt> but only for composers whose works are in the [[Help:When does music enter the public domain?|public domain]].
|-
| {{tl|WikipediaLink}}
| A template to provide a link from a composer page to the article on [[Wikipedia:Main Page|Wikipedia]].
|-
| {{tl|WikipediaLink2}}
| A template to provide a link from a composer page to the article on [[Wikipedia:Main Page|Wikipedia]] when all or the majority of the biography on the CPDL page has been copied verbatim from Wikipedia.
|-
| {{tl|AffiliateLink}}<br>
{{tl|AffiliateLink2}}
| Templates which provide a link to CPDL's affiliate, [http://www.sheetmusicplus.com/a/home.html?id=154015 Sheet Music Plus] Use AffiliateLink2 if the composer's works are out of Copyright; use AffiliateLink if only some of the composer's works are out of Copyright.
|-
| {{tl|CompCopyrightWarning}}
| A template to warn users that some or all of the composer's works hosted on or linked from CPDL may not be public domain worldwide.
|}
===Music files templates===
''These templates are usually found on score pages under the music files heading.''
{| border="1" valign="top" cellspacing="0" cellpadding="5"
|-
| {{tl|Editor|''name''|''date''}}<br> {{tl|Editor|''2''|''name1''|''name2''|''date''}}<br> {{tl|Editor|''3''|''name1''|''name2''|''name3''|''date''}}<br>{{tl|Editor|edtype{{eq}}Contributor|''name''|''date''}}
| A template which adds a link to the page of the editor (or editors) who has added a score, and likewise the date the score was added to CPDL. This is usually placed on the line directly after the '''''CDPL #''''' entry which provides links to the score itself.  In the last form, "edtype=Contributor" changes the word "Editor" to "Contributor".
|-
| {{tl|ScoreInfo|''page&nbsp;size''|''#&nbsp;pages''|''kBytes''}}
| A template used to format the information about a score: the size of paper used, the number of pages, and download size. This usually follows straight after the ''Editor'' template above; e.g., <tt><nowiki>{{ScoreInfo|A4|2|20}}</nowiki></tt> returns the text '''Score information:''' A4, 2 pages, 20 kbytes
|-
| {{tl|Copy|''copyright type''}}
| A template used to add a link to the copyright description for the edition, this usually follows directly after the ''ScoreInfo'' template above. For example, the template <tt><nowiki>{{Copy|CPDL}}</nowiki></tt> returns the text '''Copyright:''' [[ChoralWiki:CPDL|CPDL]], which link to the CPDL copyright page; several other types of copyright have pages, eg. [[ChoralWiki:Personal|Personal]], [[ChoralWiki:Religious|Religious]] or [[ChoralWiki:Public Domain]].
|-
| {{tl|CopyCC|''copyright type''}}
| A variation on <tt><nowiki>{{Copy}}</nowiki></tt> used to add a link to the [[ChoralWiki:Creative Commons|Creative Commons]] copyright description for the edition. For example, the template <tt><nowiki>{{CopyCC|Attribution 3.0 Unported}}</nowiki></tt> returns the text '''Copyright:''' [[ChoralWiki:Creative Commons#Attribution 3.0 Unported|Creative Commons Attribution 3.0 Unported]], which link to the Creative Commons copyright page and scrolls down to the "Attribution 3.0 Unported" anchor. If the specific license is not listed, simply edit the page and add it in the same way as the others.
|-
| {{tl|ScoreError|''errors''}}
| A template used for adding a note to a particular edition, describing a musical error in the score. A short discussion of the error(s) may be added after the vertical bar; a large number of errors should be reported separately in the linked discussion page. This template adds the work in question to the [[:Category:Sheet music errors]] category.
|-
| {{tl|KbdVer}}
| A template used only under the "edition notes" section of a score entry to state that the edition "Includes a keyboard version of the original accompaniment" and add the page to [[:Category:Keyboard version]].
|-
| {{tl|KbdRed}}
| A template used only under the "edition notes" section of a score entry to state that the edition "Includes a keyboard reduction of the a cappella choral score" and add the page to [[:Category:Keyboard reduction]].
|-
| {{tl|FinaleReader}}
| A template used under the "edition notes" section of a score entry to point users to the [[CW:DT|Downloadable tools]] page where they may download Finale Reader, software which will view and print Finale files.
|-
| {{tl|NWC}}
| A template used under the "edition notes" section of a score entry to point users to the [[CW:DT|Downloadable tools]] page where they may download NoteWorthy Composer Viewer, software which will view and print NoteWorthy Composer files.
|}


===Works templates===
===Works templates===
''These templates are usually found on score pages.''
''These templates are usually found on score pages.''


{| border="1" valign="top"  
{| border="1" valign="top" cellspacing="0" cellpadding="5"
|-
|-
| <nowiki>{{2editions}}</nowiki>
| {{tl|Editions|''n''}}
| A series of templates used to mark works that have more than one edition. This is not for counting the number of files, but only the number of separate editions on a given page. Similarly named templates exist for works with 3, 4, and more editions available.
| A series of templates used to mark works that have more than one edition. This is not for counting the number of files, but only the number of separate editions on a given page. Similarly named templates exist for works with 3, 4, and more editions available.
|-
|-
| <nowiki>{{UnfinishedWork}}</nowiki>
| {{tl|UnfinishedWork}}
| A template used for a work that a composer did not complete, or has been partially lost subsequently.
| A template used for a work that a composer did not complete, or has subsequently been partially lost. This is usually placed directly after the '''''Title:''''' and '''''Composer:''''' entries, or alternately at the top of the page.
|-
|-
| <nowiki>{{IncompleteEdition}}</nowiki>
| {{tl|IncompleteEdition}}
| A template used for an edition that is missing sections.
| A template used for an edition that is missing sections.
|-
|-
| <nowiki>{{MisattributedWork}}</nowiki>
| {{tl|MisattributedWork}}<br/> {{tl|MisattributedWork|''comments''}}
| A template used for a work which has been attributed to a composer incorrectly. This is an aid for users who may not know the correct composer. This template adds the work in question to the [[:Category:Misattributed compositions]] category.
| A template used for a work which has been attributed to a composer incorrectly. This is an aid for users who may not know the correct composer. This template adds the work in question to the {{CiteCat|Misattributed compositions}} category.
|-
|-
| <nowiki>{{Cleanup|errors}}</nowiki>
| {{tl|Cleanup|''errors''}}
| A template used on a page that has broken formatting, or incorrect or missing information. A short description of the problems with the page may be entered after the vertical bar. This template adds the work in question to the [[:Category:Pages awaiting cleanup]] category.
| A template used on a page that has broken formatting, or incorrect or missing information. A short description of the problems with the page may be entered after the vertical bar. This template adds the work in question to the {{CiteCat|Pages awaiting cleanup}} category.
|-
|-
| <nowiki>{{BrahmsScores}}</nowiki>
| {{tl|Composer|''composer&nbsp;name''}}
| A template used for further categorizing a composer's works (in this case, '''''Brahms''''', other composer templates may be created in the future). Most comonly used when one wishes to organize compositions in two different ways (i.e. alphabetically and by opus/catalog number).
| A template used to format the name of the composer, and to generate a category entry (e.g. {{CiteCat|William Byrd compositions}}). Currently it is required in order for a work to be included in the online [[ChoralWiki:Score catalog|Score catalog]].
|-
| {{tl|Lyricist|''lyricist&nbsp;name''}}
| A template used to format the name of the lyricist, and to generate a category entry (e.g. {{CiteCat|William Shakespeare settings}}). This is obviously more useful for lyricists with a large body of work represented on CPDL, but the template should be used even if there is a limited representation.
|-
| {{tl|Genre|''Sacred''|''Motets''}}
| A template used to format the entry for the genre of the vocal work. The first field is expected to be either "Sacred" or "Secular"; the second to fourth fields can be any of the various subgenres available. The page is also automatically added to the proper categories. In this example, the categories for such a work will be {{CiteCat|Sacred music}} and {{CiteCat|Motets}}.
|-
| {{tl|Language|''language''}}<br/> {{tl|Language|''2''|''language1''|''language2''}}
| A template used to format the entry for the language of the vocal work, to generate a link to the appropriate category entry (e.g. {{CiteCat|Italian texts}}) and to add a category to the score page . Multiple languages are catered for by inserting the number (2 or 3) as the first parameter.
|-
| {{tl|Instruments|''description''}}
| This template scans the ''description'' text for names of instruments (or for ''a cappella'') and automatically categorizes the page under the corresponding categories.
|-
| {{tl|CopyrightWarning}}
| A template to warn users that the work listed on the score page may not be public domain worldwide.
|}
====Voicing templates====
''There are several templates which may be combined to describe the vocal forces called for by a particular work. See also {{CiteCat|voicing}}.  
{| border="1" valign="top" cellspacing="0" cellpadding="5"
|-
| {{tl|Voicing|''1''|''T''|''Unison Tenor''}}
| A template used to format the entry for the voicing of the vocal work. The first field generates the start of the line, '''''Number of voices:''' 1v'', and the second and third fields generate a link to the appropriate category entry, and the text to be displayed. The page is also automatically added to the category. In this case, the correct category for such a work is {{CiteCat|T}}, but the displayed text, '''''Voicing:''' {{CiteCat|T|Unison Tenor}}'' is more helpful for reading.
|-
| {{tl|MultiVoicing}}
| This enhanced version of {{CiteTemp|Voicing}} is intended for works with multiple or complex voicings. Please refer to the template's documentation for the proper syntax.
|-
| {{tl|Vcat|''voicing''}}
| Vcat simultaneously displays a link to a Voice category (e.g., {{CiteCat|SATB}}) and categorizes the page under that category. More importantly, it calculates the number of parts involved and categorizes the work under one of the {{CiteCat|Voicing|''N''-part choral music}} categories. This information is useful when searching for works with a specific number of parts regardless of voicing. Both templates {{CiteTemp|Voicing}} and {{CiteTemp|MultiVoicing}} use Vcat internally, but it can also be used independently or as a complement to Voicing.
|}
|}


===Music files templates===
====Accompaniment templates====
''These templates are usually found on score pages under the music files heading.''
''These templates are usually found on the "Instruments" line of score pages. See also {{tl|instruments}}, and some other recent additions at [[:Category:Accompaniment templates]].


{| border="1" valign="top"  
{| border="1" valign="top" cellspacing="0" cellpadding="5"
|-
| {{tl|acap}}
| For an ''a cappella'' work.
|-
| {{tl|BsCont}}
| For a work with bass continuo accompaniment.
|-
|-
| <nowiki>{{Editor|name|date}}</nowiki>
| {{tl|BrassAcc}}
| A template which adds a link to the page of the editor who has added a score, and likewise the date the score was added to CPDL. This is usually placed on the line directly after the '''''CDPL #''''' entry which provides links to the score itself.
| For a work with brass accompaniment.
|-
|-
| <nowiki>{{ScoreInfo|Page size|# of pages|File size}}</nowiki>
| {{tl|FluteAcc}}
| A template used to format the information about a score: the size of paper used, the number of pages, and download size. This usually follows straight after the ''Editor'' template above; e.g., <nowiki>{{ScoreInfo|A4|2|20}}</nowiki> returns the text '''Score information:''' A4, 2 pages, 20 kbytes
| For a work with flute accompaniment.
|-
|-
| <nowiki>{{Copy|copyright type}}</nowiki>
| {{tl|GtrAcc}}
| A template used to add a link to the copyright description for the vocal work, this usually follows directly after the ''ScoreInfo'' template above. For example, the template <nowiki>{{Copy|CPDL}}</nowiki> returns the text '''Copyright:''' [[ChoralWiki:CPDL|CPDL]], which link to the CPDL copyright page; several other types of copyright are linked (e.g. Personal).
| For a work with guitar accompaniment.
|-
|-
| <nowiki>{{Edition}}</nowiki>
| {{tl|HarpAcc}}
| A simple template used to format the text '''Edition notes:''' on a new line.
| For a work with harp accompaniment.
|-
|-
| <nowiki>{{ScoreError|errors}}</nowiki>
| {{tl|HpsichdAcc}}
| A template used for adding a note to a particular edition, describing a musical error in the score. A short discussion of the error(s) may be added after the vertical bar; a large number of errors should be reported separately in the linked discussion page. This template adds the work in question to the [[:Category:Sheet music errors]] category.
| For a work with harpsichord accompaniment.
|-
| {{tl|JazzAcc}}
| For a work with jazz band accompaniment.
|-
| {{tl|KbdAcc}}
| For a work with keyboard accompaniment.
|-
| {{tl|KbdRed}}
| For reductions of ''a cappella'' works [[Category talk:Keyboard reduction|(See discussion)]]
|-
| {{tl|KbdVer}}
| For reductions of orchestra accompaniments.
|-
| {{tl|LuteAcc}}
| For a work with lute accompaniment.
|-
| {{tl|MxEnsAcc}}
| For a work with mixed ensemble accompaniment.
|-
| {{tl|OrchAcc}}
| For a work with orchestra accompaniment.
|-
| {{tl|OrgAcc}}
| For a work with organ accompaniment.
|-
| {{tl|PercAcc}}
| For a work with percussion accompaniment.
|-
| {{tl|PnoAcc}}
| For a work with piano accompaniment.
|-
| {{tl|StrAcc}}
| For a work with string ensemble accompaniment.
|-
| {{tl|ViolAcc}}
| For a work with viol consort accompaniment.
|-
| {{tl|WindAcc}}
| For a work with wind ensemble accompaniment.
|}
|}


===General information templates===
===Image templates===
''These templates are usually found on score pages under the general information heading.''
''Self explanatory templates for generating icons for PDF, MIDI files, and the like.''


{| border="1" valign="top"  
{| border="1" valign="top" cellspacing="0" cellpadding="5"
|-
|-
| <nowiki>{{UnfinishedWork}}</nowiki>
| {{tl|pdf}}
| A template used for a work that a composer did not complete. This is usually placed directly after the '''''Title:''''' and '''''Composer:''''' entries, or alternately at the top of the page.
| {{pdf}}
| Portable Document Format (PDF) files.
|-
|-
| <nowiki>{{Composer|William Byrd}}</nowiki>
| {{tl|mid}}
| A template used to format the name of the composer, and to generate a category entry (in this case, it adds the work to the category '''''William Byrd compositions'''''). This is obviously more useful for composers with a large body of work represented on CPDL; there is little point assigning a category for composers with a handful of works.
| {{mid}}
| MIDI sound files.
|-
|-
| <nowiki>{{Voicing|1|T|Tenor solo}}</nowiki>
| {{tl|net}}
| A template used to format the entry for the voicing of the vocal work. The first field generates the start of the line, '''''Number of voices:''' 1vv'', and the second and third fields generate a link to the appropriate category entry, and the text to be displayed. The page is also automatically added to the category. In this case, the correct category for such a work is [[:Category:T]], but the displayed text, '''''Voicing:''' [[:Category:T|Tenor solo]]'' is more helpful for reading.
| {{net}}
| A link to an external webpage which has links to files.
|-
|-
| <nowiki>{{Language|Italian}}</nowiki>
| {{tl|mp3}}
| A template used to format the entry for the language of the vocal work, and to generate a link to the appropriate category entry (in this case, it creates a link to the category '''''Italian texts'''''). Do '''not''' use the template for works with texts in ''more than one language''; putting two languages into the variable field will create a link to a non-existent category.
| {{mp3}}
| MP3 files.
|-
|-
| <nowiki>{{UnfinishedWork}}</nowiki>
| {{tl|ly}}
| A template used for a work that a composer did not complete.
| {{ly}}
| LilyPond files.
|-
| {{tl|Capx}}
| {{Capx}}
| Capella files.
|-
| {{tl|mp4}}
| {{mp4}}
| MP4 videos.
|-
| {{tl|extpdf}}
| {{extpdf}}
| A direct link to a PDF hosted on an external site.
|-
| {{tl|extmid}}
| {{extmid}}
| A direct link to a MIDI hosted on an external site.
|-
| {{tl|extmp3}}
| {{extmp3}}
| A direct link to an MP3 hosted on an external site.
|-
| {{tl|extly}}
| {{extly}}
| A direct link to a LilyPond file hosted on an external site.
|}
|}


===Text & translation templates===
''These templates may be on score pages, or on text pages.''


===Text/translation templates===
{| border="1" valign="top" cellspacing="0" cellpadding="5"
 
''These templates may be on score pages, or on text pages.''
{| border="1" valign="top"
|-
|-
| <nowiki>{{Text|Latin}}</nowiki>  
| {{tl|Text|''language''}}<br> {{tl|Text|2|''language1''|''language2''}}<br> {{tl|Text|3|''language1''|''language2''|''language3''}} 
| A template to use when the text for a work is available on a given page. The variable '''''Latin''''' can be replaced with any language. Using this template automatically causes the page to be listed under the [[:Category:Texts-translations]] category.
| A template to use when the text for a work is available on a given page. Macaronic text can also be represented with this template, as shown in the other examples. Using this template automatically causes the page to be listed under the [[:Category:Texts]] and under the specific '''''Language'' texts''' category. If more than one language is informed, it is also included in [[:Category:Macaronic texts]].
|-
|-
| <nowiki>{{Translation|English}}</nowiki>
| {{tl|Translation|''language''}}  
| A template to use when the translation for a work is available on a given page (use the above template for the original text). The variable '''''English''''' can be replaced with any language. If a work is set in the original language and a translated language, use the <nowiki>{{Text|Language}}</nowiki> template.
| A template to use when the translation for a work is available on a given page (use the above template for the original text). Using this template automatically causes the page to be listed under the [[:Category:Translations]] and under the specific '''''Language'' translations''' category. If a work is set in the original language and a translated language, use the {{tl|Text|Language}} template.
|-
|-
| <nowiki>{{LinkText|Ave Maria}}</nowiki>
| {{tl|LinkText|''Ave Maria''}}
| A template that is used when a text and/or translation for a work exists on a different page. This is commonly used when several works have the same text. The variable '''''Ave Maria''''' should be replaced by the title of the page with the actual text/translation.
| A template that is used when a text and/or translation for a work exists on a different page. This is commonly used when several works have the same text. The variable '''''Ave Maria''''' should be replaced by the title of the page with the actual text/translation.
|-
| <nowiki>{{MassText}}</nowiki>
| A specialized example of LinkText, only for use with score pages of masses, or mass movements.
|-
|-
| <nowiki>{{NoText}}</nowiki>
| {{tl|MassText}}<br>{{tl|MassText|Requiem}}
| This template appears often on score pages, and is for a work which does not have the text available in an easily copied format.
| A specialized example of LinkText, only for use with score pages of masses, or mass movements. Requiem masses usually have a different set of mass movements, and the extra parameter '''''Requiem''''' should be used to denote these.
|-
|-
| <nowiki>{{NoTranslation|English}}</nowiki>
| {{tl|NoText}}
| This template is used to request a translation (e.g. English or any other language) which does not exist yet.
| This template appears often on score pages, and is for a work which does not have the text available in an easily copied format. It adds the page to [[:Category:Text requests]].
|-
| {{tl|NoTranslation|''language''}}  
| This template is used to request a translation (e.g. English or any other language) which has not yet been provided. It adds the page to [[:Category:Translation requests]].
|}
|}


===Other miscellaneous templates===
===Other miscellaneous templates===
{| border="1" valign="top"
{| border="1" valign="top" cellspacing="0" cellpadding="5"
|-
|-
| <nowiki>{{CatAZ}}</nowiki>
| {{tl|CatAZ}}  
| A template for adding an alphabetical link list (from A to Z) to facilitate jumping to the appropriate letter in a long list; this is very useful for categories with very large numbers of items.
| A template for adding an alphabetical link list (from A to Z) to facilitate jumping to the appropriate letter in a long list; this is very useful for categories with very large numbers of items.
|-
|-
| <nowiki>{{Cat|Motets|Motet}}</nowiki>
| {{tl|Cat|''SATB''|''SATB&nbsp;divisi''}}  
| A template for adding a page to a given category using the first variable (in this case, [[:Category:Motets]]) and to create a link to that category, using the second variable for the displayed text. This is due to the fact that unlike some Wiki implementations, more often a Wiki link to a term such as <nowiki>[[Motet]]</nowiki> should actually refer to the category, <nowiki>[[:Category:Motets]]</nowiki>; however it is grammatically incorrect to categorise a single item by the plural, so this template would link to the plural category ''Motets'', but display the singular item ''[[:Category:Motets|Motet]]''.
| A template for adding a page to a given category using the first variable (in this case, [[:Category:SATB]]) and to create a link to that category, using the second variable for the displayed text (in this case, ''SATB divisi'').
|-
|-
| <nowiki>{{Disambig}}</nowiki>
| {{tl|Pcat|Mass|es}}
| A template for creating a link to a given category, using the first variable (that should be the category name in singular form) for the displayed text, and to add the page to that category using both variables concatenated (singular category name plus plural suffix: ''Mass''+''es'': [[:Category:Masses]]). This is due to the fact that a page being categorized to a term such as <tt><nowiki>[[Mass]]</nowiki></tt> should actually refer to the category <tt><nowiki>[[:Category:Masses]]</nowiki></tt>; however it is grammatically incorrect to categorise a single item by the plural, so this template would link to the plural category ''Masses'', but display the singular item ''[[:Category:Masses|Mass]]''.
|-
| {{tl|Disambig}}  
| A template for disambiguation pages (e.g. to avoid confusion when composers or works have the same name). The template adds the page to [[:Category:Disambiguation]].
| A template for disambiguation pages (e.g. to avoid confusion when composers or works have the same name). The template adds the page to [[:Category:Disambiguation]].
|-
|-
| <nowiki>{{Psalm table|x&ndash;1|x|x+1}}</nowiki>
| {{tl|Psalm table|''x&ndash;1''|''x''|''x+1''}}
| A template which adds a table of links to all 150 chapters of the book of Psalms, and includes special links, to the current psalm (''x''), and usually the immediate preceding (''x''&ndash;1) and following psalms (''x''+1).
| A template which adds a table of links to all 150 chapters of the book of Psalms, and includes special links, to the current psalm (''x''), and usually the immediate preceding (''x''&ndash;1) and following psalms (''x''+1).
|-
| {{tl|NoMelody}}
| A template which should be present on all hymn tune pages which have not yet had their melody added with the [[Help:How can I add a LilyPond excerpt?|LilyPond extension]]. The template adds the page to [[:Category:LilyPond requests]] and should be removed when the melody is added.
|-
| {{tl|CompCatTxt}}
| A template which should be added to all [[:Category:Composer works categories|compositions by composer subcategories]] to provide the generic descriptive text.
|-
| {{tl|WksLangTxt}}
| A template which should be added to all [[:Category:Works by language|works by language subcategories]] to provide the generic descriptive text.
|-
| {{tl|VoicingCatTxt}}
| A template which is applied to some [[:Category:Voicing|voicing subcategories]] to provide the generic descriptive text.
|}
|}
{{Help}}

Revision as of 17:07, 30 May 2016

This is a shorthand reference to the most useful templates that exist on CPDL; for exact syntax and usage, there may be a discussion page associated with the particular template. Click on the template names for more details. Text in examples in italics indicates where you should enter a variable, ie. a value which is different depending on the situation.

See also: Category of frequently used templates.

General purpose templates

These templates are found on many different pages.

{{Legend}} A ubiquitous template used on composer and works pages to describe common icons and symbols for obtaining CPDL editions.
{{Broken}} A template used to mark broken links to PDF, MIDI or any other types of files.
{{PermBroken}} A template used to mark permanently broken links to PDF, MIDI or any other types of files.
{{Merge}} A template for marking 2 or more pages to be merged. If necessary, discussion should take place on the article talk page.
{{Split}} A template for marking a page to be split into 2 or more separate pages. If necessary, discussion should take place on the article talk page.
{{Delnow}} A template used to mark a page for immediate deletion.
{{Delreq}} A template used to propose a page for deletion. Discussion should take place on the article talk page.


Composer templates

These templates are usually found on composer pages.

{{NoWorks}} A template to state that there are currently no editions of any works by the composer on CPDL. It should be added to a composer page below {{Legend}} but only for composers whose works are in the public domain.
{{WikipediaLink}} A template to provide a link from a composer page to the article on Wikipedia.
{{WikipediaLink2}} A template to provide a link from a composer page to the article on Wikipedia when all or the majority of the biography on the CPDL page has been copied verbatim from Wikipedia.
{{AffiliateLink}}

{{AffiliateLink2}}

Templates which provide a link to CPDL's affiliate, Sheet Music Plus Use AffiliateLink2 if the composer's works are out of Copyright; use AffiliateLink if only some of the composer's works are out of Copyright.
{{CompCopyrightWarning}} A template to warn users that some or all of the composer's works hosted on or linked from CPDL may not be public domain worldwide.


Music files templates

These templates are usually found on score pages under the music files heading.

{{Editor|name|date}}
{{Editor|2|name1|name2|date}}
{{Editor|3|name1|name2|name3|date}}
{{Editor|edtype=Contributor|name|date}}
A template which adds a link to the page of the editor (or editors) who has added a score, and likewise the date the score was added to CPDL. This is usually placed on the line directly after the CDPL # entry which provides links to the score itself. In the last form, "edtype=Contributor" changes the word "Editor" to "Contributor".
{{ScoreInfo|page size|# pages|kBytes}} A template used to format the information about a score: the size of paper used, the number of pages, and download size. This usually follows straight after the Editor template above; e.g., {{ScoreInfo|A4|2|20}} returns the text Score information: A4, 2 pages, 20 kbytes
{{Copy|copyright type}} A template used to add a link to the copyright description for the edition, this usually follows directly after the ScoreInfo template above. For example, the template {{Copy|CPDL}} returns the text Copyright: CPDL, which link to the CPDL copyright page; several other types of copyright have pages, eg. Personal, Religious or ChoralWiki:Public Domain.
{{CopyCC|copyright type}} A variation on {{Copy}} used to add a link to the Creative Commons copyright description for the edition. For example, the template {{CopyCC|Attribution 3.0 Unported}} returns the text Copyright: Creative Commons Attribution 3.0 Unported, which link to the Creative Commons copyright page and scrolls down to the "Attribution 3.0 Unported" anchor. If the specific license is not listed, simply edit the page and add it in the same way as the others.
{{ScoreError|errors}} A template used for adding a note to a particular edition, describing a musical error in the score. A short discussion of the error(s) may be added after the vertical bar; a large number of errors should be reported separately in the linked discussion page. This template adds the work in question to the Category:Sheet music errors category.
{{KbdVer}} A template used only under the "edition notes" section of a score entry to state that the edition "Includes a keyboard version of the original accompaniment" and add the page to Category:Keyboard version.
{{KbdRed}} A template used only under the "edition notes" section of a score entry to state that the edition "Includes a keyboard reduction of the a cappella choral score" and add the page to Category:Keyboard reduction.
{{FinaleReader}} A template used under the "edition notes" section of a score entry to point users to the Downloadable tools page where they may download Finale Reader, software which will view and print Finale files.
{{NWC}} A template used under the "edition notes" section of a score entry to point users to the Downloadable tools page where they may download NoteWorthy Composer Viewer, software which will view and print NoteWorthy Composer files.

Works templates

These templates are usually found on score pages.

{{Editions|n}} A series of templates used to mark works that have more than one edition. This is not for counting the number of files, but only the number of separate editions on a given page. Similarly named templates exist for works with 3, 4, and more editions available.
{{UnfinishedWork}} A template used for a work that a composer did not complete, or has subsequently been partially lost. This is usually placed directly after the Title: and Composer: entries, or alternately at the top of the page.
{{IncompleteEdition}} A template used for an edition that is missing sections.
{{MisattributedWork}}
{{MisattributedWork|comments}}
A template used for a work which has been attributed to a composer incorrectly. This is an aid for users who may not know the correct composer. This template adds the work in question to the Misattributed compositions category.
{{Cleanup|errors}} A template used on a page that has broken formatting, or incorrect or missing information. A short description of the problems with the page may be entered after the vertical bar. This template adds the work in question to the Pages awaiting cleanup category.
{{Composer|composer name}} A template used to format the name of the composer, and to generate a category entry (e.g. William Byrd compositions). Currently it is required in order for a work to be included in the online Score catalog.
{{Lyricist|lyricist name}} A template used to format the name of the lyricist, and to generate a category entry (e.g. William Shakespeare settings). This is obviously more useful for lyricists with a large body of work represented on CPDL, but the template should be used even if there is a limited representation.
{{Genre|Sacred|Motets}} A template used to format the entry for the genre of the vocal work. The first field is expected to be either "Sacred" or "Secular"; the second to fourth fields can be any of the various subgenres available. The page is also automatically added to the proper categories. In this example, the categories for such a work will be Sacred music and Motets.
{{Language|language}}
{{Language|2|language1|language2}}
A template used to format the entry for the language of the vocal work, to generate a link to the appropriate category entry (e.g. Italian texts) and to add a category to the score page . Multiple languages are catered for by inserting the number (2 or 3) as the first parameter.
{{Instruments|description}} This template scans the description text for names of instruments (or for a cappella) and automatically categorizes the page under the corresponding categories.
{{CopyrightWarning}} A template to warn users that the work listed on the score page may not be public domain worldwide.

Voicing templates

There are several templates which may be combined to describe the vocal forces called for by a particular work. See also voicing.

{{Voicing|1|T|Unison Tenor}} A template used to format the entry for the voicing of the vocal work. The first field generates the start of the line, Number of voices: 1v, and the second and third fields generate a link to the appropriate category entry, and the text to be displayed. The page is also automatically added to the category. In this case, the correct category for such a work is T, but the displayed text, Voicing: Unison Tenor is more helpful for reading.
{{MultiVoicing}} This enhanced version of Voicing is intended for works with multiple or complex voicings. Please refer to the template's documentation for the proper syntax.
{{Vcat|voicing}} Vcat simultaneously displays a link to a Voice category (e.g., SATB) and categorizes the page under that category. More importantly, it calculates the number of parts involved and categorizes the work under one of the N-part choral music categories. This information is useful when searching for works with a specific number of parts regardless of voicing. Both templates Voicing and MultiVoicing use Vcat internally, but it can also be used independently or as a complement to Voicing.

Accompaniment templates

These templates are usually found on the "Instruments" line of score pages. See also {{instruments}}, and some other recent additions at Category:Accompaniment templates.

{{acap}} For an a cappella work.
{{BsCont}} For a work with bass continuo accompaniment.
{{BrassAcc}} For a work with brass accompaniment.
{{FluteAcc}} For a work with flute accompaniment.
{{GtrAcc}} For a work with guitar accompaniment.
{{HarpAcc}} For a work with harp accompaniment.
{{HpsichdAcc}} For a work with harpsichord accompaniment.
{{JazzAcc}} For a work with jazz band accompaniment.
{{KbdAcc}} For a work with keyboard accompaniment.
{{KbdRed}} For reductions of a cappella works (See discussion)
{{KbdVer}} For reductions of orchestra accompaniments.
{{LuteAcc}} For a work with lute accompaniment.
{{MxEnsAcc}} For a work with mixed ensemble accompaniment.
{{OrchAcc}} For a work with orchestra accompaniment.
{{OrgAcc}} For a work with organ accompaniment.
{{PercAcc}} For a work with percussion accompaniment.
{{PnoAcc}} For a work with piano accompaniment.
{{StrAcc}} For a work with string ensemble accompaniment.
{{ViolAcc}} For a work with viol consort accompaniment.
{{WindAcc}} For a work with wind ensemble accompaniment.

Image templates

Self explanatory templates for generating icons for PDF, MIDI files, and the like.

{{pdf}} Icon_pdf.gif Portable Document Format (PDF) files.
{{mid}} Icon_snd.gif MIDI sound files.
{{net}} Network.png A link to an external webpage which has links to files.
{{mp3}} Icon_mp3.gif MP3 files.
{{ly}} Icon_ly.gif LilyPond files.
{{Capx}} Logo_capella-software_kurz_2011_16x16.png Capella files.
{{mp4}} Icon_vid2.gif MP4 videos.
{{extpdf}} Icon_pdf_globe.gif A direct link to a PDF hosted on an external site.
{{extmid}} Icon_snd_globe.gif A direct link to a MIDI hosted on an external site.
{{extmp3}} Icon_mp3_globe.gif A direct link to an MP3 hosted on an external site.
{{extly}} Icon_ly_ext.png A direct link to a LilyPond file hosted on an external site.

Text & translation templates

These templates may be on score pages, or on text pages.

{{Text|language}}
{{Text|2|language1|language2}}
{{Text|3|language1|language2|language3}}
A template to use when the text for a work is available on a given page. Macaronic text can also be represented with this template, as shown in the other examples. Using this template automatically causes the page to be listed under the Category:Texts and under the specific Language texts category. If more than one language is informed, it is also included in Category:Macaronic texts.
{{Translation|language}} A template to use when the translation for a work is available on a given page (use the above template for the original text). Using this template automatically causes the page to be listed under the Category:Translations and under the specific Language translations category. If a work is set in the original language and a translated language, use the {{Text|Language}} template.
{{LinkText|Ave Maria}} A template that is used when a text and/or translation for a work exists on a different page. This is commonly used when several works have the same text. The variable Ave Maria should be replaced by the title of the page with the actual text/translation.
{{MassText}}
{{MassText|Requiem}}
A specialized example of LinkText, only for use with score pages of masses, or mass movements. Requiem masses usually have a different set of mass movements, and the extra parameter Requiem should be used to denote these.
{{NoText}} This template appears often on score pages, and is for a work which does not have the text available in an easily copied format. It adds the page to Category:Text requests.
{{NoTranslation|language}} This template is used to request a translation (e.g. English or any other language) which has not yet been provided. It adds the page to Category:Translation requests.

Other miscellaneous templates

{{CatAZ}} A template for adding an alphabetical link list (from A to Z) to facilitate jumping to the appropriate letter in a long list; this is very useful for categories with very large numbers of items.
{{Cat|SATB|SATB divisi}} A template for adding a page to a given category using the first variable (in this case, Category:SATB) and to create a link to that category, using the second variable for the displayed text (in this case, SATB divisi).
{{Pcat|Mass|es}} A template for creating a link to a given category, using the first variable (that should be the category name in singular form) for the displayed text, and to add the page to that category using both variables concatenated (singular category name plus plural suffix: Mass+es: Category:Masses). This is due to the fact that a page being categorized to a term such as [[Mass]] should actually refer to the category [[:Category:Masses]]; however it is grammatically incorrect to categorise a single item by the plural, so this template would link to the plural category Masses, but display the singular item Mass.
{{Disambig}} A template for disambiguation pages (e.g. to avoid confusion when composers or works have the same name). The template adds the page to Category:Disambiguation.
{{Psalm table|x–1|x|x+1}} A template which adds a table of links to all 150 chapters of the book of Psalms, and includes special links, to the current psalm (x), and usually the immediate preceding (x–1) and following psalms (x+1).
{{NoMelody}} A template which should be present on all hymn tune pages which have not yet had their melody added with the LilyPond extension. The template adds the page to Category:LilyPond requests and should be removed when the melody is added.
{{CompCatTxt}} A template which should be added to all compositions by composer subcategories to provide the generic descriptive text.
{{WksLangTxt}} A template which should be added to all works by language subcategories to provide the generic descriptive text.
{{VoicingCatTxt}} A template which is applied to some voicing subcategories to provide the generic descriptive text.


This page is part of the CPDL Help system.
View main help index