=====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. **For most users, it's not necessary to install Gregorio on your own computer.** Instead you can access it using one of the [[#Running_Gregorio_on-line|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: *[[http://apps.illuminarepublications.com/gregorio/|Illuminare online score editor]] *[[http://run.gregoriochant.org/|run.gregoriochant.org Chant Engraver]] *[[https://www.youtube.com/watch?v=TZPP1vOO6ms|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: *[[http://marello.org/tools/syllabifier/|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: *[[http://gregorio-project.github.io/hyphen-la/|Hyphen-la]] for liturgical Latin *[[http://juiciobrennan.com/hyphenator/|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: *[[https://bbloomf.github.io/jgabc/transcriber.html|GABC generator for hymns]] *[[https://bbloomf.github.io/jgabc/propers.html|GABC generator for propers with Rossini psalm-tones]]. You can get a [[https://chrome.google.com/webstore/detail/gabc-transcription-tool/mkhgaijffgijgkolifpoaijimncdakkd|Chrome app for it here]]. *[[https://bbloomf.github.io/jgabc/psalmtone.html|GABC generator for psalm texts with psalm tones]] *[[https://bbloomf.github.io/jgabc/readings.html|GABC generator for scripture readings]] =====Tutorials And Guides===== *[[http://gregorio-project.github.io/tutorial/tutorial-gabc-01.html|gabc Tutorial]] *[[Cheat Sheet|Gregorio gabc Code Reference]] *[[gabc Header Reference|Gregorio gabc Header Reference]] *[[Tex Cheat Sheet|Gregorio Tex Code Reference]] for Gregorio. *[[Tweaking Your Chant Output]] *[[Using Macros in your gabc]] *[[Working With Fonts]] *Common [[Unicode Characters]] used in chant notation (Reference) *[[Troubleshooting]] *[[Latest features]] *[[http://www.ccwatershed.org/blog/2013/jun/8/gregorio-tutorial-gabc-training-video/|Video demo of run.gregoriochant.org web interface]] (Note: the video references an old name for the web site) *[[http://www.ccwatershed.org/blog/2013/jun/16/try-illuminare-score-editor/|Video demo of Illuminare Score Editor]] (Note: the editor web site has moved to a new URL since this video was made) =====Resources===== *[[http://gregobase.selapa.net/|GregoBase - database of gabc chant scores]] *[[http://gregobase.selapa.net/chant_edit.php|Upload a new chant score to the GregoBase]] *[[http://www.caecilia-project.org/|The Caecilia Project]] - collection of gabc scores *[[Collection of Chant-Related Links]] *[[http://www.vatican.va/archive/bible/nova_vulgata/documents/nova-vulgata_index_lt.html|Nova Vulgata]] *[[http://jsgabc.blogspot.com/|Benjamin Bloomfield's Blog]] - the designer of some of the online gabc tools *[[http://gregorien.info/|Gregorian Chant repertoire]] [[http://gregorien.info/fr|fr]] [[http://gregorien.info/en|en]] [[http://cantus.uwaterloo.ca|Cantus]] *[[http://www.ccwatershed.org/library/|Gradualia et Antiphonarii]] *[[https://espritdelaliturgie.org/2022/04/22/rubriques-de-lordo-cantus-missae/|Ordo Cantus Missæ Prænotanda (fr)]] *[[.tex templates]] *[[Scripts]] =====Software===== *[[http://www.tug.org/texlive/|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. *[[http://gregorio-project.github.io/|The official Gregorio web site]] *[[Latest features]] of Gregorio not yet integrated in the documentation *[[https://github.com/gregorio-project/gregorio|Gregorio GIT]] *[[http://notatioantiqua.sourceforge.net/index.html|Notatio Antiqua]] - a GUI .gabc editor and compiler. *[[http://www.dcmembers.com/bgmcoder/download/greg/|Greg]] - a desktop GUI application for Gregorio. It assists in compiling gabc files (windows only) and can also play them as midi files *[[https://github.com/jperon/gabctk|gabc2tk]], that supersedes the unmaintained [[https://github.com/jperon/gabc2mid|gabc2mid]] - a CLI python script to convert gabc files into midi. Tested and working under linux and windows, should work on osX ; under windows, you could prefer using Greg. *Gregorio comes with a compilation script called gprocess which is a perl script designed to instantly show the result of a gabc file using your system's pdf viewer. *[[https://github.com/igneus/gly|gly]] - "Gabc with separate LYrics" or "Gabc for liLYponders" *[[https://github.com/igneus/lygre|lygre]] - ruby gem providing script grely.rb 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==== *[[http://chant.fsspx.pl/gregorio-mode/docs/|gregorio-mode.el]] A Gregorio mode configuration for the Emacs editor; it performs automatic syntax highlighting. Instructions are [[http://christusrex.pl:8080|here]]. *[[https://github.com/igneus/gabc-mode|gabc-mode.el]] One (actually two) more, much simpler, Emacs mode; syntax highlighting + some quick-code-insertion shortcuts. *[[http://www.sspxusa.org/goodies/progsamples/NPP_Gregorio.zip|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 [[http://sourceforge.net/apps/mediawiki/notepad-plus/index.php?title=User_Defined_Languages|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 [[https://github.com/gregorio-project/gregorio/tree/master/contrib|github]].) There are files for BBEdit, TextWrangler, Scribus, Gedit, Kedit, Emacs, Vim, and Texshop (Mac OSX). ====Installation==== *[[How to Install TexLive]] *[[https://github.com/gregorio-project/gregorio/releases|Gregorio software releases]] for people working with the very latest editions (i.e., not most users) =====Developer notes===== * [[Nabc]] =====Technical support===== *[[Troubleshooting]] *#gregorio IRC channel on [[http://freenode.net/|freenode]]. *[[http://webchat.freenode.net/?channels=gregorio|Gregorio Webchat]] ====Mailing lists==== *[[http://gregorio-project.github.io/contact.html|All Gregorio mailing lists]] *[[https://groups.google.com/g/gregorio-users|The gregorio-users list: information and subscription form]] *[[https://groups.google.com/g/gregorio-users Mailing List Archives]] *[[http://www.mail-archive.com/gregorio-users@gna.org/|Search engine for gregorio-users mailing list]] *[[http://forum.musicasacra.com/|MusicaSacra Forum]] - there are gregorio users there! *[[mailto:gregorio-users@googlegroups.com|gregorio-users Mailing List posting address]] ====Bug reports==== *[[https://github.com/gregorio-project/gregorio/issues|View and submit Gregorio bug reports here]] =====Works produced with Gregorio===== Several published books and smaller works have been produced using Gregorio. * [[Works produced with Gregorio]] =====Helping to build this site===== If you wish to contribute to the gregowiki, contact us through the [[gregorio-users@googlegroups.com|gregorio-users mailing list]]. -- administrators rac, bgm, and pierre *[[Wiki Tips]] - helpful hints for using this wiki.