1 @c -*- coding: utf-8; mode: texinfo; -*-
2 @c This file is part of lilypond.tely
4 Translation of GIT committish: 4d9a81ea05bea52229dd9045b9eceecd64dbe61d
6 When revising a translation, copy the HEAD committish of the
7 version that you are working on. See TRANSLATION for details.
12 - unless you have a really good reason, use either
13 @l ilypond[quote,ragged-right,verbatim]
15 @l ilypond[quote,ragged-right,verbatim,fragment,relative=2]
17 Don't use any other relative=X commands (make it a non-fragment
18 example), and don't use fragment without relative=2.
19 - use "aes" and "ees" instead of "as" and "aes". I know it's not
20 correct Dutch naming, but let's not confuse people with this until
21 we get to the Basic notation chapter.
26 @c old info that will probably be removed.
28 @c * more details about running lilypond; error messages,
29 @c compiling/viewing (emacs?)
30 @c * where to go from First steps+More basics?
32 @c wherever possible, do not include index entries here; the
33 @c index should point to stuff in the reference manual. -gp
35 @c Your first LilyPond score in 10 minutes?
40 Este tutorial comienza con una introducción al lenguaje musical LilyPond
41 y cómo producir música impresa. Después de este primer contacto,
42 explicaremos cómo crear notación musical usual.
45 Muchas personas aprenden a utilizar programas probando y enredando con ellos.
46 Esto también puede hacerse con LilyPond. Si hace clic sobre una imagen
47 en la versión en HTML de este manual, podrá ver la entrada exacta de LilyPond
48 que se utilizó para generar esa imagen.
49 Pruébelo sobre esta imagen:
52 @lilypond[quote,ragged-right]
54 c-\markup { \bold \huge { Click here. } }
58 Cortando y pegando todo lo que se encuentra dentro de la sección @qq{ly snippet} (fragmento de tipo ly), tendrá una
59 plantilla inicial para sus experimentos. Si le agrada esta forma de aprender,
60 probablemente quiera imprimir o añadir a sus favoritos la dirección de la
61 @ruser{Cheat sheet}, que es una relación en forma de tabla de las instrucciones más comunes
62 de manera que sirvan de referencia rápida.
67 * Single staff notation::
68 * Multiple notes at once::
77 Esta sección le ofrece una introducción básica al trabajo con LilyPond.
82 * Working on text files::
83 * How to read the tutorial::
87 @node Compiling a file
88 @subsection Compiling a file
90 El primer ejemplo demuestra cómo empezar a trabajar con LilyPond. Para
91 crear una partitura, escribimos un archivo de texto que especifica la
92 notación. Por ejemplo, si escribimos
101 el resultado tiene este aspecto
103 @c in this case we don't want verbatim
104 @lilypond[quote,ragged-right]
110 @strong{Advertencia:} Todo el código que se da como entrada a LilyPond tiene que
111 ir entre @strong{@{ llaves @}}. Las llaves deberían también estar
112 rodeadas por espacios a no ser que se encuentren al principio o al final de una línea,
113 para evitar ambigüedades. Es posible que se omitan en algunos ejemplos del presente
114 manual ¡pero no las omita en su propia música!
116 @cindex Sensible a las mayúsculas
117 Además la entrada de LilyPond es @strong{sensible a las mayúsculas}. @code{ @{ c d e @}}
118 es una entrada válida; @code{@{ C D E @}} producirá un mensaje de error.
122 @subheading Entering music and viewing output
124 En esta sección vamos a explicar qué órdenes hay que ejecutar
125 y cómo, para ver o imprimir el resultado.
127 @subsubheading MacOS X
129 Si hace doble clic sobre @code{LilyPond.app}, se abrirá con un archivo
130 de ejemplo. Guárdelo, por ejemplo, como @file{prueba.ly} en el Escritorio, y
131 a continuación procéselo con la orden de menú @samp{Compilar > Componer archivo}.
132 El PDF resultante se mostrará en la pantalla.
134 Advierta que la primera vez que ejecute LilyPond, tardará un minuto
135 o dos porque todas las tipografías del sistema han de ser analizadas previamente.
137 Para posteriores usos de LilyPond, debería comenzar eligiendo @q{Nuevo}
138 o @q{Abrir}. Tiene que grabar el archivo antes de componerlo tipográficamente.
139 Si se produce algún error durante el proceso, observe la ventana del registro.
141 @subsubheading Windows
143 En Windows, si hace doble clic sobre el icono de LilyPond que está en el escritorio, se
144 abrirá un sencillo editor de texto con un archivo de ejemplo. Guárdelo, por ejemplo, con
145 el nombre @file{prueba.ly} en el escritorio y después haga doble clic sobre el icono del
146 archivo para procesarlo (el icono tiene la forma de una nota). Transcurridos unos segundos,
147 obtendrá un archivo @file{prueba.pdf} en el escritorio. Haga doble clic sobre este archivo
148 PDF para ver la partitura compuesta tipográficamente. Un método alternativo para procesar el
149 archivo @file{prueba.ly} es arrastrarlo y soltarlo sobre el icono de LilyPond utilizando
152 Para editar un archivo @file{.ly} existente, haga clic sobre él con el botón derecho del ratón
153 y elija @qq{Edit source} (editar el archivo fuente). Para empezar con un archivo vacío,
154 arranque el editor como se describe más arriba y elija @qq{New} (nuevo) del menú @qq{File} (archivo).
156 Al hacer doble clic sobre el archivo no sólo se obtiene como resultado un archivo PDF,
157 sino también un archivo @file{.log} que contiene cierta información acerca de lo que
158 LilyPond ha hecho con el archivo. Si se produce algún error, examine este archivo de registro.
160 Tenga en cuenta que hay disponibles varios editores de texto
161 alternativos con un mejor apoyo para la realización de documentos de
162 LilyPond, consulte @rprogram{Text editor support} para ver más información.
166 Comience abriendo una ventana de terminal e iniciando un editor de texto. Por
167 ejemplo, puede abrir un xterm y ejecutar
168 @code{joe}@footnote{Existen macros para los adictos a VIM, y hay
169 un @code{LilyPond-mode} (modo de LilyPond) para los adictos a Emacs. Si no han sido
170 instalados aún, consulte el archivo @file{INSTALL.txt}. El
171 entorno de edición más sencillo es @file{LilyPondTool}. Consulte
172 @rprogram{Text editor support} para más información.}. En su
173 editor de texto, introduzca la siguiente entrada y guarde el archivo como
183 Para procesar @file{prueba.ly}, haga lo siguiente:
190 Verá algo parecido a:
195 Procesando `prueba.ly'
197 Interpretando la música... [1]
198 Preprocesando los objetos gráficos...
199 Calculando los cortes de línea... [2]
200 Escribiendo la página de salida en `prueba.ps'...
201 Convirtiendo a `prueba.pdf'...
205 @cindex Ver la música
208 El resultado es el archivo @file{prueba.pdf} que podrá imprimir o ver
209 con las utilidades estándar de su sistema operativo.@footnote{Si
210 su sistema no dispone de dichas herramientas, puede probar
211 @uref{http://@/www@/.cs@/.wisc@/.edu/@/~ghost/,Ghostscript}, un programa
212 de libre disposición para ver e imprimir archivos PDF y PostScript.}
215 @node Simple notation
216 @subsection Simple notation
218 LilyPond añadirá ciertos elementos de notación de manera automática. En el siguiente
219 ejemplo hemos especificado solamente cuatro alturas, pero LilyPond ha
220 añadido la clave, el compás y las duraciones.
222 @lilypond[quote,ragged-right,verbatim]
229 Este comportamiento se puede modificar, pero en general estos valores automáticos
235 La manera más sencilla de introducir las notas es mediante la utilización del modo @code{\relative}. En
236 este modo se supone que el @rglos{interval} entre la nota anterior y la actual
237 se encuentra dentro de una @rglos{fourth}. Comenzamos
238 introduciendo la pieza musical más elemental, una @rglos{scale}.
240 @lilypond[quote,ragged-right,verbatim]
247 La nota inicial es @rglos{middle C}. Cada nota sucesiva
248 se encuentra dentro de una cuarta de la nota previa (en otras palabras: la primera
249 @samp{c} es el Do más cercano al Do central; a éste le sigue el Re más cercano a la
250 nota previa, y así sucesivamente). Podemos crear melodías con intervalos mayores:
252 @lilypond[quote,ragged-right,verbatim]
260 Como puede observar, este ejemplo no comienza en el Do central. La primera nota
261 (la @samp{d}) es el Re más cercano al Do central.
263 Para poner intervalos mayores de una cuarta, podemos elevar la octava
264 añadiendo una comilla simple @code{'} (o apóstrofe) al nombre de la nota. También podemos bajar
265 la octava adjuntando una coma @code{,} al nombre de la nota.
267 @lilypond[quote,ragged-right,verbatim]
275 Para subir o bajar una nota en dos (¡o más!) octavas, utilizamos varias @code{''} ó
276 @code{,,} (pero tenga cuidado de utilizar dos comillas simples @code{''} ¡y no una
277 comilla doble @code{"}@tie{}!) El valor inicial de
278 @code{\relative c'} también puede modificarse de esta forma.
281 @subheading Durations (rhythms)
283 La @rglos{duration} de una nota se especifica mediante un número después del nombre de la nota.
284 @samp{1} significa @rglos{whole note}, @samp{2} significa @rglos{half note},
285 @samp{4} significa @rglos{quarter note} y así sucesivamente. Las barras de corchea se añaden
288 @lilypond[quote,ragged-right,verbatim]
292 a16 a a a a32 a a a a64 a a a a a a a a2
297 Si no especifica una duración, se utiliza la duración previa para la nota siguiente.
298 La figura por omisión de la primera nota es una negra.
300 Para crear notas con puntillo (véase @rglos{dotted note}), añada un punto @samp{.} al número de la duración.
302 @lilypond[quote,ragged-right,verbatim]
312 Un @rglos{rest} se introduce igual que una nota, con el nombre @samp{r}:
314 @lilypond[quote,ragged-right,verbatim]
322 @subheading Time signature
324 La @rglos{time signature}) se puede establecer con la orden @code{\time} :
326 @lilypond[quote,ragged-right,verbatim]
340 La @rglos{clef} se puede establecer utilizando la orden @code{\clef} :
342 @lilypond[quote,ragged-right,verbatim]
356 @subheading All together
358 He aquí un pequeño ejemplo que muestra todos los elementos anteriores juntos:
360 @lilypond[quote,ragged-right,verbatim]
372 @item Introducir alturas y duraciones
373 véase @ruser{Pitches} y @ruser{Durations}.
376 @item Indicaciones de compás y otras instrucciones de tiempo
377 véase @ruser{Time signature}.
384 @node Working on text files
385 @subsection Working on text files
387 Los archivos de entrada de LilyPond son como los archivos fuente de muchos lenguajes de programación corrientes.
388 Son sensibles a las mayúsculas e insensibles al número de espacios Las expresiones
389 se forman con llaves @{ @} y los comentarios se denotan por un signo de porcentaje (@code{%}) o por
392 Si la frase anterior no tiene sentido para usted ¡no se preocupe! A continuación explicaremos el
393 significado de todos estos términos:
397 @cindex Sensible a las mayúsculas
398 @item @strong{Sensible a las mayúsculas}:
399 tiene importancia el hecho de que introduzca una letra
400 en minúsculas (p.ej. @code{a, b, s, t}) o en mayúsculas (p.ej.
401 @code{A, B, S, T}). Las notas son minúsculas: @code{@{ c d e @}}
402 es una entrada válida; @code{@{ C D E @}} produciría un mensaje de error.
404 @item @strong{Insensible al número de espacios}:
406 espacios (o saltos de línea) añada. @code{@{ c d e @}} significa lo mismo
407 que @code{@{ c @tie{} @tie{} @tie{} d e @}} y que
415 Por supuesto, el ejemplo anterior es difícil de leer. Una regla práctica
416 es sangrar los bloques de código con un carácter de tabulación, o bien con dos espacios:
423 @item @strong{Expresiones:}
424 Todo fragmento de código de entrada para LilyPond ha de llevar
425 @strong{@{ llaves @}} antes y después de la entrada. Estas llaves le dicen a
426 LilyPond que la entrada es una expresión musical unitaria, igual que
427 los paréntesis @samp{()} de las matemáticas. Las llaves deben ir rodeadas
428 de un espacio a no ser que se encuentren al comienzo o al final de una
429 línea, para evitar cualquier ambigüedad.
431 Una función (como por ejemplo @code{\relative @{ @}}) también es una expresión musical
435 @cindex comentario de línea
436 @cindex comentario de bloque
437 @item @strong{Comentarios}:
438 Un comentario es una nota para el lector humano de la entrada musical; se ignora
439 cuando esta entrada se analiza, de manera que no tiene ningún efecto sobre la salida impresa.
440 Existen dos tipos de comentarios. El símbolo de porcentaje @samp{%}
441 introduce un comentario de línea; todo lo que se encuentra después de @samp{%} en esa línea
442 se ignora. Un comentario de bloque marca una sección entera de entrada musical
443 como comentario. Todo lo que está encerrado dentro de @code{%@{} y @code{%@}} se
444 ignora (pero los comentarios no pueden incluir otros comentarios). El siguiente fragmento muestra algunos posibles usos para los comentarios:
447 % a continuación van las notas de campanitas del lugar
451 Esta línea y las notas que aparecen más abajo
452 se ignoran, por estar dentro de un
453 comentario de bloque.
461 Hay más trucos para elaborar archivos de entrada en
462 @ruser{Suggestions for writing LilyPond files}.
465 @node How to read the tutorial
466 @subsection How to read the tutorial
468 Como vimos en @ruser{Working on text files}, la entrada de LilyPond debe estar
469 rodeada de llaves @{ @} o de @code{\relative c'' @{ ... @}}. Durante el
470 resto del presente manual, la mayor parte de los ejemplos omitirán las llaves.
472 Si está leyendo la documentación HTML y quiere ver el código de LilyPond exacto
473 que se utilizó para crear el ejemplo, sencillamente haga clic
474 sobre la imagen. Si no está leyendo la versión en HTML, podría
475 copiar y pegar la entrada que se muestra, pero @strong{deberá} añadir
476 @code{\relative c'' @{ @}} de la siguiente manera:
480 ... aquí va el ejemplo...
484 ¿Por qué omitir las llaves? Casi todos los ejemplos
485 del presente manual se pueden insertar en medio de un fragmento mayor de
486 música. Para estos ejemplos no tiene ningún sentido añadir
487 @code{\relative c'' @{ @}} (no debería poner un @code{\relative}
488 dentro de otro @code{\relative}), de forma que usted no podría copiar
489 un ejemplo pequeño procedente de la documentación y pegarlo dentro de su propia
493 @node Single staff notation
494 @section Single staff notation
496 Esta sección es una introducción a la notación corriente que se utiliza para una voz
500 * Relative note names::
501 * Accidentals and key signatures::
503 * Articulation and dynamics::
504 * Automatic and manual beams::
505 * Advanced rhythmic commands::
509 @node Relative note names
510 @subsection Relative note names
512 Como hemos visto en @ruser{Simple notation}, LilyPond calcula la altura de
513 cada nota de forma relativa respecto de la nota anterior@footnote{Existe otra forma de
514 introducir las alturas, @ruser{Absolute note names}, pero en la práctica el modo
515 relativo es mucho más cómodo y seguro de utilizar.}. Si no se añade ninguna marca de octava
516 (@code{'} y @code{,}), se supone que cada altura se encuentra dentro de una
517 cuarta desde la nota anterior.
519 LilyPond examina las alturas basándose en los nombres de las notas (dicho de otra forma:
520 una cuarta aumentada @emph{no} es lo mismo que una quinta disminuida. Si
521 empezamos en un Do, un Fa sostenido situado a continuación se colocará por encima del Do, mientras que
522 un Sol bemol se colocará por debajo de este mismo Do.
524 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
532 @item Octavas relativas
533 ver @ruser{Relative octaves}.
534 @item Comprobación de octava
535 ver @ruser{Octave check}.
541 @node Accidentals and key signatures
542 @subsection Accidentals and key signatures
544 @subheading Accidentals
546 Una nota @rglos{sharp} se hace añadiendo @samp{is} al
547 nombre, y una nota @rglos{flat} añadiendo @samp{es}. Como
548 ha podido adivinar, un @rglos{double sharp} o @rglos{double flat} se hace
549 añadiendo @samp{isis} o @samp{eses}@footnote{Esta sintaxis
550 derivó de las convenciones de las lenguas nórdicas y germánicas para nombrar las notas
551 como el alemán y el holandés. Para utilizar otros nombres para las alteraciones accidentales, vea
552 @ruser{Note names in other languages}.}
554 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
555 cis1 ees fisis, aeses
558 @cindex tonalidad, armadura de la, establecer
559 @subheading Key signatures
561 La armadura de la tonalidad se establece mediante la instrucción @code{\key} seguido de
562 una nota y @code{\major} o @code{\minor}.
564 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
573 @subheading Warning: key signatures and pitches
575 Para determinar si hay que imprimir una alteración accidental, LilyPond examina las
576 notas y la armadura de la tonalidad. La armadura solamente afecta a las
577 alteraciones @emph{impresas}, ¡no a las propias notas! Ésta es una
578 funcionalidad que frecuentemente confunde a los que se inician con el programa, por ello permítanos explicarla
581 LilyPond hace una clara distinción entre el contenido musical y la
582 presentación. La alteración (bemol, becuadro o sostenido) de una nota es parte de
583 la altura, y por tanto es contenido musical. Si una alteración (un
584 signo @emph{impreso} de bemol, becuadro o sostenido) se imprime o no delante de la
585 nota correspondiente, es una cuestión de presentación. La presentación es algo que
586 sigue unas reglas, así que las alteraciones accidentales se imprimen automáticamente según
587 dichas reglas. Las alturas de las notas en su música son obras de arte, por tanto no se
588 añadirán automáticamente, y usted deberá introducir aquello que quiera oír.
590 En el siguiente ejemplo
592 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
598 ninguna nota lleva una alteración impresa, pero de todas formas usted debe añadir la @samp{is} a
599 @code{cis} y a @code{fis}.
601 El texto @samp{e} no significa @qq{imprimir una bolita negra en la
602 primera línea del pentagrama.} Más bien significa: @qq{hay una nota
603 Mi natural.} En la tonalidad de La bemol mayor, @emph{lleva} una
604 alteración accidental:
606 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
611 Poner todas las alteraciones de forma explícita puede que requiera algo más de trabajo
612 al teclear, pero la ventaja es que la transposición es más fácil, y las
613 alteraciones se pueden imprimir siguiendo varias convenciones distintas. Consulte
614 @ruser{Automatic accidentals} para ver ejemplos de cómo se pueden imprimir las alteraciones
615 de acuerdo a reglas diferentes.
620 @item Alteraciones accidentales
621 ver @ruser{Accidentals} y @ruser{Automatic accidentals}.
622 @item Armadura de la tonalidad
623 ver @ruser{Key signature}.
629 @subsection Ties and slurs
631 @cindex ligaduras de unión
633 Una @rglos{tie} se crea adjuntando un carácter tilde @samp{~} a la primera
636 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
641 @cindex ligaduras de expresión
644 Una @rglos{slur} es una curva que se traza abarcando varias notas. Las notas inicial
645 y final se marcan mediante @samp{(} y @samp{)} respectivamente.
647 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
648 d4( c16) cis( d e c cis d) e( d4)
651 @cindex fraseo, ligaduras de
652 @cindex ligaduras de fraseo
653 @subheading Phrasing slurs
655 Las ligaduras que se utilizan para indicar fraseos más largos se pueden introducir mediante @code{\(} y
656 @code{\)}. Puede haber al mismo tiempo ligaduras de legato y ligaduras de fraseo,
657 pero no es posible tener legatos simultáneos o ligaduras de expresión
660 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
661 a8(\( ais b c) cis2 b'2 a4 cis,\)
666 @cindex ligaduras de expresión frente a ligaduras de unión
667 @subheading Warnings: slurs vs. ties
669 Una ligadura de expresión parece una @rglos{tie}, pero tiene un significado distinto. Una
670 ligadura (de unión) sencillamente hace que la primera nota sea más larga, y sólo se puede utilizar sobre
671 parejas de notas iguales. Las ligaduras de expresión indican las articulaciones
672 de las notas, y se pueden utilizar sobre grupos mayores de notas. Las ligaduras de unión y de expresión
673 se pueden anidar unas dentro de otras.
675 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
676 c2~( c8 fis fis4 ~ fis2 g2)
682 @item Ligaduras de unión
684 @item Ligaduras de expresión
686 @item Ligaduras de fraseo
687 ver @ruser{Phrasing slurs}.
692 @node Articulation and dynamics
693 @subsection Articulation and dynamics
698 @subheading Articulations
700 Las articulaciones (véase @rglos{articulation}) más corrientes se pueden añadir a las notas utilizando un guión @samp{-}
701 seguido de un carácter único:
703 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
704 c-. c-- c-> c-^ c-+ c-_
708 @subheading Fingerings
709 De manera similar, las indicaciones de digitación se pueden añadir a una nota utilizando un guión
710 (@samp{-}) seguido del dígito deseado:
712 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
716 Las articulaciones y digitaciones normalmente se colocan de forma automática, pero puede
717 especificar una dirección mediante @samp{^} (encima) o @samp{_} (debajo). También
718 puede usar varias articulaciones sobre la misma nota. Sin embargo, casi siempre
719 es mejor dejar que LilyPond determine la dirección de las articulaciones.
721 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
722 c_-^1 d^. f^4_2-> e^-_+
726 Las expresiones de matiz o signos dinámicos se hacen añadiendo las marcas (con una barra invertida) a la
729 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
733 @cindex expresiones dinámicas
737 Los crescendi y decrescendi comienzan con las órdenes @code{\<} y
738 @code{\>}. Una expresión terminal de matiz, como por ejemplo @code{\f}, dará por terminado el
739 (de)crescendo, o bien se puede usar la orden @code{\!}:
741 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
749 ver @ruser{Articulations}.
751 ver @ruser{Fingering instructions}.
753 ver @ruser{Dynamics}.
758 @node Automatic and manual beams
759 @subsection Automatic and manual beams
761 @cindex barras, establecimiento manual
762 Todas las @rglos{beam}s se dibujan automáticamente:
763 @c aquí hay un problema con el plural. FVD
764 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
765 a8 ais d ees r d c16 b a8
769 Si no le gustan las barras automáticas, pueden forzarse
770 manualmente. Marque la primera nota que comprende la barra con @samp{[} y la última
773 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
774 a8[ ais] d[ ees r d] a b
780 @item Barras automáticas
781 ver @ruser{Automatic beams}.
782 @item Barras manuales
783 ver @ruser{Manual beams}.
788 @node Advanced rhythmic commands
789 @subsection Advanced rhythmic commands
792 @c @cindex anacruse @c redundant, in spanish. FVD
793 @cindex compás parcial
794 @subheading Partial measure
796 Una anacrusa (o @rglos{anacrusis}) se introduce con la palabra clave
797 @code{\partial}. Va seguida de una duración: @code{\partial 4} es
798 una anacrusa de negra y @code{\partial 8} de corchea.
800 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
805 @cindex grupos especiales
809 Los grupos especiales como los tresillos se hacen con la palabra clave @code{\times}. Requiere dos
810 argumentos: una fracción y un fragmento de música. La duración del fragmento
811 de música se multiplica por la fracción. Los tresillos hacen que las notas ocupen
812 2/3 de su duración expresa, por tanto un tresillo lleva una fracción de 2/3
814 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
815 \times 2/3 { f8 g a }
817 \times 2/3 { f,8 g16[ a g a] }
821 @cindex notas de adorno
824 @subheading Grace notes
826 Las notas de adorno se crean con la instrucción @code{\grace}, aunque
827 también se pueden conseguir precediendo una expresión musical por la
828 palabra clave @code{\appoggiatura} o @code{\acciaccatura}
830 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
831 c2 \grace { a32[ b] } c2
832 c2 \appoggiatura b16 c2
833 c2 \acciaccatura b16 c2
839 @item Notas de adorno
840 ver @ruser{Grace notes},
841 @item Grupos especiales
844 ver @ruser{Partial measures}.
849 @node Multiple notes at once
850 @section Multiple notes at once
852 Esta sección es una introducción a las notas simultáneas:
853 varios instrumentos, varios pentagramas para un solo instrumento (p.ej. piano)
856 La palabra @q{polifonía} en música hace referencia al hecho de tener más de una voz en un momento determinado
857 dentro de una pieza musical. La palabra @q{polifonía} en LilyPond se refiere al hecho de tener más de
858 una voz en el mismo pentagrama.
861 * Music expressions explained::
864 * Combining notes into chords::
865 * Single staff polyphony::
869 @node Music expressions explained
870 @subsection Music expressions explained
872 En los archivos de entrada de LilyPond, la música se representa mediante @emph{expresiones
873 musicales}. Una sola nota es una expresión musical, aunque no es una
874 entrada válida por sí sola.
876 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
880 Al encerrar un grupo de notas dentro de llaves creamos una expresión musical:
882 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
886 Si colocamos un grupo de expresiones musicales (p.ej.: notas) dentro de llaves, eso significa que
887 se encuentran en secuencia (es decir, cada una sigue a la anterior). El resultado
888 es otra expresión musical:
890 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
894 @subheading Simultaneous music expressions: multiple staves
896 Esta técnica es muy útil para la música polifónica. Para introducir música
897 con más voces o con más pentagramas, lo que hacemos es combinar varias expresiones en
898 paralelo. Para indicar que dos voces se deben interpretar al mismo tiempo,
899 sencillamente introduzca una combinación simultánea de expresiones musicales. Una
900 expresión musical @q{simultánea} se forma encerrando las expresiones dentro de
901 @code{<<} y @code{>>}. En el ejemplo que sigue, tres secuencias (cada una de las cuales
902 contiene dos notas diferentes) se combinan de forma simultánea:
904 @lilypond[quote,ragged-right,verbatim]
914 Tenga en cuenta que hemos sangrado cada nivel jerárquico de la entrada con un margen
915 distinto. A LilyPond no le importa cuánto (o cuán poco) espacio haya
916 al comienzo de una línea, pero el establecimiento de márgenes distintos dentro del código de LilyPond, de esta forma, lo
917 hace mucho más fácil de leer por nosotros los seres humanos.
919 @strong{Advertencia}: cada nota se entiende relativa a la
920 nota anterior de la entrada, no relativa a la @code{c''} dentro de la
921 instrucción inicial @code{\relative}.
924 @subheading Simultaneous music expressions: single staff
926 Para determinar el número de pentagramas en una pieza, LilyPond examina la primera
927 expresión. Si ésta consiste en una sola nota, hay un solo pentagrama; si hay una
928 expresión simultánea, hay más de un pentagrama.
930 @lilypond[quote,ragged-right,verbatim]
933 << { e f } { c <<b d>> } >>
938 @cindex expresión musical
939 @subheading Analogy: mathematical expressions
941 Este mecanismo es semejante a las fórmulas
942 matemáticas: una fórmula grande se construye combinando fórmulas pequeñas. Dichas
943 fórmulas se llaman expresiones, y su definición es recursiva de tal forma que
944 se pueden construir expresiones de un tamaño y complejidad arbitrarios. Por ejemplo:
953 ((1 + 2) * 3) / (4 * 5)
956 Ésta es una secuencia de expresiones donde cada expresión se encuentra contenida dentro
957 de la siguiente, más grande. Las expresiones más simples son números, y las mayores
958 se hacen combinando expresiones mediante operadores (como @samp{+},
959 @samp{*} y @samp{/}) y paréntesis. Del mismo modo que las expresiones matemáticas,
960 las expresiones musicales se pueden anidar a una profundidad arbitraria, lo que se hace necesario
961 para músicas complejas como las partituras polifónicas.
964 @node Multiple staves
965 @subsection Multiple staves
967 Como ya hemos visto en @ruser{Music expressions explained}, los archivos de entrada para LilyPond
968 se construyen a base de expresiones musicales. Si la partitura comienza con
969 expresiones musicales simultáneas, LilyPond crea varios pentagramas. Sin embargo
970 es más fácil ver lo que ocurre si creamos cada uno de los pentagramas de forma explícita.
972 Para imprimir más de un pentagrama, cada fragmento de música que constituye un
973 pentagrama se marca escribiendo @code{\new Staff} antes de él. Estos
974 elementos @code{Staff} se combinan después en paralelo con @code{<<} y
977 @lilypond[quote,ragged-right,verbatim]
980 \new Staff { \clef treble c }
981 \new Staff { \clef bass c,, }
986 La instrucción @code{\new} inaugura un @q{contexto de notación}. Un contexto de
987 notación es un entorno dentro del que se interpretan los acontecimientos musicales (como las notas o las
988 instrucciones @code{\clef}). Para piezas sencillas, tales
989 contextos de notación se crean automáticamente. Para piezas más complicadas, es mejor
990 marcar los contextos de forma explícita.
992 Existen varias clases de contextos. @code{Score}, @code{Staff}
993 y @code{Voice} manejan la notación melódica, mientras que @code{Lyrics} se ocupa de los textos
994 cantados y @code{ChordNames} imprime los nombres de los acordes.
996 En términos de sintaxis, la anteposición de @code{\new} a una expresión musical
997 crea una expresión musical mayor. Es semejante al signo
998 menos de las matemáticas. La fórmula @math{(4+5)} es una expresión, por tanto
999 @math{-(4+5)} es una expresión más amplia.
1001 Las indicaciones de compás escritas en un pentagrama afectan al
1002 resto de ellos@footnote{Este comportamiento se puede cambiar si uno lo desea; consulte
1003 @ruser{Polymetric notation} para ver más detalles.}. En cambio,
1004 la armadura de la tonalidad de un pentagrama @emph{no} afecta a los otros
1007 @lilypond[quote,ragged-right,verbatim]
1010 \new Staff { \clef treble \time 3/4 c }
1011 \new Staff { \clef bass \key d \major c,, }
1020 @subsection Piano staves
1022 @cindex salto de pentagrama, establecimiento manual
1023 @cindex voz de pentagrama cruzado, establecimiento manual
1024 La música para piano se compone tipográficamente en forma de dos pentagramas unidos mediante una llave. El aspecto impreso de
1025 este sistema de pentagramas se parece al ejemplo polifónico que aparece en @ruser{Multiple staves},
1026 pero en esta ocasión la expresión completa se coloca dentro de un @code{PianoStaff}:
1035 He aquí un pequeño ejemplo:
1037 @lilypond[quote,ragged-right,verbatim]
1040 \new Staff { \time 2/4 c4 e g g, }
1041 \new Staff { \clef bass c,, c' e c }
1048 Ver @ruser{Piano music}.
1051 @node Combining notes into chords
1052 @subsection Combining notes into chords
1055 Los acordes se hacen rodeando las notas con paréntesis en ángulo simples. Los paréntesis
1056 en ángulo son los símbolos @samp{<} (menor que) y @samp{>} (mayor que).
1058 @lilypond[quote,fragment,verbatim,relative=2,fragment]
1059 r4 <c e g>4 <c f a>2
1062 Se pueden combinar las marcas como barras y ligaduras con acordes. Se deben
1063 colocar por fuera de los paréntesis en ángulo:
1065 @lilypond[quote,fragment,verbatim,relative=2,fragment]
1066 r4 <c e g>8[ <c f a>]~ <c f a>2
1069 @lilypond[quote,fragment,verbatim,relative=2,fragment]
1070 r4 <c e g>8\>( <c e g> <c e g>4 <c f a>\!)
1073 @node Single staff polyphony
1074 @subsection Single staff polyphony
1077 @cindex varias voces
1078 @cindex voces, más (en un solo pentagrama)
1079 Cuando distintas líneas melódicas se combinan sobre un solo pentagrama, se
1080 imprimen como voces polifónicas; cada voz lleva sus propias plicas, ligaduras y
1081 barras de corchea, y la voz superior tiene las plicas hacia arriba mientras que la voz inferior las
1084 La introducción de estas partes se hace escribiendo cada voz en forma de secuencia (con
1085 @code{@{...@}}) y combinando éstas de forma simultánea, separando las
1088 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
1095 Para el tipografiado de música polifónica, puede ser conveniente la utilización de silencios separadores, o sea,
1096 silencios que no aparecen impresos. Son muy útiles para rellenar
1097 voces que temporalmente no están cantando. He aquí el mismo ejemplo con un
1098 silencio separador (@samp{s}) en vez de un silencio normal (@samp{r}):
1100 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
1108 Una vez más, las expresiones de este tipo se pueden anidar de forma arbitraria.
1110 @lilypond[quote,fragment,verbatim,relative=2,fragment]
1118 { <c g>1 ~ <c g>4 } \\
1126 Ver @ruser{Basic polyphony}.
1133 Esta sección es una introducción a la música vocal y a las partituras de canciones sencillas.
1141 @node Printing lyrics
1142 @subsection Printing lyrics
1146 Consideremos una melodía sencilla:
1148 @lilypond[quote,ragged-right,verbatim]
1155 La letra se puede asignar a esas notas, combinando ambas con la
1156 palabra clave @code{\addlyrics}. La letra se escribe separando cada
1157 sílaba mediante un espacio.
1159 @lilypond[quote,ragged-right,verbatim]
1165 \addlyrics { One day this shall be free }
1170 @cindex línea de extensión de sílabas
1171 Esta melodía acaba en un @rglos{melisma}, una sílaba única (@q{suelta})
1172 que se canta sobre más de una nota. Esto se indica mediante una @emph{línea
1173 de extensión}. Se escribe como dos guiones bajos @code{__}:
1175 @lilypond[quote,ragged-right,verbatim]
1181 \addlyrics { One day this shall be free __ }
1185 De forma parecida, los guiones entre las palabras se pueden escribir como dos guiones,
1186 dando como resultado unas líneas cortas entre cada dos sílabas:
1188 @c aquí no se pone ragged-right porque los guiones se perderían.
1189 @lilypond[quote,verbatim]
1195 \addlyrics { A -- le -- gri -- a }
1201 Otras posibilidades como poner varios versos debajo de una melodía, se
1202 discuten en @ruser{Vocal music}.
1207 @subsection A lead sheet
1209 @cindex Hojas guía de acordes
1211 @cindex nombres de los acordes
1213 En la música pop es muy común denotar el acompañamiento con los nombres de los acordes.
1214 Estos acordes se pueden escribir como notas:
1216 @lilypond[quote,ragged-right,verbatim]
1217 \chordmode { c2 f4. g8 }
1220 Ahora, cada altura se lee como la fundamental de un acorde en vez de como una nota.
1221 Este modo se activa con @code{\chordmode}. Otros acordes pueden
1222 construirse añadiendo modificadores después de un signo de dos puntos. El
1223 ejemplo que sigue muestra algunos modificadores comunes:
1225 @lilypond[quote,verbatim,ragged-right]
1226 \chordmode { c2 f4:m g4:maj7 gis1:dim7 }
1229 Para canciones con acordes, éstos no se imprimen sobre pentagramas, sino como nombres en su
1230 propia línea. Esto se consigue utilizando @code{\chords} en sustitución
1231 de @code{\chordmode}. Utiliza la misma sintaxis que @code{\chordmode},
1232 pero pinta las notas dentro de un contexto de @code{ChordNames}, con el
1233 siguiente resultado:
1235 @lilypond[quote,verbatim,ragged-right]
1236 \chords { c2 f4.:m g4.:maj7 gis8:dim7 }
1239 @cindex hoja guía de acordes
1240 Cuando se combinan, los nombres de acorde, la letra y la melodía forman
1241 una hoja de canción con acordes (@q{lead sheet}):
1243 @lilypond[quote,verbatim,ragged-right]
1245 \chords { c2 g:sus4 f e }
1250 \addlyrics { One day this shall be free __ }
1257 Puede ver una lista completa de los modificadores y otras opciones de presentación
1263 @section Final touches
1265 Éste es el último apartado del tutorial; muestra la forma de dar los toques finales
1266 a piezas sencillas, y ofrece una introducción al resto
1272 * Absolute note names::
1273 * Organizing pieces with identifiers::
1274 * After the tutorial::
1275 * How to read the manual::
1279 @node Version number
1280 @subsection Version number
1282 @cindex indicación de la versión
1283 La indicación @code{\version} deja registrado para qué versión de LilyPond se escribió
1291 por convenio se sitúa al principio del archivo de partitura de LilyPond.
1293 Estas anotaciones hacen menos problemáticas las subsiguientes actualizaciones de LilyPond.
1294 Los cambios en la sintaxis se tratan mediante un programa especial,
1295 @file{convert-ly} (ver @rprogram{Updating files with convert-ly}), y utiliza
1296 @code{\version} para determinar qué reglas hay que aplicar.
1300 @subsection Adding titles
1302 La información sobre el título, autor, número de Opus y similares se escriben
1303 en el bloque @code{\header}. Éste se encuentra fuera de la expresión musical
1304 principal; el bloque @code{\header} normalmente se sitúa por debajo del
1305 @ruser{Version number}.
1316 @dots{} music @dots{}
1320 Cuando se procesa el archivo, el título y el autor se imprimen por encima
1321 de la música. Puede obtener más información sobre los títulos en @ruser{Creating
1325 @node Absolute note names
1326 @subsection Absolute note names
1328 Hasta el momento siempre hemos utilizado @code{\relative} para definir las alturas. Ésta es la
1329 forma más sencilla de escribir la mayor parte de la música, pero existe otra forma de definir
1330 las alturas: el modo absoluto.
1332 Si omite el @code{\relative}, LilyPond tratará todas las alturas como
1333 valores absolutos. Una @code{c'} significará siembre un Do central, una @code{b} significará
1334 siempre la nota inmediatamente por debajo del Do central, y una @code{g,} significará
1335 siempre la nota que se coloca en la primera línea del pentagrama en clave de Fa.
1337 @lilypond[quote,verbatim,ragged-right]
1345 He aquí una escala que abarca cuatro octavas:
1347 @lilypond[quote,verbatim,ragged-right]
1362 Como puede ver, escribir una melodía en clave de Sol implica escribir gran cantidad de
1363 apóstrofes ' . Consideremos este fragmento de Mozart:
1365 @lilypond[quote,verbatim,ragged-right]
1369 cis''8. d''16 cis''8 e''4 e''8
1370 b'8. cis''16 b'8 d''4 d''8
1374 Todos estos apóstrofes hacen casi ilegible el código de entrada y será origen de numerosos
1375 errores. Con @code{\relative}, el ejemplo anterior es mucho más fácil
1378 @lilypond[quote,verbatim,ragged-right]
1382 cis8. d16 cis8 e4 e8
1387 Si comete un error con una marca de octava (@code{'} o @code{,}) mientras
1388 trabaja en el modo @code{\relative}, será muy obvio (muchas notas estarán
1389 en la octava equivocada). Mientras trabaja en el modo absoluto, un solo fallo
1390 no será tan visible, y tampoco será tan fácil de localizar.
1392 Sin embargo, el modo absoluto es útil para escribir música que contenga intervalos grandes, y
1393 será extremadamente útil para hacer archivos de LilyPond generados por ordenador.
1396 @node Organizing pieces with identifiers
1397 @subsection Organizing pieces with identifiers
1399 Cuando los elementos que hemos discutido anteriormente se combinan para producir
1400 archivos mayores, las expresiones musicales se hacen enormes. En música
1401 polifónica con muchos pentagramas, los archivos de entrada pueden volverse muy propensos a la confusión. Podemos
1402 reducir esta confusión utilizando los @emph{identificadores}.
1404 Con los identificadores (también conocidos como variables o macros), podemos trocear las
1405 expresiones musicales complejas. Un identificador se asigna de la manera siguiente:
1408 musicaConNombre = @{ @dots{} @}
1411 El contenido de la expresión musical @code{musicaConNombre} se puede usar
1412 posteriormente colocando una barra invertida delante del nombre
1413 (@code{\musicaConNombre}, igual que una orden normal de LilyPond). Los identificadores
1414 se deben definir @emph{antes} de la expresión musical principal.
1416 @lilypond[quote,verbatim,ragged-right]
1417 violin = \new Staff { \relative c'' {
1420 cello = \new Staff { \relative c {
1433 El nombre de un identificador debe consistir enteramente en caracteres alfabéticos, es decir
1434 sin números, guiones ni guiones bajos.
1436 Es posible utilizar variables para otras muchas clases de objetos en el código de
1437 entrada. Por ejemplo:
1442 aFivePaper = \paper @{ paperheight = 21.0 \cm @}
1445 Dependiendo de su contenido, el identificador se puede usar en distintos
1446 lugares. El siguiente ejemplo utiliza las variables anteriores:
1457 @node After the tutorial
1458 @subsection After the tutorial
1460 Después de terminar el tutorial, quizá debería probar a escribir una o dos
1461 piezas. Comience con una de las @ruser{Templates} y añada algunas
1462 notas. Si necesita un tipo de notación que no ha sido tratada en el
1463 tutorial, eche un vistazo a la Referencia de Notación, empezando por
1464 @ruser{Basic notation}. Si quiere escribir música para un conjunto
1465 instrumental que no está cubierto por ninguna plantilla,
1466 consulte @ruser{Extending the templates}.
1468 Una vez que ha escrito algunas piezas cortas, lea el resto del
1469 Manual de aprendizaje (capítulos 3 al 5). ¡Por supuesto, no pasa nada por
1470 leerlo ahora mismo! Sin embargo, el resto del Manual
1471 de Aprendizaje da por sentado que está familiarizado con la entrada
1472 de LilyPond. Puede saltarse estos capítulos ahora
1473 y volver a ellos cuando haya adquirido más experiencia.
1476 @node How to read the manual
1477 @subsection How to read the manual
1479 Como ya vimos en @ruser{How to read the tutorial}, muchos ejemplos del
1480 tutorial omitían el @code{\relative c'' @{ ... @}} alrededor del ejemplo
1483 Durante el resto del manual seremos mucho menos estrictos respecto de los
1484 ejemplos impresos: a veces pueden omitir el
1485 @code{\relative c'' @{ ... @}}, pero otras veces se puede usar una nota inicial
1486 diferente (como @code{c'} o @code{c,,}), y en ocasiones
1487 ¡todo el ejemplo estará en el modo de notas absoluto! Sin embargo, las ambigüedades de esta clase
1488 existen solamente allí donde las alturas no son lo más importante. En aquellos ejemplos
1489 en los que las alturas tienen importancia, hemos escrito explícitamente @code{\relative}
1490 o bien el @code{@{ @}} en modo absoluto.
1492 Si aún tiene dudas respecto de la entrada de LilyPond exacta que se
1493 ha utilizado en un ejemplo, lea la versión HTML (si no lo está haciendo ya)
1494 y pulse con el ratón sobre la imagen de la música. De esta forma se mostrará la entrada
1495 exacta que LilyPond usó para generar este manual.
1497 Para informarse sobre la estructura que tiene el resto del manual, consulte
1498 @ruser{About this manual}.