From 65ff5cb34596f15fda21e8d5b484b6d938b72c8a Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Tue, 28 May 2019 21:25:28 +0000 Subject: musicography (28may19) git-svn-id: svn://tug.org/texlive/trunk@51251 c570f23f-e606-0410-a88d-b1316a301751 --- .../doc/latex/musicography/musicography.pdf | Bin 264002 -> 328394 bytes .../doc/latex/musicography/musicography.tex | 110 ++++++++++++++++++--- 2 files changed, 96 insertions(+), 14 deletions(-) (limited to 'Master/texmf-dist/doc') diff --git a/Master/texmf-dist/doc/latex/musicography/musicography.pdf b/Master/texmf-dist/doc/latex/musicography/musicography.pdf index aace9ed835f..3d8ab64a0b3 100644 Binary files a/Master/texmf-dist/doc/latex/musicography/musicography.pdf and b/Master/texmf-dist/doc/latex/musicography/musicography.pdf differ diff --git a/Master/texmf-dist/doc/latex/musicography/musicography.tex b/Master/texmf-dist/doc/latex/musicography/musicography.tex index 54f26e0ca10..2b7981c188d 100644 --- a/Master/texmf-dist/doc/latex/musicography/musicography.tex +++ b/Master/texmf-dist/doc/latex/musicography/musicography.tex @@ -27,7 +27,7 @@ {\nolinkurl{andrewacashner@gmail.com}}% }% } -\date{May 21, 2018} +\date{May 28, 2019} \begin{document} \maketitle @@ -39,7 +39,8 @@ The \code{lilyglyphs} package uses Lilypond's fonts, but requires This package makes available the most commonly used symbols in writing about music in a way that can be used with \code{pdflatex} and looks consistent and attractive. -It includes accidentals, meters, and notes of different rhythmic values. +It includes accidentals, meters, notes of different rhythmic values, and +automatic formatting of figured bass. This package builds on the approach used in the \code{harmony} package, where the symbols are taken from the MusiXTeX fonts. @@ -58,6 +59,9 @@ the other package. The \code{bigger} option provides larger font sizes that match better with certain fonts. +The package now (2019) provides full support for figured-bass notation using the +\verb|\musFig| command. + The \verb|\musNumFont| command allows you to change the font of the numerals used. For example, if using the \code{ebgaramond} font package, it looks better if you @@ -66,6 +70,7 @@ do this: \verb|\renewcommand{\musNumFont}[1]{\liningnums{#1}}|. \end{quote} + \section{Symbols and Commands} \subsection{Accidentals} @@ -92,6 +97,8 @@ there are also aliases for older note names. Eighth note (corchea) & \verb|\musEighth| or \verb|\musCorchea| & \musEighth\\ Sixteenth note & \verb|\musSixteenth| & \musSixteenth\\ + Thirty-second note & \verb|\musThirtySecond| & \musThirtySecond\\ + Sixty-fourth note & \verb|\musSixtyFourth| & \musSixtyFourth\\ \end{codetable} A dot may be added to any of the above by adding \code{Dotted} to the end of the @@ -100,6 +107,8 @@ command. For example: \begin{codetable} Dotted whole note & \verb|\musWholeDotted| & \musWholeDotted\\ Dotted quarter note & \verb|\musQuarterDotted| & \musQuarterDotted\\ + Dotted thirty-second note & \verb|\musThirtySecondDotted| & + \musThirtySecondDotted\\ \end{codetable} \subsection{Meter Signatures} @@ -111,12 +120,66 @@ command. For example: Ternary with $3:2$ proportion & \verb|\meterCThreeTwo| & \meterCThreeTwo\\ Spanish 17th-cent. ternary & \verb|\meterCZ| & \meterCZ\\ + Medieval \term{tempus perfectum} & \verb|\meterO| & \meterO\\ \end{codetable} -For other time signatures, use \verb|\musMeter{}{}|. -The command \verb|\musFigures| is an alias for \verb|\musMeter| that can be used -for notating figured bass. -Both commands take two arguments and stack the arguments vertically. +For other time signatures, use \verb|\musMeter{}{}|; the two arguments are the +numerator and denominator of the fraction, respectively. + +\subsection{Figured Bass} + +For figured-bass notation, use \verb|\musFig{}|. +The command, as of May 2019 now re-implemented using the \code{stackengine} +package, takes a single argument which may contain as many space-separated +elements as you like. +(The \verb|\musFig| command is implemented with \verb|\musStack{}|, which is +also used to for \verb|\musMeter|.) + +The elements in the argument will be stacked vertically and left-aligned. +Multiple figures in a row should be enclosed in brackets if there are spaces +between them. + +To align figures when there are empty slots, as in \musFig{6--5 +\noFig[5--]\musSharp}, use \verb|\noFig[]|. +It will insert horizontal space the +same width as its optional argument when typeset; the default value is the +width of the numeral 5. +It does this using \verb|\hphantom|, so you should supply the same text in the +argument as the figure with which you want to align. +The code for the example at the beginning of this paragraph was +\verb|\musFig{6--5 \noFig[5--]\musSharp}|. + +The font may be controlled by redefining \verb|\musFigFont{}|. +Its default value is as follows: +\begin{Verbatim} +\NewDocumentCommand{\musFigFont}{}{% + \scriptsize + \let\musFontLarge\musFontBig +} +\end{Verbatim} +This reduces the size of numbers and the music font so that they fit better with +surrounding text and so that numerals and accidentals in the figures match. + + + +{\renewcommand{\arraystretch}{2.5} +\small +\begin{codetable} + Two figures & \verb|\musFig{7 5\musSharp}| + & \musFig{7 5\musSharp}\\ + Three figures & \verb|\musFig{7\musFlat{} 5 3}| + & \musFig{7\musFlat{} 5 3}\\ + Four figures & \verb|\musFig{7 5 4 2}| & + \musFig{9 7 5 3}\\ + Voice leading & \verb|\musFig{7--6 5--4 3}| + & \musFig{7--6 5--4 3}\\ + Voice leading & \verb|\musFig{6--7 4--5 \noFig[2--]3}| + & \musFig{7--6 5--4 \noFig[2--]3}\\ + Multiple figures per row + & \verb|\musFig{{6\musFlat{} 5} {\noFig[6\musFlat] \musSharp}}| + & \musFig{{6\musFlat{} 5} {\noFig[6\musFlat] \musSharp}}\\ +\end{codetable}} + \subsection{Customization} @@ -129,14 +192,33 @@ See \verb|\musSymbol| and \verb|\musAccidental| in the code listing below. \section{Changes} -\begin{tabular}{r p{0.75\textwidth}} - 2018/05/21 & Override semantic-markup's \verb|\fl|, \verb|\sh|, \verb|\na| - commands if it is loaded \\ - 2017/10/31 & Corrected glyph used for \verb|\musHalf| and documented - \verb|\musMeter| and \verb|\musFigures|\\ - 2017/08/29 & First version on CTAN\\ - 2017/04/12 & Created\\ -\end{tabular} +\begin{itemize} + \item[2019/05/28] Bux fixes and new features, especially figured bass + \begin{itemize} + \item Fix issue 1 on Bitbucket, thanks to Christian Mondrup + \begin{itemize} + \item Correct mistaken notehead symbol for values less than + quarter note (was hollow, now filled) + \item Add 32nd and 64th notes, regular and dotted varieties + \item \verb|\musSymbol| is now typeset inside an + \verb|\mbox| to fix alignment problems when used in + tables + \end{itemize} + \item New features (some requested in issue no. 1): + \begin{itemize} + \item Add medieval perfect meter + \item Add aliases for \term{fusa} ($=$ corchea $=$ eighth note) + \item Replace musStack implementation with \code{stackengine} + \item Add full figured-bass support + \end{itemize} + \end{itemize} + \item[2018/05/21] Override semantic-markup's \verb|\fl|, \verb|\sh|, + \verb|\na| commands if it is loaded + \item[2017/10/31] Corrected glyph used for \verb|\musHalf| and documented + \verb|\musMeter| and \verb|\musFigures| + \item[2017/08/29] First version on CTAN + \item[2017/04/12] Created +\end{itemize} \section{Code} -- cgit v1.2.3