Issue 4894: Remove unescaped @funindex entries

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

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

@ignore
    Translation of GIT committish: 42cd2e57e37cbbf1fc5ccbe2bc83048761690f60

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

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

- 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
* Líneas divisorias y comprobaciones de compás::
* Alturas 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 Líneas divisorias y comprobaciones de compás
@subsection Líneas divisorias y comprobaciones de compás
@translationof Bar lines and bar checks

@menu
* Líneas divisorias::
* Comprobaciones de compás::
@end menu

@node Líneas divisorias
@unnumberedsubsubsec Líneas divisorias
@translationof Bar lines

Las líneas de compás sencillas se dibujan automáticamente en la
música, por lo que no hay que añadirlas de forma manual.  Otros
tipos de barras de compás se añaden usando @code{\bar}, por
ejemplo @code{\bar "||"} para una doble barra, o @code{\bar "|."}
para la doble barra final.  Para ver una lista completa de las
líneas divisorias, consulte @ruser{Barras de compás}.

@lilypond[verbatim,quote]
\relative { g'1 e1 \bar "||" c2. c'4 \bar "|." }
@end lilypond

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

Aunque no es estrictamente necesario, es conveniente 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ácter 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.

@c This example deliberately produces a warning
@lilypond[verbatim,quote]
\relative {
  g'1 | e1 | c2. c' | g4 c g e | c4 r r2 |
}
@end lilypond

Si compila el código del ejemplo anterior, verá una advertencia en
la salida de la consola:

@example
advertencia: la comprobación de compás ha fallado en: 1/2
 g'1 | e1 | c2. c'
                   | g4 c g e | c4 r r2 |
@end example

Aunque la duración que falta está clara en la salida musical de
este ejemplo sencillo, la advertencia de la salida de consola es
mucho más efectiva al atraer la atención concretamente al @code{4}
que falta en el compás 3.

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


@node Alturas y armaduras
@subsection Alturas y armaduras
@translationof Pitches and key signatures

@menu
* Alteraciones accidentales::
* Armaduras::
* Advertencia armaduras y alturas::
@end menu

@warning{Con frecuencia, a los nuevos usuarios les cuesta
comprender cómo usa LilyPond la armadura: le rogamos que lea la
advertencia que aparece al final de esta sección.}

@node Alteraciones accidentales
@unnumberedsubsubsec Alteraciones accidentales
@translationof Pitch alterations

@cindex accidentales, alteraciones
@cindex becuadro
@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}.

En LilyPond, los nombres de las notas identifican alturas. Por
ejemplo, @code{c} siempre significa Do natural, cualquiera que sea
la armadura.

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 { cis''4 ees fisis, aeses }
@end lilypond

@cindex tonalidad, armadura de la, establecer

@node Armaduras
@unnumberedsubsubsec Armaduras
@translationof Key signatures

@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 \major
@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 {
  \key d \major
  d'4 fis a c |
  \bar "||" \key c \minor
  c,4 ees g b |
}
@end lilypond

@smallspace

@node Advertencia armaduras y alturas
@unnumberedsubsubsec Advertencia: armaduras y alturas
@translationof Warning key signatures and pitches

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

LilyPond distingue entre el contenido musical y su representación
impresa.  Una entrada como @code{d4 e fis2} define las alturas y
duraciones de las notas, lo que es el contenido musical.  La
@notation{armadura} forma parte de la representación impresa.  La
armadura también establece reglas para las representaciones
impresas de las notas.  LilyPond compara la altura de cada nota de
la entrada con la armadura para determinar si imprimir, o no, una
alteración @notation{accidental}.

La instrucción @code{\key} fija la @notation{armadura}, que afecta
a la representación impresa, pero @emph{no} modifica la altura
asignada a una nota cualquiera como @code{c} a partir de la
entrada.

En el siguiente ejemplo:

