@c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
@c This file is part of lilypond.tely
@ignore
    Translation of GIT committish: 2607a3536733d8d4a1e74176027a5cb01d4e776a

    When revising a translation, copy the HEAD committish of the
    version that you are working on.  See TRANSLATION for details.
@end ignore


@node Chords Blah
@section Chords Blah

Intro text.

@menu 
* TODO chords fix::
@end menu 


@node TODO chords fix
@subsection TODO chords fix

@menu
* Introducing chord names::     
* Chords mode::                 
* Printing chord names::        
@end menu


@c  awkward name; awkward section name.
@c  still, the Basic "chords" seems like a good name...  :(
@node Introducing chord names
@subsubsection Introducing chord names
@cindex acordes, nombres

LilyPond tiene la capacidad de imprimir nombres de acordes.  Los acordes se pueden introducir
en notación musical de acordes, es decir: @code{< .. >}, pero también se pueden
introducir por su nombre.  Internamente los acordes se representan como un conjunto de
notas, así que se pueden transportar


@lilypond[quote,ragged-right,verbatim,ragged-right]
twoWays = \transpose c c' {
  \chordmode {
    c1 f:sus4 bes/f
  }
  <c e g>
  <f bes c'>
  <f bes d'>
}

<< \new ChordNames \twoWays
   \new Voice \twoWays >>
@end lilypond

Este ejemplo también muestra que las rutinas de impresión de acordes no tratan de
ser inteligentes.  El último acorde (@code{f bes d}) no se interpreta como
una inversión.

Tenga en cuenta que la duración de los acordes se debe especificar fuera de los
@code{<>}.

@example
<c e g>2
@end example


@node Chords mode
@subsubsection Chords mode
@cindex Acordes, modo de

En el modo de acordes, se introducen conjuntos de notas o acordes con sus nombres usuales.
Un acorde se introduce por su fundamental, que se escribe como una
nota normal

@lilypond[quote,ragged-right,fragment,verbatim]
\chordmode { es4. d8 c2 }
@end lilypond

@noindent
El modo se inicia mediante la palabra clave @code{\chordmode}.

@cindex acordes, introducción
@cindex acordes, modo de

Otros acordes se pueden escribir añadiendo al final dos puntos e introduciendo un
modificador (que puede incluir un número si se desea)

@lilypond[quote,fragment,verbatim]
\chordmode { e1:m e1:7 e1:m7 }
@end lilypond

El primer número que sigue a la fundamental se toma como el @q{tipo} de
acorde, las terceras se añaden a la fundamental hasta que se alcanza el número
especificado. La excepción es @code{c:13}, para el que se omite el 11.

@lilypond[quote,fragment,verbatim]
\chordmode { c:3 c:5 c:6 c:7 c:8 c:9 c:10 c:11 c:13 }
@end lilypond

@cindex fundamental de un acorde
@cindex adiciones, en acordes
@cindex omisiones, en acordes

También se pueden construir acordes más complejos añadiendo elementos separados
a un acorde.  Las adiciones se escriben después del número que sigue
a los dos puntos y van separadas por puntos

@lilypond[quote,verbatim,fragment]
\chordmode { c:5.6 c:3.7.8 c:3.6.13 }
@end lilypond

Los elementos de un acorde se pueden alterar añadiendo un signo de @code{-} ó @code{+}
al número

@lilypond[quote,verbatim,fragment]
\chordmode { c:7+ c:5+.3- c:3-.5-.7- }
@end lilypond

Las omisiones se especifican de forma similar y se escriben mediante un circunflejo.  Deben
ir después de las adiciones

@lilypond[quote,verbatim,fragment]
\chordmode { c^3 c:7^5 c:9^3.5 }
@end lilypond

Se pueden usar modificadores para cambiar la altura de las notas.  Están previstos los siguientes
modificadores

@table @code
@item m
El acorde menor.  Este modificador baja la tercera y (si está presente) la séptima.

@item dim
El acorde disminuido.  Este modificador baja la tercera, la quinta y (si está presente)
la séptima.

@item aug
El acorde aumentado.  Este modificador eleva la quinta.

@item maj
El acorde de séptima mayor.  Este modificador eleva la séptima si está presente.

