1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
2 @c This file is part of web/download.itexi and
3 @c learning/tutorial.itely
6 Translation of GIT committish: 63f65db72ca60bb87a6515a4f20a172c4a2897dc
8 When revising a translation, copy the HEAD committish of the
9 version that you are working on. For details, see the Contributors'
10 Guide, node Updating translation committishes..
13 @c This is about "compiling" a lilypond file
14 @c (Learning 1 Tutorial), **not** compiling the
18 @warning{Estas instrucciones dan por sentado que está usando la propia
19 aplicación LilyPond. Si está usando alguno de los programas que se
20 describen en @rweb{Entornos mejorados}, debe consultar la
21 documentación de estos programas si se encuentra con algún problema.}
24 @subsubheading Paso 1. Creamos nuestro archivo @file{.ly}
26 Haga doble clic sobre @command{LilyPond.app}, se abrirá un archivo de
29 @sourceimage{Learning_Macos_welcome,,,}
31 Del menú de la parte superior izquierda de la pantalla, elija
32 @w{@code{Archivo > Guardar}}.
34 @sourceimage{Learning_Macos_Save_menu,,,}
36 ELija un nombre para su archivo, por ejemplo @file{prueba.ly}.
38 @sourceimage{Learning_Macos_Save_file_with_name,,,}
41 @subsubheading Paso 2. Compilamos (con LilyPad)
44 @w{@code{Compilar > Procesar}}.
46 @sourceimage{Learning_Macos_Typeset_menu,,,}
48 Se abrirá una ventana que muestra un registro del progreso de la
49 compilación del archivo que acaba de guardar.
51 @sourceimage{Learning_Macos_Compiling_log,,,}
54 @subsubheading Paso 3. Examinar el resultado
56 Una vez la compilación ha terminado, se crea un archivo PDF con
57 el mismo nombre que el archivo original y se abrirá
58 automáticamente en el visor de documentos PDF predeterminado,
59 mostrándose en la pantalla.
61 @sourceimage{Learning_Macos_pdf_output,,,}
64 @subsubheading Otras instrucciones
66 Para crear archivos de LilyPond nuevos, comience seleccionando
67 @w{@code{Archivo > Nuevo}}
69 @sourceimage{Learning_Macos_New_menu,,,}
71 o bien @w{@code{Archivo > Abrir}} para abrir y editar archivos existentes
72 que haya guardado previamente.
74 @sourceimage{Learning_Macos_Open_menu,,,}
76 Debe guardar cualquier e modificación que haya realizado sobre el
77 archivo, antes de @w{@code{Compilar > Procesar}} y siempre que el PDF
78 no se muestre en pantalla debe comprobar que no haya errores en la
79 ventana que contiene el registro del progreso.
81 Si no está utilizando el visor de documentos predeterminado que viene
82 con el sistema operativo del Mac, y tiene abierto el archivo PDF
83 generado a partir de una compilación previa, cualquier compilación
84 ulterior puede fallar al intentar generar un PDF actualizado hasta que
91 @warning{Estas instrucciones dan por sentado que está utilizando el
92 editor LilyPad incorporado. Si está usando alguno de los programas
93 que se describen en el apartado @rweb{Entornos mejorados}, consulte la
94 documentación de estos programas cuando encuentre algún problema
95 durante la compilación de un archivo.}
98 @subsubheading Paso 1. Creamos el archivo @file{.ly}
100 Haga doble clic sobre el icono de LilyPond del escritorio
101 y se abrirá un archivo de ejemplo.
103 @sourceimage{LilyPad,,,}
105 Del menú de la ventana que contiene el archivo de ejemplo, elija
106 @w{@code{Archivo > Guardar como}}. No use @w{@code{Archivo > Guardar}}
107 para este archivo de ejemplo porque no funcionará hasta que le aplique
108 un nombre de LilyPond válido.
110 @sourceimage{FileSave,,,}
112 Escoja un nombre para el archivo, por ejemplo @file{prueba.ly}.
114 @sourceimage{SaveAs,,,}
117 @subsubheading Step 2. Compilación
119 Para convertir nuestro archivo de LilyPond en una partitura
120 musical, tenemos que compilarlo. Esto puede hacerse de varias
121 formas: usando la técnica de arrastrar y soltar, clic con el botón
122 derecho del ratón, dobe clic, o usando la línea de órdenes (la
123 consola de MS-DOS). Comenzaremos examinando las tres primeras.
125 1. Arrastre el archivo y suéltelo directamente encima del icono de
126 LilyPond del escritorio.
128 @sourceimage{DragDrop,,,}
130 No parece que haya ocurrido gran cosa, pero después de unos
131 instantes, debe observar que hay dos archivos nuevos en el
132 escritorio: @file{prueba.log} y @file{prueba.pdf}.
134 2. Pulse sobre el archivo con el botón derecho del ratón y elija
135 del menú contextual la opción @w{@code{Generar PDF}}.
137 @sourceimage{GenPDF,,,}
139 3. O bien, sencillamente haga doble clic sobre el archivo
143 @subsubheading Step 3. Ver el resultado
145 El archivo @file{prueba.pdf} contiene, compuesta tipográficamente,
146 la partitura del archivo @file{prueba.ly}. Haga doble clic sobre
147 ella y se debería abrir en el visor de documentos PDF:
149 @sourceimage{PDFRead,,,}
152 @subsubheading Otras instrucciones
154 Para crear un archivo nuevo, comience eligiendo @w{@code{Archivo >
155 Nuevo}} desde dentro de algún archivo creado previamente, o bien
156 elija @w{@code{Archivo > Abrir}} para abrir y editar cualquier
157 archivo que haya guardado antes. También puede editar un archivo
158 pulsando con el botón derecho y eligiendo la opción
159 @w{@code{Editar la fuente}}.
161 @sourceimage{EditFile,,,}
163 Debe guardar cualquier edición que haya realizado sobre el archivo
164 antes de compilarlo, y si no se ha creado un PDF, deberá comprobar el
165 archivo @command{log} de registro que se ha creado durante el intento
166 de compilación, en busca de algún error.
168 @sourceimage{BadLog,,,}
170 Este archivo de registro se sobreescribe cada vez que compilamos un
173 Si estamos viendo el archivo en un visor de documentos PDF, tiene que
174 cerrar el PDF cuando quiera intentar una compilación nueva, porque
175 podría fallar la creación del PDF nuevo mientras se está viendo con
178 @sourceimage{BadLog2,,,}
183 @c not lilypad at all, but I ran out of names. :(
184 @macro lilypadCommandLine
185 @warning{Estas instrucciones dan por sentado que usted está
186 familiarizado con los programas en línea de órdenes, o programas de
187 consola. Si está utilizando alguno de los programas que se describen
188 en @rweb{Entornos mejorados}, consulte la documentación de estos
189 programas cuando tenga algún problema al compilar un documento.}
192 @subsubheading Paso 1. Creamos el archivo @file{.ly}
194 Haga un archivo de texto con el nombre
195 @file{prueba.ly} y escriba en él lo siguiente:
197 @c double \\ required because this is inside a macro!
199 \\version "@w{@versionStable{}}"
206 @subsubheading Paso 2. Compilación (con la línea de órdenes)
208 Para procesar el archivo @file{prueba.ly} escriba lo siguiente en la
216 Verá algo parecido a:
219 GNU LilyPond @w{@versionStable{}}
220 Procesando `prueba.ly'
222 Interpretando la música...
223 Preprocesando los objetos gráficos...
224 Buscando el número de páginas ideal...
225 Disponiendo la música en 1 página...
226 Dibujando los sistemas...
227 Escribiendo la página de salida en `prueba.ps'...
228 Convirtiendo a `prueba.pdf'...
229 Terminado: la compilación ha finalizado satisfactoriamente
232 @subsubheading Paso 3: Examinar el resultado
234 Podemos ver o imprimir el archivo @file{prueba.pdf} resultante.