1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
4 Translation of GIT committish: 88cfc9ee61dece9cffff98ab7f10318633698c39
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
237 LilyPond emplea letras minúsculas para las alturas. Las letras
238 desde @code{c} hasta@tie{}@code{b} denotan las alturas de las
239 notas de la @q{octava corta} por debajo del @notation{Do central}.
240 Los sufijos @code{'} (apóstrofo) o@tie{}@code{,} (coma) se añaden
241 para indicar octavas más agudas o más graves. A continuación se
242 muestra una escala que comienza en el @notation{Do central}, y un
245 @lilypond[verbatim,quote]
246 { c' d' e' f' g' a' b' c'' g c' e' g' c'' e'' g'' c''' }
249 La manera más sencilla de introducir las notas es mediante la
250 utilización del modo @code{\relative} (relativo). En este modo,
251 se elige la octava automáticamente bajo la suposición de que la
252 siguiente nota se colocará siempre lo más cerca de la nota actual,
253 es decir, se colocará en la octava comprendida dentro de hasta
254 tres espacios de pentagrama a partir de la nota anterior.
255 Comenzaremos por introducir el fragmento musical más elemental:
256 una @notation{escala}, donde cada nota está comprendida dentro de
257 tan sólo un espacio de pentagrama desde la nota anterior.
259 @lilypond[verbatim,quote]
266 La nota inicial, escrita como @code{c'}, es el @notation{Do
267 central}. Cada nota sucesiva se coloca lo más cerca posible de la
268 nota previa (en otras palabras: la primera @samp{c} es el Do más
269 cercano al Do central; a éste le sigue el Re más cercano a la nota
270 previa, y así sucesivamente). Podemos crear melodías con
271 intervalos mayores, aún sin dejar de utilizar el modo relativo:
273 @lilypond[verbatim,quote]
281 En el ejemplo anterior, la primera nota (@code{d'}, con un
282 apóstrofo) es el Re que está en la octava que va del Do central al
285 Añadiendo (o eliminando) comillas simples @code{'} o comas
286 @code{,} a la primera nota, podemos cambiar la octava de inicio:
288 @lilypond[verbatim,quote]
294 Al principio, el modo relativo puede resultar algo confuso, pero
295 es la forma más sencilla de introducir la mayor parte de las
296 melodías. Veamos cómo funciona en la práctica este cálculo
297 relativo. Comenzando por Si, que está situado en la línea central
298 en clave de Sol, podemos alcanzar Do, Re y Mi dentro de los tres
299 espacios de pentagrama hacia arriba, y La, Sol y Fa dentro de los
300 tres espacios hacia abajo. Por tanto, si la nota siguiente a Si
301 es Do, Re o Mi se supondrá que está por encima del Si, mientras
302 que La, Sol o Fa se entenderán situados por debajo.
305 @lilypond[verbatim,quote]
307 b' c % el Do está un espacio por encima, es el Do de arriba
308 b d % el Re está dos por encima ó 5 por debajo, es el Re de arriba
309 b e % el Mi está 3 por encima ó 4 por debajo, es el Mi de arriba
310 b a % el La está 6 por encima ó 1 por debajo, es el La de abajo
311 b g % el Sol está 5 por encima ó 2 por debajo, es el Sol de abajo
312 b f % el Fa está 4 por encima ó 3 por debajo, es el Fa de abajo
316 Lo mismo exactamente ocurre cuando cualquiera de esas notas llevan
317 un sostenido o un bemol. Las @notation{Alteraciones accidentales}
318 se @strong{ignoran totalmente} en el cálculo de la posición
319 relativa. Exactamente la misma cuenta de espacios de pentagrama
320 se hace a partir de una nota situada en cualquier otro lugar del
323 Para añadir intervalos mayores de tres espacios de pentagrama,
324 podemos elevar la @notation{octava} añadiendo una comilla simple
325 @code{'} (o apóstrofo) a continuación del nombre de la nota.
326 También podemos bajar la octava escribiendo una coma @code{,} a
327 continuación del nombre de la nota.
329 @lilypond[verbatim,quote]
337 Para subir o bajar una nota en dos (¡o más!) octavas, utilizamos
338 varias @code{''} ó @code{,,} (pero tenga cuidado de utilizar dos
339 comillas simples @code{''} ¡y no una comilla doble
341 @c " - keeps quotes in order for context-sensitive editor -td
343 @node Duraciones (valores rítmicos)
344 @unnumberedsubsubsec Duraciones (valores rítmicos)
345 @translationof Durations (rhythms)
347 @cindex duraciones de las notas
348 @cindex notas, duraciones de
353 @cindex figura con puntillo
355 @cindex notación de las duraciones
362 @rglos{quarter note},
365 La @notation{duración} de una nota se especifica mediante un
366 número después del nombre de la nota: @code{1} significa
367 @notation{redonda}, @code{2} significa @notation{blanca}, @code{4}
368 significa @notation{negra} y así sucesivamente. Las
369 @notation{barras de corchea} se añaden automáticamente.
371 Si no especifica una duración, se utiliza la duración previa para
372 la nota siguiente. La figura por omisión de la primera nota es
375 @lilypond[verbatim,quote]
379 a16 a a a a32 a a a a64 a a a a a a a a2
383 Para crear @notation{notas con puntillo}, añada un punto @code{.}
384 al número de la duración. La duración de una nota con puntillo se
385 debe especificar de forma explícita (es decir: mediante un
388 @lilypond[verbatim,quote]
396 @unnumberedsubsubsec Silencios
400 @cindex notación de los silencios
405 Un @notation{silencio} se introduce igual que si fuera una nota
406 con el nombre @code{r}@tie{}:
408 @lilypond[verbatim,quote]
416 @node Indicación de compás
417 @unnumberedsubsubsec Indicación de compás
418 @translationof Time signature
420 @cindex compás, indicación de
426 @rglos{time signature}.
428 La @notation{indicación de compás} se puede establecer con la
431 @lilypond[verbatim,quote]
442 @node Indicaciones de tempo
443 @unnumberedsubsubsec Indicaciones de tempo
444 @translationof Tempo marks
446 @cindex tempo, indicaciones de
447 @cindex metronómicas, indicaciones
453 @rglos{tempo indication},
456 La @notation{indicación de tempo} y la @notation{indicación
457 metronómica} pueden establecerse con la instrucción @code{\tempo}:
459 @lilypond[verbatim,quote]
468 \tempo "Presto" 4 = 120
475 @unnumberedsubsubsec Clave
479 @cindex sol, clave de
480 @cindex do en tercera, clave de
481 @cindex do en cuarta, clave de
494 La @notation{clave} se puede establecer utilizando la orden
497 @lilypond[verbatim,quote]
512 @unnumberedsubsubsec Todo junto
513 @translationof All together
515 He aquí un pequeño ejemplo que muestra todos los elementos
518 @lilypond[verbatim,quote]
522 \tempo "Andante" 4 = 120
532 Referencia de la notación:
533 @ruser{Escritura de notas},
534 @ruser{Escritura de las duraciones (valores rítmicos)},
535 @ruser{Escritura de silencios},
536 @ruser{Indicación de compás},
540 @node Trabajar sobre los archivos de entrada
541 @subsection Trabajar sobre los archivos de entrada
542 @translationof Working on input files
546 @cindex línea, comentario de
547 @cindex comentario de línea
548 @cindex bloque, comentario de
549 @cindex mayúsculas, sensible a
550 @cindex espacios, insensible a
554 @cindex número de versión
560 @funindex %@{ ... %@}
562 Los archivos de entrada de LilyPond son como los archivos fuente
563 de muchos lenguajes de programación corrientes. Contienen un
564 enunciado de versión, son sensibles a las mayúsculas y
565 generalmente los espacios se ignoran. Las expresiones se forman
566 con llaves @w{@code{@{ @}}} y los comentarios se denotan por un
567 signo de porcentaje (@code{%}) o por @w{@code{%@{ @dots{}
570 Si la frase anterior no tiene sentido para usted ¡no se preocupe!
571 A continuación explicaremos el significado de todos estos
577 @strong{Enunciado de la versión}: Todo archivo de LilyPond debe
578 contener un enunciado de versión. Un enunciado de versión es una
579 línea que describe la versión de LilyPond para la que se escribió
580 este archivo, como en el ejemplo siguiente:
583 \version "@w{@version{}}"
586 Por convenio, el enunciado de versión se coloca al principio del
589 El enunciado de versión es importante por dos motivos como mínimo.
590 En primer lugar, permite la actualización automática del código de
591 entrada conforme se va modificando la sintaxis de LilyPond. En
592 segundo lugar, indica la versión de LilyPond que se necesita para
595 Si no se escribe ningún enunciado de versión en el archivo de
596 entrada, LilyPond imprime una advertencia durante la compilación
600 @strong{Sensible a las mayúsculas}: tiene importancia el hecho de
601 que introduzca una letra en minúsculas (p.ej. @w{@code{a, b, s, t}})
602 o en mayúsculas (p.ej. @w{@code{A, B, S, T}}). Las notas son
603 minúsculas: @w{@samp{@{ c d e @}}} es una entrada válida;
604 @w{@samp{@{ C D E @}}} produciría un mensaje de error.
607 @strong{Insensible al número de espacios}: no importa cuántos
608 espacios (o saltos de línea o de tabulación) añada.
609 @w{@samp{@{ c4 d e @}}} significa lo mismo que
610 @w{@samp{@{ c4 @tie{} @tie{} @tie{} d e @}}} y que
618 Por supuesto, el ejemplo anterior es difícil de leer. Una regla
619 práctica es sangrar los bloques de código con un carácter de
620 tabulación, o bien con dos espacios:
628 Sin embargo, @emph{sí} se necesitan espacios para separar muchos
629 elementos sintácticos unos de otros. En otras palabras, los
630 espacios se pueden siempre @emph{añadir}, pero no siempre
631 @emph{eliminar}. Dado que la falta de espacios puede dar lugar a
632 extraños errores, recomendamos insertar espacios siempre antes y
633 después de cualquier elemento sintáctico, por ejemplo, antes y
634 después de las llaves.
637 @strong{Expresiones:} Todo fragmento de código de entrada para
638 LilyPond ha de llevar @strong{@{@tie{}llaves@tie{}@}} antes y
639 después de la entrada. Estas llaves le dicen a LilyPond que la
640 entrada es una expresión musical unitaria, igual que los
641 paréntesis @samp{()} de las matemáticas. Las llaves deben ir
642 rodeadas de un espacio a no ser que se encuentren al comienzo o al
643 final de una línea, para evitar cualquier ambigüedad.
645 Una instrucción de LilyPond seguida de una expresión simple entre
646 llaves (como por ejemplo @q{@w{@code{@bs{}relative @{ @dots{}
647 @}}}}) también es una expresión musical unitaria.
650 @cindex comentario de línea
651 @cindex comentario de bloque
653 @strong{Comentarios}: Un comentario es una nota para el lector
654 humano de la entrada musical; se ignora cuando esta entrada se
655 analiza, de manera que no tiene ningún efecto sobre la salida
656 impresa. Existen dos tipos de comentarios. El símbolo de
657 porcentaje @samp{%} introduce un comentario de línea; todo lo que
658 se encuentra después de @samp{%} en esa línea se ignora. Por
659 convenio, una línea de comentario se coloca @emph{por encima} del
660 código a que se refiere el comentario.
664 % este comentario se refiere a las notas Si
668 Un comentario de bloque marca una sección entera de entrada
669 musical como comentario. Todo lo que está encerrado dentro de
670 @code{%@{} y @code{%@}} se ignora (pero los comentarios no pueden
671 anidarse, lo que significa que un comentario de bloque no puede
672 incluir otros comentarios de bloque). Si lo hiciera, el primer
673 @code{%@}} daría por terminado @emph{los dos} comentarios de
674 bloque. El siguiente fragmento muestra algunos posibles usos para
678 % a continuación van las notas de campanitas del lugar
682 Esta línea y las notas que aparecen más abajo
683 se ignoran, por estar dentro de un
684 comentario de bloque.
693 @node Tratar con los errores
694 @section Tratar con los errores
695 @translationof Dealing with errors
697 @cindex depuración de errores
699 A veces, LilyPond no produce el resultado esperado. Esta sección
700 aporta algunos enlaces para ayudarle a resolver los problemas que
704 * Consejos generales de solución de problemas::
705 * Algunos errores comunes::
708 @node Consejos generales de solución de problemas
709 @subsection Consejos generales de solución de problemas
710 @translationof General troubleshooting tips
712 La solución de problemas en LilyPond puede ser un desafío para las
713 personas acostumbradas a los interfaces gráficos, porque es
714 posible crear archivos de entrada inválidos. Cuando esto ocurre,
715 la mejor forma de identificar y resolver el problema es aplicar un
716 enfoque lógico. Se dan algunas guías para ayudarle a aprender a
717 hacerlo, en @rprogram{Solución de problemas}.
720 @node Algunos errores comunes
721 @subsection Algunos errores comunes
722 @translationof Some common errors
724 @cindex comunes, errores
725 @cindex errores comunes
727 Existen algunos errores comunes que son difíciles de solucionar si
728 nos basamos solamente en los mensajes de error que se nos
729 presentan. Éstos se describen en @rprogram{Errores comunes}.
732 @node Cómo leer los manuales
733 @section Cómo leer los manuales
734 @translationof How to read the manuals
736 Esta sección muestra cómo leer la documentación de forma
737 eficiente, y presenta algunas interesantes funcionalidades
738 interactivas de la versión en línea.
742 * Ejemplos con enlace::
743 * Panorámica de los manuales::
747 @node Material omitido
748 @subsection Material omitido
749 @translationof Omitted material
752 @cindex cómo leer el manual
753 @cindex manual, lectura del
754 @cindex leer el manual
755 @cindex ejemplos, pulsar
756 @cindex pulsar sobre los ejemplos
757 @cindex consejos para construir archivos
759 @cindex construir archivos, consejos
760 @cindex archivos, consejos para construir
762 Como ya vimos en @ref{Trabajar sobre los archivos de entrada}, el
763 código de entrada de LilyPond debe estar rodeado de llaves
764 @code{@{ @}} o de @q{@w{@code{@bs{}relative @{ @dots{} @}}}}.
765 Durante el resto del presente manual, ciertos ejemplos breves
766 omitirán las llaves. Para reproducir estos ejemplos puede copiar
767 la entrada que se muestra, pero debe pegarla entre @code{@{} y
768 @code{@}} dentro del archivo de entrada.
772 @dots{}aquí va el ejemplo@dots{}
776 Asimismo, recuerde que todo archivo de LilyPond debe llevar un
777 enunciado @code{\version}. Dado que los ejemplos de los manuales
778 son fragmentos de código y no archivos completos, el enunciado
779 @code{\version} se omite. De todas formas, debemos acostumbrarnos
780 a incluirlo en nuestros documentos.
782 @node Ejemplos con enlace
783 @subsection Ejemplos con enlace
784 @translationof Clickable examples
786 @warning{Esta funcionalidad sólo está disponible en los manuales
789 Muchas personas aprenden a utilizar programas probando y enredando
790 con ellos. Esto también puede hacerse con LilyPond. Si hace clic
791 sobre una imagen en la versión en HTML de este manual, podrá ver
792 la entrada exacta de LilyPond que se utilizó para generar esa
793 imagen. Pruébelo sobre esta imagen:
799 c''4-\markup { \bold \huge { Haga clic aquí. } }
803 Cortando y pegando todo lo que se encuentra dentro de la sección
804 @qq{ly snippet} (fragmento de tipo ly), tendrá una plantilla
805 inicial para sus experimentos. Para poder ver exactamente el mismo
806 resultado (con igual anchura de línea y todo), copie todo lo que
807 está desde @qq{Start cut-&-pastable section} hasta el final del
814 @n ode Navegación con el teclado
815 @s ubsection Navegación con el teclado
816 @t ranslationof Keyboard navigation
818 @warning{Esta posibilidad sólo está disponible en los manuales en
821 @c TODO: once this is figured out, insert it here.
823 Estamos trabajando sobre esta funcionalidad.
826 @node Panorámica de los manuales
827 @subsection Panorámica de los manuales
828 @translationof Overview of manuals
830 Existe abundantísima documentación sobre LilyPond. Con
831 frecuencia, los nuevos usuarios se encuentran desorientados
832 respecto a qué parte o partes deben leer, y ocasionalmente pasan
833 por alto la lectura de partes de importancia vital.
835 @warning{Por favor: no se salte las partes importantes de la
836 documentación. Le resultará mucho más difícil comprender las
837 secciones subsiguientes.}
842 @strong{Antes de intentar hacer @emph{cualquier cosa}}: lea el
843 @ref{Tutorial} del manual de Aprendizaje, y la sección
844 @ref{Notación corriente}. Si encuentra términos musicales que no
845 reconoce, búsquelos en el @rglosnamed{Top, Glosario}.
848 @strong{Antes de tratar de escribir una pieza completa de música}:
849 lea la sección @ref{Conceptos fundamentales} del manual de
850 Aprendizaje. Después, le vendrá bien consultar las secciones
851 correspondientes de la @rusernamed{Top, Referencia de la
855 @strong{Antes de tratar de modificar los resultados
856 predeterminados}: lea la sección @ref{Trucar la salida} del manual
860 @strong{Antes de afrontar un proyecto grande}: lea la sección
861 @rprogramnamed{Suggestions for writing files,Sugerencias para
862 escribir archivos de entrada de LilyPond} del manual de
863 Utilización del programa.