@c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
@c vim: foldmethod=marker
@ignore
    Translation of GIT committish: d7e42f37c3c945ebff36b1c4bcb6c5da5051caa5

    When revising a translation, copy the HEAD committish of the
    version that you are working on.  For details, see the Contributors'
    Guide, node Updating translation committishes..
@end ignore

@c \version "2.25.5"


@node Ancient notation
@chapter Notación antigua

@lilypondfile[quote]{snippets/ancient-headword.ly}

@cindex Vaticana, Editio
@cindex Medicaea, Editio
@cindex Hufnagel
@cindex Petrucci
@cindex mensural

Entre las formas en que está contemplada la notación antigua se
encuentra la posibilidad de tipografiar notación mensural, canto
gregoriano y canto kievano en notación cuadrada.  Se puede acceder
a estas funcionalidades mediante la modificación de propiedades de
estilo de objetos gráficos como la cabeza de las notas o los
silencios, o bien mediante la utilización de uno de los contextos
predefinidos para estos estilos.

Muchos objetos gráficos, como la cabeza y el corchete de las
figuras, las alteraciones, la indicación de compás y los silencios
ofrecen una propiedad @code{style} (estilo), que se puede cambiar
para emular varios estilos diferentes de notación antigua.  Véase

@itemize
@item @ref{Mensural note heads},
@item @ref{Mensural accidentals and key signatures},
@item @ref{Mensural rests},
@item @ref{Mensural clefs},
@item @ref{Gregorian clefs},
@item @ref{Mensural flags},
@item @ref{Mensural time signatures}.
@end itemize

Ciertos conceptos de notación se incluyen específicamente para la
notación antigua:

@itemize
@item @ref{Custodes},
@item @ref{Divisiones},
@item @ref{Ligatures}.
@end itemize

@morerefs
Glosario musical:
@rglos{custos},
@rglos{ligature},
@rglos{mensural notation}.

Referencia de la notación:
@ref{Mensural note heads},
@ref{Mensural accidentals and key signatures},
@ref{Mensural rests},
@ref{Gregorian clefs},
@ref{Mensural flags},
@ref{Mensural time signatures},
@ref{Custodes},
@ref{Divisiones},
@ref{Ligatures}.
@endmorerefs


@node Overview of the supported styles
@section Panorámica de los estilos contemplados

Están disponibles tres estilos para la composición tipográfica del
canto gregoriano:

@itemize
@item
@cindex Solesmes
@cindex Vaticana, Editio
@emph{Editio Vaticana} es un estilo completo para canto
gregoriano, que sigue la apariencia de las ediciones de Solesmes,
los libros de canto oficiales del Vaticano desde 1904.  LilyPond
contempla todos los signos de notación que se utilizan en este
estilo, entre ellos las ligaduras, @emph{custodias} y símbolos
especiales como el quilisma y el oriscus.

@item
@cindex Ratisbona, Editio
@cindex Medicaea, Editio
El estilo @emph{Editio Medicaea} ofrece ciertas funcionalidades
que se usan en las ediciones Medicaea (o de Ratisbona) que se
usaban con anterioridad a las ediciones de Solesmes.  Las
diferencias más significativas con respecto al estilo
@emph{Vaticana} son las claves, que tienen trazos descendentes, y
la cabeza de las figuras, que son cuadradas y regulares.

@item
@cindex Hufnagel
El estilo @emph{Hufnagel} (en @qq{uña de herradura}) o
@emph{gótico} reproduce el estilo de escritura en los manuscritos
de canto medievales de Alemania y Centro Europa.  Recibe el nombre
de la forma de la nota básica (la @emph{virga}), que parece una
pequeña uña.
@end itemize

Tres estilos emulan la apariencia de los manuscritos y ediciones
impresas de música mensural tardomedievales y renacentistas:

@itemize
@item
@cindex mensural
El estilo @emph{Mensural}
se asemeja bastante al estilo de escritura utilizado en los
manuscritos tardomedievales y renacentistas tempranos, con la
cabeza de sus figuras en forma de rombo pequeñas y estrechas, y
los silencios que imitan un estilo dibujado a mano.

@item
@cindex neomensural
El estilo @emph{Neomensural}
es una versión modernizada y estilizada del anterior: la cabeza de
las figuras es más ancha y los silencios están formados por trazos
rectilíneos.  Este estilo está particularmente indicado, p.ej.,
para los @emph{incipits} de transcripciones de fragmentos de
música mensural.

@item
@cindex Petrucci
El estilo @emph{Petrucci}
recibe su nombre de Ottaviano Petrucci (1466-1539), el primer
impresor en utilizar tipos móviles para la música (en su
@emph{Harmonice musices odhecaton}, 1501).  Este estilo utiliza
para las figuras una cabeza más grande que los otros estilos
mensurales.

@end itemize

@emph{Baroque} y @emph{classical} no son estilos completos, sino
que difieren del estilo predeterminado solamente en ciertos
detalles: algunas cabezas de nota (Baroque) y el silencio de negra
(classical).

Solo el estilo mensural tiene alternativas para todos los aspectos
de la notación.  Así, no existen silencios ni corchetes en los
estilos gregorianos, pues estos símbolos no se usan en la notación
del canto llano, y el estilo Petrucci no posee corchetes ni
alteraciones por sí mismo.

Cada elemento de la notación se puede cambiar independientemente
de los otros, y así podemos usar corchetes mensurales, cabezas de
Petrucci, silencios de classical y claves de Vaticana en la misma
pieza, si queremos.

@morerefs
Glosario musical:
@rglos{mensural notation},
@rglos{flag}.
@endmorerefs


@need 1500
@node Ancient notation - common features
@section Notación antigua: funcionalidades comunes

@node Predefined contexts
@subsection Contextos predefinidos

Para el canto gregoriano y la notación mensural, están a nuestra
disposición contextos predefinidos de voz y de pauta, que
establecen todos los símbolos de notación a unos valores adecuados
para estos estilos.  Si nos satisfacen estos valores
predeterminados, podemos a continuación introducir directamente
las notas sin la necesidad de preocuparnos de los detalles sobre
cómo personalizar un contexto.  Véase uno de los contextos
predefinidos @code{VaticanaScore}, @code{VaticanaVoice},
@code{VaticanaStaff}, @code{MensuralVoice}, @code{MensuralStaff},
@code{PetrucciStaff}, @code{PetrucciVoice}, @code{KievanVoice} y
@code{KievanStaff}.

@morerefs
Glosario musical:
@rglos{mensural notation}.

Referencia de la notación:
@ref{Gregorian chant contexts},
@ref{Mensural contexts},
@ref{Kievan contexts}.
@endmorerefs


@node Ligatures
@subsection Ligaduras

@cindex ligadura

@c TODO: Should double check if I recalled things correctly when I wrote
@c down the following paragraph by heart.

Una ligadura es un símbolo gráfico que representa al menos dos
notas distintas.  Las ligaduras aparecieron originalmente en los
manuscritos de la notación del canto gregoriano para denotar
secuencias de notas ascendentes o descendentes en la misma sílaba.
Se usan también en notación mensural.

@funindexpost \[
@funindexpost \]

Las ligaduras se escriben @emph{encerrándolas} dentro de un par
@code{\[} y @code{\]}.  Ciertos estilos de ligadura podrían
necesitar una sintaxis de entrada adicional específica para este
tipo de ligadura en particular.  De forma predeterminada, el
grabador @code{LigatureBracket} se limita a colocar un corchete
recto sobre la ligadura:

