LilyPond: manual de utilización del programa: 3.1 Un ejemplo de documento musicológico

## 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' {
>       c2 e2 \times 2/3 { 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-boink.ly}

>     (Si es necesario, sustituya @file{screech-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.14.2
>     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 mostrar1. 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' {
        c d e f g a b c
      }
    }

### Notas el pie

[1] Este tutorial se procesa con Texinfo, por lo que el ejemplo presenta un resultado en la disposición ligeramente distinto.

Otros idiomas: English, deutsch, français, magyar, italiano.

#### LilyPond — Utilización