Merge branch 'master' of ssh://kainhofer@git.sv.gnu.org/srv/git/lilypond into dev...

[lilypond.git] / Documentation / es / user / tutorial.itely

@c -*- coding: utf-8; mode: texinfo; -*-
@c This file is part of lilypond.tely
@ignore
    Translation of GIT committish: 1599b9171f39a1000e38104deae93e9df08276be

    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:  (different from policy.txt!)
- unless you have a really good reason, use either
    @lilypond[verbatim,quote,ragged-right]
  or
    @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 "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.

@end ignore


@node Tutorial
@chapter Tutorial

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.


@menu
* First steps::                 
* Single staff notation::       
* Multiple notes at once::      
* Songs::                       
* Final touches::               
@end menu


@node First steps
@section First steps

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 manual::      
@end menu


@node Compiling a file
@subsection Compiling a file

@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
@{
  c' e' g' e'
@}
@end example

@noindent
el resultado tiene este aspecto:

@c  in this case we don't want verbatim
@lilypond[quote,ragged-right]
{
  c' e' g' e'
}
@end lilypond

@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.

@smallspace

@subheading Entering music and viewing output

@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.


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 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 example

Para procesar el archivo @file{prueba.ly} haga lo siguiente:

@example
lilypond prueba.ly
@end example

@noindent
Verá algo parecido a:

