1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
4 Translation of GIT committish: 09ef86c87175cc6c1071eedb022ed1d01a93bcaf
6 When revising a translation, copy the HEAD committish of the
7 version that you are working on. For details, see the Contributors'
8 Guide, node Updating translation committishes..
11 @include included/generating-output.itexi
17 @translationof Tutorial
19 Este capítulo ofrece una introducción básica al trabajo con
23 * Compilación del archivo::
24 * Cómo escribir archivos de entrada::
25 * Tratar con los errores::
26 * Cómo leer los manuales::
29 @node Compilación del archivo
30 @section Compilación del archivo
31 @translationof Compiling a file
33 Esta sección presenta el concepto de @qq{compilación}: el
34 procesamiento de los documentos de entrada de LilyPond (escritos
35 por uno mismo) para producir archivos de salida.
38 * Escritura del código de entrada::
44 @node Escritura del código de entrada
45 @subsection Escritura del código de entrada
46 @translationof Entering input
49 @cindex ejemplo inicial
50 @cindex inicial, ejemplo
51 @cindex mayúsculas, sensible a
54 * Generar el resultado::
57 @qq{Compilación} es una palabra que significa procesar un texto de
58 entrada en formato de LilyPond para producir un archivo que se
59 puede imprimir y (de manera opcional) un archivo MIDI que se puede
60 reproducir. El primer ejemplo muestra el aspecto de un sencillo
61 archivo de texto de entrada.
63 Este ejemplo muestra un archivo de entrada sencillo:
66 \version "@w{@version{}}"
72 El resultado tiene este aspecto:
74 @c in this case we don't want verbatim
81 @warning{la música y la letra escrita en el código de entrada de
82 LilyPond tiene que ir siempre entre @w{@strong{@{ llaves @}}}.
83 Las llaves deberían también estar rodeadas por espacios a no ser
84 que se encuentren al principio o al final de una línea, para
85 evitar ambigüedades. Es posible que se omitan en algunos ejemplos
86 del presente manual ¡pero no las omita en su propia música! Para
87 ver más información sobre la presentación de los ejemplos del
88 manual, consulte @ref{Cómo leer los manuales}.}
90 Además, la entrada de LilyPond es @strong{sensible a las
91 mayúsculas}. @w{@samp{ @{ c d e @}}} es una entrada válida;
92 @w{@samp{@{ C D E @}}} produce un mensaje de error.
96 @node Generar el resultado
97 @unnumberedsubsubsec Generar el resultado
98 @translationof Producing output
101 @cindex ver la música
102 @cindex editores de texto
104 El método para producir un resultado impreso depende de nuestro
105 sistema operativo y del programa o programas que utilicemos.
111 @ref{MacOS X, @sourceimage{logo-macosx,,,}}
112 @ref{MacOS X, MacOS X} (gráfico)
115 @ref{Windows, @sourceimage{logo-windows,,,}}
116 @ref{Windows, Microsoft Windows} (gráfico)
119 @ref{Línea de órdenes, @sourceimage{logo-linux,,,}
120 @sourceimage{logo-freebsd,,,}
121 @sourceimage{logo-macosx,,,}
122 @sourceimage{logo-windows,,,}
124 @ref{Línea de órdenes, Todos los sistemas operativos} (consola)
128 Existen varios otros editores de texto con un apoyo específico a
129 la edición de texto de LilyPond. Para ver más información,
130 consulte @rweb{Entornos mejorados}.
132 @warning{La primera vez que ejecute LilyPond, tardará un minuto o
133 dos porque todas las tipografías del sistema han de ser analizadas
134 previamente. ¡Después de esto, LilyPond será mucho más rápido!}
140 @cindex ejecución de LilyPond bajo MacOS X
141 @cindex MacOS X, ejecución de LilyPond
149 @cindex ejecutar LilyPond bajo Windows
150 @cindex Windows, ejecutar LilyPond
155 @node Línea de órdenes
156 @subsection Línea de órdenes
157 @translationof Command-line
159 @cindex ejecución de LilyPond bajo Unix
160 @cindex Unix, ejecución de LilyPond
164 @node Cómo escribir archivos de entrada
165 @section Cómo escribir archivos de entrada
166 @translationof How to write input files
168 Esta sección presenta una parte de la sintaxis básica de LilyPond
169 como ayuda para que se inicie en la escritura de archivos de
173 * Notación sencilla::
174 * Trabajar sobre los archivos de entrada::
178 @node Notación sencilla
179 @subsection Notación sencilla
180 @translationof Simple notation
182 @cindex sencilla, notación
183 @cindex notación sencilla
187 * Duraciones (valores rítmicos)::
189 * Indicación de compás::
190 * Indicaciones de tempo::
195 LilyPond añadirá ciertos elementos de notación de manera
196 automática. En el siguiente ejemplo hemos especificado solamente
197 cuatro alturas, pero LilyPond ha añadido la clave, el compás y las
200 @lilypond[verbatim,quote]
207 Este comportamiento se puede modificar, pero en general estos
208 valores automáticos son adecuados.
212 @unnumberedsubsubsec Alturas
213 @translationof Pitches
217 @cindex relativo, modo
219 @cindex comilla simple
221 @cindex alteraciones y modo relativo
222 @cindex relativo, modo, alteraciones y
236 LilyPond emplea letras minúsculas para las alturas. Las letras
237 desde @code{c} hasta@tie{}@code{b} denotan las alturas de las
238 notas de la @q{octava corta} por debajo del @notation{Do central}.
239 Los sufijos @code{'} (apóstrofo) o@tie{}@code{,} (coma) se añaden
240 para indicar octavas más agudas o más graves. A continuación se
241 muestra una escala que comienza en el @notation{Do central}, y un
244 @lilypond[verbatim,quote]
245 { c' d' e' f' g' a' b' c'' g c' e' g' c'' e'' g'' c''' }
248 La manera más sencilla de introducir las notas es mediante la
249 utilización del modo @code{\relative} (relativo). En este modo,
250 se elige la octava automáticamente bajo la suposición de que la
251 siguiente nota se colocará siempre lo más cerca de la nota actual,
252 es decir, se colocará en la octava comprendida dentro de hasta
253 tres espacios de pentagrama a partir de la nota anterior.
254 Comenzaremos por introducir el fragmento musical más elemental:
255 una @notation{escala}, donde cada nota está comprendida dentro de
256 tan sólo un espacio de pentagrama desde la nota anterior.
258 @lilypond[verbatim,quote]
265 La nota inicial, escrita como @code{c'}, es el @notation{Do
266 central}. Cada nota sucesiva se coloca lo más cerca posible de la
267 nota previa (en otras palabras: la primera @samp{c} es el Do más
268 cercano al Do central; a éste le sigue el Re más cercano a la nota
269 previa, y así sucesivamente). Podemos crear melodías con
270 intervalos mayores, aún sin dejar de utilizar el modo relativo:
272 @lilypond[verbatim,quote]
280 En el ejemplo anterior, la primera nota (@code{d'}, con un
281 apóstrofo) es el Re que está en la octava que va del Do central al
284 Añadiendo (o eliminando) comillas simples @code{'} o comas
285 @code{,} a la primera nota, podemos cambiar la octava de inicio:
287 @lilypond[verbatim,quote]
293 Al principio, el modo relativo puede resultar algo confuso, pero
294 es la forma más sencilla de introducir la mayor parte de las
295 melodías. Veamos cómo funciona en la práctica este cálculo
296 relativo. Comenzando por Si, que está situado en la línea central
297 en clave de Sol, podemos alcanzar Do, Re y Mi dentro de los tres
298 espacios de pentagrama hacia arriba, y La, Sol y Fa dentro de los
299 tres espacios hacia abajo. Por tanto, si la nota siguiente a Si
300 es Do, Re o Mi se supondrá que está por encima del Si, mientras
301 que La, Sol o Fa se entenderán situados por debajo.
304 @lilypond[verbatim,quote]
306 b' c % el Do está un espacio por encima, es el Do de arriba
307 b d % el Re está dos por encima ó 5 por debajo, es el Re de arriba
308 b e % el Mi está 3 por encima ó 4 por debajo, es el Mi de arriba
309 b a % el La está 6 por encima ó 1 por debajo, es el La de abajo
310 b g % el Sol está 5 por encima ó 2 por debajo, es el Sol de abajo
311 b f % el Fa está 4 por encima ó 3 por debajo, es el Fa de abajo
315 Lo mismo exactamente ocurre cuando cualquiera de esas notas llevan
316 un sostenido o un bemol. Las @notation{Alteraciones accidentales}
317 se @strong{ignoran totalmente} en el cálculo de la posición
318 relativa. Exactamente la misma cuenta de espacios de pentagrama
319 se hace a partir de una nota situada en cualquier otro lugar del
322 Para añadir intervalos mayores de tres espacios de pentagrama,
323 podemos elevar la @notation{octava} añadiendo una comilla simple
324 @code{'} (o apóstrofo) a continuación del nombre de la nota.
325 También podemos bajar la octava escribiendo una coma @code{,} a
326 continuación del nombre de la nota.
328 @lilypond[verbatim,quote]
336 Para subir o bajar una nota en dos (¡o más!) octavas, utilizamos
337 varias @code{''} ó @code{,,} (pero tenga cuidado de utilizar dos
338 comillas simples @code{''} ¡y no una comilla doble
340 @c " - keeps quotes in order for context-sensitive editor -td
342 @node Duraciones (valores rítmicos)
343 @unnumberedsubsubsec Duraciones (valores rítmicos)
344 @translationof Durations (rhythms)
346 @cindex duraciones de las notas
347 @cindex notas, duraciones de
352 @cindex figura con puntillo
354 @cindex notación de las duraciones
361 @rglos{quarter note},
364 La @notation{duración} de una nota se especifica mediante un
365 número después del nombre de la nota: @code{1} significa
366 @notation{redonda}, @code{2} significa @notation{blanca}, @code{4}
367 significa @notation{negra} y así sucesivamente. Las
368 @notation{barras de corchea} se añaden automáticamente.
370 Si no especifica una duración, se utiliza la duración previa para
371 la nota siguiente. La figura por omisión de la primera nota es
374 @lilypond[verbatim,quote]
378 a16 a a a a32 a a a a64 a a a a a a a a2
382 Para crear @notation{notas con puntillo}, añada un punto @code{.}
383 al número de la duración. La duración de una nota con puntillo se
384 debe especificar de forma explícita (es decir: mediante un
387 @lilypond[verbatim,quote]
395 @unnumberedsubsubsec Silencios
399 @cindex notación de los silencios
404 Un @notation{silencio} se introduce igual que si fuera una nota
405 con el nombre @code{r}@tie{}:
407 @lilypond[verbatim,quote]
415 @node Indicación de compás
416 @unnumberedsubsubsec Indicación de compás
417 @translationof Time signature
419 @cindex compás, indicación de
424 @rglos{time signature}.
426 La @notation{indicación de compás} se puede establecer con la
429 @lilypond[verbatim,quote]
440 @node Indicaciones de tempo
441 @unnumberedsubsubsec Indicaciones de tempo
442 @translationof Tempo marks
444 @cindex tempo, indicaciones de
445 @cindex metronómicas, indicaciones
450 @rglos{tempo indication},
453 La @notation{indicación de tempo} y la @notation{indicación
454 metronómica} pueden establecerse con la instrucción @code{\tempo}:
456 @lilypond[verbatim,quote]
465 \tempo "Presto" 4 = 120
472 @unnumberedsubsubsec Clave
476 @cindex sol, clave de
477 @cindex do en tercera, clave de
478 @cindex do en cuarta, clave de
490 La @notation{clave} se puede establecer utilizando la orden
493 @lilypond[verbatim,quote]
508 @unnumberedsubsubsec Todo junto
509 @translationof All together
511 He aquí un pequeño ejemplo que muestra todos los elementos
514 @lilypond[verbatim,quote]
518 \tempo "Andante" 4 = 120
528 Referencia de la notación:
529 @ruser{Escritura de notas},
530 @ruser{Escritura de las duraciones (valores rítmicos)},
531 @ruser{Escritura de silencios},
532 @ruser{Indicación de compás},
536 @node Trabajar sobre los archivos de entrada
537 @subsection Trabajar sobre los archivos de entrada
538 @translationof Working on input files
542 @cindex línea, comentario de
543 @cindex comentario de línea
544 @cindex bloque, comentario de
545 @cindex mayúsculas, sensible a
546 @cindex espacios, insensible a
550 @cindex número de versión
556 @funindex %@{ ... %@}
558 Los archivos de entrada de LilyPond son como los archivos fuente
559 de muchos lenguajes de programación corrientes. Contienen un
560 enunciado de versión, son sensibles a las mayúsculas y
561 generalmente los espacios se ignoran. Las expresiones se forman
562 con llaves @w{@code{@{ @}}} y los comentarios se denotan por un
563 signo de porcentaje (@code{%}) o por @w{@code{%@{ @dots{}
566 Si la frase anterior no tiene sentido para usted ¡no se preocupe!
567 A continuación explicaremos el significado de todos estos
573 @strong{Enunciado de la versión}: Todo archivo de LilyPond debe
574 contener un enunciado de versión. Un enunciado de versión es una
575 línea que describe la versión de LilyPond para la que se escribió
576 este archivo, como en el ejemplo siguiente:
579 \version "@w{@version{}}"
582 Por convenio, el enunciado de versión se coloca al principio del
585 El enunciado de versión es importante por dos motivos como mínimo.
586 En primer lugar, permite la actualización automática del código de
587 entrada conforme se va modificando la sintaxis de LilyPond. En
588 segundo lugar, indica la versión de LilyPond que se necesita para
591 Si no se escribe ningún enunciado de versión en el archivo de
592 entrada, LilyPond imprime una advertencia durante la compilación
596 @strong{Sensible a las mayúsculas}: tiene importancia el hecho de
597 que introduzca una letra en minúsculas (p.ej. @w{@code{a, b, s, t}})
598 o en mayúsculas (p.ej. @w{@code{A, B, S, T}}). Las notas son
599 minúsculas: @w{@samp{@{ c d e @}}} es una entrada válida;
600 @w{@samp{@{ C D E @}}} produciría un mensaje de error.
603 @strong{Insensible al número de espacios}: no importa cuántos
604 espacios (o saltos de línea o de tabulación) añada.
605 @w{@samp{@{ c4 d e @}}} significa lo mismo que
606 @w{@samp{@{ c4 @tie{} @tie{} @tie{} d e @}}} y que
614 Por supuesto, el ejemplo anterior es difícil de leer. Una regla
615 práctica es sangrar los bloques de código con un carácter de
616 tabulación, o bien con dos espacios:
624 Sin embargo, @emph{sí} se necesitan espacios para separar muchos
625 elementos sintácticos unos de otros. En otras palabras, los
626 espacios se pueden siempre @emph{añadir}, pero no siempre
627 @emph{eliminar}. Dado que la falta de espacios puede dar lugar a
628 extraños errores, recomendamos insertar espacios siempre antes y
629 después de cualquier elemento sintáctico, por ejemplo, antes y
630 después de las llaves.
633 @strong{Expresiones:} Todo fragmento de código de entrada para
634 LilyPond ha de llevar @strong{@{@tie{}llaves@tie{}@}} antes y
635 después de la entrada. Estas llaves le dicen a LilyPond que la
636 entrada es una expresión musical unitaria, igual que los
637 paréntesis @samp{()} de las matemáticas. Las llaves deben ir
638 rodeadas de un espacio a no ser que se encuentren al comienzo o al
639 final de una línea, para evitar cualquier ambigüedad.
641 Una instrucción de LilyPond seguida de una expresión simple entre
642 llaves (como por ejemplo @q{@w{@code{@bs{}relative @{ @dots{}
643 @}}}}) también es una expresión musical unitaria.
646 @cindex comentario de línea
647 @cindex comentario de bloque
649 @strong{Comentarios}: Un comentario es una nota para el lector
650 humano de la entrada musical; se ignora cuando esta entrada se
651 analiza, de manera que no tiene ningún efecto sobre la salida
652 impresa. Existen dos tipos de comentarios. El símbolo de
653 porcentaje @samp{%} introduce un comentario de línea; todo lo que
654 se encuentra después de @samp{%} en esa línea se ignora. Por
655 convenio, una línea de comentario se coloca @emph{por encima} del
656 código a que se refiere el comentario.
660 % este comentario se refiere a las notas Si
664 Un comentario de bloque marca una sección entera de entrada
665 musical como comentario. Todo lo que está encerrado dentro de
666 @code{%@{} y @code{%@}} se ignora (pero los comentarios no pueden
667 anidarse, lo que significa que un comentario de bloque no puede
668 incluir otros comentarios de bloque). Si lo hiciera, el primer
669 @code{%@}} daría por terminado @emph{los dos} comentarios de
670 bloque. El siguiente fragmento muestra algunos posibles usos para
674 % a continuación van las notas de campanitas del lugar
678 Esta línea y las notas que aparecen más abajo
679 se ignoran, por estar dentro de un
680 comentario de bloque.
689 @node Tratar con los errores
690 @section Tratar con los errores
691 @translationof Dealing with errors
693 @cindex depuración de errores
695 A veces, LilyPond no produce el resultado esperado. Esta sección
696 aporta algunos enlaces para ayudarle a resolver los problemas que
700 * Consejos generales de solución de problemas::
701 * Algunos errores comunes::
704 @node Consejos generales de solución de problemas
705 @subsection Consejos generales de solución de problemas
706 @translationof General troubleshooting tips
708 La solución de problemas en LilyPond puede ser un desafío para las
709 personas acostumbradas a los interfaces gráficos, porque es
710 posible crear archivos de entrada inválidos. Cuando esto ocurre,
711 la mejor forma de identificar y resolver el problema es aplicar un
712 enfoque lógico. Se dan algunas guías para ayudarle a aprender a
713 hacerlo, en @rprogram{Solución de problemas}.
716 @node Algunos errores comunes
717 @subsection Algunos errores comunes
718 @translationof Some common errors
720 @cindex comunes, errores
721 @cindex errores comunes
723 Existen algunos errores comunes que son difíciles de solucionar si
724 nos basamos solamente en los mensajes de error que se nos
725 presentan. Éstos se describen en @rprogram{Errores comunes}.
728 @node Cómo leer los manuales
729 @section Cómo leer los manuales
730 @translationof How to read the manuals
732 Esta sección muestra cómo leer la documentación de forma
733 eficiente, y presenta algunas interesantes funcionalidades
734 interactivas de la versión en línea.
738 * Ejemplos con enlace::
739 * Panorámica de los manuales::
743 @node Material omitido
744 @subsection Material omitido
745 @translationof Omitted material
748 @cindex cómo leer el manual
749 @cindex manual, lectura del
750 @cindex leer el manual
751 @cindex ejemplos, pulsar
752 @cindex pulsar sobre los ejemplos
753 @cindex consejos para construir archivos
755 @cindex construir archivos, consejos
756 @cindex archivos, consejos para construir
758 Como ya vimos en @ref{Trabajar sobre los archivos de entrada}, el
759 código de entrada de LilyPond debe estar rodeado de llaves
760 @code{@{ @}} o de @q{@w{@code{@bs{}relative @{ @dots{} @}}}}.
761 Durante el resto del presente manual, ciertos ejemplos breves
762 omitirán las llaves. Para reproducir estos ejemplos puede copiar
763 la entrada que se muestra, pero debe pegarla entre @code{@{} y
764 @code{@}} dentro del archivo de entrada.
768 @dots{}aquí va el ejemplo@dots{}
772 Asimismo, recuerde que todo archivo de LilyPond debe llevar un
773 enunciado @code{\version}. Dado que los ejemplos de los manuales
774 son fragmentos de código y no archivos completos, el enunciado
775 @code{\version} se omite. De todas formas, debemos acostumbrarnos
776 a incluirlo en nuestros documentos.
778 @node Ejemplos con enlace
779 @subsection Ejemplos con enlace
780 @translationof Clickable examples
782 @warning{Esta funcionalidad sólo está disponible en los manuales
785 Muchas personas aprenden a utilizar programas probando y enredando
786 con ellos. Esto también puede hacerse con LilyPond. Si hace clic
787 sobre una imagen en la versión en HTML de este manual, podrá ver
788 la entrada exacta de LilyPond que se utilizó para generar esa
789 imagen. Pruébelo sobre esta imagen:
795 c''4-\markup { \bold \huge { Haga clic aquí. } }
799 Cortando y pegando todo lo que se encuentra dentro de la sección
800 @qq{ly snippet} (fragmento de tipo ly), tendrá una plantilla
801 inicial para sus experimentos. Para poder ver exactamente el mismo
802 resultado (con igual anchura de línea y todo), copie todo lo que
803 está desde @qq{Start cut-&-pastable section} hasta el final del
810 @n ode Navegación con el teclado
811 @s ubsection Navegación con el teclado
812 @t ranslationof Keyboard navigation
814 @warning{Esta posibilidad sólo está disponible en los manuales en
817 @c TODO: once this is figured out, insert it here.
819 Estamos trabajando sobre esta funcionalidad.
822 @node Panorámica de los manuales
823 @subsection Panorámica de los manuales
824 @translationof Overview of manuals
826 Existe abundantísima documentación sobre LilyPond. Con
827 frecuencia, los nuevos usuarios se encuentran desorientados
828 respecto a qué parte o partes deben leer, y ocasionalmente pasan
829 por alto la lectura de partes de importancia vital.
831 @warning{Por favor: no se salte las partes importantes de la
832 documentación. Le resultará mucho más difícil comprender las
833 secciones subsiguientes.}
838 @strong{Antes de intentar hacer @emph{cualquier cosa}}: lea el
839 @ref{Tutorial} del manual de Aprendizaje, y la sección
840 @ref{Notación corriente}. Si encuentra términos musicales que no
841 reconoce, búsquelos en el @rglosnamed{Top, Glosario}.
844 @strong{Antes de tratar de escribir una pieza completa de música}:
845 lea la sección @ref{Conceptos fundamentales} del manual de
846 Aprendizaje. Después, le vendrá bien consultar las secciones
847 correspondientes de la @rusernamed{Top, Referencia de la
851 @strong{Antes de tratar de modificar los resultados
852 predeterminados}: lea la sección @ref{Trucar la salida} del manual
856 @strong{Antes de afrontar un proyecto grande}: lea la sección
857 @rprogramnamed{Suggestions for writing files,Sugerencias para
858 escribir archivos de entrada de LilyPond} del manual de
859 Utilización del programa.