Referencia de la notación de GNU LilyPond: 3.1 Estructura del código de entrada

[ >> ]

[ ? ]

3.1.1 Estructura de una partitura

@translationof Structure of a score

Un bloque \score debe contener una expresión musical única delimitada por un par de llaves:

\score {
  …
}

Nota: Sólo puede haber una expresión musical dentro del bloque score, y debe estar encerrada entre llaves.

Esta expresión musical única puede tener cualquier tamaño, y puede contener otras expresiones musicales hasta cualquier grado de complejidad. Todos los siguientes ejemplos son expresiones musicales:

{ c'4 c' c' c' }

{
  { c'4 c' c' c' }
  { d'4 d' d' d' }
}

<<
  \new Staff { c'4 c' c' c' }
  \new Staff { d'4 d' d' d' }
>>

{
  \new GrandStaff <<
    \new StaffGroup <<
      \new Staff { \flute }
      \new Staff { \oboe }
    >>
    \new StaffGroup <<
      \new Staff { \violinI }
      \new Staff { \violinII }
    >>
  >>
}

Los comentarios son una excepción a esta regla general (para ver otras excepciones, consulte Estructura del archivo). Tanto los comentarios de una línea como los que están delimitados por %{ … %} se pueden escribir en cualquier lugar dentro del archivo de entrada. Se pueden escribir dentro o fuera del bloque \score, y dentro o fuera de la expresión musical única dentro del bloque \score.

Recuerde que incluso dentro de un archivo que contenga solamente un bloque \score, éste se encuentra incluido implícitamente dentro de un bloque \book. Un bloque \book dentro de un archivo fuente produce al menos un archivo de salida, y de forma predeterminada el nombre del archivo de salida que se produce está derivado del nombre del archivo de entrada, de forma que ‘fandangoforelephants.ly’ da como resultado ‘fandangoforelephants.pdf’.

(Para ver más detalles acerca de los bloques \book, consulte Varias partituras en un libro, Varios archivos de salida a partir de uno de entrada y Estructura del archivo.)

Véase también

Manual de aprendizaje: (learning)Trabajar sobre los archivos de entrada sección ‘Trabajar sobre los archivos de entrada’ en Manual de Aprendizaje, (learning)Explicación de las expresiones musicales sección ‘Explicación de las expresiones musicales’ en Manual de Aprendizaje, (learning)La partitura es una (única) expresión musical compuesta sección ‘La partitura es una (única) expresión musical compuesta’ en Manual de Aprendizaje.

[ < ]

[ > ]

[ << ]

[ >> ]

[ ? ]

3.1.2 Varias partituras en un libro

@translationof Multiple scores in a book

Un documento puede contener varias piezas de música y texto. Son ejemplos un libro de estudios o una parte orquestal con varios movimientos. Cada movimiento se introduce con un bloque \score:

\score {
  …música…
}

y los textos se introducen con un bloque \markup:

\markup {
  …texto…
}

Todos los movimientos y textos que aparecen en el mismo archivo ‘.ly’ se tipografían normalmente en la forma de un solo archivo de salida.

\score {
  …
}
\markup {
  …
}
\score {
  …
}

Una excepción importante se da dentro de los documentos de lilypond-book, en los que tenemos que escribir explícitamente un bloque \book, pues en caso contrario sólo aparecerá en la salida el primer \score o \markup.

El encabezamiento de cada pieza se puede poner dentro del bloque \score. Antes de cada movimiento, se imprime el nombre de la pieza (piece) extraído del encabezamiento. El título del libro entero se puede poner dentro del bloque \book, pero si no está presente se inserta el encabezamiento \header que está al principio del archivo.

\header {
  title = "Ocho miniaturas"
  composer = "Igor Stravinsky"
}
\score {
  …
  \header { piece = "Romanze" }
}
\markup {
   …texto de la segunda estrofa…
}
\markup {
   …texto de la tercera estrofa…
}
\score {
  …
  \header { piece = "Menuetto" }
}

Se pueden agrupar distintas piezas de música en partes de un libro utilizando bloques \bookpart. Las partes de libro se separan por medio de saltos de página, y pueden dar comienzo con un título, como el libro propiamente dicho, mediante la especificación del bloque \header.