@lilypond[quote,ragged-right,verbatim]
\relative {
  \[ g' c, a' f d' \]
  a g f
  \[ e f a g \]
}
@end lilypond

Están disponibles otros tres estilos de ligaduras: el @q{Vaticana}
para canto gregoriano, el @q{Mensural} para música mensural (solo
están contempladas las ligaduras mensurales blancas para la música
mensural, y con ciertas limitaciones), y @q{Kievan} para los
melismas del canto kievano.  Para usar cualquiera de estos
estilos, se debe sustituir el grabador predeterminado
@code{Ligature_@/bracket_@/engraver} por uno de los grabadores
especializados en ligaduras del contexto @code{Voice}. Para más
información, @pxref{White mensural ligatures}, @ref{Gregorian
square neume ligatures}, and @ref{Kievan melismata}.

@morerefs
Glosario musical:
@rglos{ligature}.

Referencia de la notación:
@ref{White mensural ligatures},
@ref{Gregorian square neume ligatures}.
@endmorerefs

@knownissues
El espacio que las ligaduras necesitan no está implementado
actualmente, y como resultado, puede producirse una separación
excesiva entre ellas.  Los saltos de línea podrían también ser
poco satisfactorios.

La estra podría no alinearse con la música de la forma esperada
cuando se utilizan ligaduras.

No se deben imprimir alteraciones accidentales dentro de una
ligadura, sino acumularse e imprimirse delante de ella.

La sintaxis aún utiliza el estilo obsoleto @qq{infijo} @code{\[
expresión musical \]}.  Por motivos de consistencia, se cambiará
tarde o temprano al estilo @qq{postfijo} @code{nota\[ @dots{}
nota\]}.

@c Alternatively, the file
@c @file{gregorian-init.ly} can be included; it provides a Scheme
@c function
@c @example
@c \ligature @var{music expr}
@c @end example
@c with the same effect and is believed to be stable.

@c TODO: this does not seem to work at the moment.
@c -- eo


@node Custodes
@subsection Custos

@cindex custos
@cindex custodes (custodias)

Un @emph{custos} (en plural: @emph{custodias}, que en latín
significa @qq{guarda}) es un símbolo que aparece al final de una
pauta.  Anticipa la altura de la primera o primeras notas de la
línea siguiente, ayudando al intérprete con los saltos de línea
durante la ejecución.

Las custodias se utilizaron mucho en la notación musical hasta el
siglo XVII.  En nuestros días, sobreviven solo en algunas formas
particulares de notación musical como las ediciones contemporáneas
de canto gregoriano como la @emph{Editio Vaticana}.  Hay distintos
glifos para el custos que se utilizan en las diferentes
variaciones de estilo notacional.

Para tipografiar las custodias, simplemente coloque un grabador
@code{Custos_engraver} dentro del contexto @code{Staff} (el
contexto del pentagrama) al declarar el bloque de @code{\layout}
(el bloque de disposición de la página), y modifique el estilo del
custos con una instrucción @code{\override} si lo desea, como se
muestra en el ejemplo siguiente:

@c Due to LilyPond's overzealous cropping on the right side we use
@c different rendering code to avoid that.

@example
\score @{
  \relative @{
    a'1
    \break
    g
  @}
  \layout @{
    \context @{
      \Staff
      \consists Custos_engraver
      \override Custos.style = #'mensural
    @}
  @}
@}
@end example

@lilypond[quote,ragged-right]
\markup {
  \score {
    \relative {
      a'1
      \break
      g
    }
    \layout {
      \context {
        \Staff
        \consists Custos_engraver
        \override Custos.style = #'mensural
      }
    }
  }
  \hspace #2
}
@end lilypond

El glifo del custos se selecciona mediante la propiedad
@code{style}.  Los estilos contemplados son @code{vaticana},
@code{medicaea}, @code{hufnagel} y @code{mensural}.

@lilypond[quote,ragged-right,fragment,verbatim]
\new Lyrics \lyricmode {
  \markup { \column {
    \typewriter "vaticana "
    \line { " " \musicglyph "custodes.vaticana.u0" }
  } }
  \markup { \column {
    \typewriter "medicaea "
    \line { " " \musicglyph "custodes.medicaea.u0" }
  }}
  \markup { \column {
    \typewriter "hufnagel "
    \line { " " \musicglyph "custodes.hufnagel.u0" }
  }}
  \markup { \column {
    \typewriter "mensural "
    \line { " " \musicglyph "custodes.mensural.u0" }
  }}
}
@end lilypond

@morerefs
Glosario musical:
@rglos{custos}.

Fragmentos de código:
@rlsrnamed{Ancient notation,Notación de la música antigua}.

Referencia de funcionamiento interno:
@rinternals{Custos}.
@endmorerefs


@need 1500
@node Typesetting mensural music
@section Tipografiar música mensural

@node Mensural contexts
@subsection Contextos de la música mensural

@funindex MensuralVoice
@funindex MensuralStaff

Los contextos predefinidos de voz @code{MensuralVoice} y de pauta
@code{MensuralStaff} se pueden usar para grabar una pieza en
estilo mensural.  Estos contextos establecen a unos valores
iniciales adecuados todas las propiedades relevantes de los
contextos y de los objetos gráficos, de manera que pueda comenzar
inmediatamente a escribir el canto, como lo demuestra el siguiente
fragmento:

@lilypond[quote,ragged-right,verbatim]
\score {
  <<
    \new MensuralVoice = "discantus" \relative {
      \hide Score.BarNumber {
        c''1\melisma bes a g\melismaEnd
        f\breve
        \[ f1\melisma a c\breve d\melismaEnd \]
        c\longa
        c\breve\melisma a1 g1\melismaEnd
        fis\longa^\signumcongruentiae
      }
    }
    \new Lyrics \lyricsto "discantus" {
      San -- ctus, San -- ctus, San -- ctus
    }
  >>
}
@end lilypond

@morerefs
Glosario musical:
@rglos{mensural notation}.
@endmorerefs


@node Mensural clefs
@subsection Claves de la música mensural

@cindex clave, estilos
@cindex música antigua, claves
@cindex clave de música antigua
@cindex clave de Petrucci
@cindex clave mensural
@cindex clave mensural negra
@cindex clave kievana
@cindex Petrucci, clave
@cindex mensural, clave
@cindex mensural negra, clave
@cindex kievana, clave

Están contempladas las claves mensurales usando la instrucción
@code{\clef}.  Algunas de las claves utilizan el mismo glifo, pero
se diferencian solamente respecto a la línea en la que se
imprimen.  En tales casos, se utiliza un sufijo numérico en el
nombre para denominar dichas claves, contando las líneas desde la
inferior hasta la superior.

@lilypond[verbatim,quote]
\new MensuralStaff {
  \clef "mensural-c1" c'1
}
@end lilypond

@lilypond[verbatim,quote]
\new MensuralStaff {
  \override NoteHead.style = #'blackmensural
  \clef "blackmensural-c2" c'1
}
@end lilypond

@lilypond[verbatim,quote]
\new MensuralStaff {
  \override NoteHead.style = #'neomensural
  \clef "neomensural-c3" c'1
}
@end lilypond

@lilypond[verbatim,quote]
\new PetrucciStaff {
  \clef "petrucci-c4" c'1
}
@end lilypond

Se puede forzar manualmente la composición tipográfica de un glifo
de clave sobre cualquier línea seleccionada arbitrariamente;
@pxref{Clef}.  Para ver el abanico completo de las claves
posibles, @pxref{Clef styles}.

@morerefs
Glosario musical:
@rglos{mensural notation},
@rglos{clef}.

Referencia de la notación:
@ref{Gregorian clefs},
@ref{Clef}.

Archivos instalados:
@file{scm/parser-clef.scm}.

Fragmentos de código:
@rlsrnamed{Pitches,Alturas}.

Referencia de funcionamiento interno:
@rinternals{Clef_engraver},
@rinternals{Clef},
@rinternals{ClefModifier},
@rinternals{clef-interface}.
@endmorerefs

@knownissues
La clave de Sol Mensural está asignada a la clave de Sol de
Petrucci.


@node Mensural time signatures
@subsection Indicaciones de compás de la música mensural

@cindex mensuración, símbolo de
@cindex compás, indicación de, mensural
@cindex compás, indicación de, estilos de

Los símbolos de mensuración (que son algo similar, pero no
exactamente igual que las indicaciones de compás) están
contemplados de forma limitada.  Los glifos están configurados de
forma fija para determinadas fracciones de tiempo.  En otras
palabras, para obtener un símbolo de mensuración determinado con
la instrucción @code{\time @var{n}/@var{m}}, se tienen que escoger
@var{n} y@tie{}@var{m} según la siguiente tabla

@lilypond[quote]
\markup \column {
  \override #'(padding . 3)
  \override #'(baseline-skip . 2)
  \table #'(0 0 0 0) {
    \typewriter "\\time 4/4"
      \typewriter "\\time 2/2"
        \typewriter "\\time 6/4"
          \typewriter "\\time 6/8"
    \musicglyph "timesig.neomensural44"
      \musicglyph "timesig.neomensural22"
        \musicglyph "timesig.neomensural64"
          \musicglyph "timesig.neomensural68"

    \null \null \null \null

    \typewriter "\\time 3/2"
      \typewriter "\\time 3/4"
        \typewriter "\\time 9/4"
          \typewriter "\\time 9/8"
    \musicglyph "timesig.neomensural32"
      \musicglyph "timesig.neomensural34"
        \musicglyph "timesig.neomensural94"
          \musicglyph "timesig.neomensural98"

    \null \null \null \null

    \typewriter "\\time 4/8"
      \typewriter "\\time 2/4"
        \null
          \null
    \musicglyph "timesig.neomensural48"
      \musicglyph "timesig.neomensural24"
        \null
          \null
  }
}
@end lilypond

Utilice la propiedad @code{style} del elemento gráfico
@code{TimeSignature} para seleccionar las indicaciones de compás
de la música antigua.  Los estilos contemplados son
@code{neomensural} y @code{mensural}.  La tabla anterior utiliza
el estilo @code{neomensural}.  Los ejemplos siguientes muestran
las diferencias que existen entre los estilos:

@lilypond[ragged-right,quote]
{
  \omit Staff.BarLine
  \omit Staff.Clef

  \override Staff.TextMark.self-alignment-X = #CENTER
  \override Staff.TextMark.break-align-symbols = #'(time-signature)
  \override Staff.TextMark.font-size = -1
  \override Staff.TextMark.staff-padding = 1.5
  \override Staff.TimeSignature.break-align-anchor-alignment = #CENTER

  \once \omit Staff.TimeSignature
  s1

  \textMark \markup \typewriter default
  \time 2/2 s1*3

  \textMark \markup \typewriter numbered
  \override Staff.TimeSignature.style = #'numbered
  \time 2/2 s1*3

  \textMark \markup \typewriter mensural
  \override Staff.TimeSignature.style = #'mensural
  \time 2/2 s1*3

  \textMark \markup \typewriter neomensural
  \override Staff.TimeSignature.style = #'neomensural
  \time 2/2 s1*3

  \textMark \markup \typewriter single-number
  \override Staff.TimeSignature.style = #'single-number
  \time 2/2 s1
}

% `TextMark` grobs in `Score` don't react to `staff-padding` (issue #342).
\layout {
  \context {
    \Score
    \remove Text_mark_engraver
  }
  \context {
    \Staff
    \consists Text_mark_engraver
  }
}
@end lilypond

@ref{Time signature} ofrece una introducción general al uso
de las indicaciones de compás.

@morerefs
Glosario musical:
@rglos{mensural notation}.

Referencia de la notación:
@ref{Time signature}.
@endmorerefs

@knownissues
Las relaciones de duración de las notas no pueden cambiar con la
indicación de compás, porque no son constantes.  Por ejemplo, la
razón de 1@tie{}breve = 3@tie{}semibreves (@emph{tempus
perfectum}) se puede hacer a mano mediante el establecimiento de

@example
breveTP = #(ly:make-duration -1 0 3/2)
@dots{}
@{ c\breveTP f1 @}
@end example

@noindent
Esto fija un valor para @code{breveTP} de 3/2 multiplicado por 2 =
3 veces una redonda.

Los símbolos @code{mensural68alt} y @code{neomensural68alt}
(alternativos al símbolo de 6/8) no se puede seleccionar
directamente con @code{\time}.  En su lugar, utilice @code{\markup
@{\musicglyph "timesig.mensural68alt" @}}.


@node Mensural note heads
@subsection Cabezas de nota de la música mensural

@cindex cabezas de nota antiguas

Para la notación antigua, se puede elegir un estilo de cabezas de
notas distinto al @code{default} (estilo predeterminado).  Esto se
consigue estableciendo la propiedad @code{style} del objeto
@code{NoteHead} a los valores @code{baroque}, @code{neomensural},
@code{mensural}, @code{petrucci}, @code{blackpetrucci} o
@code{semipetrucci}.

El estilo @code{baroque} se diferencia del estilo predeterminado
@code{default} en que:

@itemize
@item Proporciona una cabeza de nota para la @code{maxima}, y
@item Usa una forma cuadrada para las cabezas de @code{\breve}.
@end itemize

Los estilos @code{neomensural}, @code{mensural} y @code{petrucci}
se diferencian del estilo @code{baroque} en que:

@itemize
@item Usan cabezas romboidales para las semibreves y todas las notas más cortas, y
@item Centran las plicas sobre las cabezas.
@end itemize

El estilo @code{blackpetrucci} produce notas con una cabeza que
puede usarse en notación mensural negra o en secciones de
coloratio dentro de la notación mensural blanca.  A causa de que
el estilo de la cabeza de las notas no influye en el número de
corchetes, en este estilo la notación de la semimínima debe hacer
como @code{a8*2}, no como @code{a4}, pues de lo contrario tendrá
el aspecto de una mínima.  El multiplicador puede ser distinto si
se usa la coloratio, es decir, para la notación de tresillos.

Utilice el estilo @code{semipetrucci} para dibujar notas con
cabeza semi-rellena (breves, longas y máximas).

El ejemplo siguiente muestra el estilo @code{petrucci}:

@c Renaissance music doesn't use bar lines ...  but they do help to
@c separate the notes for easier identification.

@lilypond[quote,fragment,ragged-right,verbatim]
\compressEmptyMeasures
\autoBeamOff
\override NoteHead.style = #'petrucci
a'\maxima a'\longa a'\breve a'1 a'2 a'4 a'8 a'16 a'
\override NoteHead.style = #'semipetrucci
a'\breve*5/6
\override NoteHead.style = #'blackpetrucci
a'8*4/3 a'
\override NoteHead.style = #'petrucci
a'\longa
@end lilypond


@ref{Note head styles} ofrece una visión de conjunto
sobre la totalidad de los estilos de cabeza disponibles.

@morerefs
Glosario musical:
@rglos{mensural notation},
@rglos{note head}.

Referencia de la notación:
@ref{Note head styles}.
@endmorerefs


@node Mensural flags
@subsection Corchetes de la música mensural

@cindex corchete mensural
@cindex mensural, corchete

Utilice la propiedad @code{style} del elemento gráfico
@code{Flag} para seleccionar los corchetes de estilo antiguo.
Aparte del estilo de corchete por defecto @code{default}, solo
está contemplado el estilo @code{mensural}

@lilypond[quote,fragment,ragged-right,verbatim]
\relative c' {
  \override Flag.style = #'mensural
  \override Stem.thickness = 1.0
  \override NoteHead.style = #'mensural
  \autoBeamOff
  c8 d e f c16 d e f c32 d e f s8
  c'8 d e f c16 d e f c32 d e f
}
@end lilypond

Observe que la bandera más interna de cada uno de los corchetes
mensurales se alinea verticalmente con una línea de la pauta.

No existe un estilo particular de corchete para la notación
neo-mensural ni Petrucci.  No existen corchetes en la notación del
canto gregoriano.

@morerefs
Glosario musical:
@rglos{mensural notation},
@rglos{flag}.
@endmorerefs

