@c -*- coding: utf-8; mode: texinfo; -*-
@c This file is part of lilypond.tely
@ignore
- Translation of GIT committish: 0e1bfd7406edd13aaccccd6827657a64d298fadc
+ Translation of GIT committish: d0333749421c9695907a4da61a6e1cd7eafcb726
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.38"
+
@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.
+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.
-@ifhtml
-Muchas personas aprenden a utilizar programas probando y enredando con ellos.
-Esto también puede hacerse con LilyPond. Si hace click 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. Si le agrada esta forma de aprender,
-probablemente quiera imprimir o añadir a sus favoritos la dirección de la
-@ref{Cheat sheet}, que es una relación en forma de tabla de los comandos más comunes
-de manera que sirvan de referencia rápida.
-@end ifhtml
@menu
* First steps::
* Compiling a file::
* Simple notation::
* Working on text files::
-* How to read the tutorial::
+* 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
@{
@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]
}
@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é comandos 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 click 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 click 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 click 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 click 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 click 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 click 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 inicando 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
@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 @rglos{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
+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 @rglos{redonda},
+@code{2} significa @rglos{blanca}, @code{4} significa @rglos{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[quote,ragged-right,verbatim]
\relative c'' {
a1
}
@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 notas con puntillo (véase @rglos{dotted note}), añada un
+punto @samp{.} 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]
\relative c'' {
@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{rest} se introduce igual que si fuera una nota con el
+nombre @code{r}:
+
+@lilypond[verbatim,quote,ragged-right]
\relative c'' {
a r r2
r8 a r4 r4. r8
@subheading Time signature
-La @rglos{time signature}) se puede establecer con el comando @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]
\relative c'' {
@subheading Clef
-La @rglos{clef} se puede establecer utilizando el comando @code{\clef} :
+Glosario musical: @rglos{clef}.
+
+La @notation{clave} se puede establecer utilizando la orden
+@code{\clef} :
@lilypond[quote,ragged-right,verbatim]
\relative c' {
@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]
\relative c, {
}
@end lilypond
-@moreinfo
-@quotation
-@table @asis
-@item Introducir alturas y duraciones
-véase @ref{Pitches} y @ref{Durations}.
-@item Silencios
-véase @ref{Rests}.
-@item Indicaciones de compás y otros comandos de tiempo
-véase @ref{Time signature}.
-@item Claves
-véase @ref{Clef}.
-@end table
-@end quotation
+
+@seealso
+Referencia de la notación: @ruser{Writing pitches},
+@ruser{Writing rhythms}, @ruser{Writing rests},
+@ruser{Time signature}, @ruser{Clef}.
@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{%@{ ... %@}}.
+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:
+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
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
c4 c g' g a a g2
%@{
- Esta línea y las notas que aprecen más abajo
+ Esta línea y las notas que aparecen más abajo
se ignoran, por estar dentro de un
comentario de bloque.
@end itemize
-Hay más trucos para elaborar archivos de entrada en
-@ref{Suggestions for writing LilyPond files}.
+@node How to read the manual
+@subsection How to read the manual
-@node How to read the tutorial
-@subsection How to read the tutorial
-
-Como vimos en @ref{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.
+Como vimos en @ref{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. Para reproducir los ejemplos, deberá copiar y
+pegar la entrada que se muestra, pero @strong{deberá} escribir
+@code{\relative c'' @{ @}}, de la siguiente forma:
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 click
+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:
@}
@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 forma.
+
+
+
+@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
+podría ser mejor leer primero el resto del presente manual.
@node Single staff notation
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 @ref{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, @ref{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
-
-@moreinfo
-@quotation
-@table @asis
-@item Octavas relativas
-ver @ref{Relative octaves}.
-@item Comprobación de octava
-ver @ref{Octave check}.
-@end table
-@end quotation
-
-
-
@node Accidentals and key signatures
@subsection Accidentals and key signatures
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
-@ref{Note names in other languages}.}
+@ruser{Note names in other languages}.}
@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
cis1 ees fisis, aeses
@cindex tonalidad, armadura de la, establecer
@subheading Key signatures
-La armadura de la tonadlidad se establece mediante el comando @code{\key} seguido de
+La armadura de la tonalidad se establece mediante la instrucción @code{\key} seguido de
una nota y @code{\major} o @code{\minor}.
@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
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
-@ref{Automatic accidentals} para ver ejemplos de cómo se pueden imprimir las alteraciones
+@ruser{Automatic accidentals} para ver ejemplos de cómo se pueden imprimir las alteraciones
de acuerdo a reglas diferentes.
-@moreinfo
+@seealso
@quotation
@table @asis
@item Alteraciones accidentales
-ver @ref{Accidentals} y @ref{Automatic accidentals}.
+véase @ruser{Accidentals} y @ruser{Automatic accidentals}.
@item Armadura de la tonalidad
-ver @ref{Key signature}.
+véase @ruser{Key signature}.
@end table
@end quotation
@cindex ligaduras de unión
@subheading Ties
-Una @rglos{tie} se crea adjuntando un carácter tilde @samp{~} a la primera
-nota ligada
+Una @rglos{tie} se crea adjuntando un carácter de tilde curva @samp{~} a la primera
+nota ligada:
@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
g4~ g c2~
c2~( c8 fis fis4 ~ fis2 g2)
@end lilypond
-@moreinfo
+@seealso
@quotation
@table @asis
@item Ligaduras de unión
-ver @ref{Ties}.
+véase @ruser{Ties}.
@item Ligaduras de expresión
-ver @ref{Slurs}.
+véase @ruser{Slurs}.
@item Ligaduras de fraseo
-ver @ref{Phrasing slurs}.
+véase @ruser{Phrasing slurs}.
@end table
@end quotation
@cindex decrescendo
@cindex crescendo
-Los crescendi y decrescendi comienzan con los comandos @code{\<} y
+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 el comando @code{\!}:
+(de)crescendo, o bien se puede usar la orden @code{\!}:
@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
c2\< c2\ff\> c2 c2\!
@end lilypond
-@moreinfo
+@seealso
@quotation
@table @asis
@item Articulaciones
-ver @ref{Articulations}.
+véase @ruser{Articulations}.
@item Digitaciones
-ver @ref{Fingering instructions}.
+véase @ruser{Fingering instructions}.
@item Matices
-ver @ref{Dynamics}.
+véase @ruser{Dynamics}.
@end table
@end quotation
+@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
a8[ ais] d[ ees r d] a b
@end lilypond
-@moreinfo
+@seealso
@quotation
@table @asis
@item Barras automáticas
-ver @ref{Automatic beams}.
+véase @ruser{Automatic beams}.
@item Barras manuales
-ver @ref{Manual beams}.
+véase @ruser{Manual beams}.
@end table
@end quotation
@subsection Advanced rhythmic commands
@cindex anacrusa
-@c @cindex anacruse @c redundant, in spanish. FVD
@cindex compás parcial
@subheading Partial measure
@cindex appoggiatura
@subheading Grace notes
-Las notas de adorno se crean con el comando @code{\grace}, aunque
+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}
c2 \acciaccatura b16 c2
@end lilypond
-@moreinfo
+@seealso
@quotation
@table @asis
@item Notas de adorno
-ver @ref{Grace notes},
+véase @ruser{Grace notes},
@item Grupos especiales
-ver @ref{Tuplets},
+véase @ruser{Tuplets},
@item Anacrusas
-ver @ref{Partial measures}.
+véase @ruser{Partial measures}.
@end table
@end quotation
@section Multiple notes at once
Esta sección es una introducción a las notas simultáneas:
-varios instrumentos, varios pentragramas para un solo instrumento (p.ej. piano)
+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 pentragrama.
+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
{ { 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 @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.
+
+
@subheading Simultaneous music expressions: multiple staves
+Glosario musical: @rglos{polyphony}.
+
Esta técnica es muy útil para la música polifónica. Para introducir música
-con más voces o con más pentragramas, lo que hacemos es combinar varias expresiones en
+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
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 del
-comando 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
}
@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 @ref{Music expressions explained}, los archivos de entrada para LilyPond
+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.
}
@end lilypond
-El comando @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 los
-comandos @code{\clef}). Para piezas sencillas, tales
+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.
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 afecta al resto, pero
-la armadura de la tonalidad de un pentagarma @emph{no} afecta a los otros
-pentagramas@footnote{Este comportamiento se puede cambiar si uno lo desea; consulte
-@ref{Changing defaults} para ver más detalles.}.
+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]
\relative c'' {
@end lilypond
+@node Staff groups
+@subsection Staff groups
+@cindex piano staff
+@cindex choir staff
+@cindex grand staff
-@node Piano staves
-@subsection Piano staves
+Glosario musical: @rglos{brace}.
-@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 @ref{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 <<
}
@end lilypond
-@moreinfo
-@quotation
-Ver @ref{Piano music}.
-@end quotation
+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
+
+Referencia de la notación: @ruser{Piano music},
+@ruser{Displaying staves}.
@node Combining notes into chords
@subsection Combining notes into chords
@cindex polifonía
@cindex varias voces
@cindex voces, más (en un solo pentagrama)
-Cuando distintas líenas melódicas se combinan sobre un solo pentagrama, se
+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.
>>
@end lilypond
-@moreinfo
+@seealso
@quotation
-Ver @ref{Basic polyphony}.
+Véase @ruser{Basic polyphony}.
@end quotation
@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
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
-@lilypond[quote,ragged-right,verbatim]
+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[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
-@moreinfo
-@quotation
-Otras posibilidades como poner varios versos debajo de una melodía, se
-discuten en @ref{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}).
-@node A lead sheet
-@subsection A lead sheet
+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:
-@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}.
-@moreinfo
-@quotation
-Puede ver una lista completa de los modificadores y otras opciones de presentación
-en @ref{Chords}.
-@end quotation
+@seealso
+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[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 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.
+
+@lilypond[verbatim,quote,ragged-right]
+tripletA = \times 2/3 { c,8 e g }
+barA = { \tripletA \tripletA \tripletA \tripletA }
+
+\relative c'' {
+ \barA \barA
+}
+@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.
-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
-@ref{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 @ruser{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 @ref{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]
{
}
@end lilypond
-Como puede ver, escribir una melodía en clave de Sol implica escibir 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]
{
}
@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]
\relative c'' {
}
@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 ambargo, 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.
-
+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.
-@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 un comando 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:
-
-@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 @ref{Templates} y añada algunas
+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
-@ref{Basic notation}. Si quiere escribir música para un conjunto
-instrumental que no está cubierto por ninguna plantilla,
-consulte @ref{Extending the templates}.
+@ruser{Basic 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
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 @ref{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
-@ref{About this manual}.
-
projects / lilypond.git / blobdiff