@item sus
El acorde suspendido de cuarta o de segunda.  Este modificador suprime la tercera.
Escriba @code{2} ó @code{4} para añadir la segunda o la cuarta al
acorde.
@end table

Se pueden mezclar modificadores con adiciones
@lilypond[quote,verbatim,fragment]
  \chordmode { c:sus4 c:7sus4 c:dim7 c:m6 }
@end lilypond

@cindex modificadores, en acordes
@funindex aug
@funindex dim
@funindex maj
@funindex sus
@funindex m

Puesto que una 11ª sin alterar no suena bien cuando se combina con una
13ª sin alterar, la 11ª se suprime en este caso (a no ser que se añada de forma
explícita)
@lilypond[quote,ragged-right,fragment,verbatim]
\chordmode { c:13 c:13.11 c:m13 }
@end lilypond

@funindex /

Se puede especificar una inversión (colocar en el bajo una nota del acorde), así como
notas del bajo, añadiendo
@code{/}@var{pitch} al acorde
@lilypond[quote,ragged-right,fragment,verbatim]
\chordmode { c1 c/g c/f }
@end lilypond
@funindex /+

Un bajo se puede añadir en lugar de moverlo dentro del mismo acorde,
mediante @code{/+}@var{pitch}.

@lilypond[quote,ragged-right,fragment,verbatim]
\chordmode { c1 c/+g c/+f }
@end lilypond

El modo de acordes es similar a @code{\lyricmode} y demás.  La mayoría de
los comandos siguen funcionando, por ejemplo se pueden usar @code{r} y
@code{\skip} para insertar silencios y espacios, y las instrucciones
de propiedades se pueden usar para modificar ciertos valores.



@knownissues

Cada nota sólo se puede presentar una vez dentro del acorde.  Lo siguiente
simplemente produce el acorde aumentado, ya que el @code{5+} se interpreta en
último lugar
@cindex racimos (clusters)
@lilypond[quote,ragged-right,verbatim,fragment]
\chordmode { c:5.5-.5+ }
@end lilypond


@node Printing chord names
@subsubsection Printing chord names

@cindex impresión de los nombres de acorde
@cindex acordes, nombres de
@cindex acordes

Para la presentación de los nombres de acordes impresos utilice el contexto @internalsref{ChordNames}.
Los acordes se puede introducir o bien usando la notación
descrita anteriormente, o directamente usando @code{<} y @code{>}

@lilypond[quote,verbatim,ragged-right]
harmonies = {
  \chordmode {a1 b c} <d' f' a'> <e' g' b'>
}
<<
  \new ChordNames \harmonies
  \new Staff \harmonies
>>
@end lilypond

Puede hacer que los cambios de acorde se hagan notar, estableciendo
@internalsref{ChordNames}.@code{chordChanges} al valor verdadero.  Esto sólo 
mostrará los nombres de los acordes cuando ocurra un cambio en la estructura de acordes y al comienzo
de una línea

@lilypond[quote,verbatim,ragged-right]
harmonies = \chordmode {
  c1:m c:m \break c:m c:m d
}
<<
  \new ChordNames {
    \set chordChanges = ##t
    \harmonies }
  \new Staff \transpose c c' \harmonies
>>
@end lilypond

Todos los ejemplos anteriores muestran los acordes sobre una pauta.  Esto no es
necesario.  Los acordes también se pueden imprimir por separado.  Puede ser necesario
añadir @internalsref{Volta_engraver} y @internalsref{Bar_engraver}
para mostrar las repeticiones.

@lilypond[ragged-right,verbatim]
\new ChordNames \with {
  \override BarLine #'bar-size = #4
  \consists Bar_engraver
  \consists "Volta_engraver"
}
\chordmode { \repeat volta 2 {
  f1:maj7 f:7 bes:7
  c:maj7
} \alternative {
  es e
}
}
@end lilypond


La disposición por defecto de los nombres de acorde en la página es una pauta para el Jazz, propuesta por
Klaus Ignatzek (véase @ref{Literature list}).  Se puede modificar a través de las
siguientes propiedades

@table @code
@funindex chordNameExceptions
@item chordNameExceptions
He aquí una lista de los acordes que tienen un formateo especial.