@knownissues
La alineación vertical de cada uno de los corchetes con una línea
de la pauta da por supuesto que las plicas siempre terminan
exactamente encima o bien exactamente en el medio de dos líneas de
la pauta.  Esto puede no ser siempre cierto cuando se utilizan las
posibilidades de disposición avanzadas de la notación clásica
(que, de todas formas, por lo común se encuentra fuera del ámbito
de la notación mensural).


@node Mensural rests
@subsection Silencios de la música mensural

@cindex silencio antiguo

Utilice la propiedad @code{style} del elemento gráfico @code{Rest}
para seleccionar silencios antiguos.  Los estilos de música
antigua contemplados son @code{classical}, @code{neomensural} y
@code{mensural}.

El ejemplo siguiente muestra estos estilos:

@lilypond[quote,fragment,ragged-right,verbatim]
\compressEmptyMeasures
\override Rest.style = #'mensural
r\longa^"mensural" r\breve r1 r2 r4 r8 r16 s \break
\override Rest.style = #'neomensural
r\longa^"neomensural" r\breve r1 r2 r4 r8 r16
@end lilypond

No existen silencios de fusa y semifusa específicos para los
estilos mensural ni neo-mensural.  Se usan los silencios del
estilo predeterminado.

@morerefs
Glosario musical:
@rglos{mensural notation}.

Referencia de la notación:
@ref{Rests}.

Fragmentos de código:
@rlsrnamed{Ancient notation,Notación de la música antigua}.
@endmorerefs

@knownissues
El glifo para el silencio de máxima en el estilo mensural es en
realidad un silencio de longa perfecta; use dos (o tres) silencios
de longa para imprimir un silencio de máxima.  Los sliencions de
longa no se agrupan automáticamente, por lo que debe hacerse
manualmente utilizando silencios con altura determinada.


@node Mensural accidentals and key signatures
@subsection Alteraciones y armaduras de la música mensural

@cindex alteración mensural
@cindex armadura mensural

El estilo @code{mensural} ofrece unos símbolos de sostenido y
bemol distintos de los del estilo predeterminado.  La notación
mensural rara vez utilizaba el becuadro: en su lugar, se usaba el
sostenido o bemol correspondiente.  Por ejemplo, un Si natural en
la tonalidad de Fa mayor se indicaría con un sostenido.  Sin
embargo, si se solicita explícitamente, el símbolo de becuadro se
extrae del estilo @code{vaticana}.

@lilypond[quote,ragged-right,staffsize=26]
\markup {
  \column {
    "mensural"
    \line { " " \musicglyph "accidentals.mensural-1"
      " " \musicglyph "accidentals.mensural1" }
  }
}
@end lilypond

La manera de usar este estilo se explica en @ref{Alternate accidental glyphs}.
Se encuentra por omisión dentro del contexto @code{MensuralStaff}.

@morerefs
Glosario musical:
@rglos{mensural notation},
@rglos{Pitch names},
@rglos{accidental},
@rglos{key signature}.

Referencia de la notación:
@ref{Pitches},
@ref{Accidentals},
@ref{Automatic accidentals},
@ref{Alternate accidental glyphs},
@ref{Accidental glyph sets},
@ref{Key signature}.

Referencia de funcionamiento interno:
@rinternals{KeySignature}.
@endmorerefs


@node Annotational accidentals (musica ficta)
@subsection Alteraciones de anotación (@emph{musica ficta})

En la música europea de hasta aprox. 1600, se esperaba de los
cantantes que alterasen cromáticamente ciertas notas según su
propia iniciativa y de acuerdo a ciertas reglas.  Esto recibe el
nombre de @notation{musica ficta}.  En las transcripciones
modernas, estas alteraciones accidentales se imprimen normalmente
encima de la nota.

@cindex alteraciones de la musica ficta
@cindex musica ficta

