Doc-es: update CHANGES, programming-interface, scheme-tutorial, others.

[lilypond.git] / Documentation / es / learning / common-notation.itely

@c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-

@ignore
    Translation of GIT committish: e6513c72e95fd6691998cb368a5172de3aad0525

    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.17.25"

@ignore
Tutorial guidelines:  (different from policy.txt!)
- unless you have a really good reason, use either
    @lilypond[verbatim,quote]
  or
    @lilypond[verbatim,quote,relative=2]

  Don't use any other relative=X commands.

- 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 Notación corriente
@chapter Notación corriente
@translationof Common notation

Este capítulo explica cómo crear hermosas partituras que contengan
notación musical común, como continuación al material que está en el
@ref{Tutorial}.

@menu
* Notación en un solo pentagrama::
* Varias notas a la vez::
* Canciones::
* Retoques finales::
@end menu


@node Notación en un solo pentagrama
@section Notación en un solo pentagrama
@translationof Single staff notation

Esta sección presenta la notación común que se utiliza para música a
una voz sobre un pentagrama único.

@menu
* Comprobaciones de compás::
* Alteraciones accidentales y armaduras::
* Ligaduras de unión y de expresión::
* Articulaciones y matices dinámicos::
* Añadir texto::
* Barras automáticas y manuales::
* Instrucciones rítmicas avanzadas::
@end menu


@node Comprobaciones de compás
@subsection Comprobaciones de compás
@translationof Bar checks

Aunque no es estrictamente necesario, es coneniente utilizar
@emph{comprobaciones de compás} dentro del código de entrada para
indicar dónde se supone que van las líneas divisorias.  Se introducen
mediante el caráter de barra vertical, @code{|} (AltGr - 1 en el
teclado español).  Con las comprobaciones de compás, el programa puede
verificar que hemos introducido las duraciones que completan los
compases correctamente.  Las comprobaciones de compás también hacen
que el código de entrada sea más fácil de leer, porque ayudan a
organizar el material.

@lilypond[verbatim,quote,relative=2]
g1 | e1 | c2. c'4 | g4 c g e | c4 r r2 |
@end lilypond

@seealso
Referencia de la notación:
@ruser{Comprobación de compás y de número de compás}.


@node Alteraciones accidentales y armaduras
@subsection Alteraciones accidentales y armaduras
@translationof Accidentals and key signatures


@warning{Con frecuencia, los nuevos usuarios se encuentran confundidos
por las alteraciones accidentales: le rogamos que lea la advertencia
que aparece al final de esta sección, ¡especialmente si no está
familiarizado con la teoría musical!}

@subheading Alteraciones accidentales

@cindex accidentales, alteraciones
@cindex alteraciones
@cindex alteraciones y armaduras
@cindex sostenido
@cindex doble sostenido
@cindex sostenido, doble
@cindex bemol
@cindex doble bemol
@cindex bemol, doble

@funindex es
@funindex is
@funindex eses
@funindex isis

Glosario musical:
@rglos{sharp},
@rglos{flat},
@rglos{double sharp},
@rglos{double flat},
@rglos{accidental}.

Una nota con @notation{sostenido} se hace añadiendo @code{is} al
nombre, y una nota @notation{bemol} añadiendo @code{es}.  Como ha
podido adivinar, un @notation{doble sostenido} o @notation{doble
bemol} se hace añadiendo @code{isis} o @code{eses}.  Esta sintaxis se
deriva de las convenciones de nomenclatura de las notas en las lenguas
nórdicas y germánicas como el alemán y el holandés.  Para utilizar
otros nombres para las @notation{alteraciones accidentales}, véase
@ruser{Nombres de las notas en otros idiomas}.

@lilypond[verbatim,quote,relative=2]
cis4 ees fisis, aeses
@end lilypond

@cindex tonalidad, armadura de la, establecer
@subheading Armaduras

@cindex tonalidad, armadura de
@cindex armadura
@cindex mayor
@cindex menor
@cindex alteraciones y armadura
@cindex contenido frente a presentación
@cindex presentación frente a contenido

