Template:Pub: Difference between revisions

From ChoralWiki
Jump to navigation Jump to search
mNo edit summary
(order of parameters '4', '5', '6' seems to be flexible, but less confusing (I hope) to consolidate their documentation)
Line 4: Line 4:


Parameters:
Parameters:
:1. Integer number, order of publication: 0 for manuscript or composed date, 1 for first publication, 2 for second, up to 50 (mandatory)
:1. Integer number, order of publication: 0 for manuscript or composed date, 1 for first publication, 2 for second, up to 50 (mandatory; should contain '''only''' an integer number)
:2. Four-digit year of publication (mandatory)
:2. Four-digit year of publication (mandatory;should contain a integer number, usually four digits, the year of publication. There may be a prefix, ''e.g.'' "ca.", "ante", or "post")
 
Optional parameters:
:3. Name and details of publication (optional)
:3. Name and details of publication (optional)
*Parameter 3 should contain a '''link''' to a publication page to which this work is linked. The link should use the template {{tl|NoComp}} (or double brackets <tt><nowiki>[[ ]]</nowiki></tt>); use {{tl|NoCo}} ''only'' if all the works in the publication have the same composer.
:–. {{para|vol}} Volume (or Edition or Part) and number (optional)
:–. {{para|vol}} Volume (or Edition or Part) and number (optional)
*The volume (or edition or part) can be specified, in the format <tt>vol{{eq}}<type> <number></tt>, for example "Volume 2" or "Part 1" or "Heft 5"; the words and numbers must be the same as in the template {{tl|Volumes}} on the publication page, and there must be a space between.
:–. {{para|no}} Sequence of work in publication (optional)
:–. {{para|no}} Sequence of work in publication (optional)
:–. {{para|pg}} Page number of work in publication (optional)
:–. {{para|pg}} Page number of work in publication (optional)
*The volume (or edition or part) can be specified, in the format <tt>vol{{eq}}<type> <number></tt>, for example "Volume 2" or "Part 1" or "Heft 5"; the words and numbers must be the same as in the template {{tl|Volumes}} on the publication page, and there must be a space between.
:–. {{para|cmp}} One word, "Composed" or "Written" (or any other word) describing a non-publication event (optional)
:–. {{para|cmp}} One word, "Composed" or "Written" (or any other word) describing a non-publication event (optional)
:–. {{para|ms}} Any text, indicating that the publication cited is a manuscript
:–. {{para|ms}} Any text, indicating that the publication cited is a manuscript
*Parameter 1 should contain '''only''' an integer number.
*Parameter 2 should contain a integer number, usually four digits, the year of publication. There may be a prefix, ''e.g.'' "ca.", "ante", or "post".
*Parameter 3 should contain a '''link''' to a publication page to which this work is linked. The link should use the template {{tl|NoComp}} (or double brackets <tt><nowiki>[[ ]]</nowiki></tt>); use {{tl|NoCo}} ''only'' if all the works in the publication have the same composer.
*Optionally, the sequence number or page in that publication can be specified; if you intend for these parameters (sequence or page number) to appear in the table generated by the template {{tl|MultiPubList}}, they should be declared as parameters, as in Syntax 3 below.
*Optionally, the volume (or edition or part) can be specified, in the format <tt>vol{{eq}}<type> <number></tt>, for example "Volume 2" or "Part 1" or "Heft 5"; the words and numbers must be the same as in the template {{tl|Volumes}} on the publication page, and there must be a space between.


<u>'''Syntax A. Normal publication (on paper or online), not manuscript'''</u>
<u>'''Syntax A. Normal publication (on paper or online), not manuscript'''</u>

Revision as of 22:28, 6 August 2022

Documentation

This template is to be used for publication data for a work. Data for a publication uses template {{PubDatePlace}} instead.

Parameters:

1. Integer number, order of publication: 0 for manuscript or composed date, 1 for first publication, 2 for second, up to 50 (mandatory; should contain only an integer number)
2. Four-digit year of publication (mandatory;should contain a integer number, usually four digits, the year of publication. There may be a prefix, e.g. "ca.", "ante", or "post")

Optional parameters:

3. Name and details of publication (optional)
  • Parameter 3 should contain a link to a publication page to which this work is linked. The link should use the template {{NoComp}} (or double brackets [[ ]]); use {{NoCo}} only if all the works in the publication have the same composer.
–. |vol= Volume (or Edition or Part) and number (optional)
  • The volume (or edition or part) can be specified, in the format vol=<type> <number>, for example "Volume 2" or "Part 1" or "Heft 5"; the words and numbers must be the same as in the template {{Volumes}} on the publication page, and there must be a space between.
–. |no= Sequence of work in publication (optional)
–. |pg= Page number of work in publication (optional)
  • The volume (or edition or part) can be specified, in the format vol=<type> <number>, for example "Volume 2" or "Part 1" or "Heft 5"; the words and numbers must be the same as in the template {{Volumes}} on the publication page, and there must be a space between.
–. |cmp= One word, "Composed" or "Written" (or any other word) describing a non-publication event (optional)
–. |ms= Any text, indicating that the publication cited is a manuscript

Syntax A. Normal publication (on paper or online), not manuscript

{{Pub|N|YYYY|in {{NoComp|<Publication>|<Composer>}}}}

Syntax B. Normal publication (on paper or online), not manuscript, including page number and sequence number

{{Pub|N|YYYY|in {{NoComp|<Publication>|<Composer>}}|no=NN|pg=PP}}

Syntax C. When date of writing (or composition) is known

{{Pub|0|YYYY||cmp=Composed}} – note zero for parameter 1, parameter 3 usually blank – put details in Description

Syntax D. Manuscript publication

{{Pub|0|YYYY|in {{NoComp|<Publication>|<Composer>}}|ms=ms}} – note zero for parameter 1

Example 1.

{{Pub|0|1752|in Weimar|cmp=Composed}}
{{Pub|1|1755|in {{NoComp|First book of motets|James Lyon}}|pg=28}}
{{Pub|2|1787|in ''[[Compilation of sacred music and poetry]]''|no=657}}
yields
 Composed 1752 in Weimar
First published 1755 in First book of motets, p. 28
Second published 1787 in Compilation of sacred music and poetry, no. 657

(Version 5)