La lista de excepciones se debe codificar como
@example
@{ <c f g bes>1 \markup @{ \super "7" "wahh" @} @}
@end example

La incorporación de esta información dentro de @code{chordNameExceptions} requiere algunas
maniobras.  El código siguiente transforma @code{chExceptionMusic}
(que es música secuencial) en una lista de excepciones.
@example
(sequential-music-to-chord-exceptions chExceptionMusic #t)
@end example
Después,
@example
(append
 (sequential-music-to-chord-exceptions chExceptionMusic #t)
 ignatzekExceptions)
@end example
añade las nuevas excepciones a las que existen de fábrica, que se encuentran definidas en
@file{ly/@/chord@/-modifier@/-init@/.ly}.

Para ver un ejemplo de cómo modificar esta propiedad, véase también
@lsr{chords,chord@/-name@/-exceptions@/.ly}
@cindex excepciones, nombres de acordes.


@funindex majorSevenSymbol
@item majorSevenSymbol
Esta propiedad contiene el objeto de marcado usado para la séptima, cuando
es mayor.  Las opciones predefinidas son @code{whiteTriangleMarkup} y
@code{blackTriangleMarkup}.  Consulte
@lsr{chords,chord@/-name@/-major7@/.ly} para ver un ejemplo.

@funindex chordNameSeparator
@item chordNameSeparator
Las distintas partes de un acorde están separadas normalmente por una barra
inclinada.  Estableciendo @code{chordNameSeparator}, puede especificar otros
separadores, p.ej.
@lilypond[quote,ragged-right,fragment,verbatim]
\new ChordNames \chordmode {
  c:7sus4
  \set chordNameSeparator
    = \markup { \typewriter "|" }
  c:7sus4
}
@end lilypond

@funindex chordRootNamer
@item chordRootNamer
La fundamental de un acorde se imprime normalmente como una letra con una alteración
opcional.  La transformación de nota a letra se hace por medio de esta función.
Los nombres de nota especiales (por ejemplo, la @q{H} alemana para un
acorde de Si) se puede producir almacenando una nueva función dentro de esta propiedad.

@funindex chordNoteNamer
@item chordNoteNamer
La opción por defecto es imprimir una sola nota, p.ej. el bajo, usando el
@code{chordRootNamer}.  La propiedad @code{chordNoteNamer} se puede establecer
a una función especializada para cambiar este comportamiento.  Por ejemplo, la
nota base se puede imprimir en minúsculas.

@funindex chordPrefixSpacer
@item chordPrefixSpacer
La @q{m} que de nota a los acordes menores se imprime normalmente justo después de la fundamental
del acorde. Estableciendo @code{chordPrefixSpacer}, puede insertar un separador
entre la fundamental y la @q{m}. El separador no se usa cuando la fundamental 
está alterada.

@end table

Las variables predefinidas @code{\germanChords},
@code{\semiGermanChords}, @code{\italianChords} y @code{\frenchChords}
establecen estas variables.  El efecto se muestra
a continuación:

@lilypondfile[ragged-right]{chord-names-languages.ly}

También se encuentran implementados otros dos esquemas de nombres de acorde: una
notación de acordes alternativa para Jazz, y un esquema sistemático llamado acordes de Banter.  La
notación alternativa de Jazz se muestra también en el cuadro @ref{Chord name
chart}.  El resultado de la activación de estos estilos se muestra en
@lsr{chords,chord-names-jazz.ly}.

@cindex Banter
@cindex jazz, acordes de
@cindex acordes de jazz


@predefined

@funindex \germanChords
@code{\germanChords},
@funindex \semiGermanChords
@code{\semiGermanChords}.
@funindex \italianChords
@code{\italianChords}.
@funindex \frenchChords
@code{\frenchChords}.




@seealso

Ejemplos:
@lsrdir{chords}

Archivos de inicio: @file{scm/@/chords@/-ignatzek@/.scm} y
@file{scm/@/chord@/-entry@/.scm}.


@knownissues

Los nombres de acorde se determinan exclusivamente a partir de la lista de notas.  No se identifican
las inversiones de acorde ni las notas del bajo añadidas.  Esto puede
dar como resultado nombres de acorde extraños cuando éstos se introducen con la
sintaxis @code{< .. >}.