\bookpart {
  \header {
    title = "Título del libro"
    subtitle = "Primera parte"
  }
  \score { … }
  …
}
\bookpart {
  \header {
    subtitle = "Segunda parte"
  }
  \score { … }
  …
}

[ < ]

[ > ]

[ << ]

[ >> ]

[ ? ]

3.1.3 Varios archivos de salida a partir de uno de entrada

@translationof Multiple output files from one input file

Si queremos varios archivos de salida a partir del mismo archivo ‘.ly’, podemos escribir varios bloques \book, donde cada uno de estos bloques \book dará como resultado un archivo de salida distinto. Si no especificamos ningún bloque \book en el archivo, LilyPond trata implícitamente todo el archivo como un solo bloque \book, véase Estructura del archivo.

Al producir varios archivos a partir de un solo archivo fuente, LilyPond se asegura de que ninguno de los archivos de salida de ningún bloque \book sobreescribe el archivo de salida producido por un \book anterior del mismo archivo de entrada.

Lo hace añadiendo un sufijo al nombre de la salida para cada libro \book que utiliza el nombre del archivo de salida predeterminado, derivado del archivo fuente de entrada.

El comportamiento predeterminado es añadir un sufijo con el número de versión para cada nombre que pueda coincidir; así:

\book {
  \score { … }
  \paper { … }
}
\book {
  \score { … }
  \paper { … }
}
\book {
  \score { … }
  \paper { … }
}

en el archivo fuente ‘eightminiatures.ly’, produce

‘eightminiatures.pdf’,
‘eightminiatures-1.pdf’ y
‘eightminiatures-2.pdf’.

[ < ]

[ > ]

[ << ]

[ >> ]

[ ? ]

3.1.4 Nombres de los archivos de salida

@translationof Output file names

LilyPond le ofrece unos mecanismos que le permiten controlar los nombres de archivo que se utilizan por parte de los diversos motores finales al producir los archivos de salida.

En la sección anterior vimos cómo LilyPond evita las coincidencias de nombres al producir varias salidas a partir de un único archivo fuente de entrada. También podemos especificar nuestros propios sufijos para cada bloque \book, de manera que podemos producir, por ejemplo, archivos con los nombres ‘eightminiatures-Romanze.pdf’, ‘eightminiatures-Menuetto.pdf’ y ‘eightminiatures-Nocturne.pdf’ añadiendo una declaración \bookOutputSuffix dentro de cada bloque \book.

\book {
  \bookOutputSuffix "Romanze"
  \score { … }
  \paper { … }
}
\book {
  \bookOutputSuffix "Menuetto"
  \score { … }
  \paper { … }
}
\book {
  \bookOutputSuffix "Nocturne"
  \score { … }
  \paper { … }
}

También podemos especificar un nombre de archivo de salida diferente para cada bloque book, mediante la utilización de declaraciones \bookOutputName:

\book {
  \bookOutputName "Romanze"
  \score { … }
  \paper { … }
}
\book {
  \bookOutputName "Menuetto"
  \score { … }
  \paper { … }
}
\book {
  \bookOutputName "Nocturne"
  \score { … }
  \paper { … }
}

El código anterior produce los siguientes archivos de salida:

‘Romanze.pdf’,
‘Menuetto.pdf’ y
‘Nocturne.pdf’.

[ < ]

[ > ]

[ << ]

[ >> ]

[ ? ]

3.1.5 Estructura del archivo

@translationof File structure

Un archivo ‘.ly’ puede contener cualquier número de expresiones del nivel superior, donde una expresión del nivel superior es una de las siguientes posibilidades:

Una definición de salida, como \paper, \midi y \layout. Tal definición en el nivel más alto cambia los ajustes predeterminados para todo el libro. Si se introduce más de una de estas definiciones del mismo tipo en el nivel más alto, las definiciones se combinan, pero en situaciones de conflicto las definiciones más tardías tienen preferencia. Para ver los detalles sobre cómo afecta al bloque \layout, consulte El bloque \layout.
Una expresión directa de Scheme, como #(set-default-paper-size "a7" 'landscape) o #(ly:set-option 'point-and-click #f).
Un bloque \header. Esto establece el bloque de encabezamiento global (es decir, al principio del archivo). Es el bloque que contiene los ajustes predeterminados de los campos de encabezamientos como el compositor, título, etc. para todos los libros que están dentro del archivo (véase Explicación de los títulos).
Un bloque \score. Esta partitura se reúne con otras partituras del nivel superior, y se combina con ellas formando un \book (libro) único. Este comportamiento se puede cambiar estableciendo el valor de la variable toplevel-score-handler en el nivel superior (el handler predeterminado se define en el archivo ‘../scm/lily-library.scm’ y su valor se establece en el archivo ‘../ly/declarations-init.ly’.)
Un bloque \book combina lógicamente varios movimientos (es decir, varios bloques \score) en un solo documento. Si hay varias partituras \score, se crea un solo archivo de salida para cada bloque \book, en el que se concatenan todos los movimientos correspondientes. La única razón para especificar explícitamente bloques \book en un archivo de entrada ‘.ly’ es si queremos crear varios archivos de salida a partir de un único archivo de entrada. Una excepción se da dentro de los documentos de lilypond-book, en los que tenemos que escribir explícitamente un bloque \book si queremos tener más de una única partitura \score o marcado \markup en el mismo ejemplo. Se puede cambiar este comportamiento estableciendo el valor de la variable toplevel-book-handler en el nivel superior. El handler predeterminado se define en el archivo de inicio ‘../scm/lily.scm’.
Un bloque \bookpart. Un libro puede dividirse en varias partes, utilizando bloques \bookpart, con objeto de facilitar la inserción de saltos de página o usar distintos ajustes de \paper en las distintas partes.
Una expresión musical compuesta, como
{ c'4 d' e'2 }
Esto añade la pieza al \score y la conforma dentro de un libro único junto a todas las demás partituras \score y expresiones musicales del nivel superior. En otras palabras, un archivo que contiene sólo la expresión musical anterior se traduce a
\book { \score { \new Staff { \new Voice { { c'4 d' e'2 } } } \layout { } } \paper { } \header { } }
Se puede cambiar este comportamiento estableciendo el valor de la variable toplevel-music-handler en el nivel más alto. El handler predeterminado se define en el archivo de inicio ‘../scm/lily.scm’.
Un texto de marcado, por ejemplo una estrofa
\markup { 2. Estrofa dos, línea uno }
Los textos de marcado se colocan encima, en medio o debajo de las partituras o expresiones musicales, según donde aparezcan escritos.
Una variable, como
fulano = { c4 d e d }
Esto se puede utilizar más tarde en el archivo escribiendo \fulano. El nombre de las variables ha de ser exclusivamente alfabético; sin números, guiones ni barras bajas.

El ejemplo siguiente muestra tres cosas que se pueden introducir en el nivel superior:

\layout {
  % No justificar la salida
  ragged-right = ##t
}

\header {
   title = "Do-re-mi"
}

{ c'4 d' e2 }

En cualquier punto del archivo se pueden introducir cualquiera de las instrucciones léxicas siguientes:

\version
\include
\sourcefilename
\sourcefileline
Un comentario de una línea, determinado por un símbolo % al principio.
Un comentario de varias líneas, delimitado por %{ … %}.

Por lo general se ignoran los espacios entre elementos del flujo de entrada, y se pueden omitir o aumentar tranquilamente para mejorar la legibilidad. Sin embargo, los espacios se deben utilizar siempre para evitar errores, en las siguientes situaciones:

Alrededor de todas y cada una de las llaves curvas de apertura y cierre.
A continuación de las instrucciones y variables, es decir, todos los elementos que comienzan con un signo \ de barra invertida.
A continuación de todo elemento que se deba interpretar como expresión de Scheme, es decir, todo elemento que comience por un signo #.
Para separar los elementos de una expresión de Scheme.
Dentro de lyricmode antes y después de las instrucciones \set y \override.

Véase también

Manual de aprendizaje: (learning)Cómo funcionan los archivos de entrada de LilyPond sección ‘Cómo funcionan los archivos de entrada de LilyPond’ en Manual de Aprendizaje.

Referencia de la notación: Explicación de los títulos, El bloque \layout.

[ < ]

[ > ]

[ << ]