@example
lilypond prueba.ly
GNU LilyPond 2.12.0
Procesando `prueba.ly'
Analizando...
Interpretando la música...
Preprocesando los objetos gráficos...
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


@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[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.


@subheading Pitches

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 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[verbatim,quote,ragged-right]
\relative c' {
  d f a g
  c b f d
}
@end lilypond

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.

Añadiendo (o eliminando) comillas simples @code{'} o comas @code{,} de
la instrucción @code{\relative c' @{}, podemos cambiar la octava de
inicio:

@c KEEP LY
@lilypond[verbatim,quote,ragged-right]
\relative c'' {  % Una octava por encima del Do central
  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.

@c KEEP LY
@lilypond[verbatim,quote,ragged-right]
\relative c'' {
  b c  % el Do está un espacio por encima: es el Do agudo
  b d  % el Re está 2 por encima ó 5 por debajo: es el Re agudo
  b e  % el Mi está 3 por encima ó 4 por debajo: es el Mi agudo
  b a  % el La está 6 por arriba ó 1 por debajo: es el La grave
  b g  % el Sol está 5 por encima ó 2 por debajo: es el Sol grave
  b f  % el Fa está 4 por encima ó 3 por debajo: es el Fa grave
}
@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.

@subheading Durations (rhythms)

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[verbatim,quote,ragged-right]
\relative c'' {
  a1
  a2 a4 a8 a
  a16 a a a a32 a a a a64 a a a a a a a a2
}
@end lilypond

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[verbatim,quote,ragged-right]
\relative c'' {
  a a a4. a8
  a8. a16 a a8. a8 a4.
}
@end lilypond


@subheading Rests

Glosario musical: @rglos{rest}.

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
}
@end lilypond


@subheading Time signature

Glosario musical: @rglos{time signature}.

La @notation{indicación de compás} se puede establecer con la orden
@code{\time} :

@lilypond[verbatim,quote,ragged-right]
\relative c'' {
  \time 3/4
  a4 a a
  \time 6/8
  a4. a
  \time 4/4
  a4 a a a
}
@end lilypond


@subheading Clef

Glosario musical: @rglos{clef}.

La @notation{clave} se puede establecer utilizando la orden
@code{\clef} :

@lilypond[verbatim,quote,ragged-right]
\relative c' {
  \clef treble
  c1
  \clef alto
  c1
  \clef tenor
  c1
  \clef bass
  c1
}
@end lilypond


@subheading All together

He aquí un pequeño ejemplo que muestra todos los elementos anteriores
juntos:

@lilypond[verbatim,quote,ragged-right]
\relative c, {
  \time 3/4
  \clef bass
  c2 e8 c' g'2.
  f4 e d c4 c, r4
}
@end lilypond


@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{%@{ ... %@}}.

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.

@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

@example
@{ 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:

@example
@{
  c d e
@}
@end example

@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
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 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.  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 aparecen más abajo
    se ignoran, por estar dentro de un
    comentario de bloque.

    g g f f e e d d c2
%@}
@end example

@end itemize


@node How to read the manual
@subsection How to read the manual

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 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:

@example
\relative c'' @{
  ... aquí va el ejemplo...
@}
@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}!); 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
@c KEEP LY
@lilypond[quote,ragged-right]
\relative c'' {
  c-\markup { \bold \huge { Haga clic aquí.  } }
}
@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
@section Single staff notation

Esta sección es una introducción a la notación corriente que se utiliza para una voz
o un pentagrama.

@menu
* Accidentals and key signatures::  
* Ties and slurs::              
* Articulation and dynamics::   
* Adding text::                 
* Automatic and manual beams::  
* Advanced rhythmic commands::  
@end menu


@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[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}.

@lilypond[verbatim,quote,ragged-right,fragment,relative=2]
\key d \major
a1
\key c \minor
a
@end lilypond

@sp 1

@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.

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[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}.

El texto @samp{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[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
@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

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
@subsection Ties and slurs

@cindex ligaduras de unión
@subheading Ties

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~
c4 ~ c8 a8 ~ a2
@end lilypond

@cindex ligaduras de expresión
@subheading Slurs

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)
@end lilypond

@cindex fraseo, ligaduras de
@cindex ligaduras de fraseo
@subheading Phrasing slurs

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[verbatim,quote,ragged-right,fragment,relative=2]
a8(\( ais b c) cis2 b'2 a4 cis,\)
@end lilypond

@smallspace

@cindex ligaduras de expresión frente a ligaduras de unión
@subheading Warnings: slurs vs. ties

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[verbatim,quote,ragged-right,fragment,relative=2]
c2~( c8 fis fis4 ~ fis2 g2)
@end lilypond

@seealso

Referencia de la notación:
@ruser{Ties},
@ruser{Slurs},
@ruser{Phrasing slurs}.


@node Articulation and dynamics
@subsection Articulation and dynamics

@cindex articulación
@cindex acentos
@cindex staccato
@subheading Articulations

Glosario musical:
@rglos{articulation}.

Las @notation{articulaciones} más corrientes se pueden añadir a las
notas utilizando un guión @samp{-} 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

Glosario musical:
@rglos{fingering}.

De manera similar, las indicaciones de digitación 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 @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[verbatim,quote,ragged-right,fragment,relative=2]
c_-^1 d^. f^4_2-> e^-_+
@end lilypond

@subheading Dynamics

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

@cindex expresiones dinámicas
@cindex decrescendo
@cindex crescendo

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[verbatim,quote,ragged-right,fragment,relative=2]
c2\< c2\ff\> c2 c2\!
@end lilypond

@seealso

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 @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 @code{[} y la última
con @code{]}.

@lilypond[verbatim,quote,ragged-right,fragment,relative=2]
a8[ ais] d[ ees r d] a b
@end lilypond

@seealso

Referencia de la notación:
@ruser{Automatic beams},
@ruser{Manual beams}.


@node Advanced rhythmic commands
@subsection Advanced rhythmic commands

@cindex anacrusa
@cindex compás parcial
@subheading Partial measure

Glosario musical:
@rglos{anacrusis}.

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

@cindex grupos especiales
@cindex tresillos
@subheading Tuplets

Glosario musical:
@rglos{note value},
@rglos{triplet}.

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] }
\times 2/3 { d4 a8 }
@end lilypond

@cindex notas de adorno
@cindex acciaccatura
@cindex appoggiatura
@subheading Grace notes

Glosario musical:
@rglos{grace notes},
@rglos{acciaccatura},
@rglos{appoggiatura}.

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

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.

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::             
* Staff groups::                
* Combining notes into chords::  
* Single staff polyphony::      
@end menu


@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:

@lilypond[verbatim,quote,ragged-right,fragment,relative=2]
a4
@end lilypond

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:

@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

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[verbatim,quote,ragged-right]
\relative c'' {
  <<
    { a4 g }
    { f e }
    { d b }
  >>
}
@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
hace mucho más fácil de leer por nosotros los seres humanos.

@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.

@lilypond[verbatim,quote,ragged-right]
\relative c'' {
  c2 <<c e>>
  << { e f } { c <<b d>> } >>
}
@end lilypond

@node Multiple staves
@subsection Multiple staves

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{>>}:

@lilypond[verbatim,quote,ragged-right]
\relative c'' {
  <<
    \new Staff { \clef treble c }
    \new Staff { \clef bass c,, }
  >>
}
@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, 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 \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}.

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 <<
  \new Staff @dots{}
  \new Staff @dots{}
>>
@end example

He aquí un pequeño ejemplo:

@lilypond[verbatim,quote,ragged-right]
\relative c'' {
  \new PianoStaff <<
    \new Staff { \time 2/4 c4 e g g, }
    \new Staff { \clef bass c,, c' e c }
  >>
}
@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

Referencia de la notación:
@ruser{Keyboard instruments},
@ruser{Displaying staves}.


@node Combining notes into chords
@subsection Combining notes into chords

@cindex acordes

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 <c e g>4 <c f a>2
@end lilypond

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[verbatim,quote,ragged-right,fragment,relative=2]
r4 <c e g>8[ <c f a>]~ <c f a>2
r4 <c e g>8( <c e g>\> <c e g>4 <c f a>\!)
@end lilypond


@node Single staff polyphony
@subsection Single staff polyphony

@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{\\}

@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
(@code{s}) en vez de un silencio normal (@code{r}):

@lilypond[verbatim,quote,ragged-right,fragment,relative=2]
<<
  { a4 g2 f4~ f4 } \\
  { s4 g4 f2 f4 }
>>
@end lilypond

@noindent
Una vez más, las expresiones de este tipo se pueden anidar de forma arbitraria.

@lilypond[verbatim,quote,ragged-right,fragment,relative=2]
<<
  \new Staff <<
    { a4 g2 f4~ f4 } \\
    { s4 g4 f2 f4 }
  >>
  \new Staff <<
    \clef bass
    { <c g>1 ~ <c g>4 } \\
    { e,,4 d e2 ~ e4}
  >>
>>
@end lilypond

@seealso

Referencia de la notación: @ruser{Simultaneous notes}.


@node Songs
@section Songs

En esta sección presentamos cómo elaborar música vocal y hojas de
canción sencillas.

@menu
* Setting simple songs::        
* Aligning lyrics to a melody::  
* Lyrics to multiple staves::   
@end menu


@node Setting simple songs
@subsection Setting simple songs

@cindex letra
@cindex canciones

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'' {
  \key g \major
  \time 6/8
  d4 b8 c4 a8 d4 b8 g4
}
@end lilypond

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[verbatim,quote,ragged-right]
<<
  \relative c'' {
    \key g \major
    \time 6/8
    d4 b8 c4 a8 d4 b8 g4
  }
  \addlyrics {
    Girls and boys come out to play,
  }
>>
@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
@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[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

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}):

@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

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:

@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

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[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

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

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


@seealso

Referencia de la notación:
@ruser{Vocal music}.



@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]
<<
  {
    \time 6/8
    \partial 8
  }
  \relative c'' {
    \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,
  }
>>
@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

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
del manual.

@menu
* Organizing pieces with variables::  
* Version number::              
* Adding titles::               
* Absolute note names::         
* After the tutorial::          
@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:

@example
\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}, 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}.

@example
\version @w{"@version{}"}
\header @{
  title = "Sinfonía"
  composer = "Yo"
  opus = "Op. 9"
@}

@{
  @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}.


@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.

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.

@lilypond[verbatim,quote,ragged-right]
{
  \clef bass
  c' b g, g,
  g, f, f c'
}
@end lilypond

He aquí una escala que abarca cuatro octavas:

@lilypond[quote,verbatim,ragged-right]
{
  \clef bass
  c, d, e, f,
  g, a, b, c
  d e f g
  a b c' d'
  \clef treble
  e' f' g' a'
  b' c'' d'' e''
  f'' g'' a'' b''
  c'''1
}
@end lilypond

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[verbatim,quote,ragged-right]
{
  \key a \major
  \time 6/8
  cis''8. d''16 cis''8 e''4 e''8
  b'8. cis''16 b'8 d''4 d''8
}
@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:

@lilypond[verbatim,quote,ragged-right]
\relative c'' {
  \key a \major
  \time 6/8
  cis8. d16 cis8 e4 e8
  b8. cis16 b8 d4 d8
}
@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 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 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.