@funindex \key
@funindex key
@funindex \major
@funindex major
@funindex \minor
@funindex minor

Glosario musical:
@rglos{key signature},
@rglos{major},
@rglos{minor}.

La @notation{armadura de la tonalidad} se establece mediante la
instrucción @code{\key} seguido de una nota y @code{\major} o
@code{\minor}.

@lilypond[verbatim,quote,relative=2]
\key d \major
a1 |
\key c \minor
a1 |
@end lilypond

@smallspace

@subheading Advertencia: armaduras y alturas

Glosario musical:
@rglos{accidental},
@rglos{key signature},
@rglos{pitch},
@rglos{flat},
@rglos{natural},
@rglos{sharp},
@rglos{transposition},
@rglos{Pitch names}.

Para determinar si hay que imprimir una @notation{alteración
accidental}, LilyPond examina las notas y la @notation{armadura de la
tonalidad}.  La armadura solamente afecta a las alteraciones
@emph{impresas}, ¡no a las propias notas!  Esta funcionalidad suele
confundir a los que están empezando con el programa, por ello
permítanos explicarla en detalle.

LilyPond hace una clara distinción entre el contenido musical y la
presentación.  La alteración (@notation{bemol}, @notation{becuadro} o
@notation{sostenido}) de una nota es parte de la altura, y por tanto
es contenido musical.  Si una alteración (un signo @emph{impreso} de
bemol, becuadro o sostenido) se imprime o no delante de la nota
correspondiente, es una cuestión de presentación.  La presentación es
algo que sigue unas reglas, así que las alteraciones accidentales se
imprimen automáticamente según dichas reglas.  Las alturas de las
notas en su música son obras de arte, por tanto no se añadirán
automáticamente, y usted deberá introducir aquello que quiera oír.

En el siguiente ejemplo:

@lilypond[verbatim,quote,relative=2]
\key d \major
cis4 d e fis
@end lilypond

@noindent
Ninguna nota lleva una alteración impresa, pero de todas formas usted
debe escribir el @code{is} a @code{cis} y a @code{fis} en el archivoo
de entrada.

El texto @code{b} no significa @qq{imprimir una bolita negra en la
tercera línea del pentagrama.}  Más bien significa: @qq{hay una nota
Si natural.}  En la tonalidad de La bemol mayor, @emph{lleva} una
alteración accidental:

@lilypond[verbatim,quote,relative=2]
\key aes \major
aes4 c b c
@end lilypond

Si se encuentra confundido por lo anterior, piense en lo siguiente: si
estuvises tocando un piano, ¿qué tecla pulsaría?  Si se tratase de una
tecla negra, entonces ¡@emph{tiene que} añadir @w{@code{-is}} ó
@w{@code{-es}} al nombre de la nota!

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{Alteraciones accidentales automáticas} para ver ejemplos de
cómo se pueden imprimir las alteraciones de acuerdo a reglas
diferentes.


@seealso
Referencia de la notación:
@ruser{Nombres de las notas en otros idiomas},
@ruser{Alteraciones accidentales},
@ruser{Alteraciones accidentales automáticas},
@ruser{Armadura de la tonalidad}.


@node Ligaduras de unión y de expresión
@subsection Ligaduras de unión y de expresión
@translationof Ties and slurs

@cindex ligadura de unión
@cindex ligadura de expresión
@cindex ligadura de fraseo
@cindex fraseo, ligadura de

@funindex ~
@funindex ( ... )
@funindex \( ... \)

@subheading Ligaduras de unión

Glosario musical:
@rglos{tie}.

Una @notation{ligadura de unión} se crea adjuntando un carácter de
tilde curva @code{~} a la primera nota ligada:

@lilypond[verbatim,quote,relative=2]
g4~ g c2~ | c4~ c8 a~ a2 |
@end lilypond

@subheading Ligaduras de expresión

Glosario musical:
@rglos{slur}.

