1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
4 Translation of GIT committish: 10bd5cc93870ac4b884b8cb938cfc6a19c768097
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 LilyPond.
22 * Compilación del archivo::
23 * Cómo escribir archivos de entrada::
24 * Tratar con los errores::
25 * Cómo leer los manuales::
28 @node Compilación del archivo
29 @section Compilación del archivo
30 @translationof Compiling a file
32 Esta sección presenta el concepto de @qq{compilación}: el
33 procesamiento de los documentos de entrada de LilyPond (escritos por
34 uno mismo) para producir archivos de salida.
37 * Escritura del código de entrada::
43 @node Escritura del código de entrada
44 @subsection Escritura del código de entrada
45 @translationof Entering input
48 @cindex ejemplo inicial
49 @cindex inicial, ejemplo
50 @cindex mayúsculas, sensible a
52 @qq{Compilación} es una palabra que significa procesar un texto de
53 entrada en formato de LilyPond para producir un archivo que se puede
54 imprimir y (de manera opcional) un archivo MIDI que se puede
55 reproducir. El primer ejemplo muestra el aspecto de un sencillo
56 archivo de texto de entrada.
58 Este ejemplo muestra un archivo de entrada sencillo:
61 \version "@w{@version{}}"
67 El resultado tiene este aspecto:
69 @c in this case we don't want verbatim
76 @warning{la música y la letra escrita en el código de entrada de
77 LilyPond tiene que ir siempre entre @w{@strong{@{ llaves @}}}. Las llaves
78 deberían también estar rodeadas por espacios a no ser que se
79 encuentren al principio o al final de una línea, para evitar
80 ambigüedades. Es posible que se omitan en algunos ejemplos del
81 presente manual ¡pero no las omita en su propia música! Para ver más
82 información sobre la presentación de los ejemplos del manual, consulte
83 @ref{Cómo leer los manuales}.}
85 Además, la entrada de LilyPond es @strong{sensible a las mayúsculas}.
86 @w{@samp{ @{ c d e @}}} es una entrada válida; @w{@samp{@{ C D E @}}} produce
91 @subheading Generar el resultado
95 @cindex editores de texto
97 El método para producir un resultado impreso depende de snuestro
98 sistema operativo y del programa o programas que utilicemos.
104 @ref{MacOS X, @sourceimage{logo-macosx,,,}}
105 @ref{MacOS X, MacOS X} (gráfico)
108 @ref{Windows, @sourceimage{logo-windows,,,}}
109 @ref{Windows, Microsoft Windows} (gráfico)
112 @ref{Línea de órdenes, @sourceimage{logo-linux,,,}
113 @sourceimage{logo-freebsd,,,}
114 @sourceimage{logo-macosx,,,}
115 @sourceimage{logo-windows,,,}
117 @ref{Línea de órdenes, Todos los sistemas operativos} (consola)
121 Existen varios otros editores de texto con un apoyo específico a la
122 edición de texto de LilyPond. Para ver más información, consulte
123 @rweb{Entornos mejorados}.
125 @warning{La primera vez que ejecute LilyPond, tardará un minuto o dos
126 porque todas las tipografías del sistema han de ser analizadas
127 previamente. ¡Después de esto, LilyPond será mucho más rápido!}
133 @cindex ejecución de LilyPond bajo MacOS X
134 @cindex MacOS X, ejecución de LilyPond
142 @cindex ejecutar LilyPond bajo Windows
143 @cindex Windows, ejecutar LilyPond
148 @node Línea de órdenes
149 @subsection Línea de órdenes
150 @translationof Command-line
152 @cindex ejecución de LilyPond bajo Unix
153 @cindex Unix, ejecución de LilyPond
157 @node Cómo escribir archivos de entrada
158 @section Cómo escribir archivos de entrada
159 @translationof How to write input files
161 Esta sección presenta una parte de la sintaxis básica de LilyPond como
162 ayuda para que se inicie en la escritura de archivos de entrada.
165 * Notación sencilla::
166 * Trabajar sobre los archivos de entrada::
170 @node Notación sencilla
171 @subsection Notación sencilla
172 @translationof Simple notation
174 @cindex sencilla, notación
175 @cindex notación sencilla
177 LilyPond añadirá ciertos elementos de notación de manera automática.
178 En el siguiente ejemplo hemos especificado solamente cuatro alturas,
179 pero LilyPond ha añadido la clave, el compás y las duraciones.
181 @lilypond[verbatim,quote]
188 Este comportamiento se puede modificar, pero en general estos valores
189 automáticos son adecuados.
196 @cindex relativo, modo
198 @cindex comilla simple
200 @cindex alteraciones y modo relativo
201 @cindex relativo, modo, alteraciones y
216 La manera más sencilla de introducir las notas es mediante la
217 utilización del modo @code{\relative} (relativo). En este modo, se
218 elige la octava automáticamente bajo la suposición de que la siguiente
219 nota se colocará siempre lo más cerca de la nota actual, es decir, se
220 colocará en la octava comprendida dentro de hasta tres espacios de
221 pentagrama a partir de la nota anterior. Comenzaremos por introducir
222 el fragmento musical más elemental: una @notation{escala}, donde cada
223 nota está comprendida dentro de tan sólo un espacio de pentagrama
224 desde la nota anterior.
226 @lilypond[verbatim,quote]
227 % set the starting point to middle C
234 La nota inicial es el @notation{Do central}. Cada nota sucesiva se
235 coloca lo más cerca posible de la nota previa (en otras palabras: la
236 primera @samp{c} es el Do más cercano al Do central; a éste le sigue
237 el Re más cercano a la nota previa, y así sucesivamente). Podemos
238 crear melodías con intervalos mayores, aún sin dejar de utilizar el
241 @lilypond[verbatim,quote]
249 No es necesario que la primera nota de la melodía comience exactamente
250 en aquella que especifica la altura de inicio. En el ejemplo
251 anterior, la primera nota (@code{d}) es el Re más cercano al Do
254 Añadiendo (o eliminando) comillas simples @code{'} o comas @code{,} a
255 la instrucción @q{@w{@code{@bs{}\relative c'}}}, podemos cambiar la octava
259 @lilypond[verbatim,quote]
260 % una octava por encima del Do central
266 Al principio, el modo relativo puede resultar algo confuso, pero es la
267 forma más sencilla de introducir la mayor parte de las melodías.
268 Veamos cómo funciona en la práctica este cálculo relativo. Comenzando
269 por Si, que está situado en la línea central en clave de Sol, podemos
270 alcanzar Do, Re y Mi dentro de los tres espacios de pentagrama hacia
271 arriba, y La, Sol y Fa dentro de los tres espacios hacia abajo. Por
272 tanto, si la nota siguiente a Si es Do, Re o Mi se supondrá que está
273 por encima del Si, mientras que La, Sol o Fa se entenderán situados
277 @lilypond[verbatim,quote]
279 b c % el Do está un espacio por encima, es el Do de arriba
280 b d % el Re está dos por encima ó 5 por debajo, es el Re de arriba
281 b e % el Mi está 3 por encima ó 4 por debajo, es el Mi de arriba
282 b a % el La está 6 por encima ó 1 por debajo, es el La de abajo
283 b g % el Sol está 5 por encima ó 2 por debajo, es el Sol de abajo
284 b f % el Fa está 4 por encima ó 3 por debajo, es el Fa de abajo
288 Lo mismo exactamente ocurre cuando cualquiera de esas notas llevan un
289 sostenido o un bemol. Las @notation{Alteraciones accidentales} se
290 @strong{ignoran totalmente} en el cálculo de la posición relativa.
291 Exactamente la misma cuenta de espacios de pentagrama se hace a partir
292 de una nota situada en cualquier otro lugar del mismo.
294 Para añadir intervalos mayores de tres espacios de pentagrama, podemos
295 elevar la @notation{octava} añadiendo una comilla simple @code{'} (o
296 apóstrofo) a continuación del nombre de la nota. También podemos
297 bajar la octava escribiendo una coma @code{,} a continuación del
300 @lilypond[verbatim,quote]
308 Para subir o bajar una nota en dos (¡o más!) octavas, utilizamos
309 varias @code{''} ó @code{,,} (pero tenga cuidado de utilizar dos
310 comillas simples @code{''} ¡y no una comilla doble @code{"}@tie{}!)
311 @c " - keeps quotes in order for context-sensitive editor -td
313 @subheading Duraciones (valores rítmicos)
315 @cindex duraciones de las notas
316 @cindex notas, duraciones de
321 @cindex figura con puntillo
323 @cindex notación de las duraciones
330 @rglos{quarter note},
333 La @notation{duración} de una nota se especifica mediante un número
334 después del nombre de la nota: @code{1} significa @notation{redonda},
335 @code{2} significa @notation{blanca}, @code{4} significa
336 @notation{negra} y así sucesivamente. Las @notation{barras de
337 corchea} se añaden automáticamente.
339 Si no especifica una duración, se utiliza la duración previa para la
340 nota siguiente. La figura por omisión de la primera nota es una
343 @lilypond[verbatim,quote]
347 a16 a a a a32 a a a a64 a a a a a a a a2
351 Para crear @notation{notas con puntillo}, añada un punto @code{.} al
352 número de la duración. La duración de una nota con puntillo se debe
353 especificar de forma explícita (es decir: mediante un número).
355 @lilypond[verbatim,quote]
363 @subheading Silencios
366 @cindex notación de los silencios
371 Un @notation{silencio} se introduce igual que si fuera una nota con el
372 nombre @code{r}@tie{}:
374 @lilypond[verbatim,quote]
382 @subheading Indicación de compás
384 @cindex compás, indicación de
390 @rglos{time signature}.
392 La @notation{indicación de compás} se puede establecer con la orden
395 @lilypond[verbatim,quote]
406 @subheading Indicaciones de tempo
408 @cindex tempo, indicaciones de
409 @cindex metronómicas, indicaciones
415 @rglos{tempo indication},
418 La @notation{indicación de tempo} y la @notation{indicación
419 metronómica} pueden establecerse con la instrucción @code{\tempo}:
421 @lilypond[verbatim,quote]
430 \tempo "Presto" 4 = 120
439 @cindex sol, clave de
440 @cindex do en tercera, clave de
441 @cindex do en cuarta, clave de
454 La @notation{clave} se puede establecer utilizando la orden
457 @lilypond[verbatim,quote]
471 @subheading Todo junto
473 He aquí un pequeño ejemplo que muestra todos los elementos anteriores
476 @lilypond[verbatim,quote]
480 \tempo "Andante" 4 = 120
490 Referencia de la notación:
491 @ruser{Escritura de notas},
492 @ruser{Escritura de las duraciones (valores rítmicos)},
493 @ruser{Escritura de silencios},
494 @ruser{Indicación de compás},
498 @node Trabajar sobre los archivos de entrada
499 @subsection Trabajar sobre los archivos de entrada
500 @translationof Working on input files
504 @cindex línea, comentario de
505 @cindex comentario de línea
506 @cindex bloque, comentario de
507 @cindex mayúsculas, sensible a
508 @cindex espacios, insensible a
512 @cindex número de versión
518 @funindex %@{ ... %@}
520 Los archivos de entrada de LilyPond son como los archivos fuente de
521 muchos lenguajes de programación corrientes. Contienen un enunciado
522 de versión, son sensibles a las mayúsculas y generalmente los espacios
523 se ignoran. Las expresiones se forman con llaves @w{@code{@{ @}}} y los
524 comentarios se denotan por un signo de porcentaje (@code{%}) o por
525 @w{@code{%@{ @dots{} %@}}}@tie{}.
527 Si la frase anterior no tiene sentido para usted ¡no se preocupe! A
528 continuación explicaremos el significado de todos estos términos:
533 @strong{Enunciado de la versión}: Todo archivo de LilyPond debe
534 contener un enunciado de versión. Un enunciado de versión es una
535 línea que describe la versión de LilyPond para la que se escribió este
536 archivo, como en el ejemplo siguiente:
539 \version "@w{@version{}}"
542 Por convenio, el enunciado de versión se coloca al principio del
545 El enunciado de versión es importante por dos motivos como mínimo. En
546 primer lugar, permite la actualización automática del código de
547 entrada conforme se va modificando la sintaxis de LilyPond. En
548 segundo lugar, indica la versión de LilyPond que se necesita para
551 Si no se escribe ningún enunciado de versión en el archivo de entrada,
552 LilyPond imprime una advertencia durante la compilación del mismo.
555 @strong{Sensible a las mayúsculas}: tiene importancia el hecho de que
556 introduzca una letra en minúsculas (p.ej. @w{@code{a, b, s, t}}) o en
557 mayúsculas (p.ej. @w{@code{A, B, S, T}}). Las notas son minúsculas:
558 @w{@samp{@{ c d e @}}} es una entrada válida; @w{@samp{@{ C D E @}}}
559 produciría un mensaje de error.
562 @strong{Insensible al número de espacios}: no importa cuántos espacios
563 (o saltos de línea o de tabulación) añada.
564 @w{@samp{@{ c4 d e @}}} significa lo mismo que
565 @w{@samp{@{ c4 @tie{} @tie{} @tie{} d e @}}} y que
573 Por supuesto, el ejemplo anterior es difícil de leer. Una regla
574 práctica es sangrar los bloques de código con un carácter de
575 tabulación, o bien con dos espacios:
583 Sin embargo, @emph{sí} se necesitan espacios para separar muchos
584 elementos sintácticos unos de otros. En otras palabras, los espacios
585 se pueden siempre @emph{añadir}, pero no siempre @emph{eliminar}.
586 Dado que la falta de espacios puede dar lugar a extraños errores,
587 recomendamos insertar espacios siempre antes y después de cualquier
588 elemento sintáctico, por ejemplo, antes y después de las llaves.
591 @strong{Expresiones:} Todo fragmento de código de entrada para
592 LilyPond ha de llevar @strong{@{@tie{}llaves@tie{}@}} antes y después de la
593 entrada. Estas llaves le dicen a LilyPond que la entrada es una
594 expresión musical unitaria, igual que los paréntesis @samp{()} de las
595 matemáticas. Las llaves deben ir rodeadas de un espacio a no ser que
596 se encuentren al comienzo o al final de una línea, para evitar
597 cualquier ambigüedad.
599 Una instrucción de LilyPond seguida de una expresión simple entre
600 llaves (como por ejemplo @q{@w{@code{@bs{}relative c' @{ @dots{} @}}}}) también es una
601 expresión musical unitaria.
604 @cindex comentario de línea
605 @cindex comentario de bloque
607 @strong{Comentarios}: Un comentario es una nota para el lector humano
608 de la entrada musical; se ignora cuando esta entrada se analiza, de
609 manera que no tiene ningún efecto sobre la salida impresa. Existen
610 dos tipos de comentarios. El símbolo de porcentaje @samp{%} introduce
611 un comentario de línea; todo lo que se encuentra después de @samp{%}
612 en esa línea se ignora. Por convenio, una línea de comentario se
613 coloca @emph{por encima} del código a que se refiere el comentario.
617 % este comentario se refiere a las notas Si
621 Un comentario de bloque marca una sección entera de entrada musical
622 como comentario. Todo lo que está encerrado dentro de @code{%@{} y
623 @code{%@}} se ignora (pero los comentarios no pueden anidarse, lo que
624 significa que un comentario de bloque no puede incluir otros
625 comentarios de bloque). Si lo hiciera, el primer @code{%@}} daría por
626 terminado @emph{los dos} comentarios de bloque. El siguiente
627 fragmento muestra algunos posibles usos para los comentarios:
630 % a continuación van las notas de campanitas del lugar
634 Esta línea y las notas que aparecen más abajo
635 se ignoran, por estar dentro de un
636 comentario de bloque.
645 @node Tratar con los errores
646 @section Tratar con los errores
647 @translationof Dealing with errors
649 @cindex depuración de errores
651 A veces, LilyPond no produce el resultado esperado. Esta sección
652 aporta algunos enlaces para ayudarle a resolver los problemas que
656 * Consejos generales de solución de problemas::
657 * Algunos errores comunes::
660 @node Consejos generales de solución de problemas
661 @subsection Consejos generales de solución de problemas
662 @translationof General troubleshooting tips
664 La solución de problemas en LilyPond puede ser un desafío para las
665 personas acostumbradas a los interfaces gráficos, porque es posible
666 crear archivos de entrada inválidos. Cuando esto ocurre, la mejor
667 forma de identificar y resolver el problema es aplicar un enfoque
668 lógico. Se dan algunas guías para ayudarle a aprender a hacerlo, en
669 @rprogram{Solución de problemas}.
672 @node Algunos errores comunes
673 @subsection Algunos errores comunes
674 @translationof Some common errors
676 @cindex comunes, errores
677 @cindex errores comunes
679 Existen algunos errores comunes que son difíciles de solucionar si nos
680 basamos solamente en los mensajes de error que se nos presentan.
681 Éstos se describen en @rprogram{Errores comunes}.
684 @node Cómo leer los manuales
685 @section Cómo leer los manuales
686 @translationof How to read the manuals
688 Esta sección muestra cómo leer la documentación de forma eficiente, y
689 presenta algunas interesantes funcionalidades interactivas de la
694 * Ejemplos con enlace::
695 * Panorámica de los manuales::
699 @node Material omitido
700 @subsection Material omitido
701 @translationof Omitted material
704 @cindex cómo leer el manual
705 @cindex manual, lectura del
706 @cindex leer el manual
707 @cindex ejemplos, pulsar
708 @cindex pulsar sobre los ejemplos
709 @cindex consejos para construir archivos
711 @cindex construir archivos, consejos
712 @cindex archivos, consejos para construir
714 Como ya vimos en @ref{Trabajar sobre los archivos de entrada}, el
715 código de entrada de LilyPond debe estar rodeado de llaves @code{@{ @}} o de
716 @q{@w{@code{@bs{}relative c'' @{ @dots{} @}}}}. Durante el resto del presente
717 manual, la mayor parte de los ejemplos omitirán las llaves. Para
718 reproducir los ejemplos, deberá copiar y pegar la entrada que se
719 muestra, pero @strong{deberá} escribir el @q{@w{@code{@bs{}relative c'' @{ @dots{} @}}}},
720 de la siguiente forma:
724 @dots{}aquí va el ejemplo@dots{}
728 ¿Por qué omitir las llaves? Casi todos los ejemplos del presente
729 manual se pueden insertar en medio de un fragmento mayor de música.
730 Para estos ejemplos no tiene ningún sentido añadir
731 @q{@w{@code{@bs{}relative c'' @{ @dots{} @}}}}
732 (¡no debería poner un @code{\relative} dentro de otro
733 @code{\relative}!); si hubiésemos incluido
734 @q{@w{@code{@bs{}relative c'' @{ @dots{} @}}}}
735 rodeando a cada uno de los ejemplos, usted no podría copiar un
736 ejemplo pequeño procedente de la documentación y pegarlo dentro de su
737 propia pieza. La mayoría querrá insertar el código dentro de una
738 pieza más grande, por eso hemos formateado el manual de esta manera.
740 Asimismo, recuerde que todo archivo de LilyPond debe llevar un
741 enunciado @code{\version}. Dado que los ejemplos de los manuales
742 son fragmentos de código y no archivos completos, el enunciado
743 @code{\version} se omite. De todas formas, debemos acostumbrarnos
744 a incluirlo en nuestros documentos.
746 @node Ejemplos con enlace
747 @subsection Ejemplos con enlace
748 @translationof Clickable examples
750 @warning{Esta funcionalidad sólo está disponible en los manuales en
753 Muchas personas aprenden a utilizar programas probando y enredando con
754 ellos. Esto también puede hacerse con LilyPond. Si hace clic sobre
755 una imagen en la versión en HTML de este manual, podrá ver la entrada
756 exacta de LilyPond que se utilizó para generar esa imagen. Pruébelo
763 c4-\markup { \bold \huge { Haga clic aquí. } }
767 Cortando y pegando todo lo que se encuentra dentro de la sección
768 @qq{ly snippet} (fragmento de tipo ly), tendrá una plantilla inicial
769 para sus experimentos. Para poder ver exactamente el mismo resultado
770 (con igual anchura de línea y todo), copie todo lo que está desde
771 @qq{Start cut-&-pastable section} hasta el final del archivo.
777 @n ode Navegación con el teclado
778 @s ubsection Navegación con el teclado
779 @translationof Keyboard navigation
781 @warning{Esta posibilidad sólo está disponible en los manuales en
784 @c TODO: once this is figured out, insert it here.
786 Estamos trabajando sobre esta funcionalidad.
789 @node Panorámica de los manuales
790 @subsection Panorámica de los manuales
791 @translationof Overview of manuals
793 Existe abundantísima documentación sobre LilyPond. Con frecuencia,
794 los nuevos usuarios se encuentran desorientados respecto a qué parte o
795 partes deben leer, y ocasionalmente pasan por alto la lectura de
796 partes de importancia vital.
798 @warning{Por favor: no se salte las partes importantes de la
799 documentación. Le resultará mucho más difícil comprender las
800 secciones subsiguientes.}
805 @strong{Antes de intentar hacer @emph{cualquier cosa}}: lea el
806 @ref{Tutorial} del manual de Aprendizaje, y la sección @ref{Notación
807 corriente}. Si encuentra términos musicales que no reconoce,
808 búsquelos en el @rglosnamed{Top, Glosario}.
811 @strong{Antes de tratar de escribir una pieza completa de música}: lea
812 la sección @ref{Conceptos fundamentales} del manual de Aprendizaje.
813 Después, le vendrá bien consultar las secciones correspondientes de la
814 @rusernamed{Top, Referencia de la notación}.
817 @strong{Antes de tratar de modificar los resultados predeterminados}:
818 lea la sección @ref{Trucar la salida} del manual de Aprendizaje.
821 @strong{Antes de afrontar un proyecto grande}: lea la sección
822 @rprogramnamed{Suggestions for writing files,Sugerencias para escribir
823 archivos de entrada de LilyPond} del manual de Utilización del