LilyPond — Manual de aprendizaje

Apéndices

1. Installing

This gentle, step-by-step installation tutorial guides you through installing LilyPond and creating a first music score.

LilyPond input files are simple text files. You can use any raw text editor to edit a LilyPond file (not a rich text editor such as Microsoft Word), but there are several editors tailored specifically for LilyPond, making the editing process very comfortable. Because a choice has to be made, this tutorial uses Frescobaldi, which is the most popular among such editors right now. However, there are several other options available. For more information, see editing Easier editing.

Please choose the tutorial according to your needs. (If you don’t know what the “command line” is, you want the graphical setup!)

1.1 Graphical setup under GNU/Linux

These instructions work for the GNOME environment, for example on the default flavors of Ubuntu and Fedora. In other desktop environments, they can likely be adapted. For more minimal GNU/Linux distributions, véase Command line setup.

First, find the GNOME Software app.

In GNOME Software, search “Frescobaldi”.

Install Frescobaldi. Behind the scenes, this should also automatically install some version of LilyPond.

Open Frescobaldi. It starts on a new file with some pre-filled text that will be explained later.

After the \version line, enter a new line containing exactly this:

{ c' }

Now click on the LilyPond icon, or press Control-M. On the right, a simple score appears.

Congratulations, you have just created your first music sheet with LilyPond! If you’re satisfied now, you can skip the rest of this section. However, it may be that the version of LilyPond that was installed is not the same one as this documentation is for. If you want a different LilyPond version, you can register it in Frescobaldi, without losing the initial one. To do this, first download the archive from Download, and double-click to unpack it.

Move the unpacked folder out of your Downloads folder to the folder where you want to permanently store it. For example, put it in your home folder.

Now, in Frescobaldi, go the Preferences.

Select “LilyPond Preferences”, and click “Add” to register a new LilyPond version.

Click on the file explorer icon.

Navigate to the folder you just extracted, then inside this folder, to ‘bin’ and finally ‘lilypond’.

You’re done! You can click ‘OK’. You now have two versions of LilyPond installed.

Now turn to Tutorial to learn more about LilyPond’s syntax.

1.2 Graphical setup under Windows

Download LilyPond for Windows from Download. The file will a ZIP archive called ‘lilypond-x.y.z-mingw-x86_64.zip’ (where “mingw” means it’s for Windows). Extract this in the file explorer. Place the resulting directory lilypond-x.y.z-mingw-x86_64 in a permanent location; the actual folder doesn’t matter, you just need to put it somewhere you won’t move it afterwards. For example, you could choose your home folder.

After this, download the latest release of Frescobaldi from the project’s download page. Choose the ‘.exe’ file.

Double-click on the downloaded file in the file explorer. This launches the setup wizard.

Accept the license and install Frescobaldi using the wizard. You will find a startup screen like this:

Navigate to the Frescobaldi preferences.

Navigate to “LilyPond Preferences” on the left.

Click “Edit” on the right. This leads to a dialog for choosing the LilyPond executable.

Click on the folder icon and navigate to the lilypond-x.y.z-mingw-x86_64 folder you previously created. Inside this folder, open ‘lilypond-x.y.z’, then ‘bin’, and finally select ‘lilypond’.

Now click “OK”.

Click “OK” again.

Type this simple file in the window:

\version "2.23.82"

{ c' }

Compile it with Control-M or using the “LilyPond” icon. A minimal score appears.

Congratulations, you have just created your first music sheet with LilyPond! Now continue with the Tutorial to learn more about LilyPond’s syntax.

1.3 Graphical setup under macOS

Download LilyPond for macOS from Download. The file will be an archive called ‘lilypond-x.y.z-darwin-x86_64.tar.gz’ (where “darwin” means it’s for macOS). In the Finder, extract this archive. Place the resulting directory lilypond-x.y.z-darwin-x86_64 in a permanent location; the actual folder doesn’t matter, you just need to put it somewhere you won’t move it afterwards. For example, you could choose your home folder.

After this, download the latest release of Frescobaldi from the project’s download page. Choose the ‘.dmg’ file.

In the Finder, double-click on the file to run the installer. At this point, you might encounter a problem:

This is because Frescobaldi is developed independently from Apple. Nevertheless, it is totally secure software, but you have to tell Apple so. To do this, you first need to click “Cancel”. After having clicked “Cancel”, open the “System Preferences” app and select “Security & Privacy”.

Then click “Open Anyway”.

This leads to a new security warning. This time, you have the option to accept. Select “Open”. Again, do not fear: Frescobaldi is completely secure for your system.

Frescobaldi is now open. Find the Preferences.

Click on “LilyPond Preferences” on the left.

Click “Edit” on the right. This opens a new window:

Click on the ‘folder’ icon. A Finder window opens. Navigate to the ‘lilypond-x.y.z-darwin-x86_64’ folder you saved earlier. Inside it, find ‘lilypond-x.y.z’, then ‘bin’ and finally ‘lilypond’.

When you press “OK”, a new security warning about LilyPond will likely appear. Again, first click “Cancel”, then enable LilyPond in the preferences, and redo the procedure to select ‘lilypond’ in the Finder.

Now click “OK” to everything until you are back to the main Frescobaldi window. Enter this simple file in source view on the left:

\version "2.23.82"

{ c' }

Click on the button with the LilyPond icon to compile the file, or use the Control-M keyboard shortcut. For a third time, the system will warn you about security, this time with “gs” (GhostScript). Once more, go to the System Preferences to enable the program to be executed.

Finally, the next compilation run will work and you will find a minimal score.

Congratulations! You have compiled your first music sheet with LilyPond. Now continue with the Tutorial to learn more about LilyPond’s syntax.

1.4 Command line setup

On many GNU/Linux distributions, LilyPond can be installed from the package manager. This is also the case on macOS using either MacPorts or Homebrew.

In any case, you can install LilyPond by downloading the archive from Download and unpacking it. The binaries are usable immediately after unpacking. You can run

/.../lilypond-x.y.z/bin/lilypond file.ly

(on Windows, replace the slashes ‘/’ with backslashes ‘\’).

This compiles file.ly, and produces file.pdf. To test your setup, you can use this minimal file:

\version "2.23.82"

{ c' }

This will produce this output in ‘file.pdf’:

Now continue with the Tutorial to learn more about LilyPond’s syntax, or see Command-line usage for more information on calling LilyPond on the command line.

2. Tutorial

Este capítulo ofrece una introducción básica al trabajo con LilyPond.

2.1 Compilación del archivo

Esta sección presenta el concepto de “compilación”: el procesamiento de los documentos de entrada de LilyPond (escritos por uno mismo) para producir archivos de salida.

“Compilación” es una palabra que significa procesar un texto de entrada en formato de LilyPond para producir un archivo que se puede imprimir y (de manera opcional) un archivo MIDI que se puede reproducir. El primer ejemplo muestra el aspecto de un sencillo archivo de texto de entrada.

Este ejemplo muestra un archivo de entrada sencillo:

\version "2.23.82"
{
  c' e' g' e'
}

El resultado tiene este aspecto:

Además, la entrada de LilyPond es sensible a las mayúsculas. ‘ { c d e }’ es una entrada válida; ‘{ C D E }’ produce un mensaje de error.

2.2 Cómo escribir archivos de entrada

Esta sección presenta una parte de la sintaxis básica de LilyPond como ayuda para que se inicie en la escritura de archivos de entrada.

2.2.1 Notación sencilla

LilyPond añadirá ciertos elementos de notación de manera automática. En el siguiente ejemplo hemos especificado solamente cuatro alturas, pero LilyPond ha añadido la clave, el compás y las duraciones.

{
  c' e' g' e'
}

Este comportamiento se puede modificar, pero en general estos valores automáticos son adecuados.

Alturas

Glosario musical: pitch, interval, scale, middle C, octave, accidental.

LilyPond emplea letras minúsculas para las alturas. Los nombres de nota en todos los ejemplos de esta sección usan la nomenclatura holandesa, en que las teclas blancas del piano van desde la c (Do) hasta la b (Si). Sin embargo, LilyPond contempla muchos otros sistemas para los nombres de las notas, como el inglés o el ‘Do fijo’ (do-re-mi-...). Véase idiomas Nombres de las notas en otros idiomas. Las letras desde c hasta b denotan las alturas de las notas de la ‘octava corta’ por debajo del Do central. Los sufijos ' (apóstrofo) o , (coma) se añaden para indicar octavas más agudas o más graves. A continuación se muestra una escala que comienza en el Do central, y un arpegio:

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

La manera más sencilla de introducir las notas es mediante la utilización del modo \relative (relativo). En este modo, se elige la octava automáticamente bajo la suposición de que la siguiente nota se colocará siempre lo más cerca de la nota actual, es decir, se colocará en la octava comprendida dentro de hasta tres espacios de pentagrama a partir de la nota anterior. Comenzaremos por introducir el fragmento musical más elemental: una escala, donde cada nota está comprendida dentro de tan sólo un espacio de pentagrama desde la nota anterior.

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

La nota inicial, escrita como c', es el Do central. Cada nota sucesiva se coloca lo más cerca posible de la nota previa (en otras palabras: la primera ‘c’ es el Do más cercano al Do central; a éste le sigue el Re más cercano a la nota previa, y así sucesivamente). Podemos crear melodías con intervalos mayores, aún sin dejar de utilizar el modo relativo:

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

En el ejemplo anterior, la primera nota (d', con un apóstrofo) es el Re que está en la octava que va del Do central al Si por encima de él.

Añadiendo (o eliminando) comillas simples ' o comas , a la primera nota, podemos cambiar la octava de inicio:

\relative {
  e'' c a c
}

Al principio, el modo relativo puede resultar algo confuso, pero es la forma más sencilla de introducir la mayor parte de las melodías. Veamos cómo funciona en la práctica este cálculo relativo. Comenzando por Si, que está situado en la línea central en clave de Sol, podemos alcanzar Do, Re y Mi dentro de los tres espacios de pentagrama hacia arriba, y La, Sol y Fa dentro de los tres espacios hacia abajo. Por tanto, si la nota siguiente a Si es Do, Re o Mi se supondrá que está por encima del Si, mientras que La, Sol o Fa se entenderán situados por debajo.

\relative {
  b' c  % el Do está un espacio por encima, es el Do de arriba
  b d  % el Re está dos por encima ó 5 por debajo, es el Re de arriba
  b e  % el Mi está 3 por encima ó 4 por debajo, es el Mi de arriba
  b a  % el La está 6 por encima ó 1 por debajo, es el La de abajo
  b g  % el Sol está 5 por encima ó 2 por debajo, es el Sol de abajo
  b f  % el Fa está 4 por encima ó 3 por debajo, es el Fa de abajo
}

Lo mismo exactamente ocurre cuando cualquiera de esas notas llevan un sostenido o un bemol. Las Alteraciones accidentales se ignoran totalmente en el cálculo de la posición relativa. Exactamente la misma cuenta de espacios de pentagrama se hace a partir de una nota situada en cualquier otro lugar del mismo.

Para añadir intervalos mayores de tres espacios de pentagrama, podemos elevar la octava añadiendo una comilla simple ' (o apóstrofo) a continuación del nombre de la nota. También podemos bajar la octava escribiendo una coma , a continuación del nombre de la nota.

\relative {
  a' a, c' f,
  g g'' a,, f'
}

Para subir o bajar una nota en dos (¡o más!) octavas, utilizamos varias '' ó ,, (pero tenga cuidado de utilizar dos comillas simples '' ¡y no una comilla doble " !)

Duraciones (valores rítmicos)

Glosario musical: beam, duration, whole note, half note, quarter note, dotted note.

La duración de una nota se especifica mediante un número después del nombre de la nota: 1 significa redonda, 2 significa blanca, 4 significa negra y así sucesivamente. Las barras de corchea se añaden automáticamente.

Si no especifica una duración, se utiliza la duración previa para la nota siguiente. La figura por omisión de la primera nota es una negra.

\relative {
  a'1
  a2 a4 a8 a
  a16 a a a a32 a a a a64 a a a a a a a a2
}

Para crear notas con puntillo, añada un punto . al número de la duración. La duración de una nota con puntillo se debe especificar de forma explícita (es decir: mediante un número).

\relative {
  a'4 a a4. a8
  a8. a16 a a8. a8 a4.
}

Silencios

Glosario musical: rest.

Un silencio se introduce igual que si fuera una nota con el nombre r :

\relative {
  a'4 r r2
  r8 a r4 r4. r8
}

Indicación de compás

Glosario musical: time signature.

La indicación de compás se puede establecer con la orden \time :

\relative {
  \time 3/4
  a'4 a a
  \time 6/8
  a4. a
  \time 4/4
  a4 a a a
}

Indicaciones de tempo

Glosario musical: tempo indication, metronome.

La indicación de tempo y la indicación metronómica pueden establecerse con la instrucción \tempo:

\relative {
  \time 3/4
  \tempo "Andante"
  a'4 a a
  \time 6/8
  \tempo 4. = 96
  a4. a
  \time 4/4
  \tempo  "Presto" 4 = 120
  a4 a a a
}

Clave

Glosario musical: clef.

La clave se puede establecer utilizando la orden \clef :

\relative {
  \clef "treble"
  c'1
  \clef "alto"
  c1
  \clef "tenor"
  c1
  \clef "bass"
  c1
}

Todo junto

He aquí un pequeño ejemplo que muestra todos los elementos anteriores juntos:

\relative {
  \clef "bass"
  \time 3/4
  \tempo "Andante" 4 = 120
  c,2 e8 c'
  g'2.
  f4 e d
  c4 c, r
}

Véase también

Referencia de la notación: Escritura de notas, Escritura de las duraciones (valores rítmicos), Escritura de silencios, Indicación de compás, Clave.

2.2.2 Trabajar sobre los archivos de entrada

Los archivos de entrada de LilyPond son como los archivos fuente de muchos lenguajes de programación corrientes. Contienen un enunciado de versión, son sensibles a las mayúsculas y generalmente los espacios se ignoran. Las expresiones se forman con llaves { } y los comentarios se denotan por un signo de porcentaje (%) o por %{ … %} .

Si la frase anterior no tiene sentido para usted ¡no se preocupe! A continuación explicaremos el significado de todos estos términos:

• Enunciado de la versión: Todo archivo de LilyPond debe contener un enunciado de versión. Un enunciado de versión es una línea que describe la versión de LilyPond para la que se escribió este archivo, como en el ejemplo siguiente:

  \version "2.23.82"
  

  Por convenio, el enunciado de versión se coloca al principio del archivo de LilyPond.

  El enunciado de versión es importante por dos motivos como mínimo. En primer lugar, permite la actualización automática del código de entrada conforme se va modificando la sintaxis de LilyPond. En segundo lugar, indica la versión de LilyPond que se necesita para compilar el archivo.

  Si no se escribe ningún enunciado de versión en el archivo de entrada, LilyPond imprime una advertencia durante la compilación del mismo.

• Sensible a las mayúsculas: tiene importancia el hecho de que introduzca una letra en minúsculas (p.ej. a, b, s, t) o en mayúsculas (p.ej. A, B, S, T). Las notas son minúsculas: ‘{ c d e }’ es una entrada válida; ‘{ C D E }’ produciría un mensaje de error.
• Insensible al número de espacios: no importa cuántos espacios (o saltos de línea o de tabulación) añada. ‘{ c4 d e }’ significa lo mismo que ‘{ c4       d e }’ y que

  { c4                       d
                     e   }
  

  Por supuesto, el ejemplo anterior es difícil de leer. Una regla práctica es sangrar los bloques de código con un carácter de tabulación, o bien con dos espacios:

  {
    c4 d e
  }
  

  Sin embargo, sí se necesitan espacios para separar muchos elementos sintácticos unos de otros. En otras palabras, los espacios se pueden siempre añadir, pero no siempre eliminar. Dado que la falta de espacios puede dar lugar a extraños errores, recomendamos insertar espacios siempre antes y después de cualquier elemento sintáctico, por ejemplo, antes y después de las llaves.

• Expresiones: Todo fragmento de código de entrada para LilyPond ha de llevar { llaves } antes y después de la entrada. Estas llaves le dicen a LilyPond que la entrada es una expresión musical unitaria, igual que los paréntesis ‘()’ de las matemáticas. Las llaves deben ir rodeadas de un espacio a no ser que se encuentren al comienzo o al final de una línea, para evitar cualquier ambigüedad.

  Una instrucción de LilyPond seguida de una expresión simple entre llaves (como por ejemplo ‘relative { … }’) también es una expresión musical unitaria.

• Comentarios: Un comentario es una nota para el lector humano de la entrada musical; se ignora cuando esta entrada se analiza, de manera que no tiene ningún efecto sobre la salida impresa. Existen dos tipos de comentarios. El símbolo de porcentaje ‘%’ introduce un comentario de línea; todo lo que se encuentra después de ‘%’ en esa línea se ignora. Por convenio, una línea de comentario se coloca por encima del código a que se refiere el comentario.

  a4 a a a
  % este comentario se refiere a las notas Si
  b2 b
  

  Un comentario de bloque marca una sección entera de entrada musical como comentario. Todo lo que está encerrado dentro de %{ y %} se ignora (pero los comentarios no pueden anidarse, lo que significa que un comentario de bloque no puede incluir otros comentarios de bloque). Si lo hiciera, el primer %} daría por terminado los dos comentarios de bloque. El siguiente fragmento muestra algunos posibles usos para los comentarios:

  % a continuación van las notas de campanitas del lugar
    c4 c g' g a a g2
  
  %{
    Esta línea y las notas que aparecen más abajo
    se ignoran, por estar dentro de un
    comentario de bloque.
  
    f4 f e e d d c2
  %}
  

2.3 Tratar con los errores

A veces, LilyPond no produce el resultado esperado. Esta sección aporta algunos enlaces para ayudarle a resolver los problemas que pudiera encontrar.

2.3.1 Consejos generales de solución de problemas

La solución de problemas en LilyPond puede ser un desafío para las personas acostumbradas a los interfaces gráficos, porque es posible crear archivos de entrada inválidos. Cuando esto ocurre, la mejor forma de identificar y resolver el problema es aplicar un enfoque lógico. Se dan algunas guías para ayudarle a aprender a hacerlo, en Solución de problemas.

2.3.2 Algunos errores comunes

Existen algunos errores comunes que son difíciles de solucionar si nos basamos solamente en los mensajes de error que se nos presentan. Éstos se describen en Errores comunes.

2.4 Cómo leer los manuales

Esta sección muestra cómo leer la documentación de forma eficiente, y presenta algunas interesantes funcionalidades interactivas de la versión en línea.

2.4.1 Material omitido

Como ya vimos en Trabajar sobre los archivos de entrada, el código de entrada de LilyPond debe estar rodeado de llaves { } o de ‘relative { … }’. Durante el resto del presente manual, ciertos ejemplos breves omitirán las llaves. Para reproducir estos ejemplos puede copiar la entrada que se muestra, pero debe pegarla entre { y } dentro del archivo de entrada.

{
  …aquí va el ejemplo…
}

Asimismo, recuerde que todo archivo de LilyPond debe llevar un enunciado \version. Dado que los ejemplos de los manuales son fragmentos de código y no archivos completos, el enunciado \version se omite. De todas formas, debemos acostumbrarnos a incluirlo en nuestros documentos.

2.4.2 Ejemplos con enlace

Muchas personas aprenden a utilizar programas probando y enredando con ellos. Esto también puede hacerse con LilyPond. Si hace clic sobre una imagen en la versión en HTML de este manual, podrá ver la entrada exacta de LilyPond que se utilizó para generar esa imagen. Pruébelo sobre esta imagen:

Cortando y pegando todo lo que se encuentra dentro de la sección “ly snippet” (fragmento de tipo ly), tendrá una plantilla inicial para sus experimentos. Para poder ver exactamente el mismo resultado (con igual anchura de línea y todo), copie todo lo que está desde “Start cut-&-pastable section” hasta el final del archivo.

2.4.3 Panorámica de los manuales

Existe abundantísima documentación sobre LilyPond. Con frecuencia, los nuevos usuarios se encuentran desorientados respecto a qué parte o partes deben leer, y ocasionalmente pasan por alto la lectura de partes de importancia vital.

• Antes de intentar hacer cualquier cosa: lea el Tutorial del manual de Aprendizaje, y la sección Notación corriente. Si encuentra términos musicales que no reconoce, búsquelos en el Glosario.
• Antes de tratar de escribir una pieza completa de música: lea la sección Conceptos fundamentales del manual de Aprendizaje. Después, le vendrá bien consultar las secciones correspondientes de la Referencia de la notación.
• Antes de tratar de modificar los resultados predeterminados: lea la sección Trucar la salida del manual de Aprendizaje.
• Antes de afrontar un proyecto grande: lea la sección Sugerencias para escribir archivos de entrada de LilyPond del manual de Utilización del programa.

3. Notación corriente

Este capítulo explica cómo crear hermosas partituras que contengan notación musical común, como continuación al material que está en el Tutorial.

3.1 Notación en un solo pentagrama

Esta sección presenta la notación común que se utiliza para música a una voz sobre un pentagrama único.

3.1.1 Líneas divisorias y comprobaciones de compás

Líneas divisorias

Las líneas de compás sencillas se dibujan automáticamente en la música, por lo que no hay que añadirlas de forma manual. Otros tipos de barras de compás se añaden usando \bar, por ejemplo \bar "||" para una doble barra, o \bar "|." para la doble barra final. Para ver una lista completa de las líneas divisorias, consulte Barras de compás.

\relative { g'1 e1 \bar "||" c2. c'4 \bar "|." }

Comprobaciones de compás

Aunque no es estrictamente necesario, es conveniente utilizar comprobaciones de compás dentro del código de entrada para indicar dónde se supone que van las líneas divisorias. Se introducen mediante el carácter de barra vertical, | (AltGr - 1 en el teclado español). Con las comprobaciones de compás, el programa puede verificar que hemos introducido las duraciones que completan los compases correctamente. Las comprobaciones de compás también hacen que el código de entrada sea más fácil de leer, porque ayudan a organizar el material.

\relative {
  g'1 | e1 | c2. c' | g4 c g e | c4 r r2 |
}

Si compila el código del ejemplo anterior, verá una advertencia en la salida de la consola:

advertencia: la comprobación de compás ha fallado en: 1/2
 g'1 | e1 | c2. c'
                   | g4 c g e | c4 r r2 |

Aunque la duración que falta está clara en la salida musical de este ejemplo sencillo, la advertencia de la salida de consola es mucho más efectiva al atraer la atención concretamente al 4 que falta en el compás 3.

Véase también

Referencia de la notación: Comprobación de compás y de número de compás.

3.1.2 Alturas y armaduras

Alteraciones accidentales

Glosario musical: sharp, flat, double sharp, double flat, accidental.

En LilyPond, los nombres de las notas identifican alturas. Por ejemplo, c siempre significa Do natural, cualquiera que sea la armadura.

En muchos idiomas, el nombre de una nota consiste en un nombre base que se refiere a los escalones diatónicos de la escala de Do mayor / la menor, p.ej. d, y un sufijo, que indica la alteración de esta altura básica. El idioma predeterminado para los nombres de nota es el holandés (Dutch). Una nota con sostenido se hace añadiendo is al nombre, y una nota bemol añadiendo es. Como ha podido adivinar, un doble sostenido o doble bemol se hace añadiendo isis o eses. Esta sintaxis se deriva de las convenciones de nomenclatura de las notas en las lenguas nórdicas y germánicas como el alemán y el holandés. Para utilizar otras nomenclaturas para las notas, véase idiomas Nombres de las notas en otros idiomas.

\relative { cis''4 ees fisis, aeses }

Armaduras

Glosario musical: key signature, major, minor.

La armadura de la tonalidad se establece mediante la instrucción \key seguido de una nota y \major o \minor.

\relative {
  \key d \major
  d'4 fis a c |
  \bar "||" \key c \minor
  c,4 ees g b |
}

Advertencia: armaduras y alturas

Glosario musical: accidental, key signature, pitch, flat, natural, sharp, transposition, Pitch names.

LilyPond distingue entre el contenido musical y su representación impresa. Una entrada como d4 e fis2 define las alturas y duraciones de las notas, lo que es el contenido musical. La armadura forma parte de la representación impresa. La armadura también establece reglas para las representaciones impresas de las notas. LilyPond compara la altura de cada nota de la entrada con la armadura para determinar si imprimir, o no, una alteración accidental.

La instrucción \key fija la armadura, que afecta a la representación impresa, pero no modifica la altura asignada a una nota cualquiera como c a partir de la entrada.

En el siguiente ejemplo:

\relative {
  \key d \major
  cis''4 d e fis
}

Ninguna nota lleva una alteración impresa, pero de todas formas usted debe escribir el is a cis y a fis en el archivo de entrada.

El texto b no significa “imprimir una bolita negra en la tercera línea del pentagrama.” Más bien significa: “hay una nota Si natural.” En la tonalidad de La bemol mayor, lleva una alteración accidental:

\relative {
  \key aes \major
  aes'4 c b c
}

Cada vez que escriba una nota correspondiente a una tecla negra del piano, tiene que añadir -is ó -es al nombre de la nota

Poner todas las alteraciones de forma explícita puede que requiera algo más de trabajo al teclear, pero la ventaja es que la transposición es más fácil, y las alteraciones se pueden imprimir siguiendo varias convenciones distintas. Consulte Alteraciones accidentales automáticas para ver ejemplos de cómo se pueden imprimir las alteraciones de acuerdo a reglas diferentes.

Véase también

Referencia de la notación: Nombres de las notas en otros idiomas, Alteraciones accidentales, Alteraciones accidentales automáticas, Armadura de la tonalidad.

3.1.3 Ligaduras de unión y de expresión

Ligaduras de unión

Glosario musical: tie.

Una ligadura de unión se crea adjuntando un carácter de tilde curva ~ a la primera de las dos notas ligadas:

\relative { g'4~ g c2~ | c4~ c8 a~ a2 | }

Cuando la altura no cambia, como es el caso cada vez que hay una ligadura de unión, las alturas que siguen se pueden omitir, y especificar tan solo las duraciones:

\relative { g'4~ 4 c2~ | 4~ 8 a~ 2 | }

Esta abreviatura puede ser de utilidad en otros lugares donde las duraciones cambian pero la altura se mantiene fija; sin embargo, recuerde que una altura aislada seguida de un espacio y de una duración aislada se interpreta como una sola nota. En otras palabras, c4 a 8 8 se interpreta como c4 a8 a8, no como c4 a4 a8 a8. En vez de ello, escriba c4 a4 8 8 .

Ligaduras de expresión

Glosario musical: slur.

Una ligadura de expresión es una curva que se traza abarcando varias notas. Las notas inicial y final se marcan mediante ( y ) respectivamente. Observe que el paréntesis de apertura ( se escribe después de la primera nota de la ligadura.

\relative { d''4( c16) cis( d e c cis d) e( d4) }

Ligaduras de fraseo

Glosario musical: slur, phrasing.

Las ligaduras que se utilizan para indicar fraseos más largos se pueden introducir mediante \( y \). Puede haber al mismo tiempo ligaduras de legato y ligaduras de fraseo.

\relative { g'4\( g8( a) b( c) b4\) }

Advertencias: ligaduras de expresión frente a ligaduras de unión

Glosario musical: articulation, slur, tie.

Una ligadura de expresión parece una ligadura de unión, pero tiene un significado distinto. Una ligadura (de unión) sencillamente hace que la primera nota sea más larga, y sólo se puede utilizar sobre parejas de notas iguales. Las ligaduras de expresión indican la articulación de las notas, y se pueden utilizar sobre grupos mayores de notas. Las ligaduras de unión y de expresión se pueden anidar unas dentro de otras.

\relative { c''4(~ c8 d~ 4 e) }

Véase también

Referencia de la notación: Ligaduras de unión, Ligaduras de expresión, Ligaduras de fraseo.

3.1.4 Articulaciones y matices dinámicos

Las articulaciones y los matices dinámicos se indican escribiendo ciertos símbolos después de las notas a las que aquellos se aplican.

Articulaciones

Glosario musical: articulation.

Las articulaciones más corrientes se pueden añadir a las notas utilizando un guión - seguido de un carácter único:

\relative {
  c''4-^ c-+ c-- c-!
  c4-> c-. c2-_
}

Indicaciones de digitación

Glosario musical: fingering.

De manera similar, las digitaciones se pueden añadir a una nota utilizando un guión (-) seguido del dígito deseado:

\relative { c''4-3 e-5 b-2 a-1 }

Las articulaciones y digitaciones normalmente se colocan de forma automática, pero puede especificar una dirección mediante ^ (encima) o _ (debajo). También puede usar varias articulaciones sobre la misma nota. Sin embargo, casi siempre es mejor dejar que LilyPond determine la dirección de las articulaciones.

\relative { c''4_-^1 d^. f^4_2-> e^-_+ }

Matices dinámicos

Glosario musical: dynamics, crescendo, decrescendo.

Las expresiones de matiz o signos dinámicos se hacen añadiendo las marcas (con una barra invertida) a la nota:

\relative { c''4\ff c\mf c\p c\pp }

Los crescendi y decrescendi comienzan con las órdenes \< y \>. La siguiente indicación de matiz, como por ejemplo \f, dará por terminado el (de)crescendo, o bien se puede usar la instrucción \!:

\relative { c''4\< c\ff\> c c\! }

Véase también

Referencia de la notación: Articulaciones y ornamentos, Indicaciones de digitación, Matices dinámicos.

3.1.5 Añadir texto

Es posible añadir texto a la partitura:

c''2^"espr" a'_"legato"

Se puede aplicar un formateo adicional mediante la instrucción \markup:

c''2^\markup { \bold espr }
a'2_\markup {
  \dynamic f \italic \small { 2nd } \hspace #0.1 \dynamic p
}

Véase también

Referencia de la notación: Escritura del texto.

3.1.6 Barras automáticas y manuales

Glosario musical: beam.

Todas las barras de las figuras se dibujan automáticamente:

\relative { a'8 ais d ees r d c16 b a8 }

Si no le gustan las barras automáticas, pueden forzarse manualmente. Marque la primera nota que comprende la barra con [ y la última con ]. Observe que el corchete de apertura [ se escribe después de la primera nota que está unida por la barra.

\relative { a'8[ ais] d[ ees r d] c16 b a8 }

Si quiere desactivar completamente el barrado automático o para una sección extensa de música, utilice la instrucción \autoBeamOff para apagarlo y \autoBeamOn para activarlo de nuevo.

\relative {
  \autoBeamOff
  a'8 c b4 d8. c16 b4 |
  \autoBeamOn
  a8 c b4 d8. c16 b4 |
}

Véase también

Referencia de la notación: Barras automáticas, Barras manuales.

3.1.7 Instrucciones rítmicas avanzadas

Compás parcial

Glosario musical: anacrusis.

Una anacrusa se introduce con la palabra clave \partial. Va seguida de una duración: \partial 4 es una anacrusa de negra y \partial 8 de corchea.

\relative {
  \partial 8 f''8 |
  c2 d |
}

Grupos especiales

Glosario musical: note value, triplet.

Los grupos especiales como los tresillos se hacen con la palabra clave \tuplet. Requiere dos argumentos: una fracción y un fragmento de música. La fracción es el número de notas del grupo partido por el número de notas que normalmente ocupan la misma duración. Para los tresillos hay tres notas en el espacio de dos, de manera que los tresillos tienen una fracción de 3/2.

\relative {
  \tuplet 3/2 { f''8 g a }
  \tuplet 3/2 { c8 r c }
  \tuplet 3/2 { f,8 g16[ a g a] }
  \tuplet 3/2 { d4 a8 }
}

Notas de adorno

Glosario musical: grace notes, acciaccatura, appoggiatura.

Las notas de adorno se crean con la instrucción \grace, aunque también se pueden conseguir precediendo una expresión musical por la palabra clave \appoggiatura o \acciaccatura

\relative {
  c''2 \grace { a32 b } c2 |
  c2 \appoggiatura b16 c2 |
  c2 \acciaccatura b16 c2 |
}

Véase también

Referencia de la notación: Notas de adorno, Grupos especiales, Anacrusas.

3.2 Varias notas a la vez

Esta sección es una introducción a las notas simultáneas: varios instrumentos, varios pentagramas para un solo instrumento (p.ej. piano) y acordes.

La palabra “polifonía” en música hace referencia al hecho de tener más de una voz en un momento determinado dentro de una pieza musical. La palabra “polifonía” en LilyPond se refiere al hecho de tener más de una voz en el mismo pentagrama.

3.2.1 Explicación de las expresiones musicales

En los archivos de entrada de LilyPond, la música se representa mediante expresiones musicales. Una sola nota es una expresión musical:

a'4

Al encerrar un grupo de notas dentro de llaves creamos una expresión musical compuesta. Aquí hemos creado una expresión musical compuesta con dos notas:

\relative { a'4 g4 }

Si colocamos un grupo de expresiones musicales (p.ej.: notas) dentro de llaves, eso significa que se encuentran en secuencia (es decir, cada una sigue a la anterior). El resultado es otra expresión musical:

\relative { { a'4 g } f4 g }

Analogía: expresiones matemáticas

Este mecanismo es semejante a las fórmulas matemáticas: una fórmula grande se construye combinando fórmulas pequeñas. Dichas fórmulas se llaman expresiones, y su definición es recursiva de tal forma que se pueden construir expresiones de un tamaño y complejidad arbitrarios. Por ejemplo:

1

1 + 2

(1 + 2) * 3

((1 + 2) * 3) / (4 * 5)

Ésta es una secuencia de expresiones donde cada expresión se encuentra contenida dentro de la siguiente, más grande. Las expresiones más simples son números, y las mayores se hacen combinando expresiones mediante operadores (como +, * y /) y paréntesis. Del mismo modo que las expresiones matemáticas, las expresiones musicales se pueden anidar a una profundidad arbitraria, lo que se hace necesario para músicas complejas como las partituras polifónicas.

Expresiones musicales simultáneas: varios pentagramas

Glosario musical: polyphony.

Esta técnica es muy útil para la música polifónica. Para introducir música con más voces o con más pentagramas, lo que hacemos es combinar varias expresiones en paralelo. Para indicar que dos voces se deben interpretar al mismo tiempo, sencillamente introduzca una combinación simultánea de expresiones musicales. Una expresión musical ‘simultánea’ se forma encerrando las expresiones dentro de << y >>. En el ejemplo que sigue, tres secuencias (cada una de las cuales contiene dos notas diferentes) se combinan de forma simultánea:

<<
  \relative { a'2 g }
  \relative { f'2 e }
  \relative { d'2 b }
>>

Tenga en cuenta que hemos sangrado cada nivel jerárquico de la entrada con un margen distinto. A LilyPond no le importa cuánto (o cuán poco) espacio haya al comienzo de una línea, pero el establecimiento de márgenes distintos dentro del código de LilyPond, de esta forma, lo hace mucho más fácil de leer por nosotros los seres humanos.

Expresiones musicales simultáneas: un solo pentagrama

Para determinar el número de pentagramas en una pieza, LilyPond examina el comienzo de la primera expresión. Si hay una sola nota, hay un solo pentagrama; si hay una expresión simultánea, hay más de un pentagrama. El siguiente ejemplo presenta una expresión compleja, pero dado que comienza con una sola nota, se dispone sobre un solo pentagrama.

\relative {
  c''2 <<c e>> |
  << { e2 f } { c2 <<b d>> } >> |
}

3.2.2 Varios pentagramas

Como ya hemos visto en Explicación de las expresiones musicales, los archivos de entrada para LilyPond se construyen a base de expresiones musicales. Si la partitura comienza con expresiones musicales simultáneas, LilyPond crea varios pentagramas. Sin embargo es más fácil ver lo que ocurre si creamos cada uno de los pentagramas de forma explícita.

Para imprimir más de un pentagrama, cada fragmento de música que constituye un pentagrama se marca escribiendo \new Staff antes de él. Estos elementos Staff se combinan después en paralelo con << y >>:

<<
  \new Staff { \clef "treble" c''4 }
  \new Staff { \clef "bass" c4 }
>>

La instrucción \new inaugura un ‘contexto de notación’. Un contexto de notación es un entorno dentro del que se interpretan los acontecimientos musicales (como las notas o las instrucciones \clef). Para piezas sencillas, tales contextos de notación se crean automáticamente. Para piezas más complicadas, es mejor marcar los contextos de forma explícita.

Existen varias clases de contextos. Score, Staff y Voice manejan la notación melódica, mientras que Lyrics se ocupa de los textos cantados y ChordNames imprime los nombres de los acordes.

En términos de sintaxis, la anteposición de \new a una expresión musical crea una expresión musical mayor. Es semejante al signo menos de las matemáticas. La fórmula (4+5) es una expresión, por tanto -(4+5) es una expresión más amplia.

Las indicaciones de compás escritas en un pentagrama afectan al resto de ellos, de forma predeterminada. En cambio, la armadura de la tonalidad de un pentagrama no afecta a los otros pentagramas. Este comportamiento predeterminado diferente es a causa de que las partituras con instrumentos transpositores son más comunes que las partituras polirrítmicas.

<<
  \new Staff { \clef "treble" \key d \major \time 3/4 c''4 }
  \new Staff { \clef "bass" c4 }
>>

3.2.3 Grupos de pentagramas

Glosario musical: brace, staff, system.

La música para piano se compone tipográficamente en forma de dos pentagramas unidos mediante una llave. El aspecto impreso de este sistema de pentagramas se parece al ejemplo polifónico que aparece en Varios pentagramas, pero en esta ocasión la expresión completa se coloca dentro de un PianoStaff:

\new PianoStaff <<
  \new Staff …
  \new Staff …
>>

He aquí un pequeño ejemplo:

\new PianoStaff <<
  \new Staff \relative { \time 2/4 c''4 e | g g, | }
  \new Staff \relative { \clef "bass" c4 c' | e c | }
>>

Otros grupos de pentagramas se declaran mediante \new GrandStaff, que es apropiado para partituras orquestales, y \new ChoirStaff, que es apropiado para partituras vocales. Cada uno de estos grupos de pautas forma un tipo de contexto distinto, que produce la llave a la izquierda y que también controla el alcance de las líneas divisorias.

Véase también

Referencia de la notación: Teclados y otros instrumentos de varios pentagramas, Impresión de los pentagramas.

3.2.4 Combinar notas para formar acordes

Glosario musical: chord.

Hemos visto con anterioridad cómo se pueden combinar las notas formando acordes que indican que son simultáneas, encerrándolas entre dobles ángulos. Sin embargo, la forma normal de indicar un acorde es encerrar las notas entre ángulos sencillos. Observe que todas las notas de un acorde deben tener la misma duración, y que la duración se escribe después del ángulo de cierre.

\relative { r4 <c'' e g> <c f a>2 }

Debemos pensar en los acordes como algo casi equivalente a las notas sencillas: casi todo lo que se puede adjuntar a una nota se puede adjuntar también a un acorde, y todo debe ir por fuera de los ángulos. Por ejemplo, puede combinar marcas como barras y ligaduras, con acordes. Tan sólo debe recordar que se escriben por fuera de los ángulos.

\relative {
  r4 <c'' e g>~ <c f a>2 |
  <c e g>8[ <c f a> <c e g> <c f a>]
    <c e g>8\>[ <c f a> <c f a> <c e g>]\! |
  r4 <c e g>8.\p <c f a>16( <c e g>4-. <c f a>) |
}

Véase también

Referencia de la notación: Notas en acorde.

3.2.5 Polifonía en un solo pentagrama

La música polifónica en LilyPond, aunque no es difícil, utiliza conceptos que aún no hemos tratado, por lo que no vamos a presentarlos en este momento. En su lugar, las secciones siguientes presentan estos conceptos y los explican en profundidad.

Véase también

Manual de aprendizaje: Las voces contienen música.

Referencia de la notación: Notas simultáneas.

3.3 Canciones

En esta sección presentamos cómo elaborar música vocal y hojas de canción sencillas.

3.3.1 Elaborar canciones sencillas

Glosario musical: lyrics.

Presentamos a continuación el inicio de la melodía de una canción infantil, “Girls and boys come out to play”:

\relative {
  \key g \major
  \time 6/8
  d''4 b8 c4 a8 | d4 b8 g4
}

La letra se puede asignar a esas notas, combinando ambas con la palabra clave \addlyrics. La letra se escribe separando cada sílaba mediante un espacio.

<<
  \relative {
    \key g \major
    \time 6/8
    d''4 b8 c4 a8 | d4 b8 g4
  }
  \addlyrics {
    Girls and boys come out to play,
  }
>>

Observe los ángulos dobles <<…>> alrededor del fragmento entero para expresar que la música y la letra han de suceder al mismo tiempo.

3.3.2 Alineación de la letra a una melodía

Glosario musical: melisma, extender line.

La siguiente línea de la canción infantil es The moon doth shine as bright as day. A continuación vamos a ampliarla:

<<
  \relative {
    \key g \major
    \time 6/8
    d''4 b8 c4 a8 | d4 b8 g4 g8 |
    a4 b8 c b a | d4 b8 g4. |
  }
  \addlyrics {
    Girls and boys come out to play,
    The moon doth shine as bright as day;
  }
>>

Si miramos la música, podemos observar que la letra adicional no se alinea correctamente con las notas. La palabra ‘shine’ se debe cantar sobre dos notas, no una. Esto se conoce como melisma, una sílaba única que se canta sobre más de una nota. Existen varias formas de hacer que una sílaba recaiga sobre varias notas, siendo la más sencilla escribir una ligadura de expresión sobre ellas (véase Ligaduras de unión y de expresión):

<<
  \relative {
    \key g \major
    \time 6/8
    d''4 b8 c4 a8 | d4 b8 g4 g8 |
    a4 b8 c( b) a | d4 b8 g4. |
  }
  \addlyrics {
    Girls and boys come out to play,
    The moon doth shine as bright as day;
  }
>>

Ahora la letra se alinea correctamente con las notas, pero el barrado automático de las notas que corresponden a shine as no parece correcto. Podemos remediarlo insertando instrucciones de barrado manual para sobreescribir el barrado automático; para ver más detalles consulte Barras automáticas y manuales.

<<
  \relative {
    \key g \major
    \time 6/8
    d''4 b8 c4 a8 | d4 b8 g4 g8 |
    a4 b8 c([ b]) a | d4 b8 g4. |
  }
  \addlyrics {
    Girls and boys come out to play,
    The moon doth shine as bright as day;
  }
>>

Como alternativa a la utilización de ligaduras de expresión, los melismas se pueden indicar solamente en la letra utilizando un guión bajo, _, para cada nota que queremos incluir dentro del melisma:

<<
  \relative {
    \key g \major
    \time 6/8
    d''4 b8 c4 a8 | d4 b8 g4 g8 |
    a4 b8 c[ b] a | d4 b8 g4. |
  }
  \addlyrics {
    Girls and boys come out to play,
    The moon doth shine _ as bright as day;
  }
>>

Si una sílaba se extiende sobre varias notas o una sola nota muy larga, normalmente se traza una línea extensora desde la sílaba que se extiende y por debajo de todas las notas que corresponden a dicha sílaba. Se escribe como dos guiones bajos __. He aquí un ejemplo extraído de los primeros tres compases del Lamento de Dido, de Dido y Eneas de Purcell:

<<
  \relative {
    \key g \minor
    \time 3/2
    g'2 a bes | bes2( a) b2 |
    c4.( bes8 a4. g8 fis4.) g8 | fis1
  }
  \addlyrics {
    When I am laid,
    am laid __ in earth,
  }
>>

Hasta el momento, ninguno de los ejemplos implicaban palabras que tuviesen más de una sílaba. Estas palabras se reparten por lo general a razón de una nota por cada sílaba, con guiones cortos entre las sílabas. Dichos guiones separadores se teclean como dos guiones, con el resultado de un guión corto centrado entre las sílabas. Presentamos a continuación un ejemplo que demuestra esto y todo lo que hemos aprendido hasta el momento acerca de la alineación de la letra a las notas.

<<
  \relative {
    \key g \major
    \time 3/4
    \partial 4
    d'4 | g4 g a8( b) | g4 g b8( c) |
    d4 d e | c2
  }
  \addlyrics {
    A -- way in a __ man -- ger,
    no __ crib for a bed,
  }
>>

Algunos textos (especialmente los que están en italiano o en español) requieren lo contrario: colocar más de una sílaba a una única nota. Esto se consigue enlazando las sílabas entre sí mediante un guión bajo simple _ (sin ningún espacio), o bien encerrándolas entre corchetes. Aquí aparece un ejemplo procedente del Barbero de Sevilla de Rossini, donde la sílaba al se canta sobre la misma nota que la sílaba go de la palabra ‘Largo’ en el aria de Fígaro Largo al factotum:

<<
  \relative {
    \clef "bass"
    \key c \major
    \time 6/8
    c'4.~ 8 d b | c8([ d]) b c d b | c8
  }
  \addlyrics {
    Lar -- go_al fac -- to -- tum del -- la cit -- tà
  }
>>

Véase también

Referencia de la notación: Música vocal.

3.3.3 Letra en varios pentagramas

La solución sencilla que utiliza \addlyrics se puede usar para poner letra a más de un pentagrama. Aquí aparece un ejemplo sacado del Judas Macabeo de Haendel:

<<
  \relative {
    \key f \major
    \time 6/8
    \partial 8
    c''8 | c8([ bes]) a a([ g]) f | f'4. b, | c4.~ 4
  }
  \addlyrics {
    Let flee -- cy flocks the hills a -- dorn, __
  }
  \relative {
    \key f \major
    \time 6/8
    \partial 8
    r8 | r4. r4 c'8 | a'8([ g]) f f([ e]) d | e8([ d]) c bes'4
  }
  \addlyrics {
    Let flee -- cy flocks the hills a -- dorn,
  }
>>

Cualquier partitura de una complejidad mayor que la de este sencillo ejemplo se hace mejor separando la letra de la estructura de pentagramas mediante variables (expresiones con nombre). Éstas se tratan en Organizar las piezas mediante variables.

Véase también

Referencia de la notación: Música vocal.

3.4 Retoques finales

Éste es el último apartado del tutorial; muestra la forma de dar los toques finales a piezas sencillas, y ofrece una introducción al resto del manual.

3.4.1 Organizar las piezas mediante variables

Cuando los elementos que hemos discutido anteriormente se combinan para producir archivos mayores, las expresiones musicales se hacen enormes. En música polifónica con muchos pentagramas, los archivos de entrada pueden volverse muy propensos a la confusión. Podemos reducir esta confusión utilizando las variables.

Con las variables (también conocidas como identificadores o macros), podemos trocear las expresiones musicales complejas. Una variable se asigna de la manera siguiente:

musicaConNombre = { … }

El contenido de la expresión musical musicaConNombre se puede usar posteriormente colocando una barra invertida delante del nombre (\musicaConNombre, igual que una orden normal de LilyPond).

violin = \new Staff {
  \relative {
    a'4 b c b
  }
}

cello = \new Staff {
  \relative {
    \clef "bass"
    e2 d
  }
}

{
  <<
    \violin
    \cello
  >>
}

Por convención, los nombres de variable consisten enteramente en caracteres alfabéticos. Para ver información detallada, consulte Estructura del archivo.

Las variables se deben definir antes de la expresión musical principal, pero se pueden usar tantas veces como se quiera, en cualquier lugar, una vez que han sido definidas. Incluso se pueden usar dentro de la definición de otra variable, proporcionando una vía para acortar el código si una sección musical se repite muchas veces.

tresilloA = \relative { \tuplet 3/2 { c'8 e g } }
compasA = { \tresilloA \tresilloA \tresilloA \tresilloA }

{ \compasA \compasA }

Las variables se pueden usar para otros muchos tipos de objetos dentro del código de entrada. Por ejemplo,

miAncho = 4.5\cm     % número pasado a una variable de \paper (unidades: milímetros)
miNombre = "Wendy"   % cadena pasada a un elemento de marcado
papelAcinco = \paper { #(set-paper-size "a5") }

Dependiendo de su contenido, la variable se puede usar en distintos lugares. El siguiente ejemplo utiliza las variables anteriores:

\paper {
  \papelAcinco
  line-width = \miAncho
}

{
  c4^\miNombre
}

3.4.2 Añadir títulos

La información sobre el título, autor, número de Opus y similares se escriben en el bloque \header. Éste se encuentra fuera de la expresión musical principal; el bloque \header normalmente se sitúa por debajo del número de versión.

\version "2.23.82"

\header {
  title = "Sinfonía"
  composer = "Yo"
  opus = "Op. 9"
}

{
  … música …
}

Cuando se procesa el archivo, el título y el autor se imprimen por encima de la música. Puede obtener más información sobre los títulos en Crear títulos encabezamientos y pies de página.

3.4.3 Nombres de nota absolutos

Hasta el momento hemos utilizado \relative para definir las alturas. Ésta es normalmente la forma más rápida de escribir la mayor parte de la música. Sin \relative, las alturas se interpretan en modo absoluto.

En este modo, LilyPond tratará todas las alturas como valores absolutos. Una c' significará siembre un Do central, una b significará siempre la nota inmediatamente por debajo del Do central, y una g, significará siempre la nota que se coloca en la primera línea del pentagrama en clave de Fa.

{
  \clef "bass"
  c'4 b g, g, |
  g,4 f, f c' |
}

La escritura de una melodía en clave de Sol implica un gran número de apóstrofos ('). Considere este fragmento de Mozart:

{
  \key a \major
  \time 6/8
  cis''8. d''16 cis''8 e''4 e''8 |
  b'8. cis''16 b'8 d''4 d''8 |
}

Las marcas de octava que son comunes se pueden indicar una sola vez, utilizando la instrucción \fixed seguida de una altura de referencia:

\fixed c'' {
  \key a \major
  \time 6/8
  cis8. d16 cis8 e4 e8 |
  b,8. cis16 b,8 d4 d8 |
}

Con \relative, el ejemplo anterior no requiere marcas de cambio de octava porque esta melodía se mueve por intervalos no mayores de una cuarta, o tres posiciones dentro del pentagrama:

\relative {
  \key a \major
  \time 6/8
  cis''8. d16 cis8 e4 e8 |
  b8. cis16 b8 d4 d8 |
}

Si comete un error con una marca de octava (' o ,) mientras trabaja en el modo \relative, será muy obvio (muchas notas estarán en la octava equivocada). Mientras trabaja en el modo absoluto, un solo fallo no será tan visible, y tampoco será tan fácil de localizar.

Sin embargo, el modo absoluto es útil para escribir música que contenga intervalos grandes, y será extremadamente útil para hacer archivos de LilyPond generados por ordenador. Cuando se copian y pegan fragmentos melódicos, el modo absoluto preserva la octava del material original.

A veces la música se dispone de formas más complejas. Si está usando \relative dentro de \relative, las secciones relativas externa e interna son independientes:

\relative { c'4 \relative { f'' g } c }

Para usar el modo absoluto dentro de \relative, ponga la música absoluta dentro de \fixed c { … } y las notas absolutas no afectarán a las octavas de la música relativa:

\relative {
  c'4 \fixed c { f'' g'' } c |
  c4 \fixed c'' { f g } c
}

3.4.4 Más allá del tutorial

Después de terminar el tutorial, quizá debería probar a escribir una o dos piezas. Comience con una de las plantillas que aparecen en Plantillas y añada algunas notas. Si necesita un tipo de notación que no ha sido tratada en el tutorial, eche un vistazo a la Referencia de Notación, empezando por Notación musical. Si quiere escribir música para un conjunto instrumental que no está cubierto por ninguna plantilla, consulte Extender las plantillas.

Una vez que ha escrito algunas piezas cortas, lea el resto del Manual de aprendizaje (capítulos 3 al 5). ¡Por supuesto, no pasa nada por leerlo ahora mismo! Sin embargo, el resto del Manual de Aprendizaje da por sentado que está familiarizado con la entrada de LilyPond. Puede saltarse estos capítulos ahora y volver a ellos cuando haya adquirido más experiencia.

En este tutorial y en el resto del Manual de aprendizaje, existe un apartado Véase también al final de cada una de las secciones, que contiene referencias cruzadas a otras secciones: no siga estas referencias durante la primera lectura; cuando haya leído el Manual de aprendizaje completo, quizá desee releer ciertas secciones y seguir las referencias cruzadas para obtener más información.

Si no lo ha hecho aún, le rogamos que lea Panorámica de los manuales. Existe una gran cantidad de información sobre LilyPond, de manera que los recién llegados con frecuencia no saben exactamente dónde deben buscar la ayuda. Si emplea cinco minutos en leer cuidadosamente esta sección ¡se ahorrará horas de frustración buscando en el sitio equivocado!

4. Conceptos fundamentales

Ha podido ver en el tutorial cómo producir música bellamente impresa a partir de un simple archivo de texto. Esta sección presenta los conceptos y técnicas que se requieren para producir partituras igualmente bellas pero más complejas.

4.1 Cómo funcionan los archivos de entrada de LilyPond

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 Estructura del archivo.

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

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

\version "2.23.82"

\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 Disposición de la partitura y en Creación de salida MIDI.

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 Varias partituras en un libro.

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 Estructura del archivo.

Véase también

Para ver una definición completa del formato del código de entrada, consulte Estructura del archivo.

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

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 Modos de entrada).

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: Estructura de una partitura.

4.1.3 Anidado de expresiones musicales

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 ossia). 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 Pentagramas de Ossia.

4.1.4 Estructura de un elemento de nota

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 Nombres de las notas en otros idiomas. 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 Duraciones. 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 Duraciones.

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: Alturas, Duraciones, Expresiones.

4.1.5 Acerca de la no anidabilidad de llaves y ligaduras

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.\)
}

4.2 Las voces contienen música

Igual que los cantantes, LilyPond necesita voces para cantar. En realidad, la música para cualquier instrumento de una partitura está siempre contenida dentro de una voz –el concepto de LilyPond más fundamental de todos–.

4.2.1 Oigo voces

De las capas más profundas de una partitura de LilyPond, las más bajas y más fundamentales reciben el nombre de ‘Voice contexts’ («contextos de voz») o, abreviadamente, ‘Voices’ («voces»). Las voces reciben a veces el nombre de ‘layers’ («capas») en otros programas de edición de partituras.

De hecho, una capa o contexto de voz es la única que puede contener música. Si un contexto de voz no se declara explícitamente, se crea uno de forma automática, como vimos al comienzo de este capítulo. Ciertos instrumentos como el oboe solamente pueden tocar una nota cada vez. La música escrita para estos instrumentos solamente requiere una voz. Los instrumentos que pueden tocar más de una nota a la vez, como el piano, con frecuencia necesitarán varias voces para codificar las distintas notas y ritmos concurrentes que son capaces de tocar.

Una sola voz puede contener muchas notas dentro de un acorde, por supuesto; entonces ¿cuándo, exactamente, se necesitan varias voces? En primer lugar observe este ejemplo de cuatro acordes:

\relative {
  \key g \major
  <d' g>4 <d fis> <d a'> <d g>
}

Esto se puede expresar utilizando sólo símbolos de acorde con ángulos simples, < … >, y para este propósito tan sólo se necesita una voz. Pero suponga que el Fa sostenido fuese realmente una corchea seguida de un Sol corchea, una nota de paso que conduce al La. Ahora tenemos dos notas que empiezan en el mismo momento pero tienen distintas duraciones: la negra Re, y la corchea Fa sostenido. ¿Cómo se codifica esto? No se pueden escribir como un acorde porque todas las notas de un acorde deben tener la misma duración. Y no se pueden escribir como dos notas en secuencia porque tienen que empezar en el mismo momento. Aquí es donde se necesitan dos voces.

Veamos cómo se hace esto dentro de la sintaxis de entrada de LilyPond.

La forma más fácil de introducir fragmentos con más de una voz en un solo pentagrama es escribir cada voz como una secuencia (con { … }), y combinarlas simultáneamente con ángulos dobles, << … >>. Los fragmentos también se deben separar mediante una doble barra invertida, \\, para situarlos en voces separadas. Sin esto, las notas irían a una sola voz, lo que normalmente produce errores. Esta técnica se adapta especialmente bien a piezas de música que son mayormente homofónicas pero ocasionalmente tienen cortas secciones de polifonía.

He aquí cómo dividimos los acordes anteriores en dos voces y añadimos la nota de paso y la ligadura:

\relative {
  \key g \major
  %    Voice = "1"             Voice = "2"
  << { g'4 fis8( g) a4 g } \\ { d4 d d d }  >>
}

Observe cómo las plicas de la segunda voz ahora se dirigen hacia abajo.

A continuación veamos otro ejemplo sencillo:

\relative {
  \key d \minor
  %    Voice = "1"           Voice = "2"
  << { r4 g' g4. a8 }   \\ { d,2 d4 g }       >> |
  << { bes4 bes c bes } \\ { g4 g g8( a) g4 } >> |
  << { a2. r4 }         \\ { fis2. s4 }       >> |
}

No es necesario usar una construcción << \\ >> distinta para cada compás. Para música que tenga unas pocas notas en cada compás, esta disposición podría facilitar la legibilidad del código, pero si hay muchas notas en cada compás podría ser mejor dividirlo en dos voces separadas, de la siguiente manera:

<<
  \key d \minor
  \relative { % Voice = "1"
    r4 g' g4. a8 |
    bes4 bes c bes |
    a2. r4 |
  } \\
  \relative { % Voice = "2"
    d'2 d4 g |
    g4 g g8( a) g4 |
    fis2. s4 |
  }
>>