Una @notation{ligadura de expresión} es una curva que se traza
abarcando varias notas.  Las notas inicial y final se marcan mediante
@code{(} y @code{)} respectivamente.

@lilypond[verbatim,quote,relative=2]
d4( c16) cis( d e c cis d) e( d4)
@end lilypond

@subheading Ligaduras de fraseo

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,relative=2]
g4\( g8( a) b( c) b4\)
@end lilypond

@smallspace

@cindex ligaduras de expresión frente a ligaduras de unión
@subheading Advertencias: ligaduras de expresión frente a ligaduras de unión

Glosario musical:
@rglos{articulation},
@rglos{slur},
@rglos{tie}.

Una @notation{ligadura de expresión} parece una @notation{ligadura de
unión}, pero tiene un significado distinto.  Una ligadura (de unión)
sencillamente hace que la primera nota sea más larga, y sólo se puede
utilizar sobre parejas de notas iguales.  Las ligaduras de expresión
indican la @notation{articulación} de las notas, y se pueden utilizar
sobre grupos mayores de notas.  Las ligaduras de unión y de expresión
se pueden anidar unas dentro de otras.

@lilypond[verbatim,quote,relative=2]
c4~( c8 d~ d4 e)
@end lilypond


@seealso
Referencia de la notación:
@ruser{Ligaduras de unión},
@ruser{Ligaduras de expresión},
@ruser{Ligaduras de fraseo}.


@node Articulaciones y matices dinámicos
@subsection Articulaciones y matices dinámicos
@translationof Articulation and dynamics

@subheading Articulaciones

@cindex articulación
@cindex acento
@cindex staccato

Glosario musical:
@rglos{articulation}.

Las @notation{articulaciones} más corrientes se pueden añadir a las
notas utilizando un guión @code{-} seguido de un carácter único:

@lilypond[verbatim,quote,relative=2]
c4-^ c-+ c-- c-!
c4-> c-. c2-_
@end lilypond

@subheading Digitaciones

@cindex digitaciones

@funindex ^
@funindex _

Glosario musical:
@rglos{fingering}.

De manera similar, las @notation{digitaciones} se pueden añadir a una
nota utilizando un guión (@code{-}) seguido del dígito deseado:

@lilypond[verbatim,quote,relative=2]
c4-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,relative=2]
c4_-^1 d^. f^4_2-> e^-_+
@end lilypond

@subheading Matices dinámicos

@cindex dinámica, indicaciones de
@cindex matices
@cindex decrescendo
@cindex crescendo

@funindex \f
@funindex \ff
@funindex \mp
@funindex \p
@funindex \mf
@funindex \pp
@funindex \<
@funindex <
@funindex \>
@funindex >
@funindex \!
@funindex !

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,relative=2]
c4\ff c\mf c\p c\pp
@end lilypond

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,relative=2]
c4\< c\ff\> c c\!
@end lilypond


@seealso
Referencia de la notación:
@ruser{Articulaciones y ornamentos},
@ruser{Indicaciones de digitación},
@ruser{Matices dinámicos}.


@node Añadir texto
@subsection Añadir texto
@translationof Adding text

@cindex texto, añadir
@cindex añadir texto
@cindex marcado

@funindex \markup
@funindex markup

Es posible añadir texto a la partitura:

@lilypond[verbatim,quote,relative=2]
c2^"espr" a_"legato"
@end lilypond

Se puede aplicar un formateo adicional mediante la instrucción
@code{\markup}:

@lilypond[verbatim,quote,relative=2]
c2^\markup { \bold espr }
a2_\markup {
  \dynamic f \italic \small { 2nd } \hspace #0.1 \dynamic p
}
@end lilypond


@seealso
Referencia de la notación:
@ruser{Escritura del texto}.


@node Barras automáticas y manuales
@subsection Barras automáticas y manuales
@translationof Automatic and manual beams

@cindex barras de corchea
@cindex barrado
@cindex automáticas, barras
@cindex manuales, barras
@cindex barras automáticas
@cindex barras manuales

