@c -*- coding: utf-8; mode: texinfo; -*-
@ignore
    Translation of GIT committish: 98ae4afd530d6a059a81356119d8138ed25b2650

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

@node Editorial annotations
@section Editorial annotations

@lilypondfile[ragged-right,line-width=16\cm,staffsize=16,quote]
{editorial-headword.ly}

@menu
* Inside the staff::            
* Outside the staff::           
@end menu


@node Inside the staff
@subsection Inside the staff


@menu
* Selecting notation font size::  
* Fingering instructions::      
* Hidden notes::                
* Coloring objects::            
* Parentheses::                 
* Stems::                       
@end menu

@node Selecting notation font size
@subsubsection Selecting notation font size

UNTRANSLATED NODE: IGNORE ME


@node Fingering instructions
@subsubsection Fingering instructions

@cindex digitación
@cindex cambio de dedo

Las instrucciones de digitación se pueden introducir usando
@example
@var{nota}-@var{dígito}
@end example
Para los cambios de dedo, utilice marcas de texto.

@lilypond[quote,verbatim,ragged-right,fragment,relative=1]
c4-1 c-2 c-3 c-4
c^\markup { \finger "2 - 3" }
@end lilypond

Puede usar la articulación de pulgar para indicar que una nota se debe tocar con el pulgar
(p.ej. en música de cello)
@lilypond[quote,verbatim,ragged-right,fragment,relative=2]
<a_\thumb a'-3>8 <b_\thumb b'-3>
@end lilypond

Las digitaciones para los acordes también se pueden añadir a las notas individuales del acorde
escribiéndolas después de las alturas
@lilypond[quote,verbatim,ragged-right,fragment,relative=2]
< c-1 e-2 g-3 b-5 >4
@end lilypond


@commonprop

Puede ejercer un mayor control sobre la digitación de los acordes
estableciendo @code{fingeringOrientations}

@lilypond[quote,verbatim,ragged-right,fragment,relative=1]
\set fingeringOrientations = #'(left down)
<c-1 es-2 g-4 bes-5 > 4
\set fingeringOrientations = #'(up right down)
<c-1 es-2 g-4 bes-5 > 4
@end lilypond

Usando esta funcionalidad, también es posible poner instrucciones de digitación muy cerca de las cabezas 
de nota en música monofónica,

@lilypond[verbatim,ragged-right,quote,fragment]
\set fingeringOrientations = #'(right)
<es'-2>4
@end lilypond


@seealso

Fragmentos de código: @lsrdir{Editorial,Editorial-annotations}.

Referencia de funcionamiento interno: @internalsref{Fingering}.


@node Hidden notes
@subsubsection Hidden notes

@cindex ocultas, notas
@cindex invisibles, notas
@cindex transparentes, notas
@funindex \hideNotes
@funindex \unHideNotes

Las notas ocultas (o invisibles, o transparentes) pueden ser de utilidad en la preparación de ejercicios
de teoría o de composición.

@lilypond[quote,ragged-right,verbatim,relative=2,fragment]
c4 d
\hideNotes
e4 f
\unHideNotes
g a
\hideNotes 
b
\unHideNotes
c
@end lilypond

@predefined

@code{\hideNotes}, @code{\unHideNotes}

@seealso

Fragmentos de código: @lsrdir{Editorial,Editorial-annotations}.


@node Coloring objects
@subsubsection Coloring objects

@cindex coloreados, objetos
@cindex colores
@cindex colorear objects
@cindex coloreadas, notas
@cindex colorear notas
@cindex notas, coloreadas

Se pueden asignar colores a los objetos individuales.  Podemos usar los nombres de color
que se relacionan en la @ref{List of colors}.

@lilypond[quote,ragged-right,verbatim,fragment,relative=1]
\override NoteHead #'color = #red
c4 c
\override NoteHead #'color = #(x11-color 'LimeGreen)
d
\override Stem #'color = #blue
e
@end lilypond

Se puede acceder al espectro completo de colores definido para X11 usando la función
de Scheme x11-color.  Esta función acepta un argumento que puede ser un
símbolo

@example
\override Beam #'color = #(x11-color 'MediumTurquoise)
@end example

o una cadena

@example
\override Beam #'color = #(x11-color "MediumTurquoise")
@end example

La primera forma es más rápida de escribir y más eficiente.  Sin embargo,
es posible usar la segunda forma para acceder a los colores de X11 a través de la variante del
nombre que tiene varias palabras

@example
\override Beam #'color = #(x11-color "medium turquoise")
@end example

Si el parámetro no tiene sentido para x11-color, el color por defecto que se devuelve
es el negro.  Debería ser obvio, a la vista de la partitura resultante, que algo está
mal.

