Updated to latest version from SVN

bbloomf · Apr 30, 2013 · 2906ef9 · 2906ef9
1 parent a0ce9fd
commit 2906ef9
Show file tree

Hide file tree

Showing 124 changed files with 11,818 additions and 1,188 deletions.
diff --git a/English Psalm Tones. 2011.pdf b/English Psalm Tones. 2011.pdf
diff --git a/README b/README
@@ -1,4 +0,0 @@
-jgabc is a javascript library for rendering GABC into Gregorian Chant.
-
-It also includes some tools for transcribing GABC and working with psalm tones,
-the latest version of which are always available at jgabc.christian.net

diff --git a/audiolet.js b/audiolet.js
diff --git a/cache.manifest b/cache.manifest
@@ -1,10 +1,15 @@
 CACHE MANIFEST
-#rev 55
-/Caeciliae-Staffless.ttf
-/Caeciliae-Staffless.svg
-/print.css
+#rev 96
+/style.css
+/css/smoothness/jquery-ui-1.8.16.custom.css
+/jquery-ui-1.8.16.custom.min.js
+/caeciliae-staffless-webfont.ttf
+/caeciliae-staffless-print.ttf
 /jgabc.js
 /jquery.min.js
+/jszip.js
+/sink.js
+/audiolet.js
 /OFLGoudyStMTT-Italic.ttf
 /OFLGoudyStMTT.ttf
 /psalmtone.htm
@@ -162,3 +167,4 @@
 /psalms/150
 /psalms/Benedictus
 /psalms/Magnificat
