Documentation/es/included/generating-output.itexi

   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
   4
   5 @ignore
   6     Translation of GIT committish: 63f65db72ca60bb87a6515a4f20a172c4a2897dc
   7
   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..
  11 @end ignore
  12
  13 @c This is about "compiling" a lilypond file
  14 @c (Learning 1 Tutorial), **not** compiling the
  15 @c source code.
  16
  17 @macro lilypadOSX
  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.}
  22
  23
  24 @subsubheading Paso 1. Creamos nuestro archivo @file{.ly}
  25
  26 Haga doble clic sobre @command{LilyPond.app}, se abrirá un archivo de
  27 ejemplo.
  28
  29 @sourceimage{Learning_Macos_welcome,,,}
  30
  31 Del menú de la parte superior izquierda de la pantalla, elija
  32 @w{@code{Archivo > Guardar}}.
  33
  34 @sourceimage{Learning_Macos_Save_menu,,,}
  35
  36 ELija un nombre para su archivo, por ejemplo @file{prueba.ly}.
  37
  38 @sourceimage{Learning_Macos_Save_file_with_name,,,}
  39
  40
  41 @subsubheading Paso 2. Compilamos (con LilyPad)
  42
  43 Del mismo menú, elija
  44 @w{@code{Compilar > Procesar}}.
  45
  46 @sourceimage{Learning_Macos_Typeset_menu,,,}
  47
  48 Se abrirá una ventana que muestra un registro del progreso de la
  49 compilación del archivo que acaba de guardar.
  50
  51 @sourceimage{Learning_Macos_Compiling_log,,,}
  52
  53
  54 @subsubheading Paso 3. Examinar el resultado
  55
  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.
  60
  61 @sourceimage{Learning_Macos_pdf_output,,,}
  62
  63
  64 @subsubheading Otras instrucciones
  65
  66 Para crear archivos de LilyPond nuevos, comience seleccionando
  67 @w{@code{Archivo > Nuevo}}
  68
  69 @sourceimage{Learning_Macos_New_menu,,,}
  70
  71 o bien @w{@code{Archivo > Abrir}} para abrir y editar archivos existentes
  72 que haya guardado previamente.
  73
  74 @sourceimage{Learning_Macos_Open_menu,,,}
  75
  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.
  80
  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
  85 cierre el original.
  86
  87 @end macro
  88
  89
  90 @macro lilypadWindows
  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.}
  96
  97
  98 @subsubheading Paso 1.  Creamos el archivo @file{.ly}
  99
 100 Haga doble clic sobre el icono de LilyPond del escritorio
 101 y se abrirá un archivo de ejemplo.
 102
 103 @sourceimage{LilyPad,,,}
 104
 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.
 109
 110 @sourceimage{FileSave,,,}
 111
 112 Escoja un nombre para el archivo, por ejemplo @file{prueba.ly}.
 113
 114 @sourceimage{SaveAs,,,}
 115
 116
 117 @subsubheading Step 2. Compilación
 118
 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.
 124
 125 1. Arrastre el archivo y suéltelo directamente encima del icono de
 126 LilyPond del escritorio.
 127
 128 @sourceimage{DragDrop,,,}
 129
 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}.
 133
 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}}.
 136
 137 @sourceimage{GenPDF,,,}
 138
 139 3. O bien, sencillamente haga doble clic sobre el archivo
 140 @file{prueba.ly}.
 141
 142
 143 @subsubheading Step 3. Ver el resultado
 144
 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:
 148
 149 @sourceimage{PDFRead,,,}
 150
 151
 152 @subsubheading Otras instrucciones
 153
 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}}.
 160
 161 @sourceimage{EditFile,,,}
 162
 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.
 167
 168 @sourceimage{BadLog,,,}
 169
 170 Este archivo de registro se sobreescribe cada vez que compilamos un
 171 archivo de LilyPond.
 172
 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
 176 algún programa.
 177
 178 @sourceimage{BadLog2,,,}
 179
 180 @end macro
 181
 182
 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.}
 190
 191
 192 @subsubheading Paso 1.  Creamos el archivo @file{.ly}
 193
 194 Haga un archivo de texto con el nombre
 195 @file{prueba.ly} y escriba en él lo siguiente:
 196
 197 @c double \\ required because this is inside a macro!
 198 @example
 199 \\version "@w{@versionStable{}}"
 200 @{
 201 @ @ c' e' g' e'
 202 @}
 203 @end example
 204
 205
 206 @subsubheading Paso 2. Compilación (con la línea de órdenes)
 207
 208 Para procesar el archivo @file{prueba.ly} escriba lo siguiente en la
 209 línea de órdenes:
 210
 211 @example
 212 lilypond prueba.ly
 213 @end example
 214
 215 @noindent
 216 Verá algo parecido a:
 217
 218 @example
 219 GNU LilyPond @w{@versionStable{}}
 220 Procesando `prueba.ly'
 221 Analizando...
 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
 230 @end example
 231
 232 @subsubheading Paso 3: Examinar el resultado
 233
 234 Podemos ver o imprimir el archivo @file{prueba.pdf} resultante.
 235
 236 @end macro
 237
 238