Este ejemplo ilustra el uso de x11-color.  Tenga en cuenta que el color de la plica
sigue siendo negro después de haberlo establecido a (x11-color 'Boggle), que es un color sin sentido
escrito a propósito.

@lilypond[quote,ragged-right,verbatim]
{
  \override Staff.StaffSymbol #'color = #(x11-color 'SlateBlue2)
  \set Staff.instrumentName = \markup {
    \with-color #(x11-color 'navy) "Clarinet"
  }
  \time 2/4
  gis''8 a''
  \override Beam #'color = #(x11-color "medium turquoise")
  gis'' a''
  \override NoteHead #'color = #(x11-color "LimeGreen")
  gis'' a''
  \override Stem #'color = #(x11-color 'Boggle)
  gis'' a''
}
@end lilypond


@seealso

Apéndice: @ref{List of colors}.


@knownissues
En un navegador de web, no todos los colores de x11 se distinguen entre sí.  Para su utilización en la
web se recomiendan los colores normales.

Un color de x11 no es necesariamente de la misma tonalidad que un color normal
con un nombre similar.

Las notas de un acorde no se pueden colorear con @code{\override}; en su lugar utilice
@code{\tweak}.  Consulte @ref{Objects connected to the input}
para ver más detalles.


@node Parentheses
@subsubsection Parentheses

@cindex fantasma, notas
@cindex notas fantasma
@cindex notas entre paréntesis

Los objetos se pueden encerrar entre paréntesis anteponiendo @code{\parenthesize} al evento
musical,

@lilypond[relative=2,fragment,verbatim,ragged-right]
<
  c
  \parenthesize d
  g
>4-\parenthesize -.
@end lilypond

Esto sólo funciona dentro de los acordes, incluso para notas sueltas

@example
< \parenthesize NOTA>
@end example


@node Stems
@subsubsection Stems

Cuando se encuentra con una nota, se crea un objeto
@internalsref{Stem} (plica) automáticamente.  Para las redondas y los
silencios, también se crean pero se hacen invisibles.

@predefined

@funindex \stemUp
@code{\stemUp},
@funindex \stemDown
@code{\stemDown},
@funindex \stemNeutral
@code{\stemNeutral}.


@commonprop

Para modificar la dirección de las plicas en medio de un pentagrama, utilice

@lilypond[quote,ragged-right,fragment,relative=2,verbatim]
a4 b c b
\override Stem #'neutral-direction = #up
a4 b c b
\override Stem #'neutral-direction = #down
a4 b c b
@end lilypond


@node Outside the staff
@subsection Outside the staff


@menu
* Balloon help::                
* Grid lines::                  
* Blank music sheet::           
@end menu

@node Balloon help
@subsubsection Balloon help

Los elementos de notación se pueden marcar y nombrar con la ayuda de un cartel o globo de ayuda
rectangular.  El propósito principal de esta funcionalidad es la explicación de la notación.

El ejemplo siguiente presenta una demostración de su uso.

@lilypond[quote,verbatim,fragment,ragged-right,relative=2]
\new Voice \with { \consists "Balloon_engraver" }
{
  \balloonGrobText #'Stem #'(3 . 4) \markup { "I'm a Stem" }
  <c-\balloonText #'(-2 . -2) \markup { Hello }  >8
}
@end lilypond

@noindent
Existen dos funciones musicales, @code{balloonText} y
@code{balloonGrobText}. Este último toma su nombre del objeto gráfico que se adorna,
mientras que el primero se puede usar como una articulación sobre una nota.
Los otros argumentos son el desplazamiento y el texto de la etiqueta.

@cindex globo
@cindex notación, explicaciones

@seealso

Referencia del programa: @internalsref{text-balloon-interface}.


@node Grid lines
@subsubsection Grid lines

Se pueden dibujar líneas verticales, sincronizadas con las notas, entre
pentagramas.

@lilypond[ragged-right,quote,verbatim]
\layout {
  \context {
    \Staff
    \consists "Grid_point_engraver" %% sets of grid
    gridInterval = #(ly:make-moment 1 4)
  }
}

\new Score \with {
  \consists "Grid_line_span_engraver"
  %% centers grid lines  horizontally below noteheads
  \override NoteColumn #'X-offset = #-0.5
}

\new ChoirStaff <<
  \new Staff {
    \stemUp
    \relative {
      c'4. d8 e8 f g4
    }
  }
  \new Staff {
    %% centers grid lines  vertically
    \override Score.GridLine #'extra-offset = #'( 0.0 . 1.0 )
    \stemDown
    \clef bass
    \relative c {
      c4  g'  f  e
    }
  }
>>
@end lilypond

Ejemplos: @lsrdir{education}


@node Analysis brackets
@subsubsection Analysis brackets

@cindex corchetes
@cindex fraseo, corchetes de
@cindex musicológico, análisis
@cindex notas, corchetes de agrupación de

Los corchetes se usan en análisis musical para indicar las estructuras presentes en las piezas
musicales.  LilyPond contempla una forma básica de corchetes horizontales anidados.
Para usarlos, añada el grabador @internalsref{Horizontal_bracket_engraver}
al contexto @internalsref{Staff}.  Un corchete se abre con
@code{\startGroup} y se cierra con @code{\stopGroup}

@lilypond[quote,ragged-right,verbatim]
\score {
  \relative c'' {
    c4\startGroup\startGroup
    c4\stopGroup
    c4\startGroup
    c4\stopGroup\stopGroup
  }
  \layout {
    \context {
      \Staff \consists "Horizontal_bracket_engraver"
}}}
@end lilypond

@seealso

Fragmentos de código: @lsrdir{Editorial,Editorial-annotations}.

Referencia de funcionamiento interno: @internalsref{HorizontalBracket},
@internalsref{Horizontal_bracket_engraver}, @internalsref{Staff}.



