1 @c -*- coding: utf-8; mode: texinfo; -*-
2 @c This file is part of lilypond.tely
4 Translation of GIT committish: e344dd780c20717963ed77658f3ce169822bc5cb
6 When revising a translation, copy the HEAD committish of the
7 version that you are working on. See TRANSLATION for details.
11 Tutorial guidelines: (different from policy.txt!)
12 - unless you have a really good reason, use either
13 @lilypond[verbatim,quote,ragged-right]
15 @lilypond[verbatim,quote,ragged-right,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.
20 - use "aes" and "ees" instead of "as" and "es". I know it's not
21 correct Dutch naming, but let's not confuse people with this
22 until we get to the Basic notation chapter.
24 - Add "Music Glossary: @rglos{foo}" to the _top_ of the relevant
25 portions of the tutorial.
33 Este tutorial comienza con una introducción al lenguaje musical
34 LilyPond y explica cómo producir música impresa. Después de este
35 primer contacto, explicaremos cómo crear música impresa de forma
36 bella, que contenga notación musical usual.
41 * Single staff notation::
42 * Multiple notes at once::
51 Esta sección le ofrece una introducción básica al trabajo con LilyPond.
56 * Working on text files::
57 * How to read the manual::
61 @node Compiling a file
62 @subsection Compiling a file
64 @qq{Compilación} es una palabra que significa procesar un texto de
65 entrada eb formato de LilyPond para producir un archivo que se puede
66 imprimir y (de manera opcional) un archivo MIDI que se puede
67 reproducir. El primer ejemplo muestra el aspecto de un sencillo
68 archivo de texto de entrada.
70 Para crear una partitura, escribimos un archivo de texto que detalla
71 la notación deseada. Por ejemplo, si escribimos
80 el resultado tiene este aspecto
82 @c in this case we don't want verbatim
83 @lilypond[quote,ragged-right]
89 @warning{La música y la letra escrita en el código de entrada de
90 LilyPond tiene que ir siempre entre @strong{@{ llaves @}}. Las llaves
91 deberían también estar rodeadas por espacios a no ser que se
92 encuentren al principio o al final de una línea, para evitar
93 ambigüedades. Es posible que se omitan en algunos ejemplos del
94 presente manual ¡pero no las omita en su propia música! Paara ver más
95 información sobre la presentación de los ejemplos del manual, consulte
96 @ref{How to read the manual}.}
99 @cindex Sensible a las mayúsculas
100 Además la entrada de LilyPond es @strong{sensible a las mayúsculas}. @code{ @{ c d e @}}
101 es una entrada válida; @code{@{ C D E @}} producirá un mensaje de error.
105 @subheading Entering music and viewing output
108 @cindex ver la música
110 En esta sección vamos a explicar qué órdenes hay que ejecutar y cómo,
111 para ver o imprimir el resultado.
113 Tenga en cuenta que están disponibles varios otros editores de texto
114 con un mejor apoyo a la edición de texto de LilyPond. Para ver más
115 información, consulte @rprogram{Text editor support}.
117 @warning{La primera vez que ejecute LilyPond, tardará un minuto o dos
118 porque todas las tipografías del sistema han de ser analizadas
119 previamente. ¡Después de esto, LilyPond será mucho más rápido!}
121 @subsubheading MacOS X
123 Si hace doble clic sobre @code{LilyPond.app}, se abrirá con un archivo
124 de ejemplo. Guárdelo, por ejemplo, como @file{prueba.ly} en el
125 Escritorio, y a continuación procéselo con la orden de menú
126 @samp{Compilar > Componer archivo}. El PDF resultante se mostrará en
130 Para posteriores usos de LilyPond, debería comenzar eligiendo
131 @q{Nuevo} o @q{Abrir}. Tiene que grabar el archivo antes de
132 componerlo tipográficamente. Si se produce algún error durante el
133 proceso, observe la ventana del registro.
136 @subsubheading Windows
138 En Windows, si hace doble clic sobre el icono de LilyPond que está en
139 el escritorio, se abrirá un sencillo editor de texto con un archivo de
140 ejemplo. Guárdelo, por ejemplo, con el nombre @file{prueba.ly} en el
141 escritorio y después haga doble clic sobre el icono del archivo para
142 procesarlo (el icono tiene la forma de una corchea). Transcurridos
143 unos segundos, obtendrá un archivo @file{prueba.pdf} en el
144 escritorio. Haga doble clic sobre este archivo PDF para ver la
145 partitura compuesta tipográficamente. Un método alternativo para
146 procesar el archivo @file{prueba.ly} es arrastrarlo y soltarlo sobre
147 el icono de LilyPond utilizando el ratón.
149 Para editar un archivo @file{.ly} existente, haga clic sobre él con el
150 botón derecho del ratón y elija @qq{Editar la fuente}. Para empezar
151 con un archivo vacío, arranque el editor como se describe más arriba y
152 elija @qq{Nuevo} del menú @qq{Archivo}, o haga clic con el botón
153 derecho sobre el escritorio y elija @qq{Nuevo..Documento de texto},
154 cámbiele el nombre por otro de su elección y cambie la extensión del
155 archivo a @code{.ly}. Edítelo y luego haga doble click sobre él para
156 procesarlo como se explicó antes.
158 Al hacer doble clic sobre el archivo no sólo se obtiene como resultado
159 un archivo PDF, sino también un archivo @file{.log} que contiene
160 cierta información acerca de lo que LilyPond ha hecho con el
161 archivo. Si se produce algún error, examine este archivo de registro.
166 Cree un archivo de texto con el nombre @file{prueba.ly} y escriba en él:
174 Para procesar el archivo @file{prueba.ly} haga lo siguiente:
181 Verá algo parecido a:
186 Procesando `prueba.ly'
188 Interpretando la música...
189 Preprocesando los objetos gráficos...
190 Buscando el número de páginas ideal...
191 Disponiendo la música en 1 página...
192 Dibujando los sistemas...
193 Escribiendo la página de salida en `prueba.ps'...
194 Convirtiendo a `prueba.pdf'...
198 @node Simple notation
199 @subsection Simple notation
201 LilyPond añadirá ciertos elementos de notación de manera automática.
202 En el siguiente ejemplo hemos especificado solamente cuatro alturas,
203 pero LilyPond ha añadido la clave, el compás y las duraciones.
205 @lilypond[verbatim,quote,ragged-right]
212 Este comportamiento se puede modificar, pero en general estos valores
213 automáticos son adecuados.
218 Glosario musical: @rglos{pitch}, @rglos{interval},
219 @rglos{scale}, @rglos{middle C}, @rglos{octave},
222 La manera más sencilla de introducir las notas es mediante la
223 utilización del modo @code{\relative} (relativo). En este modo, se
224 elige la octava automáticamente bajo la suposición de que la siguiente
225 nota se colocará siempre lo más cerca de la nota actual, es decir, se
226 colocará en la octava comprendida dentro de hasta tres espacios de
227 pentagrama a partir de la nota anterior. Comenzaremos por introducir
228 el fragmento musical más elemental: una @notation{escala}, donde cada
229 nota está comprendida dentro de tan sólo un espacio de pentagrama
230 desde la nota anterior.
232 @lilypond[verbatim,quote,ragged-right]
233 \relative c' { % set the starting point to middle C
239 La nota inicial es @rglos{middle C}. Cada nota sucesiva se coloca lo
240 más cerca posible de la nota previa (en otras palabras: la primera
241 @samp{c} es el Do más cercano al Do central; a éste le sigue el Re más
242 cercano a la nota previa, y así sucesivamente). Podemos crear
243 melodías con intervalos mayores, aún sin dejar de utilizar el modo
246 @lilypond[verbatim,quote,ragged-right]
253 No es necesario que la primera nota de la melodía comience exactamente
254 en aquella que especifica la altura de inicio. En el ejemplo
255 anterior, la primera nota (@code{d}) es el Re más cercano al Do
258 Añadiendo (o eliminando) comillas simples @code{'} o comas @code{,} de
259 la instrucción @code{\relative c' @{}, podemos cambiar la octava de
262 @lilypond[verbatim,quote,ragged-right]
263 \relative c'' { % one octave above middle C
268 Al principio, el modo relativo puede resultar algo confuso, pero es la
269 forma más sencilla de introducir la mayor parte de las melodías.
270 Veamos cómo funciona en la práctica este cálculo relativo. Comenzando
271 por Si, que está situado en la línea central en clave de Sol, podemos
272 alcanzar Do, Re y Mi dentro de los tres espacios de pentagrama hacia
273 arriba, y La, Sol y Fa dentro de los tres espacios hacia abajo. Por
274 tanto, si la nota siguiente a Si es Do, Re o Mi se supondrá que está
275 por encima del Si, mientras que La, Sol o Fa se entenderán situados
278 @lilypond[verbatim,quote,ragged-right]
280 b c % c is 1 staff space up, so is the c above
281 b d % d is 2 up or 5 down, so is the d above
282 b e % e is 3 up or 4 down, so is the e above
283 b a % a is 6 up or 1 down, so is the a below
284 b g % g is 5 up or 2 down, so is the g below
285 b f % f is 4 up or 3 down, so is the f below
289 Loo mismo exactamente ocurre cuando cualquiera de esas notas llevan un
290 sostenido o un bemol. Las @notation{Alteraciones accidentales} se
291 @strong{ignoran totalmente} en el cálculo de la posición relativa.
292 Exactamente la misma cuenta de espacios de pentagrama se hace a partir
293 de una nota situada en cualquier otro lugar del mismo.
295 Para añadir intervalos mayores de tres espacios de pentagrama, podemos
296 elevar la @notation{octava} añadiendo una comilla simple @code{'} (o
297 apóstrofe) a continuación del nombre de la nota. También podemos
298 bajar la octava escribiendo una coma @code{,} a continuación del
301 @lilypond[verbatim,quote,ragged-right]
310 Para subir o bajar una nota en dos (¡o más!) octavas, utilizamos
311 varias @code{''} ó @code{,,} (pero tenga cuidado de utilizar dos
312 comillas simples @code{''} ¡y no una comilla doble @code{"}@tie{}!)
313 El valor inicial de @code{\relative c'} también puede modificarse de
316 @subheading Durations (rhythms)
318 Glosario musical: @rglos{beam}, @rglos{duration}, @rglos{whole note},
319 @rglos{half note}, @rglos{quarter note}, @rglos{dotted note}.
321 La @notation{duración} de una nota se especifica mediante un número
322 después del nombre de la nota. @code{1} significa @rglos{redonda},
323 @code{2} significa @rglos{blanca}, @code{4} significa @rglos{negra} y
324 así sucesivamente. Las @notation{barras de corchea} se añaden
327 Si no especifica una duración, se utiliza la duración previa para la
328 nota siguiente. La figura por omisión de la primera nota es una
331 @lilypond[quote,ragged-right,verbatim]
335 a16 a a a a32 a a a a64 a a a a a a a a2
339 Para crear notas con puntillo (véase @rglos{dotted note}), añada un
340 punto @samp{.} al número de la duración. La duración de una nota con
341 puntillo se debe especificar de forma explícita (es decir: mediante un
344 @lilypond[quote,ragged-right,verbatim]
354 Glosario musical: @rglos{rest}.
356 Un @notation{rest} se introduce igual que si fuera una nota con el
359 @lilypond[verbatim,quote,ragged-right]
367 @subheading Time signature
369 Glosario musical: @rglos{time signature}.
371 La @notation{indicación de compás} se puede establecer con la orden
374 @lilypond[quote,ragged-right,verbatim]
388 Glosario musical: @rglos{clef}.
390 La @notation{clave} se puede establecer utilizando la orden
393 @lilypond[quote,ragged-right,verbatim]
407 @subheading All together
409 He aquí un pequeño ejemplo que muestra todos los elementos anteriores
412 @lilypond[quote,ragged-right,verbatim]
423 Referencia de la notación: @ruser{Writing pitches},
424 @ruser{Writing rhythms}, @ruser{Writing rests},
425 @ruser{Time signature}, @ruser{Clef}.
428 @node Working on text files
429 @subsection Working on text files
431 Los archivos de entrada de LilyPond son como los archivos fuente de
432 muchos lenguajes de programación corrientes. Son sensibles a las
433 mayúsculas e insensibles al número de espacios Las expresiones se
434 forman con llaves @{ @} y los comentarios se denotan por un signo de
435 porcentaje (@code{%}) o por @code{%@{ ... %@}}.
437 Si la frase anterior no tiene sentido para usted ¡no se preocupe! A
438 continuación explicaremos el significado de todos estos términos:
442 @cindex Sensible a las mayúsculas
443 @item @strong{Sensible a las mayúsculas}:
444 tiene importancia el hecho de que introduzca una letra en minúsculas
445 (p.ej. @code{a, b, s, t}) o en mayúsculas (p.ej. @code{A, B, S, T}).
446 Las notas son minúsculas: @code{@{ c d e @}} es una entrada válida;
447 @code{@{ C D E @}} produciría un mensaje de error.
449 @item @strong{Insensible al número de espacios}:
450 no importa cuántos espacios (o saltos de línea) añada. @code{@{ c d e
451 @}} significa lo mismo que @code{@{ c @tie{} @tie{} @tie{} d e @}} y
460 Por supuesto, el ejemplo anterior es difícil de leer. Una regla
461 práctica es sangrar los bloques de código con un carácter de
462 tabulación, o bien con dos espacios:
471 @strong{Expresiones:}
472 Todo fragmento de código de entrada para LilyPond ha de llevar
473 @strong{@{ llaves @}} antes y después de la entrada. Estas llaves le dicen a
474 LilyPond que la entrada es una expresión musical unitaria, igual que
475 los paréntesis @samp{()} de las matemáticas. Las llaves deben ir rodeadas
476 de un espacio a no ser que se encuentren al comienzo o al final de una
477 línea, para evitar cualquier ambigüedad.
479 Una instrucción de LilyPond seguida de una expresión simple entre
480 llaves (como por ejemplo @code{\relative @{ @}}) también es una
481 expresión musical unitaria.
484 @cindex comentario de línea
485 @cindex comentario de bloque
487 @strong{Comentarios}:
488 Un comentario es una nota para el lector humano de la entrada musical;
489 se ignora cuando esta entrada se analiza, de manera que no tiene
490 ningún efecto sobre la salida impresa. Existen dos tipos de
491 comentarios. El símbolo de porcentaje @samp{%} introduce un
492 comentario de línea; todo lo que se encuentra después de @samp{%} en
493 esa línea se ignora. Por convenio, una línea de comentario se coloca
494 @emph{por encima} del código a que se refiere el comentario.
498 % este comentario se refiere a las notas Si
502 Un comentario de bloque marca una sección entera de entrada musical
503 como comentario. Todo lo que está encerrado dentro de @code{%@{} y
504 @code{%@}} se ignora (pero los comentarios no pueden anidarse, lo que
505 signnifica que un comentario de bloque no puede incluir otros
506 comentarios de bloque). Si lo hiciera, el primer @code{%@}} daría por
507 terminado @emph{los dos} comentarios de bloque. El siguiente
508 fragmento muestra algunos posibles usos para los comentarios:
511 % a continuación van las notas de campanitas del lugar
515 Esta línea y las notas que aparecen más abajo
516 se ignoran, por estar dentro de un
517 comentario de bloque.
526 @node How to read the manual
527 @subsection How to read the manual
529 Como vimos en @ref{Working on text files}, la entrada de LilyPond debe
530 estar rodeada de llaves @{ @} o de @code{\relative c'' @{ ... @}}.
531 Durante el resto del presente manual, la mayor parte de los ejemplos
532 omitirán las llaves. Para reproducir los ejemplos, deberá copiar y
533 pegar la entrada que se muestra, pero @strong{deberá} escribir
534 @code{\relative c'' @{ @}}, de la siguiente forma:
536 Si está leyendo la documentación HTML y quiere ver el código de LilyPond exacto
537 que se utilizó para crear el ejemplo, sencillamente haga clic
538 sobre la imagen. Si no está leyendo la versión en HTML, podría
539 copiar y pegar la entrada que se muestra, pero @strong{deberá} añadir
540 @code{\relative c'' @{ @}} de la siguiente manera:
544 ... aquí va el ejemplo...
548 ¿Por qué omitir las llaves? Casi todos los ejemplos del presente
549 manual se pueden insertar en medio de un fragmento mayor de música.
550 Para estos ejemplos no tiene ningún sentido añadir @code{\relative c''
551 @{ @}} (¡no debería poner un @code{\relative} dentro de otro
552 @code{\relative}!); si hubiésemos incluido @code{\relative c'' @{ @}}
553 rodeando a cada uno de los ejemplos, usted no podría copiar un ejemplo
554 pequeño procedente de la documentación y pegarlo dentro de su propia
555 pieza. La mayoría querrá insertar el código dentro de una pieza más
556 grande, por eso hemos formateado el manual de esta forma.
560 @subheading Clickable examples
562 Muchas personas aprenden a utilizar programas probando y enredando con ellos.
563 Esto también puede hacerse con LilyPond. Si hace clic sobre una imagen
564 en la versión en HTML de este manual, podrá ver la entrada exacta de LilyPond
565 que se utilizó para generar esa imagen.
566 Pruébelo sobre esta imagen:
569 @lilypond[quote,ragged-right]
571 c-\markup { \bold \huge { Click here. } }
575 Cortando y pegando todo lo que se encuentra dentro de la sección
576 @qq{ly snippet} (fragmento de tipo ly), tendrá una plantilla inicial
577 para sus experimentos. Para poder ver exactamente el mismo resultado
578 (con igual anchura de línea y todo), copie todo lo que está desde
579 @qq{Start cut-&-pastable section} hasta el final del archivo.
584 Podrá encontrar más consejos y trucos para la construcción de archivos
585 de entrada en @ref{Suggestions for writing LilyPond files}; pero
586 podría ser mejor leer primero el resto del presente manual.
589 @node Single staff notation
590 @section Single staff notation
592 Esta sección es una introducción a la notación corriente que se utiliza para una voz
596 * Relative note names::
597 * Accidentals and key signatures::
599 * Articulation and dynamics::
600 * Automatic and manual beams::
601 * Advanced rhythmic commands::
605 @node Relative note names
606 @subsection Relative note names
608 Como hemos visto en @ruser{Simple notation}, LilyPond calcula la altura de
609 cada nota de forma relativa respecto de la nota anterior@footnote{Existe otra forma de
610 introducir las alturas, @ruser{Absolute note names}, pero en la práctica el modo
611 relativo es mucho más cómodo y seguro de utilizar.}. Si no se añade ninguna marca de octava
612 (@code{'} y @code{,}), se supone que cada altura se encuentra dentro de una
613 cuarta desde la nota anterior.
615 LilyPond examina las alturas basándose en los nombres de las notas (dicho de otra forma:
616 una cuarta aumentada @emph{no} es lo mismo que una quinta disminuida. Si
617 empezamos en un Do, un Fa sostenido situado a continuación se colocará por encima del Do, mientras que
618 un Sol bemol se colocará por debajo de este mismo Do.
620 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
628 @item Octavas relativas
629 ver @ruser{Relative octaves}.
630 @item Comprobación de octava
631 ver @ruser{Octave check}.
637 @node Accidentals and key signatures
638 @subsection Accidentals and key signatures
640 @subheading Accidentals
642 Una nota @rglos{sharp} se hace añadiendo @samp{is} al
643 nombre, y una nota @rglos{flat} añadiendo @samp{es}. Como
644 ha podido adivinar, un @rglos{double sharp} o @rglos{double flat} se hace
645 añadiendo @samp{isis} o @samp{eses}@footnote{Esta sintaxis
646 derivó de las convenciones de las lenguas nórdicas y germánicas para nombrar las notas
647 como el alemán y el holandés. Para utilizar otros nombres para las alteraciones accidentales, vea
648 @ruser{Note names in other languages}.}
650 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
651 cis1 ees fisis, aeses
654 @cindex tonalidad, armadura de la, establecer
655 @subheading Key signatures
657 La armadura de la tonalidad se establece mediante la instrucción @code{\key} seguido de
658 una nota y @code{\major} o @code{\minor}.
660 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
669 @subheading Warning: key signatures and pitches
671 Para determinar si hay que imprimir una alteración accidental, LilyPond examina las
672 notas y la armadura de la tonalidad. La armadura solamente afecta a las
673 alteraciones @emph{impresas}, ¡no a las propias notas! Ésta es una
674 funcionalidad que frecuentemente confunde a los que se inician con el programa, por ello permítanos explicarla
677 LilyPond hace una clara distinción entre el contenido musical y la
678 presentación. La alteración (bemol, becuadro o sostenido) de una nota es parte de
679 la altura, y por tanto es contenido musical. Si una alteración (un
680 signo @emph{impreso} de bemol, becuadro o sostenido) se imprime o no delante de la
681 nota correspondiente, es una cuestión de presentación. La presentación es algo que
682 sigue unas reglas, así que las alteraciones accidentales se imprimen automáticamente según
683 dichas reglas. Las alturas de las notas en su música son obras de arte, por tanto no se
684 añadirán automáticamente, y usted deberá introducir aquello que quiera oír.
686 En el siguiente ejemplo
688 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
694 ninguna nota lleva una alteración impresa, pero de todas formas usted debe añadir la @samp{is} a
695 @code{cis} y a @code{fis}.
697 El texto @samp{e} no significa @qq{imprimir una bolita negra en la
698 primera línea del pentagrama.} Más bien significa: @qq{hay una nota
699 Mi natural.} En la tonalidad de La bemol mayor, @emph{lleva} una
700 alteración accidental:
702 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
707 Poner todas las alteraciones de forma explícita puede que requiera algo más de trabajo
708 al teclear, pero la ventaja es que la transposición es más fácil, y las
709 alteraciones se pueden imprimir siguiendo varias convenciones distintas. Consulte
710 @ruser{Automatic accidentals} para ver ejemplos de cómo se pueden imprimir las alteraciones
711 de acuerdo a reglas diferentes.
716 @item Alteraciones accidentales
717 ver @ruser{Accidentals} y @ruser{Automatic accidentals}.
718 @item Armadura de la tonalidad
719 ver @ruser{Key signature}.
725 @subsection Ties and slurs
727 @cindex ligaduras de unión
729 Una @rglos{tie} se crea adjuntando un carácter tilde @samp{~} a la primera
732 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
737 @cindex ligaduras de expresión
740 Una @rglos{slur} es una curva que se traza abarcando varias notas. Las notas inicial
741 y final se marcan mediante @samp{(} y @samp{)} respectivamente.
743 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
744 d4( c16) cis( d e c cis d) e( d4)
747 @cindex fraseo, ligaduras de
748 @cindex ligaduras de fraseo
749 @subheading Phrasing slurs
751 Las ligaduras que se utilizan para indicar fraseos más largos se pueden introducir mediante @code{\(} y
752 @code{\)}. Puede haber al mismo tiempo ligaduras de legato y ligaduras de fraseo,
753 pero no es posible tener legatos simultáneos o ligaduras de expresión
756 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
757 a8(\( ais b c) cis2 b'2 a4 cis,\)
762 @cindex ligaduras de expresión frente a ligaduras de unión
763 @subheading Warnings: slurs vs. ties
765 Una ligadura de expresión parece una @rglos{tie}, pero tiene un significado distinto. Una
766 ligadura (de unión) sencillamente hace que la primera nota sea más larga, y sólo se puede utilizar sobre
767 parejas de notas iguales. Las ligaduras de expresión indican las articulaciones
768 de las notas, y se pueden utilizar sobre grupos mayores de notas. Las ligaduras de unión y de expresión
769 se pueden anidar unas dentro de otras.
771 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
772 c2~( c8 fis fis4 ~ fis2 g2)
778 @item Ligaduras de unión
780 @item Ligaduras de expresión
782 @item Ligaduras de fraseo
783 ver @ruser{Phrasing slurs}.
788 @node Articulation and dynamics
789 @subsection Articulation and dynamics
794 @subheading Articulations
796 Las articulaciones (véase @rglos{articulation}) más corrientes se pueden añadir a las notas utilizando un guión @samp{-}
797 seguido de un carácter único:
799 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
800 c-. c-- c-> c-^ c-+ c-_
804 @subheading Fingerings
805 De manera similar, las indicaciones de digitación se pueden añadir a una nota utilizando un guión
806 (@samp{-}) seguido del dígito deseado:
808 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
812 Las articulaciones y digitaciones normalmente se colocan de forma automática, pero puede
813 especificar una dirección mediante @samp{^} (encima) o @samp{_} (debajo). También
814 puede usar varias articulaciones sobre la misma nota. Sin embargo, casi siempre
815 es mejor dejar que LilyPond determine la dirección de las articulaciones.
817 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
818 c_-^1 d^. f^4_2-> e^-_+
822 Las expresiones de matiz o signos dinámicos se hacen añadiendo las marcas (con una barra invertida) a la
825 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
829 @cindex expresiones dinámicas
833 Los crescendi y decrescendi comienzan con las órdenes @code{\<} y
834 @code{\>}. Una expresión terminal de matiz, como por ejemplo @code{\f}, dará por terminado el
835 (de)crescendo, o bien se puede usar la orden @code{\!}:
837 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
845 ver @ruser{Articulations}.
847 ver @ruser{Fingering instructions}.
849 ver @ruser{Dynamics}.
854 @node Automatic and manual beams
855 @subsection Automatic and manual beams
857 @cindex barras, establecimiento manual
858 Todas las @rglos{beam}s se dibujan automáticamente:
859 @c aquí hay un problema con el plural. FVD
860 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
861 a8 ais d ees r d c16 b a8
865 Si no le gustan las barras automáticas, pueden forzarse
866 manualmente. Marque la primera nota que comprende la barra con @samp{[} y la última
869 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
870 a8[ ais] d[ ees r d] a b
876 @item Barras automáticas
877 ver @ruser{Automatic beams}.
878 @item Barras manuales
879 ver @ruser{Manual beams}.
884 @node Advanced rhythmic commands
885 @subsection Advanced rhythmic commands
888 @c @cindex anacruse @c redundant, in spanish. FVD
889 @cindex compás parcial
890 @subheading Partial measure
892 Una anacrusa (o @rglos{anacrusis}) se introduce con la palabra clave
893 @code{\partial}. Va seguida de una duración: @code{\partial 4} es
894 una anacrusa de negra y @code{\partial 8} de corchea.
896 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
901 @cindex grupos especiales
905 Los grupos especiales como los tresillos se hacen con la palabra clave @code{\times}. Requiere dos
906 argumentos: una fracción y un fragmento de música. La duración del fragmento
907 de música se multiplica por la fracción. Los tresillos hacen que las notas ocupen
908 2/3 de su duración expresa, por tanto un tresillo lleva una fracción de 2/3
910 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
911 \times 2/3 { f8 g a }
913 \times 2/3 { f,8 g16[ a g a] }
917 @cindex notas de adorno
920 @subheading Grace notes
922 Las notas de adorno se crean con la instrucción @code{\grace}, aunque
923 también se pueden conseguir precediendo una expresión musical por la
924 palabra clave @code{\appoggiatura} o @code{\acciaccatura}
926 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
927 c2 \grace { a32[ b] } c2
928 c2 \appoggiatura b16 c2
929 c2 \acciaccatura b16 c2
935 @item Notas de adorno
936 ver @ruser{Grace notes},
937 @item Grupos especiales
940 ver @ruser{Partial measures}.
945 @node Multiple notes at once
946 @section Multiple notes at once
948 Esta sección es una introducción a las notas simultáneas:
949 varios instrumentos, varios pentagramas para un solo instrumento (p.ej. piano)
952 La palabra @q{polifonía} en música hace referencia al hecho de tener más de una voz en un momento determinado
953 dentro de una pieza musical. La palabra @q{polifonía} en LilyPond se refiere al hecho de tener más de
954 una voz en el mismo pentagrama.
957 * Music expressions explained::
960 * Combining notes into chords::
961 * Single staff polyphony::
965 @node Music expressions explained
966 @subsection Music expressions explained
968 En los archivos de entrada de LilyPond, la música se representa mediante @emph{expresiones
969 musicales}. Una sola nota es una expresión musical, aunque no es una
970 entrada válida por sí sola.
972 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
976 Al encerrar un grupo de notas dentro de llaves creamos una expresión musical:
978 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
982 Si colocamos un grupo de expresiones musicales (p.ej.: notas) dentro de llaves, eso significa que
983 se encuentran en secuencia (es decir, cada una sigue a la anterior). El resultado
984 es otra expresión musical:
986 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
990 @subheading Simultaneous music expressions: multiple staves
992 Esta técnica es muy útil para la música polifónica. Para introducir música
993 con más voces o con más pentagramas, lo que hacemos es combinar varias expresiones en
994 paralelo. Para indicar que dos voces se deben interpretar al mismo tiempo,
995 sencillamente introduzca una combinación simultánea de expresiones musicales. Una
996 expresión musical @q{simultánea} se forma encerrando las expresiones dentro de
997 @code{<<} y @code{>>}. En el ejemplo que sigue, tres secuencias (cada una de las cuales
998 contiene dos notas diferentes) se combinan de forma simultánea:
1000 @lilypond[quote,ragged-right,verbatim]
1010 Tenga en cuenta que hemos sangrado cada nivel jerárquico de la entrada con un margen
1011 distinto. A LilyPond no le importa cuánto (o cuán poco) espacio haya
1012 al comienzo de una línea, pero el establecimiento de márgenes distintos dentro del código de LilyPond, de esta forma, lo
1013 hace mucho más fácil de leer por nosotros los seres humanos.
1015 @strong{Advertencia}: cada nota se entiende relativa a la
1016 nota anterior de la entrada, no relativa a la @code{c''} dentro de la
1017 instrucción inicial @code{\relative}.
1020 @subheading Simultaneous music expressions: single staff
1022 Para determinar el número de pentagramas en una pieza, LilyPond examina la primera
1023 expresión. Si ésta consiste en una sola nota, hay un solo pentagrama; si hay una
1024 expresión simultánea, hay más de un pentagrama.
1026 @lilypond[quote,ragged-right,verbatim]
1029 << { e f } { c <<b d>> } >>
1034 @cindex expresión musical
1035 @subheading Analogy: mathematical expressions
1037 Este mecanismo es semejante a las fórmulas
1038 matemáticas: una fórmula grande se construye combinando fórmulas pequeñas. Dichas
1039 fórmulas se llaman expresiones, y su definición es recursiva de tal forma que
1040 se pueden construir expresiones de un tamaño y complejidad arbitrarios. Por ejemplo:
1049 ((1 + 2) * 3) / (4 * 5)
1052 Ésta es una secuencia de expresiones donde cada expresión se encuentra contenida dentro
1053 de la siguiente, más grande. Las expresiones más simples son números, y las mayores
1054 se hacen combinando expresiones mediante operadores (como @samp{+},
1055 @samp{*} y @samp{/}) y paréntesis. Del mismo modo que las expresiones matemáticas,
1056 las expresiones musicales se pueden anidar a una profundidad arbitraria, lo que se hace necesario
1057 para músicas complejas como las partituras polifónicas.
1060 @node Multiple staves
1061 @subsection Multiple staves
1063 Como ya hemos visto en @ruser{Music expressions explained}, los archivos de entrada para LilyPond
1064 se construyen a base de expresiones musicales. Si la partitura comienza con
1065 expresiones musicales simultáneas, LilyPond crea varios pentagramas. Sin embargo
1066 es más fácil ver lo que ocurre si creamos cada uno de los pentagramas de forma explícita.
1068 Para imprimir más de un pentagrama, cada fragmento de música que constituye un
1069 pentagrama se marca escribiendo @code{\new Staff} antes de él. Estos
1070 elementos @code{Staff} se combinan después en paralelo con @code{<<} y
1073 @lilypond[quote,ragged-right,verbatim]
1076 \new Staff { \clef treble c }
1077 \new Staff { \clef bass c,, }
1082 La instrucción @code{\new} inaugura un @q{contexto de notación}. Un contexto de
1083 notación es un entorno dentro del que se interpretan los acontecimientos musicales (como las notas o las
1084 instrucciones @code{\clef}). Para piezas sencillas, tales
1085 contextos de notación se crean automáticamente. Para piezas más complicadas, es mejor
1086 marcar los contextos de forma explícita.
1088 Existen varias clases de contextos. @code{Score}, @code{Staff}
1089 y @code{Voice} manejan la notación melódica, mientras que @code{Lyrics} se ocupa de los textos
1090 cantados y @code{ChordNames} imprime los nombres de los acordes.
1092 En términos de sintaxis, la anteposición de @code{\new} a una expresión musical
1093 crea una expresión musical mayor. Es semejante al signo
1094 menos de las matemáticas. La fórmula @math{(4+5)} es una expresión, por tanto
1095 @math{-(4+5)} es una expresión más amplia.
1097 Las indicaciones de compás escritas en un pentagrama afectan al
1098 resto de ellos@footnote{Este comportamiento se puede cambiar si uno lo desea; consulte
1099 @ruser{Polymetric notation} para ver más detalles.}. En cambio,
1100 la armadura de la tonalidad de un pentagrama @emph{no} afecta a los otros
1103 @lilypond[quote,ragged-right,verbatim]
1106 \new Staff { \clef treble \time 3/4 c }
1107 \new Staff { \clef bass \key d \major c,, }
1116 @subsection Piano staves
1118 @cindex salto de pentagrama, establecimiento manual
1119 @cindex voz de pentagrama cruzado, establecimiento manual
1120 La música para piano se compone tipográficamente en forma de dos pentagramas unidos mediante una llave. El aspecto impreso de
1121 este sistema de pentagramas se parece al ejemplo polifónico que aparece en @ruser{Multiple staves},
1122 pero en esta ocasión la expresión completa se coloca dentro de un @code{PianoStaff}:
1131 He aquí un pequeño ejemplo:
1133 @lilypond[quote,ragged-right,verbatim]
1136 \new Staff { \time 2/4 c4 e g g, }
1137 \new Staff { \clef bass c,, c' e c }
1144 Ver @ruser{Piano music}.
1147 @node Combining notes into chords
1148 @subsection Combining notes into chords
1151 Los acordes se hacen rodeando las notas con paréntesis en ángulo simples. Los paréntesis
1152 en ángulo son los símbolos @samp{<} (menor que) y @samp{>} (mayor que).
1154 @lilypond[quote,fragment,verbatim,relative=2,fragment]
1155 r4 <c e g>4 <c f a>2
1158 Se pueden combinar las marcas como barras y ligaduras con acordes. Se deben
1159 colocar por fuera de los paréntesis en ángulo:
1161 @lilypond[quote,fragment,verbatim,relative=2,fragment]
1162 r4 <c e g>8[ <c f a>]~ <c f a>2
1165 @lilypond[quote,fragment,verbatim,relative=2,fragment]
1166 r4 <c e g>8\>( <c e g> <c e g>4 <c f a>\!)
1169 @node Single staff polyphony
1170 @subsection Single staff polyphony
1173 @cindex varias voces
1174 @cindex voces, más (en un solo pentagrama)
1175 Cuando distintas líneas melódicas se combinan sobre un solo pentagrama, se
1176 imprimen como voces polifónicas; cada voz lleva sus propias plicas, ligaduras y
1177 barras de corchea, y la voz superior tiene las plicas hacia arriba mientras que la voz inferior las
1180 La introducción de estas partes se hace escribiendo cada voz en forma de secuencia (con
1181 @code{@{...@}}) y combinando éstas de forma simultánea, separando las
1184 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
1191 Para el tipografiado de música polifónica, puede ser conveniente la utilización de silencios separadores, o sea,
1192 silencios que no aparecen impresos. Son muy útiles para rellenar
1193 voces que temporalmente no están cantando. He aquí el mismo ejemplo con un
1194 silencio separador (@samp{s}) en vez de un silencio normal (@samp{r}):
1196 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
1204 Una vez más, las expresiones de este tipo se pueden anidar de forma arbitraria.
1206 @lilypond[quote,fragment,verbatim,relative=2,fragment]
1214 { <c g>1 ~ <c g>4 } \\
1222 Ver @ruser{Basic polyphony}.
1229 Esta sección es una introducción a la música vocal y a las partituras de canciones sencillas.
1237 @node Printing lyrics
1238 @subsection Printing lyrics
1242 Consideremos una melodía sencilla:
1244 @lilypond[quote,ragged-right,verbatim]
1251 La letra se puede asignar a esas notas, combinando ambas con la
1252 palabra clave @code{\addlyrics}. La letra se escribe separando cada
1253 sílaba mediante un espacio.
1255 @lilypond[quote,ragged-right,verbatim]
1261 \addlyrics { One day this shall be free }
1266 @cindex línea de extensión de sílabas
1267 Esta melodía acaba en un @rglos{melisma}, una sílaba única (@q{suelta})
1268 que se canta sobre más de una nota. Esto se indica mediante una @emph{línea
1269 de extensión}. Se escribe como dos guiones bajos @code{__}:
1271 @lilypond[quote,ragged-right,verbatim]
1277 \addlyrics { One day this shall be free __ }
1281 De forma parecida, los guiones entre las palabras se pueden escribir como dos guiones,
1282 dando como resultado unas líneas cortas entre cada dos sílabas:
1284 @c aquí no se pone ragged-right porque los guiones se perderían.
1285 @lilypond[quote,verbatim]
1291 \addlyrics { A -- le -- gri -- a }
1297 Otras posibilidades como poner varios versos debajo de una melodía, se
1298 discuten en @ruser{Vocal music}.
1303 @subsection A lead sheet
1305 @cindex Hojas guía de acordes
1307 @cindex nombres de los acordes
1309 En la música pop es muy común denotar el acompañamiento con los nombres de los acordes.
1310 Estos acordes se pueden escribir como notas:
1312 @lilypond[quote,ragged-right,verbatim]
1313 \chordmode { c2 f4. g8 }
1316 Ahora, cada altura se lee como la fundamental de un acorde en vez de como una nota.
1317 Este modo se activa con @code{\chordmode}. Otros acordes pueden
1318 construirse añadiendo modificadores después de un signo de dos puntos. El
1319 ejemplo que sigue muestra algunos modificadores comunes:
1321 @lilypond[quote,verbatim,ragged-right]
1322 \chordmode { c2 f4:m g4:maj7 gis1:dim7 }
1325 Para canciones con acordes, éstos no se imprimen sobre pentagramas, sino como nombres en su
1326 propia línea. Esto se consigue utilizando @code{\chords} en sustitución
1327 de @code{\chordmode}. Utiliza la misma sintaxis que @code{\chordmode},
1328 pero pinta las notas dentro de un contexto de @code{ChordNames}, con el
1329 siguiente resultado:
1331 @lilypond[quote,verbatim,ragged-right]
1332 \chords { c2 f4.:m g4.:maj7 gis8:dim7 }
1335 @cindex hoja guía de acordes
1336 Cuando se combinan, los nombres de acorde, la letra y la melodía forman
1337 una hoja de canción con acordes (@q{lead sheet}):
1339 @lilypond[quote,verbatim,ragged-right]
1341 \chords { c2 g:sus4 f e }
1346 \addlyrics { One day this shall be free __ }
1353 Puede ver una lista completa de los modificadores y otras opciones de presentación
1359 @section Final touches
1361 Éste es el último apartado del tutorial; muestra la forma de dar los toques finales
1362 a piezas sencillas, y ofrece una introducción al resto
1368 * Absolute note names::
1369 * Organizing pieces with identifiers::
1370 * After the tutorial::
1371 * How to read the manual::
1375 @node Version number
1376 @subsection Version number
1378 @cindex indicación de la versión
1379 La indicación @code{\version} deja registrado para qué versión de LilyPond se escribió
1383 \version @w{"@version{}"}
1387 por convenio se sitúa al principio del archivo de partitura de LilyPond.
1389 Estas anotaciones hacen menos problemáticas las subsiguientes actualizaciones de LilyPond.
1390 Los cambios en la sintaxis se tratan mediante un programa especial,
1391 @file{convert-ly} (ver @rprogram{Updating files with convert-ly}), y utiliza
1392 @code{\version} para determinar qué reglas hay que aplicar.
1396 @subsection Adding titles
1398 La información sobre el título, autor, número de Opus y similares se escriben
1399 en el bloque @code{\header}. Éste se encuentra fuera de la expresión musical
1400 principal; el bloque @code{\header} normalmente se sitúa por debajo del
1401 @ruser{Version number}.
1404 \version @w{"@version{}"}
1412 @dots{} music @dots{}
1416 Cuando se procesa el archivo, el título y el autor se imprimen por encima
1417 de la música. Puede obtener más información sobre los títulos en @ruser{Creating
1421 @node Absolute note names
1422 @subsection Absolute note names
1424 Hasta el momento siempre hemos utilizado @code{\relative} para definir las alturas. Ésta es la
1425 forma más sencilla de escribir la mayor parte de la música, pero existe otra forma de definir
1426 las alturas: el modo absoluto.
1428 Si omite el @code{\relative}, LilyPond tratará todas las alturas como
1429 valores absolutos. Una @code{c'} significará siembre un Do central, una @code{b} significará
1430 siempre la nota inmediatamente por debajo del Do central, y una @code{g,} significará
1431 siempre la nota que se coloca en la primera línea del pentagrama en clave de Fa.
1433 @lilypond[quote,verbatim,ragged-right]
1441 He aquí una escala que abarca cuatro octavas:
1443 @lilypond[quote,verbatim,ragged-right]
1458 Como puede ver, escribir una melodía en clave de Sol implica escribir gran cantidad de
1459 apóstrofes ' . Consideremos este fragmento de Mozart:
1461 @lilypond[quote,verbatim,ragged-right]
1465 cis''8. d''16 cis''8 e''4 e''8
1466 b'8. cis''16 b'8 d''4 d''8
1470 Todos estos apóstrofes hacen casi ilegible el código de entrada y será origen de numerosos
1471 errores. Con @code{\relative}, el ejemplo anterior es mucho más fácil
1474 @lilypond[quote,verbatim,ragged-right]
1478 cis8. d16 cis8 e4 e8
1483 Si comete un error con una marca de octava (@code{'} o @code{,}) mientras
1484 trabaja en el modo @code{\relative}, será muy obvio (muchas notas estarán
1485 en la octava equivocada). Mientras trabaja en el modo absoluto, un solo fallo
1486 no será tan visible, y tampoco será tan fácil de localizar.
1488 Sin embargo, el modo absoluto es útil para escribir música que contenga intervalos grandes, y
1489 será extremadamente útil para hacer archivos de LilyPond generados por ordenador.
1492 @node Organizing pieces with identifiers
1493 @subsection Organizing pieces with identifiers
1495 Cuando los elementos que hemos discutido anteriormente se combinan para producir
1496 archivos mayores, las expresiones musicales se hacen enormes. En música
1497 polifónica con muchos pentagramas, los archivos de entrada pueden volverse muy propensos a la confusión. Podemos
1498 reducir esta confusión utilizando los @emph{identificadores}.
1500 Con los identificadores (también conocidos como variables o macros), podemos trocear las
1501 expresiones musicales complejas. Un identificador se asigna de la manera siguiente:
1504 musicaConNombre = @{ @dots{} @}
1507 El contenido de la expresión musical @code{musicaConNombre} se puede usar
1508 posteriormente colocando una barra invertida delante del nombre
1509 (@code{\musicaConNombre}, igual que una orden normal de LilyPond). Los identificadores
1510 se deben definir @emph{antes} de la expresión musical principal.
1512 @lilypond[quote,verbatim,ragged-right]
1513 violin = \new Staff { \relative c'' {
1516 cello = \new Staff { \relative c {
1529 El nombre de un identificador debe consistir enteramente en caracteres alfabéticos, es decir
1530 sin números, guiones ni guiones bajos.
1532 Es posible utilizar variables para otras muchas clases de objetos en el código de
1533 entrada. Por ejemplo:
1538 aFivePaper = \paper @{ paperheight = 21.0 \cm @}
1541 Dependiendo de su contenido, el identificador se puede usar en distintos
1542 lugares. El siguiente ejemplo utiliza las variables anteriores:
1553 @node After the tutorial
1554 @subsection After the tutorial
1556 Después de terminar el tutorial, quizá debería probar a escribir una o dos
1557 piezas. Comience con una de las @ruser{Templates} y añada algunas
1558 notas. Si necesita un tipo de notación que no ha sido tratada en el
1559 tutorial, eche un vistazo a la Referencia de Notación, empezando por
1560 @ruser{Basic notation}. Si quiere escribir música para un conjunto
1561 instrumental que no está cubierto por ninguna plantilla,
1562 consulte @ruser{Extending the templates}.
1564 Una vez que ha escrito algunas piezas cortas, lea el resto del
1565 Manual de aprendizaje (capítulos 3 al 5). ¡Por supuesto, no pasa nada por
1566 leerlo ahora mismo! Sin embargo, el resto del Manual
1567 de Aprendizaje da por sentado que está familiarizado con la entrada
1568 de LilyPond. Puede saltarse estos capítulos ahora
1569 y volver a ellos cuando haya adquirido más experiencia.
1572 @node How to read the manual
1573 @subsection How to read the manual
1575 Como ya vimos en @ruser{How to read the tutorial}, muchos ejemplos del
1576 tutorial omitían el @code{\relative c'' @{ ... @}} alrededor del ejemplo
1579 Durante el resto del manual seremos mucho menos estrictos respecto de los
1580 ejemplos impresos: a veces pueden omitir el
1581 @code{\relative c'' @{ ... @}}, pero otras veces se puede usar una nota inicial
1582 diferente (como @code{c'} o @code{c,,}), y en ocasiones
1583 ¡todo el ejemplo estará en el modo de notas absoluto! Sin embargo, las ambigüedades de esta clase
1584 existen solamente allí donde las alturas no son lo más importante. En aquellos ejemplos
1585 en los que las alturas tienen importancia, hemos escrito explícitamente @code{\relative}
1586 o bien el @code{@{ @}} en modo absoluto.
1588 Si aún tiene dudas respecto de la entrada de LilyPond exacta que se
1589 ha utilizado en un ejemplo, lea la versión HTML (si no lo está haciendo ya)
1590 y pulse con el ratón sobre la imagen de la música. De esta forma se mostrará la entrada
1591 exacta que LilyPond usó para generar este manual.
1593 Para informarse sobre la estructura que tiene el resto del manual, consulte
1594 @ruser{About this manual}.