3.1 Un ejemplo de documento musicológico

Ciertos textos contienen ejemplos musicales. Son tratados musicales, cancioneros o manuales como este mismo. Estos textos se pueden hacer a mano, importando simplemente una imagen en formato PostScript en el editor de textos. Sin embargo, hay un procedimiento automático para reducir la carga de trabajo que esto implica los documentos de HTML, LaTeX, Texinfo y DocBook.

Un guión ejecutable llamado lilypond-book extrae los fragmentos de música, les da formato y vuelve a poner en su lugar la partitura resultante. A continuación presentamos un pequeño ejemplo de su utilización con LaTeX. El ejemplo contiene también texto explicativo, por lo que no vamos a comentarlo posteriormente.

Entrada

\documentclass[a4paper]{article}

\begin{document}

Los documentos para \verb+lilypond-book+ pueden mezclar libremente
música y texto. Por ejemplo:

\begin{lilypond}
\relative {
  c'2 e2 \tuplet 3/2 { f8 a b } a2 e4
}
\end{lilypond}

Las opciones se escriben entre corchetes.

\begin{lilypond}[fragment,quote,staffsize=26,verbatim]
  c'4 f16
\end{lilypond}

Los ejemplos grandes se pueden grabar en archivos separados e
introducirse con \verb+\lilypondfile+.

\lilypondfile[quote,noindent]{screech-and-boink.ly}

(Si es necesario, sustituya @file{screech-and-boink.ly}
por cualquier archivo @file{.ly}
situado en el mismo directorio que este archivo.)

\end{document}

Procesado

Guarde el código anterior como un archivo llamado lilybook.lytex, y luego ejecute en un terminal:

lilypond-book --output=out --pdf lilybook.lytex
lilypond-book (GNU LilyPond) 2.25.22 
Leyendo lilybook.lytex...
…montañas de mensajes suprimidos…
Compilando lilybook.tex…
cd out
pdflatex lilybook
…montañas de mensajes suprimidos…
xpdf lilybook
(sustituya xpdf por su visor de PDF favorito)

La ejecución de lilypond-book y latex crea un gran número de archivos temporales, que podrían abarrotar el directorio de trabajo. Para poner remedio a esto utilice la opción --output=directorio. Creará los archivos en un subdirectorio aparte directorio.

Finalmente el resultado del ejemplo de LaTeX que acabamos de mostrar³. Así acaba la sección del tutorial.

Salida

Los documentos para lilypond-book pueden mezclar libremente música y texto. Por ejemplo:

Las opciones se escriben entre corchetes.

c'4 f16

Los ejemplos grandes se pueden grabar en archivos separados e introducirse con \lilypondfile.

Si se requiere un campo tagline, ya sea predeterminado o personalizado, entonces el fragmento completo se debe incluir dentro de una construcción \book { }.

\book{
  \header{
    title = "Una escala en LilyPond"
  }

  \relative {
    c' d e f g a b c
  }
}