Table of Contents
Welcome
The Gregowiki is a central location for all Gregorio users to find:
- Tips and Hints
- Code Snippets
- Installation Procedures
- Links
- And anything else!
What is Gregorio?
Gregorio is an open-source project offering software tools for typesetting (engraving) Gregorian chant scores. In particular, Gregorio is an add-on package for the typesetting system LaTeX, so it requires an installation of TeXLive.
Gregorio and LaTeX together produce PDF output suitable for printing.
The input to Gregorio is a notation called GABC, which combines the syllables of a chant text with a simple notation indicating the position and shape of each note.
“nabc” is the name of the extension of gabc to display some adiastematic neumes of the St. Gallen and Laon style.
For most users, it's not necessary to install Gregorio on your own computer. Instead you can access it using one of the on-line Gregorio web interfaces listed below.
On-line Tools
Running Gregorio on-line
There are two web sites that have versions of the Gregorio software installed. They offer interfaces where a user can enter GABC code, make selections about the output format, and receive a PDF file with the score produced by the Gregorio (and LaTeX) software:
- demo video from Corpus Christi Watershed, using run.gregoriochant.org
Tools for preparing text
Since GABC code assigns notes to syllables of the sung text, this tool can be useful in breaking up a text into syllables:
- Syllabifier for Latin text
Some users like to add hyphens whenever a word has more than one syllable, but be aware that it's not a requirement. Here are tools for that purpose:
- Hyphen-la for liturgical Latin
- Hyphenator for English text
If you prefer, it's fine to let Gregorio insert hyphens automatically where they are needed for formatting.
Tools for producing GABC code
Ben Bloomfield's on-line tools can apply melodic formulas to hymn texts, psalm verses, and scripture texts:
Tutorials And Guides
- Gregorio Tex Code Reference for Gregorio.
- Common Unicode Characters used in chant notation (Reference)
- Video demo of run.gregoriochant.org web interface (Note: the video references an old name for the web site)
- Video demo of Illuminare Score Editor (Note: the editor web site has moved to a new URL since this video was made)
Resources
- The Caecilia Project - collection of gabc scores
- Benjamin Bloomfield's Blog - the designer of some of the online gabc tools
Software
- TexLive TeXLive is a package for installing LaTeX typesetting software. It is updated annually and includes a reasonably current version of Gregorio, so if you need to install the software on your computer in order to undertake a highly customized and automated project, TeXLive is the foundation to start with.
- Latest features of Gregorio not yet integrated in the documentation
- Notatio Antiqua - a GUI .gabc editor and compiler.
- Greg - a desktop GUI application for Gregorio. It assists in compiling gabc files (windows only) and can also play them as midi files
- Gregorio comes with a compilation script called <html>gprocess</html> which is a <html>perl</html> script designed to instantly show the result of a gabc file using your system's pdf viewer.
- gly - “Gabc with separate LYrics” or “Gabc for liLYponders”
- lygre - ruby gem providing script <html>grely.rb</html> which converts gabc to simple lilypond. Currently the conversion is possible only to modern notation, with great information loss.
Text editor tools for gabc files
- gregorio-mode.el A Gregorio mode configuration for the Emacs editor; it performs automatic syntax highlighting. Instructions are here.
- gabc-mode.el One (actually two) more, much simpler, Emacs mode; syntax highlighting + some quick-code-insertion shortcuts.
- NPP_Gregorio.zip - A Gregorio mode configration for the Notepad++ editor, for use with .gabc files. (Documentation and tutorials on Notepad++ syntax colour files are available here.
- There are also several syntax-colouring files that come with your Gregorio installation. Look in your Gregorio's application folder under “contrib”. (Or look in the same folder at github.) There are files for BBEdit, TextWrangler, Scribus, Gedit, Kedit, Emacs, Vim, and Texshop (Mac OSX).
Installation
- Gregorio software releases for people working with the very latest editions (i.e., not most users)
Developer notes
Technical support
- <html>#gregorio</html> IRC channel on freenode.
Mailing lists
- MusicaSacra Forum - there are gregorio users there!
Bug reports
Works produced with Gregorio
Several published books and smaller works have been produced using Gregorio.
Helping to build this site
If you wish to contribute to the gregowiki, contact us through the gregorio-users mailing list. – administrators rac, bgm, and pierre
- Wiki Tips - helpful hints for using this wiki.