X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Fes%2Fuser%2Ftutorial.itely;h=2f6aa3bd3435f2c1dfb9237a3492e25971587fd0;hb=edf17353d89f4f6bd831466262402bb9151a26ca;hp=3f0b57adc58e45d4b47020f3faf07a0f216dbf0c;hpb=555d8e498a31380d62be9f4853ab514b3786e986;p=lilypond.git diff --git a/Documentation/es/user/tutorial.itely b/Documentation/es/user/tutorial.itely index 3f0b57adc5..2f6aa3bd34 100644 --- a/Documentation/es/user/tutorial.itely +++ b/Documentation/es/user/tutorial.itely @@ -1,66 +1,42 @@ @c -*- coding: utf-8; mode: texinfo; -*- -@c This file is part of lilypond.tely +@c This file is part of lilypond-learning.tely @ignore - Translation of GIT committish: 4d9a81ea05bea52229dd9045b9eceecd64dbe61d + Translation of GIT committish: e007b6bd3b3328581df4998247fd92d9d66ce07c When revising a translation, copy the HEAD committish of the version that you are working on. See TRANSLATION for details. @end ignore +@c \version "2.11.51" + @ignore -Tutorial guidelines: +Tutorial guidelines: (different from policy.txt!) - unless you have a really good reason, use either - @l ilypond[quote,ragged-right,verbatim] + @lilypond[verbatim,quote,ragged-right] or - @l ilypond[quote,ragged-right,verbatim,fragment,relative=2] - (without spaces) + @lilypond[verbatim,quote,ragged-right,fragment,relative=2] + Don't use any other relative=X commands (make it a non-fragment example), and don't use fragment without relative=2. -- use "aes" and "ees" instead of "as" and "aes". I know it's not - correct Dutch naming, but let's not confuse people with this until - we get to the Basic notation chapter. -@end ignore +- use "aes" and "ees" instead of "as" and "es". I know it's not + correct Dutch naming, but let's not confuse people with this + until we get to the Basic notation chapter. +- Add "Music Glossary: @rglos{foo}" to the _top_ of the relevant + portions of the tutorial. -@c old info that will probably be removed. -@c TODO: -@c * more details about running lilypond; error messages, -@c compiling/viewing (emacs?) -@c * where to go from First steps+More basics? - -@c wherever possible, do not include index entries here; the -@c index should point to stuff in the reference manual. -gp +@end ignore -@c Your first LilyPond score in 10 minutes? @node Tutorial @chapter Tutorial -Este tutorial comienza con una introducción al lenguaje musical LilyPond -y cómo producir música impresa. Después de este primer contacto, -explicaremos cómo crear notación musical usual. - -@ifhtml -Muchas personas aprenden a utilizar programas probando y enredando con ellos. -Esto también puede hacerse con LilyPond. Si hace clic sobre una imagen -en la versión en HTML de este manual, podrá ver la entrada exacta de LilyPond -que se utilizó para generar esa imagen. -Pruébelo sobre esta imagen: +Este tutorial comienza con una introducción al lenguaje musical +LilyPond y explica cómo producir música impresa. Después de este +primer contacto, explicaremos cómo crear música impresa de forma +bella, que contenga notación musical usual. -@c no verbatim here -@lilypond[quote,ragged-right] -\relative c'' { - c-\markup { \bold \huge { Click here. } } -} -@end lilypond - -Cortando y pegando todo lo que se encuentra dentro de la sección @qq{ly snippet} (fragmento de tipo ly), tendrá una -plantilla inicial para sus experimentos. Si le agrada esta forma de aprender, -probablemente quiera imprimir o añadir a sus favoritos la dirección de la -@ruser{Cheat sheet}, que es una relación en forma de tabla de las instrucciones más comunes -de manera que sirvan de referencia rápida. -@end ifhtml @menu * First steps:: @@ -79,17 +55,22 @@ Esta sección le ofrece una introducción básica al trabajo con LilyPond. @menu * Compiling a file:: * Simple notation:: -* Working on text files:: -* How to read the tutorial:: +* Working on input files:: +* How to read the manual:: @end menu @node Compiling a file @subsection Compiling a file -El primer ejemplo demuestra cómo empezar a trabajar con LilyPond. Para -crear una partitura, escribimos un archivo de texto que especifica la -notación. Por ejemplo, si escribimos +@qq{Compilación} es una palabra que significa procesar un texto de +entrada en formato de LilyPond para producir un archivo que se puede +imprimir y (de manera opcional) un archivo MIDI que se puede +reproducir. El primer ejemplo muestra el aspecto de un sencillo +archivo de texto de entrada. + +Para crear una partitura, escribimos un archivo de texto que detalla +la notación deseada. Por ejemplo, si escribimos @example @{ @@ -98,7 +79,7 @@ notación. Por ejemplo, si escribimos @end example @noindent -el resultado tiene este aspecto +el resultado tiene este aspecto: @c in this case we don't want verbatim @lilypond[quote,ragged-right] @@ -107,80 +88,93 @@ el resultado tiene este aspecto } @end lilypond -@strong{Advertencia:} Todo el código que se da como entrada a LilyPond tiene que -ir entre @strong{@{ llaves @}}. Las llaves deberían también estar -rodeadas por espacios a no ser que se encuentren al principio o al final de una línea, -para evitar ambigüedades. Es posible que se omitan en algunos ejemplos del presente -manual ¡pero no las omita en su propia música! +@warning{la música y la letra escrita en el código de entrada de +LilyPond tiene que ir siempre entre @strong{@{ llaves @}}. Las llaves +deberían también estar rodeadas por espacios a no ser que se +encuentren al principio o al final de una línea, para evitar +ambigüedades. Es posible que se omitan en algunos ejemplos del +presente manual ¡pero no las omita en su propia música! Para ver más +información sobre la presentación de los ejemplos del manual, consulte +@ref{How to read the manual}.} -@cindex Sensible a las mayúsculas -Además la entrada de LilyPond es @strong{sensible a las mayúsculas}. @code{ @{ c d e @}} -es una entrada válida; @code{@{ C D E @}} producirá un mensaje de error. -@sp 1 +@cindex sensible a las mayúsculas +Además la entrada de LilyPond es @strong{sensible a las mayúsculas}. +@code{ @{ c d e @}} es una entrada válida; @code{@{ C D E @}} +producirá un mensaje de error. + +@smallspace @subheading Entering music and viewing output -En esta sección vamos a explicar qué órdenes hay que ejecutar -y cómo, para ver o imprimir el resultado. +@cindex PDF, archivo +@cindex ver la música + +En esta sección vamos a explicar qué órdenes hay que ejecutar y cómo, +para ver o imprimir el resultado. + +Tenga en cuenta que están disponibles varios otros editores de texto +con un mejor apoyo a la edición de texto de LilyPond. Para ver más +información, consulte @rprogram{Text editor support}. + +@warning{la primera vez que ejecute LilyPond, tardará un minuto o dos +porque todas las tipografías del sistema han de ser analizadas +previamente. ¡Después de esto, LilyPond será mucho más rápido!} @subsubheading MacOS X -Si hace doble clic sobre @code{LilyPond.app}, se abrirá con un archivo -de ejemplo. Guárdelo, por ejemplo, como @file{prueba.ly} en el Escritorio, y -a continuación procéselo con la orden de menú @samp{Compilar > Componer archivo}. -El PDF resultante se mostrará en la pantalla. +Si hace doble clic sobre @code{LilyPond.app}, se abrirá con un archivo +de ejemplo. Guárdelo, por ejemplo, como @file{prueba.ly} en el +Escritorio, y a continuación procéselo con la orden de menú +@samp{Compilar > Componer archivo}. El PDF resultante se mostrará en +la pantalla. + -Advierta que la primera vez que ejecute LilyPond, tardará un minuto -o dos porque todas las tipografías del sistema han de ser analizadas previamente. +Para posteriores usos de LilyPond, debería comenzar eligiendo +@q{Nuevo} o @q{Abrir}. Tiene que grabar el archivo antes de +componerlo tipográficamente. Si se produce algún error durante el +proceso, observe la ventana del registro. -Para posteriores usos de LilyPond, debería comenzar eligiendo @q{Nuevo} -o @q{Abrir}. Tiene que grabar el archivo antes de componerlo tipográficamente. -Si se produce algún error durante el proceso, observe la ventana del registro. @subsubheading Windows -En Windows, si hace doble clic sobre el icono de LilyPond que está en el escritorio, se -abrirá un sencillo editor de texto con un archivo de ejemplo. Guárdelo, por ejemplo, con -el nombre @file{prueba.ly} en el escritorio y después haga doble clic sobre el icono del -archivo para procesarlo (el icono tiene la forma de una nota). Transcurridos unos segundos, -obtendrá un archivo @file{prueba.pdf} en el escritorio. Haga doble clic sobre este archivo -PDF para ver la partitura compuesta tipográficamente. Un método alternativo para procesar el -archivo @file{prueba.ly} es arrastrarlo y soltarlo sobre el icono de LilyPond utilizando -el ratón. - -Para editar un archivo @file{.ly} existente, haga clic sobre él con el botón derecho del ratón -y elija @qq{Edit source} (editar el archivo fuente). Para empezar con un archivo vacío, -arranque el editor como se describe más arriba y elija @qq{New} (nuevo) del menú @qq{File} (archivo). - -Al hacer doble clic sobre el archivo no sólo se obtiene como resultado un archivo PDF, -sino también un archivo @file{.log} que contiene cierta información acerca de lo que -LilyPond ha hecho con el archivo. Si se produce algún error, examine este archivo de registro. - -Tenga en cuenta que hay disponibles varios editores de texto -alternativos con un mejor apoyo para la realización de documentos de -LilyPond, consulte @rprogram{Text editor support} para ver más información. - -@subsubheading Unix - -Comience abriendo una ventana de terminal e iniciando un editor de texto. Por -ejemplo, puede abrir un xterm y ejecutar -@code{joe}@footnote{Existen macros para los adictos a VIM, y hay -un @code{LilyPond-mode} (modo de LilyPond) para los adictos a Emacs. Si no han sido -instalados aún, consulte el archivo @file{INSTALL.txt}. El -entorno de edición más sencillo es @file{LilyPondTool}. Consulte -@rprogram{Text editor support} para más información.}. En su -editor de texto, introduzca la siguiente entrada y guarde el archivo como -@file{prueba.ly} - -@verbatim -{ +En Windows, si hace doble clic sobre el icono de LilyPond que está en +el escritorio, se abrirá un sencillo editor de texto con un archivo de +ejemplo. Guárdelo, por ejemplo, con el nombre @file{prueba.ly} en el +escritorio y después haga doble clic sobre el icono del archivo para +procesarlo (el icono tiene la forma de una corchea). Transcurridos +unos segundos, obtendrá un archivo @file{prueba.pdf} en el +escritorio. Haga doble clic sobre este archivo PDF para ver la +partitura compuesta tipográficamente. Un método alternativo para +procesar el archivo @file{prueba.ly} es arrastrarlo y soltarlo sobre +el icono de LilyPond utilizando el ratón. + +Para editar un archivo @file{.ly} existente, haga clic sobre él con el +botón derecho del ratón y elija @qq{Editar la fuente}. Para empezar +con un archivo vacío, arranque el editor como se describe más arriba y +elija @qq{Nuevo} del menú @qq{Archivo}, o haga clic con el botón +derecho sobre el escritorio y elija @qq{Nuevo..Documento de texto}, +cámbiele el nombre por otro de su elección y cambie la extensión del +archivo a @code{.ly}. Edítelo y luego haga doble click sobre él para +procesarlo como se explicó antes. + +Al hacer doble clic sobre el archivo no sólo se obtiene como resultado +un archivo PDF, sino también un archivo @file{.log} que contiene +cierta información acerca de lo que LilyPond ha hecho con el +archivo. Si se produce algún error, examine este archivo de registro. + + +@subsubheading UNIX + +Cree un archivo de texto con el nombre @file{prueba.ly} y escriba en él: + +@example +@{ c' e' g' e' -} -@end verbatim +@} +@end example -@noindent -Para procesar @file{prueba.ly}, haga lo siguiente: +Para procesar el archivo @file{prueba.ly} haga lo siguiente: @example lilypond prueba.ly @@ -191,101 +185,162 @@ Verá algo parecido a: @example lilypond prueba.ly -GNU LilyPond 2.10.0 +GNU LilyPond 2.12.0 Procesando `prueba.ly' Analizando... -Interpretando la música... [1] +Interpretando la música... Preprocesando los objetos gráficos... -Calculando los cortes de línea... [2] +Buscando el número de páginas ideal... +Disponiendo la música en 1 página... +Dibujando los sistemas... Escribiendo la página de salida en `prueba.ps'... Convirtiendo a `prueba.pdf'... @end example -@cindex Archivo PDF -@cindex Ver la música - -@noindent -El resultado es el archivo @file{prueba.pdf} que podrá imprimir o ver -con las utilidades estándar de su sistema operativo.@footnote{Si -su sistema no dispone de dichas herramientas, puede probar -@uref{http://@/www@/.cs@/.wisc@/.edu/@/~ghost/,Ghostscript}, un programa -de libre disposición para ver e imprimir archivos PDF y PostScript.} - @node Simple notation @subsection Simple notation -LilyPond añadirá ciertos elementos de notación de manera automática. En el siguiente -ejemplo hemos especificado solamente cuatro alturas, pero LilyPond ha -añadido la clave, el compás y las duraciones. +LilyPond añadirá ciertos elementos de notación de manera automática. +En el siguiente ejemplo hemos especificado solamente cuatro alturas, +pero LilyPond ha añadido la clave, el compás y las duraciones. -@lilypond[quote,ragged-right,verbatim] +@lilypond[verbatim,quote,ragged-right] { c' e' g' e' } @end lilypond @noindent -Este comportamiento se puede modificar, pero en general estos valores automáticos -son adecuados. +Este comportamiento se puede modificar, pero en general estos valores +automáticos son adecuados. @subheading Pitches -La manera más sencilla de introducir las notas es mediante la utilización del modo @code{\relative}. En -este modo se supone que el @rglos{interval} entre la nota anterior y la actual -se encuentra dentro de una @rglos{fourth}. Comenzamos -introduciendo la pieza musical más elemental, una @rglos{scale}. - -@lilypond[quote,ragged-right,verbatim] -\relative c' { +Glosario musical: +@rglos{pitch}, +@rglos{interval}, +@rglos{scale}, +@rglos{middle C}, +@rglos{octave}, +@rglos{accidental}. + +La manera más sencilla de introducir las notas es mediante la +utilización del modo @code{\relative} (relativo). En este modo, se +elige la octava automáticamente bajo la suposición de que la siguiente +nota se colocará siempre lo más cerca de la nota actual, es decir, se +colocará en la octava comprendida dentro de hasta tres espacios de +pentagrama a partir de la nota anterior. Comenzaremos por introducir +el fragmento musical más elemental: una @notation{escala}, donde cada +nota está comprendida dentro de tan sólo un espacio de pentagrama +desde la nota anterior. + +@lilypond[verbatim,quote,ragged-right] +\relative c' { % set the starting point to middle C c d e f g a b c } @end lilypond -La nota inicial es @rglos{middle C}. Cada nota sucesiva -se encuentra dentro de una cuarta de la nota previa (en otras palabras: la primera -@samp{c} es el Do más cercano al Do central; a éste le sigue el Re más cercano a la -nota previa, y así sucesivamente). Podemos crear melodías con intervalos mayores: +La nota inicial es @notation{middle C}. Cada nota sucesiva se coloca +lo más cerca posible de la nota previa (en otras palabras: la primera +@samp{c} es el Do más cercano al Do central; a éste le sigue el Re más +cercano a la nota previa, y así sucesivamente). Podemos crear +melodías con intervalos mayores, aún sin dejar de utilizar el modo +relativo: -@lilypond[quote,ragged-right,verbatim] +@lilypond[verbatim,quote,ragged-right] \relative c' { d f a g c b f d } @end lilypond -@noindent -Como puede observar, este ejemplo no comienza en el Do central. La primera nota -(la @samp{d}) es el Re más cercano al Do central. +No es necesario que la primera nota de la melodía comience exactamente +en aquella que especifica la altura de inicio. En el ejemplo +anterior, la primera nota (@code{d}) es el Re más cercano al Do +central. -Para poner intervalos mayores de una cuarta, podemos elevar la octava -añadiendo una comilla simple @code{'} (o apóstrofe) al nombre de la nota. También podemos bajar -la octava adjuntando una coma @code{,} al nombre de la nota. +Añadiendo (o eliminando) comillas simples @code{'} o comas @code{,} de +la instrucción @code{\relative c' @{}, podemos cambiar la octava de +inicio: -@lilypond[quote,ragged-right,verbatim] +@lilypond[verbatim,quote,ragged-right] +\relative c'' { % one octave above middle C + e c a c +} +@end lilypond + +Al principio, el modo relativo puede resultar algo confuso, pero es la +forma más sencilla de introducir la mayor parte de las melodías. +Veamos cómo funciona en la práctica este cálculo relativo. Comenzando +por Si, que está situado en la línea central en clave de Sol, podemos +alcanzar Do, Re y Mi dentro de los tres espacios de pentagrama hacia +arriba, y La, Sol y Fa dentro de los tres espacios hacia abajo. Por +tanto, si la nota siguiente a Si es Do, Re o Mi se supondrá que está +por encima del Si, mientras que La, Sol o Fa se entenderán situados +por debajo. + +@lilypond[verbatim,quote,ragged-right] +\relative c'' { + b c % c is 1 staff space up, so is the c above + b d % d is 2 up or 5 down, so is the d above + b e % e is 3 up or 4 down, so is the e above + b a % a is 6 up or 1 down, so is the a below + b g % g is 5 up or 2 down, so is the g below + b f % f is 4 up or 3 down, so is the f below +} +@end lilypond + +Loo mismo exactamente ocurre cuando cualquiera de esas notas llevan un +sostenido o un bemol. Las @notation{Alteraciones accidentales} se +@strong{ignoran totalmente} en el cálculo de la posición relativa. +Exactamente la misma cuenta de espacios de pentagrama se hace a partir +de una nota situada en cualquier otro lugar del mismo. + +Para añadir intervalos mayores de tres espacios de pentagrama, podemos +elevar la @notation{octava} añadiendo una comilla simple @code{'} (o +apóstrofe) a continuación del nombre de la nota. También podemos +bajar la octava escribiendo una coma @code{,} a continuación del +nombre de la nota. + +@lilypond[verbatim,quote,ragged-right] \relative c'' { a a, c' f, g g'' a,, f' } @end lilypond -@noindent -Para subir o bajar una nota en dos (¡o más!) octavas, utilizamos varias @code{''} ó -@code{,,} (pero tenga cuidado de utilizar dos comillas simples @code{''} ¡y no una -comilla doble @code{"}@tie{}!) El valor inicial de -@code{\relative c'} también puede modificarse de esta forma. +@noindent +Para subir o bajar una nota en dos (¡o más!) octavas, utilizamos +varias @code{''} ó @code{,,} (pero tenga cuidado de utilizar dos +comillas simples @code{''} ¡y no una comilla doble @code{"}@tie{}!) +El valor inicial de @code{\relative c'} también puede modificarse de +esta forma. @subheading Durations (rhythms) -La @rglos{duration} de una nota se especifica mediante un número después del nombre de la nota. -@samp{1} significa @rglos{whole note}, @samp{2} significa @rglos{half note}, -@samp{4} significa @rglos{quarter note} y así sucesivamente. Las barras de corchea se añaden -automáticamente. - -@lilypond[quote,ragged-right,verbatim] +Glosario musical: +@rglos{beam}, +@rglos{duration}, +@rglos{whole note}, +@rglos{half note}, +@rglos{quarter note}, +@rglos{dotted note}. + +La @notation{duración} de una nota se especifica mediante un número +después del nombre de la nota. @code{1} significa @notation{redonda}, +@code{2} significa @notation{blanca}, @code{4} significa +@notation{negra} y así sucesivamente. Las @notation{barras de +corchea} se añaden automáticamente. + +Si no especifica una duración, se utiliza la duración previa para la +nota siguiente. La figura por omisión de la primera nota es una +negra. + +@lilypond[verbatim,quote,ragged-right] \relative c'' { a1 a2 a4 a8 a @@ -293,13 +348,11 @@ automáticamente. } @end lilypond -@noindent -Si no especifica una duración, se utiliza la duración previa para la nota siguiente. -La figura por omisión de la primera nota es una negra. - -Para crear notas con puntillo (véase @rglos{dotted note}), añada un punto @samp{.} al número de la duración. +Para crear @notation{notas con puntillo}, añada un punto @code{.} al +número de la duración. La duración de una nota con puntillo se debe +especificar de forma explícita (es decir: mediante un número). -@lilypond[quote,ragged-right,verbatim] +@lilypond[verbatim,quote,ragged-right] \relative c'' { a a a4. a8 a8. a16 a a8. a8 a4. @@ -309,9 +362,13 @@ Para crear notas con puntillo (véase @rglos{dotted note}), añada un punto @sam @subheading Rests -Un @rglos{rest} se introduce igual que una nota, con el nombre @samp{r}: +Glosario musical: +@rglos{rest}. -@lilypond[quote,ragged-right,verbatim] +Un @notation{silencio} se introduce igual que si fuera una nota con el +nombre @code{r}@tie{}: + +@lilypond[verbatim,quote,ragged-right] \relative c'' { a r r2 r8 a r4 r4. r8 @@ -321,9 +378,13 @@ Un @rglos{rest} se introduce igual que una nota, con el nombre @samp{r}: @subheading Time signature -La @rglos{time signature}) se puede establecer con la orden @code{\time} : +Glosario musical: +@rglos{time signature}. + +La @notation{indicación de compás} se puede establecer con la orden +@code{\time} : -@lilypond[quote,ragged-right,verbatim] +@lilypond[verbatim,quote,ragged-right] \relative c'' { \time 3/4 a4 a a @@ -337,9 +398,13 @@ La @rglos{time signature}) se puede establecer con la orden @code{\time} : @subheading Clef -La @rglos{clef} se puede establecer utilizando la orden @code{\clef} : +Glosario musical: +@rglos{clef}. -@lilypond[quote,ragged-right,verbatim] +La @notation{clave} se puede establecer utilizando la orden +@code{\clef} : + +@lilypond[verbatim,quote,ragged-right] \relative c' { \clef treble c1 @@ -355,9 +420,10 @@ La @rglos{clef} se puede establecer utilizando la orden @code{\clef} : @subheading All together -He aquí un pequeño ejemplo que muestra todos los elementos anteriores juntos: +He aquí un pequeño ejemplo que muestra todos los elementos anteriores +juntos: -@lilypond[quote,ragged-right,verbatim] +@lilypond[verbatim,quote,ragged-right] \relative c, { \time 3/4 \clef bass @@ -366,61 +432,60 @@ He aquí un pequeño ejemplo que muestra todos los elementos anteriores juntos: } @end lilypond + @seealso -@quotation -@table @asis -@item Introducir alturas y duraciones -véase @ruser{Pitches} y @ruser{Durations}. -@item Silencios -véase @ruser{Rests}. -@item Indicaciones de compás y otras instrucciones de tiempo -véase @ruser{Time signature}. -@item Claves -véase @ruser{Clef}. -@end table -@end quotation - - -@node Working on text files -@subsection Working on text files - -Los archivos de entrada de LilyPond son como los archivos fuente de muchos lenguajes de programación corrientes. -Son sensibles a las mayúsculas e insensibles al número de espacios Las expresiones -se forman con llaves @{ @} y los comentarios se denotan por un signo de porcentaje (@code{%}) o por -@code{%@{ ... %@}}. - -Si la frase anterior no tiene sentido para usted ¡no se preocupe! A continuación explicaremos el -significado de todos estos términos: +Referencia de la notación: +@ruser{Writing pitches}, +@ruser{Writing rhythms}, +@ruser{Writing rests}, +@ruser{Time signature}, +@ruser{Clef}. + + +@node Working on input files +@subsection Working on input files + +Los archivos de entrada de LilyPond son como los archivos fuente de +muchos lenguajes de programación corrientes. Son sensibles a las +mayúsculas e insensibles al número de espacios Las expresiones se +forman con llaves @{ @} y los comentarios se denotan por un signo de +porcentaje (@code{%}) o por @code{%@{ ... %@}}. + +Si la frase anterior no tiene sentido para usted ¡no se preocupe! A +continuación explicaremos el significado de todos estos términos: @itemize @cindex Sensible a las mayúsculas @item @strong{Sensible a las mayúsculas}: -tiene importancia el hecho de que introduzca una letra -en minúsculas (p.ej. @code{a, b, s, t}) o en mayúsculas (p.ej. -@code{A, B, S, T}). Las notas son minúsculas: @code{@{ c d e @}} -es una entrada válida; @code{@{ C D E @}} produciría un mensaje de error. +tiene importancia el hecho de que introduzca una letra en minúsculas +(p.ej. @code{a, b, s, t}) o en mayúsculas (p.ej. @code{A, B, S, T}). +Las notas son minúsculas: @code{@{ c d e @}} es una entrada válida; +@code{@{ C D E @}} produciría un mensaje de error. @item @strong{Insensible al número de espacios}: -no importa cuántos -espacios (o saltos de línea) añada. @code{@{ c d e @}} significa lo mismo -que @code{@{ c @tie{} @tie{} @tie{} d e @}} y que +no importa cuántos espacios (o saltos de línea) añada. @code{@{ c d e +@}} significa lo mismo que @code{@{ c @tie{} @tie{} @tie{} d e @}} y +que + @example - @{ -c d - e @} +@{ c d + e @} @end example @noindent -Por supuesto, el ejemplo anterior es difícil de leer. Una regla práctica -es sangrar los bloques de código con un carácter de tabulación, o bien con dos espacios: +Por supuesto, el ejemplo anterior es difícil de leer. Una regla +práctica es sangrar los bloques de código con un carácter de +tabulación, o bien con dos espacios: + @example @{ c d e @} @end example -@item @strong{Expresiones:} +@item +@strong{Expresiones:} Todo fragmento de código de entrada para LilyPond ha de llevar @strong{@{ llaves @}} antes y después de la entrada. Estas llaves le dicen a LilyPond que la entrada es una expresión musical unitaria, igual que @@ -428,20 +493,36 @@ los paréntesis @samp{()} de las matemáticas. Las llaves deben ir rodeadas de un espacio a no ser que se encuentren al comienzo o al final de una línea, para evitar cualquier ambigüedad. -Una función (como por ejemplo @code{\relative @{ @}}) también es una expresión musical -unitaria. +Una instrucción de LilyPond seguida de una expresión simple entre +llaves (como por ejemplo @code{\relative @{ @}}) también es una +expresión musical unitaria. @cindex comentarios @cindex comentario de línea @cindex comentario de bloque -@item @strong{Comentarios}: -Un comentario es una nota para el lector humano de la entrada musical; se ignora -cuando esta entrada se analiza, de manera que no tiene ningún efecto sobre la salida impresa. -Existen dos tipos de comentarios. El símbolo de porcentaje @samp{%} -introduce un comentario de línea; todo lo que se encuentra después de @samp{%} en esa línea -se ignora. Un comentario de bloque marca una sección entera de entrada musical -como comentario. Todo lo que está encerrado dentro de @code{%@{} y @code{%@}} se -ignora (pero los comentarios no pueden incluir otros comentarios). El siguiente fragmento muestra algunos posibles usos para los comentarios: +@item +@strong{Comentarios}: +Un comentario es una nota para el lector humano de la entrada musical; +se ignora cuando esta entrada se analiza, de manera que no tiene +ningún efecto sobre la salida impresa. Existen dos tipos de +comentarios. El símbolo de porcentaje @samp{%} introduce un +comentario de línea; todo lo que se encuentra después de @samp{%} en +esa línea se ignora. Por convenio, una línea de comentario se coloca +@emph{por encima} del código a que se refiere el comentario. + +@example +a4 a a a +% este comentario se refiere a las notas Si +b2 b +@end example + +Un comentario de bloque marca una sección entera de entrada musical +como comentario. Todo lo que está encerrado dentro de @code{%@{} y +@code{%@}} se ignora (pero los comentarios no pueden anidarse, lo que +significa que un comentario de bloque no puede incluir otros +comentarios de bloque). Si lo hiciera, el primer @code{%@}} daría por +terminado @emph{los dos} comentarios de bloque. El siguiente +fragmento muestra algunos posibles usos para los comentarios: @example % a continuación van las notas de campanitas del lugar @@ -458,22 +539,17 @@ ignora (pero los comentarios no pueden incluir otros comentarios). El siguiente @end itemize -Hay más trucos para elaborar archivos de entrada en -@ruser{Suggestions for writing LilyPond files}. - - -@node How to read the tutorial -@subsection How to read the tutorial -Como vimos en @ruser{Working on text files}, la entrada de LilyPond debe estar -rodeada de llaves @{ @} o de @code{\relative c'' @{ ... @}}. Durante el -resto del presente manual, la mayor parte de los ejemplos omitirán las llaves. +@node How to read the manual +@subsection How to read the manual -Si está leyendo la documentación HTML y quiere ver el código de LilyPond exacto -que se utilizó para crear el ejemplo, sencillamente haga clic -sobre la imagen. Si no está leyendo la versión en HTML, podría -copiar y pegar la entrada que se muestra, pero @strong{deberá} añadir -@code{\relative c'' @{ @}} de la siguiente manera: +Como ya vimos en @ref{Working on input files}, el código de entrada de +LilyPond debe estar rodeado de llaves @{ @} o de +@w{@code{\relative c'' @{ ... @}}}. Durante el resto del presente +manual, la mayor parte de los ejemplos omitirán las llaves. Para +reproducir los ejemplos, deberá copiar y pegar la entrada que se +muestra, pero @strong{deberá} escribir el +@w{@code{\relative c'' @{ @}}}, de la siguiente forma: @example \relative c'' @{ @@ -481,13 +557,45 @@ copiar y pegar la entrada que se muestra, pero @strong{deberá} añadir @} @end example -¿Por qué omitir las llaves? Casi todos los ejemplos -del presente manual se pueden insertar en medio de un fragmento mayor de -música. Para estos ejemplos no tiene ningún sentido añadir -@code{\relative c'' @{ @}} (no debería poner un @code{\relative} -dentro de otro @code{\relative}), de forma que usted no podría copiar -un ejemplo pequeño procedente de la documentación y pegarlo dentro de su propia -pieza. +¿Por qué omitir las llaves? Casi todos los ejemplos del presente +manual se pueden insertar en medio de un fragmento mayor de música. +Para estos ejemplos no tiene ningún sentido añadir @code{\relative c'' +@{ @}} (¡no debería poner un @code{\relative} dentro de otro +@code{\relative}!); si hubiésemos incluido @code{\relative c'' @{ @}} +rodeando a cada uno de los ejemplos, usted no podría copiar un ejemplo +pequeño procedente de la documentación y pegarlo dentro de su propia +pieza. La mayoría querrá insertar el código dentro de una pieza más +grande, por eso hemos formateado el manual de esta manera. + + + +@subheading Clickable examples + +Muchas personas aprenden a utilizar programas probando y enredando con +ellos. Esto también puede hacerse con LilyPond. Si hace clic sobre +una imagen en la versión en HTML de este manual, podrá ver la entrada +exacta de LilyPond que se utilizó para generar esa imagen. Pruébelo +sobre esta imagen: + +@c no verbatim here +@lilypond[quote,ragged-right] +\relative c'' { + c-\markup { \bold \huge { Click here. } } +} +@end lilypond + +Cortando y pegando todo lo que se encuentra dentro de la sección +@qq{ly snippet} (fragmento de tipo ly), tendrá una plantilla inicial +para sus experimentos. Para poder ver exactamente el mismo resultado +(con igual anchura de línea y todo), copie todo lo que está desde +@qq{Start cut-&-pastable section} hasta el final del archivo. + +@seealso + + +Podrá encontrar más consejos y trucos para la construcción de archivos +de entrada en @ref{Suggestions for writing LilyPond files}; pero quizá +sea mejor leer primero el resto del tutorial. @node Single staff notation @@ -497,132 +605,128 @@ Esta sección es una introducción a la notación corriente que se utiliza para o un pentagrama. @menu -* Relative note names:: * Accidentals and key signatures:: * Ties and slurs:: * Articulation and dynamics:: +* Adding text:: * Automatic and manual beams:: * Advanced rhythmic commands:: @end menu -@node Relative note names -@subsection Relative note names - -Como hemos visto en @ruser{Simple notation}, LilyPond calcula la altura de -cada nota de forma relativa respecto de la nota anterior@footnote{Existe otra forma de -introducir las alturas, @ruser{Absolute note names}, pero en la práctica el modo -relativo es mucho más cómodo y seguro de utilizar.}. Si no se añade ninguna marca de octava -(@code{'} y @code{,}), se supone que cada altura se encuentra dentro de una -cuarta desde la nota anterior. - -LilyPond examina las alturas basándose en los nombres de las notas (dicho de otra forma: -una cuarta aumentada @emph{no} es lo mismo que una quinta disminuida. Si -empezamos en un Do, un Fa sostenido situado a continuación se colocará por encima del Do, mientras que -un Sol bemol se colocará por debajo de este mismo Do. - -@lilypond[quote,ragged-right,verbatim,fragment,relative=2] -c2 fis -c2 ges -@end lilypond - -@seealso -@quotation -@table @asis -@item Octavas relativas -ver @ruser{Relative octaves}. -@item Comprobación de octava -ver @ruser{Octave check}. -@end table -@end quotation - - - @node Accidentals and key signatures @subsection Accidentals and key signatures @subheading Accidentals -Una nota @rglos{sharp} se hace añadiendo @samp{is} al -nombre, y una nota @rglos{flat} añadiendo @samp{es}. Como -ha podido adivinar, un @rglos{double sharp} o @rglos{double flat} se hace -añadiendo @samp{isis} o @samp{eses}@footnote{Esta sintaxis -derivó de las convenciones de las lenguas nórdicas y germánicas para nombrar las notas -como el alemán y el holandés. Para utilizar otros nombres para las alteraciones accidentales, vea -@ruser{Note names in other languages}.} - -@lilypond[quote,ragged-right,verbatim,fragment,relative=2] +Glosario musical: +@rglos{sharp}, +@rglos{flat}, +@rglos{double sharp}, +@rglos{double flat}, +@rglos{accidental}. + +Una nota con @notation{sostenido} se hace añadiendo @code{is} al +nombre, y una nota @notation{bemol} añadiendo @code{es}. Como ha +podido adivinar, un @notation{doble sostenido} o @notation{doble +bemol} se hace añadiendo @code{isis} o @code{eses}. Esta sintaxis se +deriva de las convenciones para da nombre a las notas de las lenguas +nórdicas y germánicas como el alemán y el holandés. Para utilizar +otros nombres para las @notation{alteraciones accidentales}, véase +@ruser{Note names in other languages}. + +@lilypond[verbatim,quote,ragged-right,fragment,relative=2] cis1 ees fisis, aeses @end lilypond @cindex tonalidad, armadura de la, establecer @subheading Key signatures -La armadura de la tonalidad se establece mediante la instrucción @code{\key} seguido de -una nota y @code{\major} o @code{\minor}. +Glosario musical: +@rglos{key signature}, +@rglos{major}, +@rglos{minor}. -@lilypond[quote,ragged-right,verbatim,fragment,relative=2] +La @notation{armadura de la tonalidad} se establece mediante la +instrucción @code{\key} seguido de una nota y @code{\major} o +@code{\minor}. + +@lilypond[verbatim,quote,ragged-right,fragment,relative=2] \key d \major a1 \key c \minor a @end lilypond -@sp 1 +@smallspace @subheading Warning: key signatures and pitches -Para determinar si hay que imprimir una alteración accidental, LilyPond examina las -notas y la armadura de la tonalidad. La armadura solamente afecta a las -alteraciones @emph{impresas}, ¡no a las propias notas! Ésta es una -funcionalidad que frecuentemente confunde a los que se inician con el programa, por ello permítanos explicarla -en detalle. +Glosario musical: +@rglos{accidental}, +@rglos{key signature}, +@rglos{pitch}, +@rglos{flat}, +@rglos{natural}, +@rglos{sharp}, +@rglos{transposition}. + +Para determinar si hay que imprimir una @notation{alteración +accidental}, LilyPond examina las notas y la @notation{armadura de la +tonalidad}. La armadura solamente afecta a las alteraciones +@emph{impresas}, ¡no a las propias notas! Esta funcionalidad suele +confundir a los que están empezando con el programa, por ello +permítanos explicarla en detalle. LilyPond hace una clara distinción entre el contenido musical y la -presentación. La alteración (bemol, becuadro o sostenido) de una nota es parte de -la altura, y por tanto es contenido musical. Si una alteración (un -signo @emph{impreso} de bemol, becuadro o sostenido) se imprime o no delante de la -nota correspondiente, es una cuestión de presentación. La presentación es algo que -sigue unas reglas, así que las alteraciones accidentales se imprimen automáticamente según -dichas reglas. Las alturas de las notas en su música son obras de arte, por tanto no se -añadirán automáticamente, y usted deberá introducir aquello que quiera oír. - -En el siguiente ejemplo - -@lilypond[quote,ragged-right,verbatim,fragment,relative=2] +presentación. La alteración (@notation{bemol}, @notation{becuadro} o +@notation{sostenido}) de una nota es parte de la altura, y por tanto +es contenido musical. Si una alteración (un signo @emph{impreso} de +bemol, becuadro o sostenido) se imprime o no delante de la nota +correspondiente, es una cuestión de presentación. La presentación es +algo que sigue unas reglas, así que las alteraciones accidentales se +imprimen automáticamente según dichas reglas. Las alturas de las +notas en su música son obras de arte, por tanto no se añadirán +automáticamente, y usted deberá introducir aquello que quiera oír. + +En el siguiente ejemplo: + +@lilypond[verbatim,quote,ragged-right,fragment,relative=2] \key d \major d cis fis @end lilypond @noindent -ninguna nota lleva una alteración impresa, pero de todas formas usted debe añadir la @samp{is} a -@code{cis} y a @code{fis}. +ninguna nota lleva una alteración impresa, pero de todas formas usted +debe añadir el @code{is} a @code{cis} y a @code{fis}. -El texto @samp{e} no significa @qq{imprimir una bolita negra en la +El texto @code{e} no significa @qq{imprimir una bolita negra en la primera línea del pentagrama.} Más bien significa: @qq{hay una nota Mi natural.} En la tonalidad de La bemol mayor, @emph{lleva} una alteración accidental: -@lilypond[quote,ragged-right,verbatim,fragment,relative=2] +@lilypond[verbatim,quote,ragged-right,fragment,relative=2] \key aes \major e @end lilypond -Poner todas las alteraciones de forma explícita puede que requiera algo más de trabajo -al teclear, pero la ventaja es que la transposición es más fácil, y las -alteraciones se pueden imprimir siguiendo varias convenciones distintas. Consulte -@ruser{Automatic accidentals} para ver ejemplos de cómo se pueden imprimir las alteraciones -de acuerdo a reglas diferentes. +Poner todas las alteraciones de forma explícita puede que requiera +algo más de trabajo al teclear, pero la ventaja es que la +@notation{transposición} es más fácil, y las alteraciones se pueden +imprimir siguiendo varias convenciones distintas. Consulte +@ruser{Automatic accidentals} para ver ejemplos de cómo se pueden +imprimir las alteraciones de acuerdo a reglas diferentes. @seealso -@quotation -@table @asis -@item Alteraciones accidentales -ver @ruser{Accidentals} y @ruser{Automatic accidentals}. -@item Armadura de la tonalidad -ver @ruser{Key signature}. -@end table -@end quotation + +Referencia de la notación: +@ruser{Note names in other languages}, +@ruser{Accidentals}, +@ruser{Automatic accidentals}, +@ruser{Key signature}. + +Glosario musical: +@rglos{Pitch names}. @node Ties and slurs @@ -630,8 +734,12 @@ ver @ruser{Key signature}. @cindex ligaduras de unión @subheading Ties -Una @rglos{tie} se crea adjuntando un carácter tilde @samp{~} a la primera -nota ligada + +Glosario musical: +@rglos{tie}. + +Una @notation{tie} se crea adjuntando un carácter de tilde curva @code{~} +a la primera nota ligada: @lilypond[quote,ragged-right,verbatim,fragment,relative=2] g4~ g c2~ @@ -641,8 +749,12 @@ c4 ~ c8 a8 ~ a2 @cindex ligaduras de expresión @subheading Slurs -Una @rglos{slur} es una curva que se traza abarcando varias notas. Las notas inicial -y final se marcan mediante @samp{(} y @samp{)} respectivamente. +Glosario musical: +@rglos{slur}. + +Una @notation{slur} es una curva que se traza abarcando varias notas. +Las notas inicial y final se marcan mediante @code{(} y @code{)} +respectivamente. @lilypond[quote,ragged-right,verbatim,fragment,relative=2] d4( c16) cis( d e c cis d) e( d4) @@ -652,41 +764,48 @@ d4( c16) cis( d e c cis d) e( d4) @cindex ligaduras de fraseo @subheading Phrasing slurs -Las ligaduras que se utilizan para indicar fraseos más largos se pueden introducir mediante @code{\(} y -@code{\)}. Puede haber al mismo tiempo ligaduras de legato y ligaduras de fraseo, -pero no es posible tener legatos simultáneos o ligaduras de expresión +Glosario musical: +@rglos{slur}, +@rglos{phrasing}. + +Las ligaduras que se utilizan para indicar @notation{fraseos} más +largos se pueden introducir mediante @code{\(} y @code{\)}. Puede +haber al mismo tiempo ligaduras de legato y ligaduras de fraseo, pero +no es posible tener legatos simultáneos o ligaduras de expresión simultáneas. -@lilypond[quote,ragged-right,verbatim,fragment,relative=2] +@lilypond[verbatim,quote,ragged-right,fragment,relative=2] a8(\( ais b c) cis2 b'2 a4 cis,\) @end lilypond -@sp 1 +@smallspace @cindex ligaduras de expresión frente a ligaduras de unión @subheading Warnings: slurs vs. ties -Una ligadura de expresión parece una @rglos{tie}, pero tiene un significado distinto. Una -ligadura (de unión) sencillamente hace que la primera nota sea más larga, y sólo se puede utilizar sobre -parejas de notas iguales. Las ligaduras de expresión indican las articulaciones -de las notas, y se pueden utilizar sobre grupos mayores de notas. Las ligaduras de unión y de expresión +Glosario musical: +@rglos{articulation}, +@rglos{slur}, +@rglos{tie}. + +Una @notation{ligadura de expresión} parece una @notation{ligadura de +unión}, pero tiene un significado distinto. Una ligadura (de unión) +sencillamente hace que la primera nota sea más larga, y sólo se puede +utilizar sobre parejas de notas iguales. Las ligaduras de expresión +indican la @notation{articulación} de las notas, y se pueden utilizar +sobre grupos mayores de notas. Las ligaduras de unión y de expresión se pueden anidar unas dentro de otras. -@lilypond[quote,ragged-right,verbatim,fragment,relative=2] +@lilypond[verbatim,quote,ragged-right,fragment,relative=2] c2~( c8 fis fis4 ~ fis2 g2) @end lilypond @seealso -@quotation -@table @asis -@item Ligaduras de unión -ver @ruser{Ties}. -@item Ligaduras de expresión -ver @ruser{Slurs}. -@item Ligaduras de fraseo -ver @ruser{Phrasing slurs}. -@end table -@end quotation + +Referencia de la notación: +@ruser{Ties}, +@ruser{Slurs}, +@ruser{Phrasing slurs}. @node Articulation and dynamics @@ -697,36 +816,50 @@ ver @ruser{Phrasing slurs}. @cindex staccato @subheading Articulations -Las articulaciones (véase @rglos{articulation}) más corrientes se pueden añadir a las notas utilizando un guión @samp{-} -seguido de un carácter único: +Glosario musical: +@rglos{articulation}. -@lilypond[quote,ragged-right,verbatim,fragment,relative=2] +Las @notation{articulaciones} más corrientes se pueden añadir a las +notas utilizando un guión @code{-} seguido de un carácter único: + +@lilypond[verbatim,quote,ragged-right,fragment,relative=2] c-. c-- c-> c-^ c-+ c-_ @end lilypond @cindex digitaciones @subheading Fingerings -De manera similar, las indicaciones de digitación se pueden añadir a una nota utilizando un guión -(@samp{-}) seguido del dígito deseado: -@lilypond[quote,ragged-right,verbatim,fragment,relative=2] +Glosario musical: +@rglos{fingering}. + +De manera similar, las @notation{digitaciones} se pueden añadir a una +nota utilizando un guión (@code{-}) seguido del dígito deseado: + +@lilypond[verbatim,quote,ragged-right,fragment,relative=2] c-3 e-5 b-2 a-1 @end lilypond -Las articulaciones y digitaciones normalmente se colocan de forma automática, pero puede -especificar una dirección mediante @samp{^} (encima) o @samp{_} (debajo). También -puede usar varias articulaciones sobre la misma nota. Sin embargo, casi siempre -es mejor dejar que LilyPond determine la dirección de las articulaciones. +Las articulaciones y digitaciones normalmente se colocan de forma +automática, pero puede especificar una dirección mediante @code{^} +(encima) o @code{_} (debajo). También puede usar varias +articulaciones sobre la misma nota. Sin embargo, casi siempre es +mejor dejar que LilyPond determine la dirección de las articulaciones. -@lilypond[quote,ragged-right,verbatim,fragment,relative=2] +@lilypond[verbatim,quote,ragged-right,fragment,relative=2] c_-^1 d^. f^4_2-> e^-_+ @end lilypond @subheading Dynamics -Las expresiones de matiz o signos dinámicos se hacen añadiendo las marcas (con una barra invertida) a la -nota: -@lilypond[quote,ragged-right,verbatim,fragment,relative=2] +Glosario musical: +@rglos{dynamics}, +@rglos{crescendo}, +@rglos{decrescendo}. + +Las expresiones de @notation{matiz} o signos dinámicos se hacen +añadiendo las marcas (con una barra invertida) a la nota: + +@lilypond[verbatim,quote,ragged-right,fragment,relative=2] c\ff c\mf c\p c\pp @end lilypond @@ -734,70 +867,93 @@ c\ff c\mf c\p c\pp @cindex decrescendo @cindex crescendo -Los crescendi y decrescendi comienzan con las órdenes @code{\<} y -@code{\>}. Una expresión terminal de matiz, como por ejemplo @code{\f}, dará por terminado el -(de)crescendo, o bien se puede usar la orden @code{\!}: +Los @notation{crescendi} y @notation{decrescendi} comienzan con las +órdenes @code{\<} y @code{\>}. La siguiente indicación de matiz, como +por ejemplo @code{\f}, dará por terminado el (de)crescendo, o bien se +puede usar la instrucción @code{\!}: -@lilypond[quote,ragged-right,verbatim,fragment,relative=2] +@lilypond[verbatim,quote,ragged-right,fragment,relative=2] c2\< c2\ff\> c2 c2\! @end lilypond @seealso -@quotation -@table @asis -@item Articulaciones -ver @ruser{Articulations}. -@item Digitaciones -ver @ruser{Fingering instructions}. -@item Matices -ver @ruser{Dynamics}. -@end table -@end quotation + +Referencia de la notación: +@ruser{Articulations and ornamentations}, +@ruser{Fingering instructions}, +@ruser{Dynamics}. + + +@node Adding text +@subsection Adding text + +Es posible añadir texto a la partitura: + +@lilypond[verbatim,quote,ragged-right,fragment,relative=2] +c1^"espr" a_"legato" +@end lilypond + +Se puede aplicar un formateo adicional mediante la instrucción @code{\markup}: + +@lilypond[verbatim,quote,ragged-right,fragment,relative=2] +c1^\markup{ \bold espr} +a1_\markup{ + \dynamic f \italic \small { 2nd } \hspace #0.1 \dynamic p +} +@end lilypond + + +@seealso + +Referencia de la notación: +@ruser{Writing text}. @node Automatic and manual beams @subsection Automatic and manual beams +Glosario musical: +@rglos{beam}. + @cindex barras, establecimiento manual -Todas las @rglos{beam}s se dibujan automáticamente: -@c aquí hay un problema con el plural. FVD -@lilypond[quote,ragged-right,verbatim,fragment,relative=2] + +Todas las @notation{barras} de las figuras se dibujan automáticamente: + +@lilypond[verbatim,quote,ragged-right,fragment,relative=2] a8 ais d ees r d c16 b a8 @end lilypond @noindent -Si no le gustan las barras automáticas, pueden forzarse -manualmente. Marque la primera nota que comprende la barra con @samp{[} y la última -con @samp{]}. +Si no le gustan las barras automáticas, pueden forzarse manualmente. +Marque la primera nota que comprende la barra con @code{[} y la última +con @code{]}. -@lilypond[quote,ragged-right,verbatim,fragment,relative=2] +@lilypond[verbatim,quote,ragged-right,fragment,relative=2] a8[ ais] d[ ees r d] a b @end lilypond @seealso -@quotation -@table @asis -@item Barras automáticas -ver @ruser{Automatic beams}. -@item Barras manuales -ver @ruser{Manual beams}. -@end table -@end quotation + +Referencia de la notación: +@ruser{Automatic beams}, +@ruser{Manual beams}. @node Advanced rhythmic commands @subsection Advanced rhythmic commands @cindex anacrusa -@c @cindex anacruse @c redundant, in spanish. FVD @cindex compás parcial @subheading Partial measure -Una anacrusa (o @rglos{anacrusis}) se introduce con la palabra clave -@code{\partial}. Va seguida de una duración: @code{\partial 4} es -una anacrusa de negra y @code{\partial 8} de corchea. +Glosario musical: +@rglos{anacrusis}. -@lilypond[quote,ragged-right,verbatim,fragment,relative=2] +Una @notation{anacrusa} se introduce con la palabra clave +@code{\partial}. Va seguida de una duración: @code{\partial 4} es una +anacrusa de negra y @code{\partial 8} de corchea. + +@lilypond[verbatim,quote,ragged-right,fragment,relative=2] \partial 8 f8 c2 d @end lilypond @@ -806,12 +962,17 @@ f8 c2 d @cindex tresillos @subheading Tuplets -Los grupos especiales como los tresillos se hacen con la palabra clave @code{\times}. Requiere dos -argumentos: una fracción y un fragmento de música. La duración del fragmento -de música se multiplica por la fracción. Los tresillos hacen que las notas ocupen -2/3 de su duración expresa, por tanto un tresillo lleva una fracción de 2/3 +Glosario musical: +@rglos{note value}, +@rglos{triplet}. -@lilypond[quote,ragged-right,verbatim,fragment,relative=2] +Los grupos especiales como los tresillos se hacen con la palabra clave +@code{\times}. Requiere dos argumentos: una fracción y un fragmento +de música. La duración del fragmento de música se multiplica por la +fracción. Los tresillos hacen que las notas ocupen 2/3 de su duración +expresa, por tanto un @notation{tresillo} lleva una fracción de 2/3: + +@lilypond[verbatim,quote,ragged-right,fragment,relative=2] \times 2/3 { f8 g a } \times 2/3 { c r c } \times 2/3 { f,8 g16[ a g a] } @@ -823,44 +984,46 @@ de música se multiplica por la fracción. Los tresillos hacen que las notas oc @cindex appoggiatura @subheading Grace notes -Las notas de adorno se crean con la instrucción @code{\grace}, aunque -también se pueden conseguir precediendo una expresión musical por la -palabra clave @code{\appoggiatura} o @code{\acciaccatura} +Glosario musical: +@rglos{grace notes}, +@rglos{acciaccatura}, +@rglos{appoggiatura}. -@lilypond[quote,ragged-right,verbatim,fragment,relative=2] +Las @notation{notas de adorno} se crean con la instrucción +@code{\grace}, aunque también se pueden conseguir precediendo una +expresión musical por la palabra clave @code{\appoggiatura} o +@code{\acciaccatura} + +@lilypond[verbatim,quote,ragged-right,fragment,relative=2] c2 \grace { a32[ b] } c2 c2 \appoggiatura b16 c2 c2 \acciaccatura b16 c2 @end lilypond @seealso -@quotation -@table @asis -@item Notas de adorno -ver @ruser{Grace notes}, -@item Grupos especiales -ver @ruser{Tuplets}, -@item Anacrusas -ver @ruser{Partial measures}. -@end table -@end quotation + +Referencia de la notación: +@ruser{Grace notes}, +@ruser{Tuplets}, +@ruser{Upbeats}. @node Multiple notes at once @section Multiple notes at once -Esta sección es una introducción a las notas simultáneas: -varios instrumentos, varios pentagramas para un solo instrumento (p.ej. piano) -y acordes. +Esta sección es una introducción a las notas simultáneas: varios +instrumentos, varios pentagramas para un solo instrumento +(p.ej. piano) y acordes. -La palabra @q{polifonía} en música hace referencia al hecho de tener más de una voz en un momento determinado -dentro de una pieza musical. La palabra @q{polifonía} en LilyPond se refiere al hecho de tener más de -una voz en el mismo pentagrama. +La palabra @qq{polifonía} en música hace referencia al hecho de tener +más de una voz en un momento determinado dentro de una pieza musical. +La palabra @qq{polifonía} en LilyPond se refiere al hecho de tener más +de una voz en el mismo pentagrama. @menu * Music expressions explained:: * Multiple staves:: -* Piano staves:: +* Staff groups:: * Combining notes into chords:: * Single staff polyphony:: @end menu @@ -869,39 +1032,76 @@ una voz en el mismo pentagrama. @node Music expressions explained @subsection Music expressions explained -En los archivos de entrada de LilyPond, la música se representa mediante @emph{expresiones -musicales}. Una sola nota es una expresión musical, aunque no es una -entrada válida por sí sola. +En los archivos de entrada de LilyPond, la música se representa +mediante @emph{expresiones musicales}. Una sola nota es una expresión +musical: -@lilypond[quote,ragged-right,verbatim,fragment,relative=2] +@lilypond[verbatim,quote,ragged-right,fragment,relative=2] a4 @end lilypond -Al encerrar un grupo de notas dentro de llaves creamos una expresión musical: +Al encerrar un grupo de notas dentro de llaves creamos una +@emph{expresión musical compuesta}. Aquí hemos creado una expresión +musical compuesta con dos notas: @lilypond[quote,ragged-right,verbatim,fragment,relative=2] { a4 g4 } @end lilypond -Si colocamos un grupo de expresiones musicales (p.ej.: notas) dentro de llaves, eso significa que -se encuentran en secuencia (es decir, cada una sigue a la anterior). El resultado -es otra expresión musical: +Si colocamos un grupo de expresiones musicales (p.ej.: notas) dentro +de llaves, eso significa que se encuentran en secuencia (es decir, +cada una sigue a la anterior). El resultado es otra expresión +musical: -@lilypond[quote,ragged-right,verbatim,fragment,relative=2] +@lilypond[verbatim,quote,ragged-right,fragment,relative=2] { { a4 g } f g } @end lilypond +@cindex expresión +@cindex expresión musical +@subheading Analogy: mathematical expressions + +Este mecanismo es semejante a las fórmulas matemáticas: una fórmula +grande se construye combinando fórmulas pequeñas. Dichas fórmulas se +llaman expresiones, y su definición es recursiva de tal forma que se +pueden construir expresiones de un tamaño y complejidad arbitrarios. +Por ejemplo: + +@example +1 + +1 + 2 + +(1 + 2) * 3 + +((1 + 2) * 3) / (4 * 5) +@end example + +Ésta es una secuencia de expresiones donde cada expresión se encuentra +contenida dentro de la siguiente, más grande. Las expresiones más +simples son números, y las mayores se hacen combinando expresiones +mediante operadores (como @code{+}, @code{*} y @code{/}) y paréntesis. +Del mismo modo que las expresiones matemáticas, las expresiones +musicales se pueden anidar a una profundidad arbitraria, lo que se +hace necesario para músicas complejas como las partituras polifónicas. + + @subheading Simultaneous music expressions: multiple staves -Esta técnica es muy útil para la música polifónica. Para introducir música -con más voces o con más pentagramas, lo que hacemos es combinar varias expresiones en -paralelo. Para indicar que dos voces se deben interpretar al mismo tiempo, -sencillamente introduzca una combinación simultánea de expresiones musicales. Una -expresión musical @q{simultánea} se forma encerrando las expresiones dentro de -@code{<<} y @code{>>}. En el ejemplo que sigue, tres secuencias (cada una de las cuales -contiene dos notas diferentes) se combinan de forma simultánea: +Glosario musical: +@rglos{polyphony}. + +Esta técnica es muy útil para la música @notation{polifónica}. Para +introducir música con más voces o con más pentagramas, lo que hacemos +es combinar varias expresiones en paralelo. Para indicar que dos +voces se deben interpretar al mismo tiempo, sencillamente introduzca +una combinación simultánea de expresiones musicales. Una expresión +musical @q{simultánea} se forma encerrando las expresiones dentro de +@code{<<} y @code{>>}. En el ejemplo que sigue, tres secuencias (cada +una de las cuales contiene dos notas diferentes) se combinan de forma +simultánea: -@lilypond[quote,ragged-right,verbatim] +@lilypond[verbatim,quote,ragged-right] \relative c'' { << { a4 g } @@ -911,70 +1111,47 @@ contiene dos notas diferentes) se combinan de forma simultánea: } @end lilypond -Tenga en cuenta que hemos sangrado cada nivel jerárquico de la entrada con un margen -distinto. A LilyPond no le importa cuánto (o cuán poco) espacio haya -al comienzo de una línea, pero el establecimiento de márgenes distintos dentro del código de LilyPond, de esta forma, lo +Tenga en cuenta que hemos sangrado cada nivel jerárquico de la entrada +con un margen distinto. A LilyPond no le importa cuánto (o cuán poco) +espacio haya al comienzo de una línea, pero el establecimiento de +márgenes distintos dentro del código de LilyPond, de esta forma, lo hace mucho más fácil de leer por nosotros los seres humanos. -@strong{Advertencia}: cada nota se entiende relativa a la -nota anterior de la entrada, no relativa a la @code{c''} dentro de la -instrucción inicial @code{\relative}. +@warning{cada nota se entiende relativa a la nota anterior de la +entrada, no relativa a la @code{c''} dentro de la instrucción inicial +@code{@bs{}\relative}.} @subheading Simultaneous music expressions: single staff -Para determinar el número de pentagramas en una pieza, LilyPond examina la primera -expresión. Si ésta consiste en una sola nota, hay un solo pentagrama; si hay una -expresión simultánea, hay más de un pentagrama. +Para determinar el número de pentagramas en una pieza, LilyPond +examina la primera expresión. Si ésta consiste en una sola nota, hay +un solo pentagrama; si hay una expresión simultánea, hay más de un +pentagrama. -@lilypond[quote,ragged-right,verbatim] +@lilypond[verbatim,quote,ragged-right] \relative c'' { c2 <> << { e f } { c <> } >> } @end lilypond -@cindex expresión -@cindex expresión musical -@subheading Analogy: mathematical expressions - -Este mecanismo es semejante a las fórmulas -matemáticas: una fórmula grande se construye combinando fórmulas pequeñas. Dichas -fórmulas se llaman expresiones, y su definición es recursiva de tal forma que -se pueden construir expresiones de un tamaño y complejidad arbitrarios. Por ejemplo: - -@example -1 - -1 + 2 - -(1 + 2) * 3 - -((1 + 2) * 3) / (4 * 5) -@end example - -Ésta es una secuencia de expresiones donde cada expresión se encuentra contenida dentro -de la siguiente, más grande. Las expresiones más simples son números, y las mayores -se hacen combinando expresiones mediante operadores (como @samp{+}, -@samp{*} y @samp{/}) y paréntesis. Del mismo modo que las expresiones matemáticas, -las expresiones musicales se pueden anidar a una profundidad arbitraria, lo que se hace necesario -para músicas complejas como las partituras polifónicas. - - @node Multiple staves @subsection Multiple staves -Como ya hemos visto en @ruser{Music expressions explained}, los archivos de entrada para LilyPond -se construyen a base de expresiones musicales. Si la partitura comienza con -expresiones musicales simultáneas, LilyPond crea varios pentagramas. Sin embargo -es más fácil ver lo que ocurre si creamos cada uno de los pentagramas de forma explícita. +Como ya hemos visto en @ref{Music expressions explained}, los +archivos de entrada para LilyPond se construyen a base de expresiones +musicales. Si la partitura comienza con expresiones musicales +simultáneas, LilyPond crea varios pentagramas. Sin embargo es más +fácil ver lo que ocurre si creamos cada uno de los pentagramas de +forma explícita. -Para imprimir más de un pentagrama, cada fragmento de música que constituye un -pentagrama se marca escribiendo @code{\new Staff} antes de él. Estos -elementos @code{Staff} se combinan después en paralelo con @code{<<} y -@code{>>}: +Para imprimir más de un pentagrama, cada fragmento de música que +constituye un pentagrama se marca escribiendo @code{\new Staff} antes +de él. Estos elementos @code{Staff} se combinan después en paralelo +con @code{<<} y @code{>>}: -@lilypond[quote,ragged-right,verbatim] +@lilypond[verbatim,quote,ragged-right] \relative c'' { << \new Staff { \clef treble c } @@ -983,47 +1160,54 @@ elementos @code{Staff} se combinan después en paralelo con @code{<<} y } @end lilypond -La instrucción @code{\new} inaugura un @q{contexto de notación}. Un contexto de -notación es un entorno dentro del que se interpretan los acontecimientos musicales (como las notas o las -instrucciones @code{\clef}). Para piezas sencillas, tales -contextos de notación se crean automáticamente. Para piezas más complicadas, es mejor -marcar los contextos de forma explícita. - -Existen varias clases de contextos. @code{Score}, @code{Staff} -y @code{Voice} manejan la notación melódica, mientras que @code{Lyrics} se ocupa de los textos -cantados y @code{ChordNames} imprime los nombres de los acordes. - -En términos de sintaxis, la anteposición de @code{\new} a una expresión musical -crea una expresión musical mayor. Es semejante al signo -menos de las matemáticas. La fórmula @math{(4+5)} es una expresión, por tanto -@math{-(4+5)} es una expresión más amplia. - -Las indicaciones de compás escritas en un pentagrama afectan al -resto de ellos@footnote{Este comportamiento se puede cambiar si uno lo desea; consulte -@ruser{Polymetric notation} para ver más detalles.}. En cambio, -la armadura de la tonalidad de un pentagrama @emph{no} afecta a los otros -pentagramas. - -@lilypond[quote,ragged-right,verbatim] +La instrucción @code{\new} inaugura un @q{contexto de notación}. Un +contexto de notación es un entorno dentro del que se interpretan los +acontecimientos musicales (como las notas o las instrucciones +@code{\clef}). Para piezas sencillas, tales contextos de notación se +crean automáticamente. Para piezas más complicadas, es mejor marcar +los contextos de forma explícita. + +Existen varias clases de contextos. @code{Score}, @code{Staff} y +@code{Voice} manejan la notación melódica, mientras que @code{Lyrics} +se ocupa de los textos cantados y @code{ChordNames} imprime los +nombres de los acordes. + +En términos de sintaxis, la anteposición de @code{\new} a una +expresión musical crea una expresión musical mayor. Es semejante al +signo menos de las matemáticas. La fórmula @math{(4+5)} es una +expresión, por tanto @math{-(4+5)} es una expresión más amplia. + +Las indicaciones de compás escritas en un pentagrama afectan al resto +de ellos, de forma predeterminada. En cambio, la armadura de la +tonalidad de un pentagrama @emph{no} afecta a los otros pentagramas. +Este comportamiento predeterminado diferente es a causa de que las +partituras con instrumentos transpositores son más comunes que las +partituras polirrítmicas. + +@lilypond[verbatim,quote,ragged-right] \relative c'' { << - \new Staff { \clef treble \time 3/4 c } - \new Staff { \clef bass \key d \major c,, } + \new Staff { \clef treble \key d \major \time 3/4 c } + \new Staff { \clef bass c,, } >> } @end lilypond +@node Staff groups +@subsection Staff groups +@cindex piano staff +@cindex choir staff +@cindex grand staff +Glosario musical: +@rglos{brace}. -@node Piano staves -@subsection Piano staves - -@cindex salto de pentagrama, establecimiento manual -@cindex voz de pentagrama cruzado, establecimiento manual -La música para piano se compone tipográficamente en forma de dos pentagramas unidos mediante una llave. El aspecto impreso de -este sistema de pentagramas se parece al ejemplo polifónico que aparece en @ruser{Multiple staves}, -pero en esta ocasión la expresión completa se coloca dentro de un @code{PianoStaff}: +La música para piano se compone tipográficamente en forma de dos +pentagramas unidos mediante una @notation{llave}. El aspecto impreso +de este sistema de pentagramas se parece al ejemplo polifónico que +aparece en @ref{Multiple staves}, pero en esta ocasión la expresión +completa se coloca dentro de un @code{PianoStaff}: @example \new PianoStaff << @@ -1034,7 +1218,7 @@ pero en esta ocasión la expresión completa se coloca dentro de un @code{PianoS He aquí un pequeño ejemplo: -@lilypond[quote,ragged-right,verbatim] +@lilypond[verbatim,quote,ragged-right] \relative c'' { \new PianoStaff << \new Staff { \time 2/4 c4 e g g, } @@ -1043,32 +1227,53 @@ He aquí un pequeño ejemplo: } @end lilypond +Otros grupos de pentagramas se declaran mediante @code{\new +GrandStaff}, que es apropiado para partituras orquestales, y +@code{\new ChoirStaff}, que es apropiado para partituras vocales. +Cada uno de estos grupos de pautas forma un tipo de contexto distinto, +que produce la llave a la izquierda y que también controla el alcance +de las líneas divisorias. + @seealso -@quotation -Ver @ruser{Piano music}. -@end quotation + +Referencia de la notación: +@ruser{Keyboard instruments}, +@ruser{Displaying staves}. + @node Combining notes into chords @subsection Combining notes into chords @cindex acordes -Los acordes se hacen rodeando las notas con paréntesis en ángulo simples. Los paréntesis -en ángulo son los símbolos @samp{<} (menor que) y @samp{>} (mayor que). -@lilypond[quote,fragment,verbatim,relative=2,fragment] +Glosario musical: +@rglos{chord}. + +Hemos visto con anterioridad cómo se pueden combinar las notas +formando @notation{acordes} que indican que son simultáneas, +encerrándolas entre dobles ángulos. Sin embargo, la forma normal de +indicar un acorde es encerrar las notas entre ángulos +@emph{sencillos}. Observe que todas las notas de un acorde deben +tener la misma duración, y que la duración se escribe después del +ángulo de cierre. + + +@lilypond[verbatim,quote,ragged-right,fragment,relative=2] r4 4 2 @end lilypond -Se pueden combinar las marcas como barras y ligaduras con acordes. Se deben -colocar por fuera de los paréntesis en ángulo: +Debemmos pensar en los acordes como algo casi equivalente a las notas +sencillas: casi todo lo que se puede adjuntar a una nota se puede +adjuntar también a un acorde, y todo debe ir @emph{por fuera} de los +ángulos. Por ejemplo, puede combinar marcas como barras y ligaduras, +con acordes. Tan sólo debe recordar que se escriben por fuera de los +ángulos. -@lilypond[quote,fragment,verbatim,relative=2,fragment] +@lilypond[verbatim,quote,ragged-right,fragment,relative=2] r4 8[ ]~ 2 +r4 8( \> 4 \!) @end lilypond -@lilypond[quote,fragment,verbatim,relative=2,fragment] -r4 8\>( 4 \!) -@end lilypond @node Single staff polyphony @subsection Single staff polyphony @@ -1076,28 +1281,31 @@ r4 8\>( 4 \!) @cindex polifonía @cindex varias voces @cindex voces, más (en un solo pentagrama) -Cuando distintas líneas melódicas se combinan sobre un solo pentagrama, se -imprimen como voces polifónicas; cada voz lleva sus propias plicas, ligaduras y -barras de corchea, y la voz superior tiene las plicas hacia arriba mientras que la voz inferior las -tiene hacia abajo. -La introducción de estas partes se hace escribiendo cada voz en forma de secuencia (con -@code{@{...@}}) y combinando éstas de forma simultánea, separando las -voces con @code{\\} +Cuando distintas líneas melódicas se combinan sobre un solo +pentagrama, se imprimen como voces polifónicas; cada voz lleva sus +propias plicas, ligaduras y barras de corchea, y la voz superior tiene +las plicas hacia arriba mientras que la voz inferior las tiene hacia +abajo. -@lilypond[quote,ragged-right,verbatim,fragment,relative=2] +La introducción de estas partes se hace escribiendo cada voz en forma +de secuencia (con @code{@{...@}}) y combinando éstas de forma +simultánea, separando las voces con @code{\\} + +@lilypond[verbatim,quote,ragged-right,fragment,relative=2] << { a4 g2 f4~ f4 } \\ { r4 g4 f2 f4 } >> @end lilypond -Para el tipografiado de música polifónica, puede ser conveniente la utilización de silencios separadores, o sea, -silencios que no aparecen impresos. Son muy útiles para rellenar -voces que temporalmente no están cantando. He aquí el mismo ejemplo con un -silencio separador (@samp{s}) en vez de un silencio normal (@samp{r}): +Para el tipografiado de música polifónica, puede ser conveniente la +utilización de silencios separadores, o sea, silencios que no aparecen +impresos. Son muy útiles para rellenar voces que temporalmente no +están cantando. He aquí el mismo ejemplo con un silencio separador +(@code{s}) en vez de un silencio normal (@code{r}): -@lilypond[quote,ragged-right,verbatim,fragment,relative=2] +@lilypond[verbatim,quote,ragged-right,fragment,relative=2] << { a4 g2 f4~ f4 } \\ { s4 g4 f2 f4 } @@ -1107,7 +1315,7 @@ silencio separador (@samp{s}) en vez de un silencio normal (@samp{r}): @noindent Una vez más, las expresiones de este tipo se pueden anidar de forma arbitraria. -@lilypond[quote,fragment,verbatim,relative=2,fragment] +@lilypond[verbatim,quote,ragged-right,fragment,relative=2] << \new Staff << { a4 g2 f4~ f4 } \\ @@ -1122,219 +1330,420 @@ Una vez más, las expresiones de este tipo se pueden anidar de forma arbitraria. @end lilypond @seealso -@quotation -Ver @ruser{Basic polyphony}. -@end quotation + +Referencia de la notación: @ruser{Simultaneous notes}. @node Songs @section Songs -Esta sección es una introducción a la música vocal y a las partituras de canciones sencillas. +En esta sección presentamos cómo elaborar música vocal y hojas de +canción sencillas. @menu -* Printing lyrics:: -* A lead sheet:: +* Setting simple songs:: +* Aligning lyrics to a melody:: +* Lyrics to multiple staves:: @end menu -@node Printing lyrics -@subsection Printing lyrics +@node Setting simple songs +@subsection Setting simple songs -@cindex Letra -@cindex Canciones -Consideremos una melodía sencilla: +@cindex letra +@cindex canciones -@lilypond[quote,ragged-right,verbatim] +Glosario musical: +@rglos{lyrics}. + +Presentamos a continuación el inicio de la melodía de una canción +infantil, @qq{Girls and boys come out to play}: + +@lilypond[verbatim,quote,ragged-right] \relative c'' { - a4 e c8 e r4 - b2 c4( d) + \key g \major + \time 6/8 + d4 b8 c4 a8 d4 b8 g4 } @end lilypond -La letra se puede asignar a esas notas, combinando ambas con la -palabra clave @code{\addlyrics}. La letra se escribe separando cada -sílaba mediante un espacio. +La @notation{letra} se puede asignar a esas notas, combinando ambas +con la palabra clave @code{\addlyrics}. La letra se escribe separando +cada sílaba mediante un espacio. -@lilypond[quote,ragged-right,verbatim] +@lilypond[verbatim,quote,ragged-right] << \relative c'' { - a4 e c8 e r4 - b2 c4( d) + \key g \major + \time 6/8 + d4 b8 c4 a8 d4 b8 g4 + } + \addlyrics { + Girls and boys come out to play, } - \addlyrics { One day this shall be free } >> @end lilypond +Observe las llaves rodeando tanto la música como la letra, y los +ángulos dobles @code{<< ... >>} alrededor del fragmento entero para +expresar que la música y la letra han de suceder al mismo tiempo. + +@node Aligning lyrics to a melody +@subsection Aligning lyrics to a melody + +Glosario musical: +@rglos{melisma}, +@rglos{extender line}. + @cindex melisma -@cindex línea de extensión de sílabas -Esta melodía acaba en un @rglos{melisma}, una sílaba única (@q{suelta}) -que se canta sobre más de una nota. Esto se indica mediante una @emph{línea -de extensión}. Se escribe como dos guiones bajos @code{__}: +@cindex línea de extensión +@cindex guión +@cindex guión bajo + +La siguiente línea de la canción infantil es @q{The moon doth shine as +bright as day}. A continuación vamos a ampliarla: -@lilypond[quote,ragged-right,verbatim] +@lilypond[verbatim,quote,ragged-right] << \relative c'' { - a4 e c8 e r4 - b2 c4( d) + \key g \major + \time 6/8 + d4 b8 c4 a8 d4 b8 g4 + g8 a4 b8 c b a d4 b8 g4. + } + \addlyrics { + Girls and boys come out to play, + The moon doth shine as bright as day; } - \addlyrics { One day this shall be free __ } >> @end lilypond -De forma parecida, los guiones entre las palabras se pueden escribir como dos guiones, -dando como resultado unas líneas cortas entre cada dos sílabas: +Podemos observar que la letra adicional no se alinea correctamente con +las notas. La palabra @q{shine} se debe cantar sobre dos notas, no +una. Esto se conoce como @notation{melisma}, una sílaba única que se +canta sobre más de una nota. Existen varias formas de hacer que una +sílaba recaiga sobre varias notas, siendo la más sencilla escribir una +ligadura de expresión sobre ellas (véase @ref{Ties and slurs}): -@c aquí no se pone ragged-right porque los guiones se perderían. -@lilypond[quote,verbatim] +@lilypond[verbatim,quote,ragged-right] << - \relative c' { - \time 2/4 - f4 f c c + \relative c'' { + \key g \major + \time 6/8 + d4 b8 c4 a8 d4 b8 g4 + g8 a4 b8 c([ b)] a d4 b8 g4. } - \addlyrics { A -- le -- gri -- a } ->> + \addlyrics { + Girls and boys come out to play, + The moon doth shine as bright as day; + } +>> @end lilypond -@seealso -@quotation -Otras posibilidades como poner varios versos debajo de una melodía, se -discuten en @ruser{Vocal music}. -@end quotation +Aquí hemos usado además el barrado manual (los corchetes rectos +@code{[ ]} ) para producir el barrado que corresponde a la letra por +convención (véase @ref{Automatic and manual beams}). +Como alternativa a la utilización de ligaduras de expresión, los +melismas se pueden indicar solamente en la letra utilizando un guión +bajo, @code{_}, para cada nota que queremos incluir dentro del +melisma: -@node A lead sheet -@subsection A lead sheet - -@cindex Hojas guía de acordes -@cindex acordes -@cindex nombres de los acordes +@lilypond[verbatim,quote,ragged-right] +<< + \relative c'' { + \key g \major + \time 6/8 + d4 b8 c4 a8 d4 b8 g4 + g8 a4 b8 c[ b] a d4 b8 g4. + } + \addlyrics { + Girls and boys come out to play, + The moon doth shine _ as bright as day; + } +>> +@end lilypond -En la música pop es muy común denotar el acompañamiento con los nombres de los acordes. -Estos acordes se pueden escribir como notas: +Si una sílaba se extiende sobre varias notas o una sola nota muy +larga, normalmente se traza una @notation{línea extensora} desde la +sílaba que se extiende y por debajo de todas las notas que +corresponden a dicha sílaba. Se escribe como dos guiones bajos +@code{__}. He aquí un ejemplo extraído de los primeros tres compases +del Lamento de Dido, de Dido y Eneas de Purcell: -@lilypond[quote,ragged-right,verbatim] -\chordmode { c2 f4. g8 } +@lilypond[verbatim,quote,ragged-right] +<< + \relative c'' { + \key g \minor + \time 3/2 + g2 a bes bes( a) + b c4.( bes8 a4. g8 fis4.) g8 fis1 + } + \addlyrics { + When I am laid, + am laid __ in earth, + } +>> @end lilypond -Ahora, cada altura se lee como la fundamental de un acorde en vez de como una nota. -Este modo se activa con @code{\chordmode}. Otros acordes pueden -construirse añadiendo modificadores después de un signo de dos puntos. El -ejemplo que sigue muestra algunos modificadores comunes: +Hasta el momento, ninguno de los ejemplos implicaban palabras que +tuviesen más de una sílaba. Estas palabras se reparten por lo general +a razón de una nota por cada sílaba, con guiones cortos entre las +sílabas. Dichos guiones separadores se teclean como dos guiones, con +el resultado de un guión corto centrado entre las sílabas. +Presentamos a continuación un ejemplo que demuestra esto y todo lo que +hemos aprendido hasta el momento acerca de la alineación de la letra a +las notas. + +@c no ragged-right here because otherwise the hyphens get lost, +@c but the example is long enough to avoid looking strange. +@lilypond[verbatim,quote] +<< + \relative c' { + \key g \major + \time 3/4 + \partial 4 + d4 g4 g a8( b) g4 g4 + b8( c) d4 d e4 c2 + } + \addlyrics { + A -- way in a __ man -- ger, + no __ crib for a bed, __ + } +>> +@end lilypond -@lilypond[quote,verbatim,ragged-right] -\chordmode { c2 f4:m g4:maj7 gis1:dim7 } +Algunos textos (especialmente los que están en italiano o en español) +requieren lo contrario: colocar más de una sílaba a una única nota. +Esto se consigue enlazando las sílabas entre sí mediante un guión bajo +simple @code{_} (sin ningún espacio), o bien encerrándolas entre +corchetes. Aquí aparece un ejemplo procedente del @qq{Barbero de +Sevilla} de Rossini, donde la sílaba @q{al} se canta sobre la misma +nota que @q{go} de la palabra @q{Largo} en el aria de Fígaro @q{Largo +al factotum}: + +@c no ragged-right here because otherwise the hyphens get lost, +@c but the example is long enough to avoid looking strange. +@lilypond[verbatim,quote] +<< + \relative c' { + \clef bass + \key c \major + \time 6/8 + c4.~ c8 d b c([ d)] b c d b c + } + \addlyrics { + Lar -- go_al fac -- to -- tum del -- la cit -- tà + } +>> @end lilypond -Para canciones con acordes, éstos no se imprimen sobre pentagramas, sino como nombres en su -propia línea. Esto se consigue utilizando @code{\chords} en sustitución -de @code{\chordmode}. Utiliza la misma sintaxis que @code{\chordmode}, -pero pinta las notas dentro de un contexto de @code{ChordNames}, con el -siguiente resultado: -@lilypond[quote,verbatim,ragged-right] -\chords { c2 f4.:m g4.:maj7 gis8:dim7 } -@end lilypond +@seealso -@cindex hoja guía de acordes -Cuando se combinan, los nombres de acorde, la letra y la melodía forman -una hoja de canción con acordes (@q{lead sheet}): +Referencia de la notación: +@ruser{Vocal music}. -@lilypond[quote,verbatim,ragged-right] + + +@node Lyrics to multiple staves +@subsection Lyrics to multiple staves + +La solución sencilla que utiliza @code{\addlyrics} se puede usar para +poner letra a más de un pentagrama. Aquí aparece un ejemplo sacado +del @qq{Judas Macabeo} de Haendel: + +@lilypond[verbatim,quote,ragged-right] << - \chords { c2 g:sus4 f e } + { + \time 6/8 + \partial 8 + } \relative c'' { - a4 e c8 e r4 - b2 c4( d) + \key f \major + c8 c([ bes)] a a([ g)] f f'4. b, c4.~ c4 + } + \addlyrics { + Let flee -- cy flocks the hills a -- dorn, __ + } + \relative c' { + \key f \major + r8 r4. r4 c8 a'([ g)] f f([ e)] d e([ d)] c bes'4 + } + \addlyrics { + Let flee -- cy flocks the hills a -- dorn, } - \addlyrics { One day this shall be free __ } >> @end lilypond +@noindent +pero cualquier partitura de una complejidad mayor que la de este +sencillo ejemplo se hace mejor separando la letra de la estructura de +pentagramas mediante variables (expresiones con nombre). Éstas se +tratan en @ref{Organizing pieces with variables}. @seealso -@quotation -Puede ver una lista completa de los modificadores y otras opciones de presentación -en @ruser{Chords}. -@end quotation +Referencia de la notación: +@ruser{Vocal music}. @node Final touches @section Final touches -Éste es el último apartado del tutorial; muestra la forma de dar los toques finales -a piezas sencillas, y ofrece una introducción al resto +Éste es el último apartado del tutorial; muestra la forma de dar los +toques finales a piezas sencillas, y ofrece una introducción al resto del manual. @menu +* Organizing pieces with variables:: * Version number:: * Adding titles:: * Absolute note names:: -* Organizing pieces with identifiers:: * After the tutorial:: -* How to read the manual:: @end menu +@node Organizing pieces with variables +@subsection Organizing pieces with variables + +Cuando los elementos que hemos discutido anteriormente se combinan +para producir archivos mayores, las expresiones musicales se hacen +enormes. En música polifónica con muchos pentagramas, los archivos de +entrada pueden volverse muy propensos a la confusión. Podemos reducir +esta confusión utilizando las @emph{variables}. + +Con las variables (también conocidas como identificadores o macros), +podemos trocear las expresiones musicales complejas. Una variable se +asigna de la manera siguiente: + +@example +musicaConNombre = @{ @dots{} @} +@end example + +El contenido de la expresión musical @code{musicaConNombre} se puede usar +posteriormente colocando una barra invertida delante del nombre +(@code{\musicaConNombre}, igual que una orden normal de LilyPond). + +@lilypond[verbatim,quote,ragged-right] +violin = \new Staff { \relative c'' { + a4 b c b +}} +cello = \new Staff { \relative c { + \clef bass + e2 d +}} +{ + << + \violin + \cello + >> +} +@end lilypond + +@noindent +El nombre de una variable debe consistir enteramente en caracteres +alfabéticos, es decir sin números, guiones ni guiones bajos. + +Las variables se deben definir @emph{antes} de la expresión musical +principal, pero se pueden usar tantas veces como se quiera, en +cualquier lugar, una vez que han sido definidas. Incluso se pueden +usar dentro de la definición de otra variable, proporcionando una vía +para acortar el código si una sección musical se repite muchas veces. + +@c KEEP LY +@lilypond[verbatim,quote,ragged-right] +tresilloA = \times 2/3 { c,8 e g } +compasA = { \tresilloA \tresilloA \tresilloA \tresilloA } + +\relative c'' { + \compasA \compasA +} +@end lilypond + +Las variables se pueden usar para otros muchos tipos de objetos dentro +del código de entrada. Por ejemplo, + +@example +ancho = 4.5\cm +nombre = "Wendy" +papelAcinco = \paper @{ paperheight = 21.0 \cm @} +@end example + +Dependiendo de su contenido, la variable se puede usar en distintos +lugares. El siguiente ejemplo utiliza las variables anteriores: + +@example +\paper @{ + \papelAcinco + line-width = \ancho +@} +@{ c4^\nombre @} +@end example + + @node Version number @subsection Version number @cindex indicación de la versión -La indicación @code{\version} deja registrado para qué versión de LilyPond se escribió -el archivo: +La indicación @code{\version} deja registrado para qué versión de +LilyPond se escribió el archivo: @example -\version "2.11.23" +\version @w{"@version{}"} @end example @noindent -por convenio se sitúa al principio del archivo de partitura de LilyPond. +por convenio se sitúa al principio del archivo de partitura de +LilyPond. -Estas anotaciones hacen menos problemáticas las subsiguientes actualizaciones de LilyPond. -Los cambios en la sintaxis se tratan mediante un programa especial, -@file{convert-ly} (ver @rprogram{Updating files with convert-ly}), y utiliza -@code{\version} para determinar qué reglas hay que aplicar. +Estas anotaciones hacen menos problemáticas las subsiguientes +actualizaciones de LilyPond. Los cambios en la sintaxis se tratan +mediante un programa especial, @file{convert-ly}, y utiliza +@code{\version} para determinar qué reglas hay que aplicar. Para ver +más detalles, consulte @rprogram{Updating files with convert-ly}). @node Adding titles @subsection Adding titles -La información sobre el título, autor, número de Opus y similares se escriben -en el bloque @code{\header}. Éste se encuentra fuera de la expresión musical -principal; el bloque @code{\header} normalmente se sitúa por debajo del -@ruser{Version number}. +La información sobre el título, autor, número de Opus y similares se +escriben en el bloque @code{\header}. Éste se encuentra fuera de la +expresión musical principal; el bloque @code{\header} normalmente se +sitúa por debajo del @ref{Version number}. @example -\version "2.11.23" +\version @w{"@version{}"} \header @{ - title = "Symphony" - composer = "Me" + title = "Sinfonía" + composer = "Yo" opus = "Op. 9" @} @{ - @dots{} music @dots{} + @dots{} música @dots{} @} @end example -Cuando se procesa el archivo, el título y el autor se imprimen por encima -de la música. Puede obtener más información sobre los títulos en @ruser{Creating -titles}. +Cuando se procesa el archivo, el título y el autor se imprimen por +encima de la música. Puede obtener más información sobre los títulos +en @ruser{Creating titles}. @node Absolute note names @subsection Absolute note names -Hasta el momento siempre hemos utilizado @code{\relative} para definir las alturas. Ésta es la -forma más sencilla de escribir la mayor parte de la música, pero existe otra forma de definir -las alturas: el modo absoluto. +Hasta el momento siempre hemos utilizado @code{\relative} para definir +las alturas. Ésta es la forma más sencilla de escribir la mayor parte +de la música, pero existe otra forma de definir las alturas: el modo +absoluto. Si omite el @code{\relative}, LilyPond tratará todas las alturas como -valores absolutos. Una @code{c'} significará siembre un Do central, una @code{b} significará -siempre la nota inmediatamente por debajo del Do central, y una @code{g,} significará -siempre la nota que se coloca en la primera línea del pentagrama en clave de Fa. +valores absolutos. Una @code{c'} significará siembre un Do central, +una @code{b} significará siempre la nota inmediatamente por debajo del +Do central, y una @code{g,} significará siempre la nota que se coloca +en la primera línea del pentagrama en clave de Fa. -@lilypond[quote,verbatim,ragged-right] +@lilypond[verbatim,quote,ragged-right] { \clef bass c' b g, g, @@ -1359,10 +1768,11 @@ He aquí una escala que abarca cuatro octavas: } @end lilypond -Como puede ver, escribir una melodía en clave de Sol implica escribir gran cantidad de -apóstrofes ' . Consideremos este fragmento de Mozart: +Como puede ver, escribir una melodía en clave de Sol implica escribir +gran cantidad de apóstrofes @q{'} . Consideremos este fragmento de +Mozart: -@lilypond[quote,verbatim,ragged-right] +@lilypond[verbatim,quote,ragged-right] { \key a \major \time 6/8 @@ -1371,11 +1781,11 @@ apóstrofes ' . Consideremos este fragmento de Mozart: } @end lilypond -Todos estos apóstrofes hacen casi ilegible el código de entrada y será origen de numerosos -errores. Con @code{\relative}, el ejemplo anterior es mucho más fácil -de leer: +Todos estos apóstrofes hacen casi ilegible el código de entrada y será +origen de numerosos errores. Con @code{\relative}, el ejemplo +anterior es mucho más fácil de leer: -@lilypond[quote,verbatim,ragged-right] +@lilypond[verbatim,quote,ragged-right] \relative c'' { \key a \major \time 6/8 @@ -1384,116 +1794,32 @@ de leer: } @end lilypond -Si comete un error con una marca de octava (@code{'} o @code{,}) mientras -trabaja en el modo @code{\relative}, será muy obvio (muchas notas estarán -en la octava equivocada). Mientras trabaja en el modo absoluto, un solo fallo -no será tan visible, y tampoco será tan fácil de localizar. - -Sin embargo, el modo absoluto es útil para escribir música que contenga intervalos grandes, y -será extremadamente útil para hacer archivos de LilyPond generados por ordenador. - - -@node Organizing pieces with identifiers -@subsection Organizing pieces with identifiers - -Cuando los elementos que hemos discutido anteriormente se combinan para producir -archivos mayores, las expresiones musicales se hacen enormes. En música -polifónica con muchos pentagramas, los archivos de entrada pueden volverse muy propensos a la confusión. Podemos -reducir esta confusión utilizando los @emph{identificadores}. - -Con los identificadores (también conocidos como variables o macros), podemos trocear las -expresiones musicales complejas. Un identificador se asigna de la manera siguiente: - -@example -musicaConNombre = @{ @dots{} @} -@end example - -El contenido de la expresión musical @code{musicaConNombre} se puede usar -posteriormente colocando una barra invertida delante del nombre -(@code{\musicaConNombre}, igual que una orden normal de LilyPond). Los identificadores -se deben definir @emph{antes} de la expresión musical principal. - -@lilypond[quote,verbatim,ragged-right] -violin = \new Staff { \relative c'' { - a4 b c b -}} -cello = \new Staff { \relative c { - \clef bass - e2 d -}} -{ - << - \violin - \cello - >> -} -@end lilypond - -@noindent -El nombre de un identificador debe consistir enteramente en caracteres alfabéticos, es decir -sin números, guiones ni guiones bajos. - -Es posible utilizar variables para otras muchas clases de objetos en el código de -entrada. Por ejemplo: - -@example -width = 4.5\cm -name = "Wendy" -aFivePaper = \paper @{ paperheight = 21.0 \cm @} -@end example - -Dependiendo de su contenido, el identificador se puede usar en distintos -lugares. El siguiente ejemplo utiliza las variables anteriores: +Si comete un error con una marca de octava (@code{'} o @code{,}) +mientras trabaja en el modo @code{\relative}, será muy obvio (muchas +notas estarán en la octava equivocada). Mientras trabaja en el modo +absoluto, un solo fallo no será tan visible, y tampoco será tan fácil +de localizar. -@example -\paper @{ - \aFivePaper - line-width = \width -@} -@{ c4^\name @} -@end example +Sin embargo, el modo absoluto es útil para escribir música que +contenga intervalos grandes, y será extremadamente útil para hacer +archivos de LilyPond generados por ordenador. @node After the tutorial @subsection After the tutorial -Después de terminar el tutorial, quizá debería probar a escribir una o dos -piezas. Comience con una de las @ruser{Templates} y añada algunas -notas. Si necesita un tipo de notación que no ha sido tratada en el -tutorial, eche un vistazo a la Referencia de Notación, empezando por -@ruser{Basic notation}. Si quiere escribir música para un conjunto -instrumental que no está cubierto por ninguna plantilla, -consulte @ruser{Extending the templates}. - -Una vez que ha escrito algunas piezas cortas, lea el resto del -Manual de aprendizaje (capítulos 3 al 5). ¡Por supuesto, no pasa nada por -leerlo ahora mismo! Sin embargo, el resto del Manual -de Aprendizaje da por sentado que está familiarizado con la entrada -de LilyPond. Puede saltarse estos capítulos ahora -y volver a ellos cuando haya adquirido más experiencia. - - -@node How to read the manual -@subsection How to read the manual - -Como ya vimos en @ruser{How to read the tutorial}, muchos ejemplos del -tutorial omitían el @code{\relative c'' @{ ... @}} alrededor del ejemplo -mostrado. - -Durante el resto del manual seremos mucho menos estrictos respecto de los -ejemplos impresos: a veces pueden omitir el -@code{\relative c'' @{ ... @}}, pero otras veces se puede usar una nota inicial -diferente (como @code{c'} o @code{c,,}), y en ocasiones -¡todo el ejemplo estará en el modo de notas absoluto! Sin embargo, las ambigüedades de esta clase -existen solamente allí donde las alturas no son lo más importante. En aquellos ejemplos -en los que las alturas tienen importancia, hemos escrito explícitamente @code{\relative} -o bien el @code{@{ @}} en modo absoluto. - -Si aún tiene dudas respecto de la entrada de LilyPond exacta que se -ha utilizado en un ejemplo, lea la versión HTML (si no lo está haciendo ya) -y pulse con el ratón sobre la imagen de la música. De esta forma se mostrará la entrada -exacta que LilyPond usó para generar este manual. - -Para informarse sobre la estructura que tiene el resto del manual, consulte -@ruser{About this manual}. +Después de terminar el tutorial, quizá debería probar a escribir una o +dos piezas. Comience con una de las plantillas del @ref{Templates} y +añada algunas notas. Si necesita un tipo de notación que no ha sido +tratada en el tutorial, eche un vistazo a la Referencia de Notación, +empezando por @ruser{Musical notation}. Si quiere escribir música para +un conjunto instrumental que no está cubierto por ninguna plantilla, +consulte @ref{Extending the templates}. + +Una vez que ha escrito algunas piezas cortas, lea el resto del Manual +de aprendizaje (capítulos 3 al 5). ¡Por supuesto, no pasa nada por +leerlo ahora mismo! Sin embargo, el resto del Manual de Aprendizaje +da por sentado que está familiarizado con la entrada de LilyPond. +Puede saltarse estos capítulos ahora y volver a ellos cuando haya +adquirido más experiencia.