Hymnal installation
From Hymnary Wiki
The hymnal installation process consists of importing the data from a hymnal into the Hymnary. Uploading a hymnal from scratch is usually accomplished by entering the data into a spreadsheet, then sending it to the Hymnary tech staff.
Remember: entering information from a hymnal is creating a hymn instance. An instance should detail exactly what is on the printed page, even if it is incorrect. That is, if the hymn lists "Dr. Watts" as the text author, you should enter "Dr. Watts" even though you know the author's real name is Isaac Watts. (The instance information will be connected to verified information on an authority page after the hymnal has been installed.)
Contents |
Spreadsheets
A hymnal may be indexed by entering its information into the following spreadsheets:
Each of these spreadsheets can be made in Excel and must follow the format specified. This includes the presence of a header row which will be ignored when the data is imported into the Hymnary.
Note that if you already have this information in a database, it may be fairly easy to export it into CSV files matching our needs. Ask your database expert.
To submit your spreadsheets, email ccel@calvin.edu to get the email address of someone on the Hymnary.org staff that you can work with.
ThML
ThML is the XML dialect used at www.ccel.org. Hymnals encoded in XML can be installed as books at www.ccel.org, and they can also be imported directly into Hymnary.org. This route may be appropriate for XML experts who want hymnals to appear at CCEL.org as well. There is an introduction to Creating Hymnals in ThML; contact us at ccel@calvin.edu for more information.
Web interface
Individual hymns may be added through the web interface via the add text instance and add tune instance pages. However, a hymnal cannot currently be created using the web interface, so this must be done manually.
