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: 7a5bfc62fcac71d5c996b2df58921fd2fe783415
   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}, consulte la
  21 documentación de estos programas en caso de encontrarse 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
  96
  97 @subsubheading Paso 1.  Creamos el archivo @file{.ly}
  98
  99 Haga doble clic sobre el icono de LilyPond del escritorio
 100 y se abrirá un archivo de ejemplo.
 101
 102 @sourceimage{LilyPad,,,}
 103
 104 Del menú de la ventana que contiene el archivo de ejemplo, elija
 105 @w{@code{Archivo > Guardar como}}. No use @w{@code{Archivo > Guardar}}
 106 para este archivo de ejemplo porque no funcionará hasta que le aplique
 107 un nombre de LilyPond válido.
 108
 109 @sourceimage{FileSave,,,}
 110
 111 Escoja un nombre para el archivo, por ejemplo @file{prueba.ly}.
 112
 113 @sourceimage{SaveAs,,,}
 114
 115
 116 @subsubheading Step 2. Compilación
 117
 118 Para convertir nuestro archivo de LilyPond en una partitura
 119 musical, tenemos que compilarlo.  Esto puede hacerse de varias
 120 formas: usando la técnica de arrastrar y soltar, clic con el botón
 121 derecho del ratón, dobe clic, o usando la línea de órdenes (la
 122 consola de MS-DOS).  Comenzaremos examinando las tres primeras.
 123
 124 1. Arrastre el archivo y suéltelo directamente encima del icono de
 125 LilyPond del escritorio.
 126
 127 @sourceimage{DragDrop,,,}
 128
 129 No parece que haya ocurrido gran cosa, pero después de unos
 130 instantes, debe observar que hay dos archivos nuevos en el
 131 escritorio: @file{prueba.log} y @file{prueba.pdf}.
 132
 133 2. Pulse sobre el archivo con el botón derecho del ratón y elija
 134 del menú contextual la opción @w{@code{Generar PDF}}.
 135
 136 @sourceimage{GenPDF,,,}
 137
 138 3. O bien, sencillamente haga doble clic sobre el archivo
 139 @file{prueba.ly}.
 140
 141
 142 @subsubheading Step 3. Ver el resultado
 143
 144 El archivo @file{prueba.pdf} contiene, compuesta tipográficamente,
 145 la partitura del archivo @file{prueba.ly}.  Haga doble clic sobre
 146 ella y se debería abrir en el visor de documentos PDF:
 147
 148 @sourceimage{PDFRead,,,}
 149
 150
 151 @subsubheading Otras instrucciones
 152
 153 Para crear un archivo nuevo, comience eligiendo @w{@code{Archivo >
 154 Nuevo}} desde dentro de algún archivo creado previamente, o bien
 155 elija @w{@code{Archivo > Abrir}} para abrir y editar cualquier
 156 archivo que haya guardado antes.  También puede editar un archivo
 157 pulsando con el botón derecho y eligiendo la opción
 158 @w{@code{Editar la fuente}}.
 159
 160 @sourceimage{EditFile,,,}
 161
 162 Debe guardar cualquier edición que haya realizado sobre el archivo
 163 antes de compilarlo, y si no se ha creado un PDF, deberá comprobar el
 164 archivo @command{log} de registro que se ha creado durante el intento
 165 de compilación, en busca de algún error.
 166
 167 @sourceimage{BadLog,,,}
 168
 169 Este archivo de registro se sobreescribe cada vez que compilamos un
 170 archivo de LilyPond.
 171
 172 Si estamos viendo el archivo en un visor de documentos PDF, tiene que
 173 cerrar el PDF cuando quiera intentar una compilación nueva, porque
 174 podría fallar la creación del PDF nuevo mientras se está viendo con
 175 algún programa.
 176
 177 @sourceimage{BadLog2,,,}
 178
 179 @end macro
 180
 181
 182 @c not lilypad at all, but I ran out of names.  :(
 183 @macro lilypadCommandLine
 184 @warning{Estas instrucciones dan por sentado que usted está
 185 familiarizado con los programas en línea de órdenes, o programas de
 186 consola.  Si está utilizando alguno de los programas que se describen
 187 en @rweb{Entornos mejorados}, consulte la documentación de estos
 188 programas cuando encuentre algún problema.}
 189
 190
 191 @subsubheading Paso 1.  Creamos el archivo @file{.ly}
 192
 193 Haga un archivo de texto con el nombre
 194 @file{prueba.ly} y escriba en él lo siguiente:
 195
 196 @c double \\ required because this is inside a macro!
 197 @example
 198 \\version "@w{@versionStable{}}"
 199 @{
 200 @ @ c' e' g' e'
 201 @}
 202 @end example
 203
 204
 205 @subsubheading Paso 2. Compilación (con la línea de órdenes)
 206
 207 Para procesar el archivo @file{prueba.ly} escriba lo siguiente en la
 208 línea de órdenes:
 209
 210 @example
 211 lilypond prueba.ly
 212 @end example
 213
 214 @noindent
 215 Verá algo parecido a:
 216
 217 @example
 218 GNU LilyPond @w{@versionStable{}}
 219 Procesando `prueba.ly'
 220 Analizando...
 221 Interpretando la música...
 222 Preprocesando los objetos gráficos...
 223 Buscando el número de páginas ideal...
 224 Disponiendo la música en 1 página...
 225 Dibujando los sistemas...
 226 Escribiendo la página de salida en `prueba.ps'...
 227 Convirtiendo a `prueba.pdf'...
 228 Terminado: la compilación ha finalizado satisfactoriamente
 229 @end example
 230
 231 @subsubheading Paso 3: Examinar el resultado
 232
 233 Podemos ver o imprimir el archivo @file{prueba.pdf} resultante.
 234
 235 @end macro
 236
 237