-@c -*- coding: utf-8; mode: texinfo; -*-
+@c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
+@c This file is included from notation.itely
@ignore
- Translation of GIT committish: 459d5b872a370b53f61e747784fb56cf23f56e4b
+ Translation of GIT committish: 41ef91786a08102d9b9a839f6a2f40cec263d723
When revising a translation, copy the HEAD committish of the
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.12.0"
+
@node Editorial annotations
@section Editorial annotations
-@menu
-* Note heads::
-* Inside the staff::
-* Outside the staff::
-@end menu
+@lilypondfile[quote]{editorial-headword.ly}
-
-@node Note heads
-@subsection Note heads
+Esta sección trata de las diversas maneras de modificar el aspecto de
+las notas y de aplicar énfasis analítico o educativo.
@menu
-* Easy notation note heads::
-* Shape note heads::
-* Improvisation::
-* Special noteheads::
+* Inside the staff::
+* Outside the staff::
@end menu
-@node Easy Notation note heads
-@unnumberedsubsubsec Easy Notation note heads
-
-@cindex notas, cabezas de, estudio
-@cindex notas, cabezas de, notación simplificada
-@cindex simplificada, notación
-@cindex Hal Leonard
-
-Las cabezas @q{easy play} (fáciles de tocar) tienen el nombre de la nota (en inglés) dentro de la cabeza. Se usa
-en la música para principiantes
-
-@lilypond[quote,ragged-right,verbatim,fragment,staffsize=26]
- \easyHeadsOn
- c'2 e'4 f' | g'1
-@end lilypond
-
-La orden @code{\easyHeadsOn} sobreescribe los ajustes del objeto
-@internalsref{NoteHead}. Para que las letras sean legibles, se tienen que imprimir
-en un tamaño grande de la tipografía. Para imprimir con un tamaño de tipografía mayor, consulte
-@ref{Setting the staff size}.
-@refcommands
-
-@funindex \easyHeadsOn
-@code{\easyHeadsOn}
-
-
-@node Shape note heads
-@unnumberedsubsubsec Shape note heads
+@node Inside the staff
+@subsection Inside the staff
-@cindex notas, cabezas de, con formas
+Esta sección trata sobre cómo aplicar énfasis a los elementos situados
+dentro del pentagrama.
-En notación de cabezas con forma, la forma de la cabeza corresponde
-a la función armónica de una nota dentro de la escala. Esta notación se hizo popular
-en los libros americanos de canciones durante el s.XIX.
+@menu
+* Selecting notation font size::
+* Fingering instructions::
+* Hidden notes::
+* Coloring objects::
+* Parentheses::
+* Stems::
+@end menu
-Las cabezas con formas se pueden producir estableciendo @code{\aikenHeads} o
-@code{\sacredHarpHeads}, según el estilo deseado.
+@node Selecting notation font size
+@unnumberedsubsubsec Selecting notation font size
-@lilypond[verbatim,relative=1,fragment]
- \aikenHeads
- c8 d4 e8 a2 g1
- \sacredHarpHeads
- c8 d4. e8 a2 g1
+@cindex fuente tipográfica (de notación), tamaño
+@cindex selección del tamaño de la fuente tipográfica (de notación)
+@cindex notación, tamaño de la fuente
+@cindex notas, cabezas de
+
+@funindex fontSize
+@funindex font-size
+@funindex magstep
+@funindex \huge
+@funindex \large
+@funindex \normalsize
+@funindex \small
+@funindex \tiny
+@funindex \teeny
+@funindex huge
+@funindex large
+@funindex normalsize
+@funindex small
+@funindex tiny
+@funindex teeny
+
+Se puede alterar el tamaño de la fuente tipográfica de los elementos
+de notación. Esto no cambia el tamaño de los símbolos variables, como
+las barras de corchea o las ligaduras.
+
+@warning{Para los tamaños de tipografía del texto, consulte
+@ref{Selecting font and font size}.}
+
+@lilypond[verbatim,quote,relative=2]
+\huge
+c4.-> d8---3
+\large
+c4.-> d8---3
+\normalsize
+c4.-> d8---3
+\small
+c4.-> d8---3
+\tiny
+c4.-> d8---3
+\teeny
+c4.-> d8---3
@end lilypond
-Las formas se determinan en función del grado de la escala, donde la tónica
-está determinada por la instrucción @code{\key}
-
-@funindex \key
-@funindex shapeNoteStyles
-@funindex \aikenHeads
-@funindex \sacredHarpHeads
-
-Las cabezas con formas están programadas a través de la propiedad @code{shapeNoteStyles}.
-Su valor es un vector de símbolos. El elemento en el lugar k indica qué estilo
-usa el grado k de la escala. Son posibles las combinaciones
-arbitrarias, p.ej.:
-
-@lilypond[verbatim,relative=1,fragment]
- \set shapeNoteStyles = ##(cross triangle fa #f mensural xcircle diamond)
- c8 d4. e8 a2 g1
+Internamente, esto establece un valor para la propiedad
+@code{fontSize}. Esto, a su vez, hace que se establezca el valor de
+la propiedad @code{font-size} de todos los objetos de presentación.
+El valor de @code{font-size} es un número que indica el tamaño con
+relación al tamaño estándar para la altura vigente del pentagrama.
+Cada unidad hacia arriba es un incremento de un 12% del tamaño de la
+fuente, aproximadamente. Seis unidades son exactamente un factor de
+dos. La función de Scheme @code{magstep} convierte un número de
+tamaño @code{font-size} a un factor de escalado. La propiedad
+@code{font-size} también se puede establecer directamente, de forma
+que queden afectados solamente determinados objetos gráficos.
+
+@lilypond[verbatim,quote,relative=2]
+\set fontSize = #3
+c4.-> d8---3
+\override NoteHead #'font-size = #-4
+c4.-> d8---3
+\override Script #'font-size = #2
+c4.-> d8---3
+\override Stem #'font-size = #-5
+c4.-> d8---3
@end lilypond
+@cindex estándar, tamaño de la tipografía (de notación)
+@cindex fuente tipográfica (de notación), tamaño estándar de
-@node Improvisation
-@unnumberedsubsubsec Improvisation
+@funindex font-interface
+@funindex font-size
-UNTRANSLATED NODE: IGNORE ME
+Los cambios en el tamaño de la fuente se obtienen por medio del
+escalado del tamaño del diseño que se encuentra más cerca del tamaño
+deseado. El tamaño estándar para la tipografía (para @code{font-size
+= #0}), depende de la altura estándar del pentagrama. Para un
+pentagrama de 20 puntos, se selecciona una fuente de 10 puntos.
+La propiedad @code{font-size} sólo se puede establecer en objetos
+gráficos que utilicen fuentes tipográficas. Éstos son los que
+contemplan el interfaz de presentación @code{font-interface}.
-@node Special noteheads
-@unnumberedsubsubsec Special noteheads
-UNTRANSLATED NODE: IGNORE ME
+@predefined
+@code{\teeny} (enano),
+@code{\tiny} (muy pequeño),
+@code{\small} (pequeño),
+@code{\normalsize} (normal),
+@code{\large} (grande),
+@code{\huge} (enorme).
+@endpredefined
-@node Inside the staff
-@subsection Inside the staff
-
-
-@menu
-* Selecting notation font size::
-* Fingering instructions::
-* Hidden notes::
-* Coloring objects::
-* Parentheses::
-* Ambitus::
-* Stems::
-@end menu
-
-@node Selecting notation font size
-@unnumberedsubsubsec Selecting notation font size
+@seealso
+Fragmentos de código:
+@rlsr{Editorial annotations}.
-UNTRANSLATED NODE: IGNORE ME
+Referencia de funcionamiento interno:
+@rinternals{font-interface}.
@node Fingering instructions
@cindex digitación
@cindex cambio de dedo
+@funindex \finger
+@funindex finger
+
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
+@var{nota}-@var{dígito}:
-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>
+@lilypond[verbatim,quote,relative=2]
+c4-1 d-2 f-4 e-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
+Para los cambios de dedo se pueden usar elementos de marcado de texto.
+
+@lilypond[verbatim,quote,relative=2]
+c4-1 d-2 f-4 c^\markup { \finger "2 - 3" }
@end lilypond
+@cindex thumb-script
-@commonprop
+@funindex \thumb
+@funindex thumb
-Puede ejercer un mayor control sobre la digitación de los acordes
-estableciendo @code{fingeringOrientations}
+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=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
+@lilypond[verbatim,quote,relative=2]
+<a_\thumb a'-3>2 <b_\thumb b'-3>
@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,
+@cindex digitación de acordes
+@cindex digitación, instrucciones de, para acordes
+@cindex acordes, digitación de
-@lilypond[verbatim,ragged-right,quote,fragment]
-\set fingeringOrientations = #'(right)
-<es'-2>4
+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[verbatim,quote,relative=2]
+<c-1 e-2 g-3 b-5>2 <d-1 f-2 a-3 c-5>
@end lilypond
+Las indicaciones de digitación se pueden situar manualmente encima o
+debajo del pentagrama, véase @ref{Direction
+and placement}.
+
+@snippets
+
+@lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
+{controlling-the-placement-of-chord-fingerings.ly}
+
+@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+{allowing-fingerings-to-be-printed-inside-the-staff.ly}
+
+@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+{avoiding-collisions-with-chord-fingerings.ly}
+
@seealso
+Referencia de la notación:
+@ref{Direction and placement}.
-Referencia del programa: @internalsref{Fingering}.
+Fragmentos de código:
+@rlsr{Editorial annotations}.
-Ejemplos: @lsr{expressive,fingering-chords.ly}
+Referencia de funcionamiento interno:
+@rinternals{FingeringEvent},
+@rinternals{fingering-event},
+@rinternals{Fingering_engraver},
+@rinternals{New_fingering_engraver},
+@rinternals{Fingering}.
@node Hidden notes
@cindex ocultas, notas
@cindex invisibles, notas
@cindex transparentes, notas
+@cindex notas ocultas
+@cindex notas invisibles
+@cindex notas transparentes
@funindex \hideNotes
+@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.
+@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 d4
+@lilypond[verbatim,quote,relative=2]
+c4 d
+\hideNotes
+e4 f
+\unHideNotes
+g a
\hideNotes
-e4 f4
+b
\unHideNotes
-g4 a
+c
@end lilypond
+Los objetos de notación que están anclados a notas invisibles, son a
+pesar de ello visibles.
+
+@lilypond[verbatim,quote,relative=2]
+c4( d)
+\hideNotes
+e4(\p f)--
+@end lilypond
+
+
+@predefined
+@code{\hideNotes},
+@code{\unHideNotes}.
+@endpredefined
+
+
+@seealso
+Fragmentos de código:
+@rlsr{Editorial annotations}.
+
+Referencia de funcionamiento interno:
+@rinternals{Note_spacing_engraver},
+@rinternals{NoteSpacing}.
+
@node Coloring objects
@unnumberedsubsubsec Coloring objects
-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]
+@cindex coloreados, objetos
+@cindex colores
+@cindex colorear objetos
+@cindex objetos, colorear
+@cindex coloreadas, notas
+@cindex colorear notas
+@cindex notas coloreadas
+@cindex x11, color de
+@cindex x11-color
+@cindex colores de x11
+@cindex with-color
+
+@funindex color
+@funindex \with-color
+@funindex with-color
+@funindex x11-color
+
+Se pueden asignar colores a los objetos individuales. Los nombres de
+color válidos se encuentran relacionados en la @ref{List of colors}.
+
+@lilypond[verbatim,quote,relative=2]
\override NoteHead #'color = #red
c4 c
\override NoteHead #'color = #(x11-color 'LimeGreen)
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
+Se puede acceder al espectro completo de colores definido para X11
+usando la función de Scheme x11-color. Esta función acepta un único
+argumento; éste puede ser un símbolo de la forma @var{'FulanoMengano}
+o una cadena de la forma @var{"FulanoMengano"}. La primera forma es
+más rápida de escribir y también más eficiente. Sin embargo, al usar
+la segunda forma es posible acceder a los colores de X11 por medio de
+la forma del nombre que tiene varias palabras.
+
+Si @code{x11-color} no entiende el parámetro, el color predeterminado
+que se devuelve es el negro.
+
+@lilypond[verbatim,quote,relative=2]
+\override Staff.StaffSymbol #'color = #(x11-color 'SlateBlue2)
+\set Staff.instrumentName = \markup {
+ \with-color #(x11-color 'navy) "Clarinet"
+}
-@example
+gis8 a
\override Beam #'color = #(x11-color "medium turquoise")
-@end example
+gis a
+\override Accidental #'color = #(x11-color 'DarkRed)
+gis a
+\override NoteHead #'color = #(x11-color "LimeGreen")
+gis a
+% this is deliberate nonsense; note that the stems remain black
+\override Stem #'color = #(x11-color 'Boggle)
+b2 cis
+@end lilypond
-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.
+@cindex rgb-color
+@cindex color rgb
+@cindex rgb, color
-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.
+@funindex rgb-color
-@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''
+Se pueden especificar colores RGB exactos utilizando la función de
+Scheme @code{rgb-color}.
+
+@lilypond[verbatim,quote,relative=2]
+\override Staff.StaffSymbol #'color = #(x11-color 'SlateBlue2)
+\set Staff.instrumentName = \markup {
+ \with-color #(x11-color 'navy) "Clarinet"
}
+
+\override Stem #'color = #(rgb-color 0 0 0)
+gis8 a
+\override Stem #'color = #(rgb-color 1 1 1)
+gis8 a
+\override Stem #'color = #(rgb-color 0 0 0.5)
+gis4 a
@end lilypond
@seealso
+Referencia de la notación:
+@ref{List of colors},
+@ref{The tweak command}.
+
+Fragmentos de código:
+@rlsr{Editorial annotations}.
-Apéndice: @ref{List of colors}.
+@cindex x11, color de
+@cindex coloreadas, notas de acorde
+@cindex notas coloreadas en acordes
+@cindex color en acordes
+
+@funindex x11-color
@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 exacta que
+un color normal de nombre similar.
-Un color de x11 no es necesariamente de la misma tonalidad que un color normal
-con un nombre similar.
+No todos los colores de X11 se distinguen entre sí en un navegador
+web, es decir, un navegador de web podría no mostrar ninguna
+diferencia entre @code{'LimeGreen} (verde lima) y @code{'ForestGreen}
+(verde bosque). Para la web se recomiendan los colores normales (o
+sea: @code{#blue}, azul, @code{#green}, verde, @code{#red}, rojo).
-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.
+Las notas de un acorde no se pueden colorear con @code{\override}; en
+su lugar utilice @code{\tweak}. Consulte @ref{The tweak command} para
+ver más detalles.
@node Parentheses
@cindex fantasma, notas
@cindex notas fantasma
@cindex notas entre paréntesis
+@cindex 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 Ambitus
-@unnumberedsubsubsec Ambitus
-@cindex ambitus
-
-El término @emph{ambitus} o ámbito, denota el rango de notas que abarca una voz dada
-en una parte musical. También puede denotar el margen de notas que es capaz de tocar
-un determinado instrumento musical. Los ámbitos se imprimen en las partes vocales de tal manera que
-los intérpretes puedan determinar con facilidad si cumplen con sus propias posibilidades.
-
-Los ámbitos se presentan al comienzo de la pieza junto a la clave inicial.
-El rango se especifica gráficamente mediante dos cabezas de nota que representan a las
-notas inferior y superior. Para imprimir el ámbito, añada el grabador
-@internalsref{Ambitus_engraver} al contexto @internalsref{Voice},
-por ejemplo
-
-@example
-\layout @{
- \context @{
- \Voice
- \consists Ambitus_engraver
- @}
-@}
-@end example
+@funindex \parenthesize
+@funindex parenthesize
-Lo que da como resultado la siguiente salida:
+Los objetos se pueden encerrar entre paréntesis anteponiendo
+@code{\parenthesize} al evento musical. Si se aplica a un acorde,
+encierra cada nota dentro de un par de paréntesis. También se pueden
+poner entre paréntesis las notas individuales de un acorde.
-@lilypond[quote,ragged-right]
-\layout {
- \context {
- \Staff
- \consists Ambitus_engraver
- }
-}
-
-\relative \new Staff {
- as'' c e2 cis,2
-}
+@lilypond[verbatim,quote,relative=2]
+c2 \parenthesize d
+c2 \parenthesize <c e g>
+c2 <c \parenthesize e g>
@end lilypond
-Si tiene varias voces en un pentagrama único y quiere tener una sola indicación de ámbito
-por pentagrama en lugar de una por cada voz, añada el grabador
-@internalsref{Ambitus_engraver} al contexto @internalsref{Staff}
-y no al contexto @internalsref{Voice}. He aquí un ejemplo:
+Los objetos que no son notas también se pueden poner entre paréntesis.
-@lilypond[verbatim,ragged-right,quote]
-\new Staff \with {
- \consists "Ambitus_engraver"
-}
-<<
- \new Voice \with {
- \remove "Ambitus_engraver"
- } \relative c'' {
- \override Ambitus #'X-offset = #-1.0
- \voiceOne
- c4 a d e f2
- }
- \new Voice \with {
- \remove "Ambitus_engraver"
- } \relative c' {
- \voiceTwo
- es4 f g as b2
- }
->>
+@lilypond[verbatim,quote,relative=2]
+c2-\parenthesize -. d
+c2 \parenthesize r
@end lilypond
-@noindent
-Este ejemplo utiliza una capacidad avanzada,
-
-@example
-\override Ambitus #'X-offset = #-1.0
-@end example
-
-@noindent
-Este código mueve el ámbito a la izquierda. Se podría haber conseguido el mismo
-efecto con @code{extra-offset}, pero en tal caso el sistema de formateo no
-reservaría espacio para el objeto que se ha movido.
@seealso
+Fragmentos de código:
+@rlsr{Editorial annotations}.
-Referencia del programa: @internalsref{Ambitus},
-@internalsref{AmbitusLine}, @internalsref{AmbitusNoteHead},
-@internalsref{AmbitusAccidental}.
-
-Ejemplos:
-@lsr{vocal,ambitus@/.ly}.
+Referencia de funciionamiento interno:
+@rinternals{Parenthesis_engraver},
+@rinternals{ParenthesesItem},
+@rinternals{parentheses-interface}.
@knownissues
-No se efectúa un tratamiento de las posibles colisiones en caso de varias indicaciones de ámbito
-simultáneas en distintas voces.
+Al poner un acorde entre paréntesis, se encierra cada una de las notas
+individuales entre paréntesis, en vez de un solo paréntesis grande
+rodeando al acorde completo.
@node Stems
@unnumberedsubsubsec 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.
-
-@refcommands
+@cindex plica
+@cindex plica invisible
+@cindex invisible, plica
@funindex \stemUp
-@code{\stemUp},
+@funindex stemUp
@funindex \stemDown
-@code{\stemDown},
+@funindex stemDown
@funindex \stemNeutral
+@funindex stemNeutral
+
+Cuando se encuentra con una nota, se crea automáticamente un objeto
+@code{Stem} (plica). Para las redondas y los silencios, también se
+crean pero se hacen invisibles.
+
+@predefined
+@code{\stemUp},
+@code{\stemDown},
@code{\stemNeutral}.
+@endpredefined
+@snippets
-@commonprop
+@cindex stem, direction
+@cindex stem, up
+@cindex stem, down
+@cindex stem, neutral
-Para modificar la dirección de las plicas en medio de un pentagrama, utilice
+@lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
+{default-direction-of-stems-on-the-center-line-of-the-staff.ly}
-@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
+
+@seealso
+Referencia de la notación:
+@ref{Direction and placement}.
+
+Fragmentos de código:
+@rlsr{Editorial annotations}.
+
+Referencia de funcionamiento interno:
+@rinternals{Stem_engraver},
+@rinternals{Stem},
+@rinternals{stem-interface}.
@node Outside the staff
@subsection Outside the staff
+Esta sección trata sobre cómo enfatizar elementos que están dentro del
+pentagrama, desde fuera del pentagrama.
@menu
-* Balloon help::
-* Grid lines::
-* Blank music sheet::
+* Balloon help::
+* Grid lines::
+* Analysis brackets::
@end menu
@node Balloon help
@unnumberedsubsubsec 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.
+@cindex globo
+@cindex notación, explicación de
+@cindex globo de ayuda
+@cindex ayuda, globos de
+
+@funindex \balloonGrobText
+@funindex \balloonText
+@funindex Balloon_engraver
+@funindex balloonGrobText
+@funindex balloonText
+@funindex \balloonLengthOn
+@funindex balloonLengthOn
+@funindex \balloonLengthOff
+@funindex balloonLengthOff
+
+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.
+
+@c KEEP LY
+@lilypond[verbatim,quote,relative=2]
+\new Voice \with { \consists "Balloon_engraver" }
+{
+ \balloonGrobText #'Stem #'(3 . 4) \markup { "Soy una plica" }
+ a8
+ \balloonGrobText #'Rest #'(-4 . -4) \markup { "Soy un silencio" }
+ r
+ <c, g'-\balloonText #'(-2 . -2) \markup { "Soy una cabeza" } c>2.
+}
+@end lilypond
-El ejemplo siguiente presenta una demostración de su uso.
+Existen dos funciones musicales, @code{balloonGrobText} y
+@code{balloonText}; el primero se usa como @code{\once\override} para
+adjuntar un texto a cualquier grob, y el último se usa coqmo
+@code{\tweak}, normalmente dentro de acordes, para adjuntar un texto a
+una nota individual.
-@lilypond[quote,verbatim,fragment,ragged-right,relative=2]
+Los textos de globo normalmente influyen en el espaciado de las notas,
+pero esto puede cambiarse:
+
+@c KEEP LY
+@lilypond[verbatim,quote,relative=2]
\new Voice \with { \consists "Balloon_engraver" }
{
- \balloonGrobText #'Stem #'(3 . 4) \markup { "I'm a Stem" }
- <c-\balloonText #'(-2 . -2) \markup { Hello } >8
+ \balloonLengthOff
+ \balloonGrobText #'Stem #'(3 . 4) \markup { "Soy una plica" }
+ a8
+ \balloonGrobText #'Rest #'(-4 . -4) \markup { "Soy un silencio" }
+ r
+ \balloonLengthOn
+ <c, g'-\balloonText #'(-2 . -2) \markup { "Soy una cabeza" } c>2.
}
@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
+@predefined
+@code{\balloonLengthOn},
+@code{\balloonLengthOff}.
+@endpredefined
+
@seealso
+Fragmentos de código:
+@rlsr{Editorial annotations}.
-Referencia del programa: @internalsref{text-balloon-interface}.
+Referencia de funcionamiento interno:
+@rinternals{Balloon_engraver},
+@rinternals{BalloonTextItem},
+@rinternals{balloon-interface}.
@node Grid lines
@unnumberedsubsubsec Grid lines
-Se pueden dibujar líneas verticales, sincronizadas con las notas, entre
-pentagramas.
+@cindex rejilla, líneas de
+@cindex líneas de rejilla
+@cindex vertical, línea, entre pentagramas
+@cindex línea vertical entre pentagramas
+
+@funindex Grid_point_engraver
+@funindex Grid_line_span_engraver
+@funindex gridInterval
-@lilypond[ragged-right,quote,verbatim]
+Se pueden dibujar líneas verticales entre los pentagramas
+sincronizadas con las notas.
+
+Se debe usar el grabador @code{Grid_point_engraver} para crear los
+puntos extremos de las líneas, mientras que el grabador
+@code{Grid_line_span_engraver} se debe utilizar para trazar
+efectivamente las líneas. De forma predeterminada, esto centra las
+líneas de rejilla horizontalmente debajo y al lado izquierdo de la
+cabeza de las notas. Las líneas de rejilla se extienden a partir de
+línea media de los pentagramas. El intervalo @code{gridInterval} debe
+especificar la duración entre las líneas de rejilla.
+
+@lilypond[verbatim,quote]
\layout {
\context {
\Staff
- \consists "Grid_point_engraver" %% sets of grid
+ \consists "Grid_point_engraver"
gridInterval = #(ly:make-moment 1 4)
}
+ \context {
+ \Score
+ \consists "Grid_line_span_engraver"
+ }
}
-\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
+\score {
+ \new ChoirStaff <<
+ \new Staff \relative c'' {
+ \stemUp
+ c4. 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
+ \new Staff \relative c {
+ \clef bass
+ \stemDown
+ c4 g' f e
}
- }
->>
+ >>
+}
@end lilypond
-Ejemplos: @lsrdir{education}
-
+@snippets
-@node Blank music sheet
-@unnumberedsubsubsec Blank music sheet
+@lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
+{grid-lines--changing-their-appearance.ly}
-@cindex papel de música vacío
-@cindex Pentagramas, hoja en blanco
-También se pueden producir hojas de papel de música en blanco utilizando notas invisibles y
-suprimiendo el grabador @code{Bar_number_engraver}.
+@seealso
+Fragmentos de código:
+@rlsr{Editorial annotations}.
+
+Referencia de funcionamiento interno:
+@rinternals{Grid_line_span_engraver},
+@rinternals{Grid_point_engraver},
+@rinternals{GridLine},
+@rinternals{GridPoint},
+@rinternals{grid-line-interface},
+@rinternals{grid-point-interface}.
+
+
+@node Analysis brackets
+@unnumberedsubsubsec Analysis brackets
+
+@cindex corchetes
+@cindex fraseo, corchetes de
+@cindex corchetes de fraseo
+@cindex musicológico, análisis
+@cindex análisis musicológico
+@cindex notas, corchetes de agrupación de
+@cindex horizontal, corchete
+@cindex corchete horizontal
+
+@funindex Horizontal_bracket_engraver
+@funindex \startGroup
+@funindex startGroup
+@funindex \stopGroup
+@funindex stopGroup
+
+Los corchetes se usan en análisis musical para indicar la estructura
+de las piezas musicales. Están contemplados los corchetes
+horizontales simples.
+
+@lilypond[verbatim,quote]
+\layout {
+ \context {
+ \Voice
+ \consists "Horizontal_bracket_engraver"
+ }
+}
+\relative c'' {
+ c2\startGroup
+ d\stopGroup
+}
+@end lilypond
+Los corchetes de análisis se pueden anidar.
-@lilypond[quote,verbatim]
-\layout{ indent = #0 }
-emptymusic = {
- \repeat unfold 2 % Change this for more lines.
- { s1\break }
- \bar "|."
+@lilypond[verbatim,quote]
+\layout {
+ \context {
+ \Voice
+ \consists "Horizontal_bracket_engraver"
+ }
+}
+\relative c'' {
+ c4\startGroup\startGroup
+ d4\stopGroup
+ e4\startGroup
+ d4\stopGroup\stopGroup
}
-\new Score \with {
- \override TimeSignature #'transparent = ##t
-% un-comment this line if desired
-% \override Clef #'transparent = ##t
- defaultBarType = #""
- \remove Bar_number_engraver
-} <<
-
-% modify these to get the staves you want
- \new Staff \emptymusic
- \new TabStaff \emptymusic
->>
@end lilypond
+@seealso
+Fragmentos de código:
+@rlsr{Editorial annotations}.
+
+Referencia de funcionamiento interno:
+@rinternals{Horizontal_bracket_engraver},
+@rinternals{HorizontalBracket},
+@rinternals{horizontal-bracket-interface},
+@rinternals{Staff}.