Merge branch 'master' into lilypond/translation

[lilypond.git] / Documentation / es / user / editorial.itely

diff --git a/Documentation/es/user/editorial.itely b/Documentation/es/user/editorial.itely
index 4418e7818976510d2d173e21acfcc7b05a74979d..bb296b250ca5287cf9e73e5fd002e53b8bef8eee 100644 (file)
--- a/Documentation/es/user/editorial.itely
+++ b/Documentation/es/user/editorial.itely
@@ -1,12 +1,14 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
 @c This file is included from notation.itely
 @ignore
 @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: 289a8244cb39275e313ddad57fe394da7a21c113

 
     When revising a translation, copy the HEAD committish of the
     version that you are working on.  See TRANSLATION for details.
 @end ignore
 
 
     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.61"
+

 @node Editorial annotations
 @section Editorial annotations
 
 @node Editorial annotations
 @section Editorial annotations
 


@@ -16,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
 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
 
 
 @end menu
 
 


@@ -28,195 +30,273 @@ Esta sección trata sobre cómo aplicar énfasis a los elementos situados
 dentro del pentagrama.
 
 @menu
 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
 @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
 
 @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
 \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
 
 @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
 
 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
 contemplan el interfaz de presentación @code{font-interface}.
 
 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
 contemplan el interfaz de presentación @code{font-interface}.
 

+

 @predefined
 @predefined

+@code{\teeny} (enano),
+@code{\tiny} (muy pequeño),
+@code{\small} (pequeño),
+@code{\normalsize} (normal),
+@code{\large} (grande),
+@code{\huge} (enorme).
+@endpredefined

 
 

-Las siguientes instrucciones establecen un valor de @code{fontSize}
-para la voz en curso:
-
-@funindex \tiny
-@code{\tiny},
-@funindex \small
-@code{\small},
-@funindex \normalsize
-@code{\normalsize}.

 
 @seealso
 
 @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
 
 @node Fingering instructions

-@subsubsection Fingering instructions
+@unnumberedsubsubsec Fingering instructions

 
 @cindex digitación
 @cindex cambio de dedo
 
 
 @cindex digitación
 @cindex cambio de dedo
 

+@funindex \finger
+@funindex finger
+

 Las instrucciones de digitación se pueden introducir usando
 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
 
 @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
 
 @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
 
 @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
 
 @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-of-chord-fingering-with-beams.ly}
+

 
 @seealso
 
 @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
 
 
 @node Hidden notes

-@subsubsection Hidden notes
+@unnumberedsubsubsec Hidden notes

 
 @cindex ocultas, notas
 @cindex invisibles, notas
 @cindex transparentes, notas
 
 @cindex ocultas, notas
 @cindex invisibles, notas
 @cindex transparentes, notas

+@cindex notas ocultas
+@cindex notas invisibles
+@cindex notas transparentes
+

 @funindex \hideNotes
 @funindex \hideNotes

+@funindex hideNotes

 @funindex \unHideNotes
 @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
 c4 d
 \hideNotes
 e4 f
 \unHideNotes
 g a

-\hideNotes 
+\hideNotes

 b
 \unHideNotes
 c
 @end lilypond
 
 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
 @predefined

+@code{\hideNotes},
+@code{\unHideNotes}.
+@endpredefined

 
 

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

 
 @seealso
 
 @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
 
 
 @node Coloring objects

-@subsubsection Coloring objects
+@unnumberedsubsubsec Coloring objects

 
 @cindex coloreados, objetos
 @cindex colores
 
 @cindex coloreados, objetos
 @cindex colores

-@cindex colorear objects
+@cindex colorear objetos
+@cindex objetos, colorear

 @cindex coloreadas, notas
 @cindex colorear notas
 @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

 
 

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

 
 

-@lilypond[quote,ragged-right,verbatim,fragment,relative=1]
+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)
 \override NoteHead #'color = #red
 c4 c
 \override NoteHead #'color = #(x11-color 'LimeGreen)


@@ -225,243 +305,400 @@ d
 e
 @end lilypond
 
 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")
 \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
 @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
 
 @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
 
 
 @node Parentheses

-@subsubsection Parentheses
+@unnumberedsubsubsec Parentheses

 
 @cindex fantasma, notas
 @cindex notas fantasma
 @cindex notas entre paréntesis
 
 @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
 
 @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
 
 @funindex \stemUp

-@code{\stemUp},
+@funindex stemUp

 @funindex \stemDown
 @funindex \stemDown

-@code{\stemDown},
+@funindex stemDown

 @funindex \stemNeutral
 @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}.
 @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
 
 
 
 @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
 
 @menu

-* Balloon help::                
-* Grid lines::                  
-* Analysis brackets::           
+* Balloon help::
+* Grid lines::
+* Analysis brackets::

 @end menu
 
 @node Balloon help
 @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" }
 {
 \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
 
 }
 @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
 
 @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
 
 
 @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
 \layout {
   \context {
     \Staff

-    \consists "Grid_point_engraver" %% sets of grid
+    \consists "Grid_point_engraver"

     gridInterval = #(ly:make-moment 1 4)
   }
     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
 
 @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
 
 
 @node Analysis brackets

-@subsubsection Analysis brackets
+@unnumberedsubsubsec Analysis brackets

 
 @cindex corchetes
 @cindex fraseo, corchetes de
 
 @cindex corchetes
 @cindex fraseo, corchetes de

+@cindex corchetes de fraseo

 @cindex musicológico, análisis
 @cindex musicológico, análisis

+@cindex análisis musicológico

 @cindex notas, corchetes de agrupación de
 @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
 
 @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}.