Están contempladas estas alteraciones sugeridas, y se pueden
activar estableciendo @code{suggestAccidentals} al valor
@code{#t} (verdadero).

@funindex suggestAccidentals

@lilypond[verbatim]
\relative {
  fis' gis
  \set suggestAccidentals = ##t
  ais bis
}
@end lilypond

Esto hará que se traten @emph{todas} las alteraciones siguientes
como @emph{musica ficta} hasta que se desactive con @code{\set
suggestAccidentals = ##f}.  Una forma más práctica es usar
@code{\once \set suggestAccidentals = ##t}, que puede incluso
definirse como una forma breve muy conveniente:

@lilypond[quote,verbatim]
ficta = { \once \set suggestAccidentals = ##t }
\score { \relative
  \new MensuralVoice  {
    \once \set suggestAccidentals = ##t
    bes'4 a2 g2 \ficta fis8 \ficta e! fis2 g1
  }
}
@end lilypond

@morerefs
Referencia de funcionamiento interno:
@rinternals{Accidental_engraver},
@rinternals{AccidentalSuggestion}.
@endmorerefs


@node White mensural ligatures
@subsection Ligaduras mensurales blancas

@cindex mensural, ligadura
@cindex ligadura mensural
@cindex ligadura mensural blanca

Las ligaduras mensurales blancas están contempladas de forma
limitada.

@funindex Ligature_bracket_engraver
@funindex Mensural_ligature_engraver

Para grabar ligaduras mensurales blancas, reemplace el grabador
@code{Ligature_@/bracket_@/engraver} por el grabador
@code{Mensural_@/ligature_@/engraver} en el bloque layout del
contexto @code{Voice}:

@example
\layout @{
  \context @{
    \Voice
    \remove Ligature_bracket_engraver
    \consists Mensural_ligature_engraver
  @}
@}
@end example

@funindex PetrucciStaff
@funindex PetrucciVoice

En el ejemplo siguiente, usamos un contexto @code{PetrucciStaff},
que lleva a cabo esta sustitución, entre otras configuraciones,
asemejándose a la tipografía mensural del @cite{Harmonices Musices
Odhecaton} de Ottaviano Petrucci (Venecia, 1501).  El contexto de
la voz que lo acompaña se llama @code{PetrucciVoice}.

No existe ningún lenguaje de entrada adicional para describir la
forma de una ligadura mensural blanca.  Más bien la forma se
determina exclusivamente a partir de las alturas y las duraciones
de las notas comprendidas.  Si bien este enfoque podría hacer que
un usuario con poca experiencia tardase un tiempo en acostumbrarse
a él, tiene la gran ventaja de que toda la información musical de
la ligadura se conoce internamente.  Esto no se requiere solamente
para una salida MIDI correcta, sino que también permite la
transcripción automática de las ligaduras.

@cindex flexa, en ligaduras mensurales
@cindex mensural, ligadura, flexa

En algunos lugares, dos notas consecutivas se pueden representar
bien como dos cuadrados, bien como un paralelogramo oblicuo (forma
de @dfn{flexa}).  En tales casos la forma por omisión es dos
cuadrados, pero puede requerirse una flexa fijando la propiedad
@code{ligature-flexa} de la @emph{segunda} cabeza.  El ancho de
una flexa se puede fijar mediante la propiedad @code{flexa-width}
de la cabeza.

@noindent
Por ejemplo:

@lilypond[quote,verbatim]
\new PetrucciStaff \relative {
  \[ c''\maxima g \]
  \[ d'\longa
     \tweak ligature-flexa ##t
     \tweak flexa-width #3.2 c\breve f e d \]
  \[ c\maxima d\longa \]
  \[ e1 a, g\breve \]
}
@end lilypond

@noindent
Si no se sustituye el grabador @code{Ligature_bracket_engraver}
por el @code{Mensural_ligature_engraver}, la misma música presenta
la siguiente apariencia:

@lilypond[quote]
\new PetrucciStaff \relative {
  \[ c''\maxima g \]
  \[ d'\longa
     \tweak ligature-flexa ##t
     \tweak flexa-width #3.2 c\breve f e d \]
  \[ c\maxima d\longa \]
  \[ e1 a, g\breve \]
}
\layout {
  \context {
    \PetrucciVoice
    \remove Mensural_ligature_engraver
    \consists Ligature_bracket_engraver
  }
}
@end lilypond

También hay casos en los que no se necesita una plica para
registrar la duración de la nota de forma no ambigua, pero tampoco
está prohibido:

@itemize
@item
una breve inicial (con una altura más baja que la nota siguiente)
puede tener, o no, una plica a la izquierda y hacia abajo;
@item
una maxima puede o no tener una plica a la derecha y hacia abajo;
@item
una longa final (con una altura más baja que la nota anterior)
puede o no tener una plica a la derecha.
@end itemize

@noindent
He aquí un ejemplo que muestra este trucaje.

@lilypond[quote,ragged-right,verbatim]
\new PetrucciStaff \relative {
  \clef "petrucci-c4"
  \[ \tweak left-down-stem ##t a\breve b
     \tweak right-down-stem ##t g\longa \]
  \[ \tweak right-down-stem ##t b\maxima
     \tweak right-up-stem ##t g\longa \]
}
@end lilypond

@noindent
Without tweaking the same ligatures look as follows.

@lilypond[quote,ragged-right,verbatim]
\new PetrucciStaff \relative {
  \clef "petrucci-c4"
  \[ a\breve b g\longa \]
  \[ b\maxima g\longa \]
}
@end lilypond

@morerefs
Glosario musical:
@rglos{ligature}.

Referencia de la notación:
@ref{Gregorian square neume ligatures},
@ref{Ligatures}.
@endmorerefs

@knownissues
El espaciado horizontal de las ligaduras puede ser algo pobre.
Las alteraciones accidentales pueden colisionar con las notas
previas.


@node Typesetting Gregorian chant
@section Tipografiado del canto gregoriano

Al componer tipográficamente una pieza en notación de canto
gregoriano, el grabador @code{Vaticana_ligature_engraver}
selecciona automáticamente la cabeza adecuada de las figuras, de
manera que no es necesario establecer explícitamente el estilo de
las cabezas.  A pesar de ello se puede establecer el estilo de las
cabezas, p.ej.: a @code{vaticana.punctum} para producir neumas de
punctum.  De forma similar, el grabador
@code{Mensural_ligature_engraver} construye ligaduras mensurales
automáticamente.  Consulte @ref{Ligatures} para ver cómo funcionan
los grabadores de ligaduras.

@morerefs
Glosario musical:
@rglos{ligature}.

Referencia de la notación:
@ref{White mensural ligatures},
@ref{Ligatures}.
@endmorerefs


@node Gregorian chant contexts
@subsection Contextos del canto gregoriano

@funindex VaticanaVoice
@funindex VaticanaLyrics
@funindex VaticanaStaff
@funindex VaticanaScore

Los contextos predefinidos @code{VaticanaScore},
@code{VaticanaVoice}, @code{VaticanaStaff} y @code{VaticanaLyrics}
se pueden utilizar para grabar una pieza de canto gregoriano en el
estilo de la Editio Vaticana.  Estos contextos establecen a unos
valores iniciales adecuados todas las propiedades relevantes de
los contextos y de los objetos gráficos.  Puede inmediatamente
comenzar a escribir el canto en sí, como lo demuestra el siguiente
fragmento.

@lilypond[quote,ragged-right,verbatim,staffsize=23]
\new VaticanaScore {
  <<
    \new VaticanaVoice = "cantus" {
      \[ c'\melisma c' \flexa a \]
      \[ a \flexa \deminutum g\melismaEnd \]
      f \divisioMinima
      \[ f\melisma \pes a c' c' \pes d'\melismaEnd \]
      c' \divisioMinima \break
      \[ c'\melisma c' \flexa a \]
      \[ a \flexa \deminutum g\melismaEnd \] f \divisioMinima
    }
    \new VaticanaLyrics \lyricsto "cantus" {
      San -- ctus, San -- ctus, San -- ctus
    }
  >>
}

\layout {
  indent = 0
  ragged-last = ##t
}
@end lilypond


@c @morerefs
@c TODO: nothing here yet ...
@c @endmorerefs


@node Gregorian clefs
@subsection Claves de canto gregoriano

@cindex clave

La tabla siguiente muestra todas las claves gregorianas
contempladas a través de la instrucción @code{\clef}.  Algunas de
las claves usan el mismo glifo, pero se diferencian solamente en
la línea en que se imprimen.  En estos casos, para enumerar estas
claves se usa un número a continuación del nombre de la clave,
contando desde la línea inferior.  Aún se puede forzar manualmente
la composición tipográfica de un glifo de clave sobre una línea
arbitraria, como se describe en @ref{Clef}.  La nota que se
imprime a la derecha junto a cada una de las claves en la columna
de los ejemplos, denota el Do central (@code{c'}) respecto a dicha
clave.

@need 1000
@indentedblock
@multitable @columnfractions .4 .4 .2
@item
@b{Descripción}
@tab
@b{Claves posibles}
@tab
@b{Ejemplo}

@item
Clave de Do, estilo Editio Vaticana
@tab
@code{vaticana-do1}, @code{vaticana-do2},@*
@code{vaticana-do3}
@tab
@lilypond[inline,line-width=1.5\cm]
\new VaticanaScore
  \new VaticanaStaff { \clef "vaticana-do2" s c' s }
\layout {
  ragged-last = ##f
  \override SpacingSpanner.packed-spacing = ##f
}
@end lilypond

@item
Clave de Fa, estilo Editio Vaticana
@tab
@code{vaticana-fa1}, @code{vaticana-fa2}
@tab
@lilypond[inline,line-width=1.5\cm]
\new VaticanaScore
  \new VaticanaStaff { \clef "vaticana-fa2" s c' s }
\layout {
  ragged-last = ##f
  \override SpacingSpanner.packed-spacing = ##f
}
@end lilypond

@item
Clave de Do, estilo Editio Medicaea
@tab
@code{medicaea-do1}, @code{medicaea-do2},@*
@code{medicaea-do3}
@tab
@lilypond[inline,line-width=1.5\cm]
\new VaticanaScore
  \new VaticanaStaff {
    \override NoteHead.style = #'medicaea.punctum
    \clef "medicaea-do2" s c' s
  }
\layout {
  ragged-last = ##f
  \override SpacingSpanner.packed-spacing = ##f
}
@end lilypond

@item
Clave de Fa, estilo Editio Medicaea
@tab
@code{medicaea-fa1}, @code{medicaea-fa2}
@tab
@lilypond[inline,line-width=1.5\cm]
\new VaticanaScore
  \new VaticanaStaff {
    \override NoteHead.style = #'medicaea.punctum
    \clef "medicaea-fa2" s c' s
  }
\layout {
  ragged-last = ##f
  \override SpacingSpanner.packed-spacing = ##f
}
@end lilypond

@item
Clave de Do, estilo hufnagel
@tab
@code{hufnagel-do1}, @code{hufnagel-do2},@*
@code{hufnagel-do3}
@tab
@lilypond[inline,line-width=1.5\cm]
\new VaticanaScore
  \new VaticanaStaff {
    \override NoteHead.style = #'hufnagel.punctum
    \clef "hufnagel-do2" s c' s
  }
\layout {
  ragged-last = ##f
  \override SpacingSpanner.packed-spacing = ##f
}
@end lilypond

@item
Clave de Fa, estilo hufnagel
@tab
@code{hufnagel-fa1}, @code{hufnagel-fa2}
@tab
@lilypond[inline,line-width=1.5\cm]
\new VaticanaScore
  \new VaticanaStaff {
    \override NoteHead.style = #'hufnagel.punctum
    % This is a guess; I couldn't find a ledger-line example (wl)
    \override VaticanaStaff.LedgerLineSpanner.length-fraction = 0.45
    \clef "hufnagel-fa2" s c' s
  }
\layout {
  ragged-last = ##f
  \override SpacingSpanner.packed-spacing = ##f
}
@end lilypond

@item
Clave combinada de Do y Fa, estilo hufnagel
@tab
@code{hufnagel-do-fa}
@tab
@lilypond[inline,line-width=1.5\cm]
\new VaticanaScore
  \new VaticanaStaff {
    \override NoteHead.style = #'hufnagel.punctum
    \override Staff.StaffSymbol.line-count = 5
    \clef "hufnagel-do-fa" s c' s
  }
\layout {
  ragged-last = ##f
  \override SpacingSpanner.packed-spacing = ##f
}
@end lilypond
@end multitable
@end indentedblock

@morerefs
Glosario musical:
@rglos{clef}.

Referencia de la notación:
@ref{Clef}.
@endmorerefs


@node Gregorian accidentals and key signatures
@subsection Alteraciones y armaduras de canto gregoriano

@cindex alteraciones gregorianas
@cindex armadura gregoriana
@cindex gregoriano, alteración
@cindex gregoriano, armadura

Están disponibles las alteraciones de los tres estilos
gregorianos:

@lilypond[quote,ragged-right,staffsize=26]
\markup {
  \column {
    "vaticana"
    \line { " " \musicglyph "accidentals.vaticana-1"
      " " \musicglyph "accidentals.vaticana0" }
  }
  \column {
    "medicaea"
    \line { " " \musicglyph "accidentals.medicaea-1" }
  }
  \column {
    "hufnagel"
    \line { " " \musicglyph "accidentals.hufnagel-1" }
  }
}
@end lilypond

Como se ve en el ejemplo, cada estilo no contempla todas las
alteraciones.  Al intentar acceder a una alteración que no está
contemplada, LilyPond cambia a un estilo diferente.

@c @lilypondfile[verbatim,quote,texidoc,doctitle]
@c {ancient-accidentals.ly}

La forma de alternar entre los estilos se explica en @ref{Alternate accidental glyphs}.

@morerefs
Glosario musical:
@rglos{accidental},
@rglos{key signature}.

Referencia de la notación:
@ref{Pitches},
@ref{Accidentals},
@ref{Automatic accidentals},
@ref{Alternate accidental glyphs},
@ref{Key signature}.

Referencia de funcionamiento interno:
@rinternals{KeySignature}.
@endmorerefs


@node Divisiones
@subsection Divisiones

@cindex barra de compás, en canto gregoriano
@cindex divisio
@cindex divisiones
@cindex barra final, en canto gregoriano
@cindex finalis
@cindex barra de frase, en canto gregoriano
@cindex barra de sección, en canto gregoriano
@cindex barra corta, en canto gregoriano
@cindex barra de raya, en canto gregoriano

En la notación del canto gregoriano no existen silencios, sino
@ref{Divisiones}.

Una @emph{divisio} (en plural: @emph{divisiones}, que en latín
significa @q{división}) es un símbolo staff-context
que indica la estructura de la música gregoriana en frases y
secciones.  El significado musical de @emph{divisio minima},
@emph{divisio maior} y @emph{divisio maxima} se podrían
caracterizar como una pausa corta, media y larga
(respectivamente).  El signo de @emph{finalis} no solo
marca el final de un canto, sino que se usa también con frecuencia
dentro de un único canto antifonal o responsorial para marcar el
final de cada una de las secciones.

Algunas ediciones usan @emph{virgula} o @emph{caesura} en vez de divisio minima.  Por ello, @file{gregorian.ly} define también las
instrucciones @code{\virgula} y @code{\caesura}.

@lilypond[quote,ragged-right,staffsize=23]
\new VaticanaScore {
  \new VaticanaVoice {
    \override TextScript.padding = 3
    g a g
    s^\markup { "divisio minima" }
    \divisioMinima
    g a g
    s^\markup { "divisio maior" }
    \divisioMaior
    g a g
    s^\markup { "divisio maxima" }
    \divisioMaxima
    \break
    g a g
    s^\markup { "finalis" }
    \finalis
    g a g
    s^\markup { "virgula" }
    \virgula
    g a g
    s^\markup { "caesura" }
    \caesura
    g a g
  }
}

\layout {
  indent = 0
  ragged-last = ##t
}
@end lilypond

@predefined
@funindex \virgula
@funindex \caesura
@funindex \divisioMinima
@funindex \divisioMaior
@funindex \divisioMaxima
@funindex \finalis

@code{\virgula},
@code{\caesura},
@code{\divisioMinima},
@code{\divisioMaior},
@code{\divisioMaxima},
@code{\finalis}.
@endpredefined

@morerefs
Glosario musical:
@rglos{caesura},
@rglos{divisio}.

Referencia de la notación:
@ref{Breath marks}.
@endmorerefs


@node Gregorian articulation signs
@subsection Articulaciones del canto gregoriano

@cindex articulaciones gregorianas
@cindex gregoriano, articulación

Además de los signos de articulación estándar que se hallan
descritos en la sección @ref{Articulations and ornamentations}, se
proveen signos de articulación diseñados específicamente para
utilizarlos con la notación en el estilo de la @emph{Editio
Vaticana}.

@funindex \accentus
@funindex \circulus
@funindex \episemInitium
@funindex \episemFinis
@funindex \ictus
@funindex \semicirculus
@cindex @q{accentus}, articulación gregoriana
@cindex gregoriano, articulación, accentus
@cindex articulación, gregoriano, accentus
@cindex @q{circulus}, articulación gregoriana
@cindex gregoriano, articulación, circulus
@cindex articulación, gregoriano, circulus
@cindex @q{episem initium}, articulación gregoriana
@cindex gregoriano, articulación, episem initium
@cindex articulación, gregoriano, episem initium
@cindex @q{episem finis}, articulación gregoriana
@cindex gregoriano, articulación, episem finis
@cindex articulación, gregoriano, episem finis
@cindex @q{ictus}, articulación gregoriana
@cindex gregoriano, articulación, ictus
@cindex articulación, gregoriano, ictus
@cindex @q{semicirculus}, articulación gregoriana
@cindex gregoriano, articulación, semicirculus
@cindex articulación, gregoriano, semicirculus

@lilypond[quote,ragged-right,verbatim,staffsize=23]
\new VaticanaScore {
  \new VaticanaVoice {
    \override Script.padding = -0.1
    a\ictus_"ictus " \break
    a\circulus_"circulus " \break
    a\semicirculus_"semicirculus " \break
    a\accentus_"accentus " \break
    \[ a_"episema" \episemInitium \pes b
       \flexa a b \episemFinis \flexa a \]
  }
}

\layout {
  indent = 0
  ragged-last = ##t
}
@end lilypond

@morerefs
Referencia de la notación:
@ref{Articulations and ornamentations}.

Fragmentos de código:
@rlsrnamed{Ancient notation,Notación de la música antigua}.

Referencia de funcionamiento interno:
@rinternals{Episema},
@rinternals{EpisemaEvent},
@rinternals{Episema_engraver},
@rinternals{Script},
@rinternals{ScriptEvent},
@rinternals{Script_engraver}.
@endmorerefs

@knownissues
Ciertas articulaciones se colocan demasiado cerca verticalmente de
las cabezas de nota correspondientes.


@node Augmentum dots (morae)
@subsection Puntos de aumentación (@emph{morae})

Los puntos de aumentación, llamados también @emph{morae}, se
escriben con la función musical @code{\augmentum}.  Observe que
@code{\augmentum} está programado como una función musical unaria
y no como un prefijo de cabeza.  Se aplica solamente a la
expresión musical que sigue inmediatamente.  Esto es,
@code{\augmentum \virga c} no tendrá ningún efecto visible.  En su
lugar, escriba @code{\virga \augmentum c} o @code{\augmentum
@{\virga c@}}.  Tenga en cuenta también que puede escribir
@code{\augmentum @{a g@}} como abreviatura de @code{\augmentum a
\augmentum g}.

@lilypond[quote,ragged-right,verbatim,staffsize=23]
\new VaticanaScore {
  \new VaticanaVoice {
    \[ \augmentum a \flexa \augmentum g \]
    \augmentum g
  }
}
@end lilypond

@morerefs
Referencia de la notación:
@ref{Breath marks}.

Referencia de funcionamiento interno:
@rinternals{Divisio}.

Fragmentos de código:
@rlsrnamed{Ancient notation,Notación de la música antigua}.
@endmorerefs


@node Gregorian square neume ligatures
@subsection Ligaduras de neumas cuadrados gregorianos

@cindex ligadura, neumas cuadrados
@cindex cuadrado, ligadura de neuma
@cindex gregoriano, ligadura de neumas

La notación de neumas cuadrados gregorianos está contemplada de
forma limitada (siguiendo el estilo de la Editio Vaticana).  El
núcleo principal del conjunto de las ligaduras ya se pueden
tipografiar, pero aún faltan aspectos esenciales para una
composición tipográfica seria, como (entre otros) la alineación
horizontal de varias ligaduras, la alineación de la letra y un
correcto manejo de las alteraciones accidentales.

Las cabezas de las notas se pueden @emph{modificar} y/o
@emph{unir}.

@itemize

@item
@funindex \virga
@funindex \stropha
@funindex \inclinatum
@funindex \auctum
@funindex \descendens
@funindex \ascendens
@funindex \oriscus
@funindex \quilisma
@funindex \deminutum
@funindex \cavum
@funindex \linea
La forma de la cabeza se puede modificar @emph{precediendo} el
nombre de la nota con una cualquiera de las instrucciones
siguientes:
@code{\virga},
@code{\stropha},
@code{\inclinatum},
@code{\auctum},
@code{\descendens},
@code{\ascendens},
@code{\oriscus},
@code{\quilisma},
@code{\deminutum},
@code{\cavum},
@code{\linea}.

@item
Las ligaduras hablando en propiedad, (es decir, notas unidas), se
producen escribiendo una de las instrucciones de unión @code{\pes}
o @code{\flexa}, para el movimiento ascendente y descendente,
respectivamente, @emph{intercaladas} entre las notas que se han de
unir.
@end itemize

Una nota sin modificaciones produce un @emph{punctum}.  Todos los
demás neumas, incluso los neumas de una nota con forma distinta
como la @emph{virga}, se consideran en principio como ligaduras y
por ello se deben escribir dentro de @code{\[@dots{}\]}.

@subsubheading Neumas de una nota

@itemize
@item El @emph{punctum} es la forma básica de nota (en el estilo
@emph{Vaticana}: un cuadrado con una ligera curvatura a modo de
excelencia tipográfica).  Además del @emph{punctum} normal, están
el @emph{punctum inclinatum}, oblicuo, producido con el prefijo
@code{\inclinatum}.  El @emph{punctum} normal se puede modificar
con @code{\cavum}, que produce una nota vacía, y @code{\linea},
que traza líneas verticales a ambos lados de la nota.

@item La @emph{virga} tiene una plica descendente en el lado derecho.
Se produce mediante el modificador @code{\virga}.
@end itemize

@subsubheading Ligaduras

A diferencia de casi todos los otros sistemas de notación de
neumas, el aspecto tipográfico de las ligaduras no viene dictado
directamente por las instrucciones de la entrada, sino que sigue
unas convenciones que dependen del significado musical.  Por
ejemplo, una ligadura de tres notas con la forma musical
bajo-alto-bajo, como @code{\[ a \pes b \flexa g \]}, produce un
Torculus que consiste en tres cabezas de Punctum, mientras que la
forma alto-bajo-alto, como @code{\[ a \flexa g \pes b \]}, produce
un Porrectus con una forma de flexa curvada y una sola cabeza de
Punctum.  No existe ninguna instrucción para tipografiar
explícitamente la forma de flexa curvada; la decisión de cuándo
tipografiar una forma de flexa curvada está basada en la entrada
musical.  La idea de este enfoque es separar los aspectos
musicales de la entrada, del estilo de notación de la salida.  De
esta forma, la misma entrada se puede reutilizar para tipografiar
la misma música en un estilo diferente de notación de canto
gregoriano.

@subsubheading Neumas licuescentes

Otra categoría fundamental de notas en el canto gregoriano es la
de los llamados neumas licuescentes.  Se utilizan bajo ciertas
circunstancias al final de una sílaba que acaba en una letra
@q{licuescente}, es decir, consonantes sonoras que pueden tener
una altura tonal, (nasales, l, r, v, j, y sus diptongos
equivalentes).  Así, los neumas licuescentes nunca se utilizan
aisladamente (aunque se pueden producir algunos de ellos), y
siempre están al final de una ligadura.

Los neumas licuescentes se representan gráficamente de dos formas
distintas más o menos intercambiables: con una nota pequeña o
@q{girando} la nota principal hacia arriba o hacia abajo.  La
primera forma se produce haciendo un @code{pes} o una @code{flexa}
normales y modificando la forma de la segunda nota: @code{\[ a
\pes \deminutum b \] }, mientras que la segunda se hace
modificando la forma de un neuma de una nota con @code{\auctum} y
uno de los generadores de dirección @code{\descendens} o
@code{\ascendens}, p.ej.  @code{ \[ \auctum \descendens a \] }.

@subsubheading Símbolos especiales

Hay una tercera categoría de símbolos que se hace a partir de un
pequeño número de símbolos que tienen un significado especial
(que, por cierto, casi siempre se conocen solo vagamente): el
@emph{quilisma}, el @emph{oriscus} y el @emph{strophicus}.  Todos
ellos se producen anteponiendo al nombre de la nota el modificador
correspondiente, @code{\quilisma}, @code{\oriscus} o
@code{\stropha}.

Dentro de los delimitadores de ligadura @code{\[} y @code{\]}, se
pueden acumular prácticamente cualquier cantidad de cabezas de
nota para formar una sola ligadura, y los prefijos de cabeza como
@code{\pes}, @code{\flexa}, @code{\virga}, @code{\inclinatum},
etc. se pueden mezclar libremente.  El uso del conjunto de reglas
que subyace a la construcción de ligaduras en la tabla anterior
está consecuentemente extrapolada.  De esta manera se pueden crear
un número infinito de ligaduras distintas.

Observe que el uso de esos símbolos en la propia música sigue
ciertas reglas que LilyPond no comprueba.  P.ej., el
@emph{quilisma} siempre es la nota intermedia de una ligadura
ascendente, y suele caer sobre un intervalo de semitono, pero es
perfectamente posible, si bien incorrecto, hacer un quilisma de
una nota.

@funindex \ij
@funindex \iij
@funindex \IJ
@funindex \IIJ
@funindex \responsum
@funindex \versus

Además de los símbolos de nota, LilyPond define también las
instrucciones @code{\versus}, @code{\responsum}, @code{\ij},
@code{\iij}, @code{\IJ} y @code{\IIJ}, que producen los caracteres
correspondientes, p.ej. para utilizarlos en la letra, como marcas
de sección, etc.  Estas instrucciones utilizan caracteres de
Unicode especiales y solo funcionan si se usa una fuente
tipográfica que los contemple.

@c neume table

La tabla siguiente muestra un conjunto limitado, pero
representativo, de ligaduras gregorianas, junto a los fragmentos
de código que las producen.  La tabla está basada en la tabla de
neumas extendidos del segundo volumen del Antiphonale Romanum
(@emph{Liber Hymnarius}), publicado en 1983 por los monjes de
Solesmes.  La primera columna da el nombre de la ligadura, con la
forma principal en tipo negrita y las formas licuescentes en
cursiva.  La tercera forma muestra el fragmento de código que
produce dicha ligadura, utilizando Sol, La y Si como alturas de
ejemplo.


@subsubheading Neumas de una nota

@need 1000
@indentedblock
@multitable @columnfractions .35 .13 .52

@item
Formas @b{Básica} y @emph{Licuescente}
@tab
@b{Salida}
@tab
@b{Código de LilyPond}

@item
@b{Punctum}
@tab
@lilypond[inline,staffsize=26,line-width=1.5\cm]
\include "neume-demo-layout.ly"
\score {
  \relative {
    % Punctum
    \[ b' \]
  }
\layout { \neumeDemoLayout }}
@end lilypond
@tab
@code{\[ b \]}

@item
@tab
@lilypond[inline,staffsize=26,line-width=1.5\cm]
\include "neume-demo-layout.ly"
\score {
  \relative {
    % Punctum
    \[ \cavum b' \]
  }
\layout { \neumeDemoLayout }}
@end lilypond
@tab
@code{\[ \cavum b \]}

@item
@tab
@lilypond[inline,staffsize=26,line-width=1.5\cm]
\include "neume-demo-layout.ly"
\score {
  \relative {
    % Punctum
    \[ \linea b' \]
  }
\layout { \neumeDemoLayout }}
@end lilypond
@tab
@code{\[ \linea b \]}

@item
@emph{Punctum Auctum Ascendens}
@tab
@lilypond[inline,staffsize=26,line-width=2.5\cm]
\include "neume-demo-layout.ly"
\score {
  \relative {
    % Punctum Auctum Ascendens
    \[ \auctum \ascendens b' \]
  }
\layout { \neumeDemoLayout }}
@end lilypond
@tab
@code{\[ \auctum \ascendens b \]}

@item
@emph{Punctum Auctum Descendens}
@tab
@lilypond[inline,staffsize=26,line-width=2.5\cm]
\include "neume-demo-layout.ly"
\score {
  \relative {
    % Punctum Auctum Descendens
    \[ \auctum \descendens b' \]
  }
\layout { \neumeDemoLayout }}
@end lilypond
@tab
@code{\[ \auctum \descendens b \]}

@item
@b{Punctum inclinatum}
@tab
@lilypond[inline,staffsize=26,line-width=1.5\cm]
\include "neume-demo-layout.ly"
\score {
  \relative {
    % Punctum Inclinatum
    \[ \inclinatum b' \]
  }
\layout { \neumeDemoLayout }}
@end lilypond
@tab
@code{\[ \inclinatum b \]}

@item
@emph{Punctum Inclinatum Auctum}
@tab
@lilypond[inline,staffsize=26,line-width=2.5\cm]
\include "neume-demo-layout.ly"
\score {
  \relative {
    % Punctum Inclinatum Auctum
    \[ \inclinatum \auctum b' \]
  }
\layout { \neumeDemoLayout }}
@end lilypond
@tab
@code{\[ \inclinatum \auctum b \]}

@item
@emph{Punctum Inclinatum Parvum}
@tab
@lilypond[inline,staffsize=26,line-width=1.0\cm]
\include "neume-demo-layout.ly"
\score {
  \relative {
    % Punctum Inclinatum Parvum
    \[ \inclinatum \deminutum b' \]
  }
\layout { \neumeDemoLayout }}
@end lilypond
@tab
@code{\[ \inclinatum \deminutum b \]}

@item
@b{Virga}
@tab
@lilypond[inline,staffsize=26,line-width=1.0\cm]
\include "neume-demo-layout.ly"
\score {
  \relative {
    % Virga
    \[ \virga b' \]
  }
\layout { \neumeDemoLayout }}
@end lilypond
@tab
@code{\[ \virga b' \]}

@end multitable
@end indentedblock


@subsubheading Ligaduras de dos notas

@need 1000
@indentedblock
@multitable @columnfractions .35 .13 .52

@item
@b{Clivis vel Flexa}
@tab
@lilypond[inline,staffsize=26,line-width=1.0\cm]
\include "neume-demo-layout.ly"
\score {
  \relative {
    % Clivis vel Flexa
    \[ b' \flexa g \]
  }
\layout { \neumeDemoLayout }}
@end lilypond
@tab
@code{\[ b \flexa g \]}

@item
@emph{Clivis Aucta Descendens}
@tab
@lilypond[inline,staffsize=26,line-width=2.0\cm]
\include "neume-demo-layout.ly"
\score {
  \relative {
    % Clivis Aucta Descendens
    \[ b' \flexa \auctum \descendens g \]
  }
\layout { \neumeDemoLayout }}
@end lilypond
@tab
@code{\[ b \flexa \auctum \descendens g \]}

@item
@emph{Clivis Aucta Ascendens}
@tab
@lilypond[inline,staffsize=26,line-width=2.0\cm]
\include "neume-demo-layout.ly"
\score {
  \relative {
    % Clivis Aucta Ascendens
    \[ b' \flexa \auctum \ascendens g \]
  }
\layout { \neumeDemoLayout }}
@end lilypond
@tab
@code{\[ b \flexa \auctum \ascendens g \]}

@item
@emph{Cephalicus}
@tab
@lilypond[inline,staffsize=26,line-width=2.0\cm]
\include "neume-demo-layout.ly"
\score {
  \relative {
    % Cephalicus
    \[ b' \flexa \deminutum g \]
  }
\layout { \neumeDemoLayout }}
@end lilypond
@tab
@code{\[ b \flexa \deminutum g \]}

@item
@b{Podatus o Pes}
@tab
@lilypond[inline,staffsize=26,line-width=1.0\cm]
\include "neume-demo-layout.ly"
\score {
  \relative {
    % Podatus vel Pes
    \[ g' \pes b \]
  }
\layout { \neumeDemoLayout }}
@end lilypond
@tab
@code{\[ g \pes b \]}

@item
@emph{Pes Auctus Descendens}
@tab
@lilypond[inline,staffsize=26,line-width=1.0\cm]
\include "neume-demo-layout.ly"
\score {
  \relative {
    % Pes Auctus Descendens
    \[ g' \pes \auctum \descendens b \]
  }
\layout { \neumeDemoLayout }}
@end lilypond
@tab
@code{\[ g \pes \auctum \descendens b \]}

@item
@emph{Pes Auctus Ascendens}
@tab
@lilypond[inline,staffsize=26,line-width=1.0\cm]
\include "neume-demo-layout.ly"
\score {
  \relative {
    % Pes Auctus Ascendens
    \[ g' \pes \auctum \ascendens b \]
  }
\layout { \neumeDemoLayout }}
@end lilypond
@tab
@code{\[ g \pes \auctum \ascendens b \]}

@item
@emph{Epiphonus}
@tab
@lilypond[inline,staffsize=26,line-width=1.0\cm]
\include "neume-demo-layout.ly"
\score {
  \relative {
    % Epiphonus
    \[ g' \pes \deminutum b \]
  }
\layout { \neumeDemoLayout }}
@end lilypond
@tab
@code{\[ g \pes \deminutum b \]}

@item
@emph{Pes Initio Debilis}
@tab
@lilypond[inline,staffsize=26,line-width=1.0\cm]
\include "neume-demo-layout.ly"
\score {
  \relative {
    % Pes Initio Debilis
    \[ \deminutum g' \pes b \]
  }
\layout { \neumeDemoLayout }}
@end lilypond
@tab
@code{\[ \deminutum g \pes b \]}

@item
@emph{Pes Auctus Descendens@*
Initio Debilis}
@tab
@lilypond[inline,staffsize=26,line-width=1.0\cm]
\include "neume-demo-layout.ly"
\score {
  \relative {
    % Pes Auctus Descendens Initio Debilis
    \[ \deminutum g' \pes \auctum \descendens b \]
  }
\layout { \neumeDemoLayout }}
@end lilypond
@tab
@code{\[ \deminutum g \pes \auctum@*
\descendens b \]}

@end multitable
@end indentedblock


@subsubheading Ligaduras de varias notas

@need 1000
@indentedblock
@multitable @columnfractions .35 .13 .52

@item
@b{Torculus}
@tab
@lilypond[inline,staffsize=26,line-width=1.0\cm]
\include "neume-demo-layout.ly"
\score {
  \relative {
    % Torculus
    \[ a' \pes b \flexa g \]
  }
\layout { \neumeDemoLayout }}
@end lilypond
@tab
@code{\[ a \pes b \flexa g \]}

@item
@emph{Torculus Auctus Descendens}
@tab
@lilypond[inline,staffsize=26,line-width=1.0\cm]
\include "neume-demo-layout.ly"
\score {
  \relative {
    % Torculus Auctus Descendens
    \[ a' \pes b \flexa \auctum \descendens g \]
  }
\layout { \neumeDemoLayout }}
@end lilypond
@tab
@code{\[ a \pes b \flexa \auctum@*
\descendens g \]}

@item
@emph{Torculus Deminutus}
@tab
@lilypond[inline,staffsize=26,line-width=1.0\cm]
\include "neume-demo-layout.ly"
\score {
  \relative {
    % Torculus Deminutus
    \[ a' \pes b \flexa \deminutum g \]
  }
\layout { \neumeDemoLayout }}
@end lilypond
@tab
@code{\[ a \pes b \flexa \deminutum g \]}

@item
@emph{Torculus Initio Debilis}
@tab
@lilypond[inline,staffsize=26,line-width=1.0\cm]
\include "neume-demo-layout.ly"
\score {
  \relative {
    % Torculus Initio Debilis
    \[ \deminutum a' \pes b \flexa g \]
  }
\layout { \neumeDemoLayout }}
@end lilypond
@tab
@code{\[ \deminutum a \pes b \flexa g \]}

@item
@emph{Torculus Auctus Descendens@*
Initio Debilis}
@tab
@lilypond[inline,staffsize=26,line-width=1.0\cm]
\include "neume-demo-layout.ly"
\score {
  \relative {
    % Torculus Auctus Descendens Initio Debilis
    \[ \deminutum a' \pes b \flexa \auctum \descendens g \]
  }
\layout { \neumeDemoLayout }}
@end lilypond
@tab
@code{\[ \deminutum a \pes b \flexa \auctum@*
\descendens g \]}

@item
@emph{Torculus Deminutus@*
Initio Debilis}
@tab
@lilypond[inline,staffsize=26,line-width=1.0\cm]
\include "neume-demo-layout.ly"
\score {
  \relative {
    % Torculus Deminutus Initio Debilis
    \[ \deminutum a' \pes b \flexa \deminutum g \]
  }
\layout { \neumeDemoLayout }}
@end lilypond
@tab
@code{\[ \deminutum a \pes b \flexa@*
\deminutum g \]}

@item
@b{Porrectus}
@tab
@lilypond[inline,staffsize=26,line-width=1.0\cm]
\include "neume-demo-layout.ly"
\score {
  \relative {
    % Porrectus
    \[ a' \flexa g \pes b \]
  }
\layout { \neumeDemoLayout }}
@end lilypond
@tab
@code{\[ a \flexa g \pes b \]}

@item
@emph{Porrectus Auctus Descendens}
@tab
@lilypond[inline,staffsize=26,line-width=1.0\cm]
\include "neume-demo-layout.ly"
\score {
  \relative {
    % Porrectus Auctus Descendens
    \[ a' \flexa g \pes \auctum \descendens b \]
  }
\layout { \neumeDemoLayout }}
@end lilypond
@tab
@code{\[ a \flexa g \pes \auctum@*
\descendens b \]}

@item
@emph{Porrectus Deminutus}
@tab
@lilypond[inline,staffsize=26,line-width=1.0\cm]
\include "neume-demo-layout.ly"
\score {
  \relative {
    % Porrectus Deminutus
    \[ a' \flexa g \pes \deminutum b \]
  }
\layout { \neumeDemoLayout }}
@end lilypond
@tab
@code{\[ a \flexa g \pes \deminutum b \]}

@item
@b{Climacus}
@tab
@lilypond[inline,staffsize=26,line-width=1.0\cm]
\include "neume-demo-layout.ly"
\score {
  \relative {
    % Climacus
    \[ \virga b' \inclinatum a \inclinatum g \]
  }
\layout { \neumeDemoLayout }}
@end lilypond
@tab
@code{\[ \virga b \inclinatum a@*
\inclinatum g \]}

@item
@emph{Climacus Auctus}
@tab
@lilypond[inline,staffsize=26,line-width=1.0\cm]
\include "neume-demo-layout.ly"
\score {
  \relative {
    % Climacus Auctus
    \[ \virga b' \inclinatum a \inclinatum \auctum g \]
  }
\layout { \neumeDemoLayout }}
@end lilypond
@tab
@code{\[ \virga b \inclinatum a@*
\inclinatum \auctum g \]}

@item
@emph{Climacus Deminutus}
@tab
@lilypond[inline,staffsize=26,line-width=1.0\cm]
\include "neume-demo-layout.ly"
\score {
  \relative {
    % Climacus Deminutus
    \[ \virga b' \inclinatum a \inclinatum \deminutum g \]
  }
\layout { \neumeDemoLayout }}
@end lilypond
@tab
@code{\[ \virga b \inclinatum a@*
\inclinatum \deminutum g \]}

@item
@b{Scandicus}
@tab
@lilypond[inline,staffsize=26,line-width=1.0\cm]
\include "neume-demo-layout.ly"
\score {
  \relative {
    % Scandicus
    \[ g' \pes a \virga b \]
  }
\layout { \neumeDemoLayout }}
@end lilypond
@tab
@code{\[ g \pes a \virga b \]}

@item
@emph{Scandicus Auctus Descendens}
@tab
@lilypond[inline,staffsize=26,line-width=1.0\cm]
\include "neume-demo-layout.ly"
\score {
  \relative {
    % Scandicus Auctus Descendens
    \[ g' \pes a \pes \auctum \descendens b \]
  }
\layout { \neumeDemoLayout }}
@end lilypond
@tab
@code{\[ g \pes a \pes@*
\auctum \descendens b \]}

@item
@emph{Scandicus Deminutus}
@tab
@lilypond[inline,staffsize=26,line-width=1.0\cm]
\include "neume-demo-layout.ly"
\score {
  \relative {
    % Scandicus Deminutus
    \[ g' \pes a \pes \deminutum b \]
  }
\layout { \neumeDemoLayout }}
@end lilypond
@tab
@code{\[ g \pes a \pes \deminutum b \]}

@end multitable
@end indentedblock


@subsubheading Símbolos especiales

@need 1000
@indentedblock
@multitable @columnfractions .35 .13 .52

@item
@b{Quilisma}
@tab
@lilypond[inline,staffsize=26,line-width=1.0\cm]
\include "neume-demo-layout.ly"
\score {
  \relative {
    % Quilisma
    \[ g' \pes \quilisma a \pes b \]
  }
\layout { \neumeDemoLayout }}
@end lilypond
@tab
@code{\[ g \pes \quilisma a \pes b \]}

@item
@emph{Quilisma Pes Auctus Descendens}
@tab
@lilypond[inline,staffsize=26,line-width=1.0\cm]
\include "neume-demo-layout.ly"
\score {
  \relative {
    % Quilisma Pes Auctus Descendens
    \[ g' \quilisma a \pes \auctum \descendens b \]
  }
\layout { \neumeDemoLayout }}
@end lilypond
@tab
@code{\[ g \quilisma a \pes \auctum@*
\descendens b \]}

@item
@b{Oriscus}
@tab
@lilypond[inline,staffsize=26,line-width=1.0\cm]
\include "neume-demo-layout.ly"
\score {
  \relative {
    % Oriscus
    \[ \oriscus b' \]
  }
\layout { \neumeDemoLayout }}
@end lilypond
@tab
@code{\[ \oriscus b \]}

@item
@emph{Pes Quassus}
@tab
@lilypond[inline,staffsize=26,line-width=1.0\cm]
\include "neume-demo-layout.ly"
\score {
  \relative {
    % Pes Quassus
    \[ \oriscus g' \pes \virga b \]
  }
\layout { \neumeDemoLayout }}
@end lilypond
@tab
@code{\[ \oriscus g \pes \virga b \]}

@item
@emph{Pes Quassus Auctus Descendens}
@tab
@lilypond[inline,staffsize=26,line-width=1.0\cm]
\include "neume-demo-layout.ly"
\score {
  \relative {
    % Pes Quassus Auctus Descendens
    \[ \oriscus g' \pes \auctum \descendens b \]
  }
\layout { \neumeDemoLayout }}
@end lilypond
@tab
@code{\[ \oriscus g \pes \auctum@*
\descendens b \]}

@item
@b{Salicus}
@tab
@lilypond[inline,staffsize=26,line-width=1.0\cm]
\include "neume-demo-layout.ly"
\score {
  \relative {
    % Salicus
    \[ g' \oriscus a \pes \virga b \]
  }
\layout { \neumeDemoLayout }}
@end lilypond
@tab
@code{\[ g \oriscus a \pes \virga b \]}

@item
@emph{Salicus Auctus Descendens}
@tab
@lilypond[inline,staffsize=26,line-width=1.0\cm]
\include "neume-demo-layout.ly"
\score {
  \relative {
    % Salicus Auctus Descendens
    \[ g' \oriscus a \pes \auctum \descendens b \]
  }
\layout { \neumeDemoLayout }}
@end lilypond
@tab
@code{\[ g \oriscus a \pes \auctum@*
\descendens b \]}

@item
@b{(Apo)stropha}
@tab
@lilypond[inline,staffsize=26,line-width=1.0\cm]
\include "neume-demo-layout.ly"
\score {
  \relative {
    % Stropha
    \[ \stropha b' \]
  }
\layout { \neumeDemoLayout }}
@end lilypond
@tab
@code{\[ \stropha b \]}

@item
@emph{Stropha Aucta}
@tab
@lilypond[inline,staffsize=26,line-width=1.0\cm]
\include "neume-demo-layout.ly"
\score {
  \relative {
    % Stropha Aucta
    \[ \stropha \auctum b' \]
  }
\layout { \neumeDemoLayout }}
@end lilypond
@tab
@code{\[ \stropha \auctum b \]}

@item
@b{Bistropha}
@tab
@lilypond[inline,staffsize=26,line-width=1.0\cm]
\include "neume-demo-layout.ly"
\score {
  \relative {
    % Bistropha
    \[ \stropha b' \stropha b \]
  }
\layout { \neumeDemoLayout }}
@end lilypond
@tab
@code{\[ \stropha b \stropha b \]}

@item
@b{Tristropha}
@tab
@lilypond[inline,staffsize=26,line-width=1.0\cm]
\include "neume-demo-layout.ly"
\score {
  \relative {
    % Tristropha
    \[ \stropha b' \stropha b \stropha b \]
  }
\layout { \neumeDemoLayout }}
@end lilypond
@tab
@code{\[ \stropha b \stropha b@*
\stropha b \]}

@item
@emph{Trigonus}
@tab
@lilypond[inline,staffsize=26,line-width=1.0\cm]
\include "neume-demo-layout.ly"
\score {
  \relative {
    % Trigonus
    \[ \stropha b' \stropha b \stropha a \]
  }
\layout { \neumeDemoLayout }}
@end lilypond
@tab
@code{\[ \stropha b \stropha b@*
\stropha a \]}

@end multitable
@end indentedblock

@predefined
@funindex \virga
@funindex \stropha
@funindex \inclinatum
@funindex \auctum
@funindex \descendens
@funindex \ascendens
@funindex \oriscus
@funindex \quilisma
@funindex \deminutum
@funindex \cavum
@funindex \linea

Están contemplados los siguientes prefijos de cabeza:
@code{\virga},
@code{\stropha},
@code{\inclinatum},
@code{\auctum},
@code{\descendens},
@code{\ascendens},
@code{\oriscus},
@code{\quilisma},
@code{\deminutum},
@code{\cavum},
@code{\linea}.
@endpredefined

Se pueden acumular los prefijos de cabeza, aunque con ciertas
restricciones.  Por ejemplo, se pueden aplicar @code{\descendens}
o @code{\ascendens} a una cabeza, pero no los dos a la misma
cabeza.

@funindex \pes
@funindex \flexa

Se pueden ligar dos cabezas adyacentes con las instrucciones
infijas @code{\pes} y @code{\flexa} para una línea melódica
ascendente y descendente, respectivamente.

@funindex \augmentum

Utilice la función musical unaria @code{\augmentum} para añadir
puntos de augmentum.

@morerefs
Glosario musical:
@rglos{ligature}.

Referencia de la notación:
@ref{Gregorian square neume ligatures},
@ref{White mensural ligatures},
@ref{Ligatures}.
@endmorerefs

@knownissues
Cuando aparece un punto de @code{\augmentum} al final de la última
pauta dentro de una ligadura, a veces se posiciona defectuosamente
en el sentido vertical.  Para rodear el problema, escriba una nota
adicional de salto (p.ej. @code{s8}) como última nota de la pauta.

@code{\augmentum} debería estar implementado como un prefijo de
cabeza en vez de una función musical unaria, de forma que
@code{\augmentum} se pudiera entremezclar con los prefijos de
cabeza en un orden arbitrario.


@need 1500
@node Typesetting Kievan square notation
@section Tipografiado del canto kievano en notación cuadrada


@node Kievan contexts
@subsection Contextos del canto kievano

@funindex KievanVoice
@funindex KievanStaff

De la misma manera que con las notaciones mensural y gregoriana,
pueden usarse los contextos predefinidos @code{KievanVoice} y
@code{KievanStaff} para tipografiar una pieza en notación
cuadrada.  Estos contextos inician todas las propiedades de
contexto necesarias a sus valores adecuados, de manera que pueda
ponerse manos a la obra inmediatamente con la introducción del
propio canto:

@lilypond[quote,ragged-right,verbatim]
% Font settings for Cyrillic
\paper {
  property-defaults.fonts.serif = "Linux Libertine O,serif"
}

\score {
  <<
    \new KievanVoice = "melody" \relative c' {
      c4 c c c c2 b\longa \fine
    }
    \new Lyrics \lyricsto "melody" {
      Го -- спо -- ди по -- ми -- луй.
    }
  >>
}
@end lilypond

@morerefs
Glosario musical:
@rglos{Kievan notation}.
@endmorerefs

@knownissues
LilyPond contempla la notación del canto kievano en el estilo
sinodal, tal y como se usa en los cantorales impresos por el Sacro
Sínodo Ruso en la década de 1910 y recientemenre reimpreso por la
Casa de Publicaciones del Patriarcado de Moscú.  LilyPond no
contempla las formas anteriores (menos corrientes) de notación
kievana que se usaban en Galitzia para la notación del canto llano
ruteno.

@node Kievan clefs
@subsection Claves del canto kievano

@cindex clave

En la notación kievana solamente se utiliza una clave (la clave
Tse-fa-ut).  Se utiliza para indicar la posición del Do:

@lilypond[quote,fragment,notime,verbatim]
  \clef "kievan-do"
  \kievanOn
  c'
@end lilypond

@morerefs
Glosario musical:
@rglos{Kievan notation},
@rglos{clef}.

Referencia de la notación:
@ref{Clef}.
@endmorerefs


@node Kievan notes
@subsection Notas del canto kievano

@cindex cabezas de nota antiguas

@funindex \kievanOn
@funindex \kievanOff

Para la notación cuadrada del canto kievano, debe escogerse el
estilo apropiado para la forma de la cabeza de las notas y se
deben suprimir los corchetes y las plicas.  Esto se consigue
mediante una llamada a la función @code{\kievanOn}, que establece
las propiedades adecuadas para la cabeza, plica y corchete de las
notas.  Una vez que las notas de estilo kievano ya no se
necesiten, pueden revertirse estas propiedades llamando a la
función @code{\kievanOff}.

La nota final del canto kievano, que suele ir al final de una
pieza musical, puede seleccionarse estableciendo la duración al
valor @code{\longa}.  La marca kievana de recitativo, utilizada
para indicar la entonación de varias sílabas sobre una sola nota,
se puede seleccionar estableciendo la duración al valor
@code{\breve}.  El siguiente ejemplo muestra las diversas formas
de la cabeza de las notas del canto kievano:

@lilypond[quote,fragment,ragged-right,verbatim]
\cadenzaOn
\kievanOn
b'1 b'2 b'4 b'8 b'\breve b'\longa
\kievanOff
b'2
@end lilypond

@morerefs
Glosario musical:
@rglos{Kievan notation},
@rglos{note head}.

Referencia de la notación:
@ref{Note head styles}.
@endmorerefs

@knownissues
LilyPond determina de forma automática si debe trazarse la forma
de una nota con la plica hacia arriba o hacia abajo.  Sin embargo,
cuando se está tipografiando un canto en notación cuadrada, es
preceptivo que las plicas estén orientadas en la misma dirección
dentro de un melisma.  Esto puede hacerse manualmente fijando la
propiedad @code{direction} del objeto @code{Stem}.

@node Kievan accidentals
@subsection Alteraciones accidentales del canto kievano

@cindex alteraciones kievanas
@cindex kievano, alteraciones de

El estilo @code{kievan} para las alteraciones accidentales se
selecciona con la propiedad @code{alteration-glyph-name-alist} del
grob @code{Accidental}.  El estilo @code{kievan} provee unos
signos de sostenido y de bemol diferentes del estilo
predeterminado.  No esiste el becuadro en la notación kievana.  El
símbolo del sostenido no se utiliza en la música sinodal pero
puede aparecer en manuscritos más antiguos.  Se ha incluido
principalmente a efectos de compatibilidad.

@lilypond[quote,fragment,notime,verbatim]
\clef "kievan-do"
\set Staff.alterationGlyphs =
  #alteration-kievan-glyph-name-alist
bes' dis'
@end lilypond

@morerefs
Glosario musical:
@rglos{Kievan notation},
@rglos{accidental}.

Referencia de la notación:
@ref{Accidentals},
@ref{Automatic accidentals},
@ref{Alternate accidental glyphs},
@ref{The Emmentaler font}.
@endmorerefs


@node Kievan bar lines
@subsection Líneas divisorias del canto kievano

@funindex \caesura
@funindex \fine
@funindex \section
@cindex barra de compás, en canto kievano
@cindex caesura, barra de compás, en canto kievano
@cindex final, barra de compás, en canto kievano
@cindex frase, barra de compás, en canto kievano
@cindex sección, barra de compás, en canto kievano

En una pauta del tipo @code{KievanStaff} no hay compases, pero la
instrucción @code{\caesura} crea una barra de frase, y las
instrucciones @code{\section} y @code{\fine} crean una barra
especial de sección.

@lilypond[quote,verbatim]
\new KievanStaff {
  c'4 4 4 4 4 4 \caesura  % \bar "."
  d'4 4 4 4 4 4 \section  % \bar "k"
  e'4 4 4 4 4 4 \fine
}
@end lilypond

@morerefs
Referencia de la notación:
@ref{Bars},
@ref{The Emmentaler font}.
@endmorerefs


@node Kievan melismata
@subsection Melismas del canto kievano

@cindex ligaduras kievanas
@cindex kievano, ligaduras de

Las notas que están dentro de un melisma del canto kievano se
suelen colocar a poca distancia entre sí y cada melisma está
separado de los demás por un espacio vacío.  Esto se hace para
permitir al cantor la identificación rápida de las estructuras
melódicas del @emph{canto Znamenny}.  En LilyPond, los melismas se
tratan como ligaduras y el especiado está implementado por el
grabador @code{Kievan_ligature_engraver}.

@funindex Ligature_bracket_engraver
@funindex Kievan_ligature_engraver

Cuando se usan los contextos @code{KievanVoice} y
@code{KievanStaff}, se habilita el grabador
@code{Kievan_@/ligature_@/engraver} de forma predeterminada.  En
otros contextos, se puede invocar sustituyendo el grabador
@code{Ligature_@/bracket_@/engraver} por
@code{Kievan_@/ligature_@/engraver} en el bloque layout:

@example
\layout @{
  \context @{
    \Voice
    \remove Ligature_bracket_engraver
    \consists Kievan_ligature_engraver
  @}
@}
@end example

El espaciado entre las notas que están dentro de una misma
ligadura kievana puede controlatse estableciendo la propiedad
@code{padding} de @code{KievanLigature}.

El ejemplo siguiente muestra el uso de las ligaduras del canto
kievano:

@lilypond[quote,ragged-right,verbatim]
% Font settings for Cyrillic
\paper {
  property-defaults.fonts.serif = "Linux Libertine O,serif"
}

\score {
  <<
    \new KievanVoice = "melody" \relative c' {
      e2 \[ e4( d4 ) \] \[ c4( d e d) \] e1 \fine
    }
    \new Lyrics \lyricsto "melody" {
      Га -- врі -- и -- лу
    }
  >>
}
@end lilypond

@morerefs
Glosario musical:
@rglos{ligature}.

Referencia de la notación:
@ref{White mensural ligatures},
@ref{Gregorian square neume ligatures},
@ref{Ligatures}.
@endmorerefs

@knownissues
El espaciado horizontal de las ligaduras es mediocre.

@node Working with ancient music - scenarios and solutions
@section Trabajar con música antigua: escenarios y soluciones

El trabajo con música antigua implica con frecuencia tareas
adicionales que difieren considerablemente de la notación moderna
para la que se diseñó LilyPond.  En el resto de esta sección se
perfilan unos cuantos escenarios típicos, con sugerencias de
soluciones.  Entre ellos están los siguientes:

@itemize
@item cómo hacer incipits
(o sea, material a modo de prefacio que indica cómo era el
original) a las transcripciones modernas de música mensural;
@item cómo conseguir el diseño @emph{Mensurstriche}
que se usa con frecuencia para las transcripciones modernas de música
polifónica;
@item cómo transcribir canto gregoriano en notación moderna;
@item cómo generar notación antigua y moderna a partir de la misma fuente.
@end itemize


@node Incipits
@subsection Incipits
@funindex \incipit
@cindex incipit, añadir

Al transcribir música mensural a la notación moderna, es costumbre
poner una indicación de la forma en que aparecían en la versión
original los silencios y la nota o notas iniciales (incluso con
las claves originales).  Esto recibe el nombre de @emph{incipit}.
La instrucción @code{\incipit} usa el valor de @code{indent} del
pentagrama principal para fijar el espacio horizontal que ocupa el
incipit junto al nombre del instrumento, y @code{incipit-width}
para establecer la anchura del pentagrama del propio incipit.  Un
argumento opcional indica cuánto debe desplazarse el incipit hacia
la izquierda.

@lilypond[verbatim,quote,ragged-right]
\score {
  \new Staff <<
    \new Voice = Tenor {
      \set Staff.instrumentName = "Tenor"
      \override Staff.InstrumentName.self-alignment-X = #RIGHT
      \incipit #1 { \clef "mensural-c4" \key f \major r\breve r1 c'1 }
      \clef "treble_8"
      \key f \major
      R1 r2 c'2 |
      a4. c'8
    }
    \new Lyrics \lyricsto Tenor { Cyn -- thia your }
  >>
  \layout
  {
    indent = 5\cm
    incipit-width = 3\cm
  }
}
@end lilypond

By default, LilyPond uses a @samp{MensuralStaff} context for
typesetting an incipit.  Other contexts can be used by directly
writing @code{\incipit \new @var{contexttype} @dots{}}; in this
case a @samp{MensuralStaff} wrapper is only used when it can
contain the specified context.

@knownissues
Observe que se debe configurar el contenido de
@code{instrumentName} dentro de la música, para que aparezca el
incipit.  Si no quiere que aparezca ningún nombre para el
instrumento, utilice @code{\set Staff.instrumentName = ""}.

@c @morerefs
@c ... and reference to other sections ...
@c @endmorerefs


@node Mensurstriche layout
@subsection Disposición tipo «Mensurstriche»

@cindex Mensurstriche

@emph{Mensurstriche} (@q{líneas de mensuración}) es el término
aceptado para las barras de compás que se trazan entre los
pentagramas de un sistema pero no dentro de los propios
pentagramas.  Es una forma común de preservar el aspecto visual de
las duraciones del original, es decir, sin tener que dividir las
notas sincopadas en las barras de compás, y al mismo tiempo
ofrecer la ayuda orientativa que proporcionan las barras de
compás.


@lilypondfile[verbatim,quote,texidoc]
{snippets/mensurstriche-layout-bar-lines-between-the-staves.ly}

@c This simple setup will take care of the
@c TODO Add text about lyrics to the lowest line, to be placed
@c outside the StaffGroup.
@c from LilyPond Wiki and -user
@c TBC

@c @morerefs
@c ... and reference to other sections ...
@c @endmorerefs


@node Transcribing Gregorian chant
@subsection Transcripción de canto gregoriano

El canto gregoriano se puede transcribir a notación moderna con
ciertos trucos sencillos.

@b{Plicas}.  Todas las plicas se pueden eliminar de una vez retirando
el grabador @code{Stem_engraver} del contexto de voz:

@example
\layout @{
  @dots{}
  \context @{
    \Voice
    \remove Stem_engraver
  @}
@}
@end example

@b{Compás}.  Para el canto no medido, existen diversas alternativas.

Se puede eliminar el grabador Time_signature_engraver del contexto
de Staff sin ningún efecto secundario negativo.  La alternativa,
que es hacer transparente la indicación de compás, deja un espacio
en blanco en la partitura, pues la indicación invisible sigue
ocupando un espacio.

En muchos casos da un buen resultado @code{\set Score.timing =
##f}.  Otra alternativa es utilizar @code{\cadenzaOn} y
@code{\cadenzaOff}.

Para quitar las barras de compás, el enfoque radical consiste en
retirar (mediante la instrucción @code{\remove}) el grabador
Bar_engraver del contexto de pentagrama Staff.  Una vez más, en
vez de ello podemos usar @code{\hide BarLine} si se necesita
ocasionalmente una barra de compás.

Los contextos de pauta predefinidos para música antigua permiten
saltos de línea sin barras de compás.  Se puede extender este
comportamiento al resto de los contextos con @code{\set
Score@/.forbidBreakBetweenBarLines = ##f} o a pautas específicas
con @code{\set Staff@/.forbidBreakBetweenBarLines = ##f}.

Un tipo de transcripción muy común es el canto de recitativo, en
el que la nota repetida se indica con una breve.  Se puede tratar
el texto del tono de recitativo de dos maneras.  Podemos ponerlo
como una sola sílaba alineada por la izquierda:

@lilypond[quote,verbatim,ragged-right]
chant = \relative {
  \clef "G_8"
  c'\breve c4 b4 a c2 c4 \divisioMaior
  c\breve c4 c f, f \finalis
}

words = \lyricmode {
  \tweak self-alignment-X #LEFT "Noctem quietam et"
    fi -- nem per -- fec -- tum
  \tweak self-alignment-X #LEFT "concedat nobis Dominus"
    om -- ni -- po -- tens.
}

\score {
  \new GregorianTranscriptionStaff <<
    \new GregorianTranscriptionVoice = "melody" {
      \chant
    }
    \new GregorianTranscriptionLyrics = "one" {
      \lyricsto "melody" \words
    }
  >>
}
@end lilypond

Esto funciona bien en la medida en que el texto no comprenda un
salto de línea.  Si es el caso, una alternativa sería añadir notas
ocultas a la partitura, en combinación con cambios en la
visibilidad de las plicas:

En ciertos estilos de transcripción, se usan plicas de forma
ocasional, por ejemplo para indicar la transición a partir de un
recitativo monotónico a un gesto melódico fijo.  En estos casos
podemos usar el grabador @code{Stem_engraver} y hacer manualmente
@code{\omit Stem} y @code{\undo \omit Stem}.

@lilypond[quote,verbatim,ragged-right]
chant = \relative {
  \clef "G_8"
  \omit Stem
  \omit Flag
  c'\breve*1/16 \hide NoteHead c8 c c c c
  \undo \hide NoteHead
  \undo \omit Stem \stemUp c4 b4 a
  \omit Stem c2 c4 \divisioMaior
  c\breve*1/16 \hide NoteHead c8 c c c c c c
  \undo \hide NoteHead c4 c f, f \finalis
}

verba = \lyricmode {
  No -- ctem qui -- e -- tam et fi -- nem per -- fec -- tum
  con -- ce -- dat no -- bis Do -- mi -- nus om -- ni -- po -- tens.
}

\score {
  \new GregorianTranscriptionStaff <<
    \new GregorianTranscriptionVoice = "melody" {
      \chant
    }
    \new GregorianTranscriptionLyrics = "one" {
      \lyricsto "melody" \verba
    }
  >>
  \layout {
    \context {
      \GregorianTranscriptionVoice
      \consists Stem_engraver
    }
  }
}
@end lilypond

Otra situación común es la transcripción de cantos neumáticos o
melismáticos, es decir, cantos con un número variable de notas en
cada sílaba.  En este caso, podemos establecer los grupos de
sílabas claramente separados, normalmente también las
subdivisiones de un melisma mayor.  Una forma de conseguirlo es
usar un @code{\time} fijo, p.ej. 1/4, y dejar que cada sílaba o
grupo de notas llene uno de esos compases, con la ayuda de grupos
de valoración especial o duraciones más breves.  Si las líneas
divisorias y todas las demás indicaciones rítmicas se hacen
transparentes, y el espacio que rodea las líneas divisorias se
aumenta, ello proporciona una aceptable representación del
original, en notación moderna.

Para evitar que las sílabas de distinta anchura (como @qq{-ri} y
@qq{-rum}) dispongan los grupos de notas de las sílabas de forma
irregular, se puede ajustar la propiedad @code{'X-extent} del
objeto @code{LyricText} a un valor fijo.  Otra forma más engorrosa
sería añadir las sílabas como elementos de @code{\markup}.  Si se
necesitan más ajustes posteriormente, esto se puede hacer
fácilmente con @q{notas} @code{s}.

@c In this example, hyphens stick out to the right, so we reduce
@c the line width a little bit to avoid an overfull box in the
@c PDF.
@lilypond[verbatim,quote,line-width=159\mm]
spiritus = \relative {
  \time 1/4
  d'4 \tuplet 3/2 { f8 a g } g a a4 g f8 e
  d4 f8 g g8 d f g a g f4 g8 a a4 s
  \tuplet 3/2 { g8 f d } e f g a g4
}

spirLyr = \lyricmode {
  \override Lyrics.LyricText.X-extent  = #'(0 . 3)
  Spi -- ri -- _ _ tus _ Do -- mi -- ni _
  re -- ple -- _ vit _ or -- _ bem _ ter -- ra -- _ rum,
  al -- _ _ le -- _ lu -- _ ia.
}
\score {
  \new GregorianTranscriptionStaff <<
    \new GregorianTranscriptionVoice = "chant" {
      \spiritus
    }
    \new GregorianTranscriptionLyrics = "one" {
      \lyricsto "chant" \spirLyr
    }
  >>
  \layout {
    \context {
      \GregorianTranscriptionStaff
      measureBarType = ""
      \override BarLine.X-extent = #'(-1 . 1)
      \hide TupletNumber
      \hide TupletBracket
    }
  }
}
@end lilypond

@c extract from 1.6.1.1

@c @morerefs
@c ... and reference to other sections ...
@c @endmorerefs


@node Ancient and modern from one source
@subsection Antigua y moderna desde la misma fuente

@funindex Completion_heads_engraver
@funindex Completion_rest_engraver

@cindex transcripción de mensural a moderno
@lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
{snippets/using-tags-to-produce-mensural-and-modern-music-from-the-same-source.ly}
