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: 66194168b6d61bee8aac10552f029817eb41d835
   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 Paso 2-A. Compílelo (arrastrando y soltando)
 118
 119 Según su preferencia, para compilar el documento puede hacer una de
 120 estas dos cosas:
 121
 122 Arrastre el archivo y suéltelo directamente encima del icono de
 123 LilyPond.
 124
 125 @sourceimage{DragDrop,,,}
 126
 127 Pulse con el botón derecho sobre el archivo y elija @w{@code{Abrir con
 128 > LilyPond}} del menú contextual emergente.
 129
 130 @sourceimage{GenPDF,,,}
 131
 132
 133 @subsubheading Paso 2-B. Compílelo (con doble clic)
 134
 135 O simplemente haga doble clic sobre el archivo @file{prueba.ly}.
 136
 137
 138 @subsubheading Paso 3. Examinar el resultado
 139
 140 Durante la compilación del archivo @file{prueba.ly}, se abrirá muy
 141 brevemente una ventana de la consola y luego se cerrará.  Durante este
 142 proceso se habrán creado tres archivos adicionales.  El archivo PDF
 143 contiene el documento @file{prueba.ly} convertido en una partitura musical.
 144
 145 @sourceimage{PDFRead,,,}
 146
 147
 148 @subsubheading Otras instrucciones
 149
 150 Para crear un archivo nuevo, comience eligiendo @w{@code{Archivo > Nuevo}}
 151 desde dentro de algún archivo creado previamente o bien, elija
 152 @w{@code{Archivo > Abrir}} para abrir y editar cualquier
 153 archivo que haya guardado antes.
 154
 155 @sourceimage{EditFile,,,}
 156
 157 Debe guardar cualquier edición que haya realizado sobre el archivo
 158 antes de compilarlo, y si no se ha creado un PDF, deberá comprobar el
 159 archivo @command{log} de registro que se ha creado durante el intento
 160 de compilación, en busca de algún error.
 161
 162 @sourceimage{BadLog,,,}
 163
 164 Este archivo de registro se sobreescribe cada vez que compilamos un
 165 archivo de LilyPond.
 166
 167 El archivo PS se utiliza internamente por parte de LilyPond para crear
 168 el archivo PDF, y se puede ignorar.  También se sobreescribe cada vez
 169 que compilamos nuestro documento.
 170
 171 Si estamos viendo el archivo en un visor de documentos PDF, tiene que
 172 cerrar el PDF cuando quiera realizar una compilación nueva, porque
 173 podría fallar la creación del PDF nuevo mientras se está viendo con
 174 algún programa.
 175
 176
 177 @end macro
 178
 179
 180 @c not lilypad at all, but I ran out of names.  :(
 181 @macro lilypadCommandLine
 182 @warning{Estas instrucciones dan por sentado que usted está
 183 familiarizado con los programas en línea de órdenes, o programas de
 184 consola.  Si está utilizando alguno de los programas que se describen
 185 en @rweb{Entornos mejorados}, consulte la documentación de estos
 186 programas cuando tenga algún problema al compilar un documento.}
 187
 188
 189 @subsubheading Paso 1.  Creamos el archivo @file{.ly}
 190
 191 Haga un archivo de texto con el nombre
 192 @file{prueba.ly} y escriba en él lo siguiente:
 193
 194 @c double \\ required because this is inside a macro!
 195 @example
 196 \\version "@w{@versionStable{}}"
 197 @{
 198 @ @ c' e' g' e'
 199 @}
 200 @end example
 201
 202
 203 @subsubheading Paso 2. Compilación (con la línea de órdenes)
 204
 205 Para procesar el archivo @file{prueba.ly} escriba lo siguiente en la
 206 línea de órdenes:
 207
 208 @example
 209 lilypond prueba.ly
 210 @end example
 211
 212 @noindent
 213 Verá algo parecido a:
 214
 215 @example
 216 GNU LilyPond @w{@versionStable{}}
 217 Procesando `prueba.ly'
 218 Analizando...
 219 Interpretando la música...
 220 Preprocesando los objetos gráficos...
 221 Buscando el número de páginas ideal...
 222 Disponiendo la música en 1 página...
 223 Dibujando los sistemas...
 224 Escribiendo la página de salida en `prueba.ps'...
 225 Convirtiendo a `prueba.pdf'...
 226 Terminado: la compilación ha finalizado satisfactoriamente
 227 @end example
 228
 229 @subsubheading Paso 3: Examinar el resultado
 230
 231 Podemos ver o imprimir el archivo @file{prueba.pdf} resultante.
 232
 233 @end macro
 234
 235