1.1 Compilación del archivo

@translationof Compiling a file

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.

1.1.1 Escritura del código de entrada

@translationof Entering input

“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.21.3"
{
  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.

Generar el resultado

@translationof Producing output

El método para producir un resultado impreso depende de nuestro sistema operativo y del programa o programas que utilicemos.

• MacOS X (gráfico)
• Microsoft Windows (gráfico)
• Todos los sistemas operativos (consola)

Existen varios otros editores de texto con un apoyo específico a la edición de texto de LilyPond. Para ver más información, consulte (web)Entornos mejorados sección ‘Entornos mejorados’ en Información general.

1.1.2 MacOS X

Paso 1. Creamos nuestro archivo ‘.ly’

Haga doble clic sobre LilyPond.app, se abrirá un archivo de ejemplo.

Del menú de la parte superior izquierda de la pantalla, elija Archivo > Guardar.

ELija un nombre para su archivo, por ejemplo ‘prueba.ly’.

Paso 2. Compilamos (con LilyPad)

Del mismo menú, elija Compilar > Procesar.

Se abrirá una ventana que muestra un registro del progreso de la compilación del archivo que acaba de guardar.

Paso 3. Examinar el resultado

Una vez la compilación ha terminado, se crea un archivo PDF con el mismo nombre que el archivo original y se abrirá automáticamente en el visor de documentos PDF predeterminado, mostrándose en la pantalla.

Otras instrucciones

Para crear archivos de LilyPond nuevos, comience seleccionando Archivo > Nuevo

o bien Archivo > Abrir para abrir y editar archivos existentes que haya guardado previamente.

Debe guardar cualquier e modificación que haya realizado sobre el archivo, antes de Compilar > Procesar y siempre que el PDF no se muestre en pantalla debe comprobar que no haya errores en la ventana que contiene el registro del progreso.

Si no está utilizando el visor de documentos predeterminado que viene con el sistema operativo del Mac, y tiene abierto el archivo PDF generado a partir de una compilación previa, cualquier compilación ulterior puede fallar al intentar generar un PDF actualizado hasta que cierre el original.

1.1.3 Windows

Paso 1. Creamos el archivo ‘.ly’

Haga doble clic sobre el icono de LilyPond del escritorio y se abrirá un archivo de ejemplo.

Del menú de la ventana que contiene el archivo de ejemplo, elija Archivo > Guardar como. No use Archivo > Guardar para este archivo de ejemplo porque no funcionará hasta que le aplique un nombre de LilyPond válido.

Escoja un nombre para el archivo, por ejemplo ‘prueba.ly’.

Step 2. Compilación

Para convertir nuestro archivo de LilyPond en una partitura musical, tenemos que compilarlo. Esto puede hacerse de varias formas: usando la técnica de arrastrar y soltar, clic con el botón derecho del ratón, dobe clic, o usando la línea de órdenes (la consola de MS-DOS). Comenzaremos examinando las tres primeras.

1. Arrastre el archivo y suéltelo directamente encima del icono de LilyPond del escritorio.

No parece que haya ocurrido gran cosa, pero después de unos instantes, debe observar que hay dos archivos nuevos en el escritorio: ‘prueba.log’ y ‘prueba.pdf’.

2. Pulse sobre el archivo con el botón derecho del ratón y elija del menú contextual la opción Generar PDF.

3. O bien, sencillamente haga doble clic sobre el archivo ‘prueba.ly’.

Step 3. Ver el resultado

El archivo ‘prueba.pdf’ contiene, compuesta tipográficamente, la partitura del archivo ‘prueba.ly’. Haga doble clic sobre ella y se debería abrir en el visor de documentos PDF:

Otras instrucciones

Para crear un archivo nuevo, comience eligiendo Archivo > Nuevo desde dentro de algún archivo creado previamente, o bien elija Archivo > Abrir para abrir y editar cualquier archivo que haya guardado antes. También puede editar un archivo pulsando con el botón derecho y eligiendo la opción Editar la fuente.

Debe guardar cualquier edición que haya realizado sobre el archivo antes de compilarlo, y si no se ha creado un PDF, deberá comprobar el archivo log de registro que se ha creado durante el intento de compilación, en busca de algún error.

Este archivo de registro se sobreescribe cada vez que compilamos un archivo de LilyPond.

Si estamos viendo el archivo en un visor de documentos PDF, tiene que cerrar el PDF cuando quiera intentar una compilación nueva, porque podría fallar la creación del PDF nuevo mientras se está viendo con algún programa.

1.1.4 Línea de órdenes

@translationof Command-line

Paso 1. Creamos el archivo ‘.ly’

Haga un archivo de texto con el nombre ‘prueba.ly’ y escriba en él lo siguiente:

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

Paso 2. Compilación (con la línea de órdenes)

Para procesar el archivo ‘prueba.ly’ escriba lo siguiente en la línea de órdenes:

lilypond prueba.ly

Verá algo parecido a:

GNU LilyPond 2.20.0
Procesando `prueba.ly'
Analizando...
Interpretando la música...
Preprocesando los objetos gráficos...
Buscando el número de páginas ideal...
Disponiendo la música en 1 página...
Dibujando los sistemas...
Escribiendo la página de salida en `prueba.ps'...
Convirtiendo a `prueba.pdf'...
Terminado: la compilación ha finalizado satisfactoriamente

Paso 3: Examinar el resultado

Podemos ver o imprimir el archivo ‘prueba.pdf’ resultante.

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.