]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/es/user/editorial.itely
lilypond-book robustness: ensure EOL at the end of @verbatim
[lilypond.git] / Documentation / es / user / editorial.itely
index 4a6a5681555c1268a66568a4a2dec7827d6fea3a..3579190d7a4ee69fbc6cb0a34f44791d50df06bf 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: 2ac76a5b0a5572cb259f22751764acfe431bfff2
+    Translation of GIT committish: 45945bd973aa9161b10e3f517902afb7ef4b4a56
 
     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.51"
+@c \version "2.12.0"
 
 @node Editorial annotations
 @section Editorial annotations
@@ -43,15 +43,33 @@ dentro del pentagrama.
 
 @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 @strong{texto}, consulte
-@ref{Text markup list commands}.}
+@warning{Para los tamaños de tipografía del texto, consulte
+@ref{Selecting font and font size}.}
 
-@lilypond[quote,fragment,relative=2,verbatim,ragged-right]
+@lilypond[verbatim,quote,relative=2]
 \huge
 c4.-> d8---3
 \large
@@ -66,8 +84,6 @@ c4.-> d8---3
 c4.-> d8---3
 @end lilypond
 
-@cindex fuente tipográfica (de notación), escalado del tamaño
-
 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.
@@ -80,7 +96,7 @@ 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]
+@lilypond[verbatim,quote,relative=2]
 \set fontSize = #3
 c4.-> d8---3
 \override NoteHead #'font-size = #-4
@@ -94,6 +110,9 @@ c4.-> d8---3
 @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
@@ -101,32 +120,25 @@ deseado.  El tamaño estándar para la tipografía (para @code{font-size
 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
 
-@funindex \teeny
+@predefined
 @code{\teeny} (enano),
-@funindex \tiny
 @code{\tiny} (muy pequeño),
-@funindex \small
 @code{\small} (pequeño),
-@funindex \normalsize
 @code{\normalsize} (normal),
-@funindex \large
 @code{\large} (grande),
-@funindex \huge
 @code{\huge} (enorme).
+@endpredefined
 
-@seealso
 
+@seealso
 Fragmentos de código:
 @rlsr{Editorial annotations}.
 
 Referencia de funcionamiento interno:
-@rinternals{fontSize},
-@rinternals{font-size},
 @rinternals{font-interface}.
 
 
@@ -136,35 +148,42 @@ Referencia de funcionamiento interno:
 @cindex digitación
 @cindex cambio de dedo
 
+@funindex \finger
+@funindex finger
+
 Las instrucciones de digitación se pueden introducir usando
 @var{nota}-@var{dígito}:
 
-@lilypond[quote,verbatim,ragged-right,fragment,relative=2]
+@lilypond[verbatim,quote,relative=2]
 c4-1 d-2 f-4 e-3
 @end lilypond
 
 Para los cambios de dedo se pueden usar elementos de marcado de texto.
 
-@lilypond[quote,verbatim,ragged-right,fragment,relative=2]
+@lilypond[verbatim,quote,relative=2]
 c4-1 d-2 f-4 c^\markup { \finger "2 - 3" }
 @end lilypond
 
 @cindex thumb-script
 
+@funindex \thumb
+@funindex thumb
+
 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]
+<a_\thumb a'-3>2 <b_\thumb b'-3>
 @end lilypond
 
-@cindex fingering chords
-@cindex chords, fingering
+@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[quote,verbatim,ragged-right,fragment,relative=2]
+@lilypond[verbatim,quote,relative=2]
 <c-1 e-2 g-3 b-5>2 <d-1 f-2 a-3 c-5>
 @end lilypond
 
@@ -174,13 +193,19 @@ and placement}.
 
 @snippets
 
-@lilypondfile[verbatim,lilyquote,ragged-right,texidoc]
+@lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
 {controlling-the-placement-of-chord-fingerings.ly}
 