@funindex [ ... ]
@funindex [
@funindex ]
@funindex \autoBeamOff
@funindex autoBeamOff
@funindex \autoBeamOn
@funindex autoBeamOn

Glosario musical:
@rglos{beam}.

Todas las @notation{barras} de las figuras se dibujan automáticamente:

@lilypond[verbatim,quote,relative=2]
a8 ais d ees r d c16 b a8
@end lilypond

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,relative=2]
a8[ ais] d[ ees r d] c16 b a8
@end lilypond

Si quiere desactivar completamente el barrado automático o para una
sección extensa de música, utilice la instrucción @code{\autoBeamOff}
para apagarlo y @code{\autoBeamOn} para activarlo de nuevo.

@lilypond[verbatim,quote,relative=2]
\autoBeamOff
a8 c b4 d8. c16 b4 |
\autoBeamOn
a8 c b4 d8. c16 b4 |
@end lilypond


@seealso
Referencia de la notación:
@ruser{Barras automáticas},
@ruser{Barras manuales}.


@node Instrucciones rítmicas avanzadas
@subsection Instrucciones rítmicas avanzadas
@translationof Advanced rhythmic commands

@subheading Compás parcial

@cindex anacrusa
@cindex compás parcial

@funindex \partial
@funindex partial

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,relative=2]
\partial 8 f8 |
c2 d |
@end lilypond

@subheading Grupos especiales

@cindex grupos especiales
@cindex tresillos

@funindex \tuplet
@funindex tuplet

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

Los grupos especiales como los tresillos se hacen con la palabra
clave @code{\tuplet}.  Requiere dos argumentos: una fracción y un
fragmento de música.  La fracción es el número de notas del grupo
partido por el número de notas que normalmente ocupan la misma
duración.  Para los tresillos hay tres notas en el espacio de dos,
de manera que los @notation{tresillos} tienen una fracción de 3/2.

@lilypond[verbatim,quote,relative=2]
\tuplet 3/2 { f8 g a }
\tuplet 3/2 { c8 r c }
\tuplet 3/2 { f,8 g16[ a g a] }
\tuplet 3/2 { d4 a8 }
@end lilypond

@subheading Notas de adorno

@cindex notas de adorno
@cindex acciaccatura
@cindex appoggiatura

@funindex \grace
@funindex grace
@funindex \acciaccatura
@funindex acciaccatura
@funindex \appoggiatura
@funindex acciaccatura

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,relative=2]
c2 \grace { a32[ b] } c2 |
c2 \appoggiatura b16 c2 |
c2 \acciaccatura b16 c2 |
@end lilypond


@seealso
Referencia de la notación:
@ruser{Notas de adorno},
@ruser{Grupos especiales},
@ruser{Anacrusas}.


@node Varias notas a la vez
@section Varias notas a la vez
@translationof 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
* Explicación de las expresiones musicales::
* Varios pentagramas::
* Grupos de pentagramas::
* Combinar notas para formar acordes::
* Polifonía en un solo pentagrama::
@end menu


@node Explicación de las expresiones musicales
@subsection Explicación de las expresiones musicales
@translationof Music expressions explained

@cindex musical, expresión
@cindex expresión musical
@cindex compuesta, expresión musical
@cindex musical, expresión, compuesta

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,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[verbatim,quote,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,relative=2]
{ { a4 g } f4 g }
@end lilypond

@subheading Analogía: expresiones matemáticas

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 Expresiones musicales simultáneas: varios pentagramas

@cindex varios pentagramas
@cindex pentagramas, varios
@cindex polifonía
@cindex combinar expresiones en paralelo
@cindex paralelas, expresiones
@cindex expresiones paralelas
@cindex relativo, modo, música simultánea y
@cindex relativo, modo, expresiones paralelas y
@cindex simultánea, música, modo relativo y
@cindex paralelas, expresiones, modo relativo y

