3.1 Cómo funcionan los archivos de entrada de LilyPond

@translationof How LilyPond input files work

El formato de entrada de LilyPond es bastante libre en su forma y concede a los usuarios con experiencia mucha flexibilidad para estructurar sus archivos de la forma que deseen. Sin embargo, toda esta flexibilidad puede hacer que las cosas se vuelvan confusas para los nuevos usuarios. Esta sección le va a explicar parte de esta estructura, pero puede obviar ciertos detalles en aras de la simplicidad. Para ver una descripción completa del formato de entrada, consulte (notation)Estructura del archivo sección ‘Estructura del archivo’ en Referencia de la Notación.

3.1.1 Introducción a la estructura de los archivos de LilyPond

@translationof Introduction to the LilyPond file structure

Un ejemplo básico de archivo de entrada de LilyPond es el siguiente:

\version "2.21.3"

\header { }

\score {
   … expresión musical compuesta …   % toda la música va aquí
  \layout { }
  \midi { }
}

Existen muchas variaciones de este esquema básico, pero el ejemplo constituye un útil punto de partida.

Hasta el momento, ninguno de los ejemplos que ha podido ver utiliza la instrucción \score{}. Esto es así a causa de que LilyPond añade automáticamente las órdenes adicionales que se requieren cuando le proporcionamos una entrada sencilla. LilyPond trata una entrada como esta:

\relative {
  c''4 a b c
}

como una abreviatura de esta otra:

\book {
  \score {
    \new Staff {
      \new Voice {
        \relative {
          c''4 a b c
        }
      }
    }
    \layout { }
  }
}

En otras palabras, si la entrada consta de una única expresión musical, LilyPond interpreta el archivo como si la expresión musical estuviera rodeada por un envoltorio hecho por las instrucciones que acabamos de ver.

¡Advertencia! Muchos de los ejemplos que aparecen en la documentación de LilyPond omiten las instrucciones \new Staff y \new Voice, dejando que se creen de forma implícita. Esto funciona bien para ejemplos sencillos, pero para ejemplos más complicados, especialmente cuando se usan instrucciones adicionales, la creación implícita de los contextos puede dar lugar a resultados inesperados, incluso en ocasiones crear pentagramas no deseados. La forma de crear contextos de forma explícita se explica en Contextos y grabadores.

De todas formas, por ahora vamos a volver al primer ejemplo para examinar la instrucción \score, dejando las demás en su forma predeterminada.

Un bloque \score siempre debe contener una expresión musical única. Recuerde que una expresión musical podía ser cualquier cosa entre una sola nota hasta una enorme expresión compuesta como

{
  \new StaffGroup <<
     … inserte aquí la partitura completa de una ópera de Wagner … 
  >>
}

Puesto que todo se encuentra dentro de { … }, cuenta como una expresión musical.

Como vimos anteriormente, el bloque \score puede contener otras cosas, tales como

\score {
  { c'4 a b c' }
  \header { }
  \layout { }
  \midi { }
}