+/psalms/NovaVulgata.txt
diff --git a/caeciliae-staffless-webfont.eot b/caeciliae-staffless-webfont.eot
diff --git a/caeciliae-staffless-webfont.ttf b/caeciliae-staffless-webfont.ttf
diff --git a/css/smoothness/images/ui-bg_flat_0_aaaaaa_40x100.png b/css/smoothness/images/ui-bg_flat_0_aaaaaa_40x100.png
diff --git a/css/smoothness/images/ui-bg_flat_75_ffffff_40x100.png b/css/smoothness/images/ui-bg_flat_75_ffffff_40x100.png
diff --git a/css/smoothness/images/ui-bg_glass_55_fbf9ee_1x400.png b/css/smoothness/images/ui-bg_glass_55_fbf9ee_1x400.png
diff --git a/css/smoothness/images/ui-bg_glass_65_ffffff_1x400.png b/css/smoothness/images/ui-bg_glass_65_ffffff_1x400.png
diff --git a/css/smoothness/images/ui-bg_glass_75_dadada_1x400.png b/css/smoothness/images/ui-bg_glass_75_dadada_1x400.png
diff --git a/css/smoothness/images/ui-bg_glass_75_e6e6e6_1x400.png b/css/smoothness/images/ui-bg_glass_75_e6e6e6_1x400.png
diff --git a/css/smoothness/images/ui-bg_glass_95_fef1ec_1x400.png b/css/smoothness/images/ui-bg_glass_95_fef1ec_1x400.png
diff --git a/css/smoothness/images/ui-bg_highlight-soft_75_cccccc_1x100.png b/css/smoothness/images/ui-bg_highlight-soft_75_cccccc_1x100.png
diff --git a/css/smoothness/images/ui-icons_222222_256x240.png b/css/smoothness/images/ui-icons_222222_256x240.png
diff --git a/css/smoothness/images/ui-icons_2e83ff_256x240.png b/css/smoothness/images/ui-icons_2e83ff_256x240.png
diff --git a/css/smoothness/images/ui-icons_454545_256x240.png b/css/smoothness/images/ui-icons_454545_256x240.png
diff --git a/css/smoothness/images/ui-icons_888888_256x240.png b/css/smoothness/images/ui-icons_888888_256x240.png
diff --git a/css/smoothness/images/ui-icons_cd0a0a_256x240.png b/css/smoothness/images/ui-icons_cd0a0a_256x240.png
diff --git a/css/smoothness/jquery-ui-1.8.16.custom.css b/css/smoothness/jquery-ui-1.8.16.custom.css
diff --git a/faq.html b/faq.html
@@ -0,0 +1,109 @@
+<html>
+<head>
+<title>GABC Transcription and Psalm Tone Tool FAQ</title>
+<style>
+body {
+  font-family:Verdana,Helvetica,sans-serif;
+}
+div.columns {
+  column-width:1em;
+  column-gap: 1em;
+  column-rule: thin solid gray;
+}
+div.question {
+  font-weight:700;
+  margin-top:1em;
+}
+p {
+  margin-top:0;
+}
+body{
+  max-width: 8in;
+  margin:auto;
+}
+</style>
+</head>
+<body>
+<h1 title="Frequently Answered Questions">FAQ</h1>
+<div class="columns">
+<div class="question">What is this for?</div>
+<div class="answer">This is two separate tools to aide in the transcription of chant into GABC notation.  The first is called the "<a href="#transcription">GABC Transcription Tool</a>" and the second is called the "<a href="#psalmtone">Psalm Tone Tool</a>" and they will be dealt with separately below.</div>
+<div class="question">Who wrote it, and why?</div>
+<div class="answer">I wrote it because in January 2011, I realized that it would be relatively simple to have a computer automatically break apart a Latin text into syllables, and provided the accents are in place, it would also be possible to apply a psalm tone to it automatically.  In the process of writing this Psalm Tone Tool, it became obvious that it would also be advantageous to split apart Latin into its syllables simply to prevent having to type so many parentheses, and thus the GABC Transcription Tool was born.</div>
+<div class="question">What about the graphical representation of the chant?</div>
+<div class="answer">I had begun a project in May 2010, thinking it would be simple to render GABC into a webpage, but abandoned it later in the year, half-finished.  When I wrote this page, it was a natural fit to use what I already had half-working in order to allow for a graphical preview of the chant, and actually using this code for something provided additional inspiration for getting it to work better, because it is annoying whenever it displays something incorrectly, and thus I have improved much in the rendering of the chant preview since writing the transcription tool.</div>
+<div class="question">Have any of these questions really been frequently asked?</div>
+<div class="answer">No, I don't think anyone has actually asked any of these questions, but I have frequently anticipated them.</div>
+<div class="question">Is there any way of running this while not connected to the Internet?</div>
+<div class="answer">Yes, as long as you use Chrome.  You can get the Chrome Web App version <a href='https://chrome.google.com/webstore/detail/mkhgaijffgijgkolifpoaijimncdakkd'>here</a> and it will work whether you are connected to the Internet or not.</div>
+<a name="Transcription"><h2>GABC Transcription Tool</h2></a>
+<div class="question">What is the GABC Transcription Tool?</div>
+<div class="answer">It is a tool to allow you to enter GABC notation without having to mark the syllable breaks, and without having to use so many parentheses.  It is also useful for transcribing chants that have repetitive melodies over different texts, such as hymns.</div>
+<div class="question">What does it do exactly?</div>
+<div class="answer"><p>It does several different things.  Its original use was simply to take a Latin text and intersperse it with parenthetic GABC notation after each syllable.  That is, it takes the two separate texts, "c e g g" adnd "Adoro te", and produce: "A(c)do(e)ro(g) te(g)" thus saving the typing of many parentheses.</p>
+  <p>For hymns, it is useful to repeat the melody over each verse.  It is also useful to have sections of melody and text, each of which repeats the melody for that section over all the text, for example with a hymn that has several verses followed by an "amen" of an entirely different melody.  This can be done by separating the sections with a line that consists entirely of two dashes: "--", or
+  <blockquote><code>1. first verse text...<br/>2. second verse text<br/>--<br/>Amen.</code></blockquote> for the text and <blockquote><code>GABC for verses...<br/>--<br/>GABC for Amen</code></blockquote> for the GABC.</p>
+  <p>It will not repeat the GABC for the last section, so if you have only one section and want it to repeat over all the text, you will have to enter the last line as --</p></div>
+<div class="question">Will it work in reverse?</div>
+<div class="answer">Yes, to some extent, although it isn't always working quite right at the moment.  If you click 'Show integrated GABC' and type into the single textbox that shows up, it will separate the text from the GABC notation if you type or paste regular GABC with the text and GABC interleaved with parentheses, and display it as chant below.</div>
+<div class="question">How can elisions be marked in the text?</div>
+<div class="answer">If you need to mark an elision in the text of the hymn, you can enclose the elided part of the syllable in parentheses.  You can change the behavior of elisions by checking or unchecking the "Use puncta for elisions" checkbox.  If this checkbox is checked, the elided syllable will get a punctum associated with it.  If it is unchecked, the syllable will simply be skipped when assigning GABC to each syllable.</div>
+<div class="question">What can I do if it doesn't break up my word into syllables properly?</div>
+<div class="answer">Right now, there is an inconsistency in the way this is handled depending on whether English is checked.  If English is checked, then you can separate syllables with an equals sign (=), but if you use one equals sign in a word, you must you it between every syllable, as it won't look that word up in the dictionary at all.  If English is not checked, you may use a hypen (-) and if you use one hypen, you must use it on all syllables to the left as well.  If you want to mark a word as a monosyllable, you may end the word with a hypen (e.g., quo-)</div>
+<div class="question">Are there any other features I should know about?</div>
+<div class="answer">There is at least one feature that may be classified as such.  When typing into the text field, you may enter accented vowels by typing an apostrophe immediately after a vowel (e.g., e' will be converted to é)  This also works with quotation marks such that e" will be converted to ë and ae and oe will be converted to æ and œ.  These conversions will not be made when English is checked above the textbox.</div>
+<div class="question">Apropos of the aforementioned "English" checkbox, what is it, and what does it do?</div>
+<div class="answer">It signifies whether the text is English, so that the syllabification can be done differently.  It works by checking each word against a dictionary (actually by feeding them into the lyric hyphenator at <a href='http://www.juiciobrennan.com/'>this site</a>) and it only updates the local dictionary every 5 seconds, so you will sometimes have to wait for it to properly syllabify the text.</div>
+<div class="question">Is there any way to hear what the chant might sound like?</div>
+<div class="answer">Oh, yes.  If you click on a punctum, it will turn red and play its tone.  You can use the arrow keys to select the puncta to the left or right, and to move it up or down.  You can also hit &lt;SPACE> to play the entire chant or &lt;Ctrl>+&lt;SPACE> to play starting at the selection.  Hit Esc to stop playing.</div>
+<div class="question">Is there anything else it does that you still forgot to mention?</div>
+<div class="answer">Yes, I nearly forgot.  It also provides a link to generate a PDF of the chant using Richard Chonak's wonderful web front-end to Gregorio <a href='http://gregorio.gabrielmass.com/'>here</a>.  This link is in the upper right corner and is labeled, "Generate PDF"</div>
+<div class="question">What about the 'Download Integrated GABC' link?</div>
+<div class="answer">Yes, I should have mentioned that.  You can click that to download the GABC file, which will be a text file containing the text in the Integrated GABC text box, which will show up if you click the "Show integrated GABC" link at the top.  From Chrome, you can drag this link onto an explorer window, and it will name the .gabc file with the value of the name field in the header, if you have edited the GABC header.</div>
+</div>
+<a name="psalmtone"><h2>Psalm Tone Tool</h2></a>
+<div class="question">What is the Psalm Tone Tool?</div>
+<div class="answer">It is a tool to aide in the transcription of psalms into GABC notation, as well as formatting the verses into HTML, TeX, or some other format.</div>
+<div class="question">What Psalm edition are you using?</div>
+<div class="answer">The psalms (as well as the Magnificat and Benedictus) are according to a 1961 Liber Usualis (although there may be some mistakes), with all the mediants and flexa as marked in there.</div>
+<div class="question">What about the "Use Nova Vulgata psalms" checkbox?</div>
+<div class="answer">Good point.  If this is checked, it will use the Nova Vulgata edition of the psalms.</div>
+<div class="question">There are a lot more options in this tool than in the Transcription Tool, aren't there?</div>
+<div class="answer">Yes, there are.</div>
+<div class="question">Shall we go over them one by one?</div>
+<div class="answer">Yes, I think that's probably the best way.</div>
+<div class="question">OK.  Let's start with the upper-left quadrant of the grid at the top.  The one with the Tone dropdown.</div>
+<div class="answer">Certainly.  From here, you can select the tone to use, first by selecting the tone and then the termination.  You can check the "Solemn Tone" box if you want the solemn tone.</div>
+<div class="question">What about the other things in the upper-left quadrant?</div>
+<div class="answer">The clef box can be used to set the position of the clef.  It will shift the chant along with the clef, so if you want to change the clef without shifting the chant, you will have to change it in the GABC box just above the preview of the chant.</div>
+<div class="question">What are the rules for the Psalm GABC box just below the clef box?</div>
+<div class="answer">This is just the GABC for each verse of the psalm.  The first line is the mediant, and the second line is the termination.  The neumes that belong over accented syllables are prefixed by an apostrophe and the dominant is marked as a punctum cavum, with an r.  You can store custom tones by using the "Create new tone" button, and they will be stored locally, and thus persist across sessions, but will only be available on your current computer.</div>
+<div class="question">How does the format verses part work?</div>
+<div class="answer"><p>This is where certain aspects of the textual part of the output can be adjusted.  If the name of the selected format has GABC in it, all verses will be output in GABC notation.  Otherwise, all but the first and sometimes second verse will be formatted text with no GABC.  Also, you can adjust the settings for the first verse by selecting GABC and changing the settings on the right side, and then selecting the format that you actually want to use for the subsequent verses.</p>
+  <p>The parameters of the currently selected verse format show up on the right, "Begin Peparatory Syllable", etc. and it should be fairly obvious what they refer to.  The default format is to italicize the preparatory syllables and to bold the accented syllables.  The verse prefix is just text that gets put before each verse ($c will be replaced by the current verse number) and the verse suffix is simply put at the end of each verse.  The non-breaking space is used between a word and a flex or mediant to prevent a line break from occurring.</p>
+  <p>The "Verses Filename" is used when dragging the 'Download Verses' link from Chrome (no other browsers support this) into an Explorer window as the name of the file.  It is also used by the "Download ZIP of all psalms in each tone" for the name of the verses files.  It is also applied to the name field in the header, but for this it will cut off everything after the last period as well as the period itself (e.g., $psalm-$tone.tex becomes $psalm-$tone).  Also, $psalm will be replaced with the psalm number (or Magnificat, etc.) and $tone will be replaced with the tone and termination, e.g., 8gstar or solemn8g.</p>
+  </div>
+<div class="question">You didn't mention the checkboxes beneath the Format verses dropdown.  What are they all about?</div>
+<div class="answer"><p>"Only format vowels" will cause only the vowels of the preparatory and accented syllables to be affected rather than the entire syllable.</p>
+  <p>"Use puncta cava" will cause puncta cava to be used in the chant parts of the output.</p>
+  <p>"Repeat intonation" will cause the intonation to be repeated on each verse, and is automatically checked if the Magnificat or Benedictus is selected or "Solemn Tone" is checked at the top, and is automatically unchecked if a psalm is selected.</p>
+</div>
+<div class="question">Is there anything else I should know about the formats?</div>
+<div class="answer">Yes, and it is simply this: if the format name has html in it, the verses will be rendered as html on the page, otherwise they will be rendered as text.</div>
+<br/>
+<div class="question">What about the Readings Tool?</div>
+<div class="answer">I wrote this just before Advent 2011, and made some slight modifications through January 2012.  This is not a tool that I myself need to use very often, so I am not as sure whether there are many problems with it.  The special characters (used in the Text that the tone is applied to) to control the output are as follows:
+<br><br>
+<b>+</b>: Causes a dotted punctum on the previous syllable and a quarter bar immediately after.
+<br/><b>~</b> (or <b>:</b> or <b>,,</b> or <b>,</b> followed by a new line): Causes the Mediant tone to be used
+<br/><b>.</b> or <b>!</b> or <b>::</b> will cause the full stop tone to be used
+<br/><b>?</b> will cause the Question tone to be used.
+</div>
+<br/>
+<div class="question">Supposing I have a question that isn't answered here?</div>
+<div class="answer">You may contact me via e-mail and I will probably respond: jgabc [at] christian.net</div>
+</div>
+</body>
+</html>
+<div class="question"></div>
+<div class="answer"></div>