From e34ba1cbe700c96794b9488ec6922ee328c722f0 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Sat, 30 Sep 2017 23:08:42 +0000 Subject: musicography (30sep17) git-svn-id: svn://tug.org/texlive/trunk@45440 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/latex/musicography/README.md | 11 ++ .../doc/latex/musicography/musicography.pdf | Bin 0 -> 262850 bytes .../doc/latex/musicography/musicography.tex | 130 +++++++++++++++++++++ 3 files changed, 141 insertions(+) create mode 100644 Master/texmf-dist/doc/latex/musicography/README.md create mode 100644 Master/texmf-dist/doc/latex/musicography/musicography.pdf create mode 100644 Master/texmf-dist/doc/latex/musicography/musicography.tex (limited to 'Master/texmf-dist/doc/latex') diff --git a/Master/texmf-dist/doc/latex/musicography/README.md b/Master/texmf-dist/doc/latex/musicography/README.md new file mode 100644 index 00000000000..65bca60bc05 --- /dev/null +++ b/Master/texmf-dist/doc/latex/musicography/README.md @@ -0,0 +1,11 @@ +# The `musicography` package: Symbols for Music Writing with `pdflatex` + +This package makes available the most commonly used symbols in writing about +music in a way that can be used with `pdflatex` and looks consistent and +attractive. +It includes accidentals, meters, and notes of different rhythmic values. +The package provides a flexible, user-friendly interface written using `xparse`. + +This material is subject to the current version of the LaTeX Project Public +License. +The author and maintainer is Andrew A. Cashner, `andrewacashner@gmail.com`. diff --git a/Master/texmf-dist/doc/latex/musicography/musicography.pdf b/Master/texmf-dist/doc/latex/musicography/musicography.pdf new file mode 100644 index 00000000000..871488be172 Binary files /dev/null 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 new file mode 100644 index 00000000000..b20a6c69620 --- /dev/null +++ b/Master/texmf-dist/doc/latex/musicography/musicography.tex @@ -0,0 +1,130 @@ +\documentclass{article} + +\usepackage{lmodern} +\usepackage[T1]{fontenc} +\usepackage[utf8]{inputenc} +\usepackage{geometry} +\usepackage{semantic-markup} +\usepackage{musicography} +\usepackage{fancyvrb} +\frenchspacing + +\newenvironment{codetable} +{\begin{quote}\begin{tabular}{lll}} +{\end{tabular}\end{quote}} + +\usepackage[ + pdftitle={The musicography Package: Symbols for Music Writing with + pdflatex}, + pdfauthor={Andrew A. Cashner}, + pdfsubject={LaTeX package}, + pdfkeywords={LaTeX, symbols, music, musicology, humanities} +]{hyperref} + +\title{The \code{musicography} Package: Symbols for Music Writing with +\code{pdflatex}} +\author{Andrew A. Cashner\thanks{% + \href{mailto:andrewacashner@gmail.com} + {\nolinkurl{andrewacashner@gmail.com}}% + }% +} + +\begin{document} +\maketitle + +Font packages for \code{pdflatex} only provided a limited range of musical +symbols. +The \code{lilyglyphs} package uses Lilypond's fonts, but requires +\code{lualatex}. +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. + +This package builds on the approach used in the \code{harmony} package, where +the symbols are taken from the MusiXTeX fonts. +But it provides a larger range of symbols and a more flexible, user-friendly +interface written using \code{xparse}. + +\tableofcontents + +\section{Package Options} + +To use the package, write \verb|\usepackage{musicography}| in your preamble. +If you are also using this author's \code{semantic-markup} package, load +\code{semantic-markup} first, since \code{musicography} modifies the commands +for accidentals in the other package. + +The \code{bigger} option provides larger font sizes that match better with +certain fonts. + +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 +do this: +\begin{quote} + \verb|\renewcommand{\musNumFont}[1]{\liningnums{#1}}|. +\end{quote} + +\section{Symbols and Commands} + +\subsection{Accidentals} + +\begin{codetable} + Flat & \verb|\musFlat| or \verb|\fl| & \musFlat\\ + Sharp & \verb|\musSharp| or \verb|\sh| & \musSharp\\ + Natural & \verb|\musNatural| or \verb|\na| & \musNatural\\ + Double Flat & \verb|\musDoubleFlat| & \musDoubleFlat\\ + Double Sharp & \verb|\musDoubleSharp| & \musDoubleSharp\\ +\end{codetable} + +\subsection{Notes of Different Rhythmic Values} + +Commands are available using modern (United States) note names; in several cases +there are also aliases for older note names. + +\begin{codetable} + Whole note (semibreve) & \verb|\musWhole| or \verb|\musSemibreve| & + \musWhole\\ + Half note (minim) & \verb|\musHalf| or \verb|\musMinim| & \musHalf\\ + Quarter note (semiminim) & \verb|\musQuarter| or \verb|\musSeminimin| & + \musQuarter\\ + Eighth note (corchea) & \verb|\musEighth| or \verb|\musCorchea| & + \musEighth\\ + Sixteenth note & \verb|\musSixteenth| & \musSixteenth\\ +\end{codetable} + +A dot may be added to any of the above by adding \code{Dotted} to the end of the +command. For example: + +\begin{codetable} + Dotted whole note & \verb|\musWholeDotted| & \musWholeDotted\\ + Dotted quarter note & \verb|\musQuarterDotted| & \musQuarterDotted\\ +\end{codetable} + +\subsection{Meter Signatures} + +\begin{codetable} + Common duple & \verb|\meterC| & \meterC\\ + \term{Alla breve} & \verb|\meterCutC| & \meterCutC\\ + Ternary (16th--18th cent.) & \verb|\meterCThree| & \meterCThree\\ + Ternary with $3:2$ proportion & \verb|\meterCThreeTwo| & + \meterCThreeTwo\\ + Spanish 17th-cent. ternary & \verb|\meterCZ| & \meterCZ\\ +\end{codetable} + +\subsection{Customization} + +It would be a simple matter of using \verb|\newcommand| or \verb|\let| to create +aliases for these commands, say, for British usage (such as \verb|\quaver|). + +\LaTeX{} programmers may wish to use the package's internal commands directly +(such as \verb|\musSymbol| and \verb|\musAccidental|) to +access more symbols from the fonts or to fine-tune their appearance (see the +code listing below). + +\section{Code} + +\VerbatimInput{musicography.sty} + +\end{document} -- cgit v1.2.3