Observe que estas tres instrucciones (\header, \layout y \midi) son especiales: a diferencia del resto de las instrucciones que comienzan con una barra invertida (\), no son expresiones musicales y no forman parte de ninguna expresión musical. Por tanto, se pueden situar dentro de un bloque \score o fuera de él. De hecho, estas instrucciones se sitúan por lo general fuera del bloque \score (por ejemplo, \header se suele colocar antes de la instrucción \score, como muestra el ejemplo que aparece al principio de la sección.

Dos instrucciones más que no hemos visto aún son \layout { } y \midi { }. Si aparecen tal y como se muestran aquí, hacen que LilyPond produzca una salida impresa y una salida MIDI, respectivamente. Se describen con todo detalle en el manual de Referencia de la notación, en partitura (notation)Disposición de la partitura sección ‘Disposición de la partitura’ en Referencia de la Notación y en (notation)Creación de salida MIDI sección ‘Creación de salida MIDI’ en Referencia de la Notación.

Podemos escribir varios bloques \score. Cada uno de ellos recibirá el mismo tratamiento que una partitura independiente, pero se combinarán todos juntos en un archivo de salida único. No se necesita ninguna instrucción \book, se creará una implícitamente. Sin embargo, si quiere archivos de salida separados a partir de un único archivo ‘.ly’, entonces es necesario utilizar la instrucción \book para separar las distintas secciones: cada bloque \book produce un archivo de salida distinto.

En resumen:

Cada bloque \book crea un archivo de salida distinto (por ejemplo, un archivo PDF). Si no hemos escrito uno de forma explícita, LilyPond envuelve todo nuestro código de entrada dentro de un bloque \book de forma implícita.

Cada bloque \score es un trozo de música separado dentro de un bloque \book.

Cada bloque \layout afecta al bloque \score o \book dentro del cual aparece (es decir, un bloque \layout dentro de un bloque \score afecta solamente a ese bloque \score, pero un bloque \layout fuera de un bloque \score (que por ello está dentro de un bloque \book, ya sea explícita o implícitamente) afecta a los bloques \score que están dentro de ese \book.

Para ver más detalles, consulte (notation)Varias partituras en un libro sección ‘Varias partituras en un libro’ en Referencia de la Notación.

Otro magnífico atajo es la posibilidad de definir variables como se muestra en Organizar las piezas mediante variables. Todas las plantillas emplean lo siguiente:

melodia = \relative {
  c'4 a b c
}

\score {
  \melodia
}

Cuando LilyPond examina este archivo, toma el valor de melodia (todo lo que está después del signo igual) y lo inserta dondequiera que ve \melodia. No se requiere un cuidado especial con el nombre (puede ser melodia, global, CompasArmadura, manoderechadelpiano o fulanomengano o cualquier otro). Recuerde que puede usar casi cualquier nombre que se le ocurra, en la medida en que contenga solamente caracteres alfabéticos y sea diferente de cualquiera de los nombres de instrucción de LilyPond. Para ver más detalles, consulte Ahorrar tecleo mediante variables y funciones. Las limitaciones exactas que afectan a los nombres de variable se detallan en (notation)Estructura del archivo sección ‘Estructura del archivo’ en Referencia de la Notación.

Véase también

Para ver una definición completa del formato del código de entrada, consulte (notation)Estructura del archivo sección ‘Estructura del archivo’ en Referencia de la Notación.

3.1.2 La partitura es una (única) expresión musical compuesta

@translationof Score is a (single) compound musical expression

En la sección anterior, Introducción a la estructura de los archivos de LilyPond, hemos podido ver la organización general de los archivos de entrada de LilyPond. Pero parece que nos saltamos la parte más importante: ¿cómo averiguamos qué escribir después de \score?

No nos hemos saltado nada en absoluto. El gran misterio es, sencillamente, que no hay ningún misterio. La siguiente línea lo explica todo:

Un bloque \score debe contener exactamente una expresión musical.

Para comprender lo que se entiende por expresión musical, quizá encuentre útil dar un repaso al tutorial, Explicación de las expresiones musicales. En esta sección vimos cómo elaborar grandes expresiones musicales a partir de pequeñas piezas (comenzábamos con notas, luego acordes, etc.). Ahora partiremos de una gran expresión musical y recorreremos el camino inverso hacia abajo. Por simplicidad, vamos a hacer sólo un cantante y un piano. No necesitamos un StaffGroup (que simplemente agrupa un cierto número de pautas con un corchete a la izquierda) para este conjunto, así que lo retiramos. Sin embargo, sí necesitamos pentagramas para un cantante y un piano.

\score {
  <<
    \new Staff = "cantante" <<
    >>
    \new PianoStaff = "piano" <<
    >>
  >>
  \layout { }
}

Aquí hemos asignado nombres a los pentagramas: “cantante” y “piano”. Esto no es esencial en este momento, pero es un hábito que resulta útil cultivar de manera que podamos saber de un vistazo para qué es cada pentagrama.

Recuerde que utilizamos << … >> en lugar de { … } para presentar la música simultánea. Esto hace que las partes vocal y del piano aparezcan una sobre la otra en la partitura. La construcción << … >> no sería necesaria para el pentagrama del cantante en el ejemplo de arriba si contiene solamente una expresión musical secuencial, pero se necesitarían los << … >> en lugar de las llaves si la música de ese pentagrama fuese a contener dos o más expresiones simultáneas, p.ej. dos voces simultáneas, o una voz con letra. Vamos a tener una voz con letra, por lo que se requieren los ángulos dobles. Después añadiremos algo de música real; por ahora limitémonos a poner unas cuantas notas y texto de relleno. Si ha olvidado cómo añadir la letra, puede releer la sección \addlyrics de Elaborar canciones sencillas.

\score { << \new Staff = "singer" << \new Voice = "vocal" { c'1 } \addlyrics { And } >> \new PianoStaff = "piano" << \new Staff = "upper" { c'1 } \new Staff = "lower" { c'1 } >> >> \layout { } }

Ahora tenemos muchos más detalles. Tenemos la pauta del cantante: contiene una Voice o voz (en LilyPond, este término hace referencia a un conjunto de notas, no necesariamente notas vocales – por ejemplo, un violín generalmente toca una voz –) y el texto de la canción. También tenemos una pauta de piano: contiene un pentagrama superior (mano derecha) y un pentagrama inferior (mano izquierda), aunque el pentagrama inferior aún no tiene la clave de Fa.

En este momento podríamos comenzar a meter las notas. Dentro de las llaves que siguen a \new Voice = "vocal", podríamos empezar escribiendo

\relative {
  r4 d''8\noBeam g, c4 r
}

Pero si lo hiciéramos, la sección \score se haría bastante larga y sería más difícil comprender lo que ocurre. En lugar de esto utilizaremos identificadores o variables. Recordará que las vimos por primera vez en la sección anterior.

Para asegurarnos de que el contenido de la variable text se interpreta como letra, lo precedemos por \lyricmode. Como \addlyrics, esto activa el modo de entrada de letra. Sin ello, LilyPond trataría de interpretar el contenido como notas, lo que generaría errores (Existen algunos otros modos, véase (notation)Modos de entrada sección ‘Modos de entrada’ en Referencia de la Notación).

Así pues, escribiendo algunas notas, y una clave de Fa para la mano izquierda, ahora tenemos un fragmento musical de verdad:

melody = \relative { r4 d''8\noBeam g, c4 r } text = \lyricmode { And God said, } upper = \relative { <g' d g,>2~ <g d g,> } lower = \relative { b,2 e } \score { << \new Staff = "singer" << \new Voice = "vocal" { \melody } \addlyrics { \text } >> \new PianoStaff = "piano" << \new Staff = "upper" { \upper } \new Staff = "lower" { \clef "bass" \lower } >> >> \layout { } }

Cuando escriba una sección \score o cuando la esté leyendo, hágalo despacio y con cuidado. Comience por el nivel exterior y luego trabaje sobre cada uno de los niveles interiores. También es de gran ayuda ser muy estricto con los márgenes (asegúrese de que en su editor de texto cada elemento del mismo nivel comienza en la misma posición horizontal).

Véase también

Referencia de la notación: (notation)Estructura de una partitura sección ‘Estructura de una partitura’ en Referencia de la Notación.

3.1.3 Anidado de expresiones musicales

@translationof Nesting music expressions

No es esencial declarar todos los pentagramas al comienzo; se pueden crear temporalmente en cualquier momento. Esto es de especial utilidad para crear secciones de ossia (véase (music-glossary)ossia sección ‘ossia’ en Glosario Musical). A continuación presentamos un ejemplo sencillo que muestra cómo introducir temporalmente un pentagrama nuevo mientras dura un fragmento de tres notas:

\new Staff { \relative { r4 g'8 g c4 c8 d | e4 r8 << { f8 c c } \new Staff { f8 f c } >> r4 | } }

Advierta que el tamaño de la clave es igual al que se imprime en un cambio de clave (ligeramente menor que la clave al principio de una línea). Esto es normal para cualquier clave que se imprime en la mitad de una línea.

La sección ossia se puede colocar encima del pentagrama de la manera siguiente:

\new Staff = "main" { \relative { r4 g'8 g c4 c8 d | e4 r8 << { f8 c c } \new Staff \with { alignAboveContext = "main" } { f8 f c } >> r4 | } }

Este ejemplo utiliza \with, que se explica en todo detalle más adelante. Es un medio de modificar el comportamiento predeterminado de un solo pentagrama. Aquí, dice que el pentagrama nuevo se debe colocar por encima del pentagrama llamado “main” en vez de la posición predeterminada que sería por debajo.

Véase también

Los fragmentos de ossia se escriben a menudo sin clave y sin indicación de compás, y generalmente en un tipo más pequeño. Esto necesitaría más instrucciones que aún no se han visto. Véase Tamaño de los objetos y (notation)Pentagramas de Ossia sección ‘Pentagramas de Ossia’ en Referencia de la Notación.

3.1.4 Estructura de un elemento de nota

@translationof Structure of a note entry

Un elemento de nota en LilyPond consiste en una altura seguida de una duración, y opcionalmente seguida de uno o más ‘post-eventos’. Los post-eventos de LilyPond añaden cosas como articulaciones, digitaciones, números de cuerda, ligaduras de unión y de expresión y textos explicativos.

La altura se puede definir explícitamente usando el lenguaje de entrada de LilyPond en su forma actual, como se describe en la sección (notation)Nombres de las notas en otros idiomas sección ‘Nombres de las notas en otros idiomas’ en Referencia de la Notación. La altura se puede omitir. En el caso de que la altura se omita, la altura de la nota será la misma que la de la nota anterior dentro del código de entrada, véase (notation)Duraciones sección ‘Duraciones’ en Referencia de la Notación. Observe que ni r ni s son alturas.

La duración consiste en un número y, opcionalmente, uno o más puntos ortográficos en el caso de las duraciones con puntillo. Si una duración no está definida explícitamente, la duración de la nota es la misma que la de la nota, acorde, silencio o silencio de separación anteriores, véase (notation)Duraciones sección ‘Duraciones’ en Referencia de la Notación.

Los post-eventos siguen a la nota a la que están adjuntos. Supongamos que queremos una nota Do corchea con una digitación de un 1, además de una articulación de tenuto, una ligadura de expresión que comienza en dicha nota, y una anotación textual. Esto puede obtenerse tal y como se muestra a continuación.

{ c'8-1--(~^\markup{"anotación textual"} c' d') }

Véase también

Manual de aprendizaje: Ligaduras de unión y de expresión, Articulaciones y matices dinámicos, Añadir texto.

Referencia de la notación: (notation)Alturas sección ‘Alturas’ en Referencia de la Notación, (notation)Duraciones sección ‘Duraciones’ en Referencia de la Notación, (notation)Expresiones sección ‘Expresiones’ en Referencia de la Notación.

3.1.5 Acerca de la no anidabilidad de llaves y ligaduras

@translationof On the un-nestedness of brackets and ties

En la escritura del archivo de entrada de LilyPond, hemos podido ver algunos tipos de paréntesis, llaves o ángulos de distintos tipos. Éstos obedecen a distintas reglas que al principio pueden resultar confusas. Antes de explicar estas reglas, demos un repaso a las distintas clases de corchetes, llaves y paréntesis.

A las anteriores, debemos añadir otras construcciones que generan líneas entre o a través de las notas: las ligaduras de unión (marcadas con una tilde curva, ~), los grupos especiales que se escriben como \tuplet x/y { … }, y las notas de adorno, que se escriben como \grace { … }.

Fuera de LilyPond, el uso convencional de los paréntesis y otros corchetes requiere que los distintos tipos se encuentren anidados correctamente, como en: << [ { ( … ) } ] >>, de manera que los paréntesis que se cierran deben encontrarse en el orden exactamente opuesto al de los paréntesis que se abren. Esto es un requisito para los tres tipos de paréntesis que se describen mediante la palabra ‘Encierra’ en la tabla anterior: se deben anidar correctamente. Sin embargo, el resto de las llaves y corchetes, que se encuentran descritos por la palabra ‘Marca’ en la misma tabla anterior, no tienen por qué anidarse estrictamente con ninguno de los otros paréntesis. De hecho, éstos no son paréntesis en el sentido de que encierran algo: simplemente son marcadores que indican dónde empieza o finaliza algo.

Así pues, por ejemplo, una ligadura de fraseo puede dar comienzo antes de una barra insertada manualmente, y acabar antes de que acabe la barra (algo que quizá no sea muy musical, pero es posible):

\relative { g'8\( a b[ c b\) a] g4 }

En general, los distintos tipos de corchete, y los implicados en grupos especiales, ligaduras de unión y notas de adorno, se pueden mezclar con total libertad. Este ejemplo muestra una barra que se extiende hacia el interior de un grupo de valoración especial (línea 1), una ligadura de expresión que se prolonga hasta el interior de un grupo especial (línea 2), una barra y una ligadura de expresión que se prolongan hasta el interior de un grupo especial, una ligadura de unión que atraviesa dos grupos especiales, y una ligadura de fraseo que sale del interior de un grupo especial (líneas 3 y 4).

\relative { r16[ g' \tuplet 3/2 { r16 e'8] } g,16( a \tuplet 3/2 { b16 d) e } g,8[( a \tuplet 3/2 { b8 d) e~] } | \tuplet 5/4 { e32\( a, b d e } a4.\) }

Este documento ha sido generado por gub el el 13 julio 2020 utilizando texi2html 1.82.

Otros idiomas: English, català, česky, deutsch, français, magyar, italiano, 日本語, nederlands.
Acerca de la selección automática del idioma.