@funindex <<
@funindex >>
@funindex << ... >>

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]
\relative c'' {
  <<
    { a2 g }
    { f2 e }
    { d2 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, solamente la primera es relativa a la @code{c''} dentro de
la instrucción inicial @code{@bs{}\relative}.}


@subheading Expresiones musicales simultáneas: un solo pentagrama

Para determinar el número de pentagramas en una pieza, LilyPond
examina el comienzo de la primera expresión.  Si hay una sola nota,
hay un solo pentagrama; si hay una expresión simultánea, hay más de un
pentagrama.  El siguiente ejemplo presenta una expresión compleja,
pero dado que comienza con una sola nota, se dispone sobre un solo
pentagrama.

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

@node Varios pentagramas
@subsection Varios pentagramas
@translationof Multiple staves

@cindex varios pentagramas
@cindex pentagramas, varios
@cindex contexto
@cindex contexto de notación
@cindex notación, contexto de

@funindex \new Staff
@funindex new Staff
@funindex Staff
@funindex \new
@funindex new
@funindex Score
@funindex Voice
@funindex Lyrics
@funindex ChordNames

Como ya hemos visto en @ref{Explicación de las expresiones musicales},
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]
\relative c'' {
  <<
    \new Staff { \clef "treble" c4 }
    \new Staff { \clef "bass" c,,4 }
  >>
}
@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]
\relative c'' {
  <<
    \new Staff { \clef "treble" \key d \major \time 3/4 c4 }
    \new Staff { \clef "bass" c,,4 }
  >>
}
@end lilypond


@node Grupos de pentagramas
@subsection Grupos de pentagramas
@translationof Staff groups

@cindex sistema de piano
@cindex piano, sistema de
@cindex sistema de coro
@cindex coro, sistema de
@cindex grupo de pentagramas
@cindex pentagramas, grupo de

@funindex PianoStaff
@funindex GrandStaff
@funindex ChoirStaff

Glosario musical:
@rglos{brace},
@rglos{staff},
@rglos{system}.

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{Varios pentagramas}, 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]
\relative c'' {
  \new PianoStaff <<
    \new Staff { \time 2/4 c4 e | g g, | }
    \new Staff { \clef "bass" c,,4 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{Teclados y otros instrumentos de varios pentagramas},
@ruser{Impresión de los pentagramas}.


@node Combinar notas para formar acordes
@subsection Combinar notas para formar acordes
@translationof Combining notes into chords

Glosario musical:
@rglos{chord}.

@cindex acordes
@cindex duraciones de notas en acordes

@funindex <
@funindex >
@funindex < ... >

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,relative=2]
r4 <c e g> <c f a>2
@end lilypond

Debemos 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,relative=2]
r4 <c e g>~ <c f a>2 |
<c e g>8[ <c f a> <c e g> <c f a>]
  <c e g>8\>[ <c f a> <c f a> <c e g>]\! |
r4 <c e g>8.\p <c f a>16( <c e g>4-. <c f a>) |
@end lilypond

@seealso
Referencia de la notación:
@ruser{Notas en acorde}.


@node Polifonía en un solo pentagrama
@subsection Polifonía en un solo pentagrama
@translationof Single staff polyphony

@cindex polifonía
@cindex varias voces
@cindex voces, más, en un solo pentagrama
@cindex único, polifonía en pentagrama
@cindex separador, silencio
@cindex silencio separador

@funindex << ... \\ ... >>
@funindex <<
@funindex \\
@funindex >>

La música polifónica en LilyPond, aunque no es difícil, utiliza
conceptos que aún no hemos tratado, por lo que no vamos a presentarlos
en este momento.  En su lugar, las secciones siguientes presentan
estos conceptos y los explican en profundidad.

@seealso
Manual de aprendizaje:
@ref{Las voces contienen música}.

Referencia de la notación:
@ruser{Notas simultáneas}.


@node Canciones
@section Canciones
@translationof Songs

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

@menu
* Elaborar canciones sencillas::
* Alineación de la letra a una melodía::
* Letra en varios pentagramas::
@end menu


@node Elaborar canciones sencillas
@subsection Elaborar canciones sencillas
@translationof Setting simple songs

