]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/es/user/editorial.itely
Merge branch 'master' of ssh://jomand@git.sv.gnu.org/srv/git/lilypond into lilypond...
[lilypond.git] / Documentation / es / user / editorial.itely
index d65f7449a4f388c280d302f42fe57242963e47bf..e444164b31b5846fb1048b1f60c82700c04e03b9 100644 (file)
@@ -1,13 +1,13 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
 @c This file is included from notation.itely
 @ignore
-    Translation of GIT committish: aae416a0211bad0bbed5c82b91d80a83d21e8054
+    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.11.38"
+@c \version "2.12.0"
 
 @node Editorial annotations
 @section Editorial annotations
@@ -18,8 +18,8 @@ Esta sección trata de las diversas maneras de modificar el aspecto de
 las notas y de aplicar énfasis analítico o educativo.
 
 @menu
-* Inside the staff::            
-* Outside the staff::           
+* Inside the staff::
+* Outside the staff::
 @end menu
 
 
@@ -30,195 +30,273 @@ Esta sección trata sobre cómo aplicar énfasis a los elementos situados
 dentro del pentagrama.
 
 @menu
-* Selecting notation font size::  
-* Fingering instructions::      
-* Hidden notes::                
-* Coloring objects::            
-* Parentheses::                 
-* Stems::                       
+* Selecting notation font size::
+* Fingering instructions::
+* Hidden notes::
+* Coloring objects::
+* Parentheses::
+* Stems::
 @end menu
 
 @node Selecting notation font size
-@subsubsection Selecting notation font size
-
-@cindex fuente tipográfica, tamaño 
-@cindex fuente tipográfica, tamaño, seleccionar
-@cindex selección del tamaño de la fuente tipográfica
-
-El método más sencillo para establecer el tamaño de la tipografía de
-cualquier contexto es mediante el ajuste de la propiedad
-@code{fontSize}.
-
-@lilypond[quote,fragment,relative=2,verbatim,ragged-right]
-c4
-\set fontSize = #-4
-c f
-\set fontSize = #3
-g8 a
+@unnumberedsubsubsec Selecting notation font size
+
+@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
 
-@noindent
-No modifica el tamaño de los símbolos variables como barras o
-ligaduras de expresión.
-
-@cindex fuente tipográfica, escalado del tamaño
-
-Internamente, la propiedad de contexto @code{fontSize} produce que se
-eestablezca el valor de la propiedad @code{font-size} en todos los
-objetos de presentación.  El valor de @code{font-size} es un número
-que indica el tamaño relativo al tamaño estándar para la altura
-vigente del pentagrama.  Cada paso hacia arriba es un incremento de un
-12% del tamaño de la fuente, aproximadamente.  Seis pasos 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[quote,fragment,relative=2,verbatim,ragged-right]
-c4
+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
-c f
-\override NoteHead #'font-size = #3
-g8 a
+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
-@cindex fuente tipográfica, tamaño estándar de
+@cindex estándar, tamaño de la tipografía (de notación)
+@cindex fuente tipográfica (de notación), tamaño estándar de
+
+@funindex font-interface
+@funindex font-size
 
 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}
-igual a 0), depende de la altura estándar del pentagrama.  Para un
+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 utilicesn fuentes tipográficas.  Éstos son los que
+gráficos que utilicen fuentes tipográficas.  Éstos son los que
 contemplan el interfaz de presentación @code{font-interface}.
 
-@predefined
 
-Las siguientes instrucciones establecen un valor de @code{fontSize}
-para la voz en curso:
+@predefined
+@code{\teeny} (enano),
+@code{\tiny} (muy pequeño),
+@code{\small} (pequeño),
+@code{\normalsize} (normal),
+@code{\large} (grande),
+@code{\huge} (enorme).
+@endpredefined
 
-@funindex \tiny
-@code{\tiny},
-@funindex \small
-@code{\small},
-@funindex \normalsize
-@code{\normalsize}.
 
 @seealso
+Fragmentos de código:
+@rlsr{Editorial annotations}.
 
-Fragmentos de código: @lsrdir{Editorial,Editorial-annotations}.
+Referencia de funcionamiento interno:
+@rinternals{font-interface}.
 
-Referencia de funcionamiento interno: @internalsref{font-interface}.
 
 @node Fingering instructions
-@subsubsection Fingering instructions
+@unnumberedsubsubsec 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
+
+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,ragged-right,quote,fragment]
-\set fingeringOrientations = #'(right)
-<es'-2>4
+@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}.
 
-Fragmentos de código: @lsrdir{Editorial,Editorial-annotations}.
+Fragmentos de código:
+@rlsr{Editorial annotations}.
 
-Referencia de funcionamiento interno: @internalsref{Fingering}.
+Referencia de funcionamiento interno:
+@rinternals{FingeringEvent},
+@rinternals{fingering-event},
+@rinternals{Fingering_engraver},
+@rinternals{New_fingering_engraver},
+@rinternals{Fingering}.
 
 
 @node Hidden notes