@lilypond[verbatim,quote]
\relative {
  \key d \major
  cis''4 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
archivo 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 {
  \key aes \major
  aes'4 c b c
}
@end lilypond

Cada vez que escriba una nota correspondiente a una tecla negra
del piano, @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 \( ... \)

@menu
* Ligaduras de unión::
* Ligaduras de expresión::
* Ligaduras de fraseo::
* Advertencias ligaduras de expresión frente a ligaduras de unión::
@end menu

@node Ligaduras de unión
@unnumberedsubsubsec Ligaduras de unión
@translationof Ties

Glosario musical:
@rglos{tie}.

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

@lilypond[verbatim,quote]
\relative { g'4~ g c2~ | c4~ c8 a~ a2 | }
@end lilypond

@cindex duración aislada
@cindex aislada, duración

Cuando la altura no cambia, como es el caso cada vez que hay una
ligadura de unión, las alturas que siguen se pueden omitir, y
especificar tan solo las duraciones:

@lilypond[verbatim,quote]
\relative { g'4~ 4 c2~ | 4~ 8 a~ 2 | }
@end lilypond

Esta abreviatura puede ser de utilidad en otros lugares donde las
duraciones cambian pero la altura se mantiene fija; sin embargo,
recuerde que una altura aislada seguida de un espacio y de una
duración aislada se interpreta como una sola nota.  En otras
palabras, @code{c4 a 8 8} se interpreta como @code{c4 a8 a8}, no
como @code{c4 a4 a8 a8}.  En vez de ello, escriba @code{c4 a4 8 8
}.

@node Ligaduras de expresión
@unnumberedsubsubsec Ligaduras de expresión
@translationof Slurs

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 { d''4( c16) cis( d e c cis d) e( d4) }
@end lilypond

@node Ligaduras de fraseo
@unnumberedsubsubsec Ligaduras de fraseo
@translationof 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.

@lilypond[verbatim,quote]
\relative { g'4\( g8( a) b( c) b4\) }
@end lilypond

@smallspace

@cindex ligaduras de expresión frente a ligaduras de unión

@node Advertencias ligaduras de expresión frente a ligaduras de unión
@unnumberedsubsubsec Advertencias: ligaduras de expresión frente a ligaduras de unión
@translationof 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]
\relative { c''4(~ c8 d~ 4 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

@menu
* Articulaciones::
* Indicaciones de digitación::
* Matices dinámicos::
@end menu

@node Articulaciones
@unnumberedsubsubsec Articulaciones
@translationof Articulations

@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 {
  c''4-^ c-+ c-- c-!
  c4-> c-. c2-_
}
@end lilypond

@node Indicaciones de digitación
@unnumberedsubsubsec Indicaciones de digitación
@translationof Fingerings

@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 { c''4-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 { c''4_-^1 d^. f^4_2-> e^-_+ }
@end lilypond

@node Matices dinámicos
@unnumberedsubsubsec Matices dinámicos
@translationof Dynamics

@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 \!

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 { c''4\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 { c''4\< 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

Es posible añadir texto a la partitura:

@lilypond[verbatim,quote,fragment]
c''2^"espr" a'_"legato"
@end lilypond

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

@lilypond[verbatim,quote,fragment]
c''2^\markup { \bold espr }
a'2_\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 \autoBeamOn

Glosario musical:
@rglos{beam}.

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

@lilypond[verbatim,quote]
\relative { a'8 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 { a'8[ 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 {
  \autoBeamOff
  a'8 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

@menu
* Compás parcial::
* Grupos especiales::
* Notas de adorno::
@end menu

@node Compás parcial
@unnumberedsubsubsec Compás parcial
@translationof Partial measure

@cindex anacrusa
@cindex compás parcial

@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 {
  \partial 8 f''8 |
  c2 d |
}
@end lilypond

@node Grupos especiales
@unnumberedsubsubsec Grupos especiales
@translationof Tuplets

@cindex grupos especiales
@cindex tresillos

@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 {
  \tuplet 3/2 { f''8 g a }
  \tuplet 3/2 { c8 r c }
  \tuplet 3/2 { f,8 g16[ a g a] }
  \tuplet 3/2 { d4 a8 }
}
@end lilypond

@node Notas de adorno
@unnumberedsubsubsec Notas de adorno
@translationof Grace notes

@cindex notas de adorno
@cindex acciaccatura
@cindex appoggiatura

@funindex \grace
@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 {
  c''2 \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

@menu
* Analogía expresiones matemáticas::
* Expresiones musicales simultáneas varios pentagramas::
* Expresiones musicales simultáneas un solo pentagrama::
@end menu

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,fragment]
a'4
@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 { a'4 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 { { a'4 g } f4 g }
@end lilypond

@node Analogía expresiones matemáticas
@unnumberedsubsubsec Analogía: expresiones matemáticas
@translationof 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.


@node Expresiones musicales simultáneas varios pentagramas
@unnumberedsubsubsec Expresiones musicales simultáneas: varios pentagramas
@translationof Simultaneous music expressions multiple staves

@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 { a'2 g }
  \relative { f'2 e }
  \relative { d'2 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}.}


@node Expresiones musicales simultáneas un solo pentagrama
@unnumberedsubsubsec Expresiones musicales simultáneas: un solo pentagrama
@translationof Simultaneous music expressions single staff

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''2 <<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 Staff
@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]
<<
  \new Staff { \clef "treble" c''4 }
  \new Staff { \clef "bass" c4 }
>>
@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]
<<
  \new Staff { \clef "treble" \key d \major \time 3/4 c''4 }
  \new Staff { \clef "bass" c4 }
>>
@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]
\new PianoStaff <<
  \new Staff \relative { \time 2/4 c''4 e | g g, | }
  \new Staff \relative { \clef "bass" c4 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 { 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 {
  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

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 {
  \key g \major
  \time 6/8
  d''4 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 {
    \key g \major
    \time 6/8
    d''4 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 {
    \key g \major
    \time 6/8
    d''4 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 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 {
    \key g \major
    \time 6/8
    d''4 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 {
    \key g \major
    \time 6/8
    d''4 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 {
    \key g \major
    \time 6/8
    d''4 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 {
    \key g \minor
    \time 3/2
    g'2 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 {
    \key g \major
    \time 3/4
    \partial 4
    d'4 | 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 {
    \clef "bass"
    \key c \major
    \time 6/8
    c'4.~ 8 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 {
    \key f \major
    \time 6/8
    \partial 8
    c''8 | c8([ bes]) a a([ g]) f | f'4. b, | c4.~ 4
  }
  \addlyrics {
    Let flee -- cy flocks the hills a -- dorn, __
  }
  \relative {
    \key f \major
    \time 6/8
    \partial 8
    r8 | r4. r4 c'8 | 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 {
    a'4 b c b
  }
}

cello = \new Staff {
  \relative {
    \clef "bass"
    e2 d
  }
}

{
  <<
    \violin
    \cello
  >>
}
@end lilypond

@noindent
Por convención, los nombres de variable consisten enteramente en
caracteres alfabéticos.

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]
tresilloA = \relative { \tuplet 3/2 { c'8 e g } }
compasA = { \tresilloA \tresilloA \tresilloA \tresilloA }

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

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 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@tie{}central,
una @code{b} significará siempre la nota inmediatamente por debajo
del Do@tie{}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

La escritura de una melodía en clave de Sol implica un gran número
de apóstrofos (@code{'}).  Considere 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

@funindex \fixed
Las marcas de octava que son comunes se pueden indicar una sola
vez, utilizando la instrucción @code{\fixed} seguida de una altura
de referencia:

@lilypond[verbatim,quote]
\fixed c'' {
  \key a \major
  \time 6/8
  cis8. d16 cis8 e4 e8 |
  b,8. cis16 b,8 d4 d8 |
}
@end lilypond

Con @code{\relative}, el ejemplo anterior no requiere marcas de
cambio de octava porque esta melodía se mueve por intervalos no
mayores de una cuarta, o tres posiciones dentro del pentagrama:

@lilypond[verbatim,quote]
\relative {
  \key a \major
  \time 6/8
  cis''8. 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'4 \relative { f'' g } c }
@end lilypond

Para usar el modo absoluto dentro de @code{\relative}, ponga la
música absoluta dentro de @code{\fixed c @{ @dots{} @}} y las
notas absolutas no afectarán a las octavas de la música relativa:

@lilypond[verbatim,quote]
\relative {
  c'4 \fixed c { f'' g'' } c |
  c4 \fixed c'' { 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!