@cindex letra
@cindex canciones

@funindex \addlyrics
@funindex addlyrics

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]
\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]
<<
  \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 los
ángulos dobles @w{@code{<<@dots{}>>}} alrededor del fragmento entero
para expresar que la música y la letra han de suceder al mismo tiempo.

@node Alineación de la letra a una melodía
@subsection Alineación de la letra a una melodía
@translationof Aligning lyrics to a melody

@cindex melisma
@cindex línea de extensión
@cindex guión
@cindex guión bajo
@cindex letra, alineación de
@cindex alineación de la letra
@cindex letra, palabras polisílabas
@cindex palabras polisílabas en la letra

Glosario musical:
@rglos{melisma},
@rglos{extender line}.

La siguiente línea de la canción infantil es @notation{The moon doth
shine as bright as day}.  A continuación vamos a ampliarla:

@lilypond[verbatim,quote]
<<
  \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 compilamos el código del ejemplo anterior, veremos algunos mensajes
de advertencia sobre la consola:

@example
song.ly:12:29: warning: la comprobación de compás ha fallado en: 5/8
    The | moon doth shine as
                             | bright as day; |
song.ly:12:46: warning: la comprobación de compás ha fallado en: 3/8
    The | moon doth shine as | bright as day;
                                              |
@end example

Éste es un buen ejemplo de la utilidad de las comprobaciones de
compás.  Ahora, si miramos la música, 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{Ligaduras de unión y de expresión}):

@lilypond[verbatim,quote]
<<
  \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

Ahora la letra se alinea correctamente con las notas, pero el barrado
automático de las notas que corresponden a @notation{shine as} no
parece correcto.  Podemos remediarlo insertando instrucciones de
barrado manual para sobreescribir el barrado automático; para ver más
detalles consulte @ref{Barras automáticas y manuales}.

@lilypond[verbatim,quote]
<<
  \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

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]
<<
  \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 @notation{Lamento de Dido}, de @notation{Dido y Eneas} de Purcell:

@lilypond[verbatim,quote]
<<
  \relative c'' {
    \key g \minor
    \time 3/2
    g2 a bes | bes2( a) b2 |
    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,noragged-right]
<<
  \relative c' {
    \key g \major
    \time 3/4
    \partial 4
    d4 | g4 g a8( b) | g4 g b8( c) |
    d4 d e | 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 @notation{Barbero
de Sevilla} de Rossini, donde la sílaba @notation{al} se canta sobre
la misma nota que la sílaba @notation{go} de la palabra @q{Largo} en
el aria de Fígaro @notation{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,noragged-right]
<<
  \relative c' {
    \clef "bass"
    \key c \major
    \time 6/8
    c4.~ c8 d b | c8([ d]) b c d b | c8
  }
  \addlyrics {
    Lar -- go_al fac -- | to -- tum del -- la cit -- | tà
  }
>>
@end lilypond


@seealso
Referencia de la notación:
@ruser{Música vocal}.


@node Letra en varios pentagramas
@subsection Letra en varios pentagramas
@translationof Lyrics to multiple staves

@cindex letra y varios pentagramas
@cindex varios pentagramas y letra

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 @notation{Judas Macabeo} de Haendel:

@lilypond[verbatim,quote]
<<
  \relative c'' {
    \key f \major
    \time 6/8
    \partial 8
    c8 | c8([ bes]) a a([ g]) f | f'4. b, | c4.~ c4
  }
  \addlyrics {
    Let | flee -- cy flocks the | hills a -- | dorn, __
  }
  \relative c' {
    \key f \major
    \time 6/8
    \partial 8
    r8 | r4. r4 c8 | a'8([ g]) f f([ e]) d | e8([ d]) c bes'4
  }
  \addlyrics {
    Let | flee -- cy flocks the | hills a -- dorn,
  }
>>
@end lilypond


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{Organizar las piezas mediante variables}.


@seealso
Referencia de la notación:
@ruser{Música vocal}.


@node Retoques finales
@section Retoques finales
@translationof 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
* Organizar las piezas mediante variables::
* Añadir títulos::
* Nombres de nota absolutos::
* Más allá del tutorial::
@end menu


@node Organizar las piezas mediante variables
@subsection Organizar las piezas mediante variables
@translationof Organizing pieces with variables

@cindex variables
@cindex variables, definir
@cindex identificadores
@cindex macros
@cindex asignación de variables
@cindex uso de las variables
@cindex variables, uso de
@cindex variables, caracteres permitidos en
@cindex caracteres permitidos en 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]
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 = \tuplet 3/2 { 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 Añadir títulos
@subsection Añadir títulos
@translationof Adding titles

@cindex título
@cindex encabezamientos
@cindex bloque de encabezamientos

@funindex \header
@funindex header

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 número de versión.

@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{Crear títulos encabezamientos y pies de página}.


@node Nombres de nota absolutos
@subsection Nombres de nota absolutos
@translationof Absolute note names

@cindex notas, nombres de
@cindex notas, nombres absolutos de
@cindex absoluto, modo
@cindex absolutos, valores de altura
@cindex alturas, valores absolutos de
@cindex absolutos, nombres de nota

Hasta el momento siempre hemos utilizado @code{\relative} para definir
las alturas.  Ésta es normalmente la forma más rápida de escribir la mayor parte
de la música.  Sin @code{\relative}, las alturas se interpretan en modo absoluto.

En este modo, 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]
{
  \clef "bass"
  c'4 b g, g, |
  g,4 f, f c' |
}
@end lilypond

He aquí una escala que abarca cuatro octavas:

@lilypond[verbatim,quote]
{
  \clef "bass"
  c,4 d, e, f, |
  g,4 a, b, c |
  d4 e f g |
  a4 b c' d' |
  \clef "treble"
  e'4 f' g' a' |
  b'4 c'' d'' e'' |
  f''4 g'' a'' b'' |
  c'''1 |
}
@end lilypond

Como puede ver, escribir una melodía en clave de Sol implica escribir
gran cantidad de apóstrofos @q{'} .  Consideremos este fragmento de
Mozart:

@lilypond[verbatim,quote]
{
  \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óstrofos 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]
\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.  Cuando se copian y
pegan fragmentos melódicos, el modo absoluto preserva la octava
del material original.

A veces la música se dispone de formas más complejas.  Si está
usando @code{\relative} dentro de @code{\relative}, las secciones
relativas externa e interna son independientes:

@lilypond[verbatim,quote]
\relative c { c'4 \relative c'' { f g } c }
@end lilypond

@funindex \absolute
Si está usando música absoluta dentro de un bloque de música
relativa, tendrá que marcar la música absoluta explícitamente con
la instrucción @code{\absolute} para evitar que se incorpore a la
música relativa:

@lilypond[verbatim,quote]
\relative c { c'4 \absolute { f'' g'' } c }
@end lilypond

@node Más allá del tutorial
@subsection Más allá del tutorial
@translationof 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 que aparecen en
@ref{Plantillas} 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{Notación musical}.  Si
quiere escribir música para un conjunto instrumental que no está
cubierto por ninguna plantilla, consulte @ref{Extender las
plantillas}.

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.

En este tutorial y en el resto del Manual de aprendizaje, existe un
apartado @strong{Véase también} al final de cada una de las secciones,
que contiene referencias cruzadas a otras secciones: no siga estas
referencias durante la primera lectura; cuando haya leído el Manual de
aprendizaje completo, quizá desee releer ciertas secciones y seguir
las referencias cruzadas para obtener más información.

Si no lo ha hecho aún, le @emph{rogamos} que lea @ref{Panorámica de
los manuales}.  Existe una gran cantidad de información sobre
LilyPond, de manera que los recién llegados con frecuencia no saben
exactamente dónde deben buscar la ayuda.  Si emplea cinco minutos en
leer cuidadosamente esta sección ¡se ahorrará horas de frustración
buscando en el sitio equivocado!