-@seealso
+@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}
+@ref{Direction and placement}.
 
 Fragmentos de código:
 @rlsr{Editorial annotations}.
@@ -199,13 +224,19 @@ Referencia de funcionamiento interno:
 @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.
 
-@lilypond[quote,ragged-right,verbatim,relative=2,fragment]
+@lilypond[verbatim,quote,relative=2]
 c4 d
 \hideNotes
 e4 f
@@ -217,12 +248,23 @@ b
 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}.
 
@@ -236,15 +278,25 @@ Referencia de funcionamiento interno:
 
 @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.  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)
@@ -264,7 +316,7 @@ 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[quote,ragged-right,verbatim,fragment,relative=2]
+@lilypond[verbatim,quote,relative=2]
 \override Staff.StaffSymbol #'color = #(x11-color 'SlateBlue2)
 \set Staff.instrumentName = \markup {
   \with-color #(x11-color 'navy) "Clarinet"
@@ -282,36 +334,46 @@ gis a
 b2 cis
 @end lilypond
 
+@cindex rgb-color
+@cindex color rgb
+@cindex rgb, color
+
+@funindex rgb-color
+
 Se pueden especificar colores RGB exactos utilizando la función de
 Scheme @code{rgb-color}.
 
-@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+@lilypond[verbatim,quote,relative=2]
 \override Staff.StaffSymbol #'color = #(x11-color 'SlateBlue2)
 \set Staff.instrumentName = \markup {
   \with-color #(x11-color 'navy) "Clarinet"
 }
 
-% black
 \override Stem #'color = #(rgb-color 0 0 0)
 gis8 a
-% white
 \override Stem #'color = #(rgb-color 1 1 1)
 gis8 a
-% dark blue
 \override Stem #'color = #(rgb-color 0 0 0.5)
 gis4 a
 @end lilypond
 
-@seealso
 
+@seealso
 Referencia de la notación:
-@ref{List of colors}, @ref{The
-tweak command}.
+@ref{List of colors},
+@ref{The tweak command}.
 
 Fragmentos de código:
 @rlsr{Editorial annotations}.
 
 
+@cindex x11,  color de
+@cindex coloreadas, notas de acorde
+@cindex notas coloreadas en acordes
+@cindex color en acordes
+
+@funindex x11-color
+
 @knownissues
 Un color de X11 no es necesariamente de la misma tonalidad exacta que
 un color normal de nombre similar.
@@ -322,10 +384,9 @@ 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{The
-tweak command} para ver más detalles.
+su lugar utilice @code{\tweak}.  Consulte @ref{The tweak command} para
+ver más detalles.
 
 
 @node Parentheses
@@ -336,62 +397,83 @@ tweak command} para ver más detalles.
 @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.  Si se aplica a un acorde,
-encierra cada nota dentro de un par de paréntesis.
+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,relative=2,fragment,verbatim,ragged-right]
+@lilypond[verbatim,quote,relative=2]
 c2 \parenthesize d
 c2 \parenthesize <c e g>
+c2 <c \parenthesize e g>
 @end lilypond
 
 Los objetos que no son notas también se pueden poner entre paréntesis.
+Para las articulaciones se necesita un guión antes de la instrucción
+@code{\parenthesize}.
 
-@lilypond[quote,relative=2,fragment,verbatim,ragged-right]
+@lilypond[verbatim,quote,relative=2]
 c2-\parenthesize -. d
 c2 \parenthesize r
 @end lilypond
 
-@seealso
 
+@seealso
 Fragmentos de código:
 @rlsr{Editorial annotations}.
 
-Referencia de funciionamiento interno:
+Referencia de funcionamiento interno:
 @rinternals{Parenthesis_engraver},
 @rinternals{ParenthesesItem},
 @rinternals{parentheses-interface}.
 
+@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
+@cindex plica, dirección
+@cindex plica arriba
+@cindex plica abajo
+@cindex plica neutral
+
+@funindex \stemUp
+@funindex stemUp
+@funindex \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
+Se puede hacer manualmente que las plicas apunten hacia arriba o hacia
+abajo; véase @ref{Direction and placement}.
 
-@funindex \stemUp
+@predefined
 @code{\stemUp},
-@funindex \stemDown
 @code{\stemDown},
-@funindex \stemNeutral
 @code{\stemNeutral}.
-
+@endpredefined
 
 @snippets
 
-@cindex stem, direction
-@cindex stem, up
-@cindex stem, down
-@cindex stem, neutral
-
-@lilypondfile[verbatim,lilyquote,ragged-right,texidoc]
+@lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
 {default-direction-of-stems-on-the-center-line-of-the-staff.ly}
 
+
 @seealso
 Referencia de la notación:
 @ref{Direction and placement}.
@@ -420,12 +502,27 @@ pentagrama, desde fuera del pentagrama.
 @node Balloon help
 @unnumberedsubsubsec Balloon help
 
+@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[quote,verbatim,fragment,ragged-right,relative=2]
+@lilypond[verbatim,quote,relative=2]
 \new Voice \with { \consists "Balloon_engraver" }
 {
   \balloonGrobText #'Stem #'(3 . 4) \markup { "Soy una plica" }
@@ -436,18 +533,37 @@ esta funcionalidad es la explicación de la notación.
 }
 @end lilypond
 
-@noindent
-Existen dos funciones musicales, @code{balloonText} y
-@code{balloonGrobText}; el primero se usa como @code{\once\override}
-para adjuntar un texto a cualquier grob, y el último se usa coqmo
+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 como
 @code{\tweak}, normalmente dentro de acordes, para adjuntar un texto a
 una nota individual.
 
-@cindex globo
-@cindex notación, explicar la
+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" }
+{
+  \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
+
+
+@predefined
+@code{\balloonLengthOn},
+@code{\balloonLengthOff}.
+@endpredefined
 
-@seealso
 
+@seealso
 Fragmentos de código:
 @rlsr{Editorial annotations}.
 
@@ -460,24 +576,36 @@ Referencia de funcionamiento interno:
 @node Grid lines
 @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.
 
-@c KEEP LY
-@lilypond[quote,verbatim,ragged-right]
+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
-    % preparar la rejilla:
     \consists "Grid_point_engraver"
-    % ajustar el intervalo de la cuadrícula a una negra:
     gridInterval = #(ly:make-moment 1 4)
   }
   \context {
     \Score
-    % por omisión las líneas de rejilla están centradas horizontalmente
-    % debajo y a la izquierda de la cabeza; las líneas parten de la tercera
-    % línea del pentagrama
     \consists "Grid_line_span_engraver"
   }
 }
@@ -499,12 +627,11 @@ sincronizadas con las notas.
 
 @snippets
 
-@lilypondfile[verbatim,lilyquote,ragged-right,texidoc]
+@lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
 {grid-lines--changing-their-appearance.ly}
 
 
 @seealso
-
 Fragmentos de código:
 @rlsr{Editorial annotations}.
 
@@ -522,17 +649,27 @@ Referencia de funcionamiento interno:
 
 @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[quote,verbatim,ragged-right]
+@lilypond[verbatim,quote]
 \layout {
   \context {
-    \Staff
+    \Voice
     \consists "Horizontal_bracket_engraver"
   }
 }
@@ -544,10 +681,10 @@ horizontales simples.
 
 Los corchetes de análisis se pueden anidar.
 
-@lilypond[quote,verbatim,ragged-right]
+@lilypond[verbatim,quote]
 \layout {
   \context {
-    \Staff
+    \Voice
     \consists "Horizontal_bracket_engraver"
   }
 }
@@ -559,8 +696,8 @@ Los corchetes de análisis se pueden anidar.
 }
 @end lilypond
 
-@seealso
 
+@seealso
 Fragmentos de código:
 @rlsr{Editorial annotations}.