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, saving the spreadsheet as XML, and uploading the spreadsheet into a hymnal. The data may also be entered directly into Hymnary by adding new text of new tune.
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.)
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. Follow the spreadsheet links above for required, recommended and optional columns.
There also are spreadsheets for Media and (Page) Images.
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.
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 email@example.com for more information.
Individual hymns may be added through the web interface via "hymn text instance" and "hymn tune instance" pages under "Editor Tools," but the hymnal must exist before adding any hymn instances. A new hymnal can be added through the web interface on the Hymnal page; see further instructions in the next section.
Be aware, especially when using the web interface, that when a new authority is added, the information in that authority record comes directly from the instance. If there is a mistake in the instance information or if the instance information is incomplete when the new authority is added, the mistake will show up in the authority and the authority information will be incomplete. Please correct the newly created authorities as well as the instances. There may be information in the instance that is appropriate for the instance but not needed or different than what is wanted in the authority. For instance, a full text does not need to be in the authority, as the text that is seen there comes from an instance; and the copyright information in the authority should be the current copyright and people's names should be the authority name.
To add a new hymnal, go to Editor Tools in the left side bar (if you are an editor, and logged in), then, Add new...Hymnal. Fill out the form.