Help:Score submission guide

From ChoralWiki
Revision as of 16:12, 10 July 2020 by BarryJ (talk | contribs)
Jump to navigation Jump to search


WARNING. This page is a draft - work in progress.

Choose a link:

Introduction and explanation

A key element of the automated process is the automation of composer pages, that are automatically updated whenever a new work is added. This automation is based on a specific function, named SortWorks, which automatically lists all works by a certain composer according to certain criteria (e.g., by creating separate lists for sacred vs. secular music). Please note that not all composer pages have been automated using the SortWorks function: some composer pages are still maintained manually, so, whenever a new work by that composer is added, the title of the new work and the link to the relevant work page have to be added manually, by doing copy-and-paste of some wiki code, as it was necessary before the automated process was introduced. You can recognize the automated composer pages by the presence of the {{SortWorks}} function in the wiki code of the page. See Help:Automating the work list on composer pages for details about the automation of composer pages and about the use of the SortWorks function.

If you added a new work and the composer page is already automated, the new work title should be automatically displayed on the page. It is possible that the work title is erroneously displayed twice, both in the main list and in the list under "Other works not listed above" at the bottom. It's a side effect ot the wiki cache, because not enough time has elapsed for the cache to refresh. You can force a cache refresh by clicking on Edit followed by Save changes, or by adding ?action=purge to the URL of the page. You may have to do this twice to obtain that the cache is completely refreshed.

If you added a new work and the composer page is not automated, you have to manually copy-and-paste the wiki code fragment that links to the new work page. You'll have received the wiki code fragment via email. You have to use the wiki code fragment under "Composer entry (this entry appears on the composer page, please copy/paste the line below, under List of works)", and you have to copy-and-paste it to the correct location on the page, depending on the composer page structure.

Composer pages newly created will lack much relevant information (birth and death dates, biography, etc.). You are invited to edit the page, adding any missing data.

If your files are already stored on external servers, we recommend that you upload them to CPDL anyway, in order to avoid eventual broken links. But if you prefer not to, then please enter the relevant links (full URL beginning with http://) and the applicable details (file type, size, page size, number of pages, etc.) because the system cannot automatically detect such information on externally stored files.

If you are more familiar with the traditional process and you don't want the work page and/or the composer page to be updated automatically, please select the checkbox "Do not automatically add wiki code to the pages, I will do it manually" at the bottom of the form. You will receive by email the wiki code fragments that would have been normally sent to you if you followed the traditional process. You will have to manually copy-and-paste the wiki code fragments on the work page, and also on the composer page if the composer page is not automated already.

When all required fields are complete, click on the "Add works data" button at the bottom of the form. The composer page, newly created or amended, according to the work/edition added, will be shown to you after a few seconds. If you selected the checkbox "Do not automatically add wiki code to the pages, I will do it manually" you will be also returned to the composer page, so that you can amend it using the wiki code fragments sent to you via email. The email with the wiki fragments will be sent to you in all cases, also if you did not select the checkbox "Do not automatically add wiki code to the pages, I will do it manually", for your records.

Contributors who are not familiar with editing wiki pages may stop at this point. All users who are familiar with editing wiki pages are encouraged to perform the next steps also for the contributions of other users.

If you selected the checkbox "Do not automatically add wiki code to the pages, I will do it manually", the work page is not automatically created or updated, therefore you will have to manually create or update it using the wiki code fragment that you'll have received via email. It's the wiki code fragment shown under "Works entry (this should appear on the works page,copy all material below except for the last line of text)".

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