diff options
Diffstat (limited to 'Master/texmf-dist/doc/luatex/gregoriotex/Gabc.tex')
| -rw-r--r-- | Master/texmf-dist/doc/luatex/gregoriotex/Gabc.tex | 152 |
1 files changed, 76 insertions, 76 deletions
diff --git a/Master/texmf-dist/doc/luatex/gregoriotex/Gabc.tex b/Master/texmf-dist/doc/luatex/gregoriotex/Gabc.tex index 2afcf872343..27ef298188b 100644 --- a/Master/texmf-dist/doc/luatex/gregoriotex/Gabc.tex +++ b/Master/texmf-dist/doc/luatex/gregoriotex/Gabc.tex @@ -46,54 +46,54 @@ Some headers have special meaning to Gregorio: \begin{description} \item[name] This is the name of the piece, in almost all cases the - incipit, the first few words. In the case of the mass ordinary, the - form as \texttt{Kyrie X Alme Pater} or \texttt{Sanctus XI} is - recommended where appropriate. \textbf{This field is required.} + incipit, the first few words. In the case of the mass ordinary, the + form as \texttt{Kyrie X Alme Pater} or \texttt{Sanctus XI} is + recommended where appropriate. \textbf{This field is required.} \item[gabc-copyright] This license is the copyright notice (in English) of the gabc file, as chosen by the person named in the transcriber field. As well as the notice itself, it may include a brief description of the license, such as public domain, CC-by-sa; for a list of commonly found open source licenses and exceptions, please see \url{https://spdx.org/licenses/}. A separate text file will be necessary for the complete legal license. For the legal issues about Gregorian chant scores, please see \url{http://gregorio-project.github.io/legalissues}. An example of this field would be: - \begin{lstlisting}[autogobble] - gabc-copyright: CC0-1.0 by Elie Roux, 2009 <http://creativecommons.org/publicdomain/zero/1.0/>; - \end{lstlisting} + \begin{lstlisting}[autogobble] + gabc-copyright: CC0-1.0 by Elie Roux, 2009 <http://creativecommons.org/publicdomain/zero/1.0/>; + \end{lstlisting} \item[score-copyright] This license is the copyright notice (in English) of the score itself from which the gabc was transcribed. Like the \texttt{gabc-copyright}, there may be a brief description of the license too. In unclear or complex cases it may be omitted; it is most suitable for use when the transcriber is the copyright holder and licensor of the score as well. One again, reading the page on legal issues (linked above) is recommended. An example of this field would be: - \begin{lstlisting}[autogobble] - score-copyright: (C) Abbaye de Solesmes, 1934; - \end{lstlisting} + \begin{lstlisting}[autogobble] + score-copyright: (C) Abbaye de Solesmes, 1934; + \end{lstlisting} \item[author] The author of the piece, if known; of course, the author of most traditional chant is not known. \item[language] The language of the lyrics. \item[oriscus-orientation] If \texttt{legacy}, the orientation of an unconnected oriscus must be set manually. \item[mode] The mode of the piece. This should normally be an arabic - number between 1 and 8, but may be any text required for unusual - cases. The mode number will be converted to roman numerals and - placed above the initial unless one of the following conditions are - met: - \begin{itemize} - \item There is a \verb=\greannotation= defined immediatly prior to \verb=\gregorioscore=. - \item The \texttt{annotation} header field is defined. - \end{itemize} + number between 1 and 8, but may be any text required for unusual + cases. The mode number will be converted to roman numerals and + placed above the initial unless one of the following conditions are + met: + \begin{itemize} + \item There is a \verb=\greannotation= defined immediatly prior to \verb=\gregorioscore=. + \item The \texttt{annotation} header field is defined. + \end{itemize} \item[mode-modifier] The mode ``modifier'' of the piece. This may be any - \TeX\ code to typeset after the mode, if the mode is typeset. If the mode - is not typeset, the mode-modifier will also not be typeset. + \TeX\ code to typeset after the mode, if the mode is typeset. If the mode + is not typeset, the mode-modifier will also not be typeset. \item[mode-differentia] The mode or tone differentia of the piece. Typically, - this expresses the variant of the psalm tone to use for the piece. This may - be any \TeX\ code to typeset after the mode-modifier, if the mode is typeset. - If the mode is not typeset, the mode-differentia will also not be typeset. + this expresses the variant of the psalm tone to use for the piece. This may + be any \TeX\ code to typeset after the mode-modifier, if the mode is typeset. + If the mode is not typeset, the mode-differentia will also not be typeset. \item[annotation] The annotation is the text to appear above the - initial letter. Usually this is an abbreviation of the office-part - in the upper line, and an indication of the mode (and differentia - for antiphons) in the lower. Either one or two annotation fields may - be used; if two are used, the first is the upper line, the second - the lower. Example: - \begin{lstlisting}[autogobble] - annotation:Ad Magnif.; - annotation:VIII G; - \end{lstlisting} - Full \TeX\ markup is accepted: - \begin{lstlisting}[autogobble] - annotation:{\color{red}Ad Magnif.}; - annotation:{\color{red}VIII G}; - \end{lstlisting} - If the user already defined annotation(s) in the main \TeX\ file via - \verb=\greannotation= then the \texttt{annotation} header field will not - overwrite that definition. + initial letter. Usually this is an abbreviation of the office-part + in the upper line, and an indication of the mode (and differentia + for antiphons) in the lower. Either one or two annotation fields may + be used; if two are used, the first is the upper line, the second + the lower. Example: + \begin{lstlisting}[autogobble] + annotation:Ad Magnif.; + annotation:VIII G; + \end{lstlisting} + Full \TeX\ markup is accepted: + \begin{lstlisting}[autogobble] + annotation:{\color{red}Ad Magnif.}; + annotation:{\color{red}VIII G}; + \end{lstlisting} + If the user already defined annotation(s) in the main \TeX\ file via + \verb=\greannotation= then the \texttt{annotation} header field will not + overwrite that definition. \end{description} Although gregorio ascribes no special meaning to them, other suggested headers are: @@ -151,16 +151,16 @@ before it. Some examples: \begin{tabularx}{\textwidth}{l|l|l|X} - \texttt{mode} & \texttt{mode-modifier} & \texttt{mode-differentia} & Result \\ - \hline - \verb=6= & & & \writemode{\romannumeral 6}{}{} \\ - \verb=4A= & & & \writemode{\romannumeral 4\relax A}{}{} \\ - \verb=4a= & & & \writemode{\romannumeral 4\relax a}{}{} \\ - \verb=2*= & \verb=t.= & & \writemode{\romannumeral 2*}{\thinspace t.}{} \\ - \verb=5= & \verb=,\thinspace t.= & & \writemode{\romannumeral 5}{,\thinspace t.}{} \\ - \verb=7= & & {\scriptsize\verb=c\raise0.5ex\hbox{\small2}=} & \writemode{\romannumeral 7}{}{\thinspace c\raise0.5ex\hbox{\small2}} \\ - \verb=8= & \verb=-t.= & \verb=G*= & \writemode{\romannumeral 8}{-t.}{\thinspace G*} \\ - {\scriptsize\verb=t. irregularis=} & & & \writemode{t. irregularis}{}{} \\ + \texttt{mode} & \texttt{mode-modifier} & \texttt{mode-differentia} & Result \\ + \hline + \verb=6= & & & \writemode{\romannumeral 6}{}{} \\ + \verb=4A= & & & \writemode{\romannumeral 4\relax A}{}{} \\ + \verb=4a= & & & \writemode{\romannumeral 4\relax a}{}{} \\ + \verb=2*= & \verb=t.= & & \writemode{\romannumeral 2*}{\thinspace t.}{} \\ + \verb=5= & \verb=,\thinspace t.= & & \writemode{\romannumeral 5}{,\thinspace t.}{} \\ + \verb=7= & & {\scriptsize\verb=c\raise0.5ex\hbox{\small2}=} & \writemode{\romannumeral 7}{}{\thinspace c\raise0.5ex\hbox{\small2}} \\ + \verb=8= & \verb=-t.= & \verb=G*= & \writemode{\romannumeral 8}{-t.}{\thinspace G*} \\ + {\scriptsize\verb=t. irregularis=} & & & \writemode{t. irregularis}{}{} \\ \end{tabularx} \subsection{Neume Fusion} @@ -169,16 +169,16 @@ Neume fusion allows for the composition of new shapes based on a set of primitive neumes. These primitives are: \begin{tabularx}{\textwidth}{l|l|X} - Gabc & Description & Rules \\ - \hline - \texttt{g} & punctum & fuses from higher or lower notes, and can fuse to higher or lower notes \\ - \texttt{go} & oriscus & may only fuse in the direction it was fused from \\ - \texttt{gO} & oriscus scapus & at the start only, next note must be higher to fuse \\ - \texttt{gw} & quilisma & does not fuse from anything, and only fuses to a higher note \\ - \texttt{gV} & virga reversa & at the start only, next note must be lower to fuse \\ - \texttt{gf} & flexus & if not at the end, must be followed by a higher note to fuse \\ - \texttt{gh} & pes & at the end only; in non-liquescent form, the previous note must be lower to fuse \\ - \texttt{gfg} & porrectus & at the end only, previous note must be lower to fuse \\ + Gabc & Description & Rules \\ + \hline + \texttt{g} & punctum & fuses from higher or lower notes, and can fuse to higher or lower notes \\ + \texttt{go} & oriscus & may only fuse in the direction it was fused from \\ + \texttt{gO} & oriscus scapus & at the start only, next note must be higher to fuse \\ + \texttt{gw} & quilisma & does not fuse from anything, and only fuses to a higher note \\ + \texttt{gV} & virga reversa & at the start only, next note must be lower to fuse \\ + \texttt{gf} & flexus & if not at the end, must be followed by a higher note to fuse \\ + \texttt{gh} & pes & at the end only; in non-liquescent form, the previous note must be lower to fuse \\ + \texttt{gfg} & porrectus & at the end only, previous note must be lower to fuse \\ \end{tabularx} Placing the \texttt{@} character between two notes will attempt to use the above @@ -300,13 +300,13 @@ defaults not be satisfactory. There are five tunable dimensions: \begin{tabularx}{\textwidth}{l|X} - Dimension & Description \\ - \hline - \texttt{overhepisemalowshift} & The shift for positioning a horizontal episema that is over a note in a low position in the space\\ - \texttt{overhepisemahighhift} & The shift for positioning a horizontal episema that is over a note in a high position in the space\\ - \texttt{underhepisemalowshift} & The shift for positioning a horizontal episema that is under a note in a low position in the space\\ - \texttt{underhepisemahighhift} & The shift for positioning a horizontal episema that is under a note in a high position in the space\\ - \texttt{hepisemamiddleshift} & The shift for centering the horizontal episema in the middle of a space\\ + Dimension & Description \\ + \hline + \texttt{overhepisemalowshift} & The shift for positioning a horizontal episema that is over a note in a low position in the space\\ + \texttt{overhepisemahighhift} & The shift for positioning a horizontal episema that is over a note in a high position in the space\\ + \texttt{underhepisemalowshift} & The shift for positioning a horizontal episema that is under a note in a low position in the space\\ + \texttt{underhepisemahighhift} & The shift for positioning a horizontal episema that is under a note in a high position in the space\\ + \texttt{hepisemamiddleshift} & The shift for centering the horizontal episema in the middle of a space\\ \end{tabularx} In addition, gabc allows you to adjust the positioning of a given episema by @@ -319,16 +319,16 @@ The position specifier allows you to select which of the five tunable dimensions will be used for the base position: \begin{tabularx}{\textwidth}{l|X} - Specifier & Base shift \\ - \hline - \textit{omitted} & Use the default shift based on the position of the episema relative to the note\\ - \texttt{m} & Use \texttt{hepisemamiddleshift}.\\ - \texttt{l} & Use \texttt{overhepisemalowshift} or \texttt{underhepisemalowshift} depending on whether the episema is over or under the note.\\ - \texttt{h} & Use \texttt{overhepisemahighshift} or \texttt{underhepisemahighshift} depending on whether the episema is over or under the note.\\ - \texttt{ol} & Use \texttt{overhepisemalowshift}.\\ - \texttt{oh} & Use \texttt{overhepisemahighshift}.\\ - \texttt{ul} & Use \texttt{underhepisemalowshift}.\\ - \texttt{uh} & Use \texttt{underhepisemahighshift}.\\ + Specifier & Base shift \\ + \hline + \textit{omitted} & Use the default shift based on the position of the episema relative to the note\\ + \texttt{m} & Use \texttt{hepisemamiddleshift}.\\ + \texttt{l} & Use \texttt{overhepisemalowshift} or \texttt{underhepisemalowshift} depending on whether the episema is over or under the note.\\ + \texttt{h} & Use \texttt{overhepisemahighshift} or \texttt{underhepisemahighshift} depending on whether the episema is over or under the note.\\ + \texttt{ol} & Use \texttt{overhepisemalowshift}.\\ + \texttt{oh} & Use \texttt{overhepisemahighshift}.\\ + \texttt{ul} & Use \texttt{underhepisemalowshift}.\\ + \texttt{uh} & Use \texttt{underhepisemahighshift}.\\ \end{tabularx} The nudge is a \TeX{} dimension specification (number and units) that starts |