| Both sides previous revision
Previous revision
Next revision
|
Previous revision
|
start [2020/02/29 18:47]
bgm [Software] |
start [2025/01/13 21:30] (current)
igneus [Software] |
| |
| 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. | 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 [[#Running_Gregorio_on-line|on-line Gregorio web interfaces]] listed below. | **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. |
| |
| =====Software===== | |
| *[[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://www.tug.org/texlive/|TexLive]] | |
| *[[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 <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. | |
| *[[https://github.com/igneus/gly|gly]] - "Gabc with separate LYrics" or "Gabc for liLYponders" | |
| *[[https://github.com/igneus/lygre|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==== | |
| *[[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]] | |
| *[[Troubleshooting Gregorio Installation]] | |
| *[[https://github.com/gregorio-project/gregorio/releases|Gregorio software releases]] | |
| |
| =====On-line Tools===== | =====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==== | ====Tools for preparing text==== |
| Since GABC code assigns notes to syllables of the sung text, these tools can be useful in breaking up a text into syllables: | 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 | *[[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://gregorio-project.github.io/hyphen-la/|Hyphen-la]] for liturgical Latin |
| *[[http://juiciobrennan.com/hyphenator/|Hyphenator]] for English text | *[[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==== | ====Tools for producing GABC code==== |
| *[[https://bbloomf.github.io/jgabc/psalmtone.html|GABC generator for psalm texts with psalm tones]] | *[[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]] | *[[https://bbloomf.github.io/jgabc/readings.html|GABC generator for scripture readings]] |
| |
| ====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]] | |
| |
| =====Tutorials And Guides===== | =====Tutorials And Guides===== |
| *[[http://gregorio-project.github.io/tutorial/tutorial-gabc-01.html|gabc Tutorial]] | *[[http://gregorio-project.github.io/tutorial/tutorial-gabc-01.html|gabc Tutorial]] |
| | *[[https://mirrors.mit.edu/CTAN/support/gregoriotex/doc/GregorioNabcRef.pdf|nabc reference]] |
| *[[Cheat Sheet|Gregorio gabc Code Reference]] | *[[Cheat Sheet|Gregorio gabc Code Reference]] |
| *[[gabc Header Reference|Gregorio gabc Header Reference]] | *[[gabc Header Reference|Gregorio gabc Header Reference]] |
| *[[Troubleshooting]] | *[[Troubleshooting]] |
| *[[Latest features]] | *[[Latest features]] |
| *[[http://www.ccwatershed.org/blog/2013/jun/8/gregorio-tutorial-gabc-training-video/|Video demo of GabrielMass web interface]] (Note: the web site has been renamed since this video was made) | *[[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) | *[[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===== | =====Resources===== |
| *[[http://gregobase.selapa.net/|GregoBase - database of gabc chant scores]] | *[[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://gregobase.selapa.net/chant_edit.php|Upload a new chant score to the GregoBase]] |
| | *[[https://gregobase.selapa.net/nabc.php|List of Gregobase scores with some nabc notation]] |
| *[[http://www.caecilia-project.org/|The Caecilia Project]] - collection of gabc scores | *[[http://www.caecilia-project.org/|The Caecilia Project]] - collection of gabc scores |
| *[[Collection of Chant-Related Links]] | *[[Collection of Chant-Related Links]] |
| *[[http://gregorien.info/|Gregorian Chant repertoire]] [[http://gregorien.info/fr|fr]] [[http://gregorien.info/en|en]] [[http://cantus.uwaterloo.ca|Cantus]] | *[[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]] | *[[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]] | *[[.tex templates]] |
| *[[Scripts]] | *[[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|official Gregorio git repository]] |
| | *[[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|gabctk]], 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 <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. |
| | *[[https://github.com/igneus/gly|gly]] - "Gabc with separate LYrics" or "Gabc for liLYponders" |
| | *[[https://github.com/igneus/lygre|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. |
| | *[[https://github.com/igneus/lilygabc|lilygabc]] - library providing support for gabc input in [[https://lilypond.org/|LilyPond]] |
| | ====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===== | =====Developer notes===== |
| *[[http://webchat.freenode.net/?channels=gregorio|Gregorio Webchat]] | *[[http://webchat.freenode.net/?channels=gregorio|Gregorio Webchat]] |
| ====Mailing lists==== | ====Mailing lists==== |
| *[[https://gna.org/mail/?group=gregorio|All Gregorio mailing lists]] | *[[http://gregorio-project.github.io/contact.html|All Gregorio mailing lists]] |
| *[[https://mail.gna.org/listinfo/gregorio-users|The gregorio-users list: information and subscription form]] | *[[https://groups.google.com/g/gregorio-users|The gregorio-users list: information and subscription form]] |
| *[[https://mail.gna.org/public/gregorio-users/|gregorio-users Mailing List Archives]] | *[[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://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! | *[[http://forum.musicasacra.com/|MusicaSacra Forum]] - there are gregorio users there! |
| *[[mailto:gregorio-users-request@gna.org?subject=help|List Help]] | *[[mailto:gregorio-users@googlegroups.com|gregorio-users Mailing List posting address]] |
| *[[mailto:gregorio-users@gna.org|gregorio-users Mailing List posting address]] | |
| ====Bug reports==== | ====Bug reports==== |
| *[[https://gna.org/bugs/?group=gregorio|View and submit Gregorio bug reports here]] | *[[https://github.com/gregorio-project/gregorio/issues|View and submit Gregorio bug reports here]] |
| |
| =====Works produced with Gregorio===== | =====Works produced with Gregorio===== |
| |
| =====Helping to build this site===== | =====Helping to build this site===== |
| If you wish to contribute to the gregowiki, contact us through the [[https://mail.gna.org/listinfo/gregorio-users|gregorio-users mailing list]]. | 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 | -- administrators rac, bgm, and pierre |
| |
| *[[Wiki Tips]] - helpful hints for using this wiki. | *[[Wiki Tips]] - helpful hints for using this wiki. |
| |