-@subsubsection Hidden notes
+@unnumberedsubsubsec 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
+@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.
+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]
+@lilypond[verbatim,quote,relative=2]
 c4 d
 \hideNotes
 e4 f
 \unHideNotes
 g a
-\hideNotes 
+\hideNotes
 b
 \unHideNotes
 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
 
-@code{\hideNotes}, @code{\unHideNotes}
 
 @seealso
+Fragmentos de código:
+@rlsr{Editorial annotations}.
 
-Fragmentos de código: @lsrdir{Editorial,Editorial-annotations}.
+Referencia de funcionamiento interno:
+@rinternals{Note_spacing_engraver},
+@rinternals{NoteSpacing}.
 
 
 @node Coloring objects
-@subsubsection Coloring objects
+@unnumberedsubsubsec Coloring objects
 
 @cindex coloreados, objetos
 @cindex colores
-@cindex colorear objects
+@cindex colorear objetos
+@cindex objetos, colorear
 @cindex coloreadas, notas
 @cindex colorear notas
-@cindex notas, coloreadas
+@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.  Podemos usar los nombres de color
-que se relacionan en la @ref{List of colors}.
+Se pueden asignar colores a los objetos individuales.  Los nombres de
+color válidos se encuentran relacionados en la @ref{List of colors}.
 
-@lilypond[quote,ragged-right,verbatim,fragment,relative=1]
+@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
-@subsubsection Parentheses
+@unnumberedsubsubsec Parentheses
 
 @cindex fantasma, notas
 @cindex notas fantasma
 @cindex notas entre paréntesis
+@cindex paréntesis
+
+@funindex \parenthesize
+@funindex parenthesize
 
-Los objetos se pueden encerrar entre paréntesis anteponiendo @code{\parenthesize} al evento
-musical,
+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[relative=2,fragment,verbatim,ragged-right]
-<
-  c
-  \parenthesize d
-  g
->4-\parenthesize -.
+@lilypond[verbatim,quote,relative=2]
+c2 \parenthesize d
+c2 \parenthesize <c e g>
+c2 <c \parenthesize e g>
 @end lilypond
 
-Esto sólo funciona dentro de los acordes, incluso para notas sueltas
+Los objetos que no son notas también se pueden poner entre paréntesis.
 
-@example
-< \parenthesize NOTA>
-@end example
+@lilypond[verbatim,quote,relative=2]
+c2-\parenthesize -. d
+c2 \parenthesize r
+@end lilypond
 
 
-@node Stems
-@subsubsection Stems
+@seealso
+Fragmentos de código:
+@rlsr{Editorial annotations}.
 
-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.
+Referencia de funciionamiento interno:
+@rinternals{Parenthesis_engraver},
+@rinternals{ParenthesesItem},
+@rinternals{parentheses-interface}.
 
-@predefined
+@knownissues
+
+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
+
+@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::                  
-* Analysis brackets::           
+* Balloon help::
+* Grid lines::
+* Analysis brackets::
 @end menu
 
 @node Balloon help
-@subsubsection 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
-@subsubsection Grid lines
-
-Se pueden dibujar líneas verticales, sincronizadas con las notas, entre
-pentagramas.
-
-@lilypond[ragged-right,quote,verbatim]
+@unnumberedsubsubsec Grid lines
+
+@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
+
+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
+
+@lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
+{grid-lines--changing-their-appearance.ly}
+
+
+@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
-@subsubsection 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
 
-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}
+@funindex Horizontal_bracket_engraver
+@funindex \startGroup
+@funindex startGroup
+@funindex \stopGroup
+@funindex stopGroup
 
-@lilypond[quote,ragged-right,verbatim]
-\score {
-  \relative c'' {
-    c4\startGroup\startGroup
-    c4\stopGroup
-    c4\startGroup
-    c4\stopGroup\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"
   }
-  \layout {
-    \context {
-      \Staff \consists "Horizontal_bracket_engraver"
-}}}
+}
+\relative c'' {
+  c2\startGroup
+  d\stopGroup
+}
 @end lilypond
 
-@seealso
-
-Fragmentos de código: @lsrdir{Editorial,Editorial-annotations}.
-
-Referencia de funcionamiento interno: @internalsref{HorizontalBracket},
-@internalsref{Horizontal_bracket_engraver}, @internalsref{Staff}.
+Los corchetes de análisis se pueden anidar.
 
+@lilypond[verbatim,quote]
+\layout {
+  \context {
+    \Voice
+    \consists "Horizontal_bracket_engraver"
+  }
+}
+\relative c'' {
+  c4\startGroup\startGroup
+  d4\stopGroup
+  e4\startGroup
+  d4\stopGroup\stopGroup
+}
+@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}.