position of the tuplet bracket, even if it was not printed. This could
lead to stranded tuplet numbers. Now they are now positioned
closer to the kneed-beam when an appropriate beam segment exists for its
-placement and when the the bracket is not drawn.
+placement and when the bracket is not drawn.
Collision detection is also added, offsetting horizontally if too close
to an adjoining note column but preserving the number's vertical
\clef "varC" c c c c
\clef "altovarC" c c c c
\clef "tenorvarC" c c c c
- \clef "baritonevarC" c c c
+ \clef "baritonevarC" c c c c
\clef "varpercussion" c c c c
@end lilypond
\input texinfo @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
@ignore
- Translation of GIT committish: 93d725094ee629b2d5200ab5a75b609579a62973
+ Translation of GIT committish: 0b49f20966fb8b4e9c9d8ed5699efcff9f805564
When revising a translation, copy the HEAD committish of the
version that you are working on. For details, see the Contributors'
@end ignore
@item
-Ya no se aplica automáticamente la funcionalidad de ajuste de los
-trazos de PostScript, sino que se deja a la discreción del
-dispositivo PostScript (de forma predeterminada, Ghostscript la
-usa para resoluciones de hasta 150ppp cuando se generan imágenes
-de matriz de puntos). Cuando se habilita, se emplea
-(principalmente para las plicas y las barras de compás) un
-algoritmo de trazado más complejo diseñado para sacar provecho del
-ajuste de los trazos.
+Ahora está disponible la instrucción de lista de marcados
+@code{\table}. Cada columna se puede alinear de distinta forma.
+@lilypond[quote,verbatim]
+\markuplist {
+ \override #'(padding . 2)
+ \table
+ #'(0 1 0 -1)
+ {
+ \underline { center-aligned right-aligned center-aligned left-aligned }
+ one "1" thousandth "0.001"
+ eleven "11" hundredth "0.01"
+ twenty "20" tenth "0.1"
+ thousand "1000" one "1.0"
+ }
+}
+@end lilypond
-El ajuste de trazos se puede forzar mediante la especificación de
-la opción de línea de órdenes @samp{-dstrokeadjust} para la
-instrucción LilyPond. Cuando se generan archivos @code{PDF}, esto
-normalmente produce una vista previa de los @code{PDF}
-marcadamente mejorada, pero con un tamaño de archivo
-significativamente más grande. A altas resoluciones, la calidad
-de la impresión puede no resultar afectada.
+@item
+La nueva función de salto de página
+@code{ly:one-line-auto-height-breaking} sitúa una partitura
+completa en una sola línea y cambia la anchura del papel de forma
+correspondiente, de igual manera que @code{ly:one-line-breaking}.
+La diferencia es que también modifica automáticamente la altura de
+la página para que se ajuste a la altura de la música.
@item
-Ahora hay un nuevo tipo de contexto llamado @code{NullVoice} que,
-si bien no aparece en la salida impresa, se puede usar para
-alinear la letra de las canciones. Esto puede ser especialmente
-conveniente cuando se usa en paralelo con una construcción
-@code{\partcombine}.
+Está disponible la instrucción de marcado
+@code{\draw-squiggle-line}. Es posible la personalización a
+través de la sobreescritura de @code{thickness},
+@code{angularity}, @code{height} and @code{orientation}.
+@lilypond[quote,verbatim]
+\markup
+ \overlay {
+ \draw-squiggle-line #0.5 #'(3 . 3) ##t
+
+ \translate #'(3 . 3)
+ \override #'(thickness . 4)
+ \draw-squiggle-line #0.5 #'(3 . -3) ##t
+
+ \translate #'(6 . 0)
+ \override #'(angularity . -5)
+ \draw-squiggle-line #0.5 #'(-3 . -3) ##t
+
+ \translate #'(3 . -3)
+ \override #'(angularity . 2)
+ \override #'(height . 0.3)
+ \override #'(orientation . -1)
+ \draw-squiggle-line #0.2 #'(-3 . 3) ##t
+ }
+@end lilypond
-@lilypond[verbatim,quote]
-soprano = \relative c' { c e g c }
-alto = \relative c' { a c e g }
-verse = \lyricmode { This is my song }
-
-\score {
- \new Staff <<
- \partcombine \soprano \alto
- \new NullVoice = "aligner" \soprano
- \new Lyrics \lyricsto "aligner" \verse
- >>
- \layout {}
+@item
+Existe una instrucción nueva para eliminar los pentagramas vacíos,
+@code{\RemoveAllEmptyStaves}, que actúa de la misma forma que
+@code{\RemoveEmptyStaves}, excepto porque también elimina los
+pentagramas vacíos del primer sistema de una partitura.
+
+@item
+Las instrucciones de marcado @code{\undertie} y @code{\overtie}
+están disponibles, así como la instrucción de marcado genérica
+@code{\tie}.
+@lilypond[quote,verbatim]
+\markup {
+ \undertie "undertied"
+ \overtie "overtied"
+}
+
+m = {
+ c''1 \prall -\tweak text \markup \tie "131" -1
}
-@end lilypond
+{ \voiceOne \m \voiceTwo \m }
+@end lilypond
@item
-Pueden colocarse dentro de una sola variable, o ser devueltas por
-una función de evento, varias articulaciones:
+@code{TabStaff} puede ahora imprimir microtonos para las
+curvaturas de tono y otros efectos.
+@lilypond[quote,verbatim]
+\layout {
+ \context {
+ \Score
+ supportNonIntegerFret = ##t
+ }
+}
-@lilypond[verbatim,quote]
-sempreStacc = -. ^\markup \italic sempre
-\relative { c''4\sempreStacc c c c }
+mus = \relative { c'4 cih d dih }
+
+<<
+ \new Staff << \clef "G_8" \mus >>
+ \new TabStaff \mus
+>>
@end lilypond
@item
-La línea de base de los elementos de marcado que constituyen
-partituras se toma actualmente del punto de referencia
-(normalmente la línea central del pentagrama) del primer sistema
-de la parte inferior, en lugar de la parte superior del rectángulo
-circundante. Lo siguente
+Ahora están disponibles dos estilos nuevos de enmarcado en blanco
+para enmascarar el material de fondo. El estilo @code{outline}
+aproxima los contornos de la forma de un glifo, y la forma se
+produce a partir de un conjunto de copias desplazadas del glifo.
+El estilo @code{rounded-box} produce una forma de rectángulo
+redondeado. Para los tres estilos, incluido el estilo @code{box}
+predeterminado, se puede personalizar el @code{thickness} o grosor
+de la forma del enmarcado en blanco, como un múltiplo del grosor
+de una línea del pentagrama.
+
@lilypond[verbatim,quote]
\markup {
- violin: \score { \new Staff { <g d' a' e''>1 }
- \layout { indent=0 } } ,
- cello: \score { \new Staff { \clef "bass" <c, g, d a> }
- \layout { indent=0 } }
+ \combine
+ \filled-box #'(-1 . 15) #'(-3 . 4) #1
+ \override #'(thickness . 3)
+ \whiteout whiteout-box
+}
+\markup {
+ \combine
+ \filled-box #'(-1 . 24) #'(-3 . 4) #1
+ \override #'(style . rounded-box)
+ \override #'(thickness . 3)
+ \whiteout whiteout-rounded-box
}
-@end lilypond
-tenía anteriormente el siguiente aspecto:
-@lilypond[quote]
\markup {
- violin: \general-align #Y #UP
- \score { \new Staff { <g d' a' e''>1 }
- \layout { indent=0 } } ,
- cello: \general-align #Y #UP
- \score { \new Staff { \clef "bass" <c, g, d a> }
- \layout { indent=0 } }
+ \combine
+ \filled-box #'(-1 . 18) #'(-3 . 4) #1
+ \override #'(style . outline)
+ \override #'(thickness . 3)
+ \whiteout whiteout-outline
+}
+\relative {
+ \override Staff.Clef.whiteout-style = #'outline
+ \override Staff.Clef.whiteout = 3
+ g'1
}
@end lilypond
-sin que hubiera una manera adecuada de hacer que las dos
-partituras estuviesen alineadas.
@item
-LilyPond ya no deduce automáticamente un contexto
-@samp{\defaultchild} dentro de una definición de contexto con
-cláusulas @samp{\accepts}. Cualquier definición de contexto que
-no tenga una definición @samp{\defaultchild} explícita o heredada,
-cuenta como un contexto @samp{Bottom} y es candidato para eventos
-de duraciones y sobreescrituras sin causar la creación implícita
-de otros contextos. Asegúrese de especificar un
-@samp{\defaultchild} para contextos no-@samp{Bottom} al definirlos
-partiendo de cero.
+Todas las instrucciones @code{\override}, @code{\revert},
+@code{\set} y @code{\unset} ahora funcionan con el prefijo
+@code{\once} para hacer ajustes de una sola vez.
+@lilypond[quote,verbatim]
+\relative {
+ c'4 d
+ \override NoteHead.color = #red
+ e4 f |
+ \once \override NoteHead.color = #green
+ g4 a
+ \once \revert NoteHead.color
+ b c |
+ \revert NoteHead.color
+ f2 c |
+}
+@end lilypond
@item
-Ahora están ampliamente contemplados los símbolos de registros de
-acordeón tanto para discanto como bajo en el módulo @samp{scm accreg},
-véase @ruser{Accordion Registers}.
+Al crear una salida MIDI, LilyPond ahora almacena el @code{title}
+que se ha definido en el bloque @code{\header} de la partitura (o,
+si no existe tal definición en el nivel de @code{\score}, la
+primera definición de ese tipo que aparezca en un bloque
+@code{\header} del @code{\bookpart}, @code{\book}, o ámbito de
+nivel superior que encierra a la partitura) como el nombre de la
+secuencia dentro del archivo MIDI. De forma opcional, el nombre
+de la secuencia MIDI se puede sobreescribir usando el nuevo campo
+@code{midititle} del bloque @code{\header} independientemente del
+@code{title} (por ejemplo, en caso de que @code{title} contenga
+código de elementos de marcado que no se convierta automáticamente
+a texto sencillo de manera satisfactoria).
+
+@item
+Las funciones musicales (además de las funciones vacías y de
+Scheme) e instrucciones de marcado que se limitan a aplicar los
+parámetros finales a una cadena de sobreescrituras, se pueden
+definir ahora de forma que solamente escriben la expresión
+interrumpida con @code{\etc}.
+
@lilypond[verbatim,quote]
-#(use-modules (scm accreg))
-\new PianoStaff
-<<
- \new Staff \relative
- { \clef "treble" \discant "10"
- r8 s32 f'[ bes f] s e[ a e] s d[ g d] s16 e32[ a]
- \discant "121"
- << { r16 <f bes> r <e a> r <d g> } \\
- { d r a r bes r } >> |
- <cis e a>1
- }
- \new Staff \relative
- { \clef "treble" \freeBass "1"
- r8 d'32 s16. c32 s16. bes32 s16. a32[ cis] s16
- \clef "bass" \stdBass "Master"
- << { r16 <f, bes d>^"b" r <e a c>^"am" r <d g bes>^"gm" |
- <e a cis>1^"a" } \\
- { d8_"D" c_"C" bes_"B" | a1_"A" }
- >>
- }
->>
+bold-red-markup = \markup \bold \with-color #red \etc
+highlight = \tweak font-size 3 \tweak color #red \etc
+
+\markup \bold-red "text"
+\markuplist \column-lines \bold-red { One Two }
+
+{ c' \highlight d' e'2-\highlight -! }
@end lilypond
@item
-Las nuevas instrucciones @code{markLengthOn} y
-@code{markLengthOff} controlan si se permite la existencia de un
-espacio horizontal para las letras de ensayo e indicaciones de
-tempo.
+Las funciones de LilyPond definidas con
+@code{define-music-function}, @code{define-event-function},
+@code{define-scheme-function} y @code{define-void-function} ahora
+se pueden llamar directamente desde Scheme como si fuesen
+procedimientos de Scheme reales. Se sigue efectuando una
+comprobación de los argumentos en su número y tipo de la misma
+forma que cuando se llama a la función a través de código de
+LilyPond. Esto incluye la inserción de valores predeterminados
+para los argumentos opcionales que no se corresponden con sus
+predicados. En lugar de usar @code{\default} en la propia lista
+de argumentos para saltar explícitamente una secuencia de
+argumentos opcionales, se puede emplear @code{*unspecified*}.
+
+@item
+La posición actual del cursor de entrada y del analizador
+sintáctico se almacenan ahora dentro de fluidos de GUILE y se
+pueden referenciar a través de las llamadas de función
+@code{(*location*)} y @code{(*parser*)}. Como consecuencia, un
+gran número de funciones que anteriormente tomaban un argumento
+@code{parser} explícito, ya no lo hacen.
+
+Las funciones definidas con @code{define-music-function},
+@code{define-event-function}, @code{define-scheme-function} y
+@code{define-void-function} ya no usan los argumentos
+@code{parser} @code{location}.
+
+Con estas definiciones, LilyPond trata de reconocer el uso
+obsoleto de los argumentos @code{parser} y @code{location},
+ofreciendo durante algún tiempo una semántica compatible hacia
+atrás.
+
+@item
+En el idioma de nombre de nota "english", los nombres largos de
+las alturas con alteración ahora contienen un guión para una mejor
+legibilidad. Ahora se debe escribir
+@example
+\key a-flat \major
+@end example
+en lugar de
+@example
+\key aflat \major
+@end example
+como se hacía antes.
+
+Las alteraciones dobles no llevan otro guión, de forma que el
+holandés @code{cisis} lleva el nombre largo @code{c-sharpsharp} en
+inglés.
+@item
+El estilo visual de las barras de trémolo (forma, estilo e
+inclinación) se controla ahora con más precisión.
@lilypond[quote,relative=2]
-\markLengthOn
-\compressFullBarRests
-\tempo "Molto vivace" c2 c'
-\mark\default
-\tempo "Meno mosso" R1*16
-\mark\default
-g,2 g
-\bar "||"
-\markLengthOff
-\tempo "Molto vivace" c2 c'
-\mark#1
-\tempo "Meno mosso" R1*16
-\mark\default
-g,2 g
+ a8:32 b: c: d:
+ \override StemTremolo.shape = #'beam-like
+ a: b: c: d:
+ \override StemTremolo.style = #'constant
+ a: b: c: d:
+ g,2
@end lilypond
+
@item
-Ahora las letras de ensayo al principio de una línea se sitúan de
-forma predeterminada a la derecha de la clave y la armadura. Como
-en versiones anteriores, la interfaz
-@code{break-alignable-interface} controla el comportamiento.
+Los silencios de varios compases tienen una longitud que depende
+de su duración, bajo el control de
+@code{MultiMeasureRest.space-increment}.
+@lilypond[quote]
+{ \compressFullBarRests
+ \override Staff.MultiMeasureRest.space-increment = 3.0
+ R1*2 R1*12 R1*64 }
+@end lilypond
-@lilypond[quote,relative=2]
-\set Score.barNumberVisibility = #all-bar-numbers-visible
-\set Timing.currentBarNumber = #72
-\bar"||" \time 3/4 \key e\major \mark#10 \tempo "Adagio" b2.
+@item
+Los números de página se pueden imprimir ahora en números romanos,
+fijando el valor de la variable @code{page-number-type} del bloque
+@code{\paper}.
+
+@item
+Ahora se pueden usar @code{\time} y @code{\partial} combinados
+para cambiar la indicación de compás en la mitad de un compás.
+
+@lilypond[verbatim,quote,relative=1]
+\override Score.BarNumber.break-visibility = #end-of-line-invisible
+\partial 4 \time 3/4 f4 | 2 4 | 2 \bar "||"
+\time 9/8 \partial 4. f8 8 8 | 2. 8 8 8 |
@end lilypond
@item
-Ahora se pueden escribir directamente números decimales dentro de
-la música, sin el prefijo del símbolo de almohadilla. Junto al
-cambio anterior en la forma de especificar las propiedades de los
-objetos, el código para modificar la longitud de las plicas ha
-cambiado de esto:
+Ahora es posible la sobreescritura de la propiedad @code{text} de
+los nombres de acorde.
+
+@lilypond[verbatim,fragment,quote]
+<<
+\new ChordNames \chordmode {
+ a' b c:7
+ \once \override ChordName.text = #"foo"
+ d
+}
+>>
+@end lilypond
+
+@item
+Se ha mejorado la alineación horizontal cuando se usa
+@code{TextScript}, con @code{DynamicText} o con @code{LyricText}.
+
+@item
+Se ha añadido una instrucción nueva @code{\magnifyStaff} que
+cambia la escala visual de los pentagramas, líneas, barras de
+compás, barras cortadas y el espaciado horizontal general en el
+nivel del contexto de @code{Staff}. Se evita que las líneas del
+pentagrama disminuyan a un tamaño menor que el predeterminado
+porque todos los grosores de las plicas, ligaduras y otros objetos
+gráficos están basados en el grosor de las líneas del pentagrama.
+
+@item
+@code{InstrumentName} contempla ahora el @code{text-interface}.
+
+@item
+Se contempla ahora el control del @q{nivel de expresión} de los
+canales MIDI usando la propiedad de contexto
+@code{Staff.midiExpression}. Se puede usar para alterar incluso
+el volumen percibido de notas mantenidas (si bien a muy @q{bajo
+nivel}) y acepta un valor numérico entre @code{0.0} y @code{1.0}.
+
@example
-\override Stem #'length = #5.6
-e' f' g' a'
+\score @{
+ \new Staff \with @{
+ midiExpression = #0.6
+ midiInstrument = #"clarinet"
+ @}
+ <<
+ @{ a'1~ a'1 @}
+ @{
+ \set Staff.midiExpression = #0.7 s4\f\<
+ \set Staff.midiExpression = #0.8 s4
+ \set Staff.midiExpression = #0.9 s4
+ \set Staff.midiExpression = #1.0 s4
+
+ \set Staff.midiExpression = #0.9 s4\>
+ \set Staff.midiExpression = #0.8 s4
+ \set Staff.midiExpression = #0.7 s4
+ \set Staff.midiExpression = #0.6 s4\!
+ @}
+ >>
+ \midi @{ @}
+@}
@end example
-a esto:
+
+@item
+Se ha añadido la posibiliidad de hacer más fácil usar tipografías
+alternativas @q{de música} diferentes de la predeterminada
+Emmentaler de LilyPond. Véase
+@uref{http://fonts.openlilylib.org/} para más información.
+
+@item
+Los @q{grobs} u objetos gráficos y sus ancestros se pueden ahora
+alinear separadamente permitiendo más flexibilidad para las
+posiciones de los grobs. Por ejemplo, el borde izquierdo de un
+grob se puede alinear sobre el centro de su ancestro.
+
+@item
+Se han hecho mejoras en la instrucción @code{\partial} para evitar
+problemas cuando se usa en varios contextos en paralelo.
+
+@item
+@code{\chordmode} puede usar ahora las construcciones @code{< >} y
+@code{<< >>}.
+
+@item
+Se ha añadido una instrucción @code{\tagGroup} que complementa a
+las instrucciones existentes @code{\keepWithTag} y
+@code{\removeWithTag}. Por ejemplo:
+
@example
-\override Stem.length = 5.6
-e' f' g' a'
+\tagGroup #'(violinI violinII viola cello)
@end example
-Se debe escribir un dígito a ambos lados del punto; no se permiten
-valores como @code{4.} ó @code{-.3}.
+declara una lista de @q{tags} o etiquetas que pertenecen a un solo
+@q{tag group} o grupo de etiquetas.
-Asimismo, no se admiten fracciones decimales dentro de
-@code{\chordmode}.
+@example
+\keepWithTag #'violinI
+@end example
+
+se ocupa solamente de las @q{tags} del grupo de etiquetas
+@q{violinI}.
+
+Cualquier elemento de la música incluida que lleve una o más
+etiquetas del grupo, pero @emph{no} la etiqueta @var{violinI},
+será eliminado.
@item
-Se pueden redefinir libremente ciertas abreviaturas como @code{(},
-@code{)}, @code{|}, @code{[}, @code{]}, @code{~}, @code{\(},
-@code{\)} y otras, como instrucciones normales. Un ejemplo sería
-@lilypond[verbatim,quote]
-"\\{" = (
-"\\}" = )
-"(" = \melisma
-")" = \melismaEnd
+La función @code{\addlyrics} funciona ahora con contextos
+arbitrarios, entre ellos @code{Staff}.
-\new Staff <<
- \relative c' {
- c8 \{ d e f \} % slurred
- g ( a b c ) % no slur, but with melisma
- c,1 \bar "|."
- }
- \addlyrics { Li -- ly -- pond. }
->>
+@item
+Ahora se pueden usar también los números de cuerda para imprimir
+números romanos (p. ej. para instrumentos de cuerda sin trastes).
+@lilypond[verbatim,quote,relative=2]
+c2\2
+\romanStringNumbers
+c\2
+\arabicStringNumbers
+c1\3
@end lilypond
@item
-El nombre de la abreviatura de articulación para
-@code{\staccatissimo} ha cambiado de @code{-|} a@tie{}@code{-!}.
+El nombre de la propiedad @code{thin-kern} del objeto gráfico
+@code{BarLine} ha cambiado a @code{segno-kern}.
@item
-Ahora se escriben los rangos de cambios de tempo como @code{\tempo
-4 = 60 - 68} en lugar de @code{\tempo 4 = 60 ~ 68}.
+Los objetos gráficos @code{KeyCancellation} ahora ignoran las
+claves de las notas guía (como hacen los objetos
+@code{KeySignature}).
@item
-Se ha cambiado el nombre de @code{OctavateEight} por el de
-@code{ClefModifier}. Las propiedades de contexto relacionadas han
-cambiado su nombre @code{xxxOctavationyyy} por el de
-@code{xxxTranspositionyyy}.
+Se contempla ahora @code{\once@tie{}\unset}
@item
-Existe una nueva instrucción @code{\absolute} que marca
-explícitamente la música introducida en alturas absolutas. Aunque
-esto era antes el comportamiento predeterminado, una instrucción
-@code{\absolute} explícita evita también la reinterpretación
-cuando el pasaje está dentro de un bloque marcado como
-@code{\relative}:
-@lilypond[verbatim,quote]
-\relative c { c'4 \absolute { f'' g'' } c }
+Ahora es posible colorear independientemente tanto los puntos como
+los paréntesis en los diagramas de posición de acordes, si se usa
+la instrucción de marcado @code{\fret-diagram-verbose}.
+
+@lilypond[verbatim,quote,relative=1]
+\new Voice {
+ c1^\markup {
+ \override #'(fret-diagram-details . (
+ (finger-code . in-dot))) {
+ \fret-diagram-verbose #'((mute 6)
+ (place-fret 5 3 1 red)
+ (place-fret 4 5 2 inverted)
+ (place-fret 3 5 3 green)
+ (place-fret 2 5 4 blue inverted)
+ (place-fret 1 3 1 violet)
+ (barre 5 1 3 ))
+ }
+ }
+ c1^\markup {
+ \override #'(fret-diagram-details . (
+ (finger-code . below-string))) {
+ \fret-diagram-verbose #'((mute 6)
+ (place-fret 5 3 1 red parenthesized)
+ (place-fret 4 5 2 yellow
+ default-paren-color
+ parenthesized)
+ (place-fret 3 5 3 green)
+ (place-fret 2 5 4 blue )
+ (place-fret 1 3 1)
+ (barre 5 1 3))
+ }
+ }
+}
@end lilypond
@item
-Cuando se utiliza @code{\relative} sin emplear como referencia una
-altura explícita, se toma como referencia el centro de la primera
-octava, haciendo que no se pueda distinguir si la primera nota que
-se introduce es relativa o absoluta. Anteriormente, la omisión de
-una altura de referencia habría llevado a una altura
-predeterminada de @code{c'} (el Do central). Dado que la
-mencionada elección es, hasta cierto punto, arbitraria, la forma
-de uso recomendada es que se especifique siempre una altura de
-referencia.
+Se han añadido dos propiedades nuevas para usarlas dentro de
+@code{fret-diagram-details} con la instrucción de marcado
+@code{\fret-diagram-verbose}; @code{fret-label-horizontal-offset},
+que afecta a la @code{fret-label-indication}, y
+@code{paren-padding}, que controla la distancia entre el puntillo
+y los paréntesis que lo rodean.
+
+@lilypond[verbatim,quote,relative=1]
+\new Voice {
+ c1^\markup {
+ \fret-diagram-verbose #'((mute 6)
+ (place-fret 5 3 1)
+ (place-fret 4 5 2)
+ (place-fret 3 5 3)
+ (place-fret 1 6 4 parenthesized)
+ (place-fret 2 3 1)
+ (barre 5 2 3))
+ }
+ c1^\markup {
+ \override #'(fret-diagram-details . (
+ (fret-label-horizontal-offset . 2)
+ (paren-padding . 0.25))) {
+ \fret-diagram-verbose #'((mute 6)
+ (place-fret 5 3 1)
+ (place-fret 4 5 2)
+ (place-fret 3 5 3)
+ (place-fret 1 6 4 parenthesized)
+ (place-fret 2 3 1)
+ (barre 5 2 3))
+ }
+ }
+}
+@end lilypond
@item
-Se puede usar la nueva instrucción @code{\single} para convertir
-la sobreescritura de una propiedad en un truco que se aplica a una
-expresión musical única:
+Se ha añadido una instrucción de marcado nueva,
+@code{\justify-line}. Similar a la instrucción de marcado
+@code{\fill-line} excepto que en lugar de disponer @emph{palabras}
+en columnas, la instrucción @code{\justify-line} equilibra la
+distancia entre ellas, haciendo que cuando hay tres o más palabras
+en una instrucción de marcado, las distancias sean siempre
+consistentes.
-@lilypond[quote,verbatim,relative=2]
-<a \single\voiceTwoStyle e' a>1
+@lilypond[quote,verbatim,papersize=a6]
+\markup \fill-line {oooooo oooooo oooooo oooooo}
+\markup \fill-line {ooooooooo oooooooo oo ooo}
@end lilypond
-@item
-Dos maneras de hacer que los objetos gráficos no aparezcan en la
-salida son: sobreescribir su propiedad @code{transparent} con un
-valor verdadero @code{#t} (reteniendo el espaciado original), o
-sobreescribiendo su propiedad @code{stencil} o sello con un valor
-falso @code{#f} (que no ocupa ningún espacio). Estas dos
-operaciones tienen ahora las formas cortas @code{\hide} (ocultar)
-y @code{\omit} (omitir), respectivamente. A estas instrucciones
-puede dárseles una expresión musical sobre la que efectuar el
-trucaje, o bien el nombre de un objeto gráfico para el que se debe
-crear la sobreescritura (para especificar los dos, utilice
-@code{\single} sobre la instrucción en forma de sobreescritura):
+@lilypond[quote,verbatim,papersize=a6]
+\markup \justify-line {oooooo oooooo oooooo oooooo}
+\markup \justify-line {ooooooooo oooooooo oo ooo}
+@end lilypond
-@lilypond[quote,verbatim]
-\new Staff \with { \omit Clef }
-\relative c'' <a e' \hide a>1
+@item
+Se ha añadido la instrucción @code{\magnifyMusic}, que permite
+modificar el tamaño de la notación sin alterar el tamaño del
+pentagrama, mientras que se escalan automáticamente las plicas,
+barras y el espaciado horizontal.
+@lilypond[verbatim,quote]
+\new Staff <<
+ \new Voice \relative {
+ \voiceOne
+ <e' e'>4 <f f'>8. <g g'>16 <f f'>8 <e e'>4 r8
+ }
+ \new Voice \relative {
+ \voiceTwo
+ \magnifyMusic 0.63 {
+ \override Score.SpacingSpanner.spacing-increment = #(* 1.2 0.63)
+ r32 c'' a c a c a c r c a c a c a c
+ r c a c a c a c a c a c a c a c
+ }
+ }
+>>
@end lilypond
@item
-Se puede aplicar la nueva instrucción @code{\temporary} a las
-sobreescrituras para hacer que no sustituyan a los ajustes de
-propiedad previos. Si se aplica una instrucción de reversión
-@code{\revert} a la misma propiedad varias veces seguidas, el
-ajuste anterior reaparece:
-
-@lilypond[quote,verbatim,relative=2]
-\override NoteHead.color = #red c4
-\override NoteHead.color = #green d
-\revert NoteHead.color e2
-\override NoteHead.color = #red c4
-\temporary\override NoteHead.color = #green d
-\revert NoteHead.color e
-\revert NoteHead.color c
+Se ha añadido una plantilla flexible adecuada para una amplia
+variedad de piezas de música coral. Se puede usar para crear
+música coral sencilla, con o sin acompañamiento de piano, en dos o
+en cuatro pentagramas. A diferencia de otras, esta plantilla está
+@q{incorporada}, lo que significa que no necesita ser copiada y
+editada: en lugar de ello sencillamente se incluye con la
+instrucción @code{\include} en el archivo de entrada. Para ver
+más detalles, consulte @rlearning{Plantillas incorporadas}.
+
+@item
+Se ha mejorado significativamente el posicionado de los números de
+grupos especiales para las barras en forma de codo.
+Anteriormente, los números de grupo especial se colocaban de
+acuerdo a la posición del corchete del grupo, incluso si éste no
+se imprimía. Ello podía dar lugar a números de tresillo
+descolocados. Ahora se sitúan más cerca de la barra cuando hay un
+segmento de barra adecuado para su colocación y cuando el corchete
+no se dibuja.
+
+Se ha añadido también detección de colisiones, desplazando
+horizontalmente si está demasiado cerca de una columna de notas
+adyacente pero preservando la distancia vertical del número a la
+barra acodada. Si el propio número es demasiado grande como para
+caber en el espacio disponible, se usa en su lugar el sistema
+original de posicionamiento basado en el corchete; en cambio, en
+caso de colisión (p. ej. con una alteración accidental) el número
+de tresillo se aleja moviéndolo verticalmente.
+
+@lilypond[verbatim,fragment,quote,relative=1]
+\time 3/4
+\override Beam.auto-knee-gap = 3
+\tuplet 3/2 4 {
+ g8 c'' e,
+ c'8 g,, e''
+ g,,8 e''' c,,
+}
@end lilypond
-Esto tiene utilidad principalmente para la escritura de funciones
-musicales que se desea que tengan alguna propiedad modificada
-solamente por un tiempo igual a la duración de la función.
+@noindent
+El comportamiento original del tresillo para las barras acodadas
+aún está disponible mediante una sobreescritura con la instrucción
+@code{\override} a travé de la nueva propiedad
+@code{knee-to-beam}.
+
+@lilypond[verbatim,fragment,quote,relative=1]
+\time 3/4
+\override Beam.auto-knee-gap = 3
+\override TupletNumber.knee-to-beam = ##f
+\tuplet 3/2 4 {
+ g8 c'' e,
+ c'8 g,, e''
+ g,,8 e''' c,,
+}
+@end lilypond
@item
-Las instrucciones @code{\tag}, @code{\removeWithTag} y
-@code{\keepWithTag} ahora admiten una lista de símbolos en lugar
-de un solo símbolo para marcar, eliminar y seleccionar música que
-esté etiquetada con una cualquiera de la lista de etiquetas. Esto
-es de especial importancia para @code{\keepWithTag} porque no es
-posible conseguir el mismo efecto usando varias instrucciones
-@code{\keepWithTag} consecutivas.
+Se han @q{armonizado} las instrucciones @code{\lyricsto} y
+@code{\addLyrics}. Ambas aceptan ahora el mismo tipo de lasta de
+argumentos delimitada que aceptan @code{\lyrics} y @code{\chords}.
+Se añade compatibilidad hacia atrás de manera que se permiten como
+argumentos identificadores musicales (p. ej. @code{\mus}). Se ha
+añadido una regla de @code{convert-ly} que elimina los usos
+redundantes de @code{\lyricmode} y reorganiza las combinaciones
+con iniciadores de contexto de forma que @code{\lyricsto} en
+general se aplica al final (es decir, como lo haría
+@code{\lyricmode}).
@item
-La opción @samp{-d old-relative} se ha eliminado. Ya no está
-accesible a través de la línea de órdenes; la utilidad que aún
-conservaba era la interpretación de @code{\relative} en archivos
-de LilyPond convertidos automáticamente de las versiones@tie{}1.8
-o anteriores. No está claro cuántas de tales versiones estaban
-aún en funcionamiento.
+Las funciones e identificadores de Scheme se pueden usar ahora
+como definiciones de salida.
@item
-Se ha invertido el significado de @code{instrumentTransposition}.
-Después de
-@example
-\set instrumentTransposition = #@{ b #@}
-@end example
-una nota escrita @code{c'} ahora suena como @code{b}.
-Anteriormente era a la inversa. Esperamos que este cambio y el
-siguiente hagan más sencillo el tratamiento de los instrumentos
-transpositores.
-
-@item
-La música generada por las instrucciones @code{\set} y
-@code{\override} ya no resulta afectada por la instrucción
-@code{\transpose}. La consecuencia más importante es que
-@code{\transpose} transporta la altura tonal sonora o de concierto
-y la que se imprime en la misma medida incluso aunque la música
-que se transporta contenga @code{\transposition}. Anteriormente,
-@example
-\transpose c' f' \transposition bes'
-@end example
-era equivalente a @code{\transposition f'}. Ahora se mantiene
-como equivalente a @code{\transposition bes'}.
-
-@item
-Cuando se comprueba la existencia de colisiones, LilyPond ya no
-trata los objetos como rectángulos. En lugar de ello se aproxima
-la forma verdadera de los objetos utilizando un enfoque parecido
-al uso de integrales, lo que por lo común dará como resultado un
-posicionamiento más ceñido y regular de los objetos y los sistemas
-de pentagramas:
-
-@lilypond[relative=1]
-#(ly:set-option 'debug-skylines #t)
-\dynamicUp
-c'4\f a4\f d\f( f)
-a,4\< c c c\!
-d4-.\downbow a4^"r'venu..." c \tempo "T1" e
-@end lilypond
+Las expresiones de Scheme se pueden usar ahora como constituyentes
+de acordes.
-El fragmento anterior tenía anteriormente este aspecto:
-
-@lilypond[relative=1]
-#(ly:set-option 'debug-skylines #t)
-\override Hairpin #'vertical-skylines = #'()
-\override DynamicText #'vertical-skylines = #'()
-\override TextScript #'vertical-skylines = #'()
-\override Score.MetronomeMark #'vertical-skylines = #'()
-\override Staff.Clef #'vertical-skylines = #'()
-\dynamicUp
-c'4\f a4\f d\f( f)
-a,4\< c c c\!
-d4-.\downbow a4^"r'venu..." c \tempo "T1" e
-@end lilypond
+@item
+Espaciado visual mejorado de las cabezas de nota con formas @q{MI}
+Funk y Walker pequeñas y normales, de forma que tengan la misma
+anchura que otras notas con forma dentro de sus respectivos
+conjuntos. Las cabezas del tipo @code{SOL} también han mejorado
+visualmente cuando se usan tanto con las cabezas normales de tipo
+Aiken como con las de tipo Sacred Harp, así como con las variantes
+de línea delgada.
-Entre los objetos afectados se encuentran @code{Accidentals},
-@code{Beams}, @code{Clefs}, @code{Dynamics}, @code{FiguredBass},
-@code{Flags}, @code{Glissandos}, @code{Lyrics},
-@code{MetronomeMarks}, @code{OttavaBrackets}, @code{Pedals},
-@code{RehearsalMarks}, @code{Rests}, @code{Scripts},
-@code{TextScripts}, @code{Ties}, @code{Tuplets} y
-@code{VoltaBrackets}.
-
-@item
-Ahora los grupos de valoración especial se crean mediante la
-instrucción @code{\tuplet}, que toma una fracción
-@code{@var{t}/@var{n}} para especificar que se tocan @var{t} notas
-en el tiempo en que habitualmente se permite un número de
-@var{n}. Una sola instrucción @code{\tuplet} puede crear varios
-grupos especiales si su duración se inserta después de la
-fracción.
-@lilypond[quote,verbatim,relative=2]
-\tuplet 3/2 { c8 d e } \tuplet 3/2 { f e d } c2
-\tuplet 3/2 4 { c8 d e f e d } c2
-@end lilypond
-La instrucción @code{\times} con el orden de la fracción invertido
-@code{@var{n}/@var{t}} aún está disponible.
+@item
+@code{LeftEdge} tiene ahora unas dimensiones verticales
+@code{Y-extent} definibles. Véase @rinternals{LeftEdge}.
+
+@item
+Se ha añadido una función nueva @code{make-path-stencil} que
+contempla todas las instrucciones @code{path} tanto relativas como
+absolutas: @code{lineto}, @code{rlineto}, @code{curveto},
+@code{rcurveto}, @code{moveto}, @code{rmoveto}, @code{closepath}.
+
+La función también contempla la sintaxis de @q{letra única}
+utilizada en las instrucciones de ruta estándares del SVG:
+@code{L}, @code{l}, @code{C}, @code{c}, @code{M}, @code{m},
+@code{Z} y @code{z}.
+
+Asimismo, la nueva instrucción es compatible hacia atrás con la
+función original @code{make-connected-path-stencil}. Véase
+también @file{scm/stencil.scm}.
@item
-Se introducen dos instrucciones nuevas de marcado:
-@code{\draw-dashed-line} (trazar línea discontinua) y
-@code{\draw-dotted-line} (trazar línea de puntos).
+Las propiedades de contexto nombradas en la propiedad
+@samp{alternativeRestores} se restauran a su valor al comienzo de
+la @emph{primera} alternativa en todas las alternativas
+siguientes.
+
+Actualmente el conjunto predeterminado restaura el @q{compás
+actual}:
+
+@lilypond[verbatim,fragment,quote,relative=2]
+\time 3/4
+\repeat volta 2 { c2 e4 | }
+\alternative {
+ { \time 4/4 f2 d | }
+ { f2 d4 | }
+}
+g2. |
+@end lilypond
@noindent
-La línea discontinua se extiende sobre toda la longitud dada por
-@var{destino}, si @code{full-length} está establecido al valor
-@code{#t} (que es lo predeterminado) sin ningún espacio al
-principio ni al final. Entonces, @code{final} se altera de forma
-que quepa. Para insistir en los valores dados (o predeterminados)
-para @code{inicio} y @code{final} utilice @code{\override
-#'(full-length . #f)}. Son posibles ajustes manuales para
-@code{inicio}, @code{final} y @code{fase}.
+la @q{posición dentro del compás}:
+
+@lilypond[verbatim,fragment,quote,relative=2]
+\time 3/4
+\repeat volta 2 { c2 e4 | }
+\alternative {
+ { \time 4/4
+ \set Timing.measurePosition = #(ly:make-moment -1/2)
+ f2 | }
+ { f2 d4 | }
+}
+g2. |
+@end lilypond
@noindent
-La línea de puntos siempre se extiende a la longitud completa dada
-por @var{destino}, sin ningún espacio al principio ni al final.
-Es posible ajustar manualmente @code{final} para obtener espacios
-mayores o menores entre los puntos. El valor dado (o
-predeterminado) de @code{final} se altera de forma que corresponda
-a la longitud de la línea, @code{line-length}.
+y los @q{cambios de acorde};
-@lilypond[verbatim,quote]
-\markup {
- \draw-dashed-line #'(5.1 . 2.3)
- \override #'(on . 0.3)
- \override #'(off . 0.5)
- \draw-dashed-line #'(5.1 . 2.3)
- \draw-dotted-line #'(5.1 . 2.3)
- \override #'(thickness . 2)
- \override #'(off . 0.2)
- \draw-dotted-line #'(5.1 . 2.3)
+@lilypond[verbatim,fragment,quote]
+<<
+ \new ChordNames {
+ \set chordChanges = ##t
+ \chordmode { c1:m d:m c:m d:m }
+ }
+ \new Staff {
+ \repeat volta 2 { \chordmode { c1:m } }
+ \alternative {
+ { \chordmode { d:m } }
+ { \chordmode { c:m } }
+ }
+ \chordmode { d:m }
}
+>>
@end lilypond
@item
-A partir de la versión@tie{}2.17.10, los mensajes de error o la
-@acronym{URI} de @code{textedit} que se usa para la funcionalidad
-«apuntar y pulsar» especifican los números de columna empezando
-en@tie{}1 en vez de en@tie{}0. El desplazamiento de bytes (que
-también forma parte de las @acronym{URI}s de @code{textedit}) aún
-comienza en@tie{}0.
+Salida MIDI mejorada para las marcas de respiración. Después de
+las notas unidas mediante una ligadura, las respiraciones toman la
+duración @emph{solo} de la última nota de la ligadura; p. ej.
+@code{@{ c4~ c8 \breathe @}} se ejecuta como @code{@{ c4~ c16 r
+@}} en lugar de @code{@{ c4 r8 @}}. Esto es más consistente con
+las articulaciones y con la forma en que los humanos interpretan
+las respiraciones después de las ligaduras de unión. También hace
+que ahora sea más fácil alinear varias marcas de respiración
+simultáneas sobre más de una parte, aunque las notas tengan
+distintas duraciones.
+
+@item
+Se ha añadido un nuevo estilo de cabeza de nota para la tablatura:
+@code{TabNoteHead.style = #'slash}.
+
+@item
+Se ha añadido cuatro nuevos glifos de clave @emph{Doble de Sol},
+@emph{Sol de tenor}, @emph{Variante de percusión} y @emph{Variante
+de Do} así como sus correspondientes formas reducidas de cambio de
+clave.
+@lilypond[verbatim,quote,fragment]
+ \override Staff.Clef.full-size-change = ##t
+
+ \clef "GG" c c c c
+ \clef "tenorG" c c c c
+ \clef "varC" c c c c
+ \clef "altovarC" c c c c
+ \clef "tenorvarC" c c c c
+ \clef "baritonevarC" c c c c
+ \clef "varpercussion" c c c c
+
+ \break
+ \override Staff.Clef.full-size-change = ##f
+
+ \clef "GG" c c c c
+ \clef "tenorG" c c c c
+ \clef "varC" c c c c
+ \clef "altovarC" c c c c
+ \clef "tenorvarC" c c c c
+ \clef "baritonevarC" c c c c
+ \clef "varpercussion" c c c c
+@end lilypond
@item
-La instrucción @code{\clef} contempla una transposición opcional:
-@lilypond[verbatim,quote,relative=1]
-\clef "treble_(8)"
-c2 c
-\clef "bass^[15]"
-c2 c
+Las duraciones aisladas en las secuencias musicales ahora tienen
+el significado de notas sin altura. Esto puede ser de utilidad
+para especificar duraciones de música o de funciones de Scheme.
+Cuando se encuentran en la partitura final, las alturas vienen
+provistas por la nota o acorde anterior. He aquí dos ejemplos en
+los que se aprecia que produce una entrada más legible:
+
+@lilypond[verbatim,quote]
+\new DrumStaff \with { \override StaffSymbol.line-count = 1 }
+\drummode {
+ \time 3/4
+ tambourine 8 \tuplet 3/2 { 16 16 16 }
+ 8 \tuplet 3/2 { 16 16 16 } 8 8 |
+}
+@end lilypond
+
+@lilypond[verbatim,quote]
+\new Staff { r16 c'16 ~ 8 ~ 4 ~ 2 | }
@end lilypond
@item
-Se ha hecho que la sintaxis de LilyPond de palabras separadas por
-puntos @code{Voice.Accidental} sea intercambiable con
-@code{#'(Voice Accidental)}, una lista de Scheme de símbolos.
-Como resultado, código del estilo de
-@example
-\override Voice.TextSpanner #'(bound-details left text) = "rit."
-@end example
-ahora es equivalente a
+@code{\displayLilyMusic} y sus funciones de Scheme subyacentes ya
+no omiten las duraciones de nota redundantes. Ello hace que sea
+más fácil reconocer correctamente y formatear las duraciones
+aisladas en expresiones como
@example
-\override Voice.TextSpanner bound-details.left.text = "rit."
-@end example
-o incluso a
-@example
-\override #'(Voice TextSpanner) bound-details.left.text = "rit."
+@{ c4 d4 8 @}
@end example
@item
-La ruta a un grob y a una propiedad de un grob ya no requieren que
-se especifiquen como dos argumentos distintos a instrucciones como
-@samp{\override} y @code{\revert}, permitiendo la sintaxis
-siguiente:
+Las excepciones en el barrado se pueden construir ahora usando la
+función de Scheme @code{\beamExceptions}. Ahora se puede escribir
+
+@lilypond[verbatim,quote,relative=1]
+\time #'(2 1) 3/16
+\set Timing.beamExceptions =
+ \beamExceptions { 32[ 32] 32[ 32] 32[ 32] }
+c16 c c |
+\repeat unfold 6 { c32 } |
+@end lilypond
+
+@noindent
+con las diversas excepciones separadas mediante comprobaciones de
+compás @code{|} (la escritura del patrón de la excepción la altura
+de las notas es conveniente pero no obligatorio). Anteriormente
+habría sido necesario escribir las excepciones del barrado como
+
@example
-\override Voice.TextSpanner.bound-details.left.text = "rit."
+\set Timing.beamExceptions =
+#'( ;start of alist
+ (end . ;entry for end of beams
+ ( ;start of alist of end points
+ ((1 . 32) . (2 2 2)) ;rule for 1/32 beams -- end each 1/16
+ )))
@end example
-Dado que las funciones musicales complementarias como
-@samp{\overrideProperty} no contemplan formas con y sin espacios
-de separación al mismo tiempo, la utillización de una sola ruta
-con puntos es ahora la forma de preferencia. La especificación
-separada de la ruta de un grob y de la propiedad del grob,
-contemplada aún por parte de @samp{\override} y de @samp{\revert}
-por motivos de compatibilidad, se considera ahora obsoleta.
-
-@item
-Debido a que dos palabras se aceptan ahora como símbolos que son
-argumentos de función, las interfaces de @samp{\accidentalStyle},
-@samp{\alterBroken}, @samp{\footnote} y @samp{\tweak} han tenido
-que ser rediseñadas allí donde estaban implicados símbolos que
-eran argumentos opcionales. Compruebe la documentación de la
-función respectiva para ver los detalles.
-
-@item
-Varias instrucciones aceptan ahora listas de símbolos
-(introducidas convenientemente como palabras separadas por puntos)
-para diversos tipos de argumentos. Entre ellos se encuentran
-@samp{\accidentalStyle}, @samp{\alterBroken}, @samp{\footnote},
-@samp{\hide}, @samp{\omit}, @samp{\overrideProperty},
-@samp{\shape} y @samp{\tweak}.
-
-@item
-Se ha modificado la interfaz de usuario de las líneas divisorias.
-Los glifos de barra de compás ahora se asemejan al aspecto de los
-caracteres utilizados para expresar el tipo de barra, de manera
-que un signo de repetición por la izquierda se debe codificar como
-@code{.|:}. La instrucción @code{\defineBarLine} provee una
-manera sencilla de definir estilos adicionales de línea divisoria.
-
-@item
-Las alteraciones accidentales en la armadura de la tonalidad se
-pueden imprimir en distinta octava de las posiciones
-tradicionales, o en más de una octava.
-@lilypond[quote,relative=0]
-\override Staff.KeySignature #'flat-positions = #'((-5 . 5))
-\override Staff.KeyCancellation #'flat-positions = #'((-5 . 5))
-\clef bass \key es \major es g bes d
-\clef treble \bar "||" \key es \major es g bes d
-\override Staff.KeySignature #'sharp-positions = #'(2)
-\bar "||" \key d \major b fis b2
-@end lilypond
+
+@item
+Las articulaciones más comunes se reflejan ahora en la salida
+MIDI. El acento y el marcato hacen a las notas sonar más fuerte;
+el picado, el staccato, el staccatissimo y el portato las hacen
+más cortas. Las marcas de respiración acortan la nota anterior.
+
+Este comportamiento se puede personalizar a través de las
+propiedades @code{midiLength} @code{midiExtraVelocity} sobre
+@code{ArticulationEvent}. Para ver ejemplos, consulre
+@file{script-init.ly}.
+
+@item
+La funcionalidad de PostScript del ajuste del trazo ya no se
+aplica automáticamente, sino que se deja a la discreción del
+dispositivo PostScript (de forma predeterminada, Ghostscript lo
+usa para las resoluciones de hasta 150 ppp al generar imagenes de
+matriz de puntos). Cuando se activa, se emplea (principalmente
+para las plicas y las líneas divisorias) un algoritmo de trazado
+más complejo diseñado para sacar provecho del ajuste del trazo.
+
+El ajuste del trazo se puede forzar especificando la opción de
+línea de órdenes @samp{-dstrokeadjust} al llamar a LilyPond.
+CUando se generan archivos @code{PDF}, ello dará lugar por lo
+general a vistas previas de @code{PDF} con un aspecto marcadamente
+mejorado pero un tamaño de archivo significativamente mayor. La
+calidad de impresión en resoluciones altas no resulta afectada.
@end itemize
@ifhtml
Para ver noticias anteriores, diríjase a
+@uref{http://lilypond.org/doc/v2.18/Documentation/changes/},
@uref{http://lilypond.org/doc/v2.16/Documentation/changes/},
-@uref{http://lilypond.org/doc/v2.14/Documentation/changes/},
o @uref{../,vuelva} al índice de la documentación.
\input texinfo @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
@ignore
- Translation of GIT committish: 08560a1b8076630c4fc6cb9b902614d8b74fd6fc
+ Translation of GIT committish: 47db9a3883d726ca53e2133a3b2298f78dd6a32e
When revising a translation, copy the HEAD committish of the
version that you are working on. For details, see the Contributors'
LilyPond versión @version{}.
@end macro
-@c `Extending' was born 2003-04-23 with git commit c08f6e8...
+@c `Extending' was born 2004-03-07 with this commit:
+@c * Documentation/user/changing-defaults.itely (Changing defaults):
+@c author: Han-Wen Nienhuys
+@c commit: c53d0cabdf9361e448cdd02a338aa5d696f4f466
+@c file: Documentation/user/programming-interface.itely
+
@macro copyrightDeclare
Copyright @copyright{} 2003--2015 por los autores.
@end macro
@c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
@c This file is part of extending.tely
@ignore
- Translation of GIT committish: 41c8bf63a7cc180746eace9b9e5278f541be0229
+ Translation of GIT committish: 5680a5687a1f5cd5b406c71fdc9cae508464af94
When revising a translation, copy the HEAD committish of the
version that you are working on. See TRANSLATION for details.
@chapter Interfaces para programadores
@translationof Interfaces for programmers
-Se pueden realizar trucos avanzados mediante el uso de Scheme. Si no
-está familiarizado con Scheme, le conviene leer nuestro tutorial de
-Scheme, @ref{Tutorial de Scheme}.
+Se pueden realizar trucos avanzados mediante el uso de Scheme.
+Si no está familiarizado con Scheme, le conviene leer nuestro
+tutorial de Scheme, @ref{Tutorial de Scheme}.
@menu
* Funciones de marcado::
* Contextos para programadores::
* Funciones de callback::
-* Código de Scheme en línea::
* Trucos difíciles::
@end menu
@funindex $
@funindex #
-La creación de expresiones musicales en Scheme puede ser una tarea
-tediosa porque a veces presentan muchos niveles de profundidad de
-anidamiento y el código resultante es grande. Para algunas tareas
-sencillas, esto puede evitarse utilizando bloques de código de
-LilyPond, que permiten usar la sintaxis ordinaria de LilyPond
-dentro de Scheme.
+La creación de expresiones musicales en Scheme puede ser una
+tarea tediosa porque a veces presentan muchos niveles de
+profundidad de anidamiento y el código resultante es grande.
+Para algunas tareas sencillas, esto puede evitarse utilizando
+bloques de código de LilyPond, que permiten usar la sintaxis
+ordinaria de LilyPond dentro de Scheme.
Los bloques de código de LilyPond tienen el siguiente aspecto:
@example
código de LilyPond y pueda ocuparse de las expresiones de Scheme
incrustadas que comienzan por @code{$} y@w{ }@code{#}.
-@cindex parser (function argument)
-@cindex location
-
El lector extrae el bloque de código de LilyPond y genera una
llamada en tiempo de ejecución al analizador sintáctico para que
interprete el código de LilyPond. Las expresiones de Scheme
-incrustadas en el código de LilyPond se evalúan dentro del entorno
-lóexico del bloque de código de LilyPond, de manera que puede
-accederse a todas las variables locales y los parámetros de
+incrustadas en el código de LilyPond se evalúan dentro del
+entorno lóexico del bloque de código de LilyPond, de manera que
+puede accederse a todas las variables locales y los parámetros de
función que están disponibles en el punto en que se escribe el
bloque de código de LilyPond. Las variables definidas en otros
módulos de Scheme, como los módulos que contienen bloques
se puede acceder a ellas como variables de LilyPond, es decir,
precedidas de@tie{}@code{\}.
-Si @code{location} (véase @ref{Funciones de Scheme}) se refiere a una
-posición de entrada válida (como lo hace normalmente dentro de las
-funciones musicales o de Scheme), toda la música generada dentro
-del bloque de código tiene su @samp{origin} establecido a
-@code{location}.
+Toda la música generada dentro del bloque de código tiene su
+@samp{origin} establecido a la localización actual del puntero de
+entrada.
Un bloque de código de LilyPond puede contener cualquier cosa que
-podríamos utilizar en la parte derecha de una asignación. Además, un
-bloque de LilyPond vacío corresponde a una expresión musical vacía, y
-un bloque de LilyPond que contiene varios eventos musicales se
-convierte en una expresión de música secuencial.
+podríamos utilizar en la parte derecha de una asignación.
+Además, un bloque de LilyPond vacío corresponde a una expresión
+musical vacía, y un bloque de LilyPond que contiene varios
+eventos musicales se convierte en una expresión de música
+secuencial.
@node Funciones de Scheme
@section Funciones de Scheme
@translationof Scheme functions
@cindex Scheme, funciones de (sintaxis de LilyPond)
-Las @emph{funciones de Scheme} son procedimientos de Scheme que pueden
-crear expresiones de Scheme a partir de código de entrada escrito en
-la sintaxis de LilyPond. Se pueden llamar desde prácticamente
-cualquier lugar en el que se permita el uso de @code{#} para la
-especificación de un valor en sintaxis de Scheme. Mientras que Scheme
-tiene funciones propias, este capítulo se ocupa de las funciones
-@emph{sintácticas}, funciones que reciben argumentos especificados en
-la sintaxis de LilyPond.
+Las @emph{funciones de Scheme} son procedimientos de Scheme que
+pueden crear expresiones de Scheme a partir de código de entrada
+escrito en la sintaxis de LilyPond. Se pueden llamar desde
+prácticamente cualquier lugar en el que se permita el uso de
+@code{#} para la especificación de un valor en sintaxis de
+Scheme. Mientras que Scheme tiene funciones propias, este
+capítulo se ocupa de las funciones @emph{sintácticas}, funciones
+que reciben argumentos especificados en la sintaxis de LilyPond.
@menu
* Definición de funciones de Scheme::
donde
@multitable @columnfractions .33 .66
-@item @code{parser}
-@tab tiene que ser literalmente @code{parser} para dar a los bloques de código
-de LilyPond (@code{#@{}@dots{}@code{#@}}) acceso al analizador
-sintáctico.
-
-@item @code{location}
-@tab tiene que ser literalmente @code{location} para ofrecer acceso al
-objeto de situación de la entrada, que se usa para ofrecer
-menssajes de error con nombres de archivo y números de línea.
-
@item @code{@var{argN}}
@tab @var{n}-ésimo argumento
@item @code{@var{typeN?}}
@tab un @emph{predicado de tipo} de Scheme para el que @code{@var{argN}}
-debe devolver @code{#t}.
-
-También existe una forma especial @code{(@emph{predicate?}
-@emph{default})} para especificar argumentos opcionales. Si el
-argumento actual no está presente cuando se ll ama a la función, el
-valor predeterminado se emplea en sustitución. Los valores
-predeterminados se evalúan en tiempo de definición (¡incluyendo los
-bloques de código de LilyPond!), de manera que se necesitamos un valor
-por omisión calculado en tiempo de ejecución, debemos escribir en su
-lugar un valor especial que podamos reconocer fácilmente. Si
-escribimos el predicado entre paréntesis pero no lo seguimos por el
-valor predeterminado, se usa @code{#f} como valor por omisión. Los
-valores por omisión no se verifican con @emph{predicate?} en tiempo de
-definición ni en tiempo de ejecución: es nuestra responsabilidad
-tratar con los valores que especifiquemos. Los valores por omisión
-que son expresiones musicales se copian mientras se establece
-@code{origin} al parámetro @code{location}.
+debe devolver @code{#t}. También existe una forma especial
+@code{(@emph{predicate?} @emph{default})} para especificar
+argumentos opcionales. Si el argumento actual no está presente
+cuando se ll ama a la función, el valor predeterminado se emplea
+en sustitución. Los valores predeterminados se evalúan en tiempo
+de definición (¡incluyendo los bloques de código de LilyPond!),
+de manera que se necesitamos un valor por omisión calculado en
+tiempo de ejecución, debemos escribir en su lugar un valor
+especial que podamos reconocer fácilmente. Si escribimos el
+predicado entre paréntesis pero no lo seguimos por el valor
+predeterminado, se usa @code{#f} como valor por omisión. Los
+valores por omisión no se verifican con @emph{predicate?} en
+tiempo de definición ni en tiempo de ejecución: es nuestra
+responsabilidad tratar con los valores que especifiquemos. Los
+valores por omisión que son expresiones musicales se copian
+mientras se establece @code{origin} a la ubicación actual del
+cursor de entrada.
@item @code{@var{cuerpo}}
@tab una secuencia de formas de Scheme que se evalúan ordenadamente; la
-última forma de la secuencia se usa como el valor de retorno de la
-función de Scheme. Puede contener bloques de código de LilyPond
-encerrados entre llaves con almohadillas
+última forma de la secuencia se usa como el valor de retorno de
+la función de Scheme. Puede contener bloques de código de
+LilyPond encerrados entre llaves con almohadillas
(@tie{}@w{@code{#@{@dots{}#@}}}@tie{}), como se describe en
-@ref{Bloques de código de LilyPond}. Dentro de los bloques de código
-de LilyPond, use el símbolo @code{#} para hacer referencia a
-argumentos de función (p.ej. @samp{#arg1}) o para iniciar una
+@ref{Bloques de código de LilyPond}. Dentro de los bloques de
+código de LilyPond, use el símbolo @code{#} para hacer referencia
+a argumentos de función (p.ej. @samp{#arg1}) o para iniciar una
expresión en línea de Scheme que contenga argumentos de función
-(p.ej. @w{@samp{#(cons arg1 arg2)}}). Donde las expresiones de Scheme
-normales que usan @code{#} no funcionan, podríamos necesitar volver a
-expresiones de Scheme inmediatas que usan @code{$}, como por ejemplo
-@samp{$music}.
+(p.ej. @w{@samp{#(cons arg1 arg2)}}). Donde las expresiones de
+Scheme normales que usan @code{#} no funcionan, podríamos
+necesitar volver a expresiones de Scheme inmediatas que usan
+@code{$}, como por ejemplo @samp{$music}.
-Si nuestra función devuelve una expresión musical, recibe un valor
-@code{origin} útil.
+Si nuestra función devuelve una expresión musical, recibe un
+valor @code{origin} útil.
@end multitable
@noindent
-La idoneidad de los argumentos para los predicados viene determinada
-mediante llamadas reales al predicado después de que LilyPond ya las
-ha convertido en una expresión de Scheme. Como consecuencia, el
-argumento se puede especificar en la sintaxis de Scheme si se desea
-(precedido de @code{#} o como resultado de haber llamado a una función
-de Scheme), pero LilyPond también convierte algunas construcciones de
-LilyPond en Scheme antes de hacer efectivamente la comprobación del
-predicado sobre ellas. Actualmente se encuentran entre ellas la
-música, los post-eventos, las cadenas simples (entrecomilladas o no),
-los números, los elementos de marcado y de listas de marcado, score
-(partitura), book (libro), bookpart (parte de libro), las definiciones
-de contexto y los bloques de definición de salida.
-
-Para ciertos tipos de expresión (como la mayor parte de la música que
-no está encerrada entre llaves) LilyPond necesita más allá de la
-expresión misma para poder determinar su final. Si tal expresión se
-considerase un argumento opcional mediante la evaluación de su
-predicado, LilyPond no podría recuperarse después de decidir que la
-expresión no se corresponde con el parámetro. Así, ciertas formas de
-música necesitan ir encerradas entre llaves para poder considerarlas
-como aceptables bajo algunas circunstancias. LilyPond resuelve
-algunas otras ambigüedades mediante la comprobación con funciones de
-predicado: ¿es @samp{-3} un post-evento de digitación o un número
-negativo? ¿Es @code{"a" 4} en el modo de letra una cadena seguida por
-un número, o un evento de letra con la duración @code{4}? LilyPond
-prueba el predicado del argumento sobre diversas interpretaciones
-sucesivas hasta que lo consigue, con un orden diseñado para minimizar
-las interpretaciones poco consistentes y la lectura por adelantado.
-
-Por ejemplo, un predicado que acepta tanto expresiones musicales como
-alturas consideraría que @code{c''} es una altura en lugar de una
-expresión musical. Las duraciones o post-eventos que siguieran
-inmediatamente podrían no funcionar con dicha interpretación. Así
-pues, es mejor evitar los predicados excesivamente permisivos como
-@code{scheme?} cuando la aplicación requeriría tipos de argumento más
-específicos.
-
-Para ver una lista de los predicados de tipo disponibles, consulte
-@ruser{Predicados de tipo predefinidos}.
+La idoneidad de los argumentos para los predicados viene
+determinada mediante llamadas reales al predicado después de que
+LilyPond ya las ha convertido en una expresión de Scheme. Como
+consecuencia, el argumento se puede especificar en la sintaxis de
+Scheme si se desea (precedido de @code{#} o como resultado de
+haber llamado a una función de Scheme), pero LilyPond también
+convierte algunas construcciones de LilyPond en Scheme antes de
+hacer efectivamente la comprobación del predicado sobre ellas.
+Actualmente se encuentran entre ellas la música, los
+post-eventos, las cadenas simples (entrecomilladas o no), los
+números, los elementos de marcado y de listas de marcado, score
+(partitura), book (libro), bookpart (parte de libro), las
+definiciones de contexto y los bloques de definición de salida.
+
+LilyPond resuelve algunas ambigüedades mediante la comprobación
+con funciones de predicado: ¿es @samp{-3} un post-evento de
+digitación o un número negativo? ¿Es @code{"a" 4} en el modo de
+letra una cadena seguida por un número, o un evento de letra con
+la duración @code{4}? LilyPond prueba el predicado del argumento
+sobre diversas interpretaciones sucesivas hasta que lo consigue,
+con un orden diseñado para minimizar las interpretaciones poco
+consistentes y la lectura por adelantado.
+
+Por ejemplo, un predicado que acepta tanto expresiones musicales
+como alturas consideraría que @code{c''} es una altura en lugar
+de una expresión musical. Las duraciones o post-eventos que
+siguen inmediatamente, cambian dicha interpretación. Es mejor
+evitar los predicados excesivamente permisivos como
+@code{scheme?} cuando la aplicación requeriría tipos de argumento
+más específicos.
+
+Para ver una lista de los predicados de tipo disponibles,
+consulte @ruser{Predicados de tipo predefinidos}.
@seealso
@subsection Uso de las funciones de Scheme
@translationof Scheme function usage
-Las funciones de Scheme se pueden llamar casi desde cualquier lugar en
-que puede escribirse una expresión de Scheme que comience con la
-almohadilla@tie{}@code{#}. Llamamos a una función de Scheme
-escribiendo su nombre precedido de la barra invertida@tie{}@code{\}, y
-seguido por sus argumentos. Una vez que un argumento opcional no
-corresponde a ningún argumento, LilyPond se salta este argumento y
-todos los que le siguen, sustituyéndolos por su valor por omisión
-especificado, y @q{recupera} el argumento que no correspondía al lugar
-del siguiente argumento obligatorio. Dado que el argumento recuperado
-necesita ir a algún lugar, los argumentos opcionales no se consideran
-realmente opcionales a no ser que vayan seguidos de un argumento
-obligatorio.
-
-Existe una excepción: si escribimos @code{\default} en el lugar de un
-argumento opcional, este argumento y todos los argumentos opcionales
-que le siguen se saltan y se sustituyen por sus valores
-predeterminados. Esto funciona incluso si no sigue ningún argumento
-obligatorio porque @code{\default} no necesita recuperarse. Las
-instrucciones @code{mark} y @code{key} hacen uso de este truco para
-ofrecer su comportamiento predeterminado cuando van seguidas solamente
-por @code{\default}.
+Las funciones de Scheme se pueden llamar casi desde cualquier
+lugar en que puede escribirse una expresión de Scheme que
+comience con la almohadilla@tie{}@code{#}. Llamamos a una
+función de Scheme escribiendo su nombre precedido de la barra
+invertida@tie{}@code{\}, y seguido por sus argumentos. Una vez
+que un argumento opcional no corresponde a ningún argumento,
+LilyPond se salta este argumento y todos los que le siguen,
+sustituyéndolos por su valor por omisión especificado, y
+@q{recupera} el argumento que no correspondía al lugar del
+siguiente argumento obligatorio. Dado que el argumento
+recuperado necesita ir a algún lugar, los argumentos opcionales
+no se consideran realmente opcionales a no ser que vayan seguidos
+de un argumento obligatorio.
+
+Existe una excepción: si escribimos @code{\default} en el lugar
+de un argumento opcional, este argumento y todos los argumentos
+opcionales que le siguen se saltan y se sustituyen por sus
+valores predeterminados. Esto funciona incluso si no sigue
+ningún argumento obligatorio porque @code{\default} no necesita
+recuperarse. Las instrucciones @code{mark} y @code{key} hacen
+uso de este truco para ofrecer su comportamiento predeterminado
+cuando van seguidas solamente por @code{\default}.
Aparte de los lugares en que se requiere un valor de Scheme hay
-ciertos sitios en que se aceptan expresiones de almohadilla @code{#} y
-se evalúan por sus efectos secundarios, pero por lo demás se ignoran.
-Son, mayormente, los lugares en que también sería aceptable colocar
-una asignación.
-
-Dado que no es buena idea devolver valores que puedan malinterpretarse
-en algún contexto, debería usar funciones de Scheme normales solo para
-los casos en que siempre se devuelve un valor útil, y usar funciones
-de Scheme vacías (@pxref{Funciones de Scheme vacías}) en caso
-contrario.
-
+ciertos sitios en que se aceptan expresiones de almohadilla
+@code{#} y se evalúan por sus efectos secundarios, pero por lo
+demás se ignoran. Son, mayormente, los lugares en que también
+sería aceptable colocar una asignación.
+
+Dado que no es buena idea devolver valores que puedan
+malinterpretarse en algún contexto, debería usar funciones de
+Scheme normales solo para los casos en que siempre se devuelve un
+valor útil, y usar funciones de Scheme vacías (@pxref{Funciones
+de Scheme vacías}) en caso contrario.
+
+Por conveniencia, las funciones de Scheme también se pueden
+llamar directamente desde Scheme, puenteando al analizador
+sintáctico de LilyPond. Su nombre puede utilizarse como el
+nombre de una función corriente. La comprobación de tipo de los
+argumentos y el salto de los argumentos opcionales tiene lugar de
+la misma forma que cuando se llama desde dentro de LilyPond,
+tomando el valor de Scheme @code{*unspecified*} el papel de la
+palabra reservada @code{\default} para saltar explícitamente
+argumentos opcionales.
@node Funciones de Scheme vacías
@subsection Funciones de Scheme vacías
@funindex define-void-function
@funindex \void
-En ocasiones, un procedimiento se ejecuta con el objeto de llevar a
-cabo alguna acción más que para devolver un valor. Algunos lenguajes
-de programación (como C y Scheme) usan las funciones para los dos
-conceptos y se limitan a descartar el valor devuelto (usualmente
-haciendo que cualquier expresión pueda actuar como instrucción,
-ignorando el resultado devuelto). Esto puede parecer inteligente pero
-es propenso a errores: casi todos los compiladores de C de hoy en día
-emiten advertencias cuando se descarta una expresión no vacía. Para
-muchas funciones que ejecutan una acción, los estándares de Scheme
-declaran que el valor de retorno sea no especificado. Guile, el
-intérprete de Scheme de LilyPond, tiene un valor único
-@code{*unspecified*} que en tales casos devuelve de forma usual (como
-cuando se usa directamente @code{set!} sobre una variable), pero
+En ocasiones, un procedimiento se ejecuta con el objeto de llevar
+a cabo alguna acción más que para devolver un valor. Algunos
+lenguajes de programación (como C y Scheme) usan las funciones
+para los dos conceptos y se limitan a descartar el valor devuelto
+(usualmente haciendo que cualquier expresión pueda actuar como
+instrucción, ignorando el resultado devuelto). Esto puede
+parecer inteligente pero es propenso a errores: casi todos los
+compiladores de C de hoy en día emiten advertencias cuando se
+descarta una expresión no vacía. Para muchas funciones que
+ejecutan una acción, los estándares de Scheme declaran que el
+valor de retorno sea no especificado. Guile, el intérprete de
+Scheme de LilyPond, tiene un valor único @code{*unspecified*} que
+en tales casos devuelve de forma usual (como cuando se usa
+directamente @code{set!} sobre una variable), pero
desgraciadamente no de forma consistente.
Definir una función de LilyPond con @code{define-void-function}
\noApuntarYPulsar % desactivar la función de apuntar y pulsar
@end example
-Si queremos evaluar una expresión sólo por su efecto colateral y no
-queremos que se interprete ningún valor que pueda devolver, podemos
-hacerlo anteponiendo el prefijo @code{\void}:
+Si queremos evaluar una expresión sólo por su efecto colateral y
+no queremos que se interprete ningún valor que pueda devolver,
+podemos hacerlo anteponiendo el prefijo @code{\void}:
@example
\void #(hashq-set! some-table some-key some-value)
@cindex funciones musicales
-Las @emph{funciones musicales} son procedimientos de Scheme que pueden
-crear automáticamente expresiones musicales, y se pueden usar para
-simplificar enormemente el archivo de entrada.
+Las @emph{funciones musicales} son procedimientos de Scheme que
+pueden crear automáticamente expresiones musicales, y se pueden
+usar para simplificar enormemente el archivo de entrada.
@menu
* Definiciones de funciones musicales::
@end example
@noindent
-de forma bastante análoga a @ref{Definición de funciones de Scheme}.
-Lo más probable es que el @var{cuerpo} sea un
+de forma bastante análoga a
+@ref{Definición de funciones de Scheme}. Lo más probable es que
+el @var{cuerpo} sea un
@ref{Bloques de código de LilyPond,bloque de código de LilyPond}.
-Para ver una lista de los predicados de tipo disponibles, consulte
-@ruser{Predicados de tipo predefinidos}.
+Para ver una lista de los predicados de tipo disponibles,
+consulte @ruser{Predicados de tipo predefinidos}.
@seealso
@subsection Uso de las funciones musicales
@translationof Music function usage
-Las funciones musicales se pueden actualmente utilizar en varios
-lugares. Dependiendo de dónde se usan, son de aplicación ciertas
-restricciones para que sea posible su análisis sintáctico de forma
-no ambigua. El resultado que devuelve una función musical debe ser
-compatible con el contexto desde el que se la llama.
+Una @q{función musical} debe devolver una expresión que se
+corresponda con el predicado @code{ly:music?}. Esto hace que las
+llamadas a funciones musicales sean aproopiadas como argumentos
+del tipo @code{ly:music?} para otra llamada a una función
+musical.
+
+Si se usa una llamada a función musical dentro de otros
+contextos, el contexto puede aplicar restricciones semánticas
+adicionales.
@itemize
@item
-En el nivel superior dentro de una expresión musical. Aquí
-no se aplica ninguna restricción.
+En el nivel superior dentro de una expresión musical no se acepta
+ningún post-evento.
@item
-Como un post-evento, que comienza explícitamente con un indicador de
-dirección (a elegir entre @code{-}, @code{^} @w{y @code{_}}).
-
-En este caso, no podemos usar una expresión musical @emph{abierta}
-como último argumento, que terminaría en una expresión musical
-capaz de aceptar post-eventos adicionales.
+Cuando una función musical (a diferencia de una función de
+evento) devuelve una expresión del tipo post-event, LilyPond
+requiere uno de los indicadores de dirección con nombre
+(@code{-}, @code{^}, @w{y @code{_}}) para poder integrar
+adecuadamente el post-evento producido por la llamada a la
+función musical dentro de la expresión circundante.
@item
-Como componente de un acorde. La expresión devuelta debe ser
-del tipo @code{rhythmic-event}, probablemente un @code{NoteEvent}.
+Como componente de un acorde. La expresión devuelta debe ser del
+tipo @code{rhythmic-event}, probablemente un @code{NoteEvent}.
@end itemize
@noindent
-Las reglas especiales para los argumentos del final hacen posible
-escribir funciones polimórficas como @code{\tweak} que se pueden
-aplicar a construcciones distintas.
+Se pueden aplicar funciones @q{polimórficas}, como @code{\tweak},
+a los post-eventos, componentes de acordes y expresiones
+musicales del nivel superior.
@node Funciones de sustitución sencillas
@subsection Funciones de sustitución sencillas
@translationof Simple substitution functions
Una función de sustitución sencilla es una función musical cuya
-expresión musical de salida está escrita en código de LilyPond
-y contiene argumentos de la función en la expresión de salida.
+expresión musical de salida está escrita en código de LilyPond y
+contiene argumentos de la función en la expresión de salida.
Están descritas en @ruser{Ejemplos de funciones de sustitución}.
@subsection Funciones de sustitución intermedias
@translationof Intermediate substitution functions
-Las funciones de sustitución intermedias contienen una
-mezcla de código de Scheme y de LilyPond
-dentro de la expresión musical que se devuelve.
+Las funciones de sustitución intermedias contienen una mezcla de
+código de Scheme y de LilyPond dentro de la expresión musical que
+se devuelve.
Algunas instrucciones @code{\override} requieren un argumento que
-consiste en una pareja de números (llamada una @emph{célula cons} en
-Scheme).
+consiste en una pareja de números (llamada una @emph{célula cons}
+en Scheme).
-La pareja se puede pasar directamente dentro de la función musical,
-usando una variable @code{pair?}:
+La pareja se puede pasar directamente dentro de la función
+musical, usando una variable @code{pair?}:
@example
barraManual =
@}
@end example
-De forma alternativa, los números que componen la pareja se pueden
-pasar como argumentos separados, y el código de Scheme que se ha usado
-para crear la pareja se puede incluir dentro de la expresión musical:
+De forma alternativa, los números que componen la pareja se
+pueden pasar como argumentos separados, y el código de Scheme que
+se ha usado para crear la pareja se puede incluir dentro de la
+expresión musical:
@lilypond[quote,verbatim,ragged-right]
manualBeam =
por cada propiedad, por cada grob y por cada contexto. Las
funciones musicales pueden requerir la sobreescritura de una o
varias propiedades durante el tiempo de duración de la función,
-restaurándolas a sus valores previos antes de salir. Sin embargo,
-las sobreescrituras normales extraen y descartan la cima de la
-pila de propiedades actual antes de introducir un valor en ella,
-de manera que el valor anterior de la propiedad se pierde cuando
-se sobreescribe. Si se quiere preservar el valor anterior, hay
-que preceder la instrucción @code{\override} con la palabra clave
-@code{\temporary}, así:
+restaurándolas a sus valores previos antes de salir. Sin
+embargo, las sobreescrituras normales extraen y descartan la cima
+de la pila de propiedades actual antes de introducir un valor en
+ella, de manera que el valor anterior de la propiedad se pierde
+cuando se sobreescribe. Si se quiere preservar el valor
+anterior, hay que preceder la instrucción @code{\override} con la
+palabra clave @code{\temporary}, así:
@example
\temporary \override @dots{}
El uso de @code{\temporary} hace que se borre la propiedad
(normalmente fijada a un cierto valor) @code{pop-first} de la
sobreescritura, de forma que el valor anterior no se extrae de la
-pila de propiedades antes de poner en ella el valor nuevo. Cuando
-una instrucción @code{\revert} posterior extrae el avlor
+pila de propiedades antes de poner en ella el valor nuevo.
+Cuando una instrucción @code{\revert} posterior extrae el valor
sobreescrito temporalmente, volverá a emerger el valor anterior.
En otras palabras, una llamada a @code{\temporary \override} y a
-continuación otra a @code{\revert} sobre la misma propiedad, tiene
-un valor neto que es nulo. De forma similar, la combinación en
-secuencia de @code{\temporary} y @code{\undo} sobre la misma
-música que contiene las sobreescrituras, tiene un efecto neto
-nulo.
+continuación otra a @code{\revert} sobre la misma propiedad,
+tiene un valor neto que es nulo. De forma similar, la
+combinación en secuencia de @code{\temporary} y @code{\undo}
+sobre la misma música que contiene las sobreescrituras, tiene un
+efecto neto nulo.
He aquí un ejemplo de una función musical que utiliza lo expuesto
anteriormente. El uso de @code{\temporary} asegura que los
@subsection Funciones sin argumentos
@translationof Functions without arguments
-En casi todos los casos, una función sin argumentos se debe escribir
-con una variable:
+En casi todos los casos, una función sin argumentos se debe
+escribir con una variable:
@example
dolce = \markup@{ \italic \bold dolce @}
#@{#@}))
@end example
-Para la impresión real de los números de compás donde se llama a esta
-función, invoque a @command{lilypond} con
+Para la impresión real de los números de compás donde se llama a
+esta función, invoque a @command{lilypond} con
@example
lilypond -d display-bar-numbers ARCHIVO.ly
@subsection Funciones musicales vacías
@translationof Void music functions
-Una función musical debe devolver una expresión musical. Si quiere
-ejecutar una función exclusivamente por sus efectos secundarios,
-debería usar @code{define-void-function}. Pero
-puede haber casos en los que a veces queremos producir una expresión
-musical, y a veces no (como en el ejemplo anterior). Devolver una
-expresión musical @code{void} (vacía) por medio de @code{#@{ #@}} lo
-hace posible.
+Una función musical debe devolver una expresión musical. Si
+quiere ejecutar una función exclusivamente por sus efectos
+secundarios, debería usar @code{define-void-function}. Pero
+puede haber casos en los que a veces queremos producir una
+expresión musical, y a veces no (como en el ejemplo anterior).
+Devolver una expresión musical @code{void} (vacía) por medio de
+@code{#@{ #@}} lo hace posible.
@node Funciones de eventos
@funindex define-event-function
@cindex event functions
-Para usar una función musical en el lugar de un evento, tenemos que
-escribir un indicador de dirección antes de ella. Pero a veces, ello
-hace que se pierda la correspondencia con la sintaxis de las
-construcciones que queremos sustituir. Por ejemplo, si queremos
-escribir instrucciones de matiz dinámico, éstos se adjuntan
-habitualmente sin indicador de dirección, como @code{c'\pp}. He aquí
-una forma de escribir indicaciones dinámicas arbitrarias:
+Para usar una función musical en el lugar de un evento, tenemos
+que escribir un indicador de dirección antes de ella. Pero a
+veces, ello hace que se pierda la correspondencia con la sintaxis
+de las construcciones que queremos sustituir. Por ejemplo, si
+queremos escribir instrucciones de matiz dinámico, éstos se
+adjuntan habitualmente sin indicador de dirección, como
+@code{c'\pp}. He aquí una forma de escribir indicaciones
+dinámicas arbitrarias:
@lilypond[quote,verbatim,ragged-right]
dyn=#(define-event-function (arg) (markup?)
\relative { c'\dyn pfsss }
@end lilypond
-Podríamos hacer lo mismo usando una función musical, pero entonces
-tendríamos que escribir siempre un indicador de dirección antes de
-llamarla, como @code{@w{c-\dyn pfsss}}.
+Podríamos hacer lo mismo usando una función musical, pero
+entonces tendríamos que escribir siempre un indicador de
+dirección antes de llamarla, como @code{@w{c-\dyn pfsss}}.
@node Funciones de marcado
@section Funciones de marcado
@translationof Markup functions
-Los elementos de marcado están implementados como funciones de Scheme
-especiales que producen un objeto @code{Stencil} dada una serie de
-argumentos.
+Los elementos de marcado están implementados como funciones de
+Scheme especiales que producen un objeto @code{Stencil} dada una
+serie de argumentos.
@menu
Véase @ref{Presentación de las expresiones musicales}.
@noindent
-Este ejemplo muestra las principales reglas de traducción entre la
-sintaxis del marcado normal de LilyPond y la sintaxis del marcado de
-Scheme. La utilización de @code{#@{ @dots{} #@}} para escribir en la
-sintaxis de LilyPond será con frecuencia lo más conveniente, pero
-explicamos cómo usar la macro @code{markup} para obtener una solución
-sólo con Scheme.
+Este ejemplo muestra las principales reglas de traducción entre
+la sintaxis del marcado normal de LilyPond y la sintaxis del
+marcado de Scheme. La utilización de @code{#@{ @dots{} #@}} para
+escribir en la sintaxis de LilyPond será con frecuencia lo más
+conveniente, pero explicamos cómo usar la macro @code{markup}
+para obtener una solución sólo con Scheme.
@quotation
@multitable @columnfractions .3 .3
@end multitable
@end quotation
-Todo el lenguaje Scheme está accesible dentro del macro @code{markup}.
-Por ejemplo, podemos usar llamadas a funciones dentro de @code{markup}
-para así manipular cadenas de caracteres. Esto es útil si se están
-definiendo instrucciones de marcado nuevas (véase
-@ref{Definición de una instrucción de marcado nueva}).
+Todo el lenguaje Scheme está accesible dentro del macro
+@code{markup}. Por ejemplo, podemos usar llamadas a funciones
+dentro de @code{markup} para así manipular cadenas de caracteres.
+Esto es útil si se están definiendo instrucciones de marcado
+nuevas (véase @ref{Definición de una instrucción de marcado
+nueva}).
@knownissues
@end lisp
@noindent
-no es válido. Hay que usar las funciones @code{make-line-markup},
-@code{make-center-markup} o @code{make-column-markup} en su lugar:
+no es válido. Hay que usar las funciones
+@code{make-line-markup}, @code{make-center-markup} o
+@code{make-column-markup} en su lugar:
@lisp
(markup (make-line-markup (funcion-que-devuelve-marcados)))
@var{el marcado "ejemplo de texto"})
@end example
-Primero la función @code{raise-markup} crea el sello para la cadena
-@code{ejemplo de texto}, y después eleva el sello Stencil en 0.5
-espacios de pentagrama. Este es un ejemplo bastante simple; en el
-resto de la sección podrán verse ejemplos más complejos, así como en
-@file{scm/define-markup-commands.scm}.
+Primero la función @code{raise-markup} crea el sello para la
+cadena @code{ejemplo de texto}, y después eleva el sello Stencil
+en 0.5 espacios de pentagrama. Este es un ejemplo bastante
+simple; en el resto de la sección podrán verse ejemplos más
+complejos, así como en @file{scm/define-markup-commands.scm}.
@node Definición de una instrucción de marcado nueva
@unnumberedsubsubsec Sintaxis de la definición de instrucciones de marcado
@translationof Markup command definition syntax
-Se pueden definir instrucciones de marcado nuevas usando el macro de
-Scheme @code{define-markup-command}, en el nivel sintáctico superior.
+Se pueden definir instrucciones de marcado nuevas usando el macro
+de Scheme @code{define-markup-command}, en el nivel sintáctico
+superior.
@lisp
(define-markup-command (@var{nombre-de-la-instruccion} @var{layout} @var{props} @var{arg1} @var{arg2} @dots{})
predicado de tipo para el argumento @var{i}-ésimo
@end table
-Si la instrucción utiliza propiedades de los argumentos @code{props},
-se puede usar la palabra clave @code{#:properties} para especificar
-qué propiedades se usan, así como sus valores predeterminados.
+Si la instrucción utiliza propiedades de los argumentos
+@code{props}, se puede usar la palabra clave @code{#:properties}
+para especificar qué propiedades se usan, así como sus valores
+predeterminados.
Los argumentos se distinguen según su tipo:
@itemize
@code{list?}, @code{number?}, @code{boolean?}, etc.
@end itemize
-No existe ninguna limitación en el orden de los argumentos (después de
-los argumentos estándar @code{layout} y @code{props}). Sin embargo, las
-funciones de marcado que toman un elemento de marcado como su último
-argumento son un poco especiales porque podemos aplicarlas a una lista
-de marcados y el resultado es una lista de marcados donde la función
-de marcado (con los argumentos antecedentes especificados) se ha
-aplicado a todos los elementos de la lista de marcados original.
-
-Dado que la replicación de los argumentos precedentes para aplicar una
-función de marcado a una lista de marcados es poco costosa
-principalmente por los argumentos de Scheme, se evitan las caídas de
-rendimiento simplemente mediante la utilización de argumentos de
-Scheme para los argumentos antecedentes de las funciones de marcado
-que toman un marcado como su último argumento.
+No existe ninguna limitación en el orden de los argumentos
+(después de los argumentos estándar @code{layout} y
+@code{props}). Sin embargo, las funciones de marcado que toman
+un elemento de marcado como su último argumento son un poco
+especiales porque podemos aplicarlas a una lista de marcados y el
+resultado es una lista de marcados donde la función de marcado
+(con los argumentos antecedentes especificados) se ha aplicado a
+todos los elementos de la lista de marcados original.
+
+Dado que la replicación de los argumentos precedentes para
+aplicar una función de marcado a una lista de marcados es poco
+costosa principalmente por los argumentos de Scheme, se evitan
+las caídas de rendimiento simplemente mediante la utilización de
+argumentos de Scheme para los argumentos antecedentes de las
+funciones de marcado que toman un marcado como su último
+argumento.
@funindex \markup
@cindex markup macro
@funindex interpret-markup
Las instrucciones de marcado tienen un ciclo de vida más bien
-complejo. El cuerpo de la definición de una instrucción de marcado es
-responsable de la conversión de los argumentos de la instrucción de
-marcado en una expresión de sello que se devuelve. Muy a menudo esto
-se lleva a cabo llamando a la función @code{interpret-markup} sobre
-una expresión de marcado, pasándole los argumentos @var{layout} y
-@var{props}. Por lo general, estos argumentos se conocen solamente en
-una fase muy tardía de la composición tipográfica. Las expresiones de
-marcado ya tienen sus componentes ensamblados dentro de expresiones de
-marcado cuando se expanden las instrucciones @code{\markup} (dentro de
+complejo. El cuerpo de la definición de una instrucción de
+marcado es responsable de la conversión de los argumentos de la
+instrucción de marcado en una expresión de sello que se devuelve.
+Muy a menudo esto se lleva a cabo llamando a la función
+@code{interpret-markup} sobre una expresión de marcado, pasándole
+los argumentos @var{layout} y @var{props}. Por lo general, estos
+argumentos se conocen solamente en una fase muy tardía de la
+composición tipográfica. Las expresiones de marcado ya tienen
+sus componentes ensamblados dentro de expresiones de marcado
+cuando se expanden las instrucciones @code{\markup} (dentro de
una expresión de LilyPond) o la macro @code{markup} (dentro de
-Scheme). La evaluación y la comprobación de tipos de los argumentos
-de la instrucción de marcado tiene lugar en el momento en que se
-interpretan @code{\markup} o @code{markup}.
+Scheme). La evaluación y la comprobación de tipos de los
+argumentos de la instrucción de marcado tiene lugar en el momento
+en que se interpretan @code{\markup} o @code{markup}.
-Pero la conversión real de expresiones de marcado en expresiones de
-sello mediante la ejecución de los cuerpos de función de marcado solo
-tienen lugar cuando se llama a @code{interpret-markup} sobre una
-expresión de marcado.
+Pero la conversión real de expresiones de marcado en expresiones
+de sello mediante la ejecución de los cuerpos de función de
+marcado solo tienen lugar cuando se llama a
+@code{interpret-markup} sobre una expresión de marcado.
@node Acerca de las propiedades
@unnumberedsubsubsec Acerca de las propiedades
@translationof On properties
-Los argumentos @code{layout} y @code{props} de las instrucciones de
-marcado traen a escena un contexto para la interpretación del marcado:
-tamaño de la tipografía, grueso de línea, etc.
+Los argumentos @code{layout} y @code{props} de las instrucciones
+de marcado traen a escena un contexto para la interpretación del
+marcado: tamaño de la tipografía, grueso de línea, etc.
El argumento @code{layout} permite el acceso a las propiedades
definidas en los bloques @code{paper}, usando la función
(ly:output-def-lookup layout 'line-width)
@end example
-El argumento @code{props} hace accesibles algunas propiedades a las
-instrucciones de marcado. Por ejemplo, cuando se interpreta el
-marcado del título de un libro, todas las variables definidas dentro
-del bloque @code{\header} se añaden automáticamente a @code{props}, de
-manera que el marcado del título del libro puede acceder al título del
-libro, el autor, etc. También es una forma de configurar el
-comportamiento de una instrucción de marcado: por ejemplo, cuando una
-instrucción utiliza tamaños de tipografía durante el procesado, el
-tamaño se lee de @code{props} en vez de tener un argumento
-@code{font-size}. El que llama a una instrucción de marcado puede
-cambiar el valor de la propiedad del tamaño de la tipografía con el
-objeto de modificar el comportamiento. Utilice la palabra clave
-@code{#:properties} de @code{define-markup-command} para especificar
-qué propiedades se deben leer a partir de los argumentos de
-@code{props}.
+El argumento @code{props} hace accesibles algunas propiedades a
+las instrucciones de marcado. Por ejemplo, cuando se interpreta
+el marcado del título de un libro, todas las variables definidas
+dentro del bloque @code{\header} se añaden automáticamente a
+@code{props}, de manera que el marcado del título del libro puede
+acceder al título del libro, el autor, etc. También es una forma
+de configurar el comportamiento de una instrucción de marcado:
+por ejemplo, cuando una instrucción utiliza tamaños de tipografía
+durante el procesado, el tamaño se lee de @code{props} en vez de
+tener un argumento @code{font-size}. El que llama a una
+instrucción de marcado puede cambiar el valor de la propiedad del
+tamaño de la tipografía con el objeto de modificar el
+comportamiento. Utilice la palabra clave @code{#:properties} de
+@code{define-markup-command} para especificar qué propiedades se
+deben leer a partir de los argumentos de @code{props}.
El ejemplo de la sección siguiente ilustra cómo acceder y
sobreescribir las propiedades de una instrucción de marcado.
@unnumberedsubsubsec Un ejemplo completo
@translationof A complete example
-El ejemplo siguiente define una instrucción de marcado para trazar un
-rectángulo doble alrededor de un fragmento de texto.
+El ejemplo siguiente define una instrucción de marcado para
+trazar un rectángulo doble alrededor de un fragmento de texto.
En primer lugar, necesitamos construir un resultado aproximado
-utilizando marcados. Una consulta a @ruser{Instrucciones de marcado
-de texto} nos muestra que es útil la instrucción @code{\box}:
+utilizando marcados. Una consulta a @ruser{Instrucciones de
+marcado de texto} nos muestra que es útil la instrucción
+@code{\box}:
@lilypond[quote,verbatim,ragged-right]
\markup \box \box HELLO
@end lilypond
-Ahora, consideramos que es preferible tener más separación entre el
-texto y los rectángulos. Según la documentación de @code{\box}, esta
-instrucción usa una propiedad @code{box-padding}, cuyo valor
-predeterminado es 0.2. La documentación también menciona cómo
-sobreescribir este valor:
+Ahora, consideramos que es preferible tener más separación entre
+el texto y los rectángulos. Según la documentación de
+@code{\box}, esta instrucción usa una propiedad
+@code{box-padding}, cuyo valor predeterminado es 0.2. La
+documentación también menciona cómo sobreescribir este valor:
@lilypond[quote,verbatim,ragged-right]
\markup \box \override #'(box-padding . 0.6) \box A
@end lilypond
-Después, el relleno o separación entre los dos rectángulos nos parece
-muy pequeño, así que lo vamos a sobreescribir también:
+Después, el relleno o separación entre los dos rectángulos nos
+parece muy pequeño, así que lo vamos a sobreescribir también:
@lilypond[quote,verbatim,ragged-right]
\markup \override #'(box-padding . 0.4) \box
\override #'(box-padding . 0.6) \box A
@end lilypond
-Repetir esta extensa instrucción de marcado una y otra vez sería un
-quebradero de cabeza. Aquí es donde se necesita una instrucción de
-marcado. Así pues, escribimos una instrucción de marcado
-@code{double-box}, que toma un argumento (el texto). Dibuja los dos
-rectángulos y añade una separación.
+Repetir esta extensa instrucción de marcado una y otra vez sería
+un quebradero de cabeza. Aquí es donde se necesita una
+instrucción de marcado. Así pues, escribimos una instrucción de
+marcado @code{double-box}, que toma un argumento (el texto).
+Dibuja los dos rectángulos y añade una separación.
@lisp
#(define-markup-command (double-box layout props text) (markup?)
@end lisp
@code{text} es el nombre del argumento de la instrucción, y
-@code{markup?} es el tipo: lo identifica como un elemento de marcado.
-La función @code{interpret-markup} se usa en casi todas las
-instrucciones de marcado: construye un sello, usando @code{layout},
-@code{props}, y un elemento de marcado. En el segundo caso, la marca
-se construye usando el macro de Scheme @code{markup}, véase
-@ref{Construcción de elementos de marcado en Scheme}. La
-transformación de una expresión @code{\markup} en una expresión de
-marcado de Scheme es directa.
+@code{markup?} es el tipo: lo identifica como un elemento de
+marcado. La función @code{interpret-markup} se usa en casi todas
+las instrucciones de marcado: construye un sello, usando
+@code{layout}, @code{props}, y un elemento de marcado. En el
+segundo caso, la marca se construye usando el macro de Scheme
+@code{markup}, véase @ref{Construcción de elementos de marcado en
+Scheme}. La transformación de una expresión @code{\markup} en
+una expresión de marcado de Scheme es directa.
La instrucción nueva se puede usar como sigue:
\markup \double-box A
@end example
-Sería buen hacer que la instrucción @code{double-box} fuera
-personalizable: aquí, los valores de relleno @code{box-padding} son
-fijos, y no se pueden cambiar por parte del usuario. Además, sería
-mejor distinguir la separación entre los dos rectángulos, del relleno
-entre el rectángulo interno y el texto. Así pues, introducimos una
-nueva propiedad, @code{inter-box-padding}, para el relleno entre los
-rectángulos. El @code{box-padding} se usará para el relleno interno.
-Ahora el código nuevo es como se ve a continuación:
+Sería bueno hacer que la instrucción @code{double-box} fuera
+personalizable: aquí, los valores de relleno @code{box-padding}
+son fijos, y no se pueden cambiar por parte del usuario. Además,
+sería mejor distinguir la separación entre los dos rectángulos,
+del relleno entre el rectángulo interno y el texto. Así pues,
+introducimos una nueva propiedad, @code{inter-box-padding}, para
+el relleno entre los rectángulos. El @code{box-padding} se usará
+para el relleno interno. Ahora el código nuevo es como se ve a
+continuación:
@lisp
#(define-markup-command (double-box layout props text) (markup?)
@{ #text @} #@}))
@end lisp
-De nuevo, la versión equivalente que utiliza la macro de marcado sería:
+De nuevo, la versión equivalente que utiliza la macro de marcado
+sería:
@lisp
#(define-markup-command (double-box layout props text) (markup?)
#:override `(box-padding . ,box-padding) #:box text)))
@end lisp
-Aquí, la palabra clave @code{#:properties} se usa de manera que las
-propiedades @code{inter-box-padding} y @code{box-padding} se leen a
-partir del argumento @code{props}, y se les proporcionan unos valores
-predeterminados si las propiedades no están definidas.
+Aquí, la palabra clave @code{#:properties} se usa de manera que
+las propiedades @code{inter-box-padding} y @code{box-padding} se
+leen a partir del argumento @code{props}, y se les proporcionan
+unos valores predeterminados si las propiedades no están
+definidas.
Después estos valores se usan para sobreescribir las propiedades
@code{box-padding} usadas por las dos instrucciones @code{\box}.
Observe el apóstrofo invertido y la coma en el argumento de
-@code{\override}: nos permiten introducir un valor de variable dentro
-de una expresión literal.
+@code{\override}: nos permiten introducir un valor de variable
+dentro de una expresión literal.
-Ahora, la instrucción se puede usar dentro de un elemento de marcado,
-y el relleno de los rectángulos se puede personalizar:
+Ahora, la instrucción se puede usar dentro de un elemento de
+marcado, y el relleno de los rectángulos se puede personalizar:
@lilypond[quote,verbatim,ragged-right]
#(define-markup-command (double-box layout props text) (markup?)
@unnumberedsubsubsec Adaptación de instrucciones incorporadas
@translationof Adapting builtin commands
-Una buena manera de comenzar a escribir una instrucción de marcado
-nueva, es seguir el ejemplo de otra instrucción ya incorporada. Casi
-todas las instrucciones de marcado que están incorporadas en LilyPond
-se pueden encontrar en el archivo
+Una buena manera de comenzar a escribir una instrucción de
+marcado nueva, es seguir el ejemplo de otra instrucción ya
+incorporada. Casi todas las instrucciones de marcado que están
+incorporadas en LilyPond se pueden encontrar en el archivo
@file{scm/define-markup-commands.scm}.
-Por ejemplo, querríamos adaptar la instrucción @code{\draw-line}, para
-que trace una línea doble. La instrucción @code{\draw-line} está
-definida como sigue (se han suprimido los comentarios de
+Por ejemplo, querríamos adaptar la instrucción @code{\draw-line},
+para que trace una línea doble. La instrucción @code{\draw-line}
+está definida como sigue (se han suprimido los comentarios de
documentación):
@lisp
(make-line-stencil th 0 0 x y)))
@end lisp
-Para definir una instrucción nueva basada en otra existente, copie la
-definición y cámbiele el nombre. La palabra clave @code{#:category}
-se puede eliminar sin miedo, pues sólo se utiliza para generar
-documentación de LilyPond, y no tiene ninguna utilidad para las
-instrucciones de marcado definidas por el usuario.
+Para definir una instrucción nueva basada en otra existente,
+copie la definición y cámbiele el nombre. La palabra clave
+@code{#:category} se puede eliminar sin miedo, pues sólo se
+utiliza para generar documentación de LilyPond, y no tiene
+ninguna utilidad para las instrucciones de marcado definidas por
+el usuario.
@lisp
(define-markup-command (draw-double-line layout props dest)
(make-line-stencil th 0 0 x y)))
@end lisp
-A continuación se añade una propiedad para establecer la separación
-entre las dos líneas, llamada @code{line-gap}, con un valor
-predeterminado de p.ej. 0.6:
+A continuación se añade una propiedad para establecer la
+separación entre las dos líneas, llamada @code{line-gap}, con un
+valor predeterminado de p.ej. 0.6:
@lisp
(define-markup-command (draw-double-line layout props dest)
@dots{}
@end lisp
-Finalmente, se añade el código para trazar las dos líneas. Se usan
-dos llamadas a @code{make-line-stencil} para trazar las líneas, y los
-sellos resultantes se combinan usando @code{ly:stencil-add}:
+Finalmente, se añade el código para trazar las dos líneas. Se
+usan dos llamadas a @code{make-line-stencil} para trazar las
+líneas, y los sellos resultantes se combinan usando
+@code{ly:stencil-add}:
@lilypond[quote,verbatim,ragged-right]
#(define-markup-command (my-draw-line layout props dest)
instrucción de marcado nueva}, excepto que donde éste devuelve un
sello único, aquél devuelve una lista de sellos.
-En el siguiente ejemplo se define una instrucción de lista de marcado
-@code{\paragraph}, que devuelve una lista de líneas justificadas,
-estando la primera de ellas sangrada. La anchura del sangrado se toma
-del argumento @code{props}.
+En el siguiente ejemplo se define una instrucción de lista de
+marcado @code{\paragraph}, que devuelve una lista de líneas
+justificadas, estando la primera de ellas sangrada. La anchura
+del sangrado se toma del argumento @code{props}.
@example
#(define-markup-list-command (paragraph layout props args) (markup-list?)
@end example
Aparte de los argumentos usuales @code{layout} y @code{props}, la
-instrucción de lista de marcados @code{paragraph} toma un argumento de
-lista de marcados, llamado @code{args}. El predicado para listas de
-marcados es @code{markup-list?}.
-
-En primer lugar, la función toma el ancho del sangrado, una propiedad
-llamada aquí @code{par-indent}, de la lista de propiedades
-@code{props}. Si no se encuentra la propiedad, el valor
-predeterminado es @code{2}. Después, se hace una lista de líneas
-justificadas usando la instrucción incorporada de lista de marcados
-@code{\justified-lines}, que está relacionada con la función
-@code{make-justified-lines-markup-list}. Se añade un espacio
-horizontal al principio usando @code{\hspace} (o la función
-@code{make-hspace-markup}). Finalmente, la lista de marcados se
-interpreta usando la función @code{interpret-markup-list}.
-
-Esta nueva instrucción de lista de marcados se puede usar como sigue:
+instrucción de lista de marcados @code{paragraph} toma un
+argumento de lista de marcados, llamado @code{args}. El
+predicado para listas de marcados es @code{markup-list?}.
+
+En primer lugar, la función toma el ancho del sangrado, una
+propiedad llamada aquí @code{par-indent}, de la lista de
+propiedades @code{props}. Si no se encuentra la propiedad, el
+valor predeterminado es @code{2}. Después, se hace una lista de
+líneas justificadas usando la instrucción incorporada de lista de
+marcados @code{\justified-lines}, que está relacionada con la
+función @code{make-justified-lines-markup-list}. Se añade un
+espacio horizontal al principio usando @code{\hspace} (o la
+función @code{make-hspace-markup}). Finalmente, la lista de
+marcados se interpreta usando la función
+@code{interpret-markup-list}.
+
+Esta nueva instrucción de lista de marcados se puede usar como
+sigue:
@example
\markuplist @{
@cindex código, llamadas durante la interpretación
@funindex \applyContext
+@funindex make-apply-context
+@funindex ly:context-property
+@funindex ly:context-set-property!
+@funindex ly:context-grob-definition
+@funindex ly:assoc-get
+@funindex ly:context-pushpop-property
-Se pueden modificar los contextos durante la interpretación con código
-de Scheme. La sintaxis para esto es
+Se pueden modificar los contextos durante la interpretación con
+código de Scheme. Dentro de un bloque de código de LilyPond, la
+sintaxis para esto es:
@example
\applyContext @var{función}
@end example
-@code{@var{función}} debe ser una función de Scheme que toma un único
-argumento, que es el contexto al que aplicarla. El código siguiente
-imprime el número del compás actual sobre la salida estándar durante
-la compilación:
+En código de Scheme, la sintaxis es:
@example
-\applyContext
- #(lambda (x)
- (format #t "\nSe nos ha llamado en el compás número ~a.\n"
- (ly:context-property x 'currentBarNumber)))
+(make-apply-context @var{function})
@end example
+@code{@var{función}} debe ser una función de Scheme que toma un
+único argumento, que es el contexto al que aplicarla. La función
+puede acceder a, así como sobreescribir u establecer propiedades
+de grobs s y propiedades de contextos. Cualquier acción tomada
+por la función que dependa del estado del contexto, está limitada
+al estado del contexto @emph{en el momento de llamar a la
+función}. Asimismo, los cambios efectuados por una llamada a
+@code{\applyContext} permanecen en efecto hasta que se modifican
+de nuevo directamente, o se revierten, incluso si han cambiado las
+condiciones iniciales sobre las que dependen.
+
+Las siguientes funciones de Scheme son útiles cuando se utiliza
+@code{\applyContext}:
+
+@table @code
+@item ly:context-property
+recuperar el valor de una propiedad de contexto
+
+@item ly:context-set-property!
+establecer el valor de una propiedad de contexto
+
+@item ly:context-grob-definition
+@itemx ly:assoc-get
+recuperar el valor de una propiedad de un grob
+
+@item ly:context-pushpop-property
+hacer una sobreescritura temporal
+(@code{\temporary@tie{}\override}) o una reversión
+(@code{\revert}) sobre una propiedad de un grob
+@end table
+
+El ejemplo siguiente recupera el valor actual de @code{fontSize},
+y a continuación lo dobla:
+
+@lilypond[quote,verbatim]
+doubleFontSize =
+\applyContext
+ #(lambda (context)
+ (let ((fontSize (ly:context-property context 'fontSize)))
+ (ly:context-set-property! context 'fontSize (+ fontSize 6))))
+
+{
+ \set fontSize = -3
+ b'4
+ \doubleFontSize
+ b'
+}
+@end lilypond
+
+
+El ejemplo siguiente recupera los colores actuales de los grobs
+@code{NoteHead}, @code{Stem} y @code{Beam}, y a continuación los
+modifica para que tengan un matiz menos saturado.
+
+@lilypond[quote,verbatim]
+desaturate =
+\applyContext
+ #(lambda (context)
+ (define (desaturate-grob grob)
+ (let* ((grob-def (ly:context-grob-definition context grob))
+ (color (ly:assoc-get 'color grob-def black))
+ (new-color (map (lambda (x) (min 1 (/ (1+ x) 2))) color)))
+ (ly:context-pushpop-property context grob 'color new-color)))
+ (for-each desaturate-grob '(NoteHead Stem Beam)))
+
+\relative {
+ \time 3/4
+ g'8[ g] \desaturate g[ g] \desaturate g[ g]
+ \override NoteHead.color = #darkred
+ \override Stem.color = #darkred
+ \override Beam.color = #darkred
+ g[ g] \desaturate g[ g] \desaturate g[ g]
+}
+@end lilypond
+
+
+Esto puede implementarse también como una función musical, con el
+objeto de restringir las modificaciones a un único bloque de
+música. Observe cómo se usa @code{ly:context-pushpop-property}
+tanto como una sobreescritura temporal
+(@code{\temporary@tie{}\override}) como una reversión
+(@code{\revert}):
+
+@lilypond[quote,verbatim]
+desaturate =
+#(define-music-function
+ (music) (ly:music?)
+ #{
+ \applyContext
+ #(lambda (context)
+ (define (desaturate-grob grob)
+ (let* ((grob-def (ly:context-grob-definition context grob))
+ (color (ly:assoc-get 'color grob-def black))
+ (new-color (map (lambda (x) (min 1 (/ (1+ x) 2))) color)))
+ (ly:context-pushpop-property context grob 'color new-color)))
+ (for-each desaturate-grob '(NoteHead Stem Beam)))
+ #music
+ \applyContext
+ #(lambda (context)
+ (define (revert-color grob)
+ (ly:context-pushpop-property context grob 'color))
+ (for-each revert-color '(NoteHead Stem Beam)))
+ #})
+
+\relative {
+ \override NoteHead.color = #darkblue
+ \override Stem.color = #darkblue
+ \override Beam.color = #darkblue
+ g'8 a b c
+ \desaturate { d c b a }
+ g b d b g2
+}
+@end lilypond
+
@node Ejecutar una función sobre todos los objetos de la presentación
@subsection Ejecutar una función sobre todos los objetos de la presentación
@cindex código, llamar sobre objetos de presentación
@funindex \applyOutput
-
La manera más versátil de realizar el ajuste fino de un objeto es
-@code{\applyOutput}, que
-funciona insertando un evento dentro del contexto especificado
-(@rinternals{ApplyOutputEvent}). Su sintaxis es
+@code{\applyOutput}, que funciona insertando un evento dentro del
+contexto especificado (@rinternals{ApplyOutputEvent}). Su
+sintaxis es o bien
@example
\applyOutput @var{Contexto} @var{proc}
@end example
+o bien
+
+@example
+\applyOutput @var{Context}.@var{Grob} @var{proc}
+@end example
+
@noindent
-donde @code{@var{proc}} es una función de Scheme que toma tres argumentos.
+donde @code{@var{proc}} es una función de Scheme que toma tres
+argumentos.
-Al interpretarse, la función @code{@var{proc}} se llama para cada objeto de
-presentación que se encuentra en el contexto @code{@var{Contexto}}
+Al interpretarse, la función @code{@var{proc}} se llama para cada
+objeto de presentación (con el nombre del grob @var{Grob} si se
+especifica) que se encuentra en el contexto @code{@var{Contexto}}
en el tiempo actual, con los siguientes argumentos:
@itemize
Además, la causa del objeto de presentación, es decir el objeto o
expresión musical que es responsable de haberlo creado, está en la
-propiedad @code{cause} del objeto. Por ejemplo, para la cabeza de una
-nota, éste es un evento @rinternals{NoteHead}, y para un objeto
-plica, éste es un objeto @rinternals{Stem}.
+propiedad @code{cause} del objeto. Por ejemplo, para la cabeza de
+una nota, éste es un evento @rinternals{NoteHead}, y para un
+objeto plica, éste es un objeto @rinternals{Stem}.
He aquí una función que usar para @code{\applyOutput}; borra las
-cabezas de las notas que están sobre la línea central y junto a ella:
+cabezas de las notas que están sobre la línea central y junto a
+ella:
@lilypond[quote,verbatim,ragged-right]
#(define (blanker grob grob-origin context)
- (if (and (memq 'note-head-interface (ly:grob-interfaces grob))
- (< (abs (ly:grob-property grob 'staff-position)) 2))
+ (if (< (abs (ly:grob-property grob 'staff-position)) 2)
(set! (ly:grob-property grob 'transparent) #t)))
\relative {
- a'4 e8 <<\applyOutput Voice #blanker a c d>> b2
+ a'4 e8 <<\applyOutput Voice.NoteHead #blanker a c d>> b2
}
@end lilypond
-Para que @var{función} se interprete en los niveles de @code{Score} o de @code{Staff}
-utilice estas formas:
+Para que @var{función} se interprete en los niveles de
+@code{Score} o de @code{Staff} utilice estas formas:
@example
-\applyOutput Score #@var{función}
-\applyOutput Staff #@var{función}
+\applyOutput Score@dots{}
+\applyOutput Staff@dots{}
@end example
@translationof Callback functions
Las propiedades (como @code{thickness} (grosor), @code{direction}
-(dirección), etc.) se pueden establecer a valores fijos con \override,
-p. ej.:
+(dirección), etc.) se pueden establecer a valores fijos con
+\override, p. ej.:
@example
\override Stem.thickness = #2.0
@end example
-Las propiedades pueden fijarse también a un procedimiento de Scheme,
+Las propiedades pueden fijarse también a un procedimiento de
+Scheme:
@lilypond[fragment,verbatim,quote]
\override Stem.thickness = #(lambda (grob)
@end lilypond
@noindent
-En este caso, el procedimiento se ejecuta tan pronto como el valor de
-la propiedad se reclama durante el proceso de formateo.
+En este caso, el procedimiento se ejecuta tan pronto como el valor
+de la propiedad se reclama durante el proceso de formateo.
Casi todo el motor de tipografiado está manejado por estos
@emph{callbacks}. Entre las propiedades que usan normalmente
La rutina que calcula la anchura de un objeto
@end table
-El procedimiento siempre toma un argumento único, que es el grob (el
-objeto gráfico).
+El procedimiento siempre toma un argumento único, que es el grob
+(el objeto gráfico).
Dicho procedimiento puede acceder al valor usual de la propiedad,
llamando en primer lugar a la función que es el @q{callback} usual
@}
@end example
-Si se deben llamar rutinas con varios argumentos, el grob actual se
-puede insertar con una cerradura de grob. He aquí un ajuste
-procedente de @code{AccidentalSuggestion},
-
-@example
-`(X-offset .
- ,(ly:make-simple-closure
- `(,+
- ,(ly:make-simple-closure
- (list ly:self-alignment-interface::centered-on-x-parent))
- ,(ly:make-simple-closure
- (list ly:self-alignment-interface::x-aligned-on-self)))))
-@end example
-
-@noindent
-En este ejemplo, tanto
-@code{ly:self-alignment-interface::x-aligned-on-self} como
-@code{ly:self-alignment-interface::centered-on-x-parent} se llaman con
-el grob como argumento. El resultado se añade con la función
-@code{+}. Para asegurar que esta adición se ejecuta adecuadamente,
-todo ello se encierra dentro de @code{ly:make-simple-closure}.
-
-De hecho, usar un solo procedimiento como valor de una propiedad
-equivale a
-
-@example
-(ly:make-simple-closure (ly:make-simple-closure (list @var{proc})))
-@end example
-
-@noindent
-El @code{ly:make-simple-closure} interior aporta el grob como
-argumento de @var{proc}, el exterior asegura que el resultado de la
-función es lo que se devuelve, en lugar del objeto
-@code{simple-closure}.
-
Desde dentro de un callback, el método más fácil para evaluar un
elemento de marcado es usar grob-interpret-markup. Por ejemplo:
(grob-interpret-markup grob (markup "fulanito")))
@end example
+@ignore
+
+@n ode Código de Scheme en línea
+@s ection Código de Scheme en línea
+@t ranslationof Inline Scheme code
+
+TODO: after this section had been written, LilyPond has improved
+to the point that finding a @emph{simple} example where one would
+@emph{have} to revert to Scheme has become rather hard.
-@node Código de Scheme en línea
-@section Código de Scheme en línea
-@translationof Inline Scheme code
+Until this section gets a rewrite, let's pretend we don't know.
La principal desventaja de @code{\tweak} es su inflexibilidad
sintáctica. Por ejemplo, lo siguiente produce un error de sintaxis (o
de nuevo con @code{set!}. El último elemento del bloque @code{let} es
el valor de retorno, el propio @code{m}.
+@end ignore
+
@node Trucos difíciles
@section Trucos difíciles
@item
Un tipo de ajuste difícil es la apariencia de los objetos de
-extensión, como las ligaduras de expresión y de unión. Inicialmente,
-sólo se crea uno de estos objetos, y pueden ajustarse con el mecanismo
-normal. Sin embargo, en ciertos casos los objetos extensores cruzan
-los saltos de línea. Si esto ocurre, estos objetos se clonan. Se
-crea un objeto distinto por cada sistema en que se encuentra. Éstos
-son clones del objeto original y heredan todas sus propiedades,
-incluidos los @code{\override}s.
+extensión, como las ligaduras de expresión y de unión.
+Inicialmente, sólo se crea uno de estos objetos, y pueden
+ajustarse con el mecanismo normal. Sin embargo, en ciertos casos
+los objetos extensores cruzan los saltos de línea. Si esto
+ocurre, estos objetos se clonan. Se crea un objeto distinto por
+cada sistema en que se encuentra. Éstos son clones del objeto
+original y heredan todas sus propiedades, incluidos los
+@code{\override}s.
En otras palabras, un @code{\override} siempre afecta a todas las
-piezas de un objeto de extensión fragmentado. Para cambiar sólo una
-parte de un extensor en el salto de línea, es necesario inmiscuirse en
-el proceso de formateado. El @emph{callback}
+piezas de un objeto de extensión fragmentado. Para cambiar sólo
+una parte de un extensor en el salto de línea, es necesario
+inmiscuirse en el proceso de formateado. El @emph{callback}
@code{after-line-breaking} contiene el procedimiento Scheme que se
llama después de que se han determinado los saltos de línea, y los
objetos de presentación han sido divididos sobre los distintos
en caso afirmativo, establece @code{extra-offset}.
@end itemize
-Este procedimiento se instala en @rinternals{Tie} (ligadura de unión),
-de forma que la última parte de la ligadura dividida se traslada hacia
-arriba.
+Este procedimiento se instala en @rinternals{Tie} (ligadura de
+unión), de forma que la última parte de la ligadura dividida se
+traslada hacia arriba.
@lilypond[quote,verbatim,ragged-right]
#(define (my-callback grob)
@noindent
Al aplicar este truco, la nueva función de callback
-@code{after-line-breaking} también debe llamar a la antigua,
-si existe este valor predeterminado. Por ejemplo, si se usa con
+@code{after-line-breaking} también debe llamar a la antigua, si
+existe este valor predeterminado. Por ejemplo, si se usa con
@code{Hairpin}, se debe llamar también a
@code{ly:spanner::kill-zero-spanned-time}.
@item Algunos objetos no se pueden cambiar con @code{\override} por
razones técnicas. Son ejemplos @code{NonMusicalPaperColumn} y
@code{PaperColumn}. Se pueden cambiar con la función
-@code{\overrideProperty} que funciona de forma similar a @code{\once
-\override}, pero usa una sintaxis distinta.
+@code{\overrideProperty} que funciona de forma similar a
+@code{\once \override}, pero usa una sintaxis distinta.
@example
\overrideProperty
@c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
@ignore
- Translation of GIT committish: 743dc7b27888c776186336cf4b330d3ebfc821de
+ Translation of GIT committish: bfd8ed4084a441d9ac65b1b088f3b54f31ae40c6
When revising a translation, copy the HEAD committish of the
version that you are working on. For details, see the Contributors'
@cindex evaluar Scheme
@cindex LISP
-LilyPond utiliza el lenguaje de programación Scheme, tanto como parte
-de la sintaxis del código de entrada, como para servir de mecanismo
-interno que une los módulos del programa entre sí. Esta sección es
-una panorámica muy breve sobre cómo introducir datos en Scheme. Si
-quiere saber más sobre Scheme, consulte
+LilyPond utiliza el lenguaje de programación Scheme, tanto como
+parte de la sintaxis del código de entrada, como para servir de
+mecanismo interno que une los módulos del programa entre sí. Esta
+sección es una panorámica muy breve sobre cómo introducir datos en
+Scheme. Si quiere saber más sobre Scheme, consulte
@uref{http://@/www@/.schemers@/.org}.
LilyPond utiliza la implementación GNU Guile de Scheme, que está
basada en el estándar @qq{R5RS} del lenguaje. Si está aprendiendo
Scheme para usarlo con LilyPond, no se recomienda trabajar con una
-implementación distinta (o que se refiera a un estándar diferente).
-Hay información sobre Guile en
+implementación distinta (o que se refiera a un estándar
+diferente). Hay información sobre Guile en
@uref{http://www.gnu.org/software/guile/}. El estándar de Scheme
@qq{R5RS} se encuentra en
@uref{http://www.schemers.org/Documents/Standards/R5RS/}.
@translationof Introduction to Scheme
Comenzaremos con una introducción a Scheme. Para esta breve
-introducción utilizaremos el intérprete GUILE para explorar la manera
-en que el lenguaje funciona. Una vez nos hayamos familiarizado con
-Scheme, mostraremos cómo se puede integrar el lenguaje en los archivos
-de LilyPond.
+introducción utilizaremos el intérprete GUILE para explorar la
+manera en que el lenguaje funciona. Una vez nos hayamos
+familiarizado con Scheme, mostraremos cómo se puede integrar el
+lenguaje en los archivos de LilyPond.
@menu
@translationof Scheme sandbox
La instalación de LilyPond incluye también la de la implementación
-Guile de Scheme. Sobre casi todos los sistemas puede experimentar en
-una @qq{caja de arena} de Scheme abriendo una ventana del terminal y
-tecleando @q{guile}. En algunos sistemas, sobre todo en Windows,
-podría necesitar ajustar la variable de entorno @code{GUILE_LOAD_PATH}
-a la carpeta @code{../usr/share/guile/1.8} dentro de la instalación de
-LilyPond (para conocer la ruta completa a esta carpeta, consulte
+Guile de Scheme. Sobre casi todos los sistemas puede experimentar
+en una @qq{caja de arena} de Scheme abriendo una ventana del
+terminal y tecleando @q{guile}. En algunos sistemas, sobre todo
+en Windows, podría necesitar ajustar la variable de entorno
+@code{GUILE_LOAD_PATH} a la carpeta @code{../usr/share/guile/1.8}
+dentro de la instalación de LilyPond (para conocer la ruta
+completa a esta carpeta, consulte
@rlearning{Otras fuentes de información}). Como alternativa, los
-usuarios de Windows pueden seleccionar simplemente @q{Ejecutar} del
-menú Inicio e introducir @q{guile}.
+usuarios de Windows pueden seleccionar simplemente @q{Ejecutar}
+del menú Inicio e introducir @q{guile}.
-Sin embargo, está disponible un cajón de arena de Scheme listo para
-funcionar con todo LilyPond cargado, con esta instrucción de la línea
-de órdenes:
+Sin embargo, está disponible un cajón de arena de Scheme listo
+para funcionar con todo LilyPond cargado, con esta instrucción de
+la línea de órdenes:
@example
lilypond scheme-sandbox
@end example
@end lisp
Podemos introducir expresiones de Scheme en este indicador para
-experimentar con Scheme. Si quiere usar la biblioteca readline de GNU
-para una más cómoda edición de la línea de órdenes de Scheme, consulte
-el archivo @file{ly/scheme-sandbox.ly} para más información. Si ya ha
-activado la biblioteca readline para las sesiones de Guile
-interactivas fuera de LilyPond, debería funcionar también en el cajón
-de arena.
+experimentar con Scheme. Si quiere usar la biblioteca readline de
+GNU para una más cómoda edición de la línea de órdenes de Scheme,
+consulte el archivo @file{ly/scheme-sandbox.ly} para más
+información. Si ya ha activado la biblioteca readline para las
+sesiones de Guile interactivas fuera de LilyPond, debería
+funcionar también en el cajón de arena.
@node Variables de Scheme
@subsection Variables de Scheme
@translationof Scheme variables
-Las variables de Scheme pueden tener cualquier valor válido de Scheme,
-incluso un procedimiento de Scheme.
+Las variables de Scheme pueden tener cualquier valor válido de
+Scheme, incluso un procedimiento de Scheme.
Las variables de Scheme se crean con @code{define}:
guile>
@end lisp
-Las variables de Scheme se pueden evaluar en el indicador del sistema
-de guile, simplemente tecleando el nombre de la variable:
+Las variables de Scheme se pueden evaluar en el indicador del
+sistema de guile, simplemente tecleando el nombre de la variable:
@lisp
guile> a
guile>
@end lisp
-Las variables de Scheme se pueden imprimir en la pantalla utilizando
-la función display:
+Las variables de Scheme se pueden imprimir en la pantalla
+utilizando la función display:
@lisp
guile> (display a)
@end lisp
@noindent
-Observe que el valor @code{2} y el indicador del sistema @code{guile}
-se muestran en la misma línea. Esto se puede evitar llamando al
-procedimiento de nueva línea o imprimiendo un carácter de nueva línea.
+Observe que el valor @code{2} y el indicador del sistema
+@code{guile} se muestran en la misma línea. Esto se puede evitar
+llamando al procedimiento de nueva línea o imprimiendo un carácter
+de nueva línea.
@lisp
guile> (display a)(newline)
guile>
@end lisp
-Una vez que se ha creado una variable, su valor se puede modificar con
-@code{set!}:
+Una vez que se ha creado una variable, su valor se puede modificar
+con @code{set!}:
@lisp
guile> (set! a 12345)
@subsection Tipos de datos simples de Scheme
@translationof Scheme simple data types
-El concepto más básico de un lenguaje son sus tipos de datos: números,
-cadenas de caracteres, listas, etc. He aquí una lista de los tipos de
-datos que son de relevancia respecto de la entrada de LilyPond.
+El concepto más básico de un lenguaje son sus tipos de datos:
+números, cadenas de caracteres, listas, etc. He aquí una lista de
+los tipos de datos que son de relevancia respecto de la entrada de
+LilyPond.
@table @asis
@item Booleanos
@item Números
Los números se escriben de la forma normal, @code{1} es el número
-(entero) uno, mientras que @w{@code{-1.5}} es un número en coma flotante
-(un número no entero).
+(entero) uno, mientras que @w{@code{-1.5}} es un número en coma
+flotante (un número no entero).
@item Cadenas
Las cadenas se encierran entre comillas:
@end example
@noindent
-y los caracteres de nueva línea al final de cada línea se incluirán
-dentro de la cadena.
+y los caracteres de nueva línea al final de cada línea se
+incluirán dentro de la cadena.
Los caracteres de nueva línea también se pueden añadir mediante la
inclusión de @code{\n} en la cadena.
Las comillas dobles y barras invertidas se añaden a las cadenas
-precediéndolas de una barra invertida. La cadena @code{\a dijo "b"}
-se introduce como
+precediéndolas de una barra invertida. La cadena @code{\a dijo
+"b"} se introduce como
@example
"\\a dijo \"b\""
@end table
-Existen más tipos de datos de Scheme que no se estudian aquí. Para
-ver un listado completo, consulte la guía de referencia de Guile,
+Existen más tipos de datos de Scheme que no se estudian aquí.
+Para ver un listado completo, consulte la guía de referencia de
+Guile,
@uref{http://www.gnu.org/software/guile/manual/html_node/Simple-Data-Types.html}.
@node Tipos de datos compuestos de Scheme
@subsection Tipos de datos compuestos de Scheme
@translationof Scheme compound data types
-También existen tipos de datos compuestos en Scheme. Entre los tipos
-más usados en la programación de LilyPond se encuentran las parejas,
-las listas, las listas-A y las tablas de hash.
+También existen tipos de datos compuestos en Scheme. Entre los
+tipos más usados en la programación de LilyPond se encuentran las
+parejas, las listas, las listas-A y las tablas de hash.
@menu
* Parejas::
@unnumberedsubsubsec Parejas
@translationof Pairs
-El tipo fundacional de datos compuestos de Scheme es la @code{pareja}.
-Como se espera por su nombre, una pareja son dos valores unidos en uno
-solo. El operador que se usa para formar una pareja se llama
-@code{cons}.
+El tipo fundacional de datos compuestos de Scheme es la
+@code{pareja}. Como se espera por su nombre, una pareja son dos
+valores unidos en uno solo. El operador que se usa para formar
+una pareja se llama @code{cons}.
@lisp
guile> (cons 4 5)
guile>
@end lisp
-Los dos elementos de una pareja pueden ser cualquier valor válido de
-Scheme:
+Los dos elementos de una pareja pueden ser cualquier valor válido
+de Scheme:
@lisp
guile> (cons #t #f)
guile>
@end lisp
-Se puede accede al primero y segundo elementos de la pareja mediante
-los procedimientos de Scheme @code{car} y @code{cdr}, respectivamente.
+Se puede accede al primero y segundo elementos de la pareja
+mediante los procedimientos de Scheme @code{car} y @code{cdr},
+respectivamente.
@lisp
guile> (define mipareja (cons 123 "Hola")
@unnumberedsubsubsec Listas
@translationof Lists
-Una estructura de datos muy común en Scheme es la @emph{lista}.
-Formalmente, una lista se define como la lista vacía (representada
-como @code{'()}, o bien como una pareja cuyo @code{cdr} es una lista.
+Una estructura de datos muy común en Scheme es la
+@emph{lista}. Formalmente, una lista @q{bien hecha} se define como
+la lista vacía, representada como @code{'()} y con longitud cero,
+o bien como una pareja cuyo @code{cdr} es a su vez una lista más
+corta.
-Existen muchas formas de crear listas. Quizá la más común es con el
-procedimiento @code{list}:
+Existen muchas formas de crear listas. Quizá la más común es con
+el procedimiento @code{list}:
@lisp
guile> (list 1 2 3 "abc" 17.5)
(1 2 3 "abc" 17.5)
@end lisp
-Como se ve, una lista se imprime en la forma de elementos individuales
-separados por espacios y encerradas entre paréntesis. A diferencia de
-las parejas, no hay ningún punto entre los elementos.
+Como se ve, una lista se imprime en la forma de elementos
+individuales separados por espacios y encerradas entre paréntesis.
+A diferencia de las parejas, no hay ningún punto entre los
+elementos.
-También se puede escribir una lista como una lista literal encerrando
-sus elementos entre paréntesis y añadiendo un apóstrofo:
+También se puede escribir una lista como una lista literal
+encerrando sus elementos entre paréntesis y añadiendo un
+apóstrofo:
@lisp
guile> '(17 23 "fulano" "mengano" "zutano")
(17 23 "fulano" "mengano" "zutano")
@end lisp
-Las listas son una parte fundamental de Scheme. De hecho, Scheme se
-considera un dialecto de Lisp, donde @q{lisp} es una abreviatura de
-@q{List Processing} (proceso de listas). Todas las expresiones de
-Scheme son listas.
+Las listas son una parte fundamental de Scheme. De hecho, Scheme
+se considera un dialecto de Lisp, donde @q{lisp} es una
+abreviatura de @q{List Processing} (proceso de listas). Todas las
+expresiones de Scheme son listas.
@node Listas asociativas (listas-A)
@translationof Association lists (alists)
Un tipo especial de listas son las @emph{listas asociativas} o
-@emph{listas-A}. Se puede usar una lista-A para almacenar datos para
-su fácil recuperación posterior.
+@emph{listas-A}. Se puede usar una lista-A para almacenar datos
+para su fácil recuperación posterior.
-Las listas-A son listas cuyos elementos son parejas. El @code{car} de
-cada elemento se llama @emph{clave}, y el @code{cdr} de cada elemento
-se llama @emph{valor}. El procedimiento de Scheme @code{assoc} se usa
-para recuperar un elemento de la lista-A, y @code{cdr} se usa para
-recuperar el valor:
+Las listas-A son listas cuyos elementos son parejas. El
+@code{car} de cada elemento se llama @emph{clave}, y el @code{cdr}
+de cada elemento se llama @emph{valor}. El procedimiento de
+Scheme @code{assoc} se usa para recuperar un elemento de la
+lista-A, y @code{cdr} se usa para recuperar el valor:
@lisp
guile> (define mi-lista-a '((1 . "A") (2 . "B") (3 . "C")))
guile>
@end lisp
-Las listas-A se usan mucho en LilyPond para almacenar propiedades y
-otros datos.
+Las listas-A se usan mucho en LilyPond para almacenar propiedades
+y otros datos.
@node Tablas de hash
@unnumberedsubsubsec Tablas de hash
@translationof Hash tables
-Estructuras de datos que se utilizan en LilyPond de forma ocasional.
-Una tabla de hash es similar a una matriz, pero los índices de la
-matriz pueden ser cualquier tipo de valor de Scheme, no sólo enteros.
+Estructuras de datos que se utilizan en LilyPond de forma
+ocasional. Una tabla de hash es similar a una matriz, pero los
+índices de la matriz pueden ser cualquier tipo de valor de Scheme,
+no sólo enteros.
-Las tablas de hash son más eficientes que las listas-A si hay una gran
-cantidad de datos que almacenar y los datos cambian con muy poca
-frecuencia.
+Las tablas de hash son más eficientes que las listas-A si hay una
+gran cantidad de datos que almacenar y los datos cambian con muy
+poca frecuencia.
La sintaxis para crear tablas de hash es un poco compleja, pero
veremos ejemplos de ello en el código fuente de LilyPond.
@end lisp
Las claves y los valores se recuperan como una pareja con
-@code{hashq-get-handle}. Ésta es la forma preferida, porque devuelve
-@code{#f} si no se encuentra la clave.
+@code{hashq-get-handle}. Ésta es la forma preferida, porque
+devuelve @code{#f} si no se encuentra la clave.
@lisp
guile> (hashq-get-handle h 'key1)
@end ignore
Scheme se puede usar para hacer cálculos. Utiliza sintaxis
-@emph{prefija}. Sumar 1 y@tie{}2 se escribe como @code{(+ 1 2)} y no
-como el tradicional @math{1+2}.
+@emph{prefija}. Sumar 1 y@tie{}2 se escribe como @code{(+ 1 2)} y
+no como el tradicional @math{1+2}.
@lisp
guile> (+ 1 2)
3
@end lisp
-Los cálculos se pueden anidar; el resultado de una función se puede
-usar para otro cálculo.
+Los cálculos se pueden anidar; el resultado de una función se
+puede usar para otro cálculo.
@lisp
guile> (+ 1 (* 3 4))
Estos cálculos son ejemplos de evaluaciones; una expresión como
@code{(* 3 4)} se sustituye por su valor @code{12}.
-Los cálculos de Scheme son sensibles a las diferencias entre enteros y
-no enteros. Los cálculos enteros son exactos, mientras que los no
-enteros se calculan con los límites de precisión adecuados:
+Los cálculos de Scheme son sensibles a las diferencias entre
+enteros y no enteros. Los cálculos enteros son exactos, mientras
+que los no enteros se calculan con los límites de precisión
+adecuados:
@lisp
guile> (/ 7 3)
@end lisp
Cuando el intérprete de Scheme encuentra una expresión que es una
-lista, el primer elemento de la lista se trata como un procedimiento a
-evaluar con los argumentos del resto de la lista. Por tanto, todos
-los operadores en Scheme son operadores prefijos.
+lista, el primer elemento de la lista se trata como un
+procedimiento a evaluar con los argumentos del resto de la lista.
+Por tanto, todos los operadores en Scheme son operadores prefijos.
-Si el primer elemento de una expresión de Scheme que es una lista que
-se pasa al intérprete @emph{no es} un operador o un procedimiento, se
-produce un error:
+Si el primer elemento de una expresión de Scheme que es una lista
+que se pasa al intérprete @emph{no es} un operador o un
+procedimiento, se produce un error:
@lisp
guile> (1 2 3)
guile>
@end lisp
-Aquí podemos ver que el intérprete estaba intentando tratar el 1 como
-un operador o procedimiento, y no pudo hacerlo. De aquí que el error
-sea "Wrong type to apply: 1".
+Aquí podemos ver que el intérprete estaba intentando tratar el 1
+como un operador o procedimiento, y no pudo hacerlo. De aquí que
+el error sea "Wrong type to apply: 1".
-Así pues, para crear una lista debemos usar el operador de lista, o
-podemos precederla de un apóstrofo para que el intérprete no trate de
-evaluarla.
+Así pues, para crear una lista debemos usar el operador de lista,
+o podemos precederla de un apóstrofo para que el intérprete no
+trate de evaluarla.
@lisp
guile> (list 1 2 3)
guile>
@end lisp
-Esto es un error que puede aparecer cuando trabaje con Scheme dentro
-de LilyPond.
+Esto es un error que puede aparecer cuando trabaje con Scheme
+dentro de LilyPond.
@ignore
La misma asignación se puede hacer también completamente en Scheme,
@subsection Procedimientos de Scheme
@translationof Scheme procedures
-Los procedimientos de Scheme son expresiones de Scheme ejecutables que
-devuelven un valor resultante de su ejecución. También pueden
+Los procedimientos de Scheme son expresiones de Scheme ejecutables
+que devuelven un valor resultante de su ejecución. También pueden
manipular variables definidas fuera del procedimiento.
@menu
expresión-de-scheme-que-devuelve-un-valor)
@end example
-Por ejemplo, podemos definir un procedimiento para calcular la media:
+Por ejemplo, podemos definir un procedimiento para calcular la
+media:
@lisp
guile> (define (media x y) (/ (+ x y) 2))
#<procedure media (x y)>
@end lisp
-Una vez se ha definido un procedimiento, se llama poniendo el nombre
-del procedimiento dentro de una lista. Por ejemplo, podemos calcular
-la media de 3 y 12:
+Una vez se ha definido un procedimiento, se llama poniendo el
+nombre del procedimiento dentro de una lista. Por ejemplo,
+podemos calcular la media de 3 y 12:
@lisp
guile> (media 3 12)
@unnumberedsubsubsec Predicados
@translationof Predicates
-Los procedimientos de Scheme que devuelven valores booleanos se suelen
-llamar @emph{predicados}. Por convenio (pero no por necesidad),
-los nombres de predicados acaban en un signo de interrogación:
+Los procedimientos de Scheme que devuelven valores booleanos se
+suelen llamar @emph{predicados}. Por convenio (pero no por
+necesidad), los nombres de predicados acaban en un signo de
+interrogación:
@lisp
guile> (define (menor-que-diez? x) (< x 10))
@unnumberedsubsubsec Valores de retorno
@translationof Return values
-Los procedimientos de Scheme siempre devuelven un valor de retorno,
-que es el valor de la última expresión ejecutada en el procedimiento.
-El valor de retorno puede ser cualquier valor de Scheme válido,
-incluso una estructura de datos compleja o un procedimiento.
+Los procedimientos de Scheme siempre devuelven un valor de
+retorno, que es el valor de la última expresión ejecutada en el
+procedimiento. El valor de retorno puede ser cualquier valor de
+Scheme válido, incluso una estructura de datos compleja o un
+procedimiento.
-A veces, el usuario quiere tener varias expresiones de Scheme dentro
-de un procedimiento. Existen dos formas en que se pueden combinar
-distintas expresiones. La primera es el procedimiento @code{begin},
-que permite evaluar varias expresiones, y devuelve el valor de la
-última expresión.
+A veces, el usuario quiere tener varias expresiones de Scheme
+dentro de un procedimiento. Existen dos formas en que se pueden
+combinar distintas expresiones. La primera es el procedimiento
+@code{begin}, que permite evaluar varias expresiones, y devuelve
+el valor de la última expresión.
@lisp
guile> (begin (+ 1 2) (- 5 8) (* 2 2))
4
@end lisp
-La segunda forma de combinar varias expresiones es dentro de un bloque
-@code{let}. Dentro de un bloque let, se crean una serie de ligaduras
-o asignaciones, y después se evalúa una secuencia de expresiones que
-pueden incluir esas ligaduras o asignaciones. El valor de retorno del
-bloque let es el valor de retorno de la última sentencia del bloque
-let:
+La segunda forma de combinar varias expresiones es dentro de un
+bloque @code{let}. Dentro de un bloque let, se crean una serie de
+ligaduras o asignaciones, y después se evalúa una secuencia de
+expresiones que pueden incluir esas ligaduras o asignaciones. El
+valor de retorno del bloque let es el valor de retorno de la
+última sentencia del bloque let:
@lisp
guile> (let ((x 2) (y 3) (z 4)) (display (+ x y)) (display (- z 4))
@var{expresión-de-prueba} es una expresión que devuelve un valor
booleano. Si @var{expresión-de-prueba} devuelve @code{#t}, el
procedimiento @code{if} devuelve el valor de la
-@var{expresión-de-cierto}, en caso contrario devuelve el valor de la
-@var{expresión-de-falso}.
+@var{expresión-de-cierto}, en caso contrario devuelve el valor de
+la @var{expresión-de-falso}.
@lisp
guile> (define a 3)
@funindex $
@funindex #
-El intérprete Guile forma parte de LilyPond, lo que significa que se
-puede incluir Scheme dentro de los archivos de entrada de LilyPond.
-Existen varios métodos para incluir Scheme dentro de LilyPond.
+El intérprete Guile forma parte de LilyPond, lo que significa que
+se puede incluir Scheme dentro de los archivos de entrada de
+LilyPond. Existen varios métodos para incluir Scheme dentro de
+LilyPond.
La manera más sencilla es utilizar el símbolo de
almohadilla@tie{}@code{#} antes de una expresión de Scheme.
Ahora bien, el código de entrada de LilyPond se estructura en
-elementos y expresiones, de forma parecida a cómo el lenguaje humano
-se estructura en palabras y frases. LilyPond tiene un analizador
-léxico que reconoce elementos indivisibles (números literales, cadenas
-de texto, elementos de Scheme, nombres de nota, etc.), y un analizador
-que entiende la sintaxis, la Gramática de LilyPond (@rcontrib{LilyPond grammar}).
-Una vez que sabe que se aplica una regla sintáctica concreta, ejecuta
-las acciones asociadas con ella.
+elementos y expresiones, de forma parecida a cómo el lenguaje
+humano se estructura en palabras y frases. LilyPond tiene un
+analizador léxico que reconoce elementos indivisibles (números
+literales, cadenas de texto, elementos de Scheme, nombres de nota,
+etc.), y un analizador que entiende la sintaxis, la Gramática de
+LilyPond (@rcontrib{LilyPond grammar}). Una vez que sabe que se
+aplica una regla sintáctica concreta, ejecuta las acciones
+asociadas con ella.
El método del símbolo de almohadilla@tie{}@code{#} para incrustar
Scheme se adapta de forma natural a este sistema. Una vez que el
analizador léxico ve un símbolo de almohadilla, llama al lector de
-Scheme para que lea una expresión de Scheme completa (que puede ser un
-identificador, una expresión encerrada entre paréntesis, o algunas
-otras cosas). Después de que se ha leído la expresión de Scheme, se
-almacena como el valor de un elemento @code{SCM_TOKEN} de la
-gramática. Después de que el analizador sintáctico ya sabe cómo hacer
-uso de este elemento, llama a Guila para que evalúe la expresión de
-Scheme. Dado que el analizador sintáctico suele requerir un poco de
-lectura por delante por parte del analizador léxico para tomar sus
-decisiones de análisis sintáctico, esta separación de lectura y
-evaluación entre los analizadores léxico y sintáctico es justamente lo
-que se necesita para mantener sincronizadas las ejecuciones de
-expresiones de LilyPond y de Scheme. Por este motivo se debe usar el
-símbolo de almohadilla@tie{}@code{#} para llamar a Scheme siempre que
-sea posible.
-
-Otra forma de llamar al intérprete de Scheme desde lilyPond es el uso
-del símbolo de dólar@tie{}@code{$} en lugar de la almohadilla para
-introducir las expresiondes de Scheme. En este caso, LilyPond evalúa
-el código justo después de que el analizador léxico lo ha leído.
-Comprueba el tipo resultante de la expresión de Scheme y después
-selecciona un tipo de elemento (uno de los varios elementos
-@code{xxx_IDENTIFIER} dentro de la sintaxis) para él. Crea una
-@emph{copia} del valor y la usa como valor del elemento. Si el valor
-de la expresión es vacío (El valor de Guile de @code{*unspecified*}),
-no se pasa nada en absoluto al analizador sintáctico.
-
-Éste es, de hecho, el mismo mecanismo exactamente que LilyPond emplea
-cuando llamamos a cualquier variable o función musical por su nombre,
-como @code{\nombre}, con la única diferencia de que el nombre viene
-determinado por el analizador léxico de LilyPond sin consultar al
-lector de Scheme, y así solamente se aceptan los nombres de variable
-consistentes con el modo actual de LilyPond.
+Scheme para que lea una expresión de Scheme completa (que puede
+ser un identificador, una expresión encerrada entre paréntesis, o
+algunas otras cosas). Después de que se ha leído la expresión de
+Scheme, se almacena como el valor de un elemento @code{SCM_TOKEN}
+de la gramática. Después de que el analizador sintáctico ya sabe
+cómo hacer uso de este elemento, llama a Guila para que evalúe la
+expresión de Scheme. Dado que el analizador sintáctico suele
+requerir un poco de lectura por delante por parte del analizador
+léxico para tomar sus decisiones de análisis sintáctico, esta
+separación de lectura y evaluación entre los analizadores léxico y
+sintáctico es justamente lo que se necesita para mantener
+sincronizadas las ejecuciones de expresiones de LilyPond y de
+Scheme. Por este motivo se debe usar el símbolo de
+almohadilla@tie{}@code{#} para llamar a Scheme siempre que sea
+posible.
+
+Otra forma de llamar al intérprete de Scheme desde LilyPond es el
+uso del símbolo de dólar@tie{}@code{$} en lugar de la almohadilla
+para introducir las expresiondes de Scheme. En este caso,
+LilyPond evalúa el código justo después de que el analizador
+léxico lo ha leído. Comprueba el tipo resultante de la expresión
+de Scheme y después selecciona un tipo de elemento (uno de los
+varios elementos @code{xxx_IDENTIFIER} dentro de la sintaxis) para
+él. Crea una @emph{copia} del valor y la usa como valor del
+elemento. Si el valor de la expresión es vacío (El valor de Guile
+de @code{*unspecified*}), no se pasa nada en absoluto al
+analizador sintáctico.
+
+Éste es, de hecho, el mismo mecanismo exactamente que LilyPond
+emplea cuando llamamos a cualquier variable o función musical por
+su nombre, como @code{\nombre}, con la única diferencia de que el
+nombre viene determinado por el analizador léxico de LilyPond sin
+consultar al lector de Scheme, y así solamente se aceptan los
+nombres de variable consistentes con el modo actual de LilyPond.
La acción inmediata de @code{$} puede llevar a alguna que otra
-sorpresa, véase @ref{Variables de entrada y Scheme}. La utilización
-de @code{#} donde el analizador sintáctico lo contempla es normalmente
-preferible. Dentro de las expresiones musicales, aquellas que se
-crean utilizando @code{#} @emph{se interprentan} como música. Sin
-embargo, @emph{no se copian} antes de ser utilizadas. Si forman parte
-de alguna estructura que aún podría tener algún uso, quizá tenga que
-utilizar explícitamente @code{ly:music-deep-copy}.
+sorpresa, véase @ref{Importación de Scheme dentro de LilyPond}.
+La utilización de @code{#} donde el analizador sintáctico lo
+contempla es normalmente preferible. Dentro de las expresiones
+musicales, aquellas que se crean utilizando @code{#} @emph{se
+interprentan} como música. Sin embargo, @emph{no se copian} antes
+de ser utilizadas. Si forman parte de alguna estructura que aún
+podría tener algún uso, quizá tenga que utilizar explícitamente
+@code{ly:music-deep-copy}.
@funindex $@@
@funindex #@@
-También existen los operadores de @q{división de listas} @code{$@@} y
-@code{#@@} que insertan todos los elementos de una lista dentro del
-contexto circundante.
+También existen los operadores de @q{división de listas}
+@code{$@@} y @code{#@@} que insertan todos los elementos de una
+lista dentro del contexto circundante.
Ahora echemos un vistazo a algo de código de Scheme real. Los
-procedimientos de Scheme se pueden definir dentro de los archivos de
-entrada de LilyPond:
+procedimientos de Scheme se pueden definir dentro de los archivos
+de entrada de LilyPond:
@example
#(define (media a b c) (/ (+ a b c) 3))
@end example
-Observe que los comentarios de LilyPond (@code{%} y @code{%@{ %@}}) no
-se pueden utilizar dentro del código de Scheme, ni siquiera dentro de
-un archivo de entrada de LilyPond, porque es el intérprete Guile, y no
-el analizador léxico de LilyPond, el que está leyendo la expresión de
-Scheme. Los comentarios en el Scheme de Guile se introducen como
-sigue:
+Observe que los comentarios de LilyPond (@code{%} y @code{%@{
+%@}}) no se pueden utilizar dentro del código de Scheme, ni
+siquiera dentro de un archivo de entrada de LilyPond, porque es el
+intérprete Guile, y no el analizador léxico de LilyPond, el que
+está leyendo la expresión de Scheme. Los comentarios en el Scheme
+de Guile se introducen como sigue:
@example
; esto es un comentario de una línea
#!
Esto es un comentario de bloque (no anidable) estilo Guile
- Pero se usan rara vez por parte de los Schemers y nunca dentro del
- código fuente de LilyPond
+ Pero se usan rara vez por parte de los Schemers
+ y nunca dentro del código fuente de LilyPond
!#
@end example
Durante el resto de esta sección, supondremos que los datos se
-introducen en un archivo de música, por lo que añadiremos
-almohadillas@tie{}@code{#} al principio de todas las expresiones de Scheme.
+introducen en un archivo de música, por lo que añadiremos una
+almohadilla@tie{}@code{#} al principio de cada una de las
+expresiones de Scheme.
-Todas las expresiones de Scheme del nivel jerárquico superior dentro
-de un archivo de entrada de LilyPond se pueden combinar en una sola
-expresión de Scheme mediante la utilización del operador @code{begin}:
+Todas las expresiones de Scheme del nivel jerárquico superior
+dentro de un archivo de entrada de LilyPond se pueden combinar en
+una sola expresión de Scheme mediante la utilización del operador
+@code{begin}:
@example
#(begin
#(define doce 12)
@end example
-Esto significa que las variables de LilyPond están disponibles para su
-uso dentro de expresiones de Scheme. Por ejemplo, podríamos usar
+Esto significa que las variables de LilyPond están disponibles
+para su uso dentro de expresiones de Scheme. Por ejemplo,
+podríamos usar
@example
veintiCuatro = (* 2 doce)
lo que daría lugar a que el número 24 se almacenase dentro de la
variable @code{veintiCuatro} de LilyPond (y de Scheme).
-La forma usual de referirse a las variables de LilyPond,
-@ref{Sintaxis del Scheme de LilyPond},
-
-es llamarlas usando una barra invertida, es decir
-@code{\veintiCuatro}. Dado que esto crea una copia para la mayor
-parte de los tipos internos de LilyPond, concretamente las expresiones
-musicales, las funciones musicales no sueln crear copias del material
-que ellas mismas modifican. Por este motivo, las expresiones
-musicales dadas con @code{#} no deberían, por lo general, contener
-material que no se haya creado partiendo de cero o copiado
-explícitamente en lugar de estar referenciado directamente.
+La forma usual de referirse a las variables de LilyPond, es
+llamarlas usando una barra invertida, es decir
+@code{\veintiCuatro} (véase
+@ref{Sintaxis del Scheme de LilyPond}). Dado que esto crea una
+copia para la mayor parte de los tipos internos de LilyPond,
+concretamente las expresiones musicales, las funciones musicales
+no sueln crear copias del material que ellas mismas modifican.
+Por este motivo, las expresiones musicales dadas con @code{#} no
+deberían, por lo general, contener material que no se haya creado
+partiendo de cero o copiado explícitamente en lugar de estar
+referenciado directamente.
@node Variables de entrada y Scheme
@subsection Variables de entrada y Scheme
@translationof Input variables and Scheme
El formato de entrada contempla la noción de variables: en el
-siguiente ejemplo, se asigna una expresión musical a una variable con
-el nombre @code{traLaLa}.
+siguiente ejemplo, se asigna una expresión musical a una variable
+con el nombre @code{traLaLa}.
@example
traLaLa = @{ c'4 d'4 @}
@noindent
-También hay una forma de ámbito: en el ejemplo siguiente, el bloque
-@code{\layout} también contiene una variable @code{traLaLa}, que es
-independiente de la @code{\traLaLa} externa.
+También hay una forma de ámbito: en el ejemplo siguiente, el
+bloque @code{\layout} también contiene una variable
+@code{traLaLa}, que es independiente de la @code{\traLaLa}
+externa.
@example
traLaLa = @{ c'4 d'4 @}
@end example
@c
-En efecto, cada archivo de entrada constituye un ámbito, y cada bloque
-@code{\header}, @code{\midi} y @code{\layout} son ámbitos anidados
-dentro del ámbito de nivel superior.
+En efecto, cada archivo de entrada constituye un ámbito, y cada
+bloque @code{\header}, @code{\midi} y @code{\layout} son ámbitos
+anidados dentro del ámbito de nivel superior.
-Tanto las variables como los ámbitos están implementados en el sistema
-de módulos de GUILE. A cada ámbito se adjunta un módulo anónimo de
-Scheme. Una asignación de la forma:
+Tanto las variables como los ámbitos están implementados en el
+sistema de módulos de GUILE. A cada ámbito se adjunta un módulo
+anónimo de Scheme. Una asignación de la forma:
@example
traLaLa = @{ c'4 d'4 @}
(define traLaLa @var{Valor Scheme de `@code{@dots{}}'})
@end example
-Esto significa que las variables de LilyPond y las variables de Scheme
-se pueden mezclar con libertad. En el ejemplo siguiente, se almacena
-un fragmento de música en la variable @code{traLaLa}, y se duplica
-usando Scheme. El resultado se importa dentro de un bloque
-@code{\score} por medio de una segunda variable @code{twice}:
+Esto significa que las variables de LilyPond y las variables de
+Scheme se pueden mezclar con libertad. En el ejemplo siguiente,
+se almacena un fragmento de música en la variable @code{traLaLa},
+y se duplica usando Scheme. El resultado se importa dentro de un
+bloque @code{\score} por medio de una segunda variable
+@code{twice}:
@lilypond[verbatim]
traLaLa = { c'4 d'4 }
@c Due to parser lookahead
-En realidad, éste es un ejemplo bastante interesante. La asignación
-solo tiene lugar después de que el analizador sintáctico se ha
-asegurado de que no sigue nada parecido a @code{\addlyrics}, de manera
-que necesita comprobar lo que viene a continuación. Lee el símbolo
-@code{#} y la expresión de Scheme siguiente @emph{sin} evaluarla, de
-forma que puede proceder a la asignación, y @emph{posteriormente}
-ejecutar el código de Scheme sin problema.
+En realidad, éste es un ejemplo bastante interesante. La
+asignación solo tiene lugar después de que el analizador
+sintáctico se ha asegurado de que no sigue nada parecido a
+@code{\addlyrics}, de manera que necesita comprobar lo que viene a
+continuación. Lee el símbolo @code{#} y la expresión de Scheme
+siguiente @emph{sin} evaluarla, de forma que puede proceder a la
+asignación, y @emph{posteriormente} ejecutar el código de Scheme
+sin problema.
@node Importación de Scheme dentro de LilyPond
@subsection Importación de Scheme dentro de LilyPond
@funindex $
@funindex #
-El ejemplo anterior muestra cómo @q{exportar} expresiones musicales
-desde la entrada al intérprete de Scheme. Lo contrario también es
-posible. Colocándolo después de @code{$}, un valor de Scheme se
-interpreta como si hubiera sido introducido en la sintaxis de
-LilyPond. En lugar de definir @code{\twice}, el ejemplo anterior
-podría también haberse escrito como
+El ejemplo anterior muestra cómo @q{exportar} expresiones
+musicales desde la entrada al intérprete de Scheme. Lo contrario
+también es posible. Colocándolo después de @code{$}, un valor de
+Scheme se interpreta como si hubiera sido introducido en la
+sintaxis de LilyPond. En lugar de definir @code{\twice}, el
+ejemplo anterior podría también haberse escrito como
@example
@dots{}
Podemos utilizar @code{$} con una expresión de Scheme en cualquier
lugar en el que usaríamos @code{\@var{nombre}} después de haber
asignado la expresión de Scheme a una variable @var{nombre}. Esta
-sustitución se produce dentro del @q{analizador léxico}, de manera que
-LilyPond no llega a darse cuenta de la diferencia.
+sustitución se produce dentro del @q{analizador léxico}, de manera
+que LilyPond no llega a darse cuenta de la diferencia.
-Sin embargo, existe un inconveniente, el de la medida del tiempo. Si
-hubiésemos estado usando @code{$} en vez de @code{#} para definir
-@code{newLa} en el ejemplo anterior, la siguiente definición de Scheme
-habría fracasado porque @code{traLaLa} no habría sido definida aún.
-Para ver una explicación de este problema de momento temporal, véase
-@ref{Sintaxis del Scheme de LilyPond}.
+Sin embargo, existe un inconveniente, el de la medida del tiempo.
+Si hubiésemos estado usando @code{$} en vez de @code{#} para
+definir @code{newLa} en el ejemplo anterior, la siguiente
+definición de Scheme habría fracasado porque @code{traLaLa} no
+habría sido definida aún. Para ver una explicación de este
+problema de momento temporal, véase @ref{Sintaxis del Scheme de
+LilyPond}.
@funindex $@@
@funindex #@@
Un conveniente aspecto posterior pueden ser los operadores de
-@q{división de listas} @code{$@@} y @code{#@@} para la inserción de
-los elementos de una lista dentro del contexto circundante.
+@q{división de listas} @code{$@@} y @code{#@@} para la inserción
+de los elementos de una lista dentro del contexto circundante.
Utilizándolos, la última parte del ejemplo se podría haber escrito
como
@{ #@@newLa @}
@end example
-Aquí, cada elemento de la lista que está almacenado en @code{newLa} se
-toma en secuencia y se inserta en la lista, como si hubiésemos escrito
+Aquí, cada elemento de la lista que está almacenado en
+@code{newLa} se toma en secuencia y se inserta en la lista, como
+si hubiésemos escrito
@example
@{ #(first newLa) #(second newLa) @}
@end example
-Ahora bien, en todas esas formas, el código de Scheme se evalúa en el
-momento en que el código de entrada aún se está procesando, ya sea en
-el analizador léxico o en el analizador sintáctico. Si necesitamos
-que se ejecute en un momento posterior, debemos consultar
-@ref{Funciones de Scheme vacías}, o almacenarlo dentro de un
-procedimiento:
+Ahora bien, en todas esas formas, el código de Scheme se evalúa en
+el momento en que el código de entrada aún se está procesando, ya
+sea en el analizador léxico o en el analizador sintáctico. Si
+necesitamos que se ejecute en un momento posterior, debemos
+consultar @ref{Funciones de Scheme vacías}, o almacenarlo dentro
+de un procedimiento:
@example
#(define (nopc)
@knownissues
-No es posible mezclar variables de Scheme y de LilyPond con la opción
-@option{--safe}.
+No es posible mezclar variables de Scheme y de LilyPond con la
+opción @option{--safe}.
@node Propiedades de los objetos
@subsection Propiedades de los objetos
@translationof Object properties
-Las propiedades de los objetos se almacenan en LilyPond en forma de
-cadenas de listas-A, que son listas de listas-A. Las propiedades se
-establecen añadiendo valores al principio de la lista de propiedades.
-Las propiedades se leen extrayendo valores de las listas-A.
+Las propiedades de los objetos se almacenan en LilyPond en forma
+de cadenas de listas-A, que son listas de listas-A. Las
+propiedades se establecen añadiendo valores al principio de la
+lista de propiedades. Las propiedades se leen extrayendo valores
+de las listas-A.
-El establecimiento de un valor nuevo para una propiedad requiere la
-asignación de un valor a la lista-A con una clave y un valor. La
-sintaxis de LilyPond para hacer esto es la siguiente:
+El establecimiento de un valor nuevo para una propiedad requiere
+la asignación de un valor a la lista-A con una clave y un valor.
+La sintaxis de LilyPond para hacer esto es la siguiente:
@example
\override Stem.thickness = #2.6
@end example
Esta instrucción ajusta el aspecto de las plicas. Se añade una
-entrada de lista-A @code{'(thickness . 2.6)} a la lista de propiedades
-de un objeto @code{Stem}. @code{thickness} se mide a partir del
-grosor de las líneas del pentagrama, y así estas plicas serán
-@code{2.6} veces el grosor de las líneas del pentagrama. Esto hace
-que las plicas sean casi el doble de gruesas de lo normal. Para
-distinguir entre las variables que se definen en los archivos de
-entrada (como @code{veintiCuatro} en el ejemplo anterior) y las
-variables de los objetos internos, llamaremos a las últimas
-@q{propiedades} y a las primeras @q{variables.} Así, el objeto plica
-tiene una propiedad @code{thickness} (grosor), mientras que
-@code{veintiCuatro} es una variable.
+entrada de lista-A @code{'(thickness . 2.6)} a la lista de
+propiedades de un objeto @code{Stem}. @code{thickness} se mide a
+partir del grosor de las líneas del pentagrama, y así estas plicas
+serán @code{2.6} veces el grosor de las líneas del pentagrama.
+Esto hace que las plicas sean casi el doble de gruesas de lo
+normal. Para distinguir entre las variables que se definen en los
+archivos de entrada (como @code{veintiCuatro} en el ejemplo
+anterior) y las variables de los objetos internos, llamaremos a
+las últimas @q{propiedades} y a las primeras @q{variables.} Así,
+el objeto plica tiene una propiedad @code{thickness} (grosor),
+mientras que @code{veintiCuatro} es una variable.
@cindex propiedades frente a variables
@cindex variables frente a propiedades
@unnumberedsubsubsec Desplazamientos
@translationof Offsets
-Los desplazamientos bidimensionales (coordenadas X e Y) se almacenan
-como @emph{parejas}. El @code{car} del desplazamiento es la
-coordenada X, y el @code{cdr} es la coordenada Y.
+Los desplazamientos bidimensionales (coordenadas X e Y) se
+almacenan como @emph{parejas}. El @code{car} del desplazamiento
+es la coordenada X, y el @code{cdr} es la coordenada Y.
@example
\override TextScript.extra-offset = #'(1 . 2)
@end example
Esto asigna la pareja @code{(1 . 2)} a la propiedad
-@code{extra-offset} del objeto TextScript. Estos números se miden en
-espacios de pentagrama, y así esta instrucción mueve el objeto un
-espacio de pentagrama a la derecha, y dos espacios hacia arriba.
+@code{extra-offset} del objeto TextScript. Estos números se miden
+en espacios de pentagrama, y así esta instrucción mueve el objeto
+un espacio de pentagrama a la derecha, y dos espacios hacia
+arriba.
Los procedimientos para trabajar con desplazamientos están en
@file{scm/lily-library.scm}.
@unnumberedsubsubsec Fracciones
@subheading Fractions
-Las fracciones tal y como se utilizan por parte de LilyPond
-se almacenan, de nuevo, como @emph{parejas}, esta
-vez de enteros sin signo. Mientras que Scheme es capaz de representar números racionaes
-como un tipo nativo, musicalmente @samp{2/4} y @samp{1/2} no son lo mismo,
-y necesitamos poder distinguir entre ellos. De igual forma, no existe el concepto
-de @q{fracciones} negativas en LilyPond. Así pues, @code{2/4} en LilyPond
-significa @code{(2 . 4)} en Scheme, y @code{#2/4} en LilyPond significa
+Las fracciones tal y como se utilizan por parte de LilyPond se
+almacenan, de nuevo, como @emph{parejas}, esta vez de enteros sin
+signo. Mientras que Scheme es capaz de representar números
+racionaes como un tipo nativo, musicalmente @samp{2/4} y
+@samp{1/2} no son lo mismo, y necesitamos poder distinguir entre
+ellos. De igual forma, no existe el concepto de @q{fracciones}
+negativas en LilyPond. Así pues, @code{2/4} en LilyPond significa
+@code{(2 . 4)} en Scheme, y @code{#2/4} en LilyPond significa
@code{1/2} en Scheme.
@unnumberedsubsubsec Dimensiones
@translationof Extents
-Las parejas se usan también para almacenar intervalos, que representan
-un rango de números desde el mínimo (el @code{car}) hasta el máximo
-(el @code{cdr}). Los intervalos se usan para almacenar las
-dimensiones en X y en Y de los objetos imprimibles. Para dimensiones
-en X, el @code{car} es la coordenada X de la parte izquierda, y el
-@code{cdr} es la coordenada X de la parte derecha. Para las
-dimensiones en Y, el @code{car} es la coordenada inferior, y el
-@code{cdr} es la coordenada superior.
+Las parejas se usan también para almacenar intervalos, que
+representan un rango de números desde el mínimo (el @code{car})
+hasta el máximo (el @code{cdr}). Los intervalos se usan para
+almacenar las dimensiones en X y en Y de los objetos imprimibles.
+Para dimensiones en X, el @code{car} es la coordenada X de la
+parte izquierda, y el @code{cdr} es la coordenada X de la parte
+derecha. Para las dimensiones en Y, el @code{car} es la
+coordenada inferior, y el @code{cdr} es la coordenada superior.
Los procedimientos para trabajar con intervalos están en
@file{scm/lily-library.scm}. Se deben usar estos procedimientos
@unnumberedsubsubsec Listas-A de propiedades
@translationof Property alists
-Una lista-A de propiedades es una estructura de datos de LilyPond que
-es una lista-A cuyas claves son propiedades y cuyos valores son
-expresiones de Scheme que dan el valor deseado de la propiedad.
+Una lista-A de propiedades es una estructura de datos de LilyPond
+que es una lista-A cuyas claves son propiedades y cuyos valores
+son expresiones de Scheme que dan el valor deseado de la
+propiedad.
-Las propiedades de LilyPond son símbolos de Scheme, como por ejemplo
-@code{'thickness}.
+Las propiedades de LilyPond son símbolos de Scheme, como por
+ejemplo @code{'thickness}.
@node Cadenas de listas-A
El conjunto de todas las propiedades que se aplican a un grob se
almacena por lo general como una cadena de listas-A. Para poder
-encontrar el valor de una propiedad determinada que debería tener un
-grob, se busca por todas las listas-A de la cadena, una a una,
+encontrar el valor de una propiedad determinada que debería tener
+un grob, se busca por todas las listas-A de la cadena, una a una,
tratando de encontrar una entrada que contenga la clave de la
propiedad. Se devuelve la primera entrada de lista-A que se
encuentre, y el valor es el valor de la propiedad.
-El procedimiento de Scheme @code{chain-assoc-get} se usa normalmente
-para obtener los valores de propiedades.
+El procedimiento de Scheme @code{chain-assoc-get} se usa
+normalmente para obtener los valores de propiedades.
@node Representación interna de la música
@subsection Representación interna de la música
@translationof Internal music representation
-Internamente, la música se representa como una lista de Scheme. La
-lista contiene varios elementos que afectan a la salida impresa. El
-análisis sintáctico es el proceso de convertir la música de la
-representación de entrada de LilyPond a la representación interna de
-Scheme.
+Internamente, la música se representa como una lista de Scheme.
+La lista contiene varios elementos que afectan a la salida
+impresa. El análisis sintáctico es el proceso de convertir la
+música de la representación de entrada de LilyPond a la
+representación interna de Scheme.
-Cuando se analiza una expresión musical, se convierte en un conjunto
-de objetos musicales de Scheme. La propiedad definitoria de un objeto
-musical es que ocupa un tiempo. El tiempo que ocupa se llama
-@emph{duración}. Las duraciones se expresan como un número racional
-que mide la longitud del objeto musical en redondas.
+Cuando se analiza una expresión musical, se convierte en un
+conjunto de objetos musicales de Scheme. La propiedad definitoria
+de un objeto musical es que ocupa un tiempo. El tiempo que ocupa
+se llama @emph{duración}. Las duraciones se expresan como un
+número racional que mide la longitud del objeto musical en
+redondas.
Un objeto musical tiene tres clases de tipos:
@itemize
@item
-nombre musical: Cada expresión musical tiene un nombre. Por ejemplo,
-una nota lleva a un @rinternals{NoteEvent}, y @code{\simultaneous}
-lleva a una @rinternals{SimultaneousMusic}. Hay una lista de todas
-las expresiones disponibles en el manual de Referencia de
-funcionamiento interno, bajo el epígrafe @rinternals{Music
-expressions}.
+nombre musical: Cada expresión musical tiene un nombre. Por
+ejemplo, una nota lleva a un @rinternals{NoteEvent}, y
+@code{\simultaneous} lleva a una @rinternals{SimultaneousMusic}.
+Hay una lista de todas las expresiones disponibles en el manual de
+Referencia de funcionamiento interno, bajo el epígrafe
+@rinternals{Music expressions}.
@item
@q{type} (tipo) o interface: Cada nombre musical tiene varios
-@q{tipos} o interfaces, por ejemplo, una nota es un @code{event}, pero
-también es un @code{note-event}, un @code{rhythmic-event}, y un
-@code{melodic-event}. Todas las clases de música están listadas en el
-manual de Referencia de funcionamiento interno, bajo el epígrafe
-@rinternals{Music classes}.
+@q{tipos} o interfaces, por ejemplo, una nota es un @code{event},
+pero también es un @code{note-event}, un @code{rhythmic-event}, y
+un @code{melodic-event}. Todas las clases de música están
+listadas en el manual de Referencia de funcionamiento interno,
+bajo el epígrafe @rinternals{Music classes}.
@item
-objeto de C++: Cada objeto musical está representado por un objeto de
-la clase @code{Music} de C++.
+objeto de C++: Cada objeto musical está representado por un objeto
+de la clase @code{Music} de C++.
@end itemize
La información real de una expresión musical se almacena en
-propiedades. Por ejemplo, un @rinternals{NoteEvent} tiene propiedades
-@code{pitch} y @code{duration} que almacenan la altura y la duración
-de esa nota. Hay una lista de todas la propiedades disponibles en el
-manual de Referencia de funcionamiento interno, bajo el epígrafe
-@rinternals{Music properties}.
+propiedades. Por ejemplo, un @rinternals{NoteEvent} tiene
+propiedades @code{pitch} y @code{duration} que almacenan la altura
+y la duración de esa nota. Hay una lista de todas la propiedades
+disponibles en el manual de Referencia de funcionamiento interno,
+bajo el epígrafe @rinternals{Music properties}.
Una expresión musical compuesta es un objeto musical que contiene
-otros objetos musicales dentro de sus propiedades. Se puede almacenar
-una lista de objetos dentro de la propiedad @code{elements} de un
-objeto musical, o un único objeto musical @q{hijo} dentro de la
-propiedad @code{element}. Por ejemplo, @rinternals{SequentialMusic}
-tiene su hijo dentro de @code{elements}, y @rinternals{GraceMusic}
-tiene su argumento único dentro de @code{element}. El cuerpo de una
-repetición se almacena dentro de la propiedad @code{element} de
+otros objetos musicales dentro de sus propiedades. Se puede
+almacenar una lista de objetos dentro de la propiedad
+@code{elements} de un objeto musical, o un único objeto musical
+@q{hijo} dentro de la propiedad @code{element}. Por ejemplo,
+@rinternals{SequentialMusic} tiene su hijo dentro de
+@code{elements}, y @rinternals{GraceMusic} tiene su argumento
+único dentro de @code{element}. El cuerpo de una repetición se
+almacena dentro de la propiedad @code{element} de
@rinternals{RepeatedMusic}, y las alternativas dentro de
@code{elements}.
@section Construir funciones complicadas
@translationof Building complicated functions
-Esta sección explica cómo reunir la información necesaria para crear
-funciones musicales complicadas.
+Esta sección explica cómo reunir la información necesaria para
+crear funciones musicales complicadas.
@menu
* Presentación de las expresiones musicales::
@cindex displayMusic
@funindex \displayMusic
-Si se está escribiendo una función musical, puede ser muy instructivo
-examinar cómo se almacena internamente una expresión musical. Esto se
-puede hacer con la función musical @code{\displayMusic}
+Si se está escribiendo una función musical, puede ser muy
+instructivo examinar cómo se almacena internamente una expresión
+musical. Esto se puede hacer con la función musical
+@code{\displayMusic}.
@example
@{
@end example
De forma predeterminada, LilyPond imprime estos mensajes sobre la
-consola junto al resto de los mensajes. Para separar estos mensajes y
-guardar el resultado de @code{\display@{LOQUESEA@}}, redirija la
-salida a un archivo.
+consola junto al resto de los mensajes. Para separar estos
+mensajes y guardar el resultado de @code{\display@{LOQUESEA@}},
+puede especificar que se use un puerto de salida opcional:
@example
-lilypond archivo.ly >salida.txt
+@{
+ \displayMusic #(open-output-file "display.txt") @{ c'4\f @}
+@}
@end example
-Con un poco de magia combinada de LilyPond y Scheme, podemos realmente
-hacer que LilyPond dirija solamente esta salida a su propio archivo:
-
+Esto sobreescribe el archivo de salida anterior cada vez ques e
+llama; si necesitamos escribir más de una expresión, debemos usar
+una variable para el puerto y reutilizarla:
@example
@{
- #(with-output-to-file "display.txt"
- (lambda () #@{ \displayMusic @{ c'4\f @} #@}))
+ port = #(open-output-file "display.txt")
+ \displayMusic \port @{ c'4\f @}
+ \displayMusic \port @{ d'4 @}
+ #(close-output-port port)
@}
@end example
+El manual de Guile describe los puertos detalladamente. Solo es
+realmente necesario cerrar el puerto si necesitamos leer el
+archivo antes de que LilyPond termine; en el primer ejemplo, no
+nos hemos molestado en hacerlo.
Un poco de reformateo hace a la información anterior más fácil de
leer:
@end example
Una secuencia musical @code{@{ @dots{} @}} tiene el nombre
-@code{SequentialMusic}, y sus expresiones internas se almacenan coma
-una lista dentro de su propiedad @code{'elements}. Una nota se
-representa como un objeto @code{NoteEvent} (que almacena las
+@code{SequentialMusic}, y sus expresiones internas se almacenan
+coma una lista dentro de su propiedad @code{'elements}. Una nota
+se representa como un objeto @code{NoteEvent} (que almacena las
propiedades de duración y altura) con información adjunta (en este
caso, un evento @code{AbsoluteDynamicEvent} con una propiedad
-@code{"f"} de texto) almacenada en su propiedad @code{articulations}.
+@code{"f"} de texto) almacenada en su propiedad
+@code{articulations}.
@funindex{\void}
-@code{\displayMusic} devuelve la música que imprime en la consola, y
-por ello se interpretará al tiempo que se imprime en la consola. Para
-evitar la interpretación, escriba @code{\void} antes de
+
+@code{\displayMusic} devuelve la música que imprime en la consola,
+y por ello se interpretará al tiempo que se imprime en la consola.
+Para evitar la interpretación, escriba @code{\void} antes de
@code{\displayMusic}.
@node Propiedades musicales
@subsection Propiedades musicales
@translationof Music properties
-@c TODO -- make sure we delineate between @emph{music} properties,
-@c @emph{context} properties, and @emph{layout} properties. These
-@c are potentially confusing.
+@ignore
+TODO -- make sure we delineate between @emph{music} properties,
+@emph{context} properties, and @emph{layout} properties. These
+are potentially confusing.
+@end ignore
Veamos un ejemplo:
(ly:make-pitch 0 0 0))
@end example
-The @code{NoteEvent} object is the representation of @code{someNote}.
-Straightforward. How about putting c' in a chord?
+El objeto @code{NoteEvent} es la representación de
+@code{someNote}. Sencillo. ¿Y si ponemos el c' dentro de un
+acorde?
@example
someNote = <c'>
(ly:make-pitch 0 0 0))))
@end example
-Ahora el objeto @code{NoteEvent} es el primer objeto
-de la propiedad @code{'elements} de @code{someNote}.
+Ahora el objeto @code{NoteEvent} es el primer objeto de la
+propiedad @code{'elements} de @code{someNote}.
-La función @code{display-scheme-music} es la función que se usa por
-parte de @code{\displayMusic} para imprimir la representación de
-Scheme de una expresión musical.
+La función @code{display-scheme-music} es la función que se usa
+por parte de @code{\displayMusic} para imprimir la representación
+de Scheme de una expresión musical.
@example
#(display-scheme-music (first (ly:music-property someNote 'elements)))
(ly:make-pitch 0 0 0)
@end example
-La altura de la nota se puede cambiar estableciendo el valor de esta
-propiedad @code{'pitch},
+La altura de la nota se puede cambiar estableciendo el valor de
+esta propiedad @code{'pitch}.
@funindex \displayLilyMusic
(ly:make-pitch 0 1 0)) ;; establecer la altura a d'.
\displayLilyMusic \someNote
===>
-d'
+d'4
@end example
@subsection Duplicar una nota con ligaduras (ejemplo)
@translationof Doubling a note with slurs (example)
-Supongamos que queremos crear una función que convierte una entrada
-como @code{a} en @code{@{ a( a) @}}. Comenzamos examinando la
-representación interna de la música con la que queremos terminar.
+Supongamos que queremos crear una función que convierte una
+entrada como @code{a} en @code{@{ a( a) @}}. Comenzamos
+examinando la representación interna de la música con la que
+queremos terminar.
@example
\displayMusic@{ a'( a') @}
@end example
La mala noticia es que las expresiones @code{SlurEvent} se deben
-añadir @q{dentro} de la nota (dentro de la
-propiedad @code{articulations}).
+añadir @q{dentro} de la nota (dentro de la propiedad
+@code{articulations}).
-Ahora examinamos la entrada,
+Ahora examinamos la entrada.
@example
\displayMusic a'
(ly:make-pitch 0 5 0))))
@end example
-Así pues, en nuestra función, tenemos que clonar esta expresión (de
-forma que tengamos dos notas para construir la secuencia), añadir
-@code{SlurEvent} a la propiedad @code{'articulations} de cada una de
-ellas, y por último hacer una secuencia @code{SequentialMusic} con los
-dos elementos @code{NoteEvent}. Para añadir a una propiedad, es útil saber
-que una propiedad no establecida se lee como @code{'()}, la lista
-vacía, así que no se requiere ninguna comprobación especial antes de
-que pongamos otro elemento delante de la propiedad
-@code{articulations}.
+Así pues, en nuestra función, tenemos que clonar esta expresión
+(de forma que tengamos dos notas para construir la secuencia),
+añadir @code{SlurEvent} a la propiedad @code{'articulations} de
+cada una de ellas, y por último hacer una secuencia
+@code{SequentialMusic} con los dos elementos @code{NoteEvent}.
+Para añadir a una propiedad, es útil saber que una propiedad no
+establecida se lee como @code{'()}, la lista vacía, así que no se
+requiere ninguna comprobación especial antes de que pongamos otro
+elemento delante de la propiedad @code{articulations}.
@example
@translationof Adding articulation to notes (example)
La manera fácil de añadir articulación a las notas es mezclar dos
-expresiones musicales en un solo contexto.
-Sin embargo, supongamos que queremos
-escribir una función musical que lo haga. Esto tiene la ventaja
-adicional de que podemos usar esa función musical para añadir una
-articulación (como una instrucción de digitación) a una nota única
-dentro de un acorde, lo cual no es posible si nos limitamos a mezclar
-fragmentos de música independientes.
-
-Una @code{$variable} dentro de la notación @code{#@{@dots{}#@}} es como
-una @code{\variable} normal en la notación clásica de LilyPond.
-Sabemos que
+expresiones musicales en un solo contexto. Sin embargo,
+supongamos que queremos escribir una función musical que lo haga.
+Esto tiene la ventaja adicional de que podemos usar esa función
+musical para añadir una articulación (como una instrucción de
+digitación) a una nota única dentro de un acorde, lo cual no es
+posible si nos limitamos a mezclar fragmentos de música
+independientes.
+
+Una @code{$variable} dentro de la notación @code{#@{@dots{}#@}} es
+como una @code{\variable} normal en la notación clásica de
+LilyPond. Sabemos que
@example
@{ \music -. -> @}
@end example
@noindent
-no funciona en LilyPond. Podríamos evitar este problema adjuntando la
-articulación a un acorde vacío,
+no funciona en LilyPond. Podríamos evitar este problema
+adjuntando la articulación a un acorde vacío,
@example
@{ << \music <> -. -> >> @}
@end example
@noindent
-pero a los efectos de este ejemplo, aprenderemos ahora cómo hacerlo en
-Scheme. Empezamos examinando nuestra entrada y la salida deseada,
+pero a los efectos de este ejemplo, aprenderemos ahora cómo
+hacerlo en Scheme. Empezamos examinando nuestra entrada y la
+salida deseada.
@example
% input
@noindent
es una descripción de lo que hace la función. No es estrictamente
-necesaria, pero de igual forma que los nombres claros de variable, es
-una buena práctica.
+necesaria, pero de igual forma que los nombres claros de variable,
+es una buena práctica.
-Se preguntará porqué modificamos el evento de nota directamente en
-lugar de trabajar sobre una copia (se puede usar
+Se preguntará por qué modificamos el evento de nota directamente
+en lugar de trabajar sobre una copia (se puede usar
@code{ly:music-deep-copy} para ello). La razón es un contrato
silencioso: se permite que las funciones musicales modifiquen sus
-argumentos; o bien se generan partiendo de cero (como la entrada del
-usuario) o están ya copiadas (referenciar una variable de música con
-@samp{\name} o la música procedente de expresiones de Scheme
-inmediatas @samp{$(@dots{})} proporcionan una copia). Dado que sería
-ineficiente crear copias innecesarias, el valor devuelto de una
-función musical @emph{no} se copia. Así pues, para cumplir dicho
-contrato, no debemos usar ningún argumento más de una vez, y
+argumentos; o bien se generan partiendo de cero (como la entrada
+del usuario) o están ya copiadas (referenciar una variable de
+música con @samp{\name} o la música procedente de expresiones de
+Scheme inmediatas @samp{$(@dots{})} proporcionan una copia). Dado
+que sería ineficiente crear copias innecesarias, el valor devuelto
+de una función musical @emph{no} se copia. Así pues, para cumplir
+dicho contrato, no debemos usar ningún argumento más de una vez, y
devolverlo cuenta como una vez.
-En un ejemplo anterior, hemos construido música mediante la repetición
-de un argumento musical dado. En tal caso, al menos una repetidión
-tuvo que ser una copia de sí misma. Si no lo fuese, podrían ocurrir
-cosas muy extrañas. Por ejemplo, si usamos @code{\relative} o
-@code{\transpose} sobre la música resultante que contiene los mismos
-elementos varias veces, estarían sujetos varias veces a la
-relativización o al transporte. Si los asignamos a una variable de
-música, se rompe el curso porque hacer referencia a @samp{\name}
-creará de nuevo una copia que no retiene la identidad de los elementos
-repetidos.
-
-Ahora bien, aun cuando la función anterior no es una función musical,
-se usará normalmente dentro de funciones musicales. Así pues, tiene
-sentido obedecer el mismo convenio que usamos para las funciones
-musicales: la entrada puede modificarse para producir la salida, y el
-código que llama es responsable de crear las copias si aún necesita el
-propio argumento sin modificar. Si observamos las propias funciones
-de LilyPond como @code{music-map}, veremos que se atienen a los mismos
-principios.
-
-¿En qué punto nos encontramos? Ahora tenemos un @code{note-event} que
-podemos modificar, no a causa de la utilización de
-@code{ly:music-deep-copy} sino por una explicación muy desarrollada.
-Añadimos el acento a su propiedad de lista @code{'articulations}.
+En un ejemplo anterior, hemos construido música mediante la
+repetición de un argumento musical dado. En tal caso, al menos
+una repetidión tuvo que ser una copia de sí misma. Si no lo
+fuese, podrían ocurrir cosas muy extrañas. Por ejemplo, si usamos
+@code{\relative} o @code{\transpose} sobre la música resultante
+que contiene los mismos elementos varias veces, estarían sujetos
+varias veces a la relativización o al transporte. Si los
+asignamos a una variable de música, se rompe el curso porque hacer
+referencia a @samp{\name} creará de nuevo una copia que no retiene
+la identidad de los elementos repetidos.
+
+Ahora bien, aun cuando la función anterior no es una función
+musical, se usará normalmente dentro de funciones musicales. Así
+pues, tiene sentido obedecer el mismo convenio que usamos para las
+funciones musicales: la entrada puede modificarse para producir la
+salida, y el código que llama es responsable de crear las copias
+si aún necesita el propio argumento sin modificar. Si observamos
+las propias funciones de LilyPond como @code{music-map}, veremos
+que se atienen a los mismos principios.
+
+¿En qué punto nos encontramos? Ahora tenemos un @code{note-event}
+que podemos modificar, no a causa de la utilización de
+@code{ly:music-deep-copy} sino por una explicación muy
+desarrollada. Añadimos el acento a su propiedad de lista
+@code{'articulations}.
@example
(set! place new-value)
(ly:music-property result-event-chord 'articulations))
@end example
-Se usa @code{cons} para añadir un elemento a la parte delantera de una
-lista sin modificar la lista original. Esto es lo que queremos: la
-misma lista de antes, más la nueva expresión @code{ArticulationEvent}.
-El orden dentro de la propiedad @code{'articulations} no tiene
-importancia aquí.
+Se usa @code{cons} para añadir un elemento a la parte delantera de
+una lista sin modificar la lista original. Esto es lo que
+queremos: la misma lista de antes, más la nueva expresión
+@code{ArticulationEvent}. El orden dentro de la propiedad
+@code{'articulations} no tiene importancia aquí.
Finalmente, una vez hemos añadido la articulación de acento a su
-propiedad @code{articulations}, podemos devolver @code{note-event}, de
-aquí la última línea de la función.
+propiedad @code{articulations}, podemos devolver
+@code{note-event}, de aquí la última línea de la función.
Ahora transformamos la función @code{add-accent} en una función
musical (es cuestión de un poco de aderezo sintáctico y una
\input texinfo @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
@ignore
- Translation of GIT committish: 08560a1b8076630c4fc6cb9b902614d8b74fd6fc
+ Translation of GIT committish: 47db9a3883d726ca53e2133a3b2298f78dd6a32e
When revising a translation, copy the HEAD committish of the
version that you are working on. For details, see the Contributors'
@version{}.
@end macro
-@c `Learning Manual' was born 1999-10-10 with git commit b9abaac...
+@c `Learning Manual' was born 1998-08-14 with this commit:
+@c release: 1.0.2
+@c author: Han-Wen Nienhuys
+@c commit: a3a44f9f3c581b6824b3a65f9039656693e09bbf
+@c file: Documentation/tex/tutorial.yo
+
@macro copyrightDeclare
Copyright @copyright{} 1999--2015 por los autores.
@end macro
@c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
@ignore
- Translation of GIT committish: 45dd19546e9b75b3e1e977732f0962f35dd3290e
+ Translation of GIT committish: 42cd2e57e37cbbf1fc5ccbe2bc83048761690f60
When revising a translation, copy the HEAD committish of the
version that you are working on. See TRANSLATION for details.
@translationof Common notation
Este capítulo explica cómo crear hermosas partituras que contengan
-notación musical común, como continuación al material que está en el
-@ref{Tutorial}.
+notación musical común, como continuación al material que está en
+el @ref{Tutorial}.
@menu
* Notación en un solo pentagrama::
@section Notación en un solo pentagrama
@translationof Single staff notation
-Esta sección presenta la notación común que se utiliza para música a
-una voz sobre un pentagrama único.
+Esta sección presenta la notación común que se utiliza para música
+a una voz sobre un pentagrama único.
@menu
* Líneas divisorias y comprobaciones de compás::
-* Alteraciones accidentales y armaduras::
+* Alturas y armaduras::
* Ligaduras de unión y de expresión::
* Articulaciones y matices dinámicos::
* Añadir texto::
@unnumberedsubsubsec Comprobaciones de compás
@translationof Bar checks
-Aunque no es estrictamente necesario, es coneniente utilizar
+Aunque no es estrictamente necesario, es conveniente utilizar
@emph{comprobaciones de compás} dentro del código de entrada para
indicar dónde se supone que van las líneas divisorias. Se
-introducen mediante el caráter de barra vertical, @code{|} (AltGr
+introducen mediante el carácter de barra vertical, @code{|} (AltGr
- 1 en el teclado español). Con las comprobaciones de compás, el
programa puede verificar que hemos introducido las duraciones que
completan los compases correctamente. Las comprobaciones de
compás también hacen que el código de entrada sea más fácil de
leer, porque ayudan a organizar el material.
-@lilypond[verbatim,quote,relative=2]
-g1 | e1 | c2. c'4 | g4 c g e | c4 r r2 |
+@c This example deliberately produces a warning
+@lilypond[verbatim,quote]
+\relative {
+ g'1 | e1 | c2. c' | g4 c g e | c4 r r2 |
+}
@end lilypond
+Si compila el código del ejemplo anterior, verá una advertencia en
+la salida de la consola:
+
+@example
+advertencia: la comprobación de compás ha fallado en: 1/2
+ g'1 | e1 | c2. c'
+ | g4 c g e | c4 r r2 |
+@end example
+
+Aunque la duración que falta está clara en la salida musical de
+este ejemplo sencillo, la advertencia de la salida de consola es
+mucho más efectiva al atraer la atención concretamente al @code{4}
+que falta en el compás 3.
+
@seealso
Referencia de la notación:
@ruser{Comprobación de compás y de número de compás}.
-@node Alteraciones accidentales y armaduras
-@subsection Alteraciones accidentales y armaduras
-@translationof Accidentals and key signatures
+@node Alturas y armaduras
+@subsection Alturas y armaduras
+@translationof Pitches and key signatures
@menu
* Alteraciones accidentales::
* Advertencia armaduras y alturas::
@end menu
-@warning{Con frecuencia, los nuevos usuarios se encuentran confundidos
-por las alteraciones accidentales: le rogamos que lea la advertencia
-que aparece al final de esta sección, ¡especialmente si no está
-familiarizado con la teoría musical!}
+@warning{Con frecuencia, a los nuevos usuarios les cuesta
+comprender cómo usa LilyPond la armadura: le rogamos que lea la
+advertencia que aparece al final de esta sección.}
@node Alteraciones accidentales
@unnumberedsubsubsec Alteraciones accidentales
-@translationof Accidentals
+@translationof Pitch alterations
@cindex accidentales, alteraciones
-@cindex alteraciones
-@cindex alteraciones y armaduras
+@cindex becuadro
@cindex sostenido
@cindex doble sostenido
@cindex sostenido, doble
@rglos{double flat},
@rglos{accidental}.
+En LilyPond, los nombres de las notas identifican alturas. Por
+ejemplo, @code{c} siempre significa Do natural, cualquiera que sea
+la armadura.
+
Una nota con @notation{sostenido} se hace añadiendo @code{is} al
nombre, y una nota @notation{bemol} añadiendo @code{es}. Como ha
podido adivinar, un @notation{doble sostenido} o @notation{doble
-bemol} se hace añadiendo @code{isis} o @code{eses}. Esta sintaxis se
-deriva de las convenciones de nomenclatura de las notas en las lenguas
-nórdicas y germánicas como el alemán y el holandés. Para utilizar
-otros nombres para las @notation{alteraciones accidentales}, véase
-@ruser{Nombres de las notas en otros idiomas}.
+bemol} se hace añadiendo @code{isis} o @code{eses}. Esta sintaxis
+se deriva de las convenciones de nomenclatura de las notas en las
+lenguas nórdicas y germánicas como el alemán y el holandés. Para
+utilizar otros nombres para las @notation{alteraciones
+accidentales}, véase @ruser{Nombres de las notas en otros
+idiomas}.
@lilypond[verbatim,quote]
\relative { cis''4 ees fisis, aeses }
instrucción @code{\key} seguido de una nota y @code{\major} o
@code{\minor}.
-@lilypond[verbatim,quote,relative=2]
-\key d \major
-a1 |
-\key c \minor
-a1 |
+@lilypond[verbatim,quote]
+\relative {
+ \key d \major
+ d'4 fis a c |
+ \bar "||" \key c \minor
+ c,4 ees g b |
+}
@end lilypond
@smallspace
@rglos{transposition},
@rglos{Pitch names}.
-Para determinar si hay que imprimir una @notation{alteración
-accidental}, LilyPond examina las notas y la @notation{armadura de la
-tonalidad}. La armadura solamente afecta a las alteraciones
-@emph{impresas}, ¡no a las propias notas! Esta funcionalidad suele
-confundir a los que están empezando con el programa, por ello
-permítanos explicarla en detalle.
-
-LilyPond hace una clara distinción entre el contenido musical y la
-presentación. La alteración (@notation{bemol}, @notation{becuadro} o
-@notation{sostenido}) de una nota es parte de la altura, y por tanto
-es contenido musical. Si una alteración (un signo @emph{impreso} de
-bemol, becuadro o sostenido) se imprime o no delante de la nota
-correspondiente, es una cuestión de presentación. La presentación es
-algo que sigue unas reglas, así que las alteraciones accidentales se
-imprimen automáticamente según dichas reglas. Las alturas de las
-notas en su música son obras de arte, por tanto no se añadirán
-automáticamente, y usted deberá introducir aquello que quiera oír.
+LilyPond distingue entre el contenido musical y su representación
+impresa. Una entrada como @code{d4 e fis2} define las alturas y
+duraciones de las notas, lo que es el contenido musical. La
+@notation{armadura} forma parte de la representación impresa. La
+armadura también establece reglas para las representaciones
+impresas de las notas. LilyPond compara la altura de cada nota de
+la entrada con la armadura para determinar si imprimir, o no, una
+alteración @notation{accidental}.
+
+La instrucción @code{\key} fija la @notation{armadura}, que afecta
+a la representación impresa, pero @emph{no} modifica la altura
+asignada a una nota cualquiera como @code{c} a partir de la
+entrada.
En el siguiente ejemplo:
@end lilypond
@noindent
-Ninguna nota lleva una alteración impresa, pero de todas formas usted
-debe escribir el @code{is} a @code{cis} y a @code{fis} en el archivoo
-de entrada.
+Ninguna nota lleva una alteración impresa, pero de todas formas
+usted debe escribir el @code{is} a @code{cis} y a @code{fis} en el
+archivo de entrada.
El texto @code{b} no significa @qq{imprimir una bolita negra en la
-tercera línea del pentagrama.} Más bien significa: @qq{hay una nota
-Si natural.} En la tonalidad de La bemol mayor, @emph{lleva} una
-alteración accidental:
+tercera línea del pentagrama.} Más bien significa: @qq{hay una
+nota Si natural.} En la tonalidad de La bemol mayor, @emph{lleva}
+una alteración accidental:
@lilypond[verbatim,quote]
\relative {
}
@end lilypond
-Si se encuentra confundido por lo anterior, piense en lo siguiente: si
-estuvises tocando un piano, ¿qué tecla pulsaría? Si se tratase de una
-tecla negra, entonces ¡@emph{tiene que} añadir @w{@code{-is}} ó
-@w{@code{-es}} al nombre de la nota!
+Cada vez que escriba una nota correspondiente a una tecla negra
+del piano, @emph{tiene que} añadir @w{@code{-is}} ó @w{@code{-es}}
+al nombre de la nota
Poner todas las alteraciones de forma explícita puede que requiera
algo más de trabajo al teclear, pero la ventaja es que la
-@notation{transposición} es más fácil, y las alteraciones se pueden
-imprimir siguiendo varias convenciones distintas. Consulte
+@notation{transposición} es más fácil, y las alteraciones se
+pueden imprimir siguiendo varias convenciones distintas. Consulte
@ruser{Alteraciones accidentales automáticas} para ver ejemplos de
cómo se pueden imprimir las alteraciones de acuerdo a reglas
diferentes.
@rglos{tie}.
Una @notation{ligadura de unión} se crea adjuntando un carácter de
-tilde curva @code{~} a la primera nota ligada:
+tilde curva @code{~} a la primera de las dos notas ligadas:
+
+@lilypond[verbatim,quote]
+\relative { g'4~ g c2~ | c4~ c8 a~ a2 | }
+@end lilypond
+
+@cindex duración aislada
+@cindex aislada, duración
+
+Cuando la altura no cambia, como es el caso cada vez que hay una
+ligadura de unión, las alturas que siguen se pueden omitir, y
+especificar tan solo las duraciones:
@lilypond[verbatim,quote]
\relative { g'4~ 4 c2~ | 4~ 8 a~ 2 | }
@end lilypond
+Esta abreviatura puede ser de utilidad en otros lugares donde las
+duraciones cambian pero la altura se mantiene fija; sin embargo,
+recuerde que una altura aislada seguida de un espacio y de una
+duración aislada se interpreta como una sola nota. En otras
+palabras, @code{c4 a 8 8} se interpreta como @code{c4 a8 a8}, no
+como @code{c4 a4 a8 a8}. En vez de ello, escriba @code{c4 a4 8 8
+}.
+
@node Ligaduras de expresión
@unnumberedsubsubsec Ligaduras de expresión
@translationof Slurs
@rglos{slur}.
Una @notation{ligadura de expresión} es una curva que se traza
-abarcando varias notas. Las notas inicial y final se marcan mediante
-@code{(} y @code{)} respectivamente.
+abarcando varias notas. Las notas inicial y final se marcan
+mediante @code{(} y @code{)} respectivamente.
@lilypond[verbatim,quote]
\relative { d''4( c16) cis( d e c cis d) e( d4) }
Las ligaduras que se utilizan para indicar @notation{fraseos} más
largos se pueden introducir mediante @code{\(} y @code{\)}. Puede
-haber al mismo tiempo ligaduras de legato y ligaduras de fraseo, pero
-no es posible tener legatos simultáneos o ligaduras de expresión
-simultáneas.
+haber al mismo tiempo ligaduras de legato y ligaduras de fraseo.
@lilypond[verbatim,quote]
\relative { g'4\( g8( a) b( c) b4\) }
@rglos{slur},
@rglos{tie}.
-Una @notation{ligadura de expresión} parece una @notation{ligadura de
-unión}, pero tiene un significado distinto. Una ligadura (de unión)
-sencillamente hace que la primera nota sea más larga, y sólo se puede
-utilizar sobre parejas de notas iguales. Las ligaduras de expresión
-indican la @notation{articulación} de las notas, y se pueden utilizar
-sobre grupos mayores de notas. Las ligaduras de unión y de expresión
-se pueden anidar unas dentro de otras.
+Una @notation{ligadura de expresión} parece una @notation{ligadura
+de unión}, pero tiene un significado distinto. Una ligadura (de
+unión) sencillamente hace que la primera nota sea más larga, y
+sólo se puede utilizar sobre parejas de notas iguales. Las
+ligaduras de expresión indican la @notation{articulación} de las
+notas, y se pueden utilizar sobre grupos mayores de notas. Las
+ligaduras de unión y de expresión se pueden anidar unas dentro de
+otras.
@lilypond[verbatim,quote]
\relative { c''4(~ c8 d~ 4 e) }
Glosario musical:
@rglos{articulation}.
-Las @notation{articulaciones} más corrientes se pueden añadir a las
-notas utilizando un guión @code{-} seguido de un carácter único:
+Las @notation{articulaciones} más corrientes se pueden añadir a
+las notas utilizando un guión @code{-} seguido de un carácter
+único:
@lilypond[verbatim,quote]
\relative {
Glosario musical:
@rglos{fingering}.
-De manera similar, las @notation{digitaciones} se pueden añadir a una
-nota utilizando un guión (@code{-}) seguido del dígito deseado:
+De manera similar, las @notation{digitaciones} se pueden añadir a
+una nota utilizando un guión (@code{-}) seguido del dígito
+deseado:
@lilypond[verbatim,quote]
\relative { c''4-3 e-5 b-2 a-1 }
automática, pero puede especificar una dirección mediante @code{^}
(encima) o @code{_} (debajo). También puede usar varias
articulaciones sobre la misma nota. Sin embargo, casi siempre es
-mejor dejar que LilyPond determine la dirección de las articulaciones.
+mejor dejar que LilyPond determine la dirección de las
+articulaciones.
@lilypond[verbatim,quote]
\relative { c''4_-^1 d^. f^4_2-> e^-_+ }
\relative { c''4\ff c\mf c\p c\pp }
@end lilypond
-Los @notation{crescendi} y @notation{decrescendi} comienzan con las
-órdenes @code{\<} y @code{\>}. La siguiente indicación de matiz, como
-por ejemplo @code{\f}, dará por terminado el (de)crescendo, o bien se
-puede usar la instrucción @code{\!}:
+Los @notation{crescendi} y @notation{decrescendi} comienzan con
+las órdenes @code{\<} y @code{\>}. La siguiente indicación de
+matiz, como por ejemplo @code{\f}, dará por terminado el
+(de)crescendo, o bien se puede usar la instrucción @code{\!}:
@lilypond[verbatim,quote]
\relative { c''4\< c\ff\> c c\! }
Glosario musical:
@rglos{beam}.
-Todas las @notation{barras} de las figuras se dibujan automáticamente:
+Todas las @notation{barras} de las figuras se dibujan
+automáticamente:
@lilypond[verbatim,quote]
\relative { a'8 ais d ees r d c16 b a8 }
@end lilypond
-Si no le gustan las barras automáticas, pueden forzarse manualmente.
-Marque la primera nota que comprende la barra con @code{[} y la última
-con @code{]}.
+Si no le gustan las barras automáticas, pueden forzarse
+manualmente. Marque la primera nota que comprende la barra con
+@code{[} y la última con @code{]}.
@lilypond[verbatim,quote]
\relative { a'8[ ais] d[ ees r d] c16 b a8 }
@end lilypond
-Si quiere desactivar completamente el barrado automático o para una
-sección extensa de música, utilice la instrucción @code{\autoBeamOff}
-para apagarlo y @code{\autoBeamOn} para activarlo de nuevo.
+Si quiere desactivar completamente el barrado automático o para
+una sección extensa de música, utilice la instrucción
+@code{\autoBeamOff} para apagarlo y @code{\autoBeamOn} para
+activarlo de nuevo.
@lilypond[verbatim,quote]
\relative {
instrumentos, varios pentagramas para un solo instrumento
(p.ej. piano) y acordes.
-La palabra @qq{polifonía} en música hace referencia al hecho de tener
-más de una voz en un momento determinado dentro de una pieza musical.
-La palabra @qq{polifonía} en LilyPond se refiere al hecho de tener más
-de una voz en el mismo pentagrama.
+La palabra @qq{polifonía} en música hace referencia al hecho de
+tener más de una voz en un momento determinado dentro de una pieza
+musical. La palabra @qq{polifonía} en LilyPond se refiere al
+hecho de tener más de una voz en el mismo pentagrama.
@menu
* Explicación de las expresiones musicales::
@end menu
En los archivos de entrada de LilyPond, la música se representa
-mediante @emph{expresiones musicales}. Una sola nota es una expresión
-musical:
+mediante @emph{expresiones musicales}. Una sola nota es una
+expresión musical:
@lilypond[verbatim,quote,fragment]
a'4
@end lilypond
Al encerrar un grupo de notas dentro de llaves creamos una
-@emph{expresión musical compuesta}. Aquí hemos creado una expresión
-musical compuesta con dos notas:
+@emph{expresión musical compuesta}. Aquí hemos creado una
+expresión musical compuesta con dos notas:
@lilypond[verbatim,quote]
\relative { a'4 g4 }
@end lilypond
-Si colocamos un grupo de expresiones musicales (p.ej.: notas) dentro
-de llaves, eso significa que se encuentran en secuencia (es decir,
-cada una sigue a la anterior). El resultado es otra expresión
-musical:
+Si colocamos un grupo de expresiones musicales (p.ej.: notas)
+dentro de llaves, eso significa que se encuentran en secuencia (es
+decir, cada una sigue a la anterior). El resultado es otra
+expresión musical:
@lilypond[verbatim,quote]
\relative { { a'4 g } f4 g }
@unnumberedsubsubsec Analogía: expresiones matemáticas
@translationof Analogy mathematical expressions
-Este mecanismo es semejante a las fórmulas matemáticas: una fórmula
-grande se construye combinando fórmulas pequeñas. Dichas fórmulas se
-llaman expresiones, y su definición es recursiva de tal forma que se
-pueden construir expresiones de un tamaño y complejidad arbitrarios.
-Por ejemplo:
+Este mecanismo es semejante a las fórmulas matemáticas: una
+fórmula grande se construye combinando fórmulas pequeñas. Dichas
+fórmulas se llaman expresiones, y su definición es recursiva de
+tal forma que se pueden construir expresiones de un tamaño y
+complejidad arbitrarios. Por ejemplo:
@example
1
Glosario musical:
@rglos{polyphony}.
-Esta técnica es muy útil para la música @notation{polifónica}. Para
-introducir música con más voces o con más pentagramas, lo que hacemos
-es combinar varias expresiones en paralelo. Para indicar que dos
-voces se deben interpretar al mismo tiempo, sencillamente introduzca
-una combinación simultánea de expresiones musicales. Una expresión
-musical @q{simultánea} se forma encerrando las expresiones dentro de
-@code{<<} y @code{>>}. En el ejemplo que sigue, tres secuencias (cada
-una de las cuales contiene dos notas diferentes) se combinan de forma
-simultánea:
+Esta técnica es muy útil para la música @notation{polifónica}.
+Para introducir música con más voces o con más pentagramas, lo que
+hacemos es combinar varias expresiones en paralelo. Para indicar
+que dos voces se deben interpretar al mismo tiempo, sencillamente
+introduzca una combinación simultánea de expresiones musicales.
+Una expresión musical @q{simultánea} se forma encerrando las
+expresiones dentro de @code{<<} y @code{>>}. En el ejemplo que
+sigue, tres secuencias (cada una de las cuales contiene dos notas
+diferentes) se combinan de forma simultánea:
@lilypond[verbatim,quote]
<<
>>
@end lilypond
-Tenga en cuenta que hemos sangrado cada nivel jerárquico de la entrada
-con un margen distinto. A LilyPond no le importa cuánto (o cuán poco)
-espacio haya al comienzo de una línea, pero el establecimiento de
-márgenes distintos dentro del código de LilyPond, de esta forma, lo
-hace mucho más fácil de leer por nosotros los seres humanos.
+Tenga en cuenta que hemos sangrado cada nivel jerárquico de la
+entrada con un margen distinto. A LilyPond no le importa cuánto
+(o cuán poco) espacio haya al comienzo de una línea, pero el
+establecimiento de márgenes distintos dentro del código de
+LilyPond, de esta forma, lo hace mucho más fácil de leer por
+nosotros los seres humanos.
@warning{Cada nota se entiende relativa a la nota anterior de la
-entrada, solamente la primera es relativa a la @code{c''} dentro de
-la instrucción inicial @code{@bs{}\relative}.}
+entrada, solamente la primera es relativa a la @code{c''} dentro
+de la instrucción inicial @code{@bs{}\relative}.}
@node Expresiones musicales simultáneas un solo pentagrama
@translationof Simultaneous music expressions single staff
Para determinar el número de pentagramas en una pieza, LilyPond
-examina el comienzo de la primera expresión. Si hay una sola nota,
-hay un solo pentagrama; si hay una expresión simultánea, hay más de un
-pentagrama. El siguiente ejemplo presenta una expresión compleja,
-pero dado que comienza con una sola nota, se dispone sobre un solo
-pentagrama.
+examina el comienzo de la primera expresión. Si hay una sola
+nota, hay un solo pentagrama; si hay una expresión simultánea, hay
+más de un pentagrama. El siguiente ejemplo presenta una expresión
+compleja, pero dado que comienza con una sola nota, se dispone
+sobre un solo pentagrama.
@lilypond[verbatim,quote]
\relative {
@funindex Lyrics
@funindex ChordNames
-Como ya hemos visto en @ref{Explicación de las expresiones musicales},
-los archivos de entrada para LilyPond se construyen a base de
-expresiones musicales. Si la partitura comienza con expresiones
-musicales simultáneas, LilyPond crea varios pentagramas. Sin embargo
-es más fácil ver lo que ocurre si creamos cada uno de los pentagramas
-de forma explícita.
+Como ya hemos visto en @ref{Explicación de las expresiones
+musicales}, los archivos de entrada para LilyPond se construyen a
+base de expresiones musicales. Si la partitura comienza con
+expresiones musicales simultáneas, LilyPond crea varios
+pentagramas. Sin embargo es más fácil ver lo que ocurre si
+creamos cada uno de los pentagramas de forma explícita.
Para imprimir más de un pentagrama, cada fragmento de música que
-constituye un pentagrama se marca escribiendo @code{\new Staff} antes
-de él. Estos elementos @code{Staff} se combinan después en paralelo
-con @code{<<} y @code{>>}:
+constituye un pentagrama se marca escribiendo @code{\new Staff}
+antes de él. Estos elementos @code{Staff} se combinan después en
+paralelo con @code{<<} y @code{>>}:
@lilypond[verbatim,quote]
<<
>>
@end lilypond
-La instrucción @code{\new} inaugura un @q{contexto de notación}. Un
-contexto de notación es un entorno dentro del que se interpretan los
-acontecimientos musicales (como las notas o las instrucciones
-@code{\clef}). Para piezas sencillas, tales contextos de notación se
-crean automáticamente. Para piezas más complicadas, es mejor marcar
-los contextos de forma explícita.
+La instrucción @code{\new} inaugura un @q{contexto de notación}.
+Un contexto de notación es un entorno dentro del que se
+interpretan los acontecimientos musicales (como las notas o las
+instrucciones @code{\clef}). Para piezas sencillas, tales
+contextos de notación se crean automáticamente. Para piezas más
+complicadas, es mejor marcar los contextos de forma explícita.
Existen varias clases de contextos. @code{Score}, @code{Staff} y
-@code{Voice} manejan la notación melódica, mientras que @code{Lyrics}
-se ocupa de los textos cantados y @code{ChordNames} imprime los
-nombres de los acordes.
+@code{Voice} manejan la notación melódica, mientras que
+@code{Lyrics} se ocupa de los textos cantados y @code{ChordNames}
+imprime los nombres de los acordes.
En términos de sintaxis, la anteposición de @code{\new} a una
-expresión musical crea una expresión musical mayor. Es semejante al
-signo menos de las matemáticas. La fórmula @math{(4+5)} es una
+expresión musical crea una expresión musical mayor. Es semejante
+al signo menos de las matemáticas. La fórmula @math{(4+5)} es una
expresión, por tanto @math{-(4+5)} es una expresión más amplia.
Las indicaciones de compás escritas en un pentagrama afectan al resto
Otros grupos de pentagramas se declaran mediante @code{\new
GrandStaff}, que es apropiado para partituras orquestales, y
@code{\new ChoirStaff}, que es apropiado para partituras vocales.
-Cada uno de estos grupos de pautas forma un tipo de contexto distinto,
-que produce la llave a la izquierda y que también controla el alcance
-de las líneas divisorias.
+Cada uno de estos grupos de pautas forma un tipo de contexto
+distinto, que produce la llave a la izquierda y que también
+controla el alcance de las líneas divisorias.
@seealso
Hemos visto con anterioridad cómo se pueden combinar las notas
formando @notation{acordes} que indican que son simultáneas,
-encerrándolas entre dobles ángulos. Sin embargo, la forma normal de
-indicar un acorde es encerrar las notas entre ángulos
+encerrándolas entre dobles ángulos. Sin embargo, la forma normal
+de indicar un acorde es encerrar las notas entre ángulos
@emph{sencillos}. Observe que todas las notas de un acorde deben
tener la misma duración, y que la duración se escribe después del
ángulo de cierre.
@funindex >>
La música polifónica en LilyPond, aunque no es difícil, utiliza
-conceptos que aún no hemos tratado, por lo que no vamos a presentarlos
-en este momento. En su lugar, las secciones siguientes presentan
-estos conceptos y los explican en profundidad.
+conceptos que aún no hemos tratado, por lo que no vamos a
+presentarlos en este momento. En su lugar, las secciones
+siguientes presentan estos conceptos y los explican en
+profundidad.
@seealso
Manual de aprendizaje:
}
@end lilypond
-La @notation{letra} se puede asignar a esas notas, combinando ambas
-con la palabra clave @code{\addlyrics}. La letra se escribe separando
-cada sílaba mediante un espacio.
+La @notation{letra} se puede asignar a esas notas, combinando
+ambas con la palabra clave @code{\addlyrics}. La letra se escribe
+separando cada sílaba mediante un espacio.
@lilypond[verbatim,quote]
<<
d''4 b8 c4 a8 | d4 b8 g4
}
\addlyrics {
- Girls and boys come | out to play,
+ Girls and boys come out to play,
}
>>
@end lilypond
-Observe los
-ángulos dobles @w{@code{<<@dots{}>>}} alrededor del fragmento entero
-para expresar que la música y la letra han de suceder al mismo tiempo.
+Observe los ángulos dobles @w{@code{<<@dots{}>>}} alrededor del
+fragmento entero para expresar que la música y la letra han de
+suceder al mismo tiempo.
@node Alineación de la letra a una melodía
@subsection Alineación de la letra a una melodía
@rglos{melisma},
@rglos{extender line}.
-La siguiente línea de la canción infantil es @notation{The moon doth
-shine as bright as day}. A continuación vamos a ampliarla:
+La siguiente línea de la canción infantil es @notation{The moon
+doth shine as bright as day}. A continuación vamos a ampliarla:
@lilypond[verbatim,quote]
<<
a4 b8 c b a | d4 b8 g4. |
}
\addlyrics {
- Girls and boys come | out to play,
- The | moon doth shine as | bright as day; |
+ Girls and boys come out to play,
+ The moon doth shine as bright as day;
}
>>
@end lilypond
-Si compilamos el código del ejemplo anterior, veremos algunos mensajes
-de advertencia sobre la consola:
-
-@example
-song.ly:12:29: warning: la comprobación de compás ha fallado en: 5/8
- The | moon doth shine as
- | bright as day; |
-song.ly:12:46: warning: la comprobación de compás ha fallado en: 3/8
- The | moon doth shine as | bright as day;
- |
-@end example
-
-Éste es un buen ejemplo de la utilidad de las comprobaciones de
-compás. Ahora, si miramos la música, podemos observar que la letra
-adicional no se alinea correctamente con las notas. La palabra
-@q{shine} se debe cantar sobre dos notas, no una. Esto se conoce como
+Si miramos la música, podemos observar que la letra adicional no
+se alinea correctamente con las notas. La palabra @q{shine} se
+debe cantar sobre dos notas, no una. Esto se conoce como
@notation{melisma}, una sílaba única que se canta sobre más de una
nota. Existen varias formas de hacer que una sílaba recaiga sobre
varias notas, siendo la más sencilla escribir una ligadura de
-expresión sobre ellas (véase @ref{Ligaduras de unión y de expresión}):
+expresión sobre ellas (véase
+@ref{Ligaduras de unión y de expresión}):
@lilypond[verbatim,quote]
<<
a4 b8 c( b) a | d4 b8 g4. |
}
\addlyrics {
- Girls and boys come | out to play,
- The | moon doth shine as | bright as day; |
+ Girls and boys come out to play,
+ The moon doth shine as bright as day;
}
>>
@end lilypond
-Ahora la letra se alinea correctamente con las notas, pero el barrado
-automático de las notas que corresponden a @notation{shine as} no
-parece correcto. Podemos remediarlo insertando instrucciones de
-barrado manual para sobreescribir el barrado automático; para ver más
-detalles consulte @ref{Barras automáticas y manuales}.
+Ahora la letra se alinea correctamente con las notas, pero el
+barrado automático de las notas que corresponden a @notation{shine
+as} no parece correcto. Podemos remediarlo insertando
+instrucciones de barrado manual para sobreescribir el barrado
+automático; para ver más detalles consulte
+@ref{Barras automáticas y manuales}.
@lilypond[verbatim,quote]
<<
a4 b8 c([ b]) a | d4 b8 g4. |
}
\addlyrics {
- Girls and boys come | out to play,
- The | moon doth shine as | bright as day; |
+ Girls and boys come out to play,
+ The moon doth shine as bright as day;
}
>>
@end lilypond
a4 b8 c[ b] a | d4 b8 g4. |
}
\addlyrics {
- Girls and boys come | out to play,
- The | moon doth shine _ as | bright as day; |
+ Girls and boys come out to play,
+ The moon doth shine _ as bright as day;
}
>>
@end lilypond
Si una sílaba se extiende sobre varias notas o una sola nota muy
-larga, normalmente se traza una @notation{línea extensora} desde la
-sílaba que se extiende y por debajo de todas las notas que
+larga, normalmente se traza una @notation{línea extensora} desde
+la sílaba que se extiende y por debajo de todas las notas que
corresponden a dicha sílaba. Se escribe como dos guiones bajos
-@code{__}. He aquí un ejemplo extraído de los primeros tres compases
-del @notation{Lamento de Dido}, de @notation{Dido y Eneas} de Purcell:
+@code{__}. He aquí un ejemplo extraído de los primeros tres
+compases del @notation{Lamento de Dido}, de @notation{Dido y
+Eneas} de Purcell:
@lilypond[verbatim,quote]
<<
c4.( bes8 a4. g8 fis4.) g8 | fis1
}
\addlyrics {
- When I am | laid,
- am | laid __ in | earth,
+ When I am laid,
+ am laid __ in earth,
}
>>
@end lilypond
Hasta el momento, ninguno de los ejemplos implicaban palabras que
-tuviesen más de una sílaba. Estas palabras se reparten por lo general
-a razón de una nota por cada sílaba, con guiones cortos entre las
-sílabas. Dichos guiones separadores se teclean como dos guiones, con
-el resultado de un guión corto centrado entre las sílabas.
-Presentamos a continuación un ejemplo que demuestra esto y todo lo que
-hemos aprendido hasta el momento acerca de la alineación de la letra a
-las notas.
+tuviesen más de una sílaba. Estas palabras se reparten por lo
+general a razón de una nota por cada sílaba, con guiones cortos
+entre las sílabas. Dichos guiones separadores se teclean como dos
+guiones, con el resultado de un guión corto centrado entre las
+sílabas. Presentamos a continuación un ejemplo que demuestra esto
+y todo lo que hemos aprendido hasta el momento acerca de la
+alineación de la letra a las notas.
@c no ragged-right here because otherwise the hyphens get lost,
@c but the example is long enough to avoid looking strange.
d4 d e | c2
}
\addlyrics {
- A -- | way in a __ | man -- ger,
- no __ | crib for a | bed, __
+ A -- way in a __ man -- ger,
+ no __ crib for a bed,
}
>>
@end lilypond
c'4.~ 8 d b | c8([ d]) b c d b | c8
}
\addlyrics {
- Lar -- go_al fac -- | to -- tum del -- la cit -- | tà
+ Lar -- go_al fac -- to -- tum del -- la cit -- tà
}
>>
@end lilypond
c''8 | c8([ bes]) a a([ g]) f | f'4. b, | c4.~ 4
}
\addlyrics {
- Let | flee -- cy flocks the | hills a -- | dorn, __
+ Let flee -- cy flocks the hills a -- dorn, __
}
\relative {
\key f \major
r8 | r4. r4 c'8 | a'8([ g]) f f([ e]) d | e8([ d]) c bes'4
}
\addlyrics {
- Let | flee -- cy flocks the | hills a -- dorn,
+ Let flee -- cy flocks the hills a -- dorn,
}
>>
@end lilypond
-Cualquier partitura de una complejidad mayor que la de este sencillo
-ejemplo se hace mejor separando la letra de la estructura de
-pentagramas mediante variables (expresiones con nombre). Éstas se
-tratan en @ref{Organizar las piezas mediante variables}.
+Cualquier partitura de una complejidad mayor que la de este
+sencillo ejemplo se hace mejor separando la letra de la estructura
+de pentagramas mediante variables (expresiones con nombre). Éstas
+se tratan en @ref{Organizar las piezas mediante variables}.
@seealso
@section Retoques finales
@translationof Final touches
-Éste es el último apartado del tutorial; muestra la forma de dar los
-toques finales a piezas sencillas, y ofrece una introducción al resto
-del manual.
+Éste es el último apartado del tutorial; muestra la forma de dar
+los toques finales a piezas sencillas, y ofrece una introducción
+al resto del manual.
@menu
* Organizar las piezas mediante variables::
Cuando los elementos que hemos discutido anteriormente se combinan
para producir archivos mayores, las expresiones musicales se hacen
-enormes. En música polifónica con muchos pentagramas, los archivos de
-entrada pueden volverse muy propensos a la confusión. Podemos reducir
-esta confusión utilizando las @emph{variables}.
+enormes. En música polifónica con muchos pentagramas, los
+archivos de entrada pueden volverse muy propensos a la confusión.
+Podemos reducir esta confusión utilizando las @emph{variables}.
-Con las variables (también conocidas como identificadores o macros),
-podemos trocear las expresiones musicales complejas. Una variable se
-asigna de la manera siguiente:
+Con las variables (también conocidas como identificadores o
+macros), podemos trocear las expresiones musicales complejas. Una
+variable se asigna de la manera siguiente:
@example
musicaConNombre = @{ @dots{} @}
@end example
-El contenido de la expresión musical @code{musicaConNombre} se puede
-usar posteriormente colocando una barra invertida delante del nombre
-(@code{\musicaConNombre}, igual que una orden normal de LilyPond).
+El contenido de la expresión musical @code{musicaConNombre} se
+puede usar posteriormente colocando una barra invertida delante
+del nombre (@code{\musicaConNombre}, igual que una orden normal de
+LilyPond).
@lilypond[verbatim,quote]
violin = \new Staff {
@end lilypond
@noindent
-El nombre de una variable debe consistir enteramente en caracteres
-alfabéticos, es decir sin números, guiones ni guiones bajos.
+Por convención, los nombres de variable consisten enteramente en
+caracteres alfabéticos.
-Las variables se deben definir @emph{antes} de la expresión musical
-principal, pero se pueden usar tantas veces como se quiera, en
-cualquier lugar, una vez que han sido definidas. Incluso se pueden
-usar dentro de la definición de otra variable, proporcionando una vía
-para acortar el código si una sección musical se repite muchas veces.
+Las variables se deben definir @emph{antes} de la expresión
+musical principal, pero se pueden usar tantas veces como se
+quiera, en cualquier lugar, una vez que han sido definidas.
+Incluso se pueden usar dentro de la definición de otra variable,
+proporcionando una vía para acortar el código si una sección
+musical se repite muchas veces.
@c KEEP LY
-@lilypond[verbatim,quote,ragged-right]
-tresilloA = \tuplet 3/2 { c,8 e g }
+@lilypond[verbatim,quote]
+tresilloA = \relative { \tuplet 3/2 { c'8 e g } }
compasA = { \tresilloA \tresilloA \tresilloA \tresilloA }
-\relative c'' {
- \compasA \compasA
-}
+{ \compasA \compasA }
@end lilypond
Las variables se pueden usar para otros muchos tipos de objetos dentro
papelAcinco = \paper @{ paperheight = 21.0 \cm @}
@end example
-Dependiendo de su contenido, la variable se puede usar en distintos
-lugares. El siguiente ejemplo utiliza las variables anteriores:
+Dependiendo de su contenido, la variable se puede usar en
+distintos lugares. El siguiente ejemplo utiliza las variables
+anteriores:
@example
\paper @{
@funindex \header
@funindex header
-La información sobre el título, autor, número de Opus y similares se
-escriben en el bloque @code{\header}. Éste se encuentra fuera de la
-expresión musical principal; el bloque @code{\header} normalmente se
-sitúa por debajo del número de versión.
+La información sobre el título, autor, número de Opus y similares
+se escriben en el bloque @code{\header}. Éste se encuentra fuera
+de la expresión musical principal; el bloque @code{\header}
+normalmente se sitúa por debajo del número de versión.
@example
\version @w{"@version{}"}
@end example
Cuando se procesa el archivo, el título y el autor se imprimen por
-encima de la música. Puede obtener más información sobre los títulos
-en @ruser{Crear títulos encabezamientos y pies de página}.
+encima de la música. Puede obtener más información sobre los
+títulos en @ruser{Crear títulos encabezamientos y pies de página}.
@node Nombres de nota absolutos
@cindex alturas, valores absolutos de
@cindex absolutos, nombres de nota
-Hasta el momento siempre hemos utilizado @code{\relative} para definir
-las alturas. Ésta es normalmente la forma más rápida de escribir la mayor parte
-de la música. Sin @code{\relative}, las alturas se interpretan en modo absoluto.
+Hasta el momento hemos utilizado @code{\relative} para definir las
+alturas. Ésta es normalmente la forma más rápida de escribir la
+mayor parte de la música. Sin @code{\relative}, las alturas se
+interpretan en modo absoluto.
-En este modo, LilyPond tratará todas las alturas como
-valores absolutos. Una @code{c'} significará siembre un Do central,
-una @code{b} significará siempre la nota inmediatamente por debajo del
-Do central, y una @code{g,} significará siempre la nota que se coloca
-en la primera línea del pentagrama en clave de Fa.
+En este modo, LilyPond tratará todas las alturas como valores
+absolutos. Una @code{c'} significará siembre un Do@tie{}central,
+una @code{b} significará siempre la nota inmediatamente por debajo
+del Do@tie{}central, y una @code{g,} significará siempre la nota
+que se coloca en la primera línea del pentagrama en clave de Fa.
@lilypond[verbatim,quote]
{
}
@end lilypond
-He aquí una escala que abarca cuatro octavas:
+La escritura de una melodía en clave de Sol implica un gran número
+de apóstrofos (@code{'}). Considere este fragmento de Mozart:
@lilypond[verbatim,quote]
{
- \clef "bass"
- c,4 d, e, f, |
- g,4 a, b, c |
- d4 e f g |
- a4 b c' d' |
- \clef "treble"
- e'4 f' g' a' |
- b'4 c'' d'' e'' |
- f''4 g'' a'' b'' |
- c'''1 |
+ \key a \major
+ \time 6/8
+ cis''8. d''16 cis''8 e''4 e''8 |
+ b'8. cis''16 b'8 d''4 d''8 |
}
@end lilypond
-Como puede ver, escribir una melodía en clave de Sol implica escribir
-gran cantidad de apóstrofos @q{'} . Consideremos este fragmento de
-Mozart:
+@funindex \fixed
+Las marcas de octava que son comunes se pueden indicar una sola
+vez, utilizando la instrucción @code{\fixed} seguida de una altura
+de referencia:
@lilypond[verbatim,quote]
-{
+\fixed c'' {
\key a \major
\time 6/8
- cis''8. d''16 cis''8 e''4 e''8 |
- b'8. cis''16 b'8 d''4 d''8 |
+ cis8. d16 cis8 e4 e8 |
+ b,8. cis16 b,8 d4 d8 |
}
@end lilypond
-Todos estos apóstrofos hacen casi ilegible el código de entrada y será
-origen de numerosos errores. Con @code{\relative}, el ejemplo
-anterior es mucho más fácil de leer:
+Con @code{\relative}, el ejemplo anterior no requiere marcas de
+cambio de octava porque esta melodía se mueve por intervalos no
+mayores de una cuarta, o tres posiciones dentro del pentagrama:
@lilypond[verbatim,quote]
\relative {
@end lilypond
Si comete un error con una marca de octava (@code{'} o @code{,})
-mientras trabaja en el modo @code{\relative}, será muy obvio (muchas
-notas estarán en la octava equivocada). Mientras trabaja en el modo
-absoluto, un solo fallo no será tan visible, y tampoco será tan fácil
-de localizar.
+mientras trabaja en el modo @code{\relative}, será muy obvio
+(muchas notas estarán en la octava equivocada). Mientras trabaja
+en el modo absoluto, un solo fallo no será tan visible, y tampoco
+será tan fácil de localizar.
Sin embargo, el modo absoluto es útil para escribir música que
contenga intervalos grandes, y será extremadamente útil para hacer
\relative { c'4 \relative { f'' g } c }
@end lilypond
-@funindex \absolute
-Si está usando música absoluta dentro de un bloque de música
-relativa, tendrá que marcar la música absoluta explícitamente con
-la instrucción @code{\absolute} para evitar que se incorpore a la
-música relativa:
+Para usar el modo absoluto dentro de @code{\relative}, ponga la
+música absoluta dentro de @code{\fixed c @{ @dots{} @}} y las
+notas absolutas no afectarán a las octavas de la música relativa:
@lilypond[verbatim,quote]
-\relative { c'4 \absolute { f'' g'' } c }
+\relative {
+ c'4 \fixed c { f'' g'' } c |
+ c4 \fixed c'' { f g } c
+}
@end lilypond
@node Más allá del tutorial
@subsection Más allá del tutorial
@translationof After the tutorial
-Después de terminar el tutorial, quizá debería probar a escribir una o
-dos piezas. Comience con una de las plantillas que aparecen en
-@ref{Plantillas} y añada algunas notas. Si necesita un tipo de
-notación que no ha sido tratada en el tutorial, eche un vistazo a la
-Referencia de Notación, empezando por @ruser{Notación musical}. Si
-quiere escribir música para un conjunto instrumental que no está
-cubierto por ninguna plantilla, consulte @ref{Extender las
+Después de terminar el tutorial, quizá debería probar a escribir
+una o dos piezas. Comience con una de las plantillas que aparecen
+en @ref{Plantillas} y añada algunas notas. Si necesita un tipo de
+notación que no ha sido tratada en el tutorial, eche un vistazo a
+la Referencia de Notación, empezando por @ruser{Notación musical}.
+Si quiere escribir música para un conjunto instrumental que no
+está cubierto por ninguna plantilla, consulte @ref{Extender las
plantillas}.
-Una vez que ha escrito algunas piezas cortas, lea el resto del Manual
-de aprendizaje (capítulos 3 al 5). ¡Por supuesto, no pasa nada por
-leerlo ahora mismo! Sin embargo, el resto del Manual de Aprendizaje
-da por sentado que está familiarizado con la entrada de LilyPond.
-Puede saltarse estos capítulos ahora y volver a ellos cuando haya
-adquirido más experiencia.
-
-En este tutorial y en el resto del Manual de aprendizaje, existe un
-apartado @strong{Véase también} al final de cada una de las secciones,
-que contiene referencias cruzadas a otras secciones: no siga estas
-referencias durante la primera lectura; cuando haya leído el Manual de
-aprendizaje completo, quizá desee releer ciertas secciones y seguir
-las referencias cruzadas para obtener más información.
-
-Si no lo ha hecho aún, le @emph{rogamos} que lea @ref{Panorámica de
-los manuales}. Existe una gran cantidad de información sobre
-LilyPond, de manera que los recién llegados con frecuencia no saben
-exactamente dónde deben buscar la ayuda. Si emplea cinco minutos en
-leer cuidadosamente esta sección ¡se ahorrará horas de frustración
-buscando en el sitio equivocado!
+Una vez que ha escrito algunas piezas cortas, lea el resto del
+Manual de aprendizaje (capítulos 3 al 5). ¡Por supuesto, no pasa
+nada por leerlo ahora mismo! Sin embargo, el resto del Manual de
+Aprendizaje da por sentado que está familiarizado con la entrada
+de LilyPond. Puede saltarse estos capítulos ahora y volver a
+ellos cuando haya adquirido más experiencia.
+
+En este tutorial y en el resto del Manual de aprendizaje, existe
+un apartado @strong{Véase también} al final de cada una de las
+secciones, que contiene referencias cruzadas a otras secciones: no
+siga estas referencias durante la primera lectura; cuando haya
+leído el Manual de aprendizaje completo, quizá desee releer
+ciertas secciones y seguir las referencias cruzadas para obtener
+más información.
+
+Si no lo ha hecho aún, le @emph{rogamos} que lea @ref{Panorámica
+de los manuales}. Existe una gran cantidad de información sobre
+LilyPond, de manera que los recién llegados con frecuencia no
+saben exactamente dónde deben buscar la ayuda. Si emplea cinco
+minutos en leer cuidadosamente esta sección ¡se ahorrará horas de
+frustración buscando en el sitio equivocado!
@c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
@ignore
- Translation of GIT committish: 7fdce4f39834cc8c83f176480cc1d20900eb09f8
+ Translation of GIT committish: 8451fc41680f500fff56f826017b53dc3dcbf65d
When revising a translation, copy the HEAD committish of the
version that you are working on. For details, see the Contributors'
@chapter Conceptos fundamentales
@translationof Fundamental concepts
-Ha podido ver en el tutorial cómo producir música bellamente impresa a
-partir de un simple archivo de texto. Esta sección presenta los
-conceptos y técnicas que se requieren para producir partituras
-igualmente bellas pero más complejas.
+Ha podido ver en el tutorial cómo producir música bellamente
+impresa a partir de un simple archivo de texto. Esta sección
+presenta los conceptos y técnicas que se requieren para producir
+partituras igualmente bellas pero más complejas.
@menu
* Cómo funcionan los archivos de entrada de LilyPond::
El formato de entrada de LilyPond es bastante libre en su forma y
concede a los usuarios con experiencia mucha flexibilidad para
-estructurar sus archivos de la forma que deseen. Sin embargo, toda
-esta flexibilidad puede hacer que las cosas se vuelvan confusas para
-los nuevos usuarios. Esta sección le va a explicar parte de esta
-estructura, pero puede obviar ciertos detalles en aras de la
-simplicidad. Para ver una descripción completa del formato de
-entrada, consulte @ruser{Estructura del archivo}.
+estructurar sus archivos de la forma que deseen. Sin embargo,
+toda esta flexibilidad puede hacer que las cosas se vuelvan
+confusas para los nuevos usuarios. Esta sección le va a explicar
+parte de esta estructura, pero puede obviar ciertos detalles en
+aras de la simplicidad. Para ver una descripción completa del
+formato de entrada, consulte @ruser{Estructura del archivo}.
@menu
@cindex entrada, formato de la
@cindex archivo, estructura del
-Un ejemplo básico de archivo de entrada de LilyPond es el siguiente:
+Un ejemplo básico de archivo de entrada de LilyPond es el
+siguiente:
@example
\version @w{"@version{}"}
@end example
@noindent
-Existen muchas variaciones de este esquema básico, pero el ejemplo
-constituye un útil punto de partida.
+Existen muchas variaciones de este esquema básico, pero el
+ejemplo constituye un útil punto de partida.
@funindex \book
@funindex book
@cindex libro
@cindex partitura
-Hasta el momento, ninguno de los ejemplos que ha podido ver utiliza la
-instrucción @code{\score@{@}}. Esto es así a causa de que LilyPond
-añade automáticamente las órdenes adicionales que se requieren cuando
-le proporcionamos una entrada sencilla. LilyPond trata una entrada
-como esta:
+Hasta el momento, ninguno de los ejemplos que ha podido ver
+utiliza la instrucción @code{\score@{@}}. Esto es así a causa de
+que LilyPond añade automáticamente las órdenes adicionales que se
+requieren cuando le proporcionamos una entrada sencilla.
+LilyPond trata una entrada como esta:
@example
\relative @{
@end example
En otras palabras, si la entrada consta de una única expresión
-musical, LilyPond interpreta el archivo como si la expresión musical
-estuviera rodeada por un envoltorio hecho por las instrucciones que
-acabamos de ver.
+musical, LilyPond interpreta el archivo como si la expresión
+musical estuviera rodeada por un envoltorio hecho por las
+instrucciones que acabamos de ver.
@cindex contextos implícitos
@cindex implícitos, contextos
@strong{¡Advertencia!} Muchos de los ejemplos que aparecen en la
-documentación de LilyPond omiten las instrucciones @code{\new Staff} y
-@code{\new Voice}, dejando que se creen de forma implícita. Esto
-funciona bien para ejemplos sencillos, pero para ejemplos más
-complicados, especialmente cuando se usan instrucciones adicionales,
-la creación implícita de los contextos puede dar lugar a resultados
-inesperados, incluso en ocasiones crear pentagramas no deseados. La
-forma de crear contextos de forma explícita se explica en
-@ref{Contextos y grabadores}.
-
-@warning{Cuando se escriben más de unas pocas líneas de música, se
-recomienda crear siempre los pentagramas y las voces de forma
+documentación de LilyPond omiten las instrucciones @code{\new
+Staff} y @code{\new Voice}, dejando que se creen de forma
+implícita. Esto funciona bien para ejemplos sencillos, pero para
+ejemplos más complicados, especialmente cuando se usan
+instrucciones adicionales, la creación implícita de los contextos
+puede dar lugar a resultados inesperados, incluso en ocasiones
+crear pentagramas no deseados. La forma de crear contextos de
+forma explícita se explica en @ref{Contextos y grabadores}.
+
+@warning{Cuando se escriben más de unas pocas líneas de música,
+se recomienda crear siempre los pentagramas y las voces de forma
explícita.}
De todas formas, por ahora vamos a volver al primer ejemplo para
-examinar la instrucción @code{\score}, dejando las demás en su forma
-predeterminada.
+examinar la instrucción @code{\score}, dejando las demás en su
+forma predeterminada.
Un bloque @code{\score} siempre debe contener una expresión musical
-única, que debe aparecer inmediatamente después de la instrucción
-@code{\score}. Recuerde que una expresión musical podía ser cualquier
+única. Recuerde que una expresión musical podía ser cualquier
cosa entre una sola nota hasta una enorme expresión compuesta como
@example
@end example
@noindent
-Puesto que todo se encuentra dentro de @code{@{ @dots{} @}}, cuenta como
-una expresión musical.
+Puesto que todo se encuentra dentro de @code{@{ @dots{} @}},
+cuenta como una expresión musical.
-Como vimos anteriormente, el bloque @code{\score} puede contener otras
-cosas, tales como
+Como vimos anteriormente, el bloque @code{\score} puede contener
+otras cosas, tales como
@example
\score @{
@cindex disposición
@noindent
-Observe que estas tres instrucciones (@code{\header}, @code{\layout} y
-@code{\midi}) son especiales: a diferencia del resto de las
-instrucciones que comienzan con una barra invertida (@code{\}),
-@emph{no} son expresiones musicales y no forman parte de ninguna
-expresión musical. Por tanto, se pueden situar dentro de un bloque
-@code{\score} o fuera de él. De hecho, estas instrucciones se sitúan
-por lo general fuera del bloque @code{\score} (por ejemplo,
-@code{\header} se suele colocar antes de la instrucción @code{\score},
-como muestra el ejemplo que aparece al principio de la sección.
-
-Dos instrucciones más que no hemos visto aún son @code{\layout @{ @}}
-y @code{\midi @{ @}}. Si aparecen tal y como se muestran aquí, hacen
-que LilyPond produzca una salida impresa y una salida MIDI,
-respectivamente. Se describen con todo detalle en el manual de
-Referencia de la notación, en @ruser{Disposición de la partitura} y en
-@ruser{Crear archivos MIDI}.
+Observe que estas tres instrucciones (@code{\header},
+@code{\layout} y @code{\midi}) son especiales: a diferencia del
+resto de las instrucciones que comienzan con una barra invertida
+(@code{\}), @emph{no} son expresiones musicales y no forman parte
+de ninguna expresión musical. Por tanto, se pueden situar dentro
+de un bloque @code{\score} o fuera de él. De hecho, estas
+instrucciones se sitúan por lo general fuera del bloque
+@code{\score} (por ejemplo, @code{\header} se suele colocar antes
+de la instrucción @code{\score}, como muestra el ejemplo que
+aparece al principio de la sección.
+
+Dos instrucciones más que no hemos visto aún son @code{\layout @{
+@}} y @code{\midi @{ @}}. Si aparecen tal y como se muestran
+aquí, hacen que LilyPond produzca una salida impresa y una salida
+MIDI, respectivamente. Se describen con todo detalle en el
+manual de Referencia de la notación, en @ruser{Disposición de la
+partitura} y en @ruser{Creación de salida MIDI}.
@cindex partituras, varias
@cindex book, bloque implícito
@funindex book
Podemos escribir varios bloques @code{\score}. Cada uno de ellos
-recibirá el mismo tratamiento que una partitura independiente, pero se
-combinarán todos juntos en un archivo de salida único. No se necesita
-ninguna instrucción @code{\book}, se creará una implícitamente. Sin
-embargo, si quiere archivos de salida separados a partir de un único
-archivo @file{.ly}, entonces es necesario utilizar la instrucción
-@code{\book} para separar las distintas secciones: cada bloque
-@code{\book} produce un archivo de salida distinto.
+recibirá el mismo tratamiento que una partitura independiente,
+pero se combinarán todos juntos en un archivo de salida único.
+No se necesita ninguna instrucción @code{\book}, se creará una
+implícitamente. Sin embargo, si quiere archivos de salida
+separados a partir de un único archivo @file{.ly}, entonces es
+necesario utilizar la instrucción @code{\book} para separar las
+distintas secciones: cada bloque @code{\book} produce un archivo
+de salida distinto.
En resumen:
Cada bloque @code{\book} crea un archivo de salida distinto (por
-ejemplo, un archivo PDF). Si no hemos escrito uno de forma explícita,
-LilyPond envuelve todo nuestro código de entrada dentro de un bloque
-@code{\book} de forma implícita.
+ejemplo, un archivo PDF). Si no hemos escrito uno de forma
+explícita, LilyPond envuelve todo nuestro código de entrada
+dentro de un bloque @code{\book} de forma implícita.
-Cada bloque @code{\score} es un trozo de música separado dentro de un
-bloque @code{\book}.
+Cada bloque @code{\score} es un trozo de música separado dentro
+de un bloque @code{\book}.
@cindex layout, efecto de la situación del bloque
Cada bloque @code{\layout} afecta al bloque @code{\score} o
@code{\book} dentro del cual aparece (es decir, un bloque
-@code{\layout} dentro de un bloque @code{\score} afecta solamente a
-ese bloque @code{\score}, pero un bloque @code{\layout} fuera de un
-bloque @code{\score} (que por ello está dentro de un bloque
-@code{\book}, ya sea explícita o implícitamente) afecta a los bloques
-@code{\score} que están dentro de ese @code{\book}.
+@code{\layout} dentro de un bloque @code{\score} afecta solamente
+a ese bloque @code{\score}, pero un bloque @code{\layout} fuera
+de un bloque @code{\score} (que por ello está dentro de un bloque
+@code{\book}, ya sea explícita o implícitamente) afecta a los
+bloques @code{\score} que están dentro de ese @code{\book}.
-Para ver más detalles, consulte @ruser{Varias partituras en un libro}.
+Para ver más detalles, consulte
+@ruser{Varias partituras en un libro}.
@cindex variables
-Otro magnífico atajo es la posibilidad de definir variables como
-se muestra en @ref{Organizar las piezas mediante variables}. Todas las
-plantillas emplean lo siguiente:
+Otro magnífico atajo es la posibilidad de definir variables como
+se muestra en @ref{Organizar las piezas mediante variables}.
+Todas las plantillas emplean lo siguiente:
@example
melodia = \relative @{
@}
@end example
-Cuando LilyPond examina este archivo, toma el valor de @code{melodia}
-(todo lo que está después del signo igual) y lo inserta dondequiera
-que ve @code{\melodia}. No se requiere un cuidado especial con el
-nombre (puede ser @code{melodia}, @code{global},
-@code{CompasArmadura}, @code{manoderechadelpiano} o
-@code{fulanomengano} o cualquier otro). Recuerde que puede usar casi
-cualquier nombre que se le ocurra, en la medida en que contenga
-solamente caracteres alfabéticos y sea diferente de cualquiera de los
-nombres de instrucción de LilyPond. Para ver más detalles, consulte @ref{Ahorrar
-tecleo mediante variables y funciones}. Las limitaciones exactas que
-afectan a los nombres de variable se detallan en @ruser{Estructura del
-archivo}.
+Cuando LilyPond examina este archivo, toma el valor de
+@code{melodia} (todo lo que está después del signo igual) y lo
+inserta dondequiera que ve @code{\melodia}. No se requiere un
+cuidado especial con el nombre (puede ser @code{melodia},
+@code{global}, @code{CompasArmadura}, @code{manoderechadelpiano}
+o @code{fulanomengano} o cualquier otro). Recuerde que puede
+usar casi cualquier nombre que se le ocurra, en la medida en que
+contenga solamente caracteres alfabéticos y sea diferente de
+cualquiera de los nombres de instrucción de LilyPond. Para ver
+más detalles, consulte
+@ref{Ahorrar tecleo mediante variables y funciones}. Las
+limitaciones exactas que afectan a los nombres de variable se
+detallan en @ruser{Estructura del archivo}.
@seealso
-Para ver una definición completa del formato del código de entrada,
-consulte @ruser{Estructura del archivo}.
+Para ver una definición completa del formato del código de
+entrada, consulte @ruser{Estructura del archivo}.
@node La partitura es una (única) expresión musical compuesta
@funindex \score
@funindex score
-En la sección anterior, @ref{Introducción a la estructura de los
-archivos de LilyPond}, hemos podido ver la organización general de los
-archivos de entrada de LilyPond. Pero parece que nos saltamos la
-parte más importante: ¿cómo averiguamos qué escribir después de
+En la sección anterior,
+@ref{Introducción a la estructura de los archivos de LilyPond},
+hemos podido ver la organización general de los archivos de
+entrada de LilyPond. Pero parece que nos saltamos la parte más
+importante: ¿cómo averiguamos qué escribir después de
@code{\score}?
No nos hemos saltado nada en absoluto. El gran misterio es,
-sencillamente, que no hay @emph{ningún} misterio. La siguiente línea
-lo explica todo:
+sencillamente, que no hay @emph{ningún} misterio. La siguiente
+línea lo explica todo:
@quotation
-@emph{Un bloque @code{\score} debe comenzar con una expresión musical
-compuesta.}
+@emph{Un bloque @code{\score} debe contener exactamente una expresión musical.}
@end quotation
@noindent
-Para comprender lo que se entiende por expresión musical y expresión
-musical compuesta, quizá encuentre útil dar un repaso al tutorial,
-@ref{Explicación de las expresiones musicales}. En esta sección vimos cómo
-elaborar grandes expresiones musicales a partir de pequeñas piezas
-(comenzábamos con notas, luego acordes, etc.). Ahora partiremos de
-una gran expresión musical y recorreremos el camino inverso hacia
-abajo. Por simplicidad, vamos a hacer sólo un cantante y un piano.
-No necesitamos un @code{StaffGroup} (que simplemente agrupa un cierto
-número de pautas con un corchete a la izquierda) para este conjunto,
-así que lo retiramos. Sin embargo, @emph{sí} necesitamos pentagramas
-para un cantante y un piano.
+Para comprender lo que se entiende por expresión musical, quizá
+encuentre útil dar un repaso al tutorial,
+@ref{Explicación de las expresiones musicales}. En esta sección
+vimos cómo elaborar grandes expresiones musicales a partir de
+pequeñas piezas (comenzábamos con notas, luego acordes, etc.).
+Ahora partiremos de una gran expresión musical y recorreremos el
+camino inverso hacia abajo. Por simplicidad, vamos a hacer sólo
+un cantante y un piano. No necesitamos un @code{StaffGroup} (que
+simplemente agrupa un cierto número de pautas con un corchete a
+la izquierda) para este conjunto, así que lo retiramos. Sin
+embargo, @emph{sí} necesitamos pentagramas para un cantante y un
+piano.
@example
\score @{
@end example
Aquí hemos asignado nombres a los pentagramas: @qq{cantante} y
-@qq{piano}. Esto no es esencial en este momento, pero es un hábito
-que resulta útil cultivar de manera que podamos saber de un vistazo
-para qué es cada pentagrama.
-
-Recuerde que utilizamos @code{<< @dots{} >>} en lugar de @code{@{ @dots{} @}}
-para presentar la música simultánea. Esto hace que las partes vocal y
-del piano aparezcan una sobre la otra en la partitura. La
-construcción @code{<< @dots{} >>} no sería necesaria para el pentagrama
-del cantante en el ejemplo de arriba si contiene solamente una
-expresión musical secuencial, pero se necesitarían los @code{<<
-@dots{} >>} en lugar de las llaves si la música de ese pentagrama fuese a
-contener dos o más expresiones simultáneas, p.ej. dos voces
-simultáneas, o una voz con letra. Vamos a tener una voz con letra,
-por lo que se requieren los ángulos dobles. Después añadiremos algo
-de música real; por ahora limitémonos a poner unas cuantas notas y
-texto de relleno. Si ha olvidado cómo añadir la letra, puede releer
-la sección @code{\addlyrics} de @ref{Elaborar canciones sencillas}.
+@qq{piano}. Esto no es esencial en este momento, pero es un
+hábito que resulta útil cultivar de manera que podamos saber de
+un vistazo para qué es cada pentagrama.
+
+Recuerde que utilizamos @code{<< @dots{} >>} en lugar de @code{@{
+@dots{} @}} para presentar la música simultánea. Esto hace que
+las partes vocal y del piano aparezcan una sobre la otra en la
+partitura. La construcción @code{<< @dots{} >>} no sería
+necesaria para el pentagrama del cantante en el ejemplo de arriba
+si contiene solamente una expresión musical secuencial, pero se
+necesitarían los @code{<< @dots{} >>} en lugar de las llaves si
+la música de ese pentagrama fuese a contener dos o más
+expresiones simultáneas, p.ej. dos voces simultáneas, o una voz
+con letra. Vamos a tener una voz con letra, por lo que se
+requieren los ángulos dobles. Después añadiremos algo de música
+real; por ahora limitémonos a poner unas cuantas notas y texto de
+relleno. Si ha olvidado cómo añadir la letra, puede releer la
+sección @code{\addlyrics} de @ref{Elaborar canciones sencillas}.
@lilypond[verbatim,quote,ragged-right]
\score {
}
@end lilypond
-Ahora tenemos muchos más detalles. Tenemos la pauta del cantante:
-contiene una @code{Voice} o voz (en LilyPond, este término hace
-referencia a un conjunto de notas, no necesariamente notas vocales --
-por ejemplo, un violín generalmente toca una voz --) y el texto de la
-canción. También tenemos una pauta de piano: contiene un pentagrama
-superior (mano derecha) y un pentagrama inferior (mano izquierda),
-aunque el pentagrama inferior aún no tiene la clave de Fa.
+Ahora tenemos muchos más detalles. Tenemos la pauta del
+cantante: contiene una @code{Voice} o voz (en LilyPond, este
+término hace referencia a un conjunto de notas, no necesariamente
+notas vocales -- por ejemplo, un violín generalmente toca una voz
+--) y el texto de la canción. También tenemos una pauta de
+piano: contiene un pentagrama superior (mano derecha) y un
+pentagrama inferior (mano izquierda), aunque el pentagrama
+inferior aún no tiene la clave de Fa.
-En este momento podríamos comenzar a meter las notas. Dentro de las
-llaves que siguen a @code{\new Voice = "vocal"}, podríamos empezar
-escribiendo
+En este momento podríamos comenzar a meter las notas. Dentro de
+las llaves que siguen a @code{\new Voice = "vocal"}, podríamos
+empezar escribiendo
@example
\relative @{
@end example
Pero si lo hiciéramos, la sección @code{\score} se haría bastante
-larga y sería más difícil comprender lo que ocurre. En lugar de esto
-utilizaremos identificadores o variables. Recordará que las vimos por
-primera vez en la sección anterior.
+larga y sería más difícil comprender lo que ocurre. En lugar de
+esto utilizaremos identificadores o variables. Recordará que las
+vimos por primera vez en la sección anterior.
-Para asegurarnos de que el contenido de la variable @code{text} se
-interpreta como letra, lo precedemos por @code{\lyricmode}. Como
-@code{\addlyrics}, esto activa el modo de entrada de letra. Sin ello,
-LilyPond trataría de interpretar el contenido como notas, lo que
-generaría errores (Existen algunos otros modos, véase @ruser{Modos de
-entrada}).
+Para asegurarnos de que el contenido de la variable @code{text}
+se interpreta como letra, lo precedemos por @code{\lyricmode}.
+Como @code{\addlyrics}, esto activa el modo de entrada de letra.
+Sin ello, LilyPond trataría de interpretar el contenido como
+notas, lo que generaría errores (Existen algunos otros modos,
+véase @ruser{Modos de entrada}).
-Así pues, escribiendo algunas notas, y una clave de Fa para la mano
-izquierda, ahora tenemos un fragmento musical de verdad:
+Así pues, escribiendo algunas notas, y una clave de Fa para la
+mano izquierda, ahora tenemos un fragmento musical de verdad:
@lilypond[verbatim,quote,ragged-right]
melody = \relative { r4 d''8\noBeam g, c4 r }
}
@end lilypond
-Cuando escriba una sección @code{\score} o cuando la esté leyendo,
-hágalo despacio y con cuidado. Comience por el nivel exterior y luego
-trabaje sobre cada uno de los niveles interiores. También es de gran
-ayuda ser muy estricto con los márgenes (asegúrese de que en su editor
-de texto cada elemento del mismo nivel comienza en la misma posición
-horizontal).
+Cuando escriba una sección @code{\score} o cuando la esté
+leyendo, hágalo despacio y con cuidado. Comience por el nivel
+exterior y luego trabaje sobre cada uno de los niveles
+interiores. También es de gran ayuda ser muy estricto con los
+márgenes (asegúrese de que en su editor de texto cada elemento
+del mismo nivel comienza en la misma posición horizontal).
@seealso
@cindex temporales, pentagramas
@cindex ossias
-No es esencial declarar todos los pentagramas al comienzo; se pueden
-crear temporalmente en cualquier momento. Esto es de especial
-utilidad para crear secciones de ossia (véase @rglos{ossia}). A
-continuación presentamos un ejemplo sencillo que muestra cómo
-introducir temporalmente un pentagrama nuevo mientras dura un
-fragmento de tres notas:
+No es esencial declarar todos los pentagramas al comienzo; se
+pueden crear temporalmente en cualquier momento. Esto es de
+especial utilidad para crear secciones de ossia (véase
+@rglos{ossia}). A continuación presentamos un ejemplo sencillo
+que muestra cómo introducir temporalmente un pentagrama nuevo
+mientras dura un fragmento de tres notas:
@lilypond[verbatim,quote,ragged-right]
\new Staff {
@end lilypond
@noindent
-Advierta que el tamaño de la clave es igual al que se imprime en un
-cambio de clave (ligeramente menor que la clave al principio de una
-línea). Esto es normal para cualquier clave que se imprime en la
-mitad de una línea.
+Advierta que el tamaño de la clave es igual al que se imprime en
+un cambio de clave (ligeramente menor que la clave al principio
+de una línea). Esto es normal para cualquier clave que se
+imprime en la mitad de una línea.
@cindex pentagrama, posicionado del
-La sección ossia se puede colocar encima del pentagrama de la manera
-siguiente:
+La sección ossia se puede colocar encima del pentagrama de la
+manera siguiente:
@lilypond[verbatim,quote,ragged-right]
\new Staff = "main" {
}
@end lilypond
-Este ejemplo utiliza @code{\with}, que se explica en todo detalle más
-adelante. Es un medio de modificar el comportamiento predeterminado
-de un solo pentagrama. Aquí, dice que el pentagrama nuevo se debe
-colocar por encima del pentagrama llamado @qq{main} en vez de la
-posición predeterminada que sería por debajo.
+Este ejemplo utiliza @code{\with}, que se explica en todo detalle
+más adelante. Es un medio de modificar el comportamiento
+predeterminado de un solo pentagrama. Aquí, dice que el
+pentagrama nuevo se debe colocar por encima del pentagrama
+llamado @qq{main} en vez de la posición predeterminada que sería
+por debajo.
@seealso
Los fragmentos de ossia se escriben a menudo sin clave y sin
-indicación de compás, y generalmente en un tipo más pequeño. Esto
-necesitaría más instrucciones que aún no se han visto. Véase
-@ref{Tamaño de los objetos} y @ruser{Pentagramas de Ossia}.
+indicación de compás, y generalmente en un tipo más pequeño.
+Esto necesitaría más instrucciones que aún no se han visto.
+Véase @ref{Tamaño de los objetos} y @ruser{Pentagramas de Ossia}.
@node Acerca de la no anidabilidad de llaves y ligaduras
@cindex paréntesis y corchetes, tipos de
@cindex paréntesis y corchetes, encerrar frente a marcar
-En la escritura del archivo de entrada de LilyPond, hemos podido ver
-algunos tipos de paréntesis, llaves o ángulos de distintos tipos.
-Éstos obedecen a distintas reglas que al principio pueden resultar
-confusas. Antes de explicar estas reglas, demos un repaso a las
-distintas clases de corchetes, llaves y paréntesis.
+En la escritura del archivo de entrada de LilyPond, hemos podido
+ver algunos tipos de paréntesis, llaves o ángulos de distintos
+tipos. Éstos obedecen a distintas reglas que al principio pueden
+resultar confusas. Antes de explicar estas reglas, demos un
+repaso a las distintas clases de corchetes, llaves y paréntesis.
@c attempt to force this onto a new page
@need 50
@end multitable
A las anteriores, debemos añadir otras construcciones que generan
-líneas entre o a través de las notas: las ligaduras de unión (marcadas
-con una tilde curva, @code{~}), los grupos especiales que se escriben
-como @code{\tuplet x/y @{ @dots{} @}}, y las notas de adorno, que se escriben
-como @code{\grace @{ @dots{} @}}.
+líneas entre o a través de las notas: las ligaduras de unión
+(marcadas con una tilde curva, @code{~}), los grupos especiales
+que se escriben como @code{\tuplet x/y @{ @dots{} @}}, y las
+notas de adorno, que se escriben como @code{\grace @{ @dots{}
+@}}.
Fuera de LilyPond, el uso convencional de los paréntesis y otros
corchetes requiere que los distintos tipos se encuentren anidados
-correctamente, como en: @code{<< [ @{ ( @dots{} ) @} ] >>}, de manera que
-los paréntesis que se cierran deben encontrarse en el orden
-exactamente opuesto al de los paréntesis que se abren. Esto
-@strong{es} un requisito para los tres tipos de paréntesis que se
-describen mediante la palabra @q{Encierra} en la tabla anterior: se
-deben anidar correctamente. Sin embargo, el resto de las llaves y
-corchetes, que se encuentran descritos por la palabra @q{Marca} en la
-misma tabla anterior, @strong{no} tienen por qué anidarse
-estrictamente con ninguno de los otros paréntesis. De hecho, éstos no
-son paréntesis en el sentido de que encierran algo: simplemente son
-marcadores que indican dónde empieza o finaliza algo.
+correctamente, como en: @code{<< [ @{ ( @dots{} ) @} ] >>}, de
+manera que los paréntesis que se cierran deben encontrarse en el
+orden exactamente opuesto al de los paréntesis que se abren.
+Esto @strong{es} un requisito para los tres tipos de paréntesis
+que se describen mediante la palabra @q{Encierra} en la tabla
+anterior: se deben anidar correctamente. Sin embargo, el resto
+de las llaves y corchetes, que se encuentran descritos por la
+palabra @q{Marca} en la misma tabla anterior, @strong{no} tienen
+por qué anidarse estrictamente con ninguno de los otros
+paréntesis. De hecho, éstos no son paréntesis en el sentido de
+que encierran algo: simplemente son marcadores que indican dónde
+empieza o finaliza algo.
Así pues, por ejemplo, una ligadura de fraseo puede dar comienzo
-antes de una barra insertada manualmente, y acabar antes de que acabe
-la barra (algo que quizá no sea muy musical, pero es posible):
+antes de una barra insertada manualmente, y acabar antes de que
+acabe la barra (algo que quizá no sea muy musical, pero es
+posible):
@lilypond[quote,verbatim,ragged-right]
\relative { g'8\( a b[ c b\) a] g4 }
@end lilypond
En general, los distintos tipos de corchete, y los implicados en
-grupos especiales, ligaduras de unión y notas de adorno, se pueden
-mezclar con total libertad. Este ejemplo muestra una barra que se
-extiende hacia el interior de un grupo de valoración especial (línea
-1), una ligadura de expresión que se prolonga hasta el interior de un
-grupo especial (línea 2), una barra y una ligadura de expresión que se
-prolongan hasta el interior de un grupo especial, una ligadura de
-unión que atraviesa dos grupos especiales, y una ligadura de fraseo
-que sale del interior de un grupo especial (líneas 3 y 4).
+grupos especiales, ligaduras de unión y notas de adorno, se
+pueden mezclar con total libertad. Este ejemplo muestra una
+barra que se extiende hacia el interior de un grupo de valoración
+especial (línea 1), una ligadura de expresión que se prolonga
+hasta el interior de un grupo especial (línea 2), una barra y una
+ligadura de expresión que se prolongan hasta el interior de un
+grupo especial, una ligadura de unión que atraviesa dos grupos
+especiales, y una ligadura de fraseo que sale del interior de un
+grupo especial (líneas 3 y 4).
@lilypond[quote,verbatim,ragged-right]
\relative {
@translationof Voices contain music
Igual que los cantantes, LilyPond necesita voces para cantar. En
-realidad, la música para cualquier instrumento de una partitura está
-siempre contenida dentro de una voz --el concepto de LilyPond más
-fundamental de todos--.
+realidad, la música para cualquier instrumento de una partitura
+está siempre contenida dentro de una voz --el concepto de
+LilyPond más fundamental de todos--.
@menu
* Oigo voces::
@cindex voces frente a acordes
@cindex acordes frente a voces
-De las capas más profundas de una partitura de LilyPond, las más bajas
-y más fundamentales reciben el nombre de @q{Voice contexts}
-(«contextos de voz») o, abreviadamente, @q{Voices} («voces»). Las
-voces reciben a veces el nombre de @q{layers} («capas») en otros
-programas de edición de partituras.
-
-De hecho, una capa o contexto de voz es la única que puede contener
-música. Si un contexto de voz no se declara explícitamente, se crea
-uno de forma automática, como vimos al comienzo de este capítulo.
-Ciertos instrumentos como el oboe solamente pueden tocar una nota cada
-vez. La música escrita para estos instrumentos
-solamente requiere una voz. Los instrumentos que pueden tocar
-más de una nota a la vez, como el piano, con frecuencia necesitarán
-varias voces para codificar las distintas notas y ritmos concurrentes
-que son capaces de tocar.
+De las capas más profundas de una partitura de LilyPond, las más
+bajas y más fundamentales reciben el nombre de @q{Voice contexts}
+(«contextos de voz») o, abreviadamente, @q{Voices} («voces»).
+Las voces reciben a veces el nombre de @q{layers} («capas») en
+otros programas de edición de partituras.
+
+De hecho, una capa o contexto de voz es la única que puede
+contener música. Si un contexto de voz no se declara
+explícitamente, se crea uno de forma automática, como vimos al
+comienzo de este capítulo. Ciertos instrumentos como el oboe
+solamente pueden tocar una nota cada vez. La música escrita para
+estos instrumentos solamente requiere una voz. Los instrumentos
+que pueden tocar más de una nota a la vez, como el piano, con
+frecuencia necesitarán varias voces para codificar las distintas
+notas y ritmos concurrentes que son capaces de tocar.
Una sola voz puede contener muchas notas dentro de un acorde, por
-supuesto; entonces ¿cuándo, exactamente, se necesitan varias voces?
-En primer lugar observe este ejemplo de cuatro acordes:
+supuesto; entonces ¿cuándo, exactamente, se necesitan varias
+voces? En primer lugar observe este ejemplo de cuatro acordes:
@lilypond[quote,verbatim,ragged-right]
\relative {
}
@end lilypond
-Esto se puede expresar utilizando sólo símbolos de acorde con ángulos
-simples, @code{< @dots{} >}, y para este propósito tan sólo se necesita
-una voz. Pero suponga que el Fa sostenido fuese realmente una corchea
-seguida de un Sol corchea, una nota de paso que conduce al La. Ahora
-tenemos dos notas que empiezan en el mismo momento pero tienen
-distintas duraciones: la negra Re, y la corchea Fa sostenido. ¿Cómo se
-codifica esto? No se pueden escribir como un acorde porque todas las
-notas de un acorde deben tener la misma duración. Y no se pueden
-escribir como dos notas en secuencia porque tienen que empezar en el
-mismo momento. Aquí es donde se necesitan dos voces.
-
-Veamos cómo se hace esto dentro de la sintaxis de entrada de LilyPond.
+Esto se puede expresar utilizando sólo símbolos de acorde con
+ángulos simples, @code{< @dots{} >}, y para este propósito tan
+sólo se necesita una voz. Pero suponga que el Fa sostenido fuese
+realmente una corchea seguida de un Sol corchea, una nota de paso
+que conduce al La. Ahora tenemos dos notas que empiezan en el
+mismo momento pero tienen distintas duraciones: la negra Re, y la
+corchea Fa sostenido. ¿Cómo se codifica esto? No se pueden
+escribir como un acorde porque todas las notas de un acorde deben
+tener la misma duración. Y no se pueden escribir como dos notas
+en secuencia porque tienen que empezar en el mismo momento. Aquí
+es donde se necesitan dos voces.
+
+Veamos cómo se hace esto dentro de la sintaxis de entrada de
+LilyPond.
@funindex << \\ >>
@funindex \\
-La forma más fácil de introducir fragmentos con más de una voz en un
-solo pentagrama es escribir cada voz como una secuencia (con
-@code{@{ @dots{} @}}), y combinarlas simultáneamente con ángulos dobles,
-@code{<< @dots{} >>}. Los fragmentos también se deben separar mediante una
-doble barra invertida, @code{\\}, para situarlos en voces separadas.
-Sin esto, las notas irían a una sola voz, lo que normalmente produce
-errores. Esta técnica se adapta especialmente bien a piezas de música
-que son mayormente homofónicas pero ocasionalmente tienen cortas
-secciones de polifonía.
+La forma más fácil de introducir fragmentos con más de una voz en
+un solo pentagrama es escribir cada voz como una secuencia (con
+@code{@{ @dots{} @}}), y combinarlas simultáneamente con ángulos
+dobles, @code{<< @dots{} >>}. Los fragmentos también se deben
+separar mediante una doble barra invertida, @code{\\}, para
+situarlos en voces separadas. Sin esto, las notas irían a una
+sola voz, lo que normalmente produce errores. Esta técnica se
+adapta especialmente bien a piezas de música que son mayormente
+homofónicas pero ocasionalmente tienen cortas secciones de
+polifonía.
-He aquí cómo dividimos los acordes anteriores en dos voces y añadimos
-la nota de paso y la ligadura:
+He aquí cómo dividimos los acordes anteriores en dos voces y
+añadimos la nota de paso y la ligadura:
@lilypond[quote,verbatim,ragged-right]
\relative {
}
@end lilypond
-No es necesario usar una construcción @code{<< \\ >>} distinta para
-cada compás. Para música que tenga unas pocas notas en cada compás,
-esta disposición podría facilitar la legibilidad del código, pero si
-hay muchas notas en cada compás podría ser mejor dividirlo en dos
-voces separadas, de la siguiente manera:
+No es necesario usar una construcción @code{<< \\ >>} distinta
+para cada compás. Para música que tenga unas pocas notas en cada
+compás, esta disposición podría facilitar la legibilidad del
+código, pero si hay muchas notas en cada compás podría ser mejor
+dividirlo en dos voces separadas, de la siguiente manera:
@lilypond[quote,verbatim,ragged-right]
<<
@cindex voces que cruzan corchetes
@cindex ligaduras que cruzan corchetes
-Este ejemplo tiene sólo dos voces, pero la misma construcción se puede
-usar para codificar tres o más voces mediante la adición de más
-separadores de barra invertida.
+Este ejemplo tiene sólo dos voces, pero la misma construcción se
+puede usar para codificar tres o más voces mediante la adición de
+más separadores de barra invertida.
-Los contextos de voz llevan los nombres de @code{"1"}, @code{"2"},
-etc. Los primeros contextos establecen las voces @emph{externas}, la
-voz aguda del contexto @code{"1"} y la voz grave del contexto
-@code{"2"}. Las voces interiores van en los contextos @code{"3"} y
-@code{"4"}. En cada uno de estos contextos, la dirección vertical de
-las ligaduras, plicas, matices dinámicos, etc., se ajusta de forma
-correcta.
+Los contextos de voz llevan los nombres de @code{"1"},
+@code{"2"}, etc. Los primeros contextos establecen las voces
+@emph{externas}, la voz aguda del contexto @code{"1"} y la voz
+grave del contexto @code{"2"}. Las voces interiores van en los
+contextos @code{"3"} y @code{"4"}. En cada uno de estos
+contextos, la dirección vertical de las ligaduras, plicas,
+matices dinámicos, etc., se ajusta de forma correcta.
@lilypond[quote,verbatim]
\new Staff \relative {
}
@end lilypond
-Todas estas voces están separadas de la voz principal que contiene las
-notas justo por fuera de la construcción @code{<< @dots{} >>}. Le
-llamaremos a esto la @emph{construcción simultánea}. Las ligaduras
-(de prolongación y de expresión) solamente pueden conectar notas que
-estén dentro de la misma voz, luego las ligaduras no pueden entrar o
-salir de una construcción simultánea. A la inversa, las voces
-paralelas de construcciones simultáneas distintas sobre el mismo
-pentagrama, son la misma voz. Otras propiedades relativas a las voces
-también conllevan construcciones simultáneas. A continuación vemos el
-mismo ejemplo, con colores y cabezas distintos para cada voz. Observe
-que los cambios en una voz no afectan a otras voces, pero persisten
-más tarde dentro de la misma voz. Observe también que las notas
-ligadas se pueden dividir entre las mismas voces de dos
-construcciones, como se indica aquí en la voz de triángulos azules.
+Todas estas voces están separadas de la voz principal que
+contiene las notas justo por fuera de la construcción @code{<<
+@dots{} >>}. Le llamaremos a esto la @emph{construcción
+simultánea}. Las ligaduras (de prolongación y de expresión)
+solamente pueden conectar notas que estén dentro de la misma voz,
+luego las ligaduras no pueden entrar o salir de una construcción
+simultánea. A la inversa, las voces paralelas de construcciones
+simultáneas distintas sobre el mismo pentagrama, son la misma
+voz. Otras propiedades relativas a las voces también conllevan
+construcciones simultáneas. A continuación vemos el mismo
+ejemplo, con colores y cabezas distintos para cada voz. Observe
+que los cambios en una voz no afectan a otras voces, pero
+persisten más tarde dentro de la misma voz. Observe también que
+las notas ligadas se pueden dividir entre las mismas voces de dos
+construcciones, como se indica aquí en la voz de triángulos
+azules.
@lilypond[quote,verbatim]
\new Staff \relative {
@funindex \voiceFourStyle
@funindex \voiceNeutralStyle
-Las instrucciones @code{\voiceXXXStyle} están pensadas principalmente
-para usarlas en documentos educativos como este mismo. Modifican el
-color de la cabeza, la plica y las barras, y el estilo de la cabeza,
-de forma que las voces se puedan distinguir fácilmente. La voz uno
-está establecida a rombos rojos, la voz dos a triángulos azules, la
-voz tres a círculos verdes con aspas, y la voz cuatro (que no se
-utiliza aquí) a aspas color magenta. @code{\voiceNeutralStyle} (que
-tampoco se usa aquí) devuelve todo al estilo predeterminado. Veremos
-más adelante cómo el usuario puede crear instrucciones como éstas.
-Véase @ref{Visibilidad y color de los objetos} y
-@ref{Uso de variables para los ajustes de disposición}.
+Las instrucciones @code{\voiceXXXStyle} están pensadas
+principalmente para usarlas en documentos educativos como este
+mismo. Modifican el color de la cabeza, la plica y las barras, y
+el estilo de la cabeza, de forma que las voces se puedan
+distinguir fácilmente. La voz uno está establecida a rombos
+rojos, la voz dos a triángulos azules, la voz tres a círculos
+verdes con aspas, y la voz cuatro (que no se utiliza aquí) a
+aspas color magenta. @code{\voiceNeutralStyle} (que tampoco se
+usa aquí) devuelve todo al estilo predeterminado. Veremos más
+adelante cómo el usuario puede crear instrucciones como éstas.
+Véase @ref{Visibilidad y color de los objetos} y @ref{Uso de
+variables para los ajustes de disposición}.
@cindex polifonía y modo relativo
@cindex relativo, modo, polifonía y
-La polifonía no cambia la relación de las notas dentro de un bloque
-@code{\relative}. La altura de cada nota aún se calcula con
-relación a la nota que le precede inmediatamente, o a la primera nota
-del acorde precedente. Así, en
+La polifonía no cambia la relación de las notas dentro de un
+bloque @code{\relative}. La altura de cada nota aún se calcula
+con relación a la nota que le precede inmediatamente, o a la
+primera nota del acorde precedente. Así, en
@example
\relative c' @{ notaA << < notaB notaC > \\ notaD >> notaE @}
al principio de cada voz:
@example
-\relative c' @{ notaA @dots{} @}
+\relative @{ notaA @dots{} @}
<<
- \relative c'' @{ < notaB notaC > @dots{} @}
+ \relative @{ < notaB notaC > @dots{} @}
\\
- \relative g' @{ notaD @dots{} @}
+ \relative @{ notaD @dots{} @}
>>
-\relative c' @{ notaE @dots{} @}
+\relative @{ notaE @dots{} @}
@end example
-Finalmente, analicemos las voces en una pieza de música más compleja.
-He aquí las notas de los dos primeros compases del segundo de los Dos
-Nocturnos de Chopin, Op 32. Este ejemplo se utilizará en fases
-posteriores dentro del presente capítulo y el siguiente, para ilustrar
-varias técnicas para producir notación, y por tanto le pedimos que
-ignore por ahora cualquier cosa en el código subyacente que le parezca
-misterioso y tan sólo se concentre en la música y las voces (todas
-las complicaciones se explicarán en secciones posteriores).
+Finalmente, analicemos las voces en una pieza de música más
+compleja. He aquí las notas de los dos primeros compases del
+segundo de los Dos Nocturnos de Chopin, Op 32. Este ejemplo se
+utilizará en fases posteriores dentro del presente capítulo y el
+siguiente, para ilustrar varias técnicas para producir notación,
+y por tanto le pedimos que ignore por ahora cualquier cosa en el
+código subyacente que le parezca misterioso y tan sólo se
+concentre en la música y las voces (todas las complicaciones se
+explicarán en secciones posteriores).
@c The following should appear as music without code
@lilypond[quote,ragged-right]
\\ % Voice two
{
% Ignore these for now - they are explained in Ch 4
- \once \override NoteColumn.ignore-collision = ##t
+ \once \override NoteColumn.force-hshift = #0
<ees, c>2
\once \override NoteColumn.force-hshift = #0.5
des2
}
@end lilypond
-Con frecuencia, la dirección de las plicas se utiliza para indicar la
-continuidad de dos líneas melódicas simultáneas. Aquí, todas las
-plicas de las notas agudas se dirigen hacia arriba y las de las notas
-graves hacia abajo. Ésta es la primera indicación de que se requiere
-más de una voz.
-
-Pero la necesidad real de varias voces aflora cuando hay notas que
-comienzan en el mismo tiempo pero tienen distintas duraciones.
-Observe las notas que comienzan en la tercera parte del primer compás.
-El La bemol es una negra con puntillo, el Fa es una negra y el Re
-bemol es una blanca. Estas notas no se pueden escribir como un acorde
-porque todas las notas de un acorde deben tener la misma duración.
-Tampoco se pueden escribir como notas secuenciales, pues deben
-comenzar al mismo tiempo. Esta sección del compás requiere tres
-voces, y la práctica común sería escribir todo el compás como tres
-voces como se muestra abajo, donde hemos usado distintas cabezas y
-colores para las tres voces. Una vez más, el código que subyace a
-este ejemplo se explicará más tarde, así pues ignore todo lo que no
-entienda.
+Con frecuencia, la dirección de las plicas se utiliza para
+indicar la continuidad de dos líneas melódicas simultáneas.
+Aquí, todas las plicas de las notas agudas se dirigen hacia
+arriba y las de las notas graves hacia abajo. Ésta es la primera
+indicación de que se requiere más de una voz.
+
+Pero la necesidad real de varias voces aflora cuando hay notas
+que comienzan en el mismo tiempo pero tienen distintas
+duraciones. Observe las notas que comienzan en la tercera parte
+del primer compás. El La bemol es una negra con puntillo, el Fa
+es una negra y el Re bemol es una blanca. Estas notas no se
+pueden escribir como un acorde porque todas las notas de un
+acorde deben tener la misma duración. Tampoco se pueden escribir
+como notas secuenciales, pues deben comenzar al mismo tiempo.
+Esta sección del compás requiere tres voces, y la práctica común
+sería escribir todo el compás como tres voces como se muestra
+abajo, donde hemos usado distintas cabezas y colores para las
+tres voces. Una vez más, el código que subyace a este ejemplo se
+explicará más tarde, así pues ignore todo lo que no entienda.
@c The following should appear as music without code
@c The three voice styles should be defined in -init
\\ % Voice two
{ \voiceTwoStyle
% Ignore these for now - they are explained in Ch 4
- \once \override NoteColumn.ignore-collision = ##t
+ \once \override NoteColumn.force-hshift = #0
<ees, c>2
\once \override NoteColumn.force-hshift = #0.5
des2
Vamos a intentar codificar esta música partiendo de cero. Como
-veremos, esto se topa con ciertas dificultades. Comenzamos tal y como
-hemos aprendido, usando la construcción @code{<< \\ >>} para
+veremos, esto se topa con ciertas dificultades. Comenzamos tal y
+como hemos aprendido, usando la construcción @code{<< \\ >>} para
introducir la música del primer compás en tres voces:
@lilypond[quote,verbatim,ragged-right]
@cindex plicas, voces y dirección de las
@cindex plica arriba
-Las direcciones de las plicas se asignan automáticamente de forma que
-las voces de numeración impar reciben las plicas hacia arriba y las de
-numeración par hacia abajo. Las plicas de las voces 1 y 2 están
-correctas, pero las plicas de la voz 3 debería ir hacia abajo en este
-fragmento en particular. Podemos corregir esto simplemente
-olvidándonos de la voz tres y situando la música en la voz cuatro.
-Esto se hace escribiendo otro par de barras invertidas (@code{\\}).
+Las direcciones de las plicas se asignan automáticamente de forma
+que las voces de numeración impar reciben las plicas hacia arriba
+y las de numeración par hacia abajo. Las plicas de las voces 1 y
+2 están correctas, pero las plicas de la voz 3 debería ir hacia
+abajo en este fragmento en particular. Podemos corregir esto
+simplemente olvidándonos de la voz tres y situando la música en
+la voz cuatro. Esto se hace escribiendo otro par de barras
+invertidas (@code{\\}).
@lilypond[quote,verbatim,ragged-right]
\new Staff \relative {
@end lilypond
@noindent
-Vemos que esto arregla la dirección de la plica, pero la colocación
-horizontal de las notas no es la deseada. LilyPond desplaza las notas
-interiores cuando ellas o sus plicas de otro modo colisionarían con
-las voces exteriores, pero esto no es lo más adecuado para música de
-piano. En otras situaciones, los desplazamientos que LilyPond aplica
-pueden no eliminar las colisiones. LilyPond aporta varias formas de
-ajustar la colocación horizontal de las notas. Aún no estamos
-preparados para ver cómo se corrige esto, por lo que dejaremos el
-problema para una sección posterior (véase la propiedad
-@code{force-hshift} en @ref{Arreglar notación con superposiciones}).
-
-@warning{No se pueden crear letras ni objetos de extensión
-(como ligaduras, reguladores, etc.) @q{entre} voces distintas.}
+Vemos que esto arregla la dirección de la plica, pero la
+colocación horizontal de las notas no es la deseada. LilyPond
+desplaza las notas interiores cuando ellas o sus plicas de otro
+modo colisionarían con las voces exteriores, pero esto no es lo
+más adecuado para música de piano. En otras situaciones, los
+desplazamientos que LilyPond aplica pueden no eliminar las
+colisiones. LilyPond aporta varias formas de ajustar la
+colocación horizontal de las notas. Aún no estamos preparados
+para ver cómo se corrige esto, por lo que dejaremos el problema
+para una sección posterior (véase la propiedad
+@code{force-hshift} en @ref{Arreglar notación con
+superposiciones}).
+
+@warning{No se pueden crear letras ni objetos de extensión (como
+ligaduras, reguladores, etc.) @q{entre} voces distintas.}
@seealso
Referencia de la notación:
@funindex \new Voice
@cindex contextos de voz, creación de
-Los contextos de voz también se pueden crear manualmente dentro de un
-bloque @code{<< >>} para crear música polifónica, utilizando
-@code{\voiceOne} @dots{} @code{\voiceFour} para indicar las direcciones
-requeridas de plicas, ligaduras, etc. En partituras más largas, este
-método es más claro porque permite que las voces estén separadas y
-reciban nombres más descriptivos.
+Los contextos de voz también se pueden crear manualmente dentro
+de un bloque @code{<< >>} para crear música polifónica,
+utilizando @code{\voiceOne} @dots{} @code{\voiceFour} para
+indicar las direcciones requeridas de plicas, ligaduras, etc. En
+partituras más largas, este método es más claro porque permite
+que las voces estén separadas y reciban nombres más descriptivos.
Concretamente, la construcción @code{<< \\ >>} que usamos en la
sección previa:
Las instrucciones @code{\voiceXXX} establecen la dirección de las
plicas, ligaduras de expresión, ligaduras de prolongación,
articulaciones, anotaciones de texto, puntillos y digitaciones.
-@code{\voiceOne} y @code{\voiceThree} hacen que estos objetos apunten
-hacia arriba, mientras que @code{\voiceTwo} y @code{\voiceFour} los
-hacen apuntar hacia abajo. Estas instrucciones también producen un
-desplazamiento horizontal para cada voz cuando es necesario para
-evitar choques entre las cabezas. La instrucción @code{\oneVoice}
-devuelve los ajustes de nuevo a los valores normales para una sola
-voz.
-
-Veamos en algunos ejemplos sencillos exactamente qué efecto tienen
-@code{\oneVoice}, @code{\voiceOne} y @code{voiceTwo} sobre el marcado,
-las ligaduras de unión y de expresión y las indicaciones de dinámica:
+@code{\voiceOne} y @code{\voiceThree} hacen que estos objetos
+apunten hacia arriba, mientras que @code{\voiceTwo} y
+@code{\voiceFour} los hacen apuntar hacia abajo. Estas
+instrucciones también producen un desplazamiento horizontal para
+cada voz cuando es necesario para evitar choques entre las
+cabezas. La instrucción @code{\oneVoice} devuelve los ajustes de
+nuevo a los valores normales para una sola voz.
+
+Veamos en algunos ejemplos sencillos exactamente qué efecto
+tienen @code{\oneVoice}, @code{\voiceOne} y @code{voiceTwo} sobre
+el marcado, las ligaduras de unión y de expresión y las
+indicaciones de dinámica:
@lilypond[quote,ragged-right,verbatim]
\relative {
}
@end lilypond
-A continuación veremos tres formas distintas de componer la notación
-del mismo pasaje polifónico, cada una de las cuales tiene sus ventajas
-según la circunstancia, utilizando el ejemplo de la sección anterior.
+A continuación veremos tres formas distintas de componer la
+notación del mismo pasaje polifónico, cada una de las cuales
+tiene sus ventajas según la circunstancia, utilizando el ejemplo
+de la sección anterior.
Una expresión que aparece directamente dentro de @code{<< >>}
-pertenece a la voz principal (pero, observe, @strong{no} dentro de una
-construcción @code{<< \\ >>}). Esto es útil cuando aparecen voces
-nuevas mientras la voz principal está sonando. A continuación podemos
-ver una realización más correcta del ejemplo de la sección anterior.
-Las notas rojas en forma de rombo muestran que la melodía principal
-está ahora dentro de un contexto de una sola voz, haciendo que se
-pueda trazar una ligadura por encima de ellas.
+pertenece a la voz principal (pero, observe, @strong{no} dentro
+de una construcción @code{<< \\ >>}). Esto es útil cuando
+aparecen voces nuevas mientras la voz principal está sonando. A
+continuación podemos ver una realización más correcta del ejemplo
+de la sección anterior. Las notas rojas en forma de rombo
+muestran que la melodía principal está ahora dentro de un
+contexto de una sola voz, haciendo que se pueda trazar una
+ligadura por encima de ellas.
@lilypond[quote,ragged-right,verbatim]
\new Staff \relative {
@cindex voces temporales
@cindex voces, anidado de
-Son posibles construcciones polifónicas anidadas más profundamente, y
-si una voz aparece sólo brevemente podría haber una forma más natural
-de tipografiar la música.
+Son posibles construcciones polifónicas anidadas más
+profundamente, y si una voz aparece sólo brevemente podría haber
+una forma más natural de tipografiar la música.
@lilypond[quote,ragged-right,verbatim]
\new Staff \relative {
@cindex espaciadoras, notas
-Este método de anidar voces nuevas brevemente es útil cuando sólo hay
-secciones polifónicas pequeñas, pero cuando todo el pentagrama es muy
-polifónico podría ser más claro usar varias voces todo el tiempo,
-usando notas espaciadoras para pasar por encima de las secciones en
-que una voz está en silencio, como aquí:
+Este método de anidar voces nuevas brevemente es útil cuando sólo
+hay secciones polifónicas pequeñas, pero cuando todo el
+pentagrama es muy polifónico podría ser más claro usar varias
+voces todo el tiempo, usando notas espaciadoras para pasar por
+encima de las secciones en que una voz está en silencio, como
+aquí:
@lilypond[quote,ragged-right,verbatim]
\new Staff \relative <<
@funindex \shiftOnnn
@funindex shiftOnnn
-Las notas cercanas de un acorde, o las notas que se producen al mismo
-tiempo en distintas voces, se disponen en dos (y ocasionalmente más)
-columnas para evitar el solapamiento de las cabezas. Reciben el
-nombre de columnas de notas. Hay columnas distintas para cada voz, y
-el desplazamiento especificado en curso dependiente de la voz se
-aplica a la columna de la nota si en caso contrario se produjese una
-colisión. Esto se puede ver en el ejemplo anterior. En el compás 2 el
-Do en la voz dos está desplazado a la derecha respecto del Re de la
-voz uno, y en el último acorde el Do de la voz tres también está
-desplazado a la derecha respecto de las otras notas.
-
-Las instrucciones @code{\shiftOn}, @code{\shiftOnn}, @code{\shiftOnnn}
-y @code{\shiftOff} especifican el grado en que se deben desplazar las
-notas y acordes de la voz si en caso contrario ocurriese una
-colisión. De forma predeterminada, las voces exteriores (normalmente
-las voces uno y dos) llevan especificado @code{\shiftOff}, mientras
-que las voces interiores (tres y cuatro) tienen @code{\shiftOn}
-especificado. Cuando se aplica un desplazamiento, las voces uno y
-tres se desplazan hacia la derecha y las voces dos y cuatro se
-desplazan hacia la izquierda.
-
-@code{\shiftOnn} y @code{\shiftOnnn} definen niveles adicionales de
-desplazamiento que se pueden especificar temporalmente para resolver
-colisiones en situaciones complejas (véase @ref{Ejemplos reales de música}).
-
-Una columna de notas puede contener sólo una nota (o acorde) de una
-voz con las plicas hacia arriba y una not (o acorde) de una voz con
-las plicas hacia abajo. Si las notas de dos voces que tienen las
-plicas en la misma dirección se sitúan en la misma posición y las dos
-voces no tienen ningún desplazamiento o llevan especificado el mismo
-desplazamiento, se producirá el mensaje de error @qq{Chocan demasiadas
-columnas de notas}.
+Las notas cercanas de un acorde, o las notas que se producen al
+mismo tiempo en distintas voces, se disponen en dos (y
+ocasionalmente más) columnas para evitar el solapamiento de las
+cabezas. Reciben el nombre de columnas de notas. Hay columnas
+distintas para cada voz, y el desplazamiento especificado en
+curso dependiente de la voz se aplica a la columna de la nota si
+en caso contrario se produjese una colisión. Esto se puede ver
+en el ejemplo anterior. En el compás 2 el Do en la voz dos está
+desplazado a la derecha respecto del Re de la voz uno, y en el
+último acorde el Do de la voz tres también está desplazado a la
+derecha respecto de las otras notas.
+
+Las instrucciones @code{\shiftOn}, @code{\shiftOnn},
+@code{\shiftOnnn} y @code{\shiftOff} especifican el grado en que
+se deben desplazar las notas y acordes de la voz si en caso
+contrario ocurriese una colisión. De forma predeterminada, las
+voces exteriores (normalmente las voces uno y dos) llevan
+especificado @code{\shiftOff}, mientras que las voces interiores
+(tres y cuatro) tienen @code{\shiftOn} especificado. Cuando se
+aplica un desplazamiento, las voces uno y tres se desplazan hacia
+la derecha y las voces dos y cuatro se desplazan hacia la
+izquierda.
+
+@code{\shiftOnn} y @code{\shiftOnnn} definen niveles adicionales
+de desplazamiento que se pueden especificar temporalmente para
+resolver colisiones en situaciones complejas (véase
+@ref{Ejemplos reales de música}).
+
+Una columna de notas puede contener sólo una nota (o acorde) de
+una voz con las plicas hacia arriba y una not (o acorde) de una
+voz con las plicas hacia abajo. Si las notas de dos voces que
+tienen las plicas en la misma dirección se sitúan en la misma
+posición y las dos voces no tienen ningún desplazamiento o llevan
+especificado el mismo desplazamiento, se producirá el mensaje de
+error @qq{Esta voz requiere un ajuste de @code{@bs{}voiceXx} o
+@code{@bs{}shiftXx}}.
@seealso
@translationof Voices and vocals
-La música vocal presenta una dificultad especial: tenemos que combinar
-dos expresiones, a saber, las notas y la letra.
+La música vocal presenta una dificultad especial: tenemos que
+combinar dos expresiones, a saber, las notas y la letra.
@funindex \new Lyrics
@funindex \lyricsto
Ya ha visto la instrucción @code{\addlyrics@{@}}, que maneja bien
partituras sencillas. Sin embargo esta técnica es algo limitada.
-Para música de mayor complejidad, tenemos que introducir la letra en
-un contexto @code{Lyrics} utilizando @code{\new Lyrics} y enlazar
-explícitamente la letra y las notas mediante @code{\lyricsto@{@}},
-usando el nombre asignado a la voz.
+Para música de mayor complejidad, tenemos que introducir la letra
+en un contexto @code{Lyrics} utilizando @code{\new Lyrics} y
+enlazar explícitamente la letra y las notas mediante
+@code{\lyricsto@{@}}, usando el nombre asignado a la voz.
@lilypond[quote,verbatim]
<<
>>
@end lilypond
-Observe que la letra se debe enlazar a un contexto de @code{Voice},
-@emph{no} a un contexto de @code{Staff}. Este es un caso en que es
-necesario crear contextos de @code{Staff} y de @code{Voice}
-explícitamente.
+Observe que la letra se debe enlazar a un contexto de
+@code{Voice}, @emph{no} a un contexto de @code{Staff}. Este es
+un caso en que es necesario crear contextos de @code{Staff} y de
+@code{Voice} explícitamente.
@cindex letra y barrado
@cindex barrado y letra
El barrado automático que LilyPond usa de forma predeterminada
funciona bien para la música instrumental, pero no tan bien para
-música con letra, donde o bien el barrado no se necesita en absoluto,
-o bien se utiliza para indicar los melismas de la letra. En el
-ejemplo anterior hemos utilizado la instrucción @code{\autoBeamOff}
-para desactivar el barrado automático.
+música con letra, donde o bien el barrado no se necesita en
+absoluto, o bien se utiliza para indicar los melismas de la
+letra. En el ejemplo anterior hemos utilizado la instrucción
+@code{\autoBeamOff} para desactivar el barrado automático.
@funindex \new ChoirStaff
@funindex ChoirStaff
@cindex vocal, estructura de una partitura
@cindex coro, sistema de
-Ahora vamos a reutilizar el ejemplo anterior de «Judas Macabeo» para
-ilustrar esta técnica más flexible. Primero la reescribiremos para
-que use variables, de manera que la música y la letra se puedan
-separar de la estructura de pentagramas. También introduciremos una
-llave de grupo de ChoirStaff. La letra en sí se debe introducir con
-@code{\lyricmode} para estar seguros de que se interpreta como letra y
-no como música.
+Ahora vamos a reutilizar el ejemplo anterior de «Judas Macabeo»
+para ilustrar esta técnica más flexible. Primero la
+reescribiremos para que use variables, de manera que la música y
+la letra se puedan separar de la estructura de pentagramas.
+También introduciremos una llave de grupo de ChoirStaff. La
+letra en sí se debe introducir con @code{\lyricmode} para estar
+seguros de que se interpreta como letra y no como música.
@lilypond[quote,verbatim]
global = { \key f \major \time 6/8 \partial 8 }
@end lilypond
Ésta es la estructura básica de todas las partituras vocales. Se
-pueden añadir más pentagramas según se necesite, se pueden añadir más
-voces a los pentagramas y más estrofas a la letra, y las variables que
-contienen la música se pueden colocar fácilmente en archivos separados
-cuando se hagan demasiado largos.
+pueden añadir más pentagramas según se necesite, se pueden añadir
+más voces a los pentagramas y más estrofas a la letra, y las
+variables que contienen la música se pueden colocar fácilmente en
+archivos separados cuando se hagan demasiado largos.
@cindex himno, estructura de
@cindex SATB, estructura de
@cindex varias estrofas vocales
@cindex estrofas, varias, vocales
-A continuación podemos ver un ejemplo final de la primera línea de un
-himno con cuatro estrofas, para coro SATB. En este caso la letra de
-las cuatro partes es la misma. Observe cómo utilizamos variables para
-separar la notación musical de la estructura de pentagramas. Observe
-también cómo se utiliza una variable, para la que hemos elegido el
-nombre @q{TimeKey} («compás y tonalidad»), para que contenga varias
-instrucciones que se usarán dentro de los dos pentagramas. En otros
-ejemplos se le suele dar el nombre de @q{global}.
+A continuación podemos ver un ejemplo final de la primera línea
+de un himno con cuatro estrofas, para coro SATB. En este caso la
+letra de las cuatro partes es la misma. Observe cómo utilizamos
+variables para separar la notación musical de la estructura de
+pentagramas. Observe también cómo se utiliza una variable, para
+la que hemos elegido el nombre @q{TimeKey} («compás y
+tonalidad»), para que contenga varias instrucciones que se usarán
+dentro de los dos pentagramas. En otros ejemplos se le suele dar
+el nombre de @q{global}.
@section Contextos y grabadores
@translationof Contexts and engravers
-Los contextos y grabadores se han mencionado de manera informal en
-secciones anteriores; ahora tan sólo vamos a ver estos conceptos con
-más detalle, pues son importantes en el ajuste fino de la salida de
-LilyPond.
+Los contextos y grabadores se han mencionado de manera informal
+en secciones anteriores; ahora tan sólo vamos a ver estos
+conceptos con más detalle, pues son importantes en el ajuste fino
+de la salida de LilyPond.
@menu
* Explicación de los contextos::
@cindex contextos, explicación de los
-Cuando se imprime la música, se tienen que añadir a la salida una gran
-cantidad de elementos notacionales que no aparecen explícitamente en
-el archivo de entrada. Por ejemplo, compare la entrada y la salida
-del siguiente ejemplo:
+Cuando se imprime la música, se tienen que añadir a la salida una
+gran cantidad de elementos notacionales que no aparecen
+explícitamente en el archivo de entrada. Por ejemplo, compare la
+entrada y la salida del siguiente ejemplo:
@lilypond[quote,verbatim]
\relative { cis''4 cis2. | a4 a2. | }
@end lilypond
-La entrada es bastante escueta, pero en la salida se han añadido las
-líneas divisorias, las alteraciones, la clave y la armadura de la
-tonalidad. Cuando LilyPond @emph{interpreta} la entrada, la
-información musical se analiza de izquierda a derecha de igual forma
-que un intérprete lee la partitura. Mientras se lee el código de
-entrada, el programa recuerda dónde están los límites de los compases,
-y qué alturas requieren alteraciones accidentales explícitas. Esta
-información se debe conservar a varios niveles. Por ejemplo, una
-alteración accidental afecta solamente a un pentagrama, mientras que
-una línea divisoria debe estar sincronizada a lo largo de todo el
-sistema.
-
-Dentro de LilyPond, estas reglas y pequeñas porciones de información
-se agrupan en @emph{Contexts}. Ya hemos visto el contexto de voz,
-@code{Voice}. Otros ejemplos de contextos son @code{Staff} (Pauta o
-pentagrama) y @code{Score} (Partitura). Los contextos son
-jerárquicos, de forma que reflejan la naturaleza jerárquica de una
-partitura musical. Por ejemplo: un contexto de @code{Staff} contener
-muchos contextos de @code{Voice}, y un contexto de @code{Score} puede
-contener muchos contextos de @code{Staff}.
+La entrada es bastante escueta, pero en la salida se han añadido
+las líneas divisorias, las alteraciones, la clave y la armadura
+de la tonalidad. Cuando LilyPond @emph{interpreta} la entrada,
+la información musical se analiza de izquierda a derecha de igual
+forma que un intérprete lee la partitura. Mientras se lee el
+código de entrada, el programa recuerda dónde están los límites
+de los compases, y qué alturas requieren alteraciones
+accidentales explícitas. Esta información se debe conservar a
+varios niveles. Por ejemplo, una alteración accidental afecta
+solamente a un pentagrama, mientras que una línea divisoria debe
+estar sincronizada a lo largo de todo el sistema.
+
+Dentro de LilyPond, estas reglas y pequeñas porciones de
+información se agrupan en @emph{Contexts}. Ya hemos visto el
+contexto de voz, @code{Voice}. Otros ejemplos de contextos son
+@code{Staff} (Pauta o pentagrama) y @code{Score} (Partitura).
+Los contextos son jerárquicos, de forma que reflejan la
+naturaleza jerárquica de una partitura musical. Por ejemplo: un
+contexto de @code{Staff} contener muchos contextos de
+@code{Voice}, y un contexto de @code{Score} puede contener muchos
+contextos de @code{Staff}.
@quotation
@sourceimage{context-example,5cm,,}
@end quotation
-Cada contexto asume la responsabilidad de imponer algunas reglas de
-notación, creando ciertos objetos de notación y manteniendo las
-propiedades asociadas. Por ejemplo, el contexto @code{Voice} puede
-introducir una alteración accidental y entonces el contexto
-@code{Staff} mantiene la regla de mostrar o suprimir la alteración
-para el resto del compás.
-
-Otro ejemplo lo constituye el hecho de que la sincronización de las
-líneas divisorias se gestiona dentro del contexto de la partitura,
-@code{Score}, de forma predeterminada. Sin embargo, en algunas
-músicas posiblemente no queramos que las líneas divisorias estén
-sincronizadas (pensemos en una partitura polimétrica en compases de
-4/4 y de 3/4). En tales casos, debemos modificar los ajustes por
-omisión de los contextos @code{Score} y @code{Staff}.
-
-Para partituras muy sencillas, los contextos se crean implícitamente y
-no debemos preocuparnos por ellos. Para piezas mayores, como por
-ejemplo cualquiera que tenga más de un pentagrama, los contextos se
-deben crear explícitamente para asegurarnos de que tendremos la
-cantidad exacta de pentagramas que necesitamos, y que están en el
-orden correcto. Para tipografiar piezas con notación especializada,
-es frecuente la modificación de contextos existentes o incluso definir
-unos completamente nuevos.
-
-
-Además de los contextos @code{Score,} @code{Staff} y @code{Voice}, hay
-contextos que se sitúan entre los niveles de partitura y de pentagrama
-para controlar los grupos de pentagramas, como los contextos
-@code{PianoStaff} y @code{ChoirStaff}. También existen contextos
-alternativos de pentagrama y de voz, y contextos para la letra, la
-percusión, diagramas de trastes, bajo cifrado, etc.
-
-Los nombres de todos los tipos de contextos se componen de una o más
-palabras que comienzan con mayúscula y que están unidas unas a otras
-sin guión ni barra baja, por ejemplo:
+Cada contexto asume la responsabilidad de imponer algunas reglas
+de notación, creando ciertos objetos de notación y manteniendo
+las propiedades asociadas. Por ejemplo, el contexto @code{Voice}
+puede introducir una alteración accidental y entonces el contexto
+@code{Staff} mantiene la regla de mostrar o suprimir la
+alteración para el resto del compás.
+
+Otro ejemplo lo constituye el hecho de que la sincronización de
+las líneas divisorias se gestiona dentro del contexto de la
+partitura, @code{Score}, de forma predeterminada. Sin embargo,
+en algunas músicas posiblemente no queramos que las líneas
+divisorias estén sincronizadas (pensemos en una partitura
+polimétrica en compases de 4/4 y de 3/4). En tales casos,
+debemos modificar los ajustes por omisión de los contextos
+@code{Score} y @code{Staff}.
+
+Para partituras muy sencillas, los contextos se crean
+implícitamente y no debemos preocuparnos por ellos. Para piezas
+mayores, como por ejemplo cualquiera que tenga más de un
+pentagrama, los contextos se deben crear explícitamente para
+asegurarnos de que tendremos la cantidad exacta de pentagramas
+que necesitamos, y que están en el orden correcto. Para
+tipografiar piezas con notación especializada, es frecuente la
+modificación de contextos existentes o incluso definir unos
+completamente nuevos.
+
+Además de los contextos @code{Score,} @code{Staff} y
+@code{Voice}, hay contextos que se sitúan entre los niveles de
+partitura y de pentagrama para controlar los grupos de
+pentagramas, como los contextos @code{PianoStaff} y
+@code{ChoirStaff}. También existen contextos alternativos de
+pentagrama y de voz, y contextos para la letra, la percusión,
+diagramas de trastes, bajo cifrado, etc.
+
+Los nombres de todos los tipos de contextos se componen de una o
+más palabras que comienzan con mayúscula y que están unidas unas
+a otras sin guión ni barra baja, por ejemplo:
@code{GregorianTranscriptionStaff}.
En un archivo de entrada, el bloque de partitura, que se presenta
precedido por la instrucción @code{\score}, contiene una sola
-expresión musical y una definición de salida asociada (bien un bloque
-@code{\layout} o bien un bloque @code{\midi}). El contexto
-@code{Score} se suele dejar que se cree automáticamente cuando
-comienza la interpretación de esa expresión musical.
-
-Para partituras que solamente tienen una voz y un pentagrama, podemos
-también dejar que los contextos @code{Voice} y @code{Staff} se creen
-automáticamente, pero para partituras más complejas es necesario
-crearlos a mano. La instrucción más simple que hace esto es
-@code{\new}. Se antepone a una expresión musical, por ejemplo
+expresión musical y una definición de salida asociada (bien un
+bloque @code{\layout} o bien un bloque @code{\midi}). El
+contexto @code{Score} se suele dejar que se cree automáticamente
+cuando comienza la interpretación de esa expresión musical.
+
+Para partituras que solamente tienen una voz y un pentagrama,
+podemos también dejar que los contextos @code{Voice} y
+@code{Staff} se creen automáticamente, pero para partituras más
+complejas es necesario crearlos a mano. La instrucción más
+simple que hace esto es @code{\new}. Se antepone a una expresión
+musical, por ejemplo
@example
\new @var{tipo} @var{expresión_musical}
@noindent
donde @var{tipo} es el nombre de un contexto (como @code{Staff} o
-@code{Voice}). Esta instrucción crea un contexto nuevo, y comienza a
-interpretar la @var{expresión_musical} que está dentro de ese
-contexto.
+@code{Voice}). Esta instrucción crea un contexto nuevo, y
+comienza a interpretar la @var{expresión_musical} que está dentro
+de ese contexto.
@warning{No se debe usar @bs{}@code{new Score} porque el contexto
-@code{Score} esencial del nivel superior ya se crea automáticamente al
-interpretarse la expresión musical que está dentro del bloque
-@bs{}@code{score}. Los valores predeterminados de propiedades de
-contexto válidos para toda la partitura se pueden cambiar dentro del
-bloque @bs{}@code{layout}. Véase @ref{Modificar las propiedades de
-los contextos}.}
-
-En las secciones anteriores ha podido ver muchos ejemplos prácticos que
-creaban nuevos contextos de @code{Staff} y de @code{Voice}, pero para
-recordarle cómo se emplean estas instrucciones en la práctica, he aquí
-un ejemplo anotado de música real:
+@code{Score} esencial del nivel superior ya se crea
+automáticamente al interpretarse la expresión musical que está
+dentro del bloque @bs{}@code{score}. Los valores predeterminados
+de propiedades de contexto válidos para toda la partitura se
+pueden cambiar dentro del bloque @bs{}@code{layout}. Véase
+@ref{Modificar las propiedades de los contextos}.}
+
+En las secciones anteriores ha podido ver muchos ejemplos
+prácticos que creaban nuevos contextos de @code{Staff} y de
+@code{Voice}, pero para recordarle cómo se emplean estas
+instrucciones en la práctica, he aquí un ejemplo anotado de
+música real:
@lilypond[quote,verbatim,ragged-right]
\score { % start of single compound music expression
(Observe cómo todas las instrucciones que abren un bloque con una
llave curva, @code{@{}, o con ángulos dobles, @code{<<}, están
-sangrados (tienen un margen adicional) con dos espacios adicionales, y
-la llave de cierre correspondiente tiene un margen exactamente igual.
-Aunque no es necesario, la observancia de esta práctica reducirá
-considerablemente el número de errores de @q{paréntesis
-descompensados}, y se recomienda vivamente. Permite apreciar de un
-solo vistazo la estructura de la música, y cualquier paréntesis
-descompensado aparecerá con obviedad. Observe también cómo el
-pentagrama de la MI se crea usando dobles ángulos porque requiere dos
-voces, mientras que el pentagrama de la MD se crea con una expresión
-musical única encerrada entre llaves porque sólo requiere una voz.)
+sangrados (tienen un margen adicional) con dos espacios
+adicionales, y la llave de cierre correspondiente tiene un margen
+exactamente igual. Aunque no es necesario, la observancia de
+esta práctica reducirá considerablemente el número de errores de
+@q{paréntesis descompensados}, y se recomienda vivamente.
+Permite apreciar de un solo vistazo la estructura de la música, y
+cualquier paréntesis descompensado aparecerá con obviedad.
+Observe también cómo el pentagrama de la MI se crea usando dobles
+ángulos porque requiere dos voces, mientras que el pentagrama de
+la MD se crea con una expresión musical única encerrada entre
+llaves porque sólo requiere una voz.)
@cindex contextos, nombrado
@cindex nombrar contextos
La instrucción @code{\new} también puede otorgar un nombre
-identificativo al contexto para distinguirlo de otros contextos del
-mismo tipo:
+identificativo al contexto para distinguirlo de otros contextos
+del mismo tipo:
@example
\new @var{tipo} = @var{identificador} @var{expresión_musical}
@end example
Observe la distinción entre el nombre del tipo de contexto,
-@code{Staff}, @code{Voice}, etc., y el nombre identificativo de una
-instancia en particular de ese tipo, que puede ser cualquier secuencia
-de letras inventada por el usuario. En el nombre identificativo
-también se pueden utilizar dígitos y espacios, pero en este caso aquél
-debe ir entre comillas p.ej. @code{\new Staff = "MiPentagrama 1"
-@var{expresión_musical}}. El nombre identificativo se utiliza para
-referirnos más tarde a esa instancia en particular de un contexto.
-Hemos visto esto en la sección acerca de la letra, en @ref{Voces y música vocal}.
+@code{Staff}, @code{Voice}, etc., y el nombre identificativo de
+una instancia en particular de ese tipo, que puede ser cualquier
+secuencia de letras inventada por el usuario. En el nombre
+identificativo también se pueden utilizar dígitos y espacios,
+pero en este caso aquél debe ir entre comillas p.ej. @code{\new
+Staff = "MiPentagrama 1" @var{expresión_musical}}. El nombre
+identificativo se utiliza para referirnos más tarde a esa
+instancia en particular de un contexto. Hemos visto esto en la
+sección acerca de la letra, en @ref{Voces y música vocal}.
@seealso
@cindex grabadores
-Todas y cada una de las marcas de la salida impresa de una partitura
-hecha con LilyPond está producida por un @code{Engraver} (grabador).
-Así, tenemos un grabador para imprimir pentagramas, otro para imprimir
-las cabezas de las notas, otro para las plicas, otro para las barras,
-etc, etc. ¡En total hay más de 120 grabadores! Afortunadamente, para
-la mayor parte de las partituras no es necesario conocer más que
-algunos, y para partituras sencillas no tenemos que saber nada de
-ninguno de ellos.
-
-Los grabadores residen y operan dentro de Contextos. Los grabadores
-como el grabador de la indicación metronómica,
-@code{Metronome_mark_engraver}, cuya acción y resultado se aplican a
-la partitura como un todo, operan en el contexto del nivel más alto:
-el contexto de partitura @code{Score}.
+Todas y cada una de las marcas de la salida impresa de una
+partitura hecha con LilyPond está producida por un
+@code{Engraver} (grabador). Así, tenemos un grabador para
+imprimir pentagramas, otro para imprimir las cabezas de las
+notas, otro para las plicas, otro para las barras, etc, etc. ¡En
+total hay más de 120 grabadores! Afortunadamente, para la mayor
+parte de las partituras no es necesario conocer más que algunos,
+y para partituras sencillas no tenemos que saber nada de ninguno
+de ellos.
+
+Los grabadores residen y operan dentro de Contextos. Los
+grabadores como el grabador de la indicación metronómica,
+@code{Metronome_mark_engraver}, cuya acción y resultado se
+aplican a la partitura como un todo, operan en el contexto del
+nivel más alto: el contexto de partitura @code{Score}.
El grabador de la clave @code{Clef_engraver} y el de la armadura
-@code{Key_engraver} se encuentran probablemente en todos los contextos
-de pentagrama (@code{Staff}), pues los distintos pentagramas podrían
-requerir diferentes claves y armaduras.
+@code{Key_engraver} se encuentran probablemente en todos los
+contextos de pentagrama (@code{Staff}), pues los distintos
+pentagramas podrían requerir diferentes claves y armaduras.
-El grabador de las cabezas de nota @code{Note_heads_engraver} y el de
-las plicas @code{Stem_engraver} viven en cada uno de los contextos de
-voz @code{Voice}, el contexto de nivel más bajo de todos.
+El grabador de las cabezas de nota @code{Note_heads_engraver} y
+el de las plicas @code{Stem_engraver} viven en cada uno de los
+contextos de voz @code{Voice}, el contexto de nivel más bajo de
+todos.
Cada grabador procesa los objetos particulares asociados con su
-función, y mantiene las propiedades que están relacionadas con dicha
-función. Estas propiedades, como las que están asociadas con los
-contextos, se pueden modificar para cambiar el funcionamiento del
-grabador o el aspecto de esos elementos en la partitura impresa.
-
-Todos los grabadores tienen nombres compuestos de varias palabras que
-describen su función. Sólo está en mayúsculas la inicial de la
-primera palabra, y el resto se le une mediante guiones bajos. Así, el
-grabador @code{Staff_symbol_engraver} es responsable de la creación de
-las líneas del pentagrama, y el @code{Clef_engraver} determina y
-establece la altura o el punto de referencia sobre el pentagrama
-dibujando un símbolo de clave.
+función, y mantiene las propiedades que están relacionadas con
+dicha función. Estas propiedades, como las que están asociadas
+con los contextos, se pueden modificar para cambiar el
+funcionamiento del grabador o el aspecto de esos elementos en la
+partitura impresa.
+
+Todos los grabadores tienen nombres compuestos de varias palabras
+que describen su función. Sólo está en mayúsculas la inicial de
+la primera palabra, y el resto se le une mediante guiones bajos.
+Así, el grabador @code{Staff_symbol_engraver} es responsable de
+la creación de las líneas del pentagrama, y el
+@code{Clef_engraver} determina y establece la altura o el punto
+de referencia sobre el pentagrama dibujando un símbolo de clave.
A continuación presentamos algunos de los grabadores más comunes,
-junto a su función. Podrá comprobar que es fácil adivinar la función
-a partir del nombre (en inglés), y viceversa.
+junto a su función. Podrá comprobar que es fácil adivinar la
+función a partir del nombre (en inglés), y viceversa.
@multitable @columnfractions .3 .7
@headitem Grabador
@funindex \unset
@funindex unset
-Los contextos se responsabilizan de mantener los valores de un cierto
-número de @emph{properties} de contexto. Muchas de ellas se pueden
-cambiar para influir en la interpretación del código de entrada y
-cambiar así la apariencia de la salida impresa. Se modifican mediante
-la instrucción @code{\set}. Esta instrucción toma la forma siguiente:
+Los contextos se responsabilizan de mantener los valores de un
+cierto número de @emph{properties} de contexto. Muchas de ellas
+se pueden cambiar para influir en la interpretación del código de
+entrada y cambiar así la apariencia de la salida impresa. Se
+modifican mediante la instrucción @code{\set}. Esta instrucción
+toma la forma siguiente:
@example
\set @emph{NombreDelContexto}.@emph{nombreDeLaPropiedad} = #@emph{valor}
@end example
Donde el @emph{NombreDelContexto} es normalmente @code{Score},
-@code{Staff} o @code{Voice}. Se puede omitir, en cuyo caso se supone
-que es el contexto en curso (normalmente @code{Voice}).
+@code{Staff} o @code{Voice}. Se puede omitir, en cuyo caso se
+supone que es el contexto en curso (normalmente @code{Voice}).
Los nombres de las propiedades de contexto consisten en palabras
unidas sin ningún guión o barra baja, y donde todas las palabras
-excepto la primera empiezan en mayúscula. A continuación podemos ver
-algunos ejemplos de nombres de propiedades utilizadas con frecuencia.
-Hay muchas más que las que se muestran aquí.
+excepto la primera empiezan en mayúscula. A continuación podemos
+ver algunos ejemplos de nombres de propiedades utilizadas con
+frecuencia. Hay muchas más que las que se muestran aquí.
@c attempt to force this onto a new page
@need 50
@noindent
donde un valor Booleano es verdadero (@code{#t}, True) o falso
-(@code{#f}, False), un Entero es un número entero positivo, un número
-Real es un número decimal positivo o negativo, y el texto se encierra
-entre comillas dobles. Observe la aparición de signos de cuadradillo,
-(@code{#}), en dos lugares diferentes: como parte del valor Booleano
-antes de la @code{t} o la @code{f}, y antes del @emph{valor} dentro de
-la sentencia @code{\set}. Así pues, cuando se está escribiendo un
-valor Booleano, hay que escribir dos signos de cuadradillo, por
-ejemplo: @code{##t}.
+(@code{#f}, False), un Entero es un número entero positivo, un
+número Real es un número decimal positivo o negativo, y el texto
+se encierra entre comillas dobles. Observe la aparición de
+signos de cuadradillo, (@code{#}), en dos lugares diferentes:
+como parte del valor Booleano antes de la @code{t} o la @code{f},
+y antes del @emph{valor} dentro de la sentencia @code{\set}. Así
+pues, cuando se está escribiendo un valor Booleano, hay que
+escribir dos signos de cuadradillo, por ejemplo: @code{##t}.
@cindex propiedades que funcionan en contextos
@cindex establecer propiedades en contextos
-Antes de poder establecer cualquiera de estas propiedades, tenemos que
-saber en qué contexto operan. A veces es algo obvio, pero en
-ocasiones puede ser algo enrevesado. Si especificamos un contexto
-equivocado, no se produce ningún mensaje de error, pero el
-funcionamiento esperado no tendrá lugar. Por ejemplo, la propiedad
-@code{instrumentName} (nombre del instrumento) vive claramente dentro
-del contexto de @code{Staff}, puesto que es el pentagrama el que debe
-ser nombrado. En este ejemplo, el primer pentagrama resulta
-etiquetado, pero no el segundo, porque hemos omitido el nombre del
-contexto.
+Antes de poder establecer cualquiera de estas propiedades,
+tenemos que saber en qué contexto operan. A veces es algo obvio,
+pero en ocasiones puede ser algo enrevesado. Si especificamos un
+contexto equivocado, no se produce ningún mensaje de error, pero
+el funcionamiento esperado no tendrá lugar. Por ejemplo, la
+propiedad @code{instrumentName} (nombre del instrumento) vive
+claramente dentro del contexto de @code{Staff}, puesto que es el
+pentagrama el que debe ser nombrado. En este ejemplo, el primer
+pentagrama resulta etiquetado, pero no el segundo, porque hemos
+omitido el nombre del contexto.
@lilypond[quote,verbatim,ragged-right]
<<
>>
@end lilypond
-Recuerde que el nombre del contexto predeterminado es @code{Voice},
-así que la segunda instrucción @code{\set} establece la propiedad
-@code{instrumentName} del contexto @code{Voice} a @qq{Alto}, pero como
-LilyPond no busca esta propiedad en el contexto @code{Voice}, no se
-realiza ninguna acción. Esto no es un error, y no se registra ningún
-mensaje en el archivo Log de registro de errores.
-
-De forma parecida, si el nombre de la propiedad se escribe con alguna
-falta, no se produce ningún mensaje de error, y claramente la acción
-esperada no puede tener lugar. De hecho, se puede establecer
-cualquier @q{property} (ficticia) usando cualquier nombre que queramos
-en cualquier contexto que exista, mediante el uso de la instrucción
-@code{\set}. Pero si el nombre no es conocido para LilyPond, no
-producirá ninguna acción. Algunos editores de texto que apoyan a los
-archivos de entrada de LilyPond de manera especial, documentan los
-nombres de propiedades con viñetas cuando pasamos sobre ellos con el
-puntero del ratón, como JEdit con la extensión LilyPondTool, o
-resaltan los nombres de propiedades desconocidas de manera diferente,
-como ConTEXT. Si no se utiliza un editor con tales posibilidades, se
-recomienda comprobar la corrección del nombre de la propiedad en el
-manual de Referencia de funcionamiento interno: véase
+Recuerde que el nombre del contexto predeterminado es
+@code{Voice}, así que la segunda instrucción @code{\set}
+establece la propiedad @code{instrumentName} del contexto
+@code{Voice} a @qq{Alto}, pero como LilyPond no busca esta
+propiedad en el contexto @code{Voice}, no se realiza ninguna
+acción. Esto no es un error, y no se registra ningún mensaje en
+el archivo Log de registro de errores.
+
+De forma parecida, si el nombre de la propiedad se escribe con
+alguna falta, no se produce ningún mensaje de error, y claramente
+la acción esperada no puede tener lugar. De hecho, se puede
+establecer cualquier @q{property} (ficticia) usando cualquier
+nombre que queramos en cualquier contexto que exista, mediante el
+uso de la instrucción @code{\set}. Pero si el nombre no es
+conocido para LilyPond, no producirá ninguna acción. Algunos
+editores de texto que apoyan a los archivos de entrada de
+LilyPond de manera especial, documentan los nombres de
+propiedades con viñetas cuando pasamos sobre ellos con el puntero
+del ratón, como JEdit con la extensión LilyPondTool, o resaltan
+los nombres de propiedades desconocidas de manera diferente, como
+ConTEXT. Si no se utiliza un editor con tales posibilidades, se
+recomienda comprobar la corrección del nombre de la propiedad en
+el manual de Referencia de funcionamiento interno: véase
@rinternals{Tunable context properties} o @rinternals{Contexts}.
La propiedad @code{instrumentName} tendrá efecto solamente si se
-establece dentro del contexto @code{Staff}, pero algunas propiedades
-se pueden establecer en más de un contexto. Por ejemplo, la propiedad
-@code{extraNatural} está establecida por defecto al valor @code{##t}
-(verdadero) para todos los pentagramas. Si se establece a @code{##f}
-(falso) en un contexto de @code{Staff} determinado, se aplicará
-solamente a las alteraciones de ese pentagrama. Si se establece a
-falso en el contexto de la partitura, @code{Score}, se aplicará a
-todos los pentagramas.
+establece dentro del contexto @code{Staff}, pero algunas
+propiedades se pueden establecer en más de un contexto. Por
+ejemplo, la propiedad @code{extraNatural} está establecida por
+defecto al valor @code{##t} (verdadero) para todos los
+pentagramas. Si se establece a @code{##f} (falso) en un contexto
+de @code{Staff} determinado, se aplicará solamente a las
+alteraciones de ese pentagrama. Si se establece a falso en el
+contexto de la partitura, @code{Score}, se aplicará a todos los
+pentagramas.
Así, esto desactivará los becuadros adicionales en un pentagrama:
>>
@end lilypond
-Como un ejemplo más, si se establece @code{clefTransposition} dentro del
-contexto de @code{Score}, éste cambia inmediatamente el valor de la
-transposición en todos los pentagramas en curso y establece un nuevo
-valor predeterminado que se aplicará a todos los pentagramas.
+Como un ejemplo más, si se establece @code{clefTransposition}
+dentro del contexto de @code{Score}, éste cambia inmediatamente
+el valor de la transposición en todos los pentagramas en curso y
+establece un nuevo valor predeterminado que se aplicará a todos
+los pentagramas.
-La instrucción opuesta, @code{\unset}, tiene el efecto de suprimir la
-propiedad del contexto, lo que ocasiona que la mayoría de las
-propiedades vuelvan a su valor predeterminado. Normalmente no es
-necesario el uso de @code{\unset}, pues una nueva instrucción
-@code{\set} hará el ajuste deseado.
+La instrucción opuesta, @code{\unset}, tiene el efecto de
+suprimir la propiedad del contexto, lo que ocasiona que la
+mayoría de las propiedades vuelvan a su valor predeterminado.
+Normalmente no es necesario el uso de @code{\unset}, pues una
+nueva instrucción @code{\set} hará el ajuste deseado.
Las instrucciones @code{\set} y @code{\unset} pueden aparecer en
-cualquier lugar del archivo de entrada y tendrán efecto a partir del
-tiempo en que se encuentran y hasta el final de la partitura o hasta
-que la propiedad se establezca de nuevo mediante @code{\set} o
-@code{\unset}. Probemos a modificar el tamaño de la fuente
-tipográfica, lo que afecta al tamaño de las cabezas de las notas
-(entre otras cosas) varias veces. El cambio se toma a partir del
-valor predeterminado, no el valor en curso.
+cualquier lugar del archivo de entrada y tendrán efecto a partir
+del tiempo en que se encuentran y hasta el final de la partitura
+o hasta que la propiedad se establezca de nuevo mediante
+@code{\set} o @code{\unset}. Probemos a modificar el tamaño de
+la fuente tipográfica, lo que afecta al tamaño de las cabezas de
+las notas (entre otras cosas) varias veces. El cambio se toma a
+partir del valor predeterminado, no el valor en curso.
@lilypond[quote,verbatim,ragged-right]
\relative {
@end lilypond
Hemos podido ver cómo establecer los valores de diversos tipos de
-propiedad diferentes. Observe que los números enteros y reales van
-siempre precedidos de un símbolo de cuadradillo, @code{#}, mientras
-que un valor booleano verdadero o falso se especifica mediante
-@code{##t} y @code{##f}, con dos cuadradillos. Una propiedad de texto
-se debe encerrar entre comillas dobles, como antes, aunque veremos más
-adelante que el texto realmente se puede especificar de una forma
-mucho más general utilizando la potentísima instrucción @code{markup}.
+propiedad diferentes. Observe que los números enteros y reales
+van siempre precedidos de un símbolo de cuadradillo, @code{#},
+mientras que un valor booleano verdadero o falso se especifica
+mediante @code{##t} y @code{##f}, con dos cuadradillos. Una
+propiedad de texto se debe encerrar entre comillas dobles, como
+antes, aunque veremos más adelante que el texto realmente se
+puede especificar de una forma mucho más general utilizando la
+potentísima instrucción @code{markup}.
@subsubheading Cambiar las propiedades de un contexto con @code{\with}
@funindex with
@cindex contexto, propiedades de, establecimiento con \with
-El valor predeterminado de las propiedades de contexto se puede establecer en el momento
-en que se crea el contexto. A veces esta forma de establecer el valor
-de una propiedad es mucho más clara, si ha de quedar fijo durante todo
-el tiempo que dure el contexto. Cuando se crea un contexto con una
-instrucción @code{\new} puede ir inmediatamente seguido de un bloque
-@code{\with @{ @dots{} @}} en el que se establecen los valores predeterminados de las
-propiedades. Por ejemplo, si queremos suprimir la impresión de
-becuadros adicionales para toda la duración de un pentagrama, podemos
-escribir:
+El valor predeterminado de las propiedades de contexto se puede
+establecer en el momento en que se crea el contexto. A veces
+esta forma de establecer el valor de una propiedad es mucho más
+clara, si ha de quedar fijo durante todo el tiempo que dure el
+contexto. Cuando se crea un contexto con una instrucción
+@code{\new} puede ir inmediatamente seguido de un bloque
+@code{\with @{ @dots{} @}} en el que se establecen los valores
+predeterminados de las propiedades. Por ejemplo, si queremos
+suprimir la impresión de becuadros adicionales para toda la
+duración de un pentagrama, podemos escribir:
@example
\new Staff \with @{ extraNatural = ##f @}
Las propiedades ajustadas de esta manera aún pueden cambiarse
dinámicamente utilizando @code{\set} y ser devueltas al valor
-predeterminados que se estableció en el bloque @code{\with} mediante
-@code{\unset}.
+predeterminados que se estableció en el bloque @code{\with}
+mediante @code{\unset}.
@cindex fontSize (tamaño de la tipografía)
@cindex fuente, tamaño de la
Así pues, si la propiedad @code{fontSize} se ajusta dentro de una
cláusula @code{\with}, tiene el efecto de reiniciar el valor
-predeterminado del tamaño de la fuente tipográfica. Si más tarde se
-modifica con @code{\set}, este nuevo valor predeterminado puede
-restablecerse con la instrucción @code{\unset fontSize}.
+predeterminado del tamaño de la fuente tipográfica. Si más tarde
+se modifica con @code{\set}, este nuevo valor predeterminado
+puede restablecerse con la instrucción @code{\unset fontSize}.
@subsubheading Cambiar las propiedades de un contexto con @code{\context}
@funindex \context
@funindex context
-Los valores de propiedad de los contextos se pueden establecer para
-@emph{todos} los contextos de un tipo determinado, como por ejemplo
-todos los contextos de @code{Staff}, con una única instrucción. El
-tipo de contexto se identifica mediante la utilización del nombre de
-su tipo, como @code{Staff}, precedido de una barra invertida:
-@code{\Staff}. El enunciado que establece el valor de la propiedad es
-el mismo que el que está en un bloque @code{\with}, presentado
-anteriormente. Se coloca en un bloque @code{\context} dentro de un
-bloque @code{\layout}. Cada bloque @code{\context} afecta a todos los
-contextos del tipo especificado a lo largo del bloque @code{\score} o
-@code{\book} en el que aparece el bloque @code{\layout}. A
-continuación presentamos un ejemplo que muestra el formato:
+Los valores de propiedad de los contextos se pueden establecer
+para @emph{todos} los contextos de un tipo determinado, como por
+ejemplo todos los contextos de @code{Staff}, con una única
+instrucción. El tipo de contexto se identifica mediante la
+utilización del nombre de su tipo, como @code{Staff}, precedido
+de una barra invertida: @code{\Staff}. El enunciado que
+establece el valor de la propiedad es el mismo que el que está en
+un bloque @code{\with}, presentado anteriormente. Se coloca en
+un bloque @code{\context} dentro de un bloque @code{\layout}.
+Cada bloque @code{\context} afecta a todos los contextos del tipo
+especificado a lo largo del bloque @code{\score} o @code{\book}
+en el que aparece el bloque @code{\layout}. A continuación
+presentamos un ejemplo que muestra el formato:
@lilypond[verbatim,quote]
\score {
@noindent
Las propiedades de contexto establecidas de esta forma se pueden
sobreescribir para ejemplares concretos de contextos mediante
-enunciados dentro de un bloque @code{\with}, y mediante instrucciones
-@code{\set} intercaladas dentro de enunciados musicales.
+enunciados dentro de un bloque @code{\with}, y mediante
+instrucciones @code{\set} intercaladas dentro de enunciados
+musicales.
@seealso
@funindex \remove
@funindex remove
-Hemos visto que cada uno de los contextos contiene varios grabadores,
-cada uno de los cuales a su vez es responsable de la producción de una
-fracción particular del resultado impreso, como líneas divisorias,
-pentagramas, cabezas, plicas, etc. Si un grabador es eliminado de un
-contexto, ya no podrá producir su salida impresa. Es una forma algo
-radical de modificar la salida, pero a veces puede ser útil.
+Hemos visto que cada uno de los contextos contiene varios
+grabadores, cada uno de los cuales a su vez es responsable de la
+producción de una fracción particular del resultado impreso, como
+líneas divisorias, pentagramas, cabezas, plicas, etc. Si un
+grabador es eliminado de un contexto, ya no podrá producir su
+salida impresa. Es una forma algo radical de modificar la
+salida, pero a veces puede ser útil.
@subsubheading Cambiar un solo contexto
-Para eliminar un grabador de un contexto único, usamos la instrucción
-@code{\with} situada inmediatamente después de la instrucción que crea
-el contexto, como en la sección anterior.
+Para eliminar un grabador de un contexto único, usamos la
+instrucción @code{\with} situada inmediatamente después de la
+instrucción que crea el contexto, como en la sección anterior.
-Como ilustración, repitamos un ejemplo extraído de la sección anterior
-con las líneas del pentagrama eliminadas. Recuerde que las líneas del
-pentagrama están dibujadas por el grabador
+Como ilustración, repitamos un ejemplo extraído de la sección
+anterior con las líneas del pentagrama eliminadas. Recuerde que
+las líneas del pentagrama están dibujadas por el grabador
@code{Staff_symbol_engraver}.
@lilypond[quote,verbatim,ragged-right]
@cindex ámbito, grabador del
-Los grabadores también se pueden añadir a los contextos individuales
-La instrucción que lo hace es
+Los grabadores también se pueden añadir a los contextos
+individuales La instrucción que lo hace es
@code{\consists @var{Nombre_del_grabador}},
-situada dentro de un bloque @code{\with}. Ciertas partituras vocales
-tienen una indicación de ámbito o tesitura situada al principio del
-pentagrama para indicar el ámbito de notas en dicho pentagrama, véase
-@rglos{ambitus}. El ambitus se produce por parte del grabador
-@code{Ambitus_engraver}, que normalmente no está incluido en ningún
-contexto. Si lo añadimos al contexto @code{Voice}, calcula el rango a
-partir de esa única voz:
+situada dentro de un bloque @code{\with}. Ciertas partituras
+vocales tienen una indicación de ámbito o tesitura situada al
+principio del pentagrama para indicar el ámbito de notas en dicho
+pentagrama, véase @rglos{ambitus}. El ambitus se produce por
+parte del grabador @code{Ambitus_engraver}, que normalmente no
+está incluido en ningún contexto. Si lo añadimos al contexto
+@code{Voice}, calcula el rango a partir de esa única voz:
@lilypond[quote,verbatim,ragged-right]
\new Staff <<
@end lilypond
@noindent
-pero si añadimos el grabador de ámbito al contexto de @code{Staff},
-calcula el rango de todas las notas en todas las voces de ese
-pentagrama:
+pero si añadimos el grabador de ámbito al contexto de
+@code{Staff}, calcula el rango de todas las notas en todas las
+voces de ese pentagrama:
@lilypond[quote,verbatim,ragged-right]
\new Staff \with {
@funindex layout
Los ejemplos anteriores muestran la manera de eliminar o añadir
-grabadores a los contextos individuales. También es posible eliminar
-o añadir grabadores a todos los contextos de un tipo específico,
-situando las instrucciones en el contexto correspondiente dentro de un
-bloque @code{\layout}. Por ejemplo, si queremos mostrar los rangos de
-tesitura para todos los pentagramas de una partitura de cuatro pautas,
-podemos escribir
+grabadores a los contextos individuales. También es posible
+eliminar o añadir grabadores a todos los contextos de un tipo
+específico, situando las instrucciones en el contexto
+correspondiente dentro de un bloque @code{\layout}. Por ejemplo,
+si queremos mostrar los rangos de tesitura para todos los
+pentagramas de una partitura de cuatro pautas, podemos escribir
@lilypond[quote,verbatim,ragged-right]
\score {
@noindent
Los valores predeterminados de las propiedades de los contextos
-también se pueden establecer para todos los contextos de un tipo en
-particular incluyendo la instrucción @code{\set} dentro de un bloque
-@code{\context} de la misma forma.
+también se pueden establecer para todos los contextos de un tipo
+en particular incluyendo la instrucción @code{\set} dentro de un
+bloque @code{\context} de la misma forma.
@seealso
@ruser{Cambiar los valores por omisión de los contextos}.
@knownissues
-Los grabadores @code{Stem_engraver} y @code{Beam_engraver}
-(de plica y de barra) adjuntan a la cabeza de las notas
-los objetos que crean. Si se suprime el grabador de cabezas de nota
-@code{Note_heads_engraver}, no se produce ninguna cabeza y por tanto
-no se crean tampoco plicas ni barras.
+Los grabadores @code{Stem_engraver} y @code{Beam_engraver} (de
+plica y de barra) adjuntan a la cabeza de las notas los objetos
+que crean. Si se suprime el grabador de cabezas de nota
+@code{Note_heads_engraver}, no se produce ninguna cabeza y por
+tanto no se crean tampoco plicas ni barras.
@node Extender las plantillas
@section Extender las plantillas
@translationof Extending the templates
-Ha leído el tutorial y ahora sabe escribir música. Pero ¿cómo puede
-poner los pentagramas que quiere? Las plantillas están muy bien, pero
-¿qué ocurre si quiere algo que no está en una de ellas? Bien, puede
-encontrar montañas de plantillas (véase @ref{Plantillas}) que le pueden
-servir como punto de partida. Pero ¿y si quiere algo que no está
-contemplado aquí? Continúe leyendo.
+Ha leído el tutorial y ahora sabe escribir música. Pero ¿cómo
+puede poner los pentagramas que quiere? Las plantillas están muy
+bien, pero ¿qué ocurre si quiere algo que no está en una de
+ellas? Bien, puede encontrar montañas de plantillas (véase
+@ref{Plantillas}) que le pueden servir como punto de partida.
+Pero ¿y si quiere algo que no está contemplado aquí? Continúe
+leyendo.
@menu
@cindex plantilla, modificar
@cindex modificar plantillas
-Para empezar, tome la plantilla que le parezca más parecida a aquello
-que quiere conseguir. Digamos que quiere escribir algo para soprano y
-cello. En este caso comenzaríamos con la plantilla @q{Notas y letra}
-(para la parte de soprano).
+Para empezar, tome la plantilla que le parezca más parecida a
+aquello que quiere conseguir. Digamos que quiere escribir algo
+para soprano y cello. En este caso comenzaríamos con la
+plantilla @q{Notas y letra} (para la parte de soprano).
@example
\version @w{"@version{}"}
@}
@end example
-Ahora queremos añadir una parte de violoncello. Veamos el ejemplo
-@q{Sólo notas}:
+Ahora queremos añadir una parte de violoncello. Veamos el
+ejemplo @q{Sólo notas}:
@example
\version @w{"@version{}"}
@}
@end example
-No necesitamos dos instrucciones @code{\version}. Vamos a necesitar
-la sección @code{melodia}. No queremos dos secciones @code{\score}
-(si tuviésemos dos @code{\score}s, acabaríamos con las dos particellas
-por separado. Queremos las dos juntas, como un dúo. Dentro de la
-sección @code{\score}, no nos hacen falta dos @code{\layout} ni dos
-@code{\midi}.
+No necesitamos dos instrucciones @code{\version}. Vamos a
+necesitar la sección @code{melodia}. No queremos dos secciones
+@code{\score} (si tuviésemos dos @code{\score}s, acabaríamos con
+las dos particellas por separado. Queremos las dos juntas, como
+un dúo. Dentro de la sección @code{\score}, no nos hacen falta
+dos @code{\layout} ni dos @code{\midi}.
Si nos limitásemos a copiar y pegar la sección @code{melodia},
-acabaríamos con dos secciones @code{melodia} separadas, así que vamos
-a cambiarles el nombre. Llamaremos @code{musicaSoprano} a la sección
-de la soprano y @code{musicaCello} a la sección del violoncello. Al
-mismo tiempo cambiaremos el nombre de @code{texto} a
-@code{letraSoprano}. Recuerde cambiar el nombre a las dos apariciones
-de todos estos nombres -- tanto la definición inicial (la parte
-@code{melodia = relative c' @{ }) -- como el uso de ese nombre (en la
-sección @code{\score}).
+acabaríamos con dos secciones @code{melodia} separadas, así que
+vamos a cambiarles el nombre. Llamaremos @code{musicaSoprano} a
+la sección de la soprano y @code{musicaCello} a la sección del
+violoncello. Al mismo tiempo cambiaremos el nombre de
+@code{texto} a @code{letraSoprano}. Recuerde cambiar el nombre a
+las dos apariciones de todos estos nombres -- tanto la definición
+inicial (la parte @code{melodia = \relative @{ }) -- como el uso
+de ese nombre (en la sección @code{\score}).
También aprovecharemos para cambiar el pentagrama de la parte del
cello (los violoncellos se escriben normalmente en clave de Fa).
@}
@end example
-Esto tiene una apariencia prometedora, pero la parte del cello no sale
-en la partitura (no la hemos puesto en la sección @code{\score}). Si
-queremos que la parte del cello aparezca debajo de la de soprano,
-tenemos que añadir
+Esto tiene una apariencia prometedora, pero la parte del cello no
+sale en la partitura (no la hemos puesto en la sección
+@code{\score}). Si queremos que la parte del cello aparezca
+debajo de la de soprano, tenemos que añadir
@example
\new Staff \musicaCello
@noindent
justo debajo de todo lo de la soprano. También tenemos que poner
-@code{<<} y @code{>>} antes y después de la música -- lo que indica a
-LilyPond que hay más de una cosa (en este caso, @code{Staff})
-sucediendo al mismo tiempo --. La @code{\score} se parecerá ahora a
-esto:
+@code{<<} y @code{>>} antes y después de la música -- lo que
+indica a LilyPond que hay más de una cosa (en este caso,
+@code{Staff}) sucediendo al mismo tiempo --. La @code{\score} se
+parecerá ahora a esto:
@c Indentation in this example is deliberately poor
@example
@end example
@noindent
-Esto parece un poco enrevesado; los márgenes están descuadrados. Esto
-tiene fácil solución. Presentamos aquí la plantilla completa para
-soprano y cello.
+Lo anterior parece un poco enrevesado; los márgenes están
+descuadrados. Esto tiene fácil solución. Presentamos aquí la
+plantilla completa para soprano y cello.
@lilypond[quote,verbatim,ragged-right,addversion]
sopranoMusic = \relative {
@subsection Partitura vocal a cuatro voces SATB
@translationof Four-part SATB vocal score
-La mayor parte de las partituras vocales escritas para coro mixto a
-cuatro voces con acompañamiento orquestal, como el «Elías» de
+La mayor parte de las partituras vocales escritas para coro mixto
+a cuatro voces con acompañamiento orquestal, como el «Elías» de
Mendelssohn o el «Mesías» de Haendel, tienen la música coral y la
-letra en cuatro pentagramas para S, A, T y B, respectivamente, con una
-reducción de piano del acompañamiento de orquesta, por debajo. He aquí
-un ejemplo del «Mesías» de Haendel:
+letra en cuatro pentagramas para S, A, T y B, respectivamente,
+con una reducción de piano del acompañamiento de orquesta, por
+debajo. He aquí un ejemplo del «Mesías» de Haendel:
@c The following should appear as music without code
@lilypond[quote,ragged-right]
}
@end lilypond
-Ninguna de las plantillas proporciona esta disposición con exactitud.
-La más parecida es @ref{Partitura vocal SATB y reducción para piano automática},
-pero necesitamos cambiar la
-disposición y añadir un acompañamiento de piano que no esté derivado
-automáticamente de las partes vocales. Las variables que contienen la
-música y la letra de las partes vocales es adecuada, pero tendremos
-que añadir variables para la reducción de piano.
+@warning{Esta disposición se puede conseguir muy fácilmente
+usando la plantilla incorporada: @code{satb.ly}, véase
+@ref{Plantillas incorporadas}. Pero para mayor facilidad de uso,
+esta plantilla oculta deliberadamente la necesaria estructura de
+contexto, proporcionándola automáticamente en vez de ello. Así
+pues, para nuestro objetivo de aprendizaje, veamos cómo construir
+la estructura partiendo de cero. Quizá necesite hacerlo cada vez
+que la plantilla incorporada no cumpla sus necesidades
+completamente.}
+
+La plantilla (no incorporada: de copiar y editar) más parecida a
+esta disposición es
+@ref{Partitura vocal SATB y reducción para piano automática},
+pero necesitamos cambiar la disposición y añadir un
+acompañamiento de piano que no esté derivado automáticamente de
+las partes vocales. Las variables que contienen la música y la
+letra de las partes vocales es adecuada, pero tendremos que
+añadir variables para la reducción de piano.
El orden en que aparecen los contextos en el ChoirStaff de la
-plantilla no se corresponde con el orden de la partitura vocal que
-hemos mostrado más arriba. Tenemos que reordenarlas para que haya
-cuatro pentagramas con la letra escrita directamente bajo las notas de
-cada parte. Todas las voces deben ser @code{\voiceOne}, que es la
-predeterminada, para que las instrucciones @code{\voiceXXX} se puedan
-eliminar. También tenemos que especificar la clave de tenor (clave de
-sol octava baja) en las partes de tenor. Aún no hemos encontrado la
-forma en que la letra se especifica en la plantilla, así que tenemos
-que utilizar el método que nos resulta familiar. También tenemos que
-escribir los nombres de cada pentagrama.
+plantilla no se corresponde con el orden de la partitura vocal
+que hemos mostrado más arriba. Tenemos que reordenarlas para que
+haya cuatro pentagramas con la letra escrita directamente bajo
+las notas de cada parte. Todas las voces deben ser
+@code{\voiceOne}, que es la predeterminada, para que las
+instrucciones @code{\voiceXXX} se puedan eliminar. También
+tenemos que especificar la clave de tenor (clave de sol octava
+baja) en las partes de tenor. Aún no hemos encontrado la forma
+en que la letra se especifica en la plantilla, así que tenemos
+que utilizar el método que nos resulta familiar. También tenemos
+que escribir los nombres de cada pentagrama.
Al hacerlo así obtenemos el ChoirStaff siguiente:
>> % fin del ChoirStaff
@end example
-A continuación debemos trabajar sobre la parte de piano. Es fácil:
-tan sólo hay que sacar la parte de piano de la plantilla de @q{Piano
-solista}:
+A continuación debemos trabajar sobre la parte de piano. Es
+fácil: tan sólo hay que sacar la parte de piano de la plantilla
+de @q{Piano solista}:
@example
\new PianoStaff <<
>>
@end example
-Al combinar todo esto junto y escribir la música de los tres compases
-del ejemplo anterior, obtenemos:
+Al combinar todo esto junto y escribir la música de los tres
+compases del ejemplo anterior, obtenemos:
@lilypond[quote,verbatim,ragged-right,addversion]
global = { \key d \major \time 4/4 }
@cindex partitura, ejemplo de escritura
Después de adquirir algo de soltura en la escritura del código de
-LilyPond, se dará cuenta de que es más fácil construir completamente
-una partitura partiendo de cero, que modificar una plantilla. También
-puede desarrollar su propio estilo de forma que se adapte al tipo de
-música que le apetezca. Veamos a continuación cómo confeccionar una
-partitura para un preludio de órgano, como ejemplo.
-
-Comenzamos con una sección para el encabezamiento. Aquí es donde van
-el título, nombre del compositor, etc., después van las definiciones
-de las variables, y finalmente el bloque de partitura. Comencemos a
-verlas por encima y más tarde completaremos los detalles.
-
-Utilizaremos los dos primeros compases del preludio de Bach basado en
-@emph{Jesu, meine Freude}, que está escrito para órgano con dos
-manuales y pedal. Tiene estos dos compases de música al final de la
-sección. La parte del manual superior tiene dos voces, y el inferior
-y el pedal, una voz cada uno. Así pues, necesitamos cuatro
-definiciones para la música y una más para definir el compás y la
-tonalidad:
+LilyPond, se dará cuenta de que es más fácil construir
+completamente una partitura partiendo de cero, que modificar una
+plantilla. También puede desarrollar su propio estilo de forma
+que se adapte al tipo de música que le apetezca. Veamos a
+continuación cómo confeccionar una partitura para un preludio de
+órgano, como ejemplo.
+
+Comenzamos con una sección para el encabezamiento. Aquí es donde
+van el título, nombre del compositor, etc., después van las
+definiciones de las variables, y finalmente el bloque de
+partitura. Comencemos a verlas por encima y más tarde
+completaremos los detalles.
+
+Utilizaremos los dos primeros compases del preludio de Bach
+basado en @emph{Jesu, meine Freude}, que está escrito para órgano
+con dos manuales y pedal. Tiene estos dos compases de música al
+final de la sección. La parte del manual superior tiene dos
+voces, y el inferior y el pedal, una voz cada uno. Así pues,
+necesitamos cuatro definiciones para la música y una más para
+definir el compás y la tonalidad:
@example
\version @w{"@version{}"}
@}
@end example
-Por el momento hemos escrito tan sólo una nota espaciadora, @code{s1},
-en lugar de la música de verdad. La añadiremos más adelante.
+Por el momento hemos escrito tan sólo una nota espaciadora,
+@code{s1}, en lugar de la música de verdad. La añadiremos más
+adelante.
A continuación veamos qué va en el bloque de partitura.
-Sencillamente, reflejaremos la estructura de pentagramas que deseemos.
-La música de órgano se escribe por lo general en tres pentagramas, uno
-para cada uno de los manuales y otro para el pedal. Los pentagramas
-de los manuales se abarcan con una llave, así que los incluiremos en
-un grupo PianoStaff. La primera parte de manual tiene dos voces, y la
-segunda sólo una.
+Sencillamente, reflejaremos la estructura de pentagramas que
+deseemos. La música de órgano se escribe por lo general en tres
+pentagramas, uno para cada uno de los manuales y otro para el
+pedal. Los pentagramas de los manuales se abarcan con una llave,
+así que los incluiremos en un grupo PianoStaff. La primera parte
+de manual tiene dos voces, y la segunda sólo una.
@example
\new PianoStaff <<
>> % fin del contexto de PianoStaff
@end example
-Después, tenemos que añadir un pentagrama para el órgano de pedal.
-Esto va por debajo del PianoStaff, pero debe ser simultáneo con él,
-por lo que escribimos dobles ángulos rodeando a los dos. Si esto se
-nos olvida, se producirá un error en el archivo log de registro. ¡Es
-un error muy común que cometerá antes o después! Intente copiar el
-ejemplo final que aparece al final de la sección, borre los dobles
-ángulos y procese el archivo para ver qué error produce.
+Después, tenemos que añadir un pentagrama para el órgano de
+pedal. Esto va por debajo del PianoStaff, pero debe ser
+simultáneo con él, por lo que escribimos dobles ángulos rodeando
+a los dos. Si esto se nos olvida, se producirá un error en el
+archivo log de registro. ¡Es un error muy común que cometerá
+antes o después! Intente copiar el ejemplo final que aparece al
+final de la sección, borre los dobles ángulos y procese el
+archivo para ver qué error produce.
@example
<< % el grupo PianoStaff y el pentagrama de Pedal son simultáneos
>>
@end example
-No es necesario utilizar la construcción simultánea @code{<< @dots{} >>} para
-el pentagrama del manual dos y el pentagrama del órgano de pedal, ya
-que contienen una única expresión, pero no hace daño, y es una buena
-costumbre utilizar siempre dobles ángulos después de @code{\new Staff}
-cuando hay varias voces. Lo opuesto es cierto para las voces:
-normalmente deben ir seguidas de llaves @code{@{ @dots{} @}} en caso de que
-tengamos música codificada como distintas variables que se deben
-situar consecutivamente.
+No es necesario utilizar la construcción simultánea @code{<<
+@dots{} >>} para el pentagrama del manual dos y el pentagrama del
+órgano de pedal, ya que contienen una única expresión, pero no
+hace daño, y es una buena costumbre utilizar siempre dobles
+ángulos después de @code{\new Staff} cuando hay varias voces. Lo
+opuesto es cierto para las voces: normalmente deben ir seguidas
+de llaves @code{@{ @dots{} @}} en caso de que tengamos música
+codificada como distintas variables que se deben situar
+consecutivamente.
Añadamos esta estructura al bloque de partitura, y ajustemos el
sangrado de los márgenes. También escribimos las claves
correspondientes, nos aseguramos de que las plicas y ligaduras de
-unión y de expresión en cada una de las voces del pentagrama superior
-apuntan en la dirección adecuada con @code{\voiceOne} y
-@code{\voiceTwo} y escribimos el compás y la tonalidad en cada uno de
-los pentagramas usando nuestra variable previamente definida
-@code{\TimeKey}.
+unión y de expresión en cada una de las voces del pentagrama
+superior apuntan en la dirección adecuada con @code{\voiceOne} y
+@code{\voiceTwo} y escribimos el compás y la tonalidad en cada
+uno de los pentagramas usando nuestra variable previamente
+definida @code{\TimeKey}.
@example
\score @{
@cindex ampliabilidad de las pautas
@cindex pautas, ampliabilidad
-La disposición anterior de los pentagramas de órgano es casi perfecta;
-sin embargo, existe un ligero defecto que no es visible cuando se
-observa un solo sistema: la distancia entre el pentagrama de pedal y
-el de la mano izquierda debiera ser aproximadamente la misma que la
-que existe entre los pentagramas de las manos izquierda y derecha.
-Concretamente, la ampliabilidad de los pentagramas dentro de un
-contexto @code{PianoStaff} es limitada (de forma que la distancia
-entre los pentagramas de las manos izquierda y derecha nunca crezcan
-excesivamente), y el pentagrama de los pedales debería comportarse de
-una forma similar.
+La disposición anterior de los pentagramas de órgano es casi
+perfecta; sin embargo, existe un ligero defecto que no es visible
+cuando se observa un solo sistema: la distancia entre el
+pentagrama de pedal y el de la mano izquierda debiera ser
+aproximadamente la misma que la que existe entre los pentagramas
+de las manos izquierda y derecha. Concretamente, la
+ampliabilidad de los pentagramas dentro de un contexto
+@code{PianoStaff} es limitada (de forma que la distancia entre
+los pentagramas de las manos izquierda y derecha nunca crezcan
+excesivamente), y el pentagrama de los pedales debería
+comportarse de una forma similar.
@cindex sub-propiedades
@cindex propiedades, sub-propiedades
@cindex gráficos, objetos
@cindex grobs
-El grado de ampliabilidad o separabilidad de los pentagramas se puede
-controlar con la propiedad @code{staff-staff-spacing} del @q{objeto
-gráfico} @code{VerticalAxisGroup} (los objetos gráficos reciben por lo
-general el nombre de @q{grob}s en la documentación de lilypond); no se
-preocupe por el momento de los detalles, pues esto se explica más
-tarde de forma exhaustiva. Los más curiosos pueden echar un vistazo a
-@ruser{Panorámica de la modificación de las propiedades}. En este
-caso, queremos modificar solamente la sub-propiedad
-@code{stretchability}.
-De nuevo, los curiosos encontrarán los valores
-predeterminados para la propiedad staff-staff-spacing
-en el archivo @file{scm/define-grobs.scm}
-examinando la definición del grob @code{VerticalAxisGroup} grob. El
-valor de @code{stretchability} se toma de la definición del contexto
-@code{PianoStaff} (en el archivo @file{ly/engraver-init.ly}) de
-forma que los valores sean idénticos.
+El grado de ampliabilidad o separabilidad de los pentagramas se
+puede controlar con la propiedad @code{staff-staff-spacing} del
+@q{objeto gráfico} @code{VerticalAxisGroup} (los objetos gráficos
+reciben por lo general el nombre de @q{grob}s en la documentación
+de lilypond); no se preocupe por el momento de los detalles, pues
+esto se explica más tarde de forma exhaustiva. Los más curiosos
+pueden echar un vistazo a @ruser{Panorámica de la modificación de
+las propiedades}. En este caso, queremos modificar solamente la
+sub-propiedad @code{stretchability}. De nuevo, los curiosos
+encontrarán los valores predeterminados para la propiedad
+staff-staff-spacing en el archivo @file{scm/define-grobs.scm}
+examinando la definición del grob @code{VerticalAxisGroup} grob.
+El valor de @code{stretchability} se toma de la definición del
+contexto @code{PianoStaff} (en el archivo
+@file{ly/engraver-init.ly}) de forma que los valores sean
+idénticos.
@example
\score @{
@} % fin del contexto Score
@end example
-Con esto se completa la estructura. Toda música para órgano de tres
-pentagramas tendrá una estructura similar, aunque el número de voces
-puede variar. Todo lo que nos queda es añadir la música, y combinar
-todas las partes.
+Con esto se completa la estructura. Toda música para órgano de
+tres pentagramas tendrá una estructura similar, aunque el número
+de voces puede variar. Todo lo que nos queda es añadir la
+música, y combinar todas las partes.
@lilypond[quote,verbatim,ragged-right,addversion]
\header {
}
@end lilypond
-Sin embargo también puede usar estos identificadores (que también se
-conocen como variables, macros o instrucciones definidas por el
-usuario) para hacer trucos:
+Sin embargo también puede usar estos identificadores (que también
+se conocen como variables, macros o instrucciones definidas por
+el usuario) para hacer trucos:
-@c TODO Avoid padtext - not needed with skylining
@lilypond[quote,verbatim,ragged-right]
dolce = \markup { \italic \bold dolce }
-padText = { \once \override TextScript.padding = #5.0 }
+centreText = { \once \override TextScript.self-alignment-X = #CENTER }
+
fthenp =_\markup {
\dynamic f \italic \small { 2nd } \hspace #0.1 \dynamic p
}
violin = \relative {
\repeat volta 2 {
c''4._\dolce b8 a8 g a b |
- \padText
- c4.^"hi there!" d8 e' f g d |
- c,4.\fthenp b8 c4 c-. |
+ \centreText
+ c4.^"hi there!" d8 e f g d |
+ c4.\fthenp b8 c4 c-. |
}
}
{
\violin
}
- \layout { ragged-right = ##t }
}
@end lilypond
-Obviamente estos identificadores son útiles para ahorrar tecleo. Pero
-son dignos de tener en cuenta incluso si se van a utilizar una sola
-vez: reducen la complejidad. Examinemos el ejemplo anterior reescrito
-sin ningún identificador. Encontrará que es mucho más difícil de
-leer, sobre todo la última línea.
+Obviamente estos identificadores son útiles para ahorrar tecleo.
+Pero son dignos de tener en cuenta incluso si se van a utilizar
+una sola vez: reducen la complejidad. Examinemos el ejemplo
+anterior reescrito sin ningún identificador. Encontrará que es
+mucho más difícil de leer, sobre todo la última línea.
@example
violin = \relative @{
\repeat volta 2 @{
c''4._\markup @{ \italic \bold dolce @} b8 a8 g a b |
- \once \override TextScript.padding = #5.0
- c4.^"hi there!" d8 e' f g d |
- c,4.\markup @{
+ \once \override TextScript.self-alignment-X = #CENTER
+ c4.^"hi there!" d8 e f g d |
+ c4._\markup @{
\dynamic f \italic \small @{ 2nd @} \hspace #0.1 \dynamic p
@}
b8 c4 c-. |
@}
@end example
-@c TODO Replace the following with a better example -td
-@c Skylining handles this correctly without padText
+Hasta ahora hemos contemplado la sustitución estática: cuando
+LilyPond se encuentra con @code{\centreText}, lo sustituye con
+aquello que hemos definido que sea (es decir, todo lo que está a
+la derecha de @code{centreText=}).
-Hasta ahora hemos contemplado la sustitución estática: cuando LilyPond
-se encuentra con @code{\padText}, lo sustituye con aquello que
-hemos definido que sea (es decir, todo lo que está a la derecha de
-@code{padtext=}).
-
-LilyPond también puede manejar sustituciones no estáticas (piense en
-ellas como en funciones).
+LilyPond también puede manejar sustituciones no estáticas (piense
+en ellas como en funciones).
@lilypond[quote,verbatim,ragged-right]
padText =
#})
\relative {
- c'''4^"piu mosso" b a b |
+ c''4^"piu mosso" b a b
\padText #1.8
- c4^"piu mosso" d e f |
+ c4^"piu mosso" b a b
\padText #2.6
- c4^"piu mosso" fis a g |
+ c4^"piu mosso" b a b
}
@end lilypond
La utilización de identificadores también es una buena forma de
-reducir el trabajo si la sintaxis de entrada de LilyPond cambia (véase
-@rprogram{Actualizar ficheros con convert-ly}). Si tiene una sola
-definición (como p.ej. @code{\dolce}) para todos sus archivos (ver
-@ref{Hojas de estilo}), y después la sintaxis se modifica, sólo tendrá
-que actualizar su definición @code{\dolce} única, en lugar de tener
-que hacer cambios en cada uno de los archivos @file{.ly}.
-
+reducir el trabajo si la sintaxis de entrada de LilyPond cambia
+(véase @rprogram{Actualizar ficheros con convert-ly}). Si tiene
+una sola definición (como p.ej. @code{\dolce}) para todos sus
+archivos (ver @ref{Hojas de estilo}), y después la sintaxis se
+modifica, sólo tendrá que actualizar su definición @code{\dolce}
+única, en lugar de tener que hacer cambios en cada uno de los
+archivos @file{.ly}.
@node Partituras y particellas
@subsection Partituras y particellas
@translationof Scores and parts
-En música orquestal, todas las notas se imprimen dos veces. Una vez
-en las particellas para los músicos, y otra para la partitura del
-director. Los identificadores se pueden usar para evitar la
-duplicación del trabajo. La música se escribe una vez y se almacena
-en una variable. El contenido de dicha variable se usa después para
-generar tanto la particella como la partitura del director.
+En música orquestal, todas las notas se imprimen dos veces. Una
+vez en las particellas para los músicos, y otra para la partitura
+del director. Los identificadores se pueden usar para evitar la
+duplicación del trabajo. La música se escribe una vez y se
+almacena en una variable. El contenido de dicha variable se usa
+después para generar tanto la particella como la partitura del
+director.
Es muy conveniente definir las notas en un archivo especial. Por
ejemplo, supongamos que el archivo @file{trompa.ly} contiene la
@end example
@noindent
-Luego se hace una particella escribiendo en un archivo lo siguiente
+Luego se hace una particella escribiendo en un archivo lo
+siguiente
@example
\include "trompa.ly"
@end example
@noindent
-sustituye el contenido de @file{trompa.ly} en esta posición dentro del
-archivo, así que @code{notasTrompa} se define con posterioridad. La
-instrucción @code{\transpose f@tie{}c'} indica que el argumento
-constituido por @code{\notasTrompa} se debe transponer una quinta
-hacia arriba. Lo que suena como @code{f} se escribe como @code{c'},
-lo que corresponde con el tono de afinación de una trompa normal
-en@tie{}Fa. La transposición se puede ver en la siguiente salida
+sustituye el contenido de @file{trompa.ly} en esta posición
+dentro del archivo, así que @code{notasTrompa} se define con
+posterioridad. La instrucción @code{\transpose f@tie{}c'} indica
+que el argumento constituido por @code{\notasTrompa} se debe
+transponer una quinta hacia arriba. Lo que suena como @code{f}
+se escribe como @code{c'}, lo que corresponde con el tono de
+afinación de una trompa normal en@tie{}Fa. La transposición se
+puede ver en la siguiente salida
@lilypond[quote,ragged-right]
\transpose f c' \relative {
durante muchos compases. Esto queda denotado por un silencio
especial, el silencio multicompás. Se introduce con una @code{R}
mayúscula seguida de una duración (@code{1}@tie{}en el caso de la
-redonda, @code{2}@tie{}en el caso de una blanca, etc.). Multiplicando
-la duración se pueden construir silencios más largos. Por ejemplo,
-este silencio ocupa 3@tie{}compases de 2/4
+redonda, @code{2}@tie{}en el caso de una blanca, etc.).
+Multiplicando la duración se pueden construir silencios más
+largos. Por ejemplo, este silencio ocupa 3@tie{}compases de 2/4
@example
R2*3
@end example
Cuando se imprime la particella tienen que comprimirse los silencios
-multicompás. Esto se hace estableciendo una variable en tiempo de
-ejecución
+multicompás. Existe una función musical para hacerlo:
@example
-\set Score.skipBars = ##t
+\compressMMRests @{ ... @}
@end example
-@noindent
-Esta instrucción establece el valor de la propiedad @code{skipBars} en
-el contexto de @code{Score} a verdadero (@code{##t}). Anteponiendo el
-silencio y esta opción a la música anterior, llegamos al siguiente
-resultado
+Applying this to @code{hornNotes} gives:
@lilypond[quote,ragged-right]
-\transpose f c' \relative {
+\compressMMRests \transpose f c' \relative {
\time 2/4
- \set Score.skipBars = ##t
R2*3 |
r4 f8 a | cis4 f | e4 d |
}
@end lilypond
-
-Esta partitura se hace combinando toda la música junta. Suponiendo
-que la otra voz se encuentra dentro de @code{notasFagot} en el archivo
-@file{fagot.ly}, la partitura se hace con
+Esta partitura se hace combinando toda la música junta.
+Suponiendo que la otra voz se encuentra dentro de
+@code{notasFagot} en el archivo @file{fagot.ly}, la partitura se
+hace con
@example
\include "fagot.ly"
>>
@end lilypond
+@seealso
+Manual de aprendizaje:
+@ref{Organizar las piezas mediante variables}.
+Referencia de la notación:
+@ruser{Transposición},
+@ruser{Escritura de las particellas},
+@ruser{Silencios de compás completo},
+@ruser{Inclusión de archivos de LilyPond}.
\input texinfo @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
@ignore
- Translation of GIT committish: 00cd4ff0b8dc4978344ba966bec06ddbc445f7e9
+ Translation of GIT committish: 47db9a3883d726ca53e2133a3b2298f78dd6a32e
When revising a translation, copy the HEAD committish of the
version that you are working on. For details, see the Contributors'
@rlearningnamed{Top, Manual de aprendizaje}.
@end macro
-@c `Notation Reference' was born 1999-10-11 with git commit 940dda0...
+@c `Notation Reference' was born 1998-08-14 with this commit:
+@c release: 1.0.2
+@c author: Han-Wen Nienhuys
+@c commit: a3a44f9f3c581b6824b3a65f9039656693e09bbf
+@c file: Documentation/tex/refman.yo
+
@macro copyrightDeclare
Copyright @copyright{} 1999--2015 por los autores.
@end macro
@translationof LilyPond command index
Este índice relaciona todas las instrucciones y palabras clave de
-LilyPond, con enlaces a aquellas secciones del manual que describen o
-se ocupan de su uso. Cada uno de los enlaces consta de dos partes.
-La primera parte apunta a la situación exacta del manual en que
-aparece la instrucción o palabra clave; la segunda parte apunta al
-comienzo de la sección correspondiente del manual en la que aparece la
-instrucción o palabra clave.
+LilyPond, con enlaces a aquellas secciones del manual que
+describen o se ocupan de su uso. Cada uno de los enlaces consta
+de dos partes. La primera parte apunta a la situación exacta del
+manual en que aparece la instrucción o palabra clave; la segunda
+parte apunta al comienzo de la sección correspondiente del manual
+en la que aparece la instrucción o palabra clave.
@printindex ky
@appendix Índice de LilyPond
@translationof LilyPond index
-Además de todas las instrucciones y palabras clave de LilyPond, este
-índice es una lista de términos musicales y las palabras que tienen
-relación con cada uno de ellos, con enlaces a aquellas secciones del
-manual que describen o se ocupan de dicho término. Cada uno de los
-enlaces consta de dos partes. La primera parte apunta a la situación
-exacta del manual en que aparece el término; la segunda parte apunta
-al comienzo de la sección correspondiente del manual en la que se
-discute dicho término.
+Además de todas las instrucciones y palabras clave de LilyPond,
+este índice es una lista de términos musicales y las palabras que
+tienen relación con cada uno de ellos, con enlaces a aquellas
+secciones del manual que describen o se ocupan de dicho término.
+Cada uno de los enlaces consta de dos partes. La primera parte
+apunta a la situación exacta del manual en que aparece el término;
+la segunda parte apunta al comienzo de la sección correspondiente
+del manual en la que se discute dicho término.
@printindex cp
@c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
@ignore
-Translation of GIT committish: a43fe59b0205af99f84532935b103d0c064b4526
+Translation of GIT committish: 28add695953862ef4a87f9fbeadd1d02dc299244
When revising a translation, copy the HEAD committish of the
version that you are working on. For details, see the Contributors'
@chapter Cambiar los valores por omisión
@translationof Changing defaults
-El objetivo del diseño de LilyPond es proporcionar la más alta calidad
-de los resultados, de forma predeterminada. A pesar de ello, podría
-tener que cambiar este resultado predeterminado. La disposición sobre
-el papel se controla a través de un amplio número de @q{botones e
-interruptores} llamados en su conjunto @q{propiedades}. En el Manual
-de aprendizaje podemos encontrar una introducción en forma de tutorial
-al acceso y modificación de estas propiedades, véase
-@rlearning{Trucar la salida}. Éste debería leerse en primer lugar.
-Este capítulo cubre un terreno similar, pero con un estilo más
-adecuado para un manual de referencia.
+El objetivo del diseño de LilyPond es proporcionar la más alta
+calidad de los resultados, de forma predeterminada. A pesar de
+ello, podría tener que cambiar este resultado predeterminado. La
+disposición sobre el papel se controla a través de un amplio
+número de @q{botones e interruptores} llamados en su conjunto
+@q{propiedades}. En el Manual de aprendizaje podemos encontrar
+una introducción en forma de tutorial al acceso y modificación de
+estas propiedades, véase @rlearning{Trucar la salida}. Éste
+debería leerse en primer lugar. Este capítulo cubre un terreno
+similar, pero con un estilo más adecuado para un manual de
+referencia.
@cindex Referencia de funcionamiento interno
-La descripción definitiva de los controles que están disponibles para
-su ajuste fino están en un documento aparte: la
-@rinternalsnamed{Top,Referencia de funcionamiento interno}.
-Dicho manual relaciona todas
-las variables, funciones y opciones que se encuentran disponibles en
-LilyPond. Está escrito como un documento HTML, que se puede encontrar
+La descripción definitiva de los controles que están disponibles
+para su ajuste fino están en un documento aparte: la
+@rinternalsnamed{Top,Referencia de funcionamiento interno}. Dicho
+manual relaciona todas las variables, funciones y opciones que se
+encuentran disponibles en LilyPond. Está escrito como un
+documento HTML, que se puede encontrar
@c leave the @uref as one long line.
@uref{http://@/lilypond@/.org/@/doc/@/stable/@/Documentation/@/internals/,en@tie{}línea},
-pero que también va incluido en el paquete de la documentación de LilyPond.
+pero que también va incluido en el paquete de la documentación de
+LilyPond.
Internamente, LilyPond utiliza el lenguaje Scheme (un dialecto de
LISP) para aportar la infraestructura. La sobreescritura de las
-decisiones de disposición da acceso efectivo a las interioridades del
-programa, lo que requiere código de Scheme como entrada. Los
-elementos de Scheme se inauguran dentro de un archivo @file{.ly} con
-el símbolo de cuadradillo@tie{}@code{#}.@footnote{@rextend{Tutorial de Scheme}
+decisiones de disposición da acceso efectivo a las interioridades
+del programa, lo que requiere código de Scheme como entrada. Los
+elementos de Scheme se inauguran dentro de un archivo @file{.ly}
+con el símbolo de
+cuadradillo@tie{}@code{#}.@footnote{@rextend{Tutorial de Scheme}
contiene un breve tutorial sobre la introducción de números,
listas, cadenas y símbolos en Scheme.}
@translationof Score - the master of all contexts
Este es el contexto de notación del nivel más alto. Ningún otro
-contexto puede contener a un contexto Score. De forma predeterminada,
-el contexto Score maneja la administración de las indicaciones de
-compás y se asegura de que ciertos elementos como claves, compases y
-armaduras están siempre alineados entre los distintos pentagramas.
+contexto puede contener a un contexto Score. De forma
+predeterminada, el contexto Score maneja la administración de las
+indicaciones de compás y se asegura de que ciertos elementos como
+claves, compases y armaduras están siempre alineados entre los
+distintos pentagramas.
Se crea implícitamente una instancia del contexto Score cuando se
procesa un bloque @code{\score @{@dots{}@}}.
@strong{@emph{StaffGroup}}
-Agrupa pentagramas y añade un corchete en la parte izquierda, formando
-un grupo. Las líneas divisorias de los pentagramas contenidos se
-conectan verticalmente. @code{StaffGroup} sólo consiste en una
-colección de pentagramas, con un corchete delante y líneas divisorias
-de arriba a abajo.
+Agrupa pentagramas y añade un corchete en la parte izquierda,
+formando un grupo. Las líneas divisorias de los pentagramas
+contenidos se conectan verticalmente. @code{StaffGroup} sólo
+consiste en una colección de pentagramas, con un corchete delante
+y líneas divisorias de arriba a abajo.
@strong{@emph{ChoirStaff}}
-Idéntico a @code{StaffGroup} excepto que las barras de compás de los
-pentagramas contenidos no se conectan verticalmente.
+Idéntico a @code{StaffGroup} excepto que las barras de compás de
+los pentagramas contenidos no se conectan verticalmente.
@strong{@emph{GrandStaff}}
Un grupo de pentagramas, con una llave en la parte izquierda que
-abarca el grupo. Las barras de compás de los pentagramas contenidos
-se conectan verticalmente.
+abarca el grupo. Las barras de compás de los pentagramas
+contenidos se conectan verticalmente.
@strong{@emph{PianoStaff}}
-Igual que @code{GrandStaff}, pero contempla la posibilidad de poner el
-nombre del instrumento a la izquierda del sistema.
+Igual que @code{GrandStaff}, pero contempla la posibilidad de
+poner el nombre del instrumento a la izquierda del sistema.
@node Contextos de nivel intermedio. Pentagramas
@strong{@emph{RhythmicStaff}}
-Como @code{Staff}, pero para imprimir ritmos. Al imprimir
-se ignoran las alturas de las notas; las notas se imprimen
-sobre una línea. La salida de MIDI conserva las alturas
-sin modificación.
+Como @code{Staff}, pero para imprimir ritmos. Al imprimir se
+ignoran las alturas de las notas; las notas se imprimen sobre una
+línea. La salida de MIDI conserva las alturas sin modificación.
@strong{@emph{TabStaff}}
@strong{@emph{VaticanaVoice}}
-Lo mismo que @code{Voice}, excepto que está diseñado para tipografiar
-piezas en estilo gregoriano.
+Lo mismo que @code{Voice}, excepto que está diseñado para
+tipografiar piezas en estilo gregoriano.
@strong{@emph{MensuralVoice}}
-Lo mismo que @code{Voice}, con modificaciones para el tipografiado de
-piezas en estilo mensural.
+Lo mismo que @code{Voice}, con modificaciones para el tipografiado
+de piezas en estilo mensural.
@strong{@emph{Lyrics}}
@strong{@emph{FiguredBass}}
-El contexto en que los objetos @code{BassFigure} se crean a partir de
-la entrada escrita en el modo @code{\figuremode}.
+El contexto en que los objetos @code{BassFigure} se crean a partir
+de la entrada escrita en el modo @code{\figuremode}.
@strong{@emph{TabVoice}}
}
\new Staff \relative {
d''4 d
-}
+ }
>>
@end lilypond
Las propiedades de todos los contextos de un tipo en particular se
pueden modificar dentro de un bloque @code{\layout} (con una
-sintaxis diferente), véase @ref{Cambiar todos los contextos del mismo tipo}.
+sintaxis diferente), véase
+@ref{Cambiar todos los contextos del mismo tipo}.
Esta construcción también ofrece una forma de mantener las
instrucciones de disposición separadas del contenido musical. Si
se va a modificar un solo contexto, debe usarse un bloque
-@code{\with}, véase @ref{Cambiar solamente un contexto determinado}.
+@code{\with}, véase
+@ref{Cambiar solamente un contexto determinado}.
@seealso
Manual de aprendizaje:
voz mediante instrucciones @code{\lyricsto}, o cuando se añaden
eventos musicales adicionales a un contexto anterior.
-Existe una excepción a esta regla general: precisamente uno de los
-contextos de @code{Voice} que están dentro de un contexto de
-@code{Staff} o de una construcción @code{<<@dots{}>>} persiste siempre
-hasta el final de, contexto de @code{Staff} circundante o la
-construcción @code{<<@dots{}>>}, incluso aunque puede haber períodos en
-que no tiene nada que hacer. El contexto que persiste de esta forma
-será el primero que se encuentre en la primera construcción encerrada
-entre llaves @code{@{@dots{}@}}, ignorando cualquiera que se encuentre
-dentro de construcciones encerradas por ángulos dobles @code{<<@dots{}>>}.
+Existe una excepción a esta regla general: dentro de una
+construcción @code{@{@dots{}@}} (música secuencial), la noción que
+la construcción tiene del @qq{contexto actual} descenderá un nivel
+cada vez que un elemento de la secuencia finaliza en un
+subcontexto del contexto anterior. Esto evita la creación espúrea
+de contextos implícitos en ciertas situaciones, pero significa que
+el primer contexto dentro del que se desciende, se va a mantener
+vivo hasta el final de la expresión.
+
+Como contraste, los contextos de una expresión hecha con la
+construcción @code{<<@dots{}>>} (música simultánea) no se
+prolongan, por lo que si una instrucción que crea un contexto se
+encierra en otro par de @code{<<@dots{}>>}, se impedirá que el
+contexto persista durante toda la duración de la secuencia
+@code{@{@dots{}@}} que lo contiene.
Cualquier contexto se puede mantener vivo si nos aseguramos de que
tiene algo que hacer en cualquier momento musical dado. Los
-contextos de @code{Staff} se mantienen con vida si nos aseguramos de
-que una de sus voces se mantiene viva. Una manera de hacerlo es
-añadir silencios de separación a una voz en paralelo con la música
-real. Éstos deben añadirse a todos y cada uno de los contextos de
-@code{Voice} que se hayan de mantener vivos. Si se van a usar
-esporádicamente varias voces, es más seguro mantenerlas todas vivas en
-lugar de tratar de confiar en las excepciones que hemos mencionado
-arriba.
+contextos de @code{Staff} se mantienen con vida si nos aseguramos
+de que una de sus voces se mantiene viva. Una manera de hacerlo
+es añadir silencios de separación a una voz en paralelo con la
+música real. Éstos deben añadirse a todos y cada uno de los
+contextos de @code{Voice} que se hayan de mantener vivos. Si se
+van a usar esporádicamente varias voces, es más seguro mantenerlas
+todas vivas en lugar de tratar de confiar en las excepciones que
+hemos mencionado arriba.
En el ejemplo siguiente, tanto la voz A como la voz B se mantienen
vivas de esta manera durante la duración de la pieza:
@cindex letra, alineación con melodía esporádica
-El ejemplo siguiente muestra cómo se puede escribir una línea melódica
-esporádica con letra utilizando este enfoque. Por supuesto, en una
-situación real la melodía y el acompañamiento consistirían en varias
-secciones diferentes.
+El ejemplo siguiente muestra cómo se puede escribir una línea
+melódica esporádica con letra utilizando este enfoque. Por
+supuesto, en una situación real la melodía y el acompañamiento
+consistirían en varias secciones diferentes.
@lilypond[quote,verbatim]
melody = \relative { a'4 a a a }
@c TODO Should this be Modifying engravers or Modifying contexts?
-Los contextos de notación (como @code{Score} y @code{Staff}) no sólo
-almacenan propiedades, también contienen «plug-ins» o complementos
-llamados @q{grabadores} que crean elementos de notación. Por ejemplo,
-el contexto @code{Voice} contiene un grabador
-@code{Note_heads_engraver} que crea las cabezas de nota y el contexto
-@code{Staff} contiene un grabador @code{Key_engraver} que
-crea la armadura.
+Los contextos de notación (como @code{Score} y @code{Staff}) no
+sólo almacenan propiedades, también contienen «plug-ins» o
+complementos llamados @q{grabadores} que crean elementos de
+notación. Por ejemplo, el contexto @code{Voice} contiene un
+grabador @code{Note_heads_engraver} que crea las cabezas de nota y
+el contexto @code{Staff} contiene un grabador @code{Key_engraver}
+que crea la armadura.
Para ver una descripción completa de todos y cada uno de los
complementos, consulte
relaciona los grabadores que se usan para ese contexto.
-Puede ser de utilidad jugar un poco con estos complementos. Se hace
-iniciando un contexto nuevo con @code{\new} o @code{\context} y
-modificándolo:
+Puede ser de utilidad jugar un poco con estos complementos. Se
+hace iniciando un contexto nuevo con @code{\new} o @code{\context}
+y modificándolo:
@funindex \with
@end example
@noindent
-donde los @dots{} deben ser el nombre de un grabador. Aquí tenemos un
-ejemplo sencillo que suprime los grabadores
-@code{Time_signature_engraver} y @code{Clef_engraver} de un contexto
-@code{Staff}:
+donde los @dots{} deben ser el nombre de un grabador. Aquí
+tenemos un ejemplo sencillo que suprime los grabadores
+@code{Time_signature_engraver} y @code{Clef_engraver} de un
+contexto @code{Staff}:
@lilypond[quote,verbatim]
<<
>>
@end lilypond
-En el segundo pentagrama no hay indicación de compás ni clave. Éste
-es un método bastante rudimentario de hacer que desaparezcan los
-objetos porque afecta a todo el pentagrama. Este método también
-afecta al espaciado, lo que puede ser deseable o no serlo. Se
-muestran métodos más sofisticados para quitar objetos en
+En el segundo pentagrama no hay indicación de compás ni clave.
+Éste es un método bastante rudimentario de hacer que desaparezcan
+los objetos porque afecta a todo el pentagrama. Este método
+también afecta al espaciado, lo que puede ser deseable o no serlo.
+Se muestran métodos más sofisticados para quitar objetos en
@rlearning{Visibilidad y color de los objetos}.
-El ejemplo siguiente muestra una aplicación práctica. Normalmente las
-líneas divisorias y las indicaciones de compás están sincronizadas a
-lo largo de toda la partitura. Lo hacen los grabadores
-@code{Timing_translator} y @code{Default_bar_line_engraver}. Estos
-complementos mantienen al día la administración de las indicaciones de
-compás, posición dentro del compás, etc. Moviendo estos grabadores
-desde el contexto de @code{Score} al de @code{Staff}, podemos
-conseguir una partitura en la que cada pentagrama tiene su propio
-compás independiente.
+El ejemplo siguiente muestra una aplicación práctica. Normalmente
+las líneas divisorias y las indicaciones de compás están
+sincronizadas a lo largo de toda la partitura. Lo hacen los
+grabadores @code{Timing_translator} y
+@code{Default_bar_line_engraver}. Estos complementos mantienen al
+día la administración de las indicaciones de compás, posición
+dentro del compás, etc. Moviendo estos grabadores desde el
+contexto de @code{Score} al de @code{Staff}, podemos conseguir una
+partitura en la que cada pentagrama tiene su propio compás
+independiente.
@cindex polimétricas, partituras
@cindex compases distintos al mismo tiempo
@knownissues
-El orden en que los grabadores se especifican es el orden en que se
-llaman para realizar su tarea de procesamiento. Normalmente, el orden
-en que se especifican los grabadores no tiene importancia, pero en
-algunos casos especiales sí la tiene, por ejemplo donde un grabador
-escribe una propiedad y otro la lee, o donde un grabador crea un groby
-otro debe procesarlo.
+El orden en que los grabadores se especifican es el orden en que
+se llaman para realizar su tarea de procesamiento. Normalmente,
+el orden en que se especifican los grabadores no tiene
+importancia, pero en algunos casos especiales sí la tiene, por
+ejemplo donde un grabador escribe una propiedad y otro la lee, o
+donde un grabador crea un groby otro debe procesarlo.
Las siguientes ordenaciones son importantes:
inscripciones,
@item
-el @code{Timing_translator} debe ir antes del grabador de números de
-compás @code{Bar_number_engraver}.
+el @code{Timing_translator} debe ir antes del grabador de números
+de compás @code{Bar_number_engraver}.
@end itemize
@cindex contexto, cambiar propiedades predeterminadas de
Se pueden cambiar las propiedades de contexto y de grob con las
-instrucciones @code{\set} y @code{\override}, tal y como se describe
-en @ref{Modificar las propiedades}. Estas instrucciones crean eventos
-musicales, haciendo que los cambios tengan efecto en el punto temporal
-en que la música se está procesando.
+instrucciones @code{\set} y @code{\override}, tal y como se
+describe en @ref{Modificar las propiedades}. Estas instrucciones
+crean eventos musicales, haciendo que los cambios tengan efecto en
+el punto temporal en que la música se está procesando.
Por contra, esta sección explica la forma de cambiarlos valores
-@emph{predeterminados} de las propiedades de contexto y de grob en el
-momento en que se crea el contexto. Existen dos formas de hacerlo.
-Una modifica los valores predeterminados en todos los contextos de un
-tipo dado, y el otro modifica los valores predeterminados solamente en
-una instancia concreta de un contexto.
+@emph{predeterminados} de las propiedades de contexto y de grob en
+el momento en que se crea el contexto. Existen dos formas de
+hacerlo. Una modifica los valores predeterminados en todos los
+contextos de un tipo dado, y el otro modifica los valores
+predeterminados solamente en una instancia concreta de un
+contexto.
@menu
* Cambiar todos los contextos del mismo tipo::
@funindex \context
@funindex \layout
-Los ajustes de contexto predeterminados que se han de usar para la composición
-tipográfica dentro de @code{Score}, @code{Staff}, @code{Voice} y otros contextos
-se pueden especificar en un bloque @code{\context} dentro de cualquier
-bloque @code{\layout}.
+Los ajustes de contexto predeterminados que se han de usar para la
+composición tipográfica dentro de @code{Score}, @code{Staff},
+@code{Voice} y otros contextos se pueden especificar en un bloque
+@code{\context} dentro de cualquier bloque @code{\layout}.
Los ajustes para la salida MIDI, al contrario que para la
composición tipográfica, se tendrán que especificar aparte en
bloques @code{\midi} (véase
@ref{Definiciones de salida - estructura de los contextos}).
-El bloque @code{\layout} se debe colocar
-dentro del bloque @code{\score} al que se aplica, después de la
-música.
+El bloque @code{\layout} se debe colocar dentro del bloque
+@code{\score} al que se aplica, después de la música.
@example
\layout @{
@itemize
@item
-Una instrucción @code{\override}, pero omitiendo el nombre del contexto
+Una instrucción @code{\override}, pero omitiendo el nombre del
+contexto
@lilypond[quote,verbatim]
\score {
@end lilypond
@item
-Una instrucción predefinida tal como @code{\dynamicUp} o una expresión
-musical como @code{\accidentalStyle dodecaphonic}
+Una instrucción predefinida tal como @code{\dynamicUp} o una
+expresión musical como @code{\accidentalStyle dodecaphonic}
@lilypond[quote,verbatim]
\score {
@end itemize
-Las instrucciones de ajuste de propiedades se pueden disponer dentro
-de un bloque @code{\layout} sin que estén encerradas en un bloque
-@code{\context}. Tales ajustes son equivalentes a incluir las mismas
-instrucciones de ajuste de propiedades al comienzo de cada uno de los
-contextos del tipo especificado. Si no se especifica ningún contexto,
-@emph{todos y cada uno} de los contextos del nivel inferior quedan
-afectados, véase @ref{Contextos del nivel más bajo. Voces}. La
-sintaxis de una instrucción de ajuste de propiedades dentro de un
-bloque @code{\layout} es la misma que si la misma instrucción
-estuviera escrita en el propio flujo musical.
+Las instrucciones de ajuste de propiedades se pueden disponer
+dentro de un bloque @code{\layout} sin que estén encerradas en un
+bloque @code{\context}. Tales ajustes son equivalentes a incluir
+las mismas instrucciones de ajuste de propiedades al comienzo de
+cada uno de los contextos del tipo especificado. Si no se
+especifica ningún contexto, @emph{todos y cada uno} de los
+contextos del nivel inferior quedan afectados, véase
+@ref{Contextos del nivel más bajo. Voces}. La sintaxis de una
+instrucción de ajuste de propiedades dentro de un bloque
+@code{\layout} es la misma que si la misma instrucción estuviera
+escrita en el propio flujo musical.
@lilypond[quote,verbatim]
\score {
@cindex \with
@funindex \with
-Las propiedades de contexto de una única instancia de contexto pueden
-cambiarse dentro de un bloque @code{\with}. Todas las demás
-instancias de contexto del mismo tipo retienen los ajustes
-predeterminados que LilyPond tiene programados y que se modifican por
-parte de cualquier bloque @code{\layout} que se encuentre dentro del
-ámbito. El bloque @code{\with} se debe situar inmediatamente después
-de las instrucciones @code{\new} @var{context-type}:
+Las propiedades de contexto de una única instancia de contexto
+pueden cambiarse dentro de un bloque @code{\with}. Todas las
+demás instancias de contexto del mismo tipo retienen los ajustes
+predeterminados que LilyPond tiene programados y que se modifican
+por parte de cualquier bloque @code{\layout} que se encuentre
+dentro del ámbito. El bloque @code{\with} se debe situar
+inmediatamente después de las instrucciones @code{\new}
+@var{context-type}:
@example
\new Staff \with @{ [ajustes de contexto para esta instancia de contexto solamente] @}
@unnumberedsubsubsec Orden de precedencia
@translationof Order of precedence
-El valor de una propiedad que se aplica en un momento determinado se
-determina de la siguiente forma:
+El valor de una propiedad que se aplica en un momento determinado
+se determina de la siguiente forma:
@itemize
@item
dentro del flujo musical, se usa dicho valor,
@item
-de lo contrario, se usa el valor predeterminado tomado de un enunciado
-@code{\with} en las instrucciones de inicio del contexto,
+de lo contrario, se usa el valor predeterminado tomado de un
+enunciado @code{\with} en las instrucciones de inicio del
+contexto,
@item
-de lo contrario, se usa el valor tomado del bloque @code{\context} más
-reciente que corresponda dentro de los bloques @code{\layout} o @code{\midi},
+de lo contrario, se usa el valor tomado del bloque @code{\context}
+más reciente que corresponda dentro de los bloques @code{\layout}
+o @code{\midi},
@item
de lo contrario se usa el valor predeterminado que LilyPond lleva
@funindex denies
Los contextos específicos, como @code{Staff} y @code{Voice}, están
-construidos a partir de bloques sencillos. Es posible crear nuevos
-tipos de contextos con combinaciones distintas de añadidos grabadores.
+construidos a partir de bloques sencillos. Es posible crear
+nuevos tipos de contextos con combinaciones distintas de añadidos
+grabadores.
El siguiente ejemplo muestra cómo construir un tipo diferente de
contexto de @code{Voice} partiendo de cero. Será parecido a
@code{Voice}, pero imprime solamente cabezas centradas en forma de
-barra inclinada. Se puede usar para indicar improvisación en piezas
-de jazz,
+barra inclinada. Se puede usar para indicar improvisación en
+piezas de jazz,
@lilypond[quote,ragged-right]
\layout { \context {
@end lilypond
-Estos ajustes se definen dentro de un bloque @code{\context} que a su
-vez está dentro de un bloque @code{\layout},
+Estos ajustes se definen dentro de un bloque @code{\context} que a
+su vez está dentro de un bloque @code{\layout},
@example
\layout @{
En el siguiente análisis, la entrada de ejemplo que se muestra debe ir
en el lugar de los puntos suspensivos @dots{} del fragmento anterior.
-En primer lugar es necesario definir un nombre para el nuevo contexto:
+En primer lugar es necesario definir un nombre para el nuevo
+contexto:
@example
\name ImproVoice
@funindex \accepts
Los contextos dan lugar a jerarquías. Queremos poner el contexto
-@code{ImproVoice} dentro del contexto @code{Staff}, igual que los contextos
-de voz normales. Por tanto, modificamos la definición de
-@code{Staff} con la instrucción @code{\accepts} (acepta),
+@code{ImproVoice} dentro del contexto @code{Staff}, igual que los
+contextos de voz normales. Por tanto, modificamos la definición
+de @code{Staff} con la instrucción @code{\accepts} (acepta),
@example
\context @{
@}
@end example
+@funindex \inherit-acceptability
+Con frecuencia, al reutilizar una definición de contexto
+existente, el contexto resultante se puede usar en cualquier lugar
+donde el contexto original hubiera podido hacerlo.
+
+@example
+\layout @{
+ @dots{}
+ \inherit-acceptability @var{to} @var{from}
+@}
+@end example
+
+@noindent
+consigue que tengamos contextos del tipo @var{to} aceptados por
+todos los contextos que asimismo aceptan @var{from}. Por ejemplo,
+usar
+
+@example
+\layout @{
+ @dots{}
+ \inherit-acceptability "ImproVoice" "Voice"
+@}
+@end example
+
+@noindent
+añade un @code{\accepts} para @code{ImproVoice} tanto a la
+definición de @code{Staff} como a la de @code{RhythmicStaff}.
+
@funindex \denies
-Lo opuesto a @code{\accepts} (acepta) es @code{\denies} (deniega), lo
-que a veces se necesita cuando se están reutilizando definiciones de
-contexto existentes.
+Lo opuesto a @code{\accepts} (acepta) es @code{\denies} (deniega),
+lo que a veces se necesita cuando se están reutilizando
+definiciones de contexto existentes.
-Ponemos ambos dentro de un bloque @code{\layout}, como
+Organizar las piezas requeridas dentro de un bloque @code{\layout}
+nos deja con
@example
\layout @{
\name ImproVoice
@dots{}
@}
- \context @{
- \Staff
- \accepts "ImproVoice"
- @}
+ \inherit-acceptability "ImproVoice" "Voice"
@}
@end example
@funindex \accepts
@funindex \denies
-Los contextos se disponen en un sistema normalmente desde arriba hacia
-abajo en el orden en que se encuentran en el archivo de entrada.
-Cuando los contextos se anidan unos dentro de otros, el contexto
-exterior incluye a los contextos anidados tal y como se especifica en
-el archivo de entrada, siempre y cuando los contextos interiores estén
-incluidos en la lista @qq{accepts} del contexto externo. Los
-contextos anidados que no está nincluidos en la lista @qq{accepts} del
-contexto externo se recolocan debajo del contexto externo en lugar de
-anidarse dentro de él.
+Los contextos se disponen en un sistema normalmente desde arriba
+hacia abajo en el orden en que se encuentran en el archivo de
+entrada. Cuando los contextos se anidan unos dentro de otros, el
+contexto exterior incluye a los contextos anidados tal y como se
+especifica en el archivo de entrada, siempre y cuando los
+contextos interiores estén incluidos en la lista @qq{accepts} del
+contexto externo. Los contextos anidados que no está nincluidos
+en la lista @qq{accepts} del contexto externo se recolocan debajo
+del contexto externo en lugar de anidarse dentro de él.
La lista @qq{accepts} de un contexto se puede cambiar con las
instrucciones @code{\accepts} (acepta) o @code{\denies} (niega).
}
@end lilypond
-@code{\denies} se usa principalmente cuando un contexto nuevo se está
-basando en otro, pero los anidamientos requeridos difieren. Por
-ejemplo, el contexto @code{VaticanaStaff} está basado en el contexto
-@code{Staff}, pero con el contexto @code{VaticanaVoice} sustituido por
-el contexto @code{Voice} en la lista @qq{accepts}.
+@code{\denies} se usa principalmente cuando un contexto nuevo se
+está basando en otro, pero los anidamientos requeridos difieren.
+Por ejemplo, el contexto @code{VaticanaStaff} está basado en el
+contexto @code{Staff}, pero con el contexto @code{VaticanaVoice}
+sustituido por el contexto @code{Voice} en la lista @qq{accepts}.
@cindex contextos implícitos
Supongamos que queremos mover la indicación de digitación del
fragmento siguiente:
-@lilypond[quote,relative=2,verbatim]
-c-2
-\stemUp
-f
+@lilypond[quote,fragment,verbatim]
+c''-2
@end lilypond
Si hace una visita a la documentación en busca de instrucciones de
@ifnothtml
La referencia del programador se encuentra disponible en forma de
-documento HTML. Se recomienda mucho que lo lea en la forma HTML, bien
-en línea o bien descargando los archivos de la documentación HTML.
-Esta sección sería mucho más difícil de entender si está utilizando el
-manual en formato PDF.
+documento HTML. Se recomienda mucho que lo lea en la forma HTML,
+bien en línea o bien descargando los archivos de la documentación
+HTML. Esta sección sería mucho más difícil de entender si está
+utilizando el manual en formato PDF.
@end ifnothtml
-Siga el enlace que lleva a @rinternals{Fingering}. Al principio de la
-página, puede ver
+Siga el enlace que lleva a @rinternals{Fingering}. Al principio
+de la página, puede ver
@quotation
Los objetos de digitación se crean por parte de:
@end quotation
Siguiendo los enlaces relacionados dentro de la referencia del
-programa, podemos seguir el flujo de información dentro del programa:
+programa, podemos seguir el flujo de información dentro del
+programa:
@itemize
Expresiones musicales con el nombre de @rinternals{FingeringEvent}
@end itemize
-Este camino se recorre en contra de la corriente de información del
-programa: comienza por la salida y acaba en el evento de entrada.
-También podríamos haber empezado por un evento de la entrada, y leído
-siguiendo el flujo de información terminando en su caso en el objeto
-(u objetos) de la salida.
+Este camino se recorre en contra de la corriente de información
+del programa: comienza por la salida y acaba en el evento de
+entrada. También podríamos haber empezado por un evento de la
+entrada, y leído siguiendo el flujo de información terminando en
+su caso en el objeto (u objetos) de la salida.
-La referencia del programa también se puede examinar como un documento
-normal. Contiene capítulos que tratan de
+La referencia del programa también se puede examinar como un
+documento normal. Contiene capítulos que tratan de
@ifhtml
@rinternals{Music definitions},
@end ifhtml
@ifnothtml
@code{Music definitions}
@end ifnothtml
-de la @rinternals{Translation}, y del @rinternals{Backend}. Cada uno
-de los capítulos relaciona todas las definiciones utilizadas y todas
-las propiedades que se pueden ajustar.
+de la @rinternals{Translation}, y del @rinternals{Backend}. Cada
+uno de los capítulos relaciona todas las definiciones utilizadas y
+todas las propiedades que se pueden ajustar.
@node Interfaces de la presentación
@cindex grob
La página HTML que pudimos ver en la sección anterior describe el
-objeto de presentación llamado @rinternals{Fingering}. Dicho objeto
-es un símbolo dentro de la partitura. Tiene propiedades que guardan
-números (como grosores y direcciones), pero también punteros a objetos
-relacionados. Un objeto de presentación también se llama un
-@emph{Grob}, que es una abreviatura de Graphical Object (objeto
-gráfico). Para ver más detalles acerca de los objetos gráficos o
-Grobs, consulte @rinternals{grob-interface}.
+objeto de presentación llamado @rinternals{Fingering}. Dicho
+objeto es un símbolo dentro de la partitura. Tiene propiedades
+que guardan números (como grosores y direcciones), pero también
+punteros a objetos relacionados. Un objeto de presentación
+también se llama un @emph{Grob}, que es una abreviatura de
+Graphical Object (objeto gráfico). Para ver más detalles acerca
+de los objetos gráficos o Grobs, consulte
+@rinternals{grob-interface}.
La página dedicada a @code{Fingering} relaciona las definiciones del
objeto @code{Fingering}. Por ejemplo, la página dice
menos 0.5 de la cabeza de la nota.
-Cada objeto de presentación puede tener varias funciones como elemento
-notacional o tipográfico. Por ejemplo, el objeto de digitación
-Fingering tiene los siguientes aspectos
+Cada objeto de presentación puede tener varias funciones como
+elemento notacional o tipográfico. Por ejemplo, el objeto de
+digitación Fingering tiene los siguientes aspectos
@itemize
@item
-Su tamaño es independiente del espaciado horizontal, al contrario de
-las ligaduras o las barras de las figuras.
+Su tamaño es independiente del espaciado horizontal, al contrario
+de las ligaduras o las barras de las figuras.
@item
Es un elemento de texto. Casi seguro que es un texto muy corto.
@item
-este elemento de texto se tipografía con un tipo de letra, no como las
-ligaduras o las barras de las figuras.
+este elemento de texto se tipografía con un tipo de letra, no como
+las ligaduras o las barras de las figuras.
@item
-Horizontalmente, el centro del símbolo se debe alinear con el centro
-de la cabeza de la nota.
+Horizontalmente, el centro del símbolo se debe alinear con el
+centro de la cabeza de la nota.
@item
Verticalmente, el símbolo se coloca cerca de la nota y del pentagrama.
Al pulsar sobre cualquiera de los enlaces nos desplazaremos a la
página del respectivo interfaz del objeto. Cada interfaz tiene un
cierto número de propiedades. Algunas de ellas no son para que el
-usuario las pueda ajustar (@q{Propiedades internas}), pero otras sí se
-pueden modificar.
+usuario las pueda ajustar (@q{Propiedades internas}), pero otras
+sí se pueden modificar.
Hemos estado hablando de @emph{el} objeto @code{Fingering}, pero
realmente esto no significa mucho. El archivo de inicialización
@end example
@noindent
-Como podemos ver, el objeto @code{Fingering} no es más que un montón
-de valores de variables, y la página web de la Referencia de
-funcionamiento interno se genera directamente a partir de esta
+Como podemos ver, el objeto @code{Fingering} no es más que un
+montón de valores de variables, y la página web de la Referencia
+de funcionamiento interno se genera directamente a partir de esta
definición.
Recordemos que queríamos cambiar la posición del @b{2} en
-@lilypond[quote,relative=2,verbatim]
-c-2
-\stemUp
-f
+@lilypond[quote,fragment,verbatim]
+c''-2
@end lilypond
-Puesto que el @b{2} se encuentra colocado verticalmente sobre su nota,
-tenemos que negociar con el interfaz asociado con esta colocación.
-Esto se hace usando @code{side-position-interface}. La página que
-describe este interface dice:
+Puesto que el @b{2} se encuentra colocado verticalmente sobre su
+nota, tenemos que negociar con el interfaz asociado con esta
+colocación. Esto se hace usando @code{side-position-interface}.
+La página que describe este interface dice:
@quotation
@code{side-position-interface}
@cindex relleno
@cindex padding (relleno)
@noindent
-Debajo de esta descripción, la variable @code{padding} (relleno) se
-describe como
+Debajo de esta descripción, la variable @code{padding} (relleno)
+se describe como
@quotation
@table @code
@item padding
(dimensión, en espacios de pentagrama)
-Añadir esta cantidad de espacio adicional entre objetos que están unos
-junto a otros.
+Añadir esta cantidad de espacio adicional entre objetos que están
+unos junto a otros.
@end table
@end quotation
f
@end lilypond
-En este caso, el contexto de este truco es @code{Voice}. Este hecho
-se puede deducir también a partir de la referencia del programa, ya
-que la página dedicada al añadido @rinternals{Fingering_engraver} dice
+En este caso, el contexto de este truco es @code{Voice}. Este
+hecho se puede deducir también a partir de la referencia del
+programa, ya que la página dedicada al añadido
+@rinternals{Fingering_engraver} dice
@quotation
El grabador Fingering_engraver es parte de los contextos: @dots{}
@translationof Overview of modifying properties
Cada contexto es responsable de la creación de ciertos tipos de
-objetos gráficos. Los ajustes que se usan para imprimir estos objetos
-también se almacenan por contexto. Mediante la modificación de estos
-ajustes, se puede alterar la apariencia de los objetos.
+objetos gráficos. Los ajustes que se usan para imprimir estos
+objetos también se almacenan por contexto. Mediante la
+modificación de estos ajustes, se puede alterar la apariencia de
+los objetos.
Existen dos tipos diferentes de propiedades almacenadas en los
-contextos: las propiedades de contexto y las propiedades de grob. Las
-propiedades de contexto son propiedades que se aplican al contexto
-como un todo y controlan la forma en que el propio contexto se
-imprime. Por contra, las propiedades de grob se aplican a los tipos
-de grob específicos que se imprimirán dentro del contexto.
-
-Las instrucciones @code{\set} y @code{\unset} se usan para cambiar los
-valores de las propiedades de contexto. Las instrucciones
-@code{\override} y @code{\revert} se usan para cambiar los valores de
-las propiedades de grob.
+contextos: las propiedades de contexto y las propiedades de grob.
+Las propiedades de contexto son propiedades que se aplican al
+contexto como un todo y controlan la forma en que el propio
+contexto se imprime. Por contra, las propiedades de grob se
+aplican a los tipos de grob específicos que se imprimirán dentro
+del contexto.
+
+Las instrucciones @code{\set} y @code{\unset} se usan para cambiar
+los valores de las propiedades de contexto. Las instrucciones
+@code{\override} y @code{\revert} se usan para cambiar los valores
+de las propiedades de grob.
@ignore
La sintaxis de esto es
@rinternals{PropertySet}.
@knownissues
-El «back-end» o motor de salida no es muy estricto en la comprobación
-de tipos de las propiedades de objetos. Las referencias cíclicas en
-valores Scheme de propiedades pueden producir cuelgues o salidas
-abruptas, o las dos cosas.
+El «back-end» o motor de salida no es muy estricto en la
+comprobación de tipos de las propiedades de objetos. Las
+referencias cíclicas en valores Scheme de propiedades pueden
+producir cuelgues o salidas abruptas, o las dos cosas.
@node La instrucción set
@cindex cambiar propiedades
Cada contexto puede tener distintas @emph{propiedades}, variables
-contenidas dentro de ese contexto. Se pueden cambiar mientras dura el
-paso de interpretación. Se consigue insertando la instrucción
-@code{\set} dentro de la música:
+contenidas dentro de ese contexto. Se pueden cambiar mientras
+dura el paso de interpretación. Se consigue insertando la
+instrucción @code{\set} dentro de la música:
@example
\set @var{contexto}.@var{propiedad} = #@var{valor}
@end example
-@var{valor} es un objeto de Scheme, razón por la que va precedido del
-carácter almohadilla,@tie{}@code{#}.
+@var{valor} es un objeto de Scheme, razón por la que va precedido
+del carácter almohadilla,@tie{}@code{#}.
-El nombre de las propiedades de contexto suele ir en minúsculas con
-mayúscula en medio. Controlan sobre todo la traducción de la música a
-la notación, p.ej. @code{localAlterations} (para determinar si hay
-que impriir alteraciones o no), o @code{measurePosition} (para
-determinar cuándo hay que imprimir una línea divisoria). El valor de
-las propiedades de contexto puede modifcarse con el tiempo durante la
-interpretación de la música; un ejemplo obvio es
-@code{measurePosition}. Las propiedades de contexto se modifican
-mediante la instrucción @code{\set}.
+El nombre de las propiedades de contexto suele ir en minúsculas
+con mayúscula en medio. Controlan sobre todo la traducción de la
+música a la notación, p.ej. @code{localAlterations} (para
+determinar si hay que impriir alteraciones o no), o
+@code{measurePosition} (para determinar cuándo hay que imprimir
+una línea divisoria). El valor de las propiedades de contexto
+puede modifcarse con el tiempo durante la interpretación de la
+música; un ejemplo obvio es @code{measurePosition}. Las
+propiedades de contexto se modifican mediante la instrucción
+@code{\set}.
-Por ejemplo, los silencios multicompás se combinan en un solo compás
-si el valor de la propiedad de contexto @code{skipBars} se establece a
-@code{#t} (verdadero):
+Por ejemplo, los silencios multicompás se combinan en un solo
+compás si el valor de la propiedad de contexto @code{skipBars} se
+establece a @code{#t} (verdadero):
@lilypond[quote,fragment,verbatim]
R1*2
}
@end lilypond
-El cambio se aplica @q{al vuelo}, mientras dura la música, de forma
-que el ajuste sólo afecta al segundo grupo de corcheas.
+El cambio se aplica @q{al vuelo}, mientras dura la música, de
+forma que el ajuste sólo afecta al segundo grupo de corcheas.
Observe que el contexto del nivel más bajo no siempre contiene la
-propiedad que querríamos modificar: por ejemplo, intentar ajustar el
-valor de la propiedad @code{skipBars} del contexto predeterminado del
-nivel más bajo, que en este caso es @code{Voice}, no tendrá ningún
-efecto, porque skipBars es una propiedad del contexto @code{Score}.
+propiedad que querríamos modificar: por ejemplo, intentar ajustar
+el valor de la propiedad @code{skipBars} del contexto
+predeterminado del nivel más bajo, que en este caso es
+@code{Voice}, no tendrá ningún efecto, porque skipBars es una
+propiedad del contexto @code{Score}.
@lilypond[quote,fragment,verbatim]
R1*2
@end lilypond
Como @code{\set}, el argumento @var{contexto} no se tiene que
-especificar para un contexto del nivel más bajo, por lo que los dos
-enunciados
+especificar para un contexto del nivel más bajo, por lo que los
+dos enunciados
@example
\set Voice.autoBeaming = ##t
@cindex \once
-Los ajustes que se aplican solamente a un único paso de tiempo se
-pueden escribir con @code{\once}, por ejemplo en
+Los ajustes con @code{\set} o @code{\unset} que se aplican
+solamente a un único paso de tiempo se pueden escribir con
+@code{\once}, por ejemplo en
@lilypond[quote,fragment,verbatim]
c''4
@end lilypond
En el manual de Referencia de funcionamiento interno hay una
-descripción completa de todas las propiedades de contexto disponibles,
-consulte
+descripción completa de todas las propiedades de contexto
+disponibles, consulte
@ifhtml
@rinternals{Tunable context properties}.
@end ifhtml
@cindex propiedades de grob
@funindex \override
-Existe un tipo especial de propiedad de contexto: la descripción de
-los grobs. Las decscripciones de los grobs reciben un nombre en
-@code{MayúsculasDeCamello} (empezando en mayúscula). Contienen los
-@q{ajustes predeterminados} para un tipo particular de grob, en forma
-de lista asociativa. Consulte @file{scm/define-grobs.scm} para
-ver los ajustes de cada descripción de grob. Las descripciones de
-grob se modifican con @code{\override}.
+Existe un tipo especial de propiedad de contexto: la descripción
+de los grobs. Las decscripciones de los grobs reciben un nombre
+en @code{MayúsculasDeCamello} (empezando en mayúscula). Contienen
+los @q{ajustes predeterminados} para un tipo particular de grob,
+en forma de lista asociativa. Consulte
+@file{scm/define-grobs.scm} para ver los ajustes de cada
+descripción de grob. Las descripciones de grob se modifican con
+@code{\override}.
La sintaxis de la instrucción @code{\override} es
}
@end lilypond
-Los efectos de @code{\override} y @code{\revert} se aplican a todos
-los grobs del contexto afectado partiendo del momento actual y hacia
-adelante:
+Los efectos de @code{\override} y @code{\revert} se aplican a
+todos los grobs del contexto afectado partiendo del momento actual
+y hacia adelante:
@lilypond[quote,verbatim]
<<
@funindex \once
@cindex sobreescritura para un solo momento
-Se puede usar @code{\once} con @code{\override} para afectar solamente
-al instante de tiempo actual:
+Se puede usar @code{\once} con @code{\override} o @code{\revert}
+para afectar solamente al instante de tiempo actual:
@lilypond[quote,verbatim]
<<
Para ver una introducción a la sintaxis y los usos de la instrucción tweak,
consulte @rlearning{Métodos de trucaje}.
-Si se colocan varios elementos similares en el mismo momento musical,
-la instrucción @code{\override} no se puede usar para modificar uno
-solo de ellos: aquí es donde se debe usar la instrucción
-@code{\tweak}. Entre los elementos que pueden aparecer más de una vez
-en el mismo momento musical están los siguientes:
+Si se colocan varios elementos similares en el mismo momento
+musical, la instrucción @code{\override} no se puede usar para
+modificar uno solo de ellos: aquí es donde se debe usar la
+instrucción @code{\tweak}. Entre los elementos que pueden
+aparecer más de una vez en el mismo momento musical están los
+siguientes:
@c TODO expand to include any further uses of \tweak
@itemize
@cindex acorde, modificación de una nota
-En este ejemplo se modifican el color de una cabeza y el tipo de otra,
-dentro del mismo acorde:
+En este ejemplo se modifican el color de una cabeza y el tipo de
+otra, dentro del mismo acorde:
@lilypond[verbatim,fragment,quote]
< c''
<\tweak color #red c'' e''>4
@end lilypond
-La instrucción @code{\tweak} sencilla no se puede usar para modificar
-ningún objeto que no se haya creado directamente a partir de la entrada.
-Concretamente, no afecta a las plicas, barras automáticas ni
-alteraciones, porque éstos se generan posteriormente por
-parte de objetos de presentación @code{NoteHead}
-más que por elementos musicales del
-flujo de entrada.
+La instrucción @code{\tweak} sencilla no se puede usar para
+modificar ningún objeto que no se haya creado directamente a
+partir de la entrada. Concretamente, no afecta a las plicas,
+barras automáticas ni alteraciones, porque éstos se generan
+posteriormente por parte de objetos de presentación
+@code{NoteHead} más que por elementos musicales del flujo de
+entrada.
-Tales objetos de presentación creados indirectamente se pueden trucar
-usando la forma de la instrucción @code{\tweak} en que el nombre
-del grob se especifica de forma explícita:
+Tales objetos de presentación creados indirectamente se pueden
+trucar usando la forma de la instrucción @code{\tweak} en que el
+nombre del grob se especifica de forma explícita:
@lilypond[fragment,verbatim,quote]
\tweak Stem.color #red
f''
@end lilypond
-El flujo musical que se genera a partir de una sección de un archivo
-de entrada (incluido cualquier elemento insertado automáticamente)
-puede examinarse, véase @rextend{Presentación de las expresiones musicales}.
-Esto puede ser de utilidad en la determinación de lo que
-puede modificarse por medio de una instrucción @code{\tweak}.
+El flujo musical que se genera a partir de una sección de un
+archivo de entrada (incluido cualquier elemento insertado
+automáticamente) puede examinarse, véase
+@rextend{Presentación de las expresiones musicales}. Esto puede
+ser de utilidad en la determinación de lo que puede modificarse
+por medio de una instrucción @code{\tweak}.
@seealso
Manual de aprendizaje:
@cindex control, trucar puntos de
No se puede usar la instrucción @code{\tweak} para modificar los
-puntos de control de una sola de varias ligaduras de unión dentro de
-un acorde, aparte de la primera que se encuentre en el código de
-entrada.
+puntos de control de una sola de varias ligaduras de unión dentro
+de un acorde, aparte de la primera que se encuentre en el código
+de entrada.
@node set frente a override
el propio contexto presentan los valores del contexto padre
respectivo.
-El valor y la duración en el tiempo de las propiedades de contexto son
-dinámicos y están disponibles solamente cuando la música se está
-interpretando o @q{iterando}. En el momento de la creación del
-contexto, se inicializan las propiedades a partir de la definición de
-contexto correspondiente y las posibles modificaciones de contexto.
-Después de esto, cualquier cambio se obtiene a través de instrucciones
-de establecimiento de propiedades dentro de la propia música.
-
-Ahora bien, las definiciones de grob (objetos gráficos) son una clase
-especial de propiedades de contexto. Dado que su estructura,
-mantenimiento y utilización es distinta de las propiedades de contexto
-ordinarias, se accede a ellas con un conjunto de instrucciones
-diferente, y se estudian por separado dentro de la documentación.
-
-A diferencia de las propiedades de contexto normales, las definiciones
-de grob están subdivididas en propiedades de grob. Un @qq{grob}
-(objeto gráfico) se crea normalmente por parte de un grabador en el
-momento de la interpretación de una expresión musical y recibe sus
-propiedades iniciales de la definición de grob en curso del contexto
-del grabador. El grabador (u otras partes del @q{backend} de
-LilyPond) pueden después añadir o modificar propiedades del grob, pero
-ello no afecta a la definición de grob del contexto.
+El valor y la duración en el tiempo de las propiedades de contexto
+son dinámicos y están disponibles solamente cuando la música se
+está interpretando o @q{iterando}. En el momento de la creación
+del contexto, se inicializan las propiedades a partir de la
+definición de contexto correspondiente y las posibles
+modificaciones de contexto. Después de esto, cualquier cambio se
+obtiene a través de instrucciones de establecimiento de
+propiedades dentro de la propia música.
+
+Ahora bien, las definiciones de grob (objetos gráficos) son una
+clase especial de propiedades de contexto. Dado que su
+estructura, mantenimiento y utilización es distinta de las
+propiedades de contexto ordinarias, se accede a ellas con un
+conjunto de instrucciones diferente, y se estudian por separado
+dentro de la documentación.
+
+A diferencia de las propiedades de contexto normales, las
+definiciones de grob están subdivididas en propiedades de grob.
+Un @qq{grob} (objeto gráfico) se crea normalmente por parte de un
+grabador en el momento de la interpretación de una expresión
+musical y recibe sus propiedades iniciales de la definición de
+grob en curso del contexto del grabador. El grabador (u otras
+partes del @q{backend} de LilyPond) pueden después añadir o
+modificar propiedades del grob, pero ello no afecta a la
+definición de grob del contexto.
Lo que conocemos como @q{propiedades de grob} en el contexto del
trucaje a nivel de usuario son en realidad las propiedades de la
-definición de grob de un contexto. A diferencia de las propiedades de
-contexto normales, las definiciones de grob mantienen la contabilidad
-necesaria para seguir la pista de sus partes, las propiedades de grob
-individuales (e incluso subpropiedades de éstos), de forma separada,
-de forma que es posible definir dichas partes dentro de contextos
-diferentes y hacer que la definición de grob en su conjunto, en el
-momento de la creación del grob, se monte a partir de las piezas
-proporcionadas en diferentes contextos entre el contexto actual y sus
-contextos padre.
+definición de grob de un contexto. A diferencia de las
+propiedades de contexto normales, las definiciones de grob
+mantienen la contabilidad necesaria para seguir la pista de sus
+partes, las propiedades de grob individuales (e incluso
+subpropiedades de éstos), de forma separada, de forma que es
+posible definir dichas partes dentro de contextos diferentes y
+hacer que la definición de grob en su conjunto, en el momento de
+la creación del grob, se monte a partir de las piezas
+proporcionadas en diferentes contextos entre el contexto actual y
+sus contextos padre.
Las definiciones de grob se manipulan usando @code{\override} y
@code{\revert} y tienen un nombre que empieza con una letra mayúscula
@subsection Modificación de las listas-A
@translationof Modifying alists
-Ciertas propiedades configurables por parte del usuario se representan
-internamente como @emph{listas-A} (listas asociativas), que almacenan
-duplas de @emph{claves} y @emph{valores}. La estructura de una
-lista-A es la siguiente:
+Ciertas propiedades configurables por parte del usuario se
+representan internamente como @emph{listas-A} (listas
+asociativas), que almacenan duplas de @emph{claves} y
+@emph{valores}. La estructura de una lista-A es la siguiente:
@example
'((@var{clave1} . @var{valor1})
@end example
Si una lista-A es una propiedad de un grob o una variable de
-@code{\paper}, sus claves se pueden modificar individualmente sin que
-afecte a las otras claves.
+@code{\paper}, sus claves se pueden modificar individualmente sin
+que afecte a las otras claves.
Por ejemplo, para reducir el espacio entre pentagramas adyacentes
dentro de un grupo, use la propiedad @code{staff-staff-spacing}
-del grob @code{StaffGrouper}. La propiedad es una lista-A con cuatro
-claves: @code{basic-distance} (distancia básica),
-@code{minimum-distance} (distancia mínima), @code{padding} (relleno)
-y @code{stretchability} (ampliabilidad).
-Los ajustes estándar para esta propiedad
-se relacionan en la sección
-@qq{Backend} de la Referencia de Funcionamiento Interno
-(véase @rinternals{StaffGrouper}):
+del grob @code{StaffGrouper}. La propiedad es una lista-A con
+cuatro claves: @code{basic-distance} (distancia básica),
+@code{minimum-distance} (distancia mínima), @code{padding}
+(relleno) y @code{stretchability} (ampliabilidad). Los ajustes
+estándar para esta propiedad se relacionan en la sección
+@qq{Backend} de la Referencia de Funcionamiento Interno (véase
+@rinternals{StaffGrouper}):
@example
'((basic-distance . 9)
(stretchability . 5))
@end example
-Una forma de acercar los pentagramas entre sí es reducir el valor de
-la clave @code{basic-distance} (@code{9}) para que se corresponda con
-el valor de @code{minimum-distance} (@code{7}). Para modificar una
-única clave de forma individual, utilice una @emph{declaración
-anidada}:
+Una forma de acercar los pentagramas entre sí es reducir el valor
+de la clave @code{basic-distance} (@code{9}) para que se
+corresponda con el valor de @code{minimum-distance} (@code{7}).
+Para modificar una única clave de forma individual, utilice una
+@emph{declaración anidada}:
@lilypond[quote,verbatim]
% default space between staves
La utilización de una declaración anidada actualiza la clave
especificada (como @code{basic-distance} en el ejemplo anterior)
-sin alterar ninguna
-de las otras claves que ya se habían establecido para la misma
-propiedad.
+sin alterar ninguna de las otras claves que ya se habían
+establecido para la misma propiedad.
-Ahora, supongamos que deseamos que los pentagramas estén tan próximos
-como sea posible sin que se superpongan. La manera más sencilla de
-hacerlo es establecer las cuatro claves de la lista-A a cero. Sin
-embargo, no es necesario escribir cuatro declaraciones anidadas, una
-por cada clave. En lugar de eso, se puede redefinir completamente la
-propiedad con una sola declaración, como una lista-A:
+Ahora, supongamos que deseamos que los pentagramas estén tan
+próximos como sea posible sin que se superpongan. La manera más
+sencilla de hacerlo es establecer las cuatro claves de la lista-A
+a cero. Sin embargo, no es necesario escribir cuatro
+declaraciones anidadas, una por cada clave. En lugar de eso, se
+puede redefinir completamente la propiedad con una sola
+declaración, como una lista-A:
@lilypond[quote,verbatim]
\new PianoStaff \with {
@end lilypond
Observe que cualquier clave que no haya sido relacionada
-explícitamente en la definición de la lista-A, será reiniciada a sus
-valores @emph{predeterminados si no se han fijado}. En el caso de
-@code{staff-staff-spacing}, el valor de cualquier clave no fijada se
-reiniciaría a cero (excepto @code{stretchability}, que toma el valor
-de @code{basic-distance} si no se fija). Así, las dos declaraciones
-siguientes son equivalentes:
+explícitamente en la definición de la lista-A, será reiniciada a
+sus valores @emph{predeterminados si no se han fijado}. En el
+caso de @code{staff-staff-spacing}, el valor de cualquier clave no
+fijada se reiniciaría a cero (excepto @code{stretchability}, que
+toma el valor de @code{basic-distance} si no se fija). Así, las
+dos declaraciones siguientes son equivalentes:
@example
\override StaffGrouper.staff-staff-spacing =
Una consecuencia de esto (posiblemente no intencionada) es la
eliminación de cualquier valor estándar que se establezca en un
-archivo de inicio y que se carga cada vez que se compila un archivo de
-entrada. En el ejemplo anterior, los ajustes estándar para
-@code{padding} y @code{minimum-distance} (definidos en
+archivo de inicio y que se carga cada vez que se compila un
+archivo de entrada. En el ejemplo anterior, los ajustes estándar
+para @code{padding} y @code{minimum-distance} (definidos en
@file{scm/define-grobs.scm}) se reinician a sus valores
-predeterminados si no se han fijado (cero para las dos claves). La
-definición de una propiedad o variable como una lista-A (de cualquier
-tamaño) siempre reinicia todos los valores de clave no establecidos a
-sus valores predeterminados si no se han fijado. Ano ser que este sea
-el resultado deseado, es más seguro actualizar los valores de clave
-individualmente con una declaración anidada.
-
-@warning{Las declaraciones anidadas no funcionan para las listas-A de
-propiedades de contexto (como @code{beamExceptions},
+predeterminados si no se han fijado (cero para las dos claves).
+La definición de una propiedad o variable como una lista-A (de
+cualquier tamaño) siempre reinicia todos los valores de clave no
+establecidos a sus valores predeterminados si no se han fijado.
+Ano ser que este sea el resultado deseado, es más seguro
+actualizar los valores de clave individualmente con una
+declaración anidada.
+
+@warning{Las declaraciones anidadas no funcionan para las listas-A
+de propiedades de contexto (como @code{beamExceptions},
@code{keyAlterations}, @code{timeSignatureSettings}, etc.). Estas
propiedades sólo se pueden modificar redefiniéndolas completamente
como listas-A.}
* Modos de entrada::
* Dirección y posición::
* Distancias y medidas::
+* Dimensiones::
* Propiedades del símbolo del pentagrama::
* Objetos de extensión::
* Visibilidad de los objetos::
@translationof Input modes
La forma en que se interpreta la notación contenida dentro de un
-archivo de entrada, está determinada por el modo de entrada en curso.
+archivo de entrada, está determinada por el modo de entrada en
+curso.
-@strong{Modo de acordes}
+@subsubsubheading Modo de acordes
Se activa con la instrucción @code{\chordmode} y produce que la
-entrada se interprete con al sintaxis de la notación de acordes, véase
-@ref{Notación de acordes}. Los acordes se imprimen como notas sobre un
-pentagrama.
+entrada se interprete con al sintaxis de la notación de acordes,
+véase @ref{Notación de acordes}. Los acordes se imprimen como
+notas sobre un pentagrama.
El modo de acordes se activa también con la instrucción
-@code{\chords}. Esto crea también un contexto @code{ChordNames} nuevo
-y produce que el código que sigue se interprete con la sintaxis de la
-notación de acordes y se imprima como nombres de acorde dentro del
-contexto @code{ChordNames}, véase @ref{Impresión de los nombres de acorde}.
+@code{\chords}. Esto crea también un contexto @code{ChordNames}
+nuevo y produce que el código que sigue se interprete con la
+sintaxis de la notación de acordes y se imprima como nombres de
+acorde dentro del contexto @code{ChordNames}, véase @ref{Impresión
+de los nombres de acorde}.
-@strong{Modo de percusión}
+@subsubsubheading Modo de percusión
-Se activa con la instrucción @code{\drummode} y produce que el código
-de entrada se interprete con la sintaxis de la notación de percusión,
-véase @ref{Notación básica de percusión}.
+Se activa con la instrucción @code{\drummode} y produce que el
+código de entrada se interprete con la sintaxis de la notación de
+percusión, véase @ref{Notación básica de percusión}.
El modo de percusión también se activa con la instrucción
-@code{\drums}. También crea un contexto @code{DrumStaff} nuevo y hace
-que el código que sigue se interprete con la sintaxis de la notación
-de percusión y se imprima como símbolos de percusión sobre un
-pentagrama de percusión, véase @ref{Notación básica de percusión}.
+@code{\drums}. También crea un contexto @code{DrumStaff} nuevo y
+hace que el código que sigue se interprete con la sintaxis de la
+notación de percusión y se imprima como símbolos de percusión
+sobre un pentagrama de percusión, véase @ref{Notación básica de
+percusión}.
-@strong{Modo de cifras}
+@subsubsubheading Modo de cifras
Se activa con la instrucción @code{\figuremode} y hace que el código
de entrada se interprete con la sintaxis del bajo cifrado, véase
bajo cifrado dentro del contexto @code{FiguredBass}, véase
@ref{Introducción al bajo cifrado}.
-@strong{Modos de traste y tablatura}
+@subsubsubheading Modos de traste y tablatura
No existen modos de entrada especiales para introducir símbolos de
trastes y de tablatura.
modo de notas e imprímalos dentro de un contexto @code{TabStaff},
véase @ref{Tablaturas predeterminadas}.
-Para crear diagramas de trastes encima de un pentagrama, escríbalos
-como elementos de marcado encima de las notas utilizando la
-instrucción @code{\fret-diagram}, véase @ref{Marcas de diagramas de trastes}.
+Para crear diagramas de trastes encima de un pentagrama,
+escríbalos como elementos de marcado encima de las notas
+utilizando la instrucción @code{\fret-diagram}, véase @ref{Marcas
+de diagramas de trastes}.
-@strong{Modo de letra}
+@subsubsubheading Modo de letra
-Se activa con la instrucción @code{\lyricmode}, y hace que la entrada
-se interprete como sílabas de la letra de la canción con duraciones
-opcionales y modificadores de letra asociados, véase @ref{Música vocal}.
+Se activa con la instrucción @code{\lyricmode}, y hace que la
+entrada se interprete como sílabas de la letra de la canción con
+duraciones opcionales y modificadores de letra asociados, véase
+@ref{Música vocal}.
El modo de letra también se habilita con la instrucción
-@code{\addlyrics}. Esto también crea un contexto @code{Lyrics} nuevo
-y una instrucción @code{\lyricsto} implícita que asocia la letra que
-viene a continuación con la música precedente.
+@code{\addlyrics}. Esto también crea un contexto @code{Lyrics}
+nuevo y una instrucción @code{\lyricsto} implícita que asocia la
+letra que viene a continuación con la música precedente.
-@strong{Modo de marcado}
+@subsubsubheading Modo de marcado
-Se activa con la instrucción @code{\markup}, y hace que la entrada se
-interprete con la sintaxis del marcado, véase @ref{Text markup commands}.
+Se activa con la instrucción @code{\markup}, y hace que la entrada
+se interprete con la sintaxis del marcado, véase @ref{Text markup
+commands}.
-@c silly work-around for texinfo broken-ness
-@c (@strong{Note...} causes a spurious cross-reference in Info)
-@b{Modo de notas}
+@subsubsubheading Modo de notas
Es el modo predeterminado o se puede activar con la instrucción
@code{\notemode}. La entrada se interpreta como alturas, duraciones,
Normalmente no es necesario especificar el modo de notas de forma
explícita, pero puede ser útil hacerlo en ciertas situaciones, por
ejemplo si estamos en el modo de letra, en el modo de acordes o en
-otro modo y queremos insertar algo que solamente se puede hacer con la
-sintaxis del modo de notas.
-
-Por ejemplo, para insertar indicaciones dinámicas para las estrofas de
-una pieza coral es necesario entrar en el modo de notas para poder
-interpretar dichas indicaciones:
-
-@lilypond[verbatim,relative=2,quote]
-{ c4 c4 c4 c4 }
-\addlyrics {
- \notemode{\set stanza = \markup{ \dynamic f 1. } }
- To be sung loudly
-}
-\addlyrics {
- \notemode{\set stanza = \markup{ \dynamic p 2. } }
- To be sung quietly
-}
-@end lilypond
+otro modo y queremos insertar algo que solamente se puede hacer
+con la sintaxis del modo de notas.
@node Dirección y posición
@subsection Dirección y posición
@translationof Direction and placement
-Al tipografiar música, la dirección y colocación de muchos elementos
-es cuestión de elección. Por ejemplo, las plicas de las notas se
-pueden dirigir hacia arriba o hacia abajo; la letra, las indicaciones
-dinámicas y otras marcas expresivas se pueden colocar encima o debajo
-del pentagrama; el texto se pude alinear a la izquierda, a la derecha
-o centrado; etc. La mayoría de estas elecciones pueden dejarse que
-LilyPond las determine automáticamente, pero en ciertos casos puede
-ser deseable forzar una dirección o colocación concreta.
+Al tipografiar música, la dirección y colocación de muchos
+elementos es cuestión de elección. Por ejemplo, las plicas de las
+notas se pueden dirigir hacia arriba o hacia abajo; la letra, las
+indicaciones dinámicas y otras marcas expresivas se pueden colocar
+encima o debajo del pentagrama; el texto se pude alinear a la
+izquierda, a la derecha o centrado; etc. La mayoría de estas
+elecciones pueden dejarse que LilyPond las determine
+automáticamente, pero en ciertos casos puede ser deseable forzar
+una dirección o colocación concreta.
@menu
* Indicadores de dirección de las articulaciones::
@unnumberedsubsubsec Indicadores de dirección de las articulaciones
@translationof Articulation direction indicators
-De forma predeterminada algunas direcciones siempre son hacia arriba o
-siempre hacia abajo (p. ej. los matices o el calderón), mientras que
-otras cosas pueden alternar entre arriba y abajo en función de la
-dirección de las plicas (como las ligaduras o los acentos).
+De forma predeterminada algunas direcciones siempre son hacia
+arriba o siempre hacia abajo (p. ej. los matices o el calderón),
+mientras que otras cosas pueden alternar entre arriba y abajo en
+función de la dirección de las plicas (como las ligaduras o los
+acentos).
@c TODO Add table showing these
-Se puede sobreescribir la acción predeterminada mediante el prefijado
-de la articulación por un @emph{indicacor de dirección}. Están
-disponibles tres indicadores de dirección: @code{^} (que significa
-@qq{arriba}), @code{_} (que significa @qq{abajo}) o @code{-} (que
-significa @qq{usar la dirección predeterminada}). El indicador de
-dirección se puede normalmente omitir, en cuyo caso se supone el
-indicador predeterminado @code{-}, pero se necesita un indicador de
-dirección @strong{siempre} antes de:
+Se puede sobreescribir la acción predeterminada mediante el
+prefijado de la articulación por un @emph{indicacor de dirección}.
+Están disponibles tres indicadores de dirección: @code{^} (que
+significa @qq{arriba}), @code{_} (que significa @qq{abajo}) o
+@code{-} (que significa @qq{usar la dirección predeterminada}).
+El indicador de dirección se puede normalmente omitir, en cuyo
+caso se supone el indicador predeterminado @code{-}, pero se
+necesita un indicador de dirección @strong{siempre} antes de:
@itemize
@item las instrucciones @code{\tweak}
La posición o dirección de muchos objetos de presentación está
controlada por la propiedad @code{direction}.
-El valor de la propiedad @code{direction} se puede establecer al valor
-@code{1}, con el significado de @qq{hacia arriba} o @qq{encima}, o a
-@w{@code{-1}}, con el significado de @qq{hacia abajo} o @qq{debajo}.
-Se pueden usar los símbolos @code{UP} y @code{DOWN} en sustitución de
-@code{1} y @w{@code{-1}} respectivamente. La dirección predeterminada
-se puede especificar estableciendo @code{direction} a @code{0} ó a
-@code{CENTER}. De forma alternativa, en muchos casos existen
-instrucciones predefinidas para especificar la dirección. Todas ellas
-son de la forma:
+El valor de la propiedad @code{direction} se puede establecer al
+valor @code{1}, con el significado de @qq{hacia arriba} o
+@qq{encima}, o a @w{@code{-1}}, con el significado de @qq{hacia
+abajo} o @qq{debajo}. Se pueden usar los símbolos @code{UP} y
+@code{DOWN} en sustitución de @code{1} y @w{@code{-1}}
+respectivamente. La dirección predeterminada se puede especificar
+estableciendo @code{direction} a @code{0} ó a @code{CENTER}. De
+forma alternativa, en muchos casos existen instrucciones
+predefinidas para especificar la dirección. Todas ellas son de la
+forma:
@example
@code{\xxxUp}, @code{\xxxDown} o @code{\xxxNeutral}
@noindent
donde @code{\xxxNeutral} significa @qq{utilizar la dirección
-predeterminada}. Véase @rlearning{Objetos interiores al pentagrama}.
+predeterminada}. Véase @rlearning{Objetos interiores al
+pentagrama}.
-En alguna que otra ocasión como en el arpegio, el
-valor de la propiedad @code{direction} puede especificar si el objeto se debe
-colocar a la izquierda o a la derecha del objeto padre. En este caso
-@w{@code{-1}} ó @code{LEFT} significan @qq{a la izquierda} y @code{1}
-ó @code{RIGHT} significan @qq{a la derecha}. @code{0} ó @code{CENTER}
-significan @qq{utilizar la dirección predeterminada}.
+En alguna que otra ocasión como en el arpegio, el valor de la
+propiedad @code{direction} puede especificar si el objeto se debe
+colocar a la izquierda o a la derecha del objeto padre. En este
+caso @w{@code{-1}} ó @code{LEFT} significan @qq{a la izquierda} y
+@code{1} ó @code{RIGHT} significan @qq{a la derecha}. @code{0} ó
+@code{CENTER} significan @qq{utilizar la dirección
+predeterminada}.
-Estas indicaciones afectan a todas las notas hasta que son canceladas.
+Estas indicaciones afectan a todas las notas hasta que son
+canceladas.
@lilypond[verbatim,quote]
\relative {
}
@end lilypond
-En música polifónica, en general es mejor especificar una voz explícita
-que cambiar la dirección de un objeto. Para ver más información,
-véase @ref{Varias voces}.
+En música polifónica, en general es mejor especificar una voz
+explícita que cambiar la dirección de un objeto. Para ver más
+información, véase @ref{Varias voces}.
@seealso
Manual de aprendizaje:
@funindex \in
@funindex \pt
-Las distancias en LilyPond son de dos tipos: absolutas y escaladas.
-
-Las distancias absolutas se usan para especificar márgenes, sangrados
-y otros detalles de diseño de página, y de forma predeterminada se
-especifican en milímetros. Las distancias se pueden especificar en
-otras unidades escribiendo después de la cifra indicativa de la
-cantidad, @code{\mm}, @code{\cm}, @code{\in}@tie{}(pulgadas), o
-@code{\pt}@tie{}(puntos, 1/72.27 pulgadas). Las distancias de diseño
-de página se pueden especificar también en unidades escalables (véase
-el párrafo siguiente) adjuntando @code{\staff-space} a la cantidad.
-La disposición de página se describe en detalle en
-@ref{Disposición de la página}.
+Las distancias en LilyPond son de dos tipos: absolutas y
+escaladas.
+
+Las distancias absolutas se usan para especificar márgenes,
+sangrados y otros detalles de diseño de página, y de forma
+predeterminada se especifican en milímetros. Las distancias se
+pueden especificar en otras unidades escribiendo después de la
+cifra indicativa de la cantidad, @code{\mm}, @code{\cm},
+@code{\in}@tie{}(pulgadas), o @code{\pt}@tie{}(puntos, 1/72.27
+pulgadas). Las distancias de diseño de página se pueden
+especificar también en unidades escalables (véase el párrafo
+siguiente) adjuntando @code{\staff-space} a la cantidad. La
+disposición de página se describe en detalle en @ref{Disposición
+de la página}.
Las distancias escaladas siempre se especifican en unidades de un
-espacio del pentagrama o, más raramente, medio espacio del pentagrama.
-El espacio de pentagrama es la distancia entre dos líneas del
-pentagrama adyacentes. El valor predeterminado se puede cambiar
-globalmente fijando el tamaño global del pentagrama, o se puede
-sobreescribir localmente cambiando la propiedad @code{staff-space} del
-objeto @code{StaffSymbol}. Las distancias escaladas se escalan
-automáticamente con cualquier cambio al tamaño global del pentagrama o
-a la propiedad @code{staff-space} del objeto @code{StaffSymbol}, pero
-las fuentes tipográficas se escalan solamente con los cambios
-efectuados al tamaño global del pentagrama. Así, el tamaño global del
-pentagrama posibilita la fácil variación del tamaño general de una
-partitura impresa. Para ver los métodos de establecimiento del tamaño
-global del pentagrama, véase @ref{Establecer el tamaño del pentagrama}.
+espacio del pentagrama o, más raramente, medio espacio del
+pentagrama. El espacio de pentagrama es la distancia entre dos
+líneas del pentagrama adyacentes. El valor predeterminado se
+puede cambiar globalmente fijando el tamaño global del pentagrama,
+o se puede sobreescribir localmente cambiando la propiedad
+@code{staff-space} del objeto @code{StaffSymbol}. Las distancias
+escaladas se escalan automáticamente con cualquier cambio al
+tamaño global del pentagrama o a la propiedad @code{staff-space}
+del objeto @code{StaffSymbol}, pero las fuentes tipográficas se
+escalan solamente con los cambios efectuados al tamaño global del
+pentagrama. Así, el tamaño global del pentagrama posibilita la
+fácil variación del tamaño general de una partitura impresa. Para
+ver los métodos de establecimiento del tamaño global del
+pentagrama, véase @ref{Establecer el tamaño del pentagrama}.
@funindex magstep
-Si se necesita dibujar sólo una sección de una partitura a una escala
-distinta, por ejemplo una sección ossia o una nota al pie, no se puede
-simplemente cambiar el tamaño global del pentagrama porque esto
-afectaría a toda la partitura. En tales casos, el cambio de tamaño se
-hace sobreescribiendo tanto la propiedad @code{staff-space} de
-@code{StaffSymbol} como el tamaño de las fuentes tipográficas. Está a
-nuestra disposición una función de Scheme, @code{magstep}, para
-convertir de un cambio en el tamaño de la fuente al cambio equivalente
-en @code{staff-space}. Para ver una explicación y un ejemplo de su
-utilización, consulte @rlearning{Longitud y grosor de los objetos}.
+Si se necesita dibujar sólo una sección de una partitura a una
+escala distinta, por ejemplo una sección ossia o una nota al pie,
+no se puede simplemente cambiar el tamaño global del pentagrama
+porque esto afectaría a toda la partitura. En tales casos, el
+cambio de tamaño se hace sobreescribiendo tanto la propiedad
+@code{staff-space} de @code{StaffSymbol} como el tamaño de las
+fuentes tipográficas. Está a nuestra disposición una función de
+Scheme, @code{magstep}, para convertir de un cambio en el tamaño
+de la fuente al cambio equivalente en @code{staff-space}. Para
+ver una explicación y un ejemplo de su utilización, consulte
+@rlearning{Longitud y grosor de los objetos}.
@seealso
Manual de aprendizaje:
@ref{Establecer el tamaño del pentagrama}.
+@node Dimensiones
+@subsection Dimensiones
+@translationof Dimensions
+
+@cindex dimensiones
+@cindex caja circundante
+
+Las dimensiones de un objeto gráfico especifican las posiciones de
+los límites izquierdo y derecho, así como los límites inferior y
+superior de las cajas limítrofes de los objetos como distancias a
+partir del punto de referencia del objeto en unidades de espacios
+de pentagrama. Estas posiciones se codifican frecuentemente como
+dos parejas de valores de Scheme. Por ejemplo, la instrucción de
+marcado de texto @code{\with-dimensions} toma tres argumentos, de
+los cuales los dos primeros son una pareja de Scheme que da las
+posiiciones de los bordes izquierdo y derecho y otra pareja de
+Scheme que da las posiciones de los límites inferior y superior:
+
+@example
+\with-dimensions #'(-5 . 10) #'(-3 . 15) @var{arg}
+@end example
+
+Esto especifica una caja circundante para @var{arg} con su límite
+izquierdo en -5, su límite derecho en 10, el inferior en -3 y el
+superior e 15, todos ellos medidos a partir del punto de
+referencia del objeto en unidades de espacios de pentagrama.
+
+@seealso
+Referencia de la notación:
+@ref{Distancias y medidas}.
+
+
@node Propiedades del símbolo del pentagrama
@subsection Propiedades del símbolo del pentagrama
@translationof Staff symbol properties
@c is used in a snippet to thicken centre line.
@c If retained, add @ref to here in 1.6.2 -td
-Se puede definir al mismo tiempo la posición vertical de las líneas de
-la pauta y el número de líneas de la misma. Como muestra el siguiente
-ejemplo, las posiciones de las notas no están influidas por las
-posiciones de las líneas de la pauta.
+Se puede definir al mismo tiempo la posición vertical de las
+líneas de la pauta y el número de líneas de la misma. Como
+muestra el siguiente ejemplo, las posiciones de las notas no están
+influidas por las posiciones de las líneas de la pauta.
@warning{La propiedad @code{'line-positions} sobreescribe a la
-propiedad @code{'line-count}. El número de líneas de la pauta está
-definido implícitamente por el número de elementos de la lista de
-valores de @code{'line-positions}.}
+propiedad @code{'line-count}. El número de líneas de la pauta
+está definido implícitamente por el número de elementos de la
+lista de valores de @code{'line-positions}.}
@lilypond[verbatim,quote]
\new Staff \with {
\relative { a4 e' f b | d1 }
@end lilypond
-Se puede modificar la anchura de la pauta. Las unidades son espacios
-de pentagrama. El espaciado de los objetos dentro del pentagrama no
-resulta afectado por este ajuste.
+Se puede modificar la anchura de la pauta. Las unidades son
+espacios de pentagrama. El espaciado de los objetos dentro del
+pentagrama no resulta afectado por este ajuste.
@lilypond[verbatim,quote]
\new Staff \with {
Muchos objetos de notación musical abarcan varias notas o incluso
varios compases. Son ejemplos los crescendi, trinos, corchetes de
-grupo especial y corchetes de primera y segunda vez. Estos objetos se
-llaman @qq{spanners} u «objetos de extensión», y tienen propiedades
-especiales para controlar su apariencia y comportamiento. Algunas de
-estas propiedades son comunes a todos los objetos de extensión; otras
-se limitan a un subconjunto de los extensores.
+grupo especial y corchetes de primera y segunda vez. Estos
+objetos se llaman @qq{spanners} u «objetos de extensión», y tienen
+propiedades especiales para controlar su apariencia y
+comportamiento. Algunas de estas propiedades son comunes a todos
+los objetos de extensión; otras se limitan a un subconjunto de los
+extensores.
Todos los objetos de extensión contemplan el interface
-@code{spanner-interface}. Algunos, básicamente aquellos que trazan
-una línea recta entre los dos objetos, contemplan también el interface
-@code{line-spanner-interface}.
+@code{spanner-interface}. Algunos, básicamente aquellos que
+trazan una línea recta entre los dos objetos, contemplan también
+el interface @code{line-spanner-interface}.
@menu
* Uso del spanner-interface::
@end ignore
-@lilypond[verbatim,quote,relative=2]
-a~ a
-a
+@lilypond[verbatim,quote,fragment]
+a'~ a'
+a'
% increase the length of the tie
-\tweak minimum-length #5
-~ a
+~ a'
@end lilypond
-@lilypond[verbatim,quote,relative=2]
-a1
-\compressFullBarRests
-R1*23
-% increase the length of the rest bar
-\once \override MultiMeasureRest.minimum-length = #20
-R1*23
-a1
+@lilypond[verbatim,quote]
+\relative \compressMMRests {
+ a'1
+ R1*23
+ % increase the length of the rest bar
+ \once \override MultiMeasureRest.minimum-length = #20
+ R1*23
+ a1
+}
@end lilypond
-@lilypond[verbatim,quote,relative=2]
-a \< a a a \!
-% increase the length of the hairpin
-\override Hairpin.minimum-length = #20
-a \< a a a \!
+@lilypond[verbatim,quote]
+\relative {
+ a' \< a a a \!
+ % increase the length of the hairpin
+ \override Hairpin.minimum-length = #20
+ a \< a a a \!
+}
@end lilypond
-Esta sobreescritura se puede usar también para aumentar la longitud de
-las ligaduras de expresión y de fraseo:
+Esta sobreescritura se puede usar también para aumentar la
+longitud de las ligaduras de expresión y de fraseo:
@lilypond[verbatim,quote]
\relative {
@end lilypond
Para algunos objetos de presentación, la propiedad
-@code{minimum-length} es efectiva sólo si se llama explícitamente al
-procedimiento @code{set-spacing-rods}. Para hacerlo, se debe fijar la
-propiedad @code{springs-and-rods} al valor
-@code{ly:spanner::set-spacing-rods}. Por ejemplo, la longitud mínima
-de un glissando no tiene efecto a no ser que se establezca la
-propiedad @code{springs-and-rods}:
+@code{minimum-length} es efectiva sólo si se llama explícitamente
+al procedimiento @code{set-spacing-rods}. Para hacerlo, se debe
+fijar la propiedad @code{springs-and-rods} al valor
+@code{ly:spanner::set-spacing-rods}. Por ejemplo, la longitud
+mínima de un glissando no tiene efecto a no ser que se establezca
+la propiedad @code{springs-and-rods}:
@lilypond[verbatim,fragment,quote]
% default
La segunda propiedad útil del @code{spanner-interface} es
@code{to-barline}. De forma predeterminada tiene el valor cierto,
-haciendo que los reguladores y otros objetos de extensión que terminan
-sobre la primera nota de un compás, en vez de eso terminen en la línea
-divisoria inmediatamente precedente. Si se establece al valor falso,
-el extensor llegará más allá de la barra de compás y terminará
-exactamente sobre la nota:
+haciendo que los reguladores y otros objetos de extensión que
+terminan sobre la primera nota de un compás, en vez de eso
+terminen en la línea divisoria inmediatamente precedente. Si se
+establece al valor falso, el extensor llegará más allá de la barra
+de compás y terminará exactamente sobre la nota:
@lilypond[verbatim,quote]
\relative {
}
@end lilypond
-Esta propiedad no es efectiva para todos los extensores. Por ejemplo,
-su establecimiento a @code{#t} no tienen ningún efecto sobre las
-ligaduras de expresión o de fraseo, o sobre otros extensores para los
-que terminar en la barra de compás no tendría ningún significado.
+Esta propiedad no es efectiva para todos los extensores. Por
+ejemplo, su establecimiento a @code{#t} no tienen ningún efecto
+sobre las ligaduras de expresión o de fraseo, o sobre otros
+extensores para los que terminar en la barra de compás no tendría
+ningún significado.
@node Uso del line-spanner-interface
@unnumberedsubsubsec Uso del @code{line-spanner-interface}
@end itemize
La rutina responsable de dibujar los sellos de estos extensores es
-@code{ly:line-interface::print}. esta rutina determina la
-localización exacta de los dos puntos extremos y traza una línea entre
-ellos, en el estilo solicitado. Las posiciones de los dos puntos
-extremos del extensor se calculan al vuelo, pero es posible
+@code{ly:line-spanner::print}. esta rutina determina la
+localización exacta de los dos puntos extremos y traza una línea
+entre ellos, en el estilo solicitado. Las posiciones de los dos
+puntos extremos del extensor se calculan al vuelo, pero es posible
sobreescribir sus coordenadas Y. Las propiedades que se deben
especificar están anidadas a dos niveles de profundidad en la
jerarquía de propiedades, pero la sintaxis de la instrucción
Las unidades para la propiedad @code{Y} son @code{staff-space}s,
siendo el punto del cero la línea central del pentagrama. Para el
glissando, esto es el valor de @code{Y} en la coordenada X que
-corresponde al punto central de cada cabeza de nota si nos imaginamos
-que la línea se extiende hasta allí.
+corresponde al punto central de cada cabeza de nota si nos
+imaginamos que la línea se extiende hasta allí.
Si no está fijado @code{Y}, su valor se calcula a partir de la
-posición vertical del punto de anclaje correspondiente del extensor.
+posición vertical del punto de anclaje correspondiente del
+extensor.
En caso de salto de línea, los valores para los puntos extremos se
especifican por las sub-listas @code{left-broken} y
f''1
@end lilypond
-Un número de propiedades adicionales de las sub-listas @code{left} y
-@code{right} de la propiedad @code{bound-details} se pueden
+Un número de propiedades adicionales de las sub-listas @code{left}
+y @code{right} de la propiedad @code{bound-details} se pueden
especificar de la misma forma que @code{Y}:
@table @code
@item Y
Establece la coordenada Y del punto extremo, en desplazamientos de
-@code{staff-space}s desde la línea central del pentagrama. De forma
-predeterminada es el centro del objeto ancla, y así un glissando
-apunta al centro vertical de la cabeza de la nota.
+@code{staff-space}s desde la línea central del pentagrama. De
+forma predeterminada es el centro del objeto ancla, y así un
+glissando apunta al centro vertical de la cabeza de la nota.
Para extensores horizontales como los extensores de texto y los
trinos, está inamoviblemente codificado como 0.
@item attach-dir (dirección de anclaje)
Determina dónde comienza y termina la línea en la dirección X, con
-relación al objeto ancla. Sí, un valor de @w{@code{-1}} (o @code{LEFT},
-izquierda) hace que la línea comience o termine en el lado izquierdo
-de la cabeza de la nota a la que está anclado.
+relación al objeto ancla. Sí, un valor de @w{@code{-1}} (o
+@code{LEFT}, izquierda) hace que la línea comience o termine en el
+lado izquierdo de la cabeza de la nota a la que está anclado.
@item X
-Es la coordenada X absoluta del punto extremo. Se suele calcular al
-vuelo, y su sobreescritura no tiene un efecto útil.
+Es la coordenada X absoluta del punto extremo. Se suele calcular
+al vuelo, y su sobreescritura no tiene un efecto útil.
@item stencil (sello)
-Los extensores de línea pueden tener símbolos al comienzo o al final,
-lo que está contenido en esta sub-propiedad. Esto es para uso
-interno; se recomienda en su lugar el uso de @code{text}.
+Los extensores de línea pueden tener símbolos al comienzo o al
+final, lo que está contenido en esta sub-propiedad. Esto es para
+uso interno; se recomienda en su lugar el uso de @code{text}.
@item text (texto)
-Es un elemento de marcado que se evalúa para dar lugar al sello. Se
-usa para escribir @i{cresc.}, @i{tr} y otros textos sobre los objetos
-de extensión horizontales.
+Es un elemento de marcado que se evalúa para dar lugar al sello.
+Se usa para escribir @i{cresc.}, @i{tr} y otros textos sobre los
+objetos de extensión horizontales.
@lilypond[quote,ragged-right,fragment,verbatim]
\override TextSpanner.bound-details.left.text
@item stencil-align-dir-y (alineación del sello en y)
@item stencil-offset (desplazamiento del sello)
-Si no se modifican uno u otro, el sello se coloca sencillamente en el
-punto extremo, centrado sobre la línea, como viene definido por las
-subpropiedades @code{X} e @code{Y}. Si se fijan
+Si no se modifican uno u otro, el sello se coloca sencillamente en
+el punto extremo, centrado sobre la línea, como viene definido por
+las subpropiedades @code{X} e @code{Y}. Si se fijan
@code{stencil-align-dir-y} o @code{stencil-offset} se moverá el
-símbolo del borde verticalmente con relación al extremo de la línea:
+símbolo del borde verticalmente con relación al extremo de la
+línea:
@lilypond[quote,fragment,verbatim]
\override TextSpanner.bound-details.left.stencil-align-dir-y = #-2
\relative { c'4^\startTextSpan c c c \stopTextSpan }
@end lilypond
-Observe que los valores negativos mueven el texto @emph{hacia arriba},
-al contrario de lo que podría esperarse, pues el valor de @w{@code{-1}} o
-@code{DOWN} (abajo) significa alinear el borde @emph{inferior} del
-texto con la línea de extensión. Un valor de @code{1} o @code{UP}
-(arriba) alinea el borde superior del texto con la línea extensora.
+Observe que los valores negativos mueven el texto @emph{hacia
+arriba}, al contrario de lo que podría esperarse, pues el valor de
+@w{@code{-1}} o @code{DOWN} (abajo) significa alinear el borde
+@emph{inferior} del texto con la línea de extensión. Un valor de
+@code{1} o @code{UP} (arriba) alinea el borde superior del texto
+con la línea extensora.
@item arrow (flecha)
Al establecer esta sub-propiedad a @code{#t} se produce una punta de
@item padding (relleno)
Esta sub-propiedad controla el espacio entre el punto extremo
-especificado de la línea y el extremo real. Sin relleno, un glissando
-empezaría y terminaría en el centro de la cabeza de las notas.
+especificado de la línea y el extremo real. Sin relleno, un
+glissando empezaría y terminaría en el centro de la cabeza de las
+notas.
@end table
-La función musical @code{\endSpanners} finaliza de forma prematura el
-extensor que comienza sobre la nota que sigue inmediatamente a
+La función musical @code{\endSpanners} finaliza de forma prematura
+el extensor que comienza sobre la nota que sigue inmediatamente a
continuación. Se termina después de una nota exactamente, o en la
siguiente barra de compás si @code{to-barline} es verdadero y se
produce una divisoria antes de la siguiente nota.
}
@end lilypond
-Si se usa @code{\endSpanners} no es necesario cerrar \startTextSpan
-con \stopTextSpan, ni cerrar los reguladores con @code{\!}.
+Si se usa @code{\endSpanners} no es necesario cerrar
+\startTextSpan con \stopTextSpan, ni cerrar los reguladores con
+@code{\!}.
@seealso
Referencia de funcionamiento interno:
@cindex grobs, visibilidad de
@cindex visibilidad de los objetos
-Hay cuatro formas principales en que se puede controlar la visibilidad
-de los objetos de presentación: se puede eliminar su sello, se pueden
-volver transparentes, se pueden pintar de blanco, o se puede
-sobreescribir su propiedad @code{break-visibility}. Las tres primeras
-se aplican a todos los objetos de presentación; la última sólo a unos
-pocos: los objetos @emph{divisibles}. El Manual de aprendizaje
-introduce estas cuatro técnicas,
-véase @rlearning{Visibilidad y color de los objetos}.
+Hay cuatro formas principales en que se puede controlar la
+visibilidad de los objetos de presentación: se puede eliminar su
+sello, se pueden volver transparentes, se pueden pintar de blanco,
+o se puede sobreescribir su propiedad @code{break-visibility}.
+Las tres primeras se aplican a todos los objetos de presentación;
+la última sólo a unos pocos: los objetos @emph{divisibles}. El
+Manual de aprendizaje introduce estas cuatro técnicas, véase
+@rlearning{Visibilidad y color de los objetos}.
Hay también algunas otras técnicas que son específicas de ciertos
-objetos de presentación. Se estudian bajo Consideraciones especiales.
+objetos de presentación. Se estudian bajo Consideraciones
+especiales.
@menu
* Eliminar el sello::
@cindex sello, eliminar
@funindex \omit
-Todo objeto de presentación tiene una propiedad stencil (sello). De
-forma predeterminada está establecida a la función específica que
-dibuja ese objeto. Si se sobreescribe esta propiedad a @code{#f} no
-se llama a ninguna función y el objeto no se dibuja. La acción
-predeterminada se puede recuperar con @code{\revert}.
+Todo objeto de presentación tiene una propiedad stencil (sello).
+De forma predeterminada está establecida a la función específica
+que dibuja ese objeto. Si se sobreescribe esta propiedad a
+@code{#f} no se llama a ninguna función y el objeto no se dibuja.
+La acción predeterminada se puede recuperar con @code{\revert}.
@lilypond[quote,fragment,verbatim]
a1 a
a a a
@end lilypond
-Esta operación, bastante común, tiene la forma abreviada @code{\omit}
-como atajo:
+Esta operación, bastante común, tiene la forma abreviada
+@code{\omit} como atajo:
@lilypond[quote,fragment,verbatim]
a1 a
Todo objeto de presentación tiene una propiedad transparent
(transparente) que de forma predeterminada está establecida a
-@code{#f}. Si se fija a @code{#t} el objeto aún ocupa espacio pero es
-invisible.
+@code{#f}. Si se fija a @code{#t} el objeto aún ocupa espacio
+pero es invisible.
@lilypond[quote,fragment,verbatim]
a'4 a'
@cindex objetos, sobreescritura de
@cindex grobs, sobreescritura de
-Todo objeto de presentación tiene una propiedad de color que de forma
-predeterminada está establecida a @code{black} (negro). Si se
-sobreescribe a @code{white} (blanco) el objeto será indistinguible del
-fondo blanco. Sin embargo, si el objeto cruza a otros objetos, el
-color de los puntos de cruce queda determinado por el orden en que se
-dibujan estos objetos, lo que puede dejar una imagen fantasma del
-objeto blanco, como puede verse aquí:
+Todo objeto de presentación tiene una propiedad de color que de
+forma predeterminada está establecida a @code{black} (negro). Si
+se sobreescribe a @code{white} (blanco) el objeto será
+indistinguible del fondo blanco. Sin embargo, si el objeto cruza
+a otros objetos, el color de los puntos de cruce queda determinado
+por el orden en que se dibujan estos objetos, lo que puede dejar
+una imagen fantasma del objeto blanco, como puede verse aquí:
@lilypond[quote,fragment,verbatim]
\override Staff.Clef.color = #white
a'1
@end lilypond
-Se puede evitar esto cambiando el orden de impresión de los objetos.
-Todos los objetos de presentación tienen una propiedad @code{layer}
-(capa) que se debe establecer a un valor entero. Los objetos con el
-valor de @code{layer} más bajo se dibujan primero, después se dibujan
-los objetos con valores progresivamente mayores, y así los objetos con
-valores más altos se dibujan encima de los que tienen valores más
-bajos. De forma predeterminada, casi todos los objetos tienen
-asignado un valor @code{layer} de @code{1}, aunque algunos objetos,
-entre ellos el pentagrama y las líneas divisorias, @code{StaffSymbol}
-y @code{BarLine}, tienen asignado un calor de @code{0}. El orden de
-impresión de los objetos con el mismo valor de @code{layer} es
-indeterminado.
-
-En el ejemplo de arriba, la clave blanca, con un valor @code{layer}
-predeterminado de @code{1}, se dibuja después de las líneas del
-pentagrama (valor @code{layer} predeterminado de @code{0}),
-sobreimpresionándolas. Para cambiarlo, se debe dar al objeto
-@code{Clef} un valor de @code{layer} más bajo, digamos @w{@code{-1}},
-para que se dibuje antes:
+Se puede evitar esto cambiando el orden de impresión de los
+objetos. Todos los objetos de presentación tienen una propiedad
+@code{layer} (capa) que se debe establecer a un valor entero. Los
+objetos con el valor de @code{layer} más bajo se dibujan primero,
+después se dibujan los objetos con valores progresivamente
+mayores, y así los objetos con valores más altos se dibujan encima
+de los que tienen valores más bajos. De forma predeterminada,
+casi todos los objetos tienen asignado un valor @code{layer} de
+@code{1}, aunque algunos objetos, entre ellos el pentagrama y las
+líneas divisorias, @code{StaffSymbol} y @code{BarLine}, tienen
+asignado un calor de @code{0}. El orden de impresión de los
+objetos con el mismo valor de @code{layer} es indeterminado.
+
+En el ejemplo de arriba, la clave blanca, con un valor
+@code{layer} predeterminado de @code{1}, se dibuja después de las
+líneas del pentagrama (valor @code{layer} predeterminado de
+@code{0}), sobreimpresionándolas. Para cambiarlo, se debe dar al
+objeto @code{Clef} un valor de @code{layer} más bajo, digamos
+@w{@code{-1}}, para que se dibuje antes:
@lilypond[quote,fragment,verbatim]
\override Staff.Clef.color = #white
@cindex break-visibility
-Casi todos los objetos de presentación se imprimen una sola vez, pero
-algunos como las líneas divisorias, claves, indicaciones de compás y
-armaduras de tonalidad, se pueden tener que imprimir dos veces cuando
-se produce un salto de línea : una vez al final de la línea y otra al
-comienzo de la siguiente. Estos objetos reciben el nombre de
-@emph{divisibles}, y tienen una propiedad, @code{break-visibility}
-(visibilidad en el salto), para controlar su visibilidad en las tres
-posiciones en que pueden aparecer: al comienzo de una línea, dentro de
-la línea si se produce un cambio, y al final de la línea si el cambio
-se produce en ese lugar.
+Casi todos los objetos de presentación se imprimen una sola vez,
+pero algunos como las líneas divisorias, claves, indicaciones de
+compás y armaduras de tonalidad, se pueden tener que imprimir dos
+veces cuando se produce un salto de línea : una vez al final de la
+línea y otra al comienzo de la siguiente. Estos objetos reciben
+el nombre de @emph{divisibles}, y tienen una propiedad,
+@code{break-visibility} (visibilidad en el salto), para controlar
+su visibilidad en las tres posiciones en que pueden aparecer: al
+comienzo de una línea, dentro de la línea si se produce un cambio,
+y al final de la línea si el cambio se produce en ese lugar.
Por ejemplo, la indicación de compás se imprime de forma
-predeterminada al comienzo de la primera línea y en ningún otro lugar
-a no ser que cambie, en cuyo caso se imprime en el punto en que se
-produce el cambio. Si este cambio se produce al final de una línea,
-la nueva indicación de compás se imprime al principio de la línea
-siguiente y también al final de la línea anterior como indicación de
-precaución.
+predeterminada al comienzo de la primera línea y en ningún otro
+lugar a no ser que cambie, en cuyo caso se imprime en el punto en
+que se produce el cambio. Si este cambio se produce al final de
+una línea, la nueva indicación de compás se imprime al principio
+de la línea siguiente y también al final de la línea anterior como
+indicación de precaución.
Este comportamiento se controla por medio de la propiedad
@code{break-visibility}, que se explica en
@c Leave this ref on a newline - formats incorrectly otherwise -td
-@rlearning{Visibilidad y color de los objetos}. Esta propiedad toma un
-vector de tres valores booleanos que, por orden, determinan si el
-objeto se imprime al final, dentro, o al principio de la línea. O,
-para ser más exactos: antes del salto de línea, si no hay salto, o
-después del salto.
+@rlearning{Visibilidad y color de los objetos}. Esta propiedad
+toma un vector de tres valores booleanos que, por orden,
+determinan si el objeto se imprime al final, dentro, o al
+principio de la línea. O, para ser más exactos: antes del salto
+de línea, si no hay salto, o después del salto.
Como alternativa se puede especificar cualquiera de las ocho
-combinaciones mediante funciones predefinidas cuya definición está en
-@file{scm/output-lib.scm}, donde las tres últimas columnas indican si
-los objetos de presentación serán visibles en las posiciones que se
-muestran en el encabezamiento de cada columna:
+combinaciones mediante funciones predefinidas cuya definición está
+en @file{scm/output-lib.scm}, donde las tres últimas columnas
+indican si los objetos de presentación serán visibles en las
+posiciones que se muestran en el encabezamiento de cada columna:
-@multitable {@code{begin-of-line-invisible}} {@code{'#(#t #t #t)}} {Antes del} {Si no hay} {Después del}
+@multitable {@code{begin-of-line-invisible}} {@code{#(#t #t #t)}} {Antes del} {Si no hay} {Después del}
@headitem Forma @tab Forma @tab Antes del @tab Si no hay @tab Después del
@headitem de función @tab de vector @tab salto @tab salto @tab salto
-@item @code{all-visible} @tab @code{'#(#t #t #t)} @tab sí @tab sí @tab sí
-@item @code{begin-of-line-visible} @tab @code{'#(#f #f #t)} @tab no @tab no @tab sí
-@item @code{center-visible} @tab @code{'#(#f #t #f)} @tab no @tab sí @tab no
-@item @code{end-of-line-visible} @tab @code{'#(#t #f #f)} @tab sí @tab no @tab no
-@item @code{begin-of-line-invisible} @tab @code{'#(#t #t #f)} @tab sí @tab sí @tab no
-@item @code{center-invisible} @tab @code{'#(#t #f #t)} @tab sí @tab no @tab sí
-@item @code{end-of-line-invisible} @tab @code{'#(#f #t #t)} @tab no @tab sí @tab sí
-@item @code{all-invisible} @tab @code{'#(#f #f #f)} @tab no @tab no @tab no
+@item @code{all-visible} @tab @code{#(#t #t #t)} @tab sí @tab sí @tab sí
+@item @code{begin-of-line-visible} @tab @code{#(#f #f #t)} @tab no @tab no @tab sí
+@item @code{center-visible} @tab @code{#(#f #t #f)} @tab no @tab sí @tab no
+@item @code{end-of-line-visible} @tab @code{#(#t #f #f)} @tab sí @tab no @tab no
+@item @code{begin-of-line-invisible} @tab @code{#(#t #t #f)} @tab sí @tab sí @tab no
+@item @code{center-invisible} @tab @code{#(#t #f #t)} @tab sí @tab no @tab sí
+@item @code{end-of-line-invisible} @tab @code{#(#f #t #t)} @tab no @tab sí @tab sí
+@item @code{all-invisible} @tab @code{#(#f #f #f)} @tab no @tab no @tab no
@end multitable
-Los ajustes predeterminados de @code{break-visibility} dependen del
-objeto de presentación. La tabla siguiente muestra todos los objetos
-de presentación de interés que resultan afectados por
-@code{break-visibility} y el ajuste predeterminado de esta propiedad:
+Los ajustes predeterminados de @code{break-visibility} dependen
+del objeto de presentación. La tabla siguiente muestra todos los
+objetos de presentación de interés que resultan afectados por
+@code{break-visibility} y el ajuste predeterminado de esta
+propiedad:
@multitable @columnfractions .3 .3 .4
}
@end lilypond
-Aunque los tres componentes del vector utilizado para sobreescribir
-@code{break-visibility} deben estar presentes, no todos son efectivos
-para todos los objetos de presentación, y algunas combinaciones pueden
-incluso dar errores. Son de aplicación las siguientes limitaciones:
+Aunque los tres componentes del vector utilizado para
+sobreescribir @code{break-visibility} deben estar presentes, no
+todos son efectivos para todos los objetos de presentación, y
+algunas combinaciones pueden incluso dar errores. Son de
+aplicación las siguientes limitaciones:
@itemize @bullet
@item Las líneas divisorias no se pueden imprimir al principio de la línea.
@cindex clave, visibilidad después de un cambio explícito
@cindex explicitClefVisibility
-La propiedad @code{break-visibility} controla la visibilidad de las
-armaduras y cambios de clave sólo al principio de las líneas, es
-decir, después de un salto. No tiene ningún efecto sobre la
-visibilidad de la armadura o la clave después de un cambio explícito
-de tonalidad o de clave dentro o al final de una línea. En el ejemplo
-siguiente la armadura que sigue al cambio explícito de tonalidad a Si
-bemol mayor es visible incluso con @code{all-invisible} establecido.
+La propiedad @code{break-visibility} controla la visibilidad de
+las armaduras y cambios de clave sólo al principio de las líneas,
+es decir, después de un salto. No tiene ningún efecto sobre la
+visibilidad de la armadura o la clave después de un cambio
+explícito de tonalidad o de clave dentro o al final de una línea.
+En el ejemplo siguiente la armadura que sigue al cambio explícito
+de tonalidad a Si bemol mayor es visible incluso con
+@code{all-invisible} establecido.
@lilypond[quote,verbatim,ragged-right]
\relative {
}
@end lilypond
-La visibilidad de estos cambios explícitos de tonalidad y de clave se
-controla por medio de las propiedades
-@code{explicitKeySignatureVisibility} y @code{explicitClefVisibility}.
-Son los equivalentes de la propiedad @code{break-visibility} y las dos
-toman un vector de tres valores booleanos o las funciones predefinidas
-relacionadas anteriormente, exactamente igual que
-@code{break-visibility}. Las dos son propiedades del contexto Staff,
-no de los propios objetos de presentación, y por tanto se establecen
-utilizando la instrucción @code{\set}. Las dos están establecidas de
-forma predeterminada al valor @code{all-visible}. Estas propiedades
+La visibilidad de estos cambios explícitos de tonalidad y de clave
+se controla por medio de las propiedades
+@code{explicitKeySignatureVisibility} y
+@code{explicitClefVisibility}. Son los equivalentes de la
+propiedad @code{break-visibility} y las dos toman un vector de
+tres valores booleanos o las funciones predefinidas relacionadas
+anteriormente, exactamente igual que @code{break-visibility}. Las
+dos son propiedades del contexto Staff, no de los propios objetos
+de presentación, y por tanto se establecen utilizando la
+instrucción @code{\set}. Las dos están establecidas de forma
+predeterminada al valor @code{all-visible}. Estas propiedades
controlan sólo la visibilidad de las armaduras y las claves que
resultan de los cambios explícitos y no afectan a las armaduras y
-tonalidades que están al principio de las líneas; para quitarlas, aún
-se debe sobreescribir la propiedad @code{break-visibility} en el
-objeto correspondiente.
+tonalidades que están al principio de las líneas; para quitarlas,
+aún se debe sobreescribir la propiedad @code{break-visibility} en
+el objeto correspondiente.
@lilypond[quote,verbatim,ragged-right]
\relative {
@subsubsubheading Visibilidad de las alteraciones de precaución
-Para eliminar las alteraciones de cancelación que se imprimen en un
-cambio de tonalidad explícito, establezca la propiedad
+Para eliminar las alteraciones de cancelación que se imprimen en
+un cambio de tonalidad explícito, establezca la propiedad
@code{printKeyCancellation} del contexto Staff a @code{#f}:
@lilypond[quote,verbatim,ragged-right]
@end lilypond
Con estas sobreescrituras solamente permanecen las alteraciones
-accidentales delante de las notas para indicar el cambio de tonalidad.
+accidentales delante de las notas para indicar el cambio de
+tonalidad.
Observe que al modificar la tonalidad a Do@tie{}mayor o
La@tie{}menor, las alteraciones de cancelación serían @emph{la
@cindex automaticBars
@cindex líneas divisorias, eliminación
-Como caso especial, la impresión de las líneas divisorias también se
-puede inhabilitar estableciendo la propiedad @code{automaticBars} en
-el contexto Score. Si se fija a @code{#f}, las barras de compás no se
-imprimen automáticamente; se deben crear explícitamente con una
-instrucción @code{\bar}. A diferencia de la instrucción predefinida
-@code{\cadenzaOn}, los compases se siguen contando. La generación de
-compases continúa de acuerdo a esta cuenta si esta propiedad se
-establece posteriormente a @code{#t}. Si se fija al valor @code{#f},
-sólo pueden producirse saltos de línea en instrucciones @code{\bar}
+Como caso especial, la impresión de las líneas divisorias también
+se puede inhabilitar estableciendo la propiedad
+@code{automaticBars} en el contexto Score. Si se fija a
+@code{#f}, las barras de compás no se imprimen automáticamente; se
+deben crear explícitamente con una instrucción @code{\bar}. A
+diferencia de la instrucción predefinida @code{\cadenzaOn}, los
+compases se siguen contando. La generación de compases continúa
+de acuerdo a esta cuenta si esta propiedad se establece
+posteriormente a @code{#t}. Si se fija al valor @code{#f}, sólo
+pueden producirse saltos de línea en instrucciones @code{\bar}
explícitas.
@c TODO Add example
@translationof Line styles
Ciertas indicaciones de ejecución, p.ej., @i{rallentando},
-@i{accelerando} y los @i{trinos} se escriben como texto y se extienden
-sobre muchos compases mediante líneas, a veces punteadas u onduladas.
-
-Todos ellos usan las mismas rutinas que el glissando para dibujar los
-textos y las líneas, y por ello el ajuste fino de su comportamiento se
-hace de la misma manera. Se hace con un spanner (un objeto de
-extensión), y la rutina responsable de dibujar los objetos de
-extensión es @code{ly:line-interface::print}. Esta rutina determina la
-colocación exacta de los dos @i{extremos del objeto de extensión} y
-dibuja una línea entre ellos, en el estilo solicitado.
-
-He aquí un ejemplo de los distintos estilos de línea disponibles, y
-cómo aplicarles ajustes finos.
+@i{accelerando} y los @i{trinos} se escriben como texto y se
+extienden sobre muchos compases mediante líneas, a veces punteadas
+u onduladas.
+
+Todos ellos usan las mismas rutinas que el glissando para dibujar
+los textos y las líneas, y por ello el ajuste fino de su
+comportamiento se hace de la misma manera. Se hace con un spanner
+(un objeto de extensión), y la rutina responsable de dibujar los
+objetos de extensión es @code{ly:line-spanner::print}. Esta rutina
+determina la colocación exacta de los dos @i{extremos del objeto
+de extensión} y dibuja una línea entre ellos, en el estilo
+solicitado.
+
+He aquí un ejemplo de los distintos estilos de línea disponibles,
+y cómo aplicarles ajustes finos.
@lilypond[ragged-right,verbatim,quote]
\relative {
}
@end lilypond
-El valor de @code{Y} está establecido a @w{@code{-2}} para el extremo
-derecho. El lado izquierdo se puede ajustar de forma similar
-especificando @code{left} en vez de @code{right}.
+El valor de @code{Y} está establecido a @w{@code{-2}} para el
+extremo derecho. El lado izquierdo se puede ajustar de forma
+similar especificando @code{left} en vez de @code{right}.
Si no está establecido @code{Y}, el valor se computa a partir de la
posición vertical de los puntos de anclaje izquierdo y derecho del
extensor.
-Son posibles otros ajustes de los extensores, para ver más detalles
-consulte @ref{Objetos de extensión}.
+Son posibles otros ajustes de los extensores, para ver más
+detalles consulte @ref{Objetos de extensión}.
@node Rotación de objetos
@translationof Rotating objects
Tanto los objetos de presentación como los elementos de texto de
-marcado se pueden girar cualquier ángulo respecto a cualquier punto,
-pero difiere el método de hacerlo.
+marcado se pueden girar cualquier ángulo respecto a cualquier
+punto, pero difiere el método de hacerlo.
@menu
* Rotación de objetos de presentación::
Todos los objetos de presentación que contemplan el interface
@code{grob-interface} se pueden rotar estableciendo su propiedad
-@code{rotation}. Acepta una lista de tres elementos: el ángulo de la
-rotación en sentido antihorario, y las coordenadas x e y del punto con
-relación al punto de referencia del objeto, alrededor del que se va a
-realizar la rotación. El ángulo de rotación se especifica en grados
-y las coordenadas en espacios de pentagrama.
+@code{rotation}. Acepta una lista de tres elementos: el ángulo de
+la rotación en sentido antihorario, y las coordenadas x e y del
+punto con relación al punto de referencia del objeto, alrededor
+del que se va a realizar la rotación. El ángulo de rotación se
+especifica en grados y las coordenadas en espacios de pentagrama.
-El ángulo de rotación y las coordenadas del punto de rotación se deben
-determinar por ensayo y error.
+El ángulo de rotación y las coordenadas del punto de rotación se
+deben determinar por ensayo y error.
@cindex reguladores en ángulo
@cindex ángulo, reguladores en
Solamente en ciertas ocasiones es útil la rotación de objetos de
-presentación; el ejemplo siguiente muestra una situación en que puede
-serlo:
+presentación; el ejemplo siguiente muestra una situación en que
+puede serlo:
@lilypond[quote,fragment,verbatim]
g4\< e' d'' f''\!
@unnumberedsubsubsec Rotación de elementos de marcado
@translationof Rotating markup
-Todos los textos de marcado se pueden rotar para que se dispongan en
-cualquier ángulo precediéndolos de la instrucción @code{\rotate}. La
-instrucción acepta dos argumentos: el ángulo de rotación en grados en
-sentido antihorario, y el texto que rotar. Los límites que ocupa el
-texto no se rotan: toman su valor a partir de los extremos de las
-coordenadas x e y del texto rotado. En el ejemplo siguiente la
-propiedad @code{outside-staff-priority} del texto se establece a
-@code{#f} para desactivar la evitación automática de colisiones, lo
-que empuja al texto a una posición muy alta.
+Todos los textos de marcado se pueden rotar para que se dispongan
+en cualquier ángulo precediéndolos de la instrucción
+@code{\rotate}. La instrucción acepta dos argumentos: el ángulo
+de rotación en grados en sentido antihorario, y el texto que
+rotar. Los límites que ocupa el texto no se rotan: toman su valor
+a partir de los extremos de las coordenadas x e y del texto
+rotado. En el ejemplo siguiente la propiedad
+@code{outside-staff-priority} del texto se establece a @code{#f}
+para desactivar la evitación automática de colisiones, lo que
+empuja al texto a una posición muy alta.
@lilypond[quote,fragment,verbatim]
\override TextScript.outside-staff-priority = ##f
@translationof Aligning objects
Los objetos gráficos que soportan el interface
-@code{self-alignment-interface} y/o el @code{side-position-interface}
-se pueden alinear contra un objeto colocado previamente, de diversas
-maneras. Para ver una lista de estos objetos, consulte
-@rinternals{self-alignment-interface} y
+@code{self-alignment-interface} y/o el
+@code{side-position-interface} se pueden alinear contra un objeto
+colocado previamente, de diversas maneras. Para ver una lista de
+estos objetos, consulte @rinternals{self-alignment-interface} y
@rinternals{side-position-interface}.
Todos los objetos gráficos tienen un punto de referencia, una
extensión horizontal y una extensión vertical. La extensión
horizontal es una pareja de números que dan los desplazamientos a
partir del punto de referencia de los bordes izquierdo y derecho,
-siendo negativos los desplazamientos hacia la izquierda. La extensión
-vertical es una pareja de números que dan el desplazamiento a partir
-del punto de referencia hasta los bordes inferior y superior, siendo
-negativos los desplazamientos hacia abajo.
+siendo negativos los desplazamientos hacia la izquierda. La
+extensión vertical es una pareja de números que dan el
+desplazamiento a partir del punto de referencia hasta los bordes
+inferior y superior, siendo negativos los desplazamientos hacia
+abajo.
La posición de un objeto sobre el pentagrama viene dada por los
valores de las propiedades @code{X-offset} e @code{Y-offset}. El
-valor de @code{X-offset} da el desplazamiento desde la coordenada X
-del punto de referencia del objeto padre, y el valor de
-@code{Y-offset} da el desplazamiento a partir de la línea central del
-pentagrama. Los valores de @code{X-offset} y @code{Y-offset} se
-pueden establecer directamente o se puede dejar que se calculen por
-parte de procedimientos para conseguir una alineación con el objeto
-padre.
+valor de @code{X-offset} da el desplazamiento desde la coordenada
+X del punto de referencia del objeto padre, y el valor de
+@code{Y-offset} da el desplazamiento a partir de la línea central
+del pentagrama. Los valores de @code{X-offset} y @code{Y-offset}
+se pueden establecer directamente o se puede dejar que se calculen
+por parte de procedimientos para conseguir una alineación con el
+objeto padre.
@warning{Muchos objetos tienen consideraciones de posicionamiento
especiales que hacen que se ignore o se modifique cualquier ajuste
realizado a @code{X-offset} o a @code{Y-offset}, a pesar de que el
objeto contemple el interface @code{self-alignment-interface}. La
-sobreescritura de las propiedades @code{X-offset} ó @code{Y-offset} a
-un valor fijo hace que se descarte la respectiva propiedad
-@code{self-alignment}.}
+sobreescritura de las propiedades @code{X-offset} ó
+@code{Y-offset} a un valor fijo hace que se descarte la respectiva
+propiedad @code{self-alignment}.}
Por ejemplo, una alteración accidental se puede reposicionar
verticalmente estableciendo @code{Y-offset} pero los cambios a
@code{X-offset} no tienen ningún efecto.
Las letras de ensayo se pueden alinear con objetos divisibles como
-líneas divisorias, claves, armaduras e indicaciones de compás. Hay
-propiedades especiales que se encuentran en
-@code{break-aligned-interface} para el posicionamiento de las letras
-de ensayo sobre dichos objetos.
+líneas divisorias, claves, armaduras e indicaciones de compás.
+Hay propiedades especiales que se encuentran en
+@code{break-aligned-interface} para el posicionamiento de las
+letras de ensayo sobre dichos objetos.
@seealso
Referencia de la notación:
@unnumberedsubsubsec Establecer directamente @code{X-offset} y @code{Y-offset}
@translationof Setting X-offset and Y-offset directly
-Se pueden dar valores numéricos a las propiedades @code{X-offset} y
-@code{Y-offset} de muchos objetos. El ejemplo siguiente muestra tres
-notas con una digitación en su posición predeterminada y con los
-valores @code{X-offset} y @code{Y-offset} modificados.
+Se pueden dar valores numéricos a las propiedades @code{X-offset}
+y @code{Y-offset} de muchos objetos. El ejemplo siguiente muestra
+tres notas con una digitación en su posición predeterminada y con
+los valores @code{X-offset} y @code{Y-offset} modificados.
@lilypond[verbatim,fragment,quote]
a'-3
@translationof Using the side-position-interface
Un objeto que contempla el @code{side-position-interface} se puede
-colocar junto a su objeto padre de forma que los bordes especificados
-de los dos objetos se toquen. El objeto se puede situar encima,
-debajo, a la derecha o a la izquierda del objeto padre. El padre no
-se puede especificar; viene determinado por el orden de los elementos
-en el flujo de entrada. Casi todos los objetos tienen la cabeza de la
-nota asociada como padre.
+colocar junto a su objeto padre de forma que los bordes
+especificados de los dos objetos se toquen. El objeto se puede
+situar encima, debajo, a la derecha o a la izquierda del objeto
+padre. El padre no se puede especificar; viene determinado por el
+orden de los elementos en el flujo de entrada. Casi todos los
+objetos tienen la cabeza de la nota asociada como padre.
Los valores de las propiedades @code{side-axis} y @code{direction}
determinan dónde colocar el objeto, como sigue:
@end multitable
-Si @code{side-axis} es @code{0}, @code{X-offset} se debe establecer al
-procedimiento @code{ly:side-position-interface::x-aligned-side}. Este
+Si @code{side-axis} es @code{0}, @code{X-offset} se debe
+establecer al procedimiento
+@code{ly:side-position-interface::x-aligned-side}. Este
procedimiento devuelve el calor correcto de @code{X-offset} para
-situar el objeto al lado izquierdo o derecho del padre de acuerdo con
-el valor de @code{direction}.
+situar el objeto al lado izquierdo o derecho del padre de acuerdo
+con el valor de @code{direction}.
-Si @code{side-axis} es @code{1}, @code{Y-offset} se debe establecer al
-procedimiento @code{ly:side-position-interface::y-aligned-side}. Este
+Si @code{side-axis} es @code{1}, @code{Y-offset} se debe
+establecer al procedimiento
+@code{ly:side-position-interface::y-aligned-side}. Este
procedimiento devuelve el valor correcto de @code{Y-offset} para
-situar el objeto encima o debajo del padre de acuerdo con el valor de
-@code{direction}.
+situar el objeto encima o debajo del padre de acuerdo con el valor
+de @code{direction}.
@c TODO Add examples
@code{self-alignment-interface} está controlada por el valor de la
propiedad @code{self-alignment-X}, siempre y cuando la propiedad
@code{X-offset} de este objeto esté establecida a
-@code{ly:self-alignment-interface::x-aligned-on-self}. Se le puede
-dar a @code{self-alignment-X} cualquier valor real, en unidades de la
-mitad de la extensión X total del objeto. Los valores negativos
-mueven el objeto a la derecha, los positivos hacia la izquierda. Un
-valor de @code{0} centra el objeto sobre el punto de referencia de su
-padre, un valor de @w{@code{-1}} alinea el borde izquierdo del objeto
-sobre el punto de referencia de su padre, y un valor de @code{1}
-alinea el borde derecho del objeto sobre el punto de referencia de su
-padre. Se pueden usar los símbolos @code{LEFT}, @code{CENTER} y
-@code{RIGHT} en sustitución de los valores @w{@code{-1}}, @code{0} y @code{1},
+@code{ly:self-alignment-interface::x-aligned-on-self}. Se le
+puede dar a @code{self-alignment-X} cualquier valor real, en
+unidades de la mitad de la extensión X total del objeto. Los
+valores negativos mueven el objeto a la derecha, los positivos
+hacia la izquierda. Un valor de @code{0} centra el objeto sobre
+el punto de referencia de su padre, un valor de @w{@code{-1}}
+alinea el borde izquierdo del objeto sobre el punto de referencia
+de su padre, y un valor de @code{1} alinea el borde derecho del
+objeto sobre el punto de referencia de su padre. Se pueden usar
+los símbolos @code{LEFT}, @code{CENTER} y @code{RIGHT} en
+sustitución de los valores @w{@code{-1}}, @code{0} y @code{1},
respectivamente.
-Normalmente se usaría la instrucción @code{\override} para modificar
-el valor de @code{self-alignment-X}, pero se puede usar la instrucción
-@code{\tweak} para alinear varias anotaciones por separado sobre una
-sola nota:
+Normalmente se usaría la instrucción @code{\override} para
+modificar el valor de @code{self-alignment-X}, pero se puede usar
+la instrucción @code{\tweak} para alinear varias anotaciones por
+separado sobre una sola nota:
@lilypond[quote,verbatim,fragment]
a'
Estableciendo tanto @code{X-offset} como @code{Y-offset}, se puede
alinear un objeto en las dos direcciones simultáneamente.
-El ejemplo siguiente muestra cómo ajustar una digitación de forma que
-se acerque a la cabeza de la nota.
+El ejemplo siguiente muestra cómo ajustar una digitación de forma
+que se acerque a la cabeza dela nota.
@lilypond[quote,verbatim,fragment]
a'
@cindex break-align-symbols
Las letras de ensayo se pueden alinear con objetos de notación
-distintos a las barras de compás. Estos objetos son @code{ambitus},
-@code{breathing-sign}, @code{clef}, @code{custos}, @code{staff-bar},
-@code{left-edge}, @code{key-cancellation}, @code{key-signature} y
-@code{time-signature}.
+distintos a las barras de compás. Estos objetos son
+@code{ambitus}, @code{breathing-sign}, @code{clef}, @code{custos},
+@code{staff-bar}, @code{left-edge}, @code{key-cancellation},
+@code{key-signature} y @code{time-signature}.
Cada tipo de objeto tiene su propio punto de referencia
predeterminado, con el que se alinean las marcas de ensayo:
\mark "↓"
@end lilypond
-Se puede especificar una lista de posibles objetos para la alineación.
-Si algunos de los objetos son invisibles en ese punto debido al valor
-de @code{break-visibility} o a valores de visibilidad explícitos para
-las armaduras y las claves, la letra de ensayo o número de compás se
-alinean con el primer objeto de la lista que sea visible. Si ningún
-objeto de la lista es visible, el objeto se alinea con la línea
-divisoria. Si la línea divisoria es invisible, el objeto se alinea
-con el punto en el que se encontraría la línea divisoria.
+Se puede especificar una lista de posibles objetos para la
+alineación. Si algunos de los objetos son invisibles en ese punto
+debido al valor de @code{break-visibility} o a valores de
+visibilidad explícitos para las armaduras y las claves, la letra
+de ensayo o número de compás se alinean con el primer objeto de la
+lista que sea visible. Si ningún objeto de la lista es visible,
+el objeto se alinea con la línea divisoria. Si la línea divisoria
+es invisible, el objeto se alinea con el punto en el que se
+encontraría la línea divisoria.
@lilypond[verbatim,quote,fragment]
% The rehearsal mark will be aligned to the right edge of the Key Signature
e'1
@end lilypond
-La alineación de la letra de ensayo con relación al objeto de notación
-se puede cambiar, como se ve en el ejemplo siguiente. En una
-partitura con varios pentagramas, este ajuste se debe hacer para todos
-los pentagramas.
+La alineación de la letra de ensayo con relación al objeto de
+notación se puede cambiar, como se ve en el ejemplo siguiente. En
+una partitura con varios pentagramas, este ajuste se debe hacer
+para todos los pentagramas.
@lilypond[verbatim,quote,fragment]
% The RehearsalMark will be aligned with the right edge of the Key Signature
@code{VerticalAxisGroup} trabajan de manera coordinada.
@code{VerticalAxisGroup} agrupa distintos grobs como @code{Staff},
@code{Lyrics}, etc. Después, @code{VerticalAlignment} alinea los
-distintos grobs agrupados previamente por @code{VerticalAxisGroup}.
-Normalmente sólo existe un @code{VerticalAlignment} por cada
-partitura, pero cada @code{Staff}, @code{Lyrics}, etc. tiene su propio
+distintos grobs agrupados previamente por
+@code{VerticalAxisGroup}. Normalmente sólo existe un
+@code{VerticalAlignment} por cada partitura, pero cada
+@code{Staff}, @code{Lyrics}, etc. tiene su propio
@code{VerticalAxisGroup}.
@subsection Modificación de los sellos
@translationof Modifying stencils
-Todos los objetos de presentación tienen una propiedad @code{stencil}
-que es parte del @code{grob-interface}. De forma predeterminada, esta
-propiedad suele estar establecida a una función específica del objeto
-que está hecha a medida para disponer el símbolo que lo representa en
-la salida. Por ejemplo, el ajuste estándar para la propiedad
-@code{stencil} del objeto @code{MultiMeasureRest} es
-@code{ly:multi-measure-rest::print}.
-
-El símbolo estándar de cualquier objeto se puede sustituir modificando
-la propiedad @code{stencil} para que haga referencia a un
-procedimiento diferente escrito especialmente. Esto requiere un alto
-nivel de conocimiento del funcionamiento interno de LilyPond, pero hay
-una forma más fácil que a menudo puede dar resultados adecuados.
+Todos los objetos de presentación tienen una propiedad
+@code{stencil} que es parte del @code{grob-interface}. De forma
+predeterminada, esta propiedad suele estar establecida a una
+función específica del objeto que está hecha a medida para
+disponer el símbolo que lo representa en la salida. Por ejemplo,
+el ajuste estándar para la propiedad @code{stencil} del objeto
+@code{MultiMeasureRest} es @code{ly:multi-measure-rest::print}.
+
+El símbolo estándar de cualquier objeto se puede sustituir
+modificando la propiedad @code{stencil} para que haga referencia a
+un procedimiento diferente escrito especialmente. Esto requiere
+un alto nivel de conocimiento del funcionamiento interno de
+LilyPond, pero hay una forma más fácil que a menudo puede dar
+resultados adecuados.
El procedimiento es establecer la propiedad @code{stencil} al
-procedimiento que imprime texto (@code{ly:text-interface::print}) y
-añadir una propiedad @code{text} al objeto ajustada para que contenga
-el texto de marcado que produce el símbolo requerido. Debido a la
-flexibilidad del marcado, se pueden conseguir muchas cosas; en
-particular, consulte @ref{Notación gráfica dentro de elementos de marcado}.
+procedimiento que imprime texto (@code{ly:text-interface::print})
+y añadir una propiedad @code{text} al objeto ajustada para que
+contenga el texto de marcado que produce el símbolo requerido.
+Debido a la flexibilidad del marcado, se pueden conseguir muchas
+cosas; en particular, consulte @ref{Notación gráfica dentro de
+elementos de marcado}.
-El ejemplo siguiente muestra esto cambiando el símbolo de la cabeza de
-la nota a unas aspas dentro de una circunferencia.
+El ejemplo siguiente muestra esto cambiando el símbolo de la
+cabeza de la nota a unas aspas dentro de una circunferencia.
@lilypond[verbatim,quote]
XinO = {
}
@end lilypond
-Cualquiera de los glifos de la fuente tipográfica Feta se puede pasar
-a la instrucción de marcado @code{\musicglyph}: véase @ref{La tipografía Feta}.
+Cualquiera de los glifos de la fuente tipográfica Feta se puede
+pasar a la instrucción de marcado @code{\musicglyph}: véase
+@ref{La tipografía Feta}.
@c TODO Add inserting eps files or ref to later
@cindex divididos, modificación de objetos de extensión
@funindex \alterBroken
-Cuando un @qq{spanner} u objeto extenso atraviesa uno o varios saltos
-de línea, cada fragmento hereda los atributos del objeto de extensión
-original. Así, el trucado ordinario de un objeto dividido aplica las
-mismas modificaciones a todos y cada uno de sus segmentos. En el
-ejemplo que aparece a continuación, la sobreescritura de
-@code{thickness} (grosor) afecta a la ligadura a ambos lados del salto
-de línea.
+Cuando un @qq{spanner} u objeto extenso atraviesa uno o varios
+saltos de línea, cada fragmento hereda los atributos del objeto de
+extensión original. Así, el trucado ordinario de un objeto
+dividido aplica las mismas modificaciones a todos y cada uno de
+sus segmentos. En el ejemplo que aparece a continuación, la
+sobreescritura de @code{thickness} (grosor) afecta a la ligadura a
+ambos lados del salto de línea.
@lilypond[verbatim,quote,ragged-right]
\relative c'' {
Es posible modificar de forma independiente el aspecto de los
fragmentos individuales de un objeto de extensión dividido, con la
-instrucción @code{\alterBroken}. Esta instrucción puede producir un
-@code{\override} o bien un @code{\tweak} de una propiedad del objeto
-de extensión.
+instrucción @code{\alterBroken}. Esta instrucción puede producir
+un @code{\override} o bien un @code{\tweak} de una propiedad del
+objeto de extensión.
La sintaxis de @code{\alterBroken} es
@end example
El argumento @var{valores} es una lista de valores, uno por cada
-fragmento. Si @var{elemento} el el nombre de un grob como @code{Slur}
-o @code{Staff.PianoPedalBracket}, el resultado es una instrucción de
-sobreescritura @code{\override} del tipo de grob especificado. Si
-@var{elemento} es una expresión musical como @qq{(} o @qq{[} el
-resultado es la misma expresión musical con el correspondiente truco
-aplicado.
+fragmento. Si @var{elemento} el el nombre de un grob como
+@code{Slur} o @code{Staff.PianoPedalBracket}, el resultado es una
+instrucción de sobreescritura @code{\override} del tipo de grob
+especificado. Si @var{elemento} es una expresión musical como
+@qq{(} o @qq{[} el resultado es la misma expresión musical con el
+correspondiente truco aplicado.
El guión inicial se debe utilizar con la forma de trucaje,
-@code{\tweak}. No lo escriba cuando utilice @code{\alterBroken} como
-una operación de sobreescritura, @code{\override}.
+@code{\tweak}. No lo escriba cuando utilice @code{\alterBroken}
+como una operación de sobreescritura, @code{\override}.
En su uso como @code{\override}, @code{\alterBroken} puede ir
precedido de @code{\once} o @code{\temporary} y ser revertido con
@code{\revert} con el argumento @var{propiedad}.
-EL código siguiente aplica un @code{\override} independiente a cada
-uno de los fragmentos de la ligadura del ejemplo anterior:
+EL código siguiente aplica un @code{\override} independiente a
+cada uno de los fragmentos de la ligadura del ejemplo anterior:
@lilypond[verbatim,quote,ragged-right]
\relative c'' {
}
@end lilypond
-La instrucción @code{\alterBroken} se puede usar con cualquier objeto
-de extensión, incluidos @code{Tie}, @code{PhrasingSlur}, @code{Beam} y
-@code{TextSpanner}. Por ejemplo, un editor que está preparando una
-edición académica podría desear indicar la ausencia de parte de una
-ligadura de fraseo en una fuente haciendo discontinuo solamente el
-segmento que se ha añadido. El siguiente ejemplo ilustra de qué
-manera se puede hacer esto, en este caso usando la forma @code{\tweak}
-de la instrucción:
+La instrucción @code{\alterBroken} se puede usar con cualquier
+objeto de extensión, incluidos @code{Tie}, @code{PhrasingSlur},
+@code{Beam} y @code{TextSpanner}. Por ejemplo, un editor que está
+preparando una edición académica podría desear indicar la ausencia
+de parte de una ligadura de fraseo en una fuente haciendo
+discontinuo solamente el segmento que se ha añadido. El siguiente
+ejemplo ilustra de qué manera se puede hacer esto, en este caso
+usando la forma @code{\tweak} de la instrucción:
@lilypond[verbatim,quote,ragged-right]
% The empty list is conveniently used below, because it is the
}
@end lilypond
-Es importante comprender que @code{\alterBroken} fija cada pieza del
-objeto fragmentado al valor correspondiente dentro del argumento
-@var{valores}. Cuando hay menos valores que piezas, cualquier
-fragmento adicional recibe la asignación de la lista vacía. Esto
-puede conllevar resultados no deseados si la propiedad de disposición
-no está establecida a la lista vacía de forma predeterminada. En
-estos casos, se debe asignar a cada segmento un valor adecuado.
+Es importante comprender que @code{\alterBroken} fija cada pieza
+del objeto fragmentado al valor correspondiente dentro del
+argumento @var{valores}. Cuando hay menos valores que piezas,
+cualquier fragmento adicional recibe la asignación de la lista
+vacía. Esto puede conllevar resultados no deseados si la
+propiedad de disposición no está establecida a la lista vacía de
+forma predeterminada. En estos casos, se debe asignar a cada
+segmento un valor adecuado.
@knownissues
-Los saltos de línea pueden ocurrir en distintos lugares según cambia
-la disposición de la música. Los ajustes elegidos para
+Los saltos de línea pueden ocurrir en distintos lugares según
+cambia la disposición de la música. Los ajustes elegidos para
@code{\alterBroken} podrían no ser adecuados para un objeto de
-extensión que ya no está dividido o que se fragmenta en más piezas que
-antes. El uso explícito (manual) de saltos de línea mediante
+extensión que ya no está dividido o que se fragmenta en más piezas
+que antes. El uso explícito (manual) de saltos de línea mediante
@code{\break} puede prevenir situaciones como ésta.
-La instrucción @code{\alterBroken} no es efectiva para propiedades de
-los objetos extensos accedidas antes del salto de línea, como
+La instrucción @code{\alterBroken} no es efectiva para propiedades
+de los objetos extensos accedidas antes del salto de línea, como
@code{direction}.
@seealso
@cindex no-puros: contenedores de Scheme
@cindex horizontal, sobreescribir el espaciado
-Los contenedores @q{unpure-pure} (pura y no pura) son útiles para la
-sobreescritura de los cálculos del espaciado en el @emph{eje Y}
-(concretamente @code{Y-offset} e @code{Y-extent}) con una función de
-Scheme en lugar de un literal, es decir, un número o una pareja de
-números.
-
-Para ciertos objetos gráficos, las dimensiones @code{Y-extent} están
-basadas en la propiedad @code{stencil}, la sobreescritura de la
-propiedad de sello de éstos requiere una sobreescritura adicional de
-@code{Y-extent} con un contenedor unpure-pure. Cuando una función
-sobreescribe una dimensión @code{Y-offset} y/o @code{Y-extent} se
-supone que esto dispara los cálculos de los saltos de línea
-prematuramente durante la compilación. Así pues, la función no se
-evalúa en absoluto (devolviendo por lo general un valor de @samp{0} o
-@samp{'(0 . 0)}) lo que puede dar lugar a colisiones. Una función
-@q{pura} no afecta a las propiedades, objetos o suicidios de grobs, y
-por ello siempre ven sus valores relacionados con el eje Y evaluados
-correctamente.
-
-Actualmente hay unas treinta funciones que ya se consideran @q{puras}
-y los contenedores Unpure-pure son una manera de establecer funciones
-que no están en esta lista como @q{puras}. La función @q{pura} se
-evalúa @emph{antes} de cualquier salto de línea y así el espaciado
-horizontal se puede ajustar @q{a tiempo}. La función @q{impura} se
-evalúa entonces @emph{después} del salto de línea.
-
-@warning{Dado que es difícil saber siempre qué funciones están en esta
-lista, recomendamos que cualquier función @q{pura} que estemos creando
-no utilice los grobs @code{Beam} o @code{VerticalAlignment}.}
+Los contenedores @q{unpure-pure} (pura y no pura) son útiles para
+la sobreescritura de los cálculos del espaciado en el @emph{eje Y}
+(concretamente @code{Y-offset} e @code{Y-extent}) con una función
+de Scheme en lugar de un literal, es decir, un número o una pareja
+de números.
+
+Para ciertos objetos gráficos, las dimensiones @code{Y-extent}
+están basadas en la propiedad @code{stencil}, la sobreescritura de
+la propiedad de sello de éstos requiere una sobreescritura
+adicional de @code{Y-extent} con un contenedor unpure-pure.
+Cuando una función sobreescribe una dimensión @code{Y-offset} y/o
+@code{Y-extent} se supone que esto dispara los cálculos de los
+saltos de línea prematuramente durante la compilación. Así pues,
+la función no se evalúa en absoluto (devolviendo por lo general un
+valor de @samp{0} o @samp{'(0 . 0)}) lo que puede dar lugar a
+colisiones. Una función @q{pura} no afecta a las propiedades,
+objetos o suicidios de grobs, y por ello siempre ven sus valores
+relacionados con el eje Y evaluados correctamente.
+
+Actualmente hay unas treinta funciones que ya se consideran
+@q{puras} y los contenedores Unpure-pure son una manera de
+establecer funciones que no están en esta lista como @q{puras}.
+La función @q{pura} se evalúa @emph{antes} de cualquier salto de
+línea y así el espaciado horizontal se puede ajustar @q{a tiempo}.
+La función @q{impura} se evalúa entonces @emph{después} del salto
+de línea.
+
+@warning{Dado que es difícil saber siempre qué funciones están en
+esta lista, recomendamos que cualquier función @q{pura} que
+estemos creando no utilice los grobs @code{Beam} o
+@code{VerticalAlignment}.}
Un contenedor @q{unpure-pure} se contruye de la manera siguiente:
primer argumento debe ser siempre el grob pero los argumentos segundo
y tercero son argumentos de @q{inicio} y de @q{final}.
-@var{inicio} y @var{final} son, a todos los efectos, valores mudos que
-sólo tienen importancia para los @code{objetos de extensión} (o sea:
-@code{Hairpin}, regulador, o @code{Beam}, barra), que pueden devolver
-distintas estimaciones de altura basadas en una columna de inicio y
-una de final.
+@var{inicio} y @var{final} son, a todos los efectos, valores mudos
+que sólo tienen importancia para los @code{objetos de extensión}
+(o sea: @code{Hairpin}, regulador, o @code{Beam}, barra), que
+pueden devolver distintas estimaciones de altura basadas en una
+columna de inicio y una de final.
-El resto son los otros argumentos para la primera función (que puede
-no ser ninguno si @var{n = 1}).
+El resto son los otros argumentos para la primera función (que
+puede no ser ninguno si @var{n = 1}).
El resultado de la segunda función se usa como una aproximación del
valor necesario, que se usa entonces por la primera función para
}
@end lilypond
-En el primer compás, sin el contenedor @emph{unpure-pure}, el motor de
-espaciado no conoce la anchura de la cabeza de la nota y permite que
-colisione con las alteraciones accidentales. En el segundo compás, el
-motor de espaciado conoce la anchura de las cabezas de las notas y
-evita la colisión mediante el alargamiento de la línea en la medida
-adecuada.
+En el primer compás, sin el contenedor @emph{unpure-pure}, el
+motor de espaciado no conoce la anchura de la cabeza de la nota y
+permite que colisione con las alteraciones accidentales. En el
+segundo compás, el motor de espaciado conoce la anchura de las
+cabezas de las notas y evita la colisión mediante el alargamiento
+de la línea en la medida adecuada.
Normalmente, para cálculos simples se pueden usar funciones casi
-idénticas tanto para las partes @q{no pura} y @q{pura}, simplemente
-cambiando el número de argumentos que se pasan a, y el ámbito de, la
-función.
+idénticas tanto para las partes @q{no pura} y @q{pura},
+simplemente cambiando el número de argumentos que se pasan a, y el
+ámbito de, la función. Este caso de utilización es lo bastante
+frecuente como para que @code{ly:make-unpure-pure-container}
+construya dicha segunda función de forma predeterminada cuando se
+llama con solo un argumento de función.
-@warning{Si una función está caracterizada como @q{pura} y resulta que
-no lo es, el resultado puede ser inesperado.}
+@warning{Si una función está caracterizada como @q{pura} y resulta
+que no lo es, el resultado puede ser inesperado.}
@node Uso de las funciones musicales
Dondequiera que se necesite reutilizar trucos con distintas
expresiones musicales, con frecuencia conviene hacer que el truco
forme parte de una @emph{función musical}. En esta sección
-estudiaremos solamente las funciones de @emph{sustitución}, en las que
-el objeto es sustituir una variable dentro de un fragmento de código
-de entrada de LilyPond. Se describen otras funciones más complejas en
-@rextend{Funciones musicales}.
+estudiaremos solamente las funciones de @emph{sustitución}, en las
+que el objeto es sustituir una variable dentro de un fragmento de
+código de entrada de LilyPond. Se describen otras funciones más
+complejas en @rextend{Funciones musicales}.
@menu
* Sintaxis de las funciones de sustitución::
@subsection Sintaxis de las funciones de sustitución
@translationof Substitution function syntax
-Es fácil hacer una función que sustituya una variable dentro de código
-de LilyPond. La forma general de estas funciones es
+Es fácil hacer una función que sustituya una variable dentro de
+código de LilyPond. La forma general de estas funciones es
@example
funcion =
@item @code{@var{@dots{}música@dots{}}}
@tab código de entrada normal de LilyPond, que utiliza @code{$} (en los
-lugares en que sólo se permiten construcciones de Lilypond) o @code{#}
-(para usarlo como un valor de Scheme o un argumento de función musical
-o música dentro de listas de música) para referenciar argumentos
-(p.ej. @samp{#arg1}).
+lugares en que sólo se permiten construcciones de Lilypond) o
+@code{#} (para usarlo como un valor de Scheme o un argumento de
+función musical o música dentro de listas de música) para
+referenciar argumentos (p.ej. @samp{#arg1}).
@end multitable
-Los argumentos @code{parser} y @code{location} son necesarios, y se
-utilizan en algunas situaciones avanzadas como se encuentra descrito
-en @rextend{Sintaxis de las funciones musicales}. Para las funciones
-de sustitución, tan sólo hemos de asegurarnos de incluirlos.
-
-También es necesaria la lista de predicados de tipo. Algunos de los
+Es necesaria la lista de predicados de tipo. Algunos de los
predicados de tipo más comunes que se utilizan en las funciones
musicales son:
@subsection Ejemplos de funciones de sustitución
@translationof Substitution function examples
-Esta sección presenta algunos ejemplos de funciones de sustitución.
-No pretenden ser exhaustivas, sino demostrar algunas de las
-posibilidades de las funciones de sustitución sencillas.
+Esta sección presenta algunos ejemplos de funciones de
+sustitución. No pretenden ser exhaustivas, sino demostrar algunas
+de las posibilidades de las funciones de sustitución sencillas.
-En el primer ejemplo se define una función que simplifica el ajuste
-del relleno de un elemento de inscripción de texto TextScript:
+En el primer ejemplo se define una función que simplifica el
+ajuste del relleno de un elemento de inscripción de texto
+TextScript:
@lilypond[quote,verbatim,ragged-right]
padText =
\relative { c'4 d e f \custosNote g }
@end lilypond
-Se pueden definir funciones de sustitución con más de un argumento:
+@funindex \etc
+Ambas funciones son expresiones únicas sencillas en las que solo
+falta el último elemento de una lamada de función o
+sobreescritura. Para estas definiciones de función en particular,
+existe una sintaxis alternativa más simple que consiste
+simplemente en escribir la parte constante de la expresión y
+sustituir el elemento final que falta por @code{\etc}:
+
+@lilypond[quote,verbatim,ragged-right]
+padText =
+ \once \override TextScript.padding = \etc
+
+\relative {
+ c''4^"piu mosso" b a b
+ \padText #1.8
+ c4^"piu mosso" b a b
+ \padText #2.6
+ c4^"piu mosso" b a b
+}
+@end lilypond
+
+@lilypond[quote,verbatim,ragged-right]
+custosNote =
+ \tweak NoteHead.stencil #ly:text-interface::print
+ \tweak NoteHead.text
+ \markup \musicglyph #"custodes.mensural.u0"
+ \tweak Stem.stencil ##f
+ \etc
+
+\relative { c'4 d e f \custosNote g }
+@end lilypond
+
+
+Se pueden definir funciones de sustitución con más de un
+argumento:
@lilypond[quote,verbatim,ragged-right]
tempoPadded =
@c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
@ignore
- Translation of GIT committish: 4cd16b30ea12e67d0c67c3e5663db113ae95db5f
+ Translation of GIT committish: dbe1fd47441d21aadd5669e9e69edfecb38ae45a
When revising a translation, copy the HEAD committish of the
version that you are working on. For details, see the Contributors'
* Lista de colores::
* La tipografía Feta::
* Estilos de cabezas de nota::
+* Estilos de clave::
* Instrucciones de marcado de texto::
* Instrucciones de listas de marcado de texto::
* Lista de caracteres especiales::
@appendixsec Modificadores de acorde más usuales
@translationof Common chord modifiers
-La tabla siguiente presenta los modificadores de acorde que se pueden
-usar para generar las estructuras de acordes estándar.
+La tabla siguiente presenta los modificadores de acorde que se
+pueden usar para generar las estructuras de acordes estándar.
@multitable @columnfractions .2 .25 .2 .15 .2
@appendixsec Afinaciones de cuerdas predefinidas
@translationof Predefined string tunings
-El cuadro de abajo muestra las afinaciones predefinidas de cuerdas.
+El cuadro de abajo muestra las afinaciones predefinidas de
+cuerdas.
@lilypondfile{display-predefined-string-tunings.ly}
@appendixsec Instrumentos MIDI
@translationof MIDI instruments
-A continuación figura una lista con los nombres que se pueden utilizar
-para la propiedad @code{midiInstrument} (instrumento MIDI). El orden
-de los instrumentos que aparece aquí, de arriba a abajo empezando por
-la columna de la izquierda, corresponde a los 128 números de programa
-del estándar General MIDI.
+A continuación figura una lista con los nombres que se pueden
+utilizar para la propiedad @code{midiInstrument} (instrumento
+MIDI). El orden de los instrumentos que aparece aquí, de arriba a
+abajo empezando por la columna de la izquierda, corresponde a los
+128 números de programa del estándar General MIDI.
@example
acoustic grand contrabass lead 7 (fifths)
@subsubheading Colores normales
-La sintaxis para el uso de colores se encuentra detallada en @ref{Colorear objetos}.
+La sintaxis para el uso de colores se encuentra detallada en
+@ref{Colorear objetos}.
@cindex lista de colores
@cindex colores, lista de
Los nombres de los colores de X admiten algunas variantes:
Un nombre que se escribe como una palabra única con mayúsculas
-intercaladas (p.ej. @q{LightSlateBlue}) se puede escribir también como
-palabras separadas por espacios y sin mayúsculas (p.ej. @q{light slate
-blue}).
+intercaladas (p.ej. @q{LightSlateBlue}) se puede escribir también
+como palabras separadas por espacios y sin mayúsculas
+(p.ej. @q{light slate blue}).
-La palabra @q{grey} siempre se puede escribir como @q{gray} (p.ej. @q{DarkSlateGray}).
+La palabra @q{grey} siempre se puede escribir como @q{gray}
+(p.ej. @q{DarkSlateGray}).
-Algunos nombres admiten un sufijo numérico (p.ej. @q{LightSalmon4}).
+Algunos nombres admiten un sufijo numérico
+(p.ej. @q{LightSalmon4}).
@subsubheading Nombres de los colores sin sufijo numérico:
@cindex Feta, tipografía
@cindex tipografía Feta
-Los símbolos siguientes están disponibles en la tipografía Emmentaler
-y es posible acceder a ellos directamente utilizando elementos de
-marcado textual con el nombre del glifo
-tal y como se muestra en las tablas de abajo,
-por ejemplo @code{g^\markup @{\musicglyph #"scripts.segno" @}} ó
-@code{\markup @{\musicglyph #"five"@}}. Para ver más información,
-consulte @ref{Formatear el texto}.
+Los símbolos siguientes están disponibles en la tipografía
+Emmentaler y es posible acceder a ellos directamente utilizando
+elementos de marcado textual con el nombre del glifo tal y como se
+muestra en las tablas de abajo, por ejemplo @code{g^\markup
+@{\musicglyph #"scripts.segno" @}} ó @code{\markup @{\musicglyph
+#"five"@}}. Para ver más información, consulte @ref{Formatear el
+texto}.
@menu
* Glifos de clave::
@translationof Note head styles
@cindex nota, estilos de cabeza
-Se pueden usar los siguientes estilos para las cabezas de las notas.
+Se pueden usar los siguientes estilos para las cabezas de las
+notas.
@lilypondfile[noindent]{note-head-style.ly}
+@node Estilos de clave
+@appendixsec Estilos de clave
+@translationof Clef styles
+
+La tabla siguiente presenta los distintos estilos de clave
+posibles y el lugar del @emph{Do central} en cada una.
+
+@multitable @columnfractions .30 .2 .30 .2
+
+@headitem
+Ejemplo
+@tab
+Salida
+@tab
+Ejemplo
+@tab
+Salida
+
+
+@item
+@code{\clef G}
+@tab
+@lilypond[line-width=3\cm,notime,ragged-right,relative=1]
+\clef G c1
+@end lilypond
+
+@tab
+@code{\clef "G2"}
+@tab
+@lilypond[line-width=3\cm,notime,ragged-right,relative=1]
+\clef "G2"
+c1
+@end lilypond
+
+@item
+@code{\clef treble}
+@tab
+@lilypond[line-width=3\cm,notime,ragged-right,relative=1]
+\clef treble
+c1
+@end lilypond
+
+@tab
+@code{\clef violin}
+@tab
+@lilypond[line-width=3\cm,notime,ragged-right,relative=1]
+\clef violin
+c1
+@end lilypond
+
+@item
+@code{\clef french}
+@tab
+@lilypond[line-width=3\cm,notime,ragged-right,relative=1]
+\clef french
+c1
+@end lilypond
+
+@tab
+@code{\clef GG}
+@tab
+@lilypond[line-width=3\cm,notime,ragged-right,relative=1]
+\clef GG
+c1
+@end lilypond
+
+@item
+@code{\clef tenorG}
+@tab
+@lilypond[line-width=3\cm,notime,ragged-right,relative=1]
+\clef tenorG
+c1
+@end lilypond
+
+@tab
+@code{\clef soprano}
+@tab
+@lilypond[line-width=3\cm,notime,ragged-right,relative=1]
+\clef soprano
+c1
+@end lilypond
+
+@item
+@code{\clef mezzosoprano}
+@tab
+@lilypond[line-width=3\cm,notime,ragged-right,relative=1]
+\clef mezzosoprano
+c1
+@end lilypond
+
+@tab
+@code{\clef C}
+@tab
+@lilypond[line-width=3\cm,notime,ragged-right,relative=1]
+\clef C
+c1
+@end lilypond
+
+@item
+@code{\clef alto}
+@tab
+@lilypond[line-width=3\cm,notime,ragged-right,relative=1]
+\clef alto
+c1
+@end lilypond
+
+@tab
+@code{\clef tenor}
+@tab
+@lilypond[line-width=3\cm,notime,ragged-right,relative=1]
+\clef tenor
+c1
+@end lilypond
+
+@item
+@code{\clef baritone}
+@tab
+@lilypond[line-width=3\cm,notime,ragged-right,relative=1]
+\clef baritone
+c1
+@end lilypond
+
+@tab
+@code{\clef varC}
+@tab
+@lilypond[line-width=3\cm,notime,ragged-right,relative=1]
+\clef varC
+c1
+@end lilypond
+
+@item
+@code{\clef altovarC}
+@tab
+@lilypond[line-width=3\cm,notime,ragged-right,relative=1]
+\clef altovarC
+c1
+@end lilypond
+
+@tab
+@code{\clef tenorvarC}
+@tab
+@lilypond[line-width=3\cm,notime,ragged-right,relative=1]
+\clef tenorvarC
+c1
+@end lilypond
+
+@item
+@code{\clef baritonevarC}
+@tab
+@lilypond[line-width=3\cm,notime,ragged-right,relative=1]
+\clef baritonevarC
+c1
+@end lilypond
+
+@tab
+@code{\clef varbaritone}
+@tab
+@lilypond[line-width=3\cm,notime,ragged-right,relative=1]
+\clef varbaritone
+c1
+@end lilypond
+
+@item
+@code{\clef baritonevarF}
+@tab
+@lilypond[line-width=3\cm,notime,ragged-right,relative=1]
+\clef baritonevarF
+c1
+@end lilypond
+
+@tab
+@code{\clef F}
+@tab
+@lilypond[line-width=3\cm,notime,ragged-right,relative=1]
+\clef F
+c1
+@end lilypond
+
+@item
+@code{\clef bass}
+@tab
+@lilypond[line-width=3\cm,notime,ragged-right,relative=1]
+\clef bass
+c1
+@end lilypond
+
+@tab
+@code{\clef subbass}
+@tab
+@lilypond[line-width=3\cm,notime,ragged-right,relative=1]
+\clef subbass
+c1
+@end lilypond
+
+@item
+@code{\clef percussion}
+@tab
+@lilypond[line-width=3\cm,notime,ragged-right,relative=1]
+\clef percussion
+c1
+@end lilypond
+
+@tab
+@c @example does not work as expected within multitables
+@code{
+\new TabStaff @{ @*
+@ @ \clef tab @*
+@}
+}
+@tab
+@lilypond[line-width=3\cm,notime,ragged-right,relative=1]
+\new TabStaff {
+ \clef tab
+ c1
+}
+@end lilypond
+
+@item
+@c @example does not work as expected within multitables
+@code{
+\new TabStaff @{ @*
+@ @ \clef moderntab @*
+@}
+}
+@tab
+@lilypond[line-width=3\cm,notime,ragged-right,relative=1]
+\new TabStaff {
+ \clef moderntab
+ c1
+}
+@end lilypond
+
+
+@end multitable
+
+
@node Instrucciones de marcado de texto
@appendixsec Instrucciones de marcado de texto
@translationof Text markup commands
@appendixsec Lista de caracteres especiales
@translationof List of special characters
-Se pueden usar las siguientes referencias a carcteres especiales; para
-ver más detalles, consulte @ref{Alias de ASCII}.
+Se pueden usar las siguientes referencias a carcteres especiales;
+para ver más detalles, consulte @ref{Alias de ASCII}.
Se usa la sintaxis del HTML y casi todas estas referencias son las
mismas que en el HTML. El resto están inspiradas en @LaTeX{}.
-Los caracteres están enmarcados en un rectángulo de forma que pueda
-verse el tamaño que tienen. Se ha añadido un pequeño relleno de
-separación entre el carácter y el rectángulo para mejorar la
+Los caracteres están enmarcados en un rectángulo de forma que
+pueda verse el tamaño que tienen. Se ha añadido un pequeño relleno
+de separación entre el carácter y el rectángulo para mejorar la
legibilidad.
@lilypond[quote]
@appendixsec Lista de articulaciones
@translationof List of articulations
-@cindex acento
-@cindex apagado
-@cindex arco abajo
-@cindex arco arriba
-@cindex calderón
-@cindex circulus
-@cindex coda
-@cindex downbow
-@cindex downmordent
-@cindex downprall
-@cindex espressivo
-@cindex fermata
-@cindex flageolet
-@cindex grupeto circular
-@cindex grupeto circular invertido
-@cindex halfopen
-@cindex ictus
-@cindex indicación de pulgar
-@cindex lheel
-@cindex lineprall
-@cindex longfermata
-@cindex ltoe
-@cindex marcas de pie
-@cindex marcato
-@cindex mordent
-@cindex open
-@cindex órgano, indicaciones de pedal de
-@cindex pedal, indicaciones de
-@cindex portato
-@cindex prall
-@cindex pralldown
-@cindex prallmordent
-@cindex prallprall
-@cindex prallup
-@cindex pulgar, indicación de
-@cindex reverseturn
-@cindex rheel
-@cindex rtoe
-@cindex segno
-@cindex semicirculus
-@cindex semitrino
-@cindex semitrino descendente
-@cindex shortfermata
-@cindex signumcongruentiae
-@cindex snappizzicato
-@cindex staccatissimo
-@cindex staccato
-@cindex tenuto
-@cindex trill
-@cindex trino
-@cindex upmordent
-@cindex upprall
-@cindex varcoda
-@cindex verylongfermata
-Las siguientes inscripciones están disponibles en la tipografía Feta y
-se pueden adjuntar a las notas (p.ej. @samp{c\accent}).
+Las listas siguientes relacionan todos los símbolos de la
+tipografía Feta que se pueden adjuntar a las notas
+(p. ej. @samp{f\accent} o @samp{f->}). Cada ejemplo muestra el
+símbolo en las posiciones @emph{superior}, @emph{inferior} y
+@emph{neutra}, respectivamente.
@c Articulations and ornamentations
@c Fingering instructions (for "thumb")
* Indicaciones antiguas::
@end menu
+@ignore
+The @multitable @columnfraction value discrepancy between the first and
+the remaining columns is deliberate; it seems (at least visually
+anyway) the gap (after building the documentation) between first and
+second column examples was always larger than between the remaining
+columns - JL
+@end ignore
+
+@cindex accent
+@cindex espressivo
+@cindex marcato
+@cindex portato
+@cindex staccatissimo
+@cindex staccato
+@cindex tenuto
+@cindex thumb
@node Indicaciones de articulación
@unnumberedsubsec Indicaciones de articulación
@translationof Articulation scripts
-@lilypond[quote]
-\include "script-chart.ly"
-\new RhythmicStaff { \scriptStaff #articulations }
+@multitable @columnfractions .22 .25 .25 .25
+
+@item
+@code{\accent} or @code{->}
+@lilypond[notime,relative=2]
+f^\accent e,_\accent b'\accent
+@end lilypond
+@tab
+@code{\espressivo}
+@lilypond[notime,relative=2]
+f^\espressivo e,_\espressivo b'\espressivo
+@end lilypond
+@tab
+@code{\marcato} or @code{-^}
+@lilypond[notime,relative=2]
+f^\marcato e,_\marcato b'\marcato
+@end lilypond
+@tab
+@code{\portato} or @code{-_}
+@lilypond[notime,relative=2]
+f^\portato e,_\portato b'\portato
@end lilypond
+@item
+@code{\staccatissimo} @* or @code{-!}
+@lilypond[notime,relative=2]
+f^\staccatissimo e,_\staccatissimo b'\staccatissimo
+@end lilypond
+@tab
+@code{\staccato} or @code{-.}
+@lilypond[notime,relative=2]
+f^\staccato e,_\staccato b'\staccato
+@end lilypond
+@tab
+@code{\tenuto} or @code{--}
+@lilypond[notime,relative=2]
+f^\tenuto e,_\tenuto b'\tenuto
+@end lilypond
+
+@end multitable
+
+@cindex prall
+@cindex prallup
+@cindex pralldown
+@cindex upprall
+@cindex downprall
+@cindex prallprall
+@cindex lineprall
+@cindex prallmordent
+@cindex mordent
+@cindex upmordent
+@cindex downmordent
+@cindex trill
+@cindex turn
+@cindex reverseturn
@node Indicaciones de adornos
@unnumberedsubsec Indicaciones de adornos
@translationof Ornament scripts
-@lilypond[quote]
-\include "script-chart.ly"
-\new RhythmicStaff { \scriptStaff #ornaments }
+@multitable @columnfractions .22 .25 .25 .25
+
+@item
+@code{\prall}
+@lilypond[notime,relative=2]
+f^\prall e,_\prall b'\prall
+@end lilypond
+@tab
+@code{\prallup}
+@lilypond[notime,relative=2]
+f^\prallup e,_\prallup b'\prallup
+@end lilypond
+@tab
+@code{\pralldown}
+@lilypond[notime,relative=2]
+f^\pralldown e,_\pralldown b'\pralldown
+@end lilypond
+@tab
+@code{\upprall}
+@lilypond[notime,relative=2]
+f^\upprall e,_\upprall b'\upprall
+@end lilypond
+
+@item
+@code{\downprall}
+@lilypond[notime,relative=2]
+f^\downprall e,_\downprall b'\downprall
+@end lilypond
+@tab
+@code{\prallprall}
+@lilypond[notime,relative=2]
+f^\prallprall e,_\prallprall b'\prallprall
+@end lilypond
+@tab
+@code{\lineprall}
+@lilypond[notime,relative=2]
+f^\lineprall e,_\lineprall b'\lineprall
+@end lilypond
+@tab
+@code{\prallmordent}
+@lilypond[notime,relative=2]
+f^\prallmordent e,_\prallmordent b'\prallmordent
+@end lilypond
+
+@item
+@code{\mordent}
+@lilypond[notime,relative=2]
+f^\mordent e,_\mordent b'\mordent
+@end lilypond
+@tab
+@code{\upmordent}
+@lilypond[notime,relative=2]
+f^\upmordent e,_\upmordent b'\upmordent
+@end lilypond
+@tab
+@code{\downmordent}
+@lilypond[notime,relative=2]
+f^\downmordent e,_\downmordent b'\downmordent
+@end lilypond
+@tab
+@code{\trill}
+@lilypond[notime,relative=2]
+f^\trill e,_\trill b'\trill
@end lilypond
+@item
+@code{\turn}
+@lilypond[notime,relative=2]
+f^\turn e,_\turn b'\reverseturn
+@end lilypond
+@tab
+@code{\reverseturn}
+@lilypond[notime,relative=2]
+f^\reverseturn e,_\reverseturn b'\reverseturn
+@end lilypond
+
+@end multitable
+
+@cindex fermata
+@cindex shortfermata
+@cindex longfermata
+@cindex verylongfermata
@node Indicaciones de calderón
@unnumberedsubsec Indicaciones de calderón
@translationof Fermata scripts
-@lilypond[quote]
-\include "script-chart.ly"
-\new RhythmicStaff { \scriptStaff #fermatas }
+@multitable @columnfractions .22 .25 .25 .25
+
+@item
+@code{\shortfermata}
+@lilypond[notime,relative=2]
+f^\shortfermata e,_\shortfermata b'\shortfermata
+@end lilypond
+@tab
+@code{\fermata}
+@lilypond[notime,relative=2]
+f^\fermata e,_\fermata b'\fermata
+@end lilypond
+@tab
+@code{\longfermata}
+@lilypond[notime,relative=2]
+f^\longfermata e,_\longfermata b'\longfermata
@end lilypond
+@tab
+@code{\verylongfermata}
+@lilypond[notime,relative=2]
+f^\verylongfermata e,_\verylongfermata b'\verylongfermata
+@end lilypond
+
+@end multitable
+@cindex upbow
+@cindex downbow
+@cindex flageolet
+@cindex open
+@cindex halfopen
+@cindex lheel
+@cindex rheel
+@cindex ltoe
+@cindex rtoe
+@cindex snappizzicato
+@cindex stopped
@node Indicaciones específicas de ciertos instrumentos
@unnumberedsubsec Indicaciones específicas de ciertos instrumentos
@translationof Instrument-specific scripts
-@lilypond[quote]
-\include "script-chart.ly"
-\new RhythmicStaff { \scriptStaff #instrument-specific }
+@multitable @columnfractions .22 .25 .25 .25
+
+@item
+@code{\upbow}
+@lilypond[notime,relative=2]
+f^\upbow e,_\upbow b'\upbow
+@end lilypond
+@tab
+@code{\downbow}
+@lilypond[notime,relative=2]
+f^\downbow e,_\downbow b'\downbow
+@end lilypond
+@tab
+@code{\flageolet}
+@lilypond[notime,relative=2]
+f^\flageolet e,_\flageolet b'\flageolet
+@end lilypond
+@tab
+@code{\open}
+@lilypond[notime,relative=2]
+f^\open e,_\open b'\open
@end lilypond
+@item
+@code{\halfopen}
+@lilypond[notime,relative=2]
+f^\halfopen e,_\halfopen b'\halfopen
+@end lilypond
+@tab
+@code{\lheel}
+@lilypond[notime,relative=2]
+f^\lheel e,_\lheel b'\lheel
+@end lilypond
+@tab
+@code{\rheel}
+@lilypond[notime,relative=2]
+f^\rheel e,_\rheel b'\rheel
+@end lilypond
+@tab
+@code{\ltoe}
+@lilypond[notime,relative=2]
+f^\ltoe e,_\ltoe b'\ltoe
+@end lilypond
+
+@item
+@code{\rtoe}
+@lilypond[notime,relative=2]
+f^\rtoe e,_\rtoe b'\rtoe
+@end lilypond
+@tab
+@code{\snappizzicato}
+@lilypond[notime,relative=2]
+f^\snappizzicato e,_\snappizzicato b'\snappizzicato
+@end lilypond
+@tab
+@code{\stopped} or @code{-+}
+@lilypond[notime,relative=2]
+f^\stopped e,_\stopped b'\stopped
+@end lilypond
+
+@end multitable
+
+@cindex segno
+@cindex coda
+@cindex varcoda
@node Indicaciones de repetición
@unnumberedsubsec Indicaciones de repetición
@translationof Repeat sign scripts
-@lilypond[quote]
-\include "script-chart.ly"
-\new RhythmicStaff { \scriptStaff #repeats }
+@multitable @columnfractions .22 .25 .25 .25
+
+@item
+@code{\segno}
+@lilypond[notime,relative=2]
+f^\segno e,_\segno b'\segno
+@end lilypond
+@tab
+@code{\coda}
+@lilypond[notime,relative=2]
+f^\coda e,_\coda b'\coda
+@end lilypond
+@tab
+@code{\varcoda}
+@lilypond[notime,relative=2]
+f^\varcoda e,_\varcoda b'\varcoda
@end lilypond
+@end multitable
+
+@cindex accentus
+@cindex circulus
+@cindex ictus
+@cindex semicirculus
+@cindex signumcongruentiae
@node Indicaciones antiguas
@unnumberedsubsec Indicaciones antiguas
@translationof Ancient scripts
-@lilypond[quote]
-\include "script-chart.ly"
+@multitable @columnfractions .22 .25 .25 .25
+
+@item
+@code{\accentus}
+@lilypond[notime]
+\include "gregorian.ly"
+\new VaticanaStaff { e'^\accentus s4 f_\accentus s4 b\accentus}
+@end lilypond
+@tab
+@code{\circulus}
+@lilypond[notime]
+\include "gregorian.ly"
+\new VaticanaStaff { e'^\circulus s4 f_\circulus s4 b\circulus }
+@end lilypond
+@tab
+@code{\ictus}
+@lilypond[notime]
+\include "gregorian.ly"
+\new VaticanaStaff { e'^\ictus s4 f_\ictus s4 b\ictus}
+@end lilypond
+
+@item
+@code{\semicirculus}
+@lilypond[notime]
\include "gregorian.ly"
-\new VaticanaStaff { \scriptStaffAncient #ancient }
+\new VaticanaStaff {
+ e'^\semicirculus s4 f_\semicirculus s4 b\semicirculus
+}
@end lilypond
+@tab
+@code{\signumcongruentiae}
+@lilypond[notime]
+\include "gregorian.ly"
+\new VaticanaStaff {
+ e'^\signumcongruentiae s4
+ f_\signumcongruentiae s4
+ b\signumcongruentiae
+}
+@end lilypond
+
+@end multitable
+@cindex drums, various
+@cindex acoustic bass
+@cindex bass
+@cindex snare
+@cindex electric snare
+@cindex acoustic snare
+@cindex tom tom
+@cindex bongo
+@cindex conga
+@cindex timbale
+@cindex sidestick
+@cindex floor tom tom
+@cindex low tom tom
+@cindex high tom tom
+@cindex mid tom tom
+@cindex high hat
+@cindex pedal high hat
+@cindex open high hat
+@cindex half-open high hat
+@cindex cymbal, various
+@cindex crash cymbal
+@cindex ride cymbal
+@cindex chinese cymbal
+@cindex splash cymbal
+@cindex ride bell
+@cindex cowbell
+@cindex agogo
+@cindex high bongo
+@cindex low bongo
+@cindex mute bongo
+@cindex open bongo
+@cindex high conga
+@cindex low conga
+@cindex mute conga
+@cindex open conga
+@cindex high timbale
+@cindex low timbale
+@cindex mute timbale
+@cindex open timbale
+@cindex sidestick
+@cindex guiro
+@cindex cabasa
+@cindex maracas
+@cindex whistle
+@cindex handclap
+@cindex tambourine
+@cindex vibraslap
+@cindex tam tam
+@cindex claves
+@cindex woodblock
+@cindex cuica
+@cindex triangle
@node Notas de percusión
@appendixsec Notas de percusión
@translationof Percussion notes
-@lilypondfile[quote]{percussion-chart.ly}
+@multitable @columnfractions .22 .25 .25 .25
+
+@item
+@code{bassdrum @* bd @*}
+@lilypond[notime,ragged-right]
+\drums { bd4 bd1 }
+@end lilypond
+@tab
+@code{acousticbassdrum @* bda @*}
+@lilypond[notime,ragged-right]
+\drums { bda4 bda1 }
+@end lilypond
+@tab
+@code{snare @* sn @*}
+@lilypond[notime,ragged-right]
+\drums { sn4 sn1 }
+@end lilypond
+@tab
+@code{acousticsnare @* sna @*}
+@lilypond[notime,ragged-right]
+\drums { sna4 sna1 }
+@end lilypond
+
+@item
+@code{electricsnare @* sne @*}
+@lilypond[notime,ragged-right]
+\drums { sne4 sne1 }
+@end lilypond
+@tab
+@code{lowfloortom @* tomfl @*}
+@lilypond[notime,ragged-right]
+\drums { tomfl4 tomfl1 }
+@end lilypond
+@tab
+@code{highfloortom @* tomfh @*}
+@lilypond[notime,ragged-right]
+\drums { tomfh4 tomfh1 }
+@end lilypond
+@tab
+@code{lowtom @* toml @*}
+@lilypond[notime,ragged-right]
+\drums { toml4 toml1 }
+@end lilypond
+
+@item
+@code{hightom @* tomh @*}
+@lilypond[notime,ragged-right]
+\drums { tomh4 tomh1 }
+@end lilypond
+@tab
+@code{lowmidtom @* tomml @*}
+@lilypond[notime,ragged-right]
+\drums { tomml4 tomml1 }
+@end lilypond
+@tab
+@code{highmidtom @* tommh @*}
+@lilypond[notime,ragged-right]
+\drums { tommh4 tommh1 }
+@end lilypond
+@tab
+@code{highhat @* hh @*}
+@lilypond[notime,ragged-right]
+\drums { hh4 hh1 }
+@end lilypond
+
+@item
+@code{closedhihat @* hhc @*}
+@lilypond[notime,ragged-right]
+\drums { hhc4 hhc1 }
+@end lilypond
+@tab
+@code{openhighhat @* hho @*}
+@lilypond[notime,ragged-right]
+\drums { hho4 hho1 }
+@end lilypond
+@tab
+@code{halfopenhihat @* hhho @*}
+@lilypond[notime,ragged-right]
+\drums { hhho4 hhho1 }
+@end lilypond
+@tab
+@code{pedalhihat @* hhp @*}
+@lilypond[notime,ragged-right]
+\drums { hhp4 hhp1 }
+@end lilypond
+
+
+@item
+@code{crashcymbal @* cymc @*}
+@lilypond[notime,ragged-right]
+\drums { cymc4 cymc1 }
+@end lilypond
+@tab
+@code{crashcymbala @* cymca @*}
+@lilypond[notime,ragged-right]
+\drums { cymca4 cymca1 }
+@end lilypond
+@tab
+@code{crashcymbalb @* cymcb @*}
+@lilypond[notime,ragged-right]
+\drums { cymcb4 cymcb1 }
+@end lilypond
+@tab
+@code{ridecymbal @* cymr @*}
+@lilypond[notime,ragged-right]
+\drums { cymr4 cymr1 }
+@end lilypond
+
+@item
+@code{ridecymbala @* cymra @*}
+@lilypond[notime,ragged-right]
+\drums { cymra4 cymra1 }
+@end lilypond
+@tab
+@code{ridecymbalb @* cymrb @*}
+@lilypond[notime,ragged-right]
+\drums { cymrb4 cymrb1 }
+@end lilypond
+@tab
+@code{chinesecymbal @* cymch @*}
+@lilypond[notime,ragged-right]
+\drums { cymch4 cymch1 }
+@end lilypond
+@tab
+@code{splashcymbal @* cyms @*}
+@lilypond[notime,ragged-right]
+\drums { cyms4 cyms1 }
+@end lilypond
+
+@item
+@code{ridebell @* rb @*}
+@lilypond[notime,ragged-right]
+\drums { rb4 rb1 }
+@end lilypond
+@tab
+@code{cowbell @* cb @*}
+@lilypond[notime,ragged-right]
+\drums { cb4 cb1 }
+@end lilypond
+@tab
+@code{hibongo @* boh @*}
+@lilypond[notime,ragged-right]
+\drums { boh4 boh1 }
+@end lilypond
+@tab
+@code{openhibongo @* boho @*}
+@lilypond[notime,ragged-right]
+\drums { boho4 boho1 }
+@end lilypond
+
+@item
+@code{mutehibongo @* bohm @*}
+@lilypond[notime,ragged-right]
+\drums { bohm4 bohm1 }
+@end lilypond
+@tab
+@code{lobongo @* bol @*}
+@lilypond[notime,ragged-right]
+\drums { bol4 bol1 }
+@end lilypond
+@tab
+@code{openlobongo @* bolo @*}
+@lilypond[notime,ragged-right]
+\drums { bolo4 bolo1 }
+@end lilypond
+@tab
+@code{mutelobongo @* bolm @*}
+@lilypond[notime,ragged-right]
+\drums { bolm4 bolm1 }
+@end lilypond
+
+
+@item
+@code{hiconga @* cgh @*}
+@lilypond[notime,ragged-right]
+\drums { cgh4 cgh1 }
+@end lilypond
+@tab
+@code{openhiconga @* cgho @*}
+@lilypond[notime,ragged-right]
+\drums { cgho4 cgho1 }
+@end lilypond
+@tab
+@code{mutehiconga @* cghm @*}
+@lilypond[notime,ragged-right]
+\drums { cghm4 cghm1 }
+@end lilypond
+@tab
+@code{loconga @* cgl @*}
+@lilypond[notime,ragged-right]
+\drums { cgl4 cgl1 }
+@end lilypond
+
+@item
+@code{openloconga @* cglo @*}
+@lilypond[notime,ragged-right]
+\drums { cglo4 cglo1 }
+@end lilypond
+@tab
+@code{muteloconga @* cglm @*}
+@lilypond[notime,ragged-right]
+\drums { cglm4 cglm1 }
+@end lilypond
+@tab
+@code{hitimbale @* timh @*}
+@lilypond[notime,ragged-right]
+\drums { timh4 timh1 }
+@end lilypond
+@tab
+@code{lotimbale @* timl @*}
+@lilypond[notime,ragged-right]
+\drums { timl4 timl1 }
+@end lilypond
+
+@item
+@code{hiagogo @* agh @*}
+@lilypond[notime,ragged-right]
+\drums { agh4 agh1 }
+@end lilypond
+@tab
+@code{loagogo @* agl @*}
+@lilypond[notime,ragged-right]
+\drums { agl4 agl1 }
+@end lilypond
+@tab
+@code{sidestick @* ss @*}
+@lilypond[notime,ragged-right]
+\drums { ss4 ss1 }
+@end lilypond
+@tab
+@code{hisidestick @* ssh @*}
+@lilypond[notime,ragged-right]
+\drums { ssh4 ssh1 }
+@end lilypond
+
+@item
+@code{losidestick @* ssl @*}
+@lilypond[notime,ragged-right]
+\drums { ssl4 ssl1 }
+@end lilypond
+@tab
+@code{guiro @* gui @*}
+@lilypond[notime,ragged-right]
+\drums { gui4 gui1 }
+@end lilypond
+@tab
+@code{shortguiro @* guis @*}
+@lilypond[notime,ragged-right]
+\drums { guis4 guis1 }
+@end lilypond
+@tab
+@code{longguiro @* guil @*}
+@lilypond[notime,ragged-right]
+\drums { guil4 guil1 }
+@end lilypond
+
+@item
+@code{cabasa @* cab @*}
+@lilypond[notime,ragged-right]
+\drums { cab4 cab1 }
+@end lilypond
+@tab
+@code{maracas @* mar @*}
+@lilypond[notime,ragged-right]
+\drums { mar4 mar1 }
+@end lilypond
+@tab
+@code{shortwhistle @* whs @*}
+@lilypond[notime,ragged-right]
+\drums { whs4 whs1 }
+@end lilypond
+@tab
+@code{longwhistle @* whl @*}
+@lilypond[notime,ragged-right]
+\drums { whl4 whl1 }
+@end lilypond
+
+@item
+@code{handclap @* hc @*}
+@lilypond[notime,ragged-right]
+\drums { hc4 hc1 }
+@end lilypond
+@tab
+@code{tambourine @* tamb @*}
+@lilypond[notime,ragged-right]
+\drums { tamb4 tamb1 }
+@end lilypond
+@tab
+@code{vibraslap @* vibs @*}
+@lilypond[notime,ragged-right]
+\drums { vibs4 vibs1 }
+@end lilypond
+@tab
+@code{tamtam @* tt @*}
+@lilypond[notime,ragged-right]
+\drums { tt4 tt1 }
+@end lilypond
+
+@item
+@code{claves @* cl @*}
+@lilypond[notime,ragged-right]
+\drums { cl4 cl1 }
+@end lilypond
+@tab
+@code{hiwoodblock @* wbh @*}
+@lilypond[notime,ragged-right]
+\drums { wbh4 wbh1 }
+@end lilypond
+@tab
+@code{lowoodblock @* wbl @*}
+@lilypond[notime,ragged-right]
+\drums { wbl4 wbl1 }
+@end lilypond
+@tab
+@code{opencuica @* cuio @*}
+@lilypond[notime,ragged-right]
+\drums { cuio4 cuio1 }
+@end lilypond
+
+@item
+@code{mutecuica @* cuim @*}
+@lilypond[notime,ragged-right]
+\drums { cuim4 cuim1 }
+@end lilypond
+@tab
+@code{triangle @* tri @*}
+@lilypond[notime,ragged-right]
+\drums { tri4 tri1 }
+@end lilypond
+@tab
+@code{opentriangle @* trio @*}
+@lilypond[notime,ragged-right]
+\drums { trio4 trio1 }
+@end lilypond
+@tab
+@code{mutetriangle @* trim}
+@lilypond[notime,ragged-right]
+\drums { trim4 trim1 }
+@end lilypond
+
+@item
+@code{oneup @* ua @*}
+@lilypond[notime,ragged-right]
+\drums { ua4 ua1 }
+@end lilypond
+@tab
+@code{twoup @* ub @*}
+@lilypond[notime,ragged-right]
+\drums { ub4 ub1 }
+@end lilypond
+@tab
+@code{threeup @* uc @*}
+@lilypond[notime,ragged-right]
+\drums { uc4 uc1 }
+@end lilypond
+@tab
+@code{fourup @* ud @*}
+@lilypond[notime,ragged-right]
+\drums { ud4 ud1 }
+@end lilypond
+
+@item
+@code{fiveup @* ue @*}
+@lilypond[notime,ragged-right]
+\drums { ue4 ue1 }
+@end lilypond
+@tab
+@code{onedown @* da @*}
+@lilypond[notime,ragged-right]
+\drums { da4 da1 }
+@end lilypond
+@tab
+@code{twodown @* db @*}
+@lilypond[notime,ragged-right]
+\drums { db4 db1 }
+@end lilypond
+@tab
+@code{threedown @* dc @*}
+@lilypond[notime,ragged-right]
+\drums { dc4 dc1 }
+@end lilypond
+
+@item
+@code{fourdown @* dd @*}
+@lilypond[notime,ragged-right]
+\drums { dd4 dd1 }
+@end lilypond
+@tab
+@code{fivedown @* de @*}
+@lilypond[notime,ragged-right]
+\drums { de4 de1 }
+@end lilypond
+
+
+@end multitable
@node Glosario técnico
* parser (analizador sintáctico)::
* variable del analizador sintáctico::
* prob (objeto de propiedades)::
-* cerradura simple::
* smob (objeto de Scheme)::
* stencil (sello)::
@end menu
@cindex lista de asociación
@cindex alist
-Una lista asociativa o abreviadamente una @strong{lista-A} (alist en
-inglés) es una pareja de Scheme que asocia un valor con una clave:
-@w{@code{(clave . valor)}}. Por ejemplo, en @file{scm/lily.scm}, la
-lista-A @w{@qq{type-p-name-alist}} asocia ciertos predicadps de tipo
-(p.ej.@tie{}@code{ly:music?}) con nombres (p.ej.@tie{}@qq{music}) de
-forma que se pueda informar de los fallos de comprobación de tipo con
-un mensaje de consola que incluye el nombre del predicado de tipo
-esperado.
+Una lista asociativa o abreviadamente una @strong{lista-A} (alist
+en inglés) es una pareja de Scheme que asocia un valor con una
+clave: @w{@code{(clave . valor)}}. Por ejemplo, en
+@file{scm/lily.scm}, la lista-A @w{@qq{type-p-name-alist}} asocia
+ciertos predicadps de tipo (p.ej.@tie{}@code{ly:music?}) con
+nombres (p.ej.@tie{}@qq{music}) de forma que se pueda informar de
+los fallos de comprobación de tipo con un mensaje de consola que
+incluye el nombre del predicado de tipo esperado.
@node callback
@cindex callback
-Una @strong{callback} es una rutina, función o método cuya referencia
-se pasa como argumento en una llamada a otra rutina, permitiendo así
-que la runtina llamada invoque a aquélla. La técnica permite que una
-capa de software de nivel más bajo llame a una función definida en una
-capa de nivel más alto. Las funciones de callback se usan ampliamente
-en LilyPond para permitir al código de Scheme del nivel de usuario
-definir cuántas acciones de bajo nivel se llevan a cabo.
+Una @strong{callback} es una rutina, función o método cuya
+referencia se pasa como argumento en una llamada a otra rutina,
+permitiendo así que la runtina llamada invoque a aquélla. La
+técnica permite que una capa de software de nivel más bajo llame a
+una función definida en una capa de nivel más alto. Las funciones
+de callback se usan ampliamente en LilyPond para permitir al
+código de Scheme del nivel de usuario definir cuántas acciones de
+bajo nivel se llevan a cabo.
@node closure (cerradura)
@translationof closure
@cindex cerradura
-@cindex cerradura simple
-
-En Scheme, se crea una @strong{cerradura} cuando una función, por lo
-general una expresión lambda, se pasa como variable. La cerradura
-contiene el codigo de la función y referencias a las ligaduras léxicas
-de las variables libres de la función (es decir, las variables que se
-usan en la expresión pero se definen fuera de ella). Cuando más tarde
-se aplica esta función a diferentes argumentos, las ligaduras de
-variables libres que se capturaron dentro de la cerradura se utilizan
-para obtener los valores de las variables libres que se usarán en el
-cálculo. Una propiedad útil de las cerraduras es la retención de los
-valores internos de las variables de una invocación a otra,
-permitiendo así que se pueda mantener un estado.
-
-Una @strong{cerradura simple} es una cerradura cuya expresión no tiene
-variables libres y por ello no tiene ligaduras de variables libres.
-Una cerradura simple se representa en LilyPond mediante un @q{smob}
-que contiene la expresión y un método para aplicar la expresión a la
-lista de argumentos que se le pasa.
+En Scheme, se crea una @strong{cerradura} cuando una función, por
+lo general una expresión lambda, se pasa como variable. La
+cerradura contiene el codigo de la función y referencias a las
+ligaduras léxicas de las variables libres de la función (es decir,
+las variables que se usan en la expresión pero se definen fuera de
+ella). Cuando más tarde se aplica esta función a diferentes
+argumentos, las ligaduras de variables libres que se capturaron
+dentro de la cerradura se utilizan para obtener los valores de las
+variables libres que se usarán en el cálculo. Una propiedad útil
+de las cerraduras es la retención de los valores internos de las
+variables de una invocación a otra, permitiendo así que se pueda
+mantener un estado.
@node glifo
@cindex tipografía
Un @strong{glifo} es una representación gráfica particular de un
-carácter tipográfico, o una combinación de dos caracteres que forman
-una ligadura. Un conjunto de glifos con un estilo y forma uniformes
-forman una fuente tipográfica, y un conjunto de fuentes tipográficas
-que abarcan varios estilos forman un tipo.
+carácter tipográfico, o una combinación de dos caracteres que
+forman una ligadura. Un conjunto de glifos con un estilo y forma
+uniformes forman una fuente tipográfica, y un conjunto de fuentes
+tipográficas que abarcan varios estilos forman un tipo.
@seealso
Referencia de la notación:
@cindex objetos de presentación
@cindex objetos gráficos
-Los objetos de LilyPond que representan elementos de la notación en la
-salida impresa tales como la cabeza y la plica de las notas, ligaduras
-de unión y de expresión, digitaciones, claves, et. se denominan
-@q{objetos de presentación}, a menudo conocidos como @q{OBjetos
-GRáficos}, o abreviadamente @strong{grobs}. Se representan mediante
-instancias de la clase @code{Grob}.
+Los objetos de LilyPond que representan elementos de la notación
+en la salida impresa tales como la cabeza y la plica de las notas,
+ligaduras de unión y de expresión, digitaciones, claves, et. se
+denominan @q{objetos de presentación}, a menudo conocidos como
+@q{OBjetos GRáficos}, o abreviadamente @strong{grobs}. Se
+representan mediante instancias de la clase @code{Grob}.
@seealso
Manual de aprendizaje:
@cindex propiedades inmutables
@cindex propiedades compartidas
-Un objeto @strong{inmutable} es aquél cuyo estado no se puede
+Un objeto @strong{inmutable} es aquel cuyo estado no se puede
modificar después de su creación, en contraste con los objetos
mutables, que se pueden modificar después de su creación.
En LilyPond, las propiedades inmutables o compartidas definen el
-estilo y comportamiento predeterminados de los grobs. Se comparten
-por parte de muchos objetos. En aparente contradicción con su nombre,
-se pueden cambiar utilizando @code{\override} y @code{\revert}.
+estilo y comportamiento predeterminados de los grobs. Se
+comparten por parte de muchos objetos. En aparente contradicción
+con su nombre, se pueden cambiar utilizando @code{\override} y
+@code{\revert}.
@seealso
Referencia de la notación:
@cindex interfaz de grob
@cindex interfaces de objetos gráficos
-Las acciones y propiedades comunes a un conjunto de grobs se agrupan
-en un objeto denominado @code{interfaz de grob (grob-inerface)}, o
-abreviadamente @q{interfaz}.
+Las acciones y propiedades comunes a un conjunto de grobs se
+agrupan en un objeto denominado @code{interfaz de grob
+(grob-inerface)}, o abreviadamente @q{interfaz}.
@seealso
Manual de aprendizaje:
@cindex analizador léxico
@cindex Flex
-Un @strong{lexer} o analizador léxico es un programa que convierte una
-secuencia de caracteres en una secuencia de elementos o tokens, en un
-proceso que se llama análisis léxico. El analizador léxico de
-LilyPond convierte el flujo obtenido a partir de un archivo de entrada
-@file{.ly} en un flujo descompuesto en tokens más apto para la
-siguiente fase del procesado: el análisis sintáctico, véase
-@ref{parser (analizador sintáctico)}. El analizador léxico de
-LilyPond lexer está construido con la herramienta Flex a partir del
-archivo de lexer @file{lily/lexer.ll} que contiene las reglas léxicas.
-Este archivo es parte del código fuente y no se incluye dentro de la
+Un @strong{lexer} o analizador léxico es un programa que convierte
+una secuencia de caracteres en una secuencia de elementos o
+tokens, en un proceso que se llama análisis léxico. El analizador
+léxico de LilyPond convierte el flujo obtenido a partir de un
+archivo de entrada @file{.ly} en un flujo descompuesto en tokens
+más apto para la siguiente fase del procesado: el análisis
+sintáctico, véase @ref{parser (analizador sintáctico)}. El
+analizador léxico de LilyPond lexer está construido con la
+herramienta Flex a partir del archivo de lexer
+@file{lily/lexer.ll} que contiene las reglas léxicas. Este
+archivo es parte del código fuente y no se incluye dentro de la
instalación binaria de LilyPond.
después de su creación, en contraste con un objeto inmutable, cuyo
estado se fija en el momento de la creación.
-En LilyPond, las propiedades mutables contienen valores específicos de
-un grob. Por lo general, las listas de otros objetos o los resultados
-de los cálculos se almacenan en propiedades mutables.
+En LilyPond, las propiedades mutables contienen valores
+específicos de un grob. Por lo general, las listas de otros
+objetos o los resultados de los cálculos se almacenan en
+propiedades mutables.
@seealso
Referencia de la notación:
Un @strong{parser} o analizador sintáctico analiza la secuencia de
tokens o elementos léxicos producida por un analizador léxico para
-determinar su estructura gramatical, agrupando los elementos léxicos
-en conjuntos mayores según las reglas de la gramática. Si la
-secuencia de elementos léxicos es válida, el producto final es un
-árbol de tokens cuya raíz es el símbolo inicial de la gramática. Si
-no se puede conseguir esto, el archivo es inválido y se produce un
-mensaje de error adecuado. Las agrupaciones sintácticas y las reglas
-para construir estas agrupaciones a partir de sus elementos
-constituyentes para la sintaxis de LilyPond están definidas en
-@file{lily/parser.yy} y se muestran en la forma normal de Backus (BNF)
-dentro de @rcontrib{LilyPond grammar}. Este archivo se usa para
-construir el analizador sintáctico durante la compilación del programa
-por parte del generador de analizadores sintácticos, Bison. Es parte
-del código fuente y no se incluye dentro de la instalación binaria de
+determinar su estructura gramatical, agrupando los elementos
+léxicos en conjuntos mayores según las reglas de la gramática. Si
+la secuencia de elementos léxicos es válida, el producto final es
+un árbol de tokens cuya raíz es el símbolo inicial de la
+gramática. Si no se puede conseguir esto, el archivo es inválido
+y se produce un mensaje de error adecuado. Las agrupaciones
+sintácticas y las reglas para construir estas agrupaciones a
+partir de sus elementos constituyentes para la sintaxis de
+LilyPond están definidas en @file{lily/parser.yy} y se muestran en
+la forma normal de Backus (BNF) dentro de @rcontrib{LilyPond
+grammar}. Este archivo se usa para construir el analizador
+sintáctico durante la compilación del programa por parte del
+generador de analizadores sintácticos, Bison. Es parte del código
+fuente y no se incluye dentro de la instalación binaria de
LilyPond.
@cindex showLastLength
@cindex showFirstLength
-Son variables definidas directamente dentro de Scheme. Su uso directo
-por parte de los usuarios está fuertemente desaconsejado, porque su
-semántica de ámbito puede ser confusa.
+Son variables definidas directamente dentro de Scheme. Su uso
+directo por parte de los usuarios está fuertemente desaconsejado,
+porque su semántica de ámbito puede ser confusa.
Cuando el valor de una de estas variables se modifica dentro de un
-archivo @file{.ly}, el cambio es global, y a no ser que se revierta
-explícitamente, el nuevo valor persistirá hasta el final del archivo,
-afectando a todos los bloques @code{\score} así como a los archivos
-externos añadidos con la instrucción @code{\include}. Esto puede
-conducir a consecuencias imprevistas y en proyectos de composición
-tipográfica complejos puede ser difícil de rastrear.
+archivo @file{.ly}, el cambio es global, y a no ser que se
+revierta explícitamente, el nuevo valor persistirá hasta el final
+del archivo, afectando a todos los bloques @code{\score} así como
+a los archivos externos añadidos con la instrucción
+@code{\include}. Esto puede conducir a consecuencias imprevistas
+y en proyectos de composición tipográfica complejos puede ser
+difícil de rastrear.
-LilyPond utiliza las siguientes variables del analizador sintáctico:
+LilyPond utiliza las siguientes variables del analizador
+sintáctico:
@itemize
@item afterGraceFraction
@cindex prob
Los OBjetos de PRopiedades, o abreviadamente @strong{probs}, son
-instancias de la clase @code{Prob}, que es una sencilla clase básica
-que tiene listas-A de propiedades mutables e inmutables y los métodos
-para manipularlas. Las clases @code{Music} y @code{Stream_event}
-derivan de @code{Prob}. También se crean instancias de la clase
-@code{Prob} para almacenar el contenido formateado de los grobs del
-sistema y los bloques de títulos durante el proceso de disposición de
-la página.
-
-
-@node cerradura simple
-@unnumberedsubsec cerradura simple
-@translationof simple closure
-
-Véase @ref{closure (cerradura)}.
+instancias de la clase @code{Prob}, que es una sencilla clase
+básica que tiene listas-A de propiedades mutables e inmutables y
+los métodos para manipularlas. Las clases @code{Music} y
+@code{Stream_event} derivan de @code{Prob}. También se crean
+instancias de la clase @code{Prob} para almacenar el contenido
+formateado de los grobs del sistema y los bloques de títulos
+durante el proceso de disposición de la página.
@node smob (objeto de Scheme)
@cindex smob
@cindex objeto de Scheme
-Los @strong{Smobs}, u OBjetos de ScheMe, forman parte del mecanismo
-utilizado por Guile para exportar objetos de C y de C++ al código de
-Scheme. En LilyPond, se crean smobs a partir de objetos de C++ por
-medio de macros. Hay dos tipos de objetos smob: los smobs simples,
-orientados a objetos inmutables simples como números, y los smobs
-complejos, usados para objetos con identidades. Si tiene acceso a las
-fuentes de LilyPond sources, encontrará más información en
-@file{lily/includes/smob.hh}.
+Los @strong{Smobs}, u OBjetos de ScheMe, forman parte del
+mecanismo utilizado por Guile para exportar objetos de C y de C++
+al código de Scheme. En LilyPond, se crean smobs a partir de
+objetos de C++ por medio de macros. Hay dos tipos de objetos
+smob: los smobs simples, orientados a objetos inmutables simples
+como números, y los smobs complejos, usados para objetos con
+identidades. Si tiene acceso a las fuentes de LilyPond sources,
+encontrará más información en @file{lily/includes/smob.hh}.
@node stencil (sello)
@cindex stencil
@cindex sello
-Las instancias de la clase @strong{stencil} contienen la información
-necesaria para imprimir un objeto tipográfico. Es un smob simple que
-contiene una caja de confinamiento, que a su vez define las
-dimensiones vertical y horizontal del objeto, y una expresión de
-Scheme que imprime el objeto cuendo se evalúa. Los stencils o sellos
-se pueden combinar para formar sellos más complejos definidos por un
-árbol de expresiones de Scheme formado a partir de las expresiones de
-Scheme de los sellos que lo componen.
+Las instancias de la clase @strong{stencil} contienen la
+información necesaria para imprimir un objeto tipográfico. Es un
+smob simple que contiene una caja de confinamiento, que a su vez
+define las dimensiones vertical y horizontal del objeto, y una
+expresión de Scheme que imprime el objeto cuendo se evalúa. Los
+stencils o sellos se pueden combinar para formar sellos más
+complejos definidos por un árbol de expresiones de Scheme formado
+a partir de las expresiones de Scheme de los sellos que lo
+componen.
-La propiedad @code{stencil}, que conecta a un grob con su sello, se
-define dentro del interfaz @code{grob-interface}.
+La propiedad @code{stencil}, que conecta a un grob con su sello,
+se define dentro del interfaz @code{grob-interface}.
@seealso
Referencia de funcionamiento interno:
@appendixsec Identificadores de modificación de contextos
@translationof Context modification identifiers
-Se definen las siguientes instrucciones
-para su uso como modificaciones de contexto dentro de un
-bloque @code{\layout} o @code{\with}.
+Se definen las siguientes instrucciones para su uso como
+modificaciones de contexto dentro de un bloque @code{\layout} o
+@code{\with}.
@include context-mod-identifiers.tely
@c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
@ignore
- Translation of GIT committish: fa12d929326daf49f84838a95b0570b32e4b3400
+ Translation of GIT committish: cca3c4542eded4f78aad08ed0928c368d7695e9a
When revising a translation, copy the HEAD committish of the
version that you are working on. For details, see the Contributors'
@lilypondfile[quote]{pitches-headword.ly}
-En esta sección se discute cómo especificar la altura de las notas.
-Este proceso se compone de tres fases: entrada, modificación y salida.
+En esta sección se discute cómo especificar la altura de las
+notas. Este proceso se compone de tres fases: entrada,
+modificación y salida.
@menu
* Escritura de notas::
@subsection Escritura de notas
@translationof Writing pitches
-En esta sección se describe la manera de introducir la altura de las
-notas. Existen dos formas distintas de colocar las notas en su octava
-correspondiente: el modo absoluto y el relativo. En casi todas las
-ocasiones, será más práctico el modo relativo.
+En esta sección se describe la manera de introducir la altura de
+las notas. Existen dos formas distintas de colocar las notas en
+su octava correspondiente: el modo absoluto y el relativo. En
+casi todas las ocasiones, será más práctico el modo relativo.
@menu
* Escritura de octava absoluta::
@cindex absoluta, introducción, de la octava
@cindex octava, introducción absoluta
-El nombre de una nota se especifica usando las letras minúsculas de la
-@code{a} a la @code{g}. Las notas cuyos nombres van desde @code{c}
-hasta @code{b} se imprimen en la octava inferior al Do central.
+El nombre de una nota se especifica usando las letras minúsculas
+de la @code{a} a la @code{g}. Las notas cuyos nombres van desde
+@code{c} hasta @code{b} se imprimen en la octava inferior al Do
+central.
@c don't use c' here.
@lilypond[verbatim,quote]
Se pueden especificar otras octavas mediante una comilla simple
quote@tie{}(@code{'}) o una coma@tie{}(@code{,}) .
-Cada@tie{}@code{'} eleva la altura en una octava; cada@tie{}@code{,}
-baja la altura una octava.
+Cada@tie{}@code{'} eleva la altura en una octava;
+cada@tie{}@code{,} baja la altura una octava.
@lilypond[verbatim,quote]
{
\clef treble
- c'4 c'' e' g
- d''4 d' d c
+ c'4 e' g' c''
+ c'4 g b c'
\clef bass
- c,4 c,, e, g
- d,,4 d, d c
+ c,4 e, g, c
+ c,4 g,, b,, c,
}
@end lilypond
-@funindex absolute
-@funindex \absolute
-Se puede indicar explícitamente que la música está en notación de
-octava absoluta si se precede con @code{\absolute}:
+@funindex fixed
+@funindex \fixed
+Las marcas de octava comunes se pueden escribir una sola vez sobre
+una nota de referencia si se emplea @code{\fixed} antes de la
+música. Las notas dentro de @code{\fixed} solo necesitan las
+marcas de apóstrofo @code{'} o de comoa @tie{}@code{,} cuando
+están por encima o por debajo de la octava de la nota de
+referencia.
-@example
-\absolute @var{musicexpr}
-@end example
+@lilypond[verbatim,quote]
+{
+ \fixed c' {
+ \clef treble
+ c4 e g c'
+ c4 g, b, c
+ }
+ \clef bass
+ \fixed c, {
+ c4 e g c'
+ c4 g, b, c
+ }
+}
+@end lilypond
-se interpreta en el modo de entrada de octava absoluta
-independientemende de en qué contexto aparece.
+La altura de las notas de la expresión musical que sigue a
+@code{\fixed} no reultan afectadas por un @code{\relative}
+circundante, que se estudia a continuación.
@seealso
Glosario musical:
\relative @var{altura_inicial} @var{expresión_musical}
@end example
-En el modo relativo, se supone que cada nota se encuentra lo más cerca
-posible de la nota anterior. Esto significa que la octava de una nota
-que está dentro de @code{@var{expresión_musical}} se calcula como sigue:
+En el modo relativo, se supone que cada nota se encuentra lo más
+cerca posible de la nota anterior. Esto significa que la octava
+de una nota que está dentro de @code{@var{expresión_musical}} se
+calcula como sigue:
@itemize
@item
-Si no se usa ninguna marca de cambio de octava en una nota, su octava
-se calcula de forma que el intervalo que forme con la nota anterior
-sea menor de una quinta. Este intervalo se determina sin considerar
-las alteraciones.
+Si no se usa ninguna marca de cambio de octava en una nota, su
+octava se calcula de forma que el intervalo que forme con la nota
+anterior sea menor de una quinta. Este intervalo se determina sin
+considerar las alteraciones.
@item
Se puede añadir una marca de cambio de octava@tie{}@code{'}
-o@tie{}@code{,} para elevar o bajar la altura, respectivamente, en una
-octava más en relación con la altura calculada sin esta marca.
+o@tie{}@code{,} para elevar o bajar la altura, respectivamente, en
+una octava más en relación con la altura calculada sin esta marca.
@item
Se pueden usar varias marcas de cambio de octava. Por ejemplo,
@item
La altura de la primera nota es relativa a
-@code{@var{altura_inicial}}. @code{@var{altura_inicial}} se especifica en
-modo de octava absoluta. ¿Qué opciones tienen sentido?
+@code{@var{altura_inicial}}. @code{@var{altura_inicial}} se
+especifica en modo de octava absoluta. ¿Qué opciones tienen
+sentido?
@table @asis
@item @code{c} (Do), en cualquier octava
como @code{\relative @{ gis''' @dots{} @}}
@item una nota que está una o más octavas de la primera nota de dentro
-Escribir @code{\relative @{ gis''' @dots{} @}} hace que sea
-fácil determinar la altura absoluta de la primera nota de dentro.
+Escribir @code{\relative @{ gis''' @dots{} @}} hace que sea fácil
+determinar la altura absoluta de la primera nota de dentro.
@item ninguna altura de inicio explícita
-Esta opción (concretamente, escribir @code{\relative @{ gis'''
-@dots{} @}}) se puede ver como una versión más compacta de la
-opción anterior: la primera nota de dentro se escribe ella misma
-en altura absoluta. Esto resulta ser equivalente a elegir
-@code{f} (Fa) como la altura de referencia.
+La forma @code{\relative @{ gis''' @dots{} @}} sirve como una
+versión más compacta de la opción anterior: la primera nota de
+dentro se escribe ella misma en altura absoluta (esto resulta ser
+equivalente a elegir @code{f} (Fa) como la altura de referencia).
@end table
-La documentación suele utilizar la primera opción.
+La documentación suele utilizar esta última opción.
@end itemize
Aquí podemos ver el modo relativo en acción:
}
@end lilypond
-Las marcas de cambio de octava se utilizan para intervalos mayores de
-la cuarta:
+Las marcas de cambio de octava se utilizan para intervalos mayores
+de la cuarta:
@lilypond[verbatim,quote]
\relative {
}
@end lilypond
-Una serie de notas sin ninguna marca de octava puede, a pesar de todo,
-abarcar intervalos muy grandes:
+Una serie de notas sin ninguna marca de octava puede, a pesar de
+todo, abarcar intervalos muy grandes:
@lilypond[verbatim,quote]
\relative {
}
@end lilypond
-Cuando hay unos bloques @code{\relative} anidados dentro de otros, es
-de aplicación el bloque @code{\relative} más interno.
+Cuando hay unos bloques @code{\relative} anidados dentro de otros,
+el bloque @code{\relative} más interno comienza con su propia nota
+de referencia independientemente del @code{\relative} exterior.
@lilypond[verbatim,quote]
\relative {
}
@end lilypond
-@code{\relative} no tiene efecto sobre los bloques @code{\chordmode}.
+@code{\relative} no tiene efecto sobre los bloques
+@code{\chordmode}.
@lilypond[verbatim,quote]
\new Staff {
@code{\relative} no se permite dentro de los bloques
@code{\chordmode}.
-La música que esa dentro de un bloque @code{\transpose} es absoluta, a
-no ser que se incluya una instrucción @code{\relative}.
+La música que esa dentro de un bloque @code{\transpose} es
+absoluta, a no ser que se incluya una instrucción
+@code{\relative}.
@lilypond[verbatim,quote]
\relative {
@cindex acordes e introducción relativa de la octava
@cindex relativa, introducción de la octava, y acordes
-Si el elemento anterior es un acorde, la primera nota del acorde se
-utiliza para determinar la primera nota del siguiente acorde. Dentro
-de los acordes, la siguiente nota siempre está en relación a la
-anterior.
+Si el elemento anterior es un acorde, la primera nota del acorde
+se utiliza para determinar la primera nota del siguiente acorde.
+Dentro de los acordes, la siguiente nota siempre está en relación
+a la anterior.
@lilypond[verbatim,quote]
\relative {
Como se explicó más arriba, la octava de las notas se calcula
solamente a partir de sus nombres, sin tener en cuenta alteración
alguna. Por tanto, un Mi doble sostenido después de un Si se
-escribirá más agudo, mientras que un Fa doble sostenido se escribirá
-más grave. En otras palabras, se considera a la cuarta doble
-aumentada un intervalo menor que la quinta doble disminuida,
+escribirá más agudo, mientras que un Fa doble sostenido se
+escribirá más grave. En otras palabras, se considera a la cuarta
+doble aumentada un intervalo menor que la quinta doble disminuida,
independientemente del número de semitonos de cada uno de ellos.
@lilypond[verbatim,quote]
}
@end lilypond
-Es una consecuencia de las reglas expuestas que la primera nota dentro
-de una expresión musical precedida de @code{@w{\relative f}} se
-interpreta igual que si estuviera escrita en el modo de altura
-absoluta.
@seealso
Glosario musical:
@c duplicated in Key signature and Accidentals
@warning{Las alteraciones accidentales y las armaduras son una
-frecuente causa de confusión para los nuevos usuarios. En LilyPond,
-los nombres de las notas son el código de entrada en bruto; la
-armadura y la clave determinan de qué forma se presenta este código en
-bruto. Una nota sin alteración como@tie{}@code{c} significa @q{Do
-natural}, si que le afecten la armadura ni la clave. Para ver más
-información, consulte @rlearning{Alteraciones accidentales y armaduras}.}
+frecuente causa de confusión para los nuevos usuarios. En
+LilyPond, los nombres de las notas especifican las alturas; la
+armadura y la clave determinan de qué forma se presentan estas
+alturas. Una nota sin alteración como@tie{}@code{c} significa
+@q{Do natural}, si que le afecten la armadura ni la clave. Para
+ver más información, consulte @rlearning{Alturas y armaduras}.}
@cindex notas, nombres holandeses de
@cindex notas, nombres predeterminados
@cindex becuadro
@cindex natural, nota
-Se escribe una nota @notation{sostenida} añadiendo @code{is} al nombre
-de la nota, y un @notation{bemol} añadiendo @code{es}. Como es de
-esperar, un @notation{dobles sostenido} y un @notation{doble bemol} se
-obtiene añadiendo @code{isis} o @code{eses}. Esta sintaxis deriva de
-los nombres de las notas en holandés. Para utilizar otros nombres
-para las alteraciones, consulte @ref{Nombres de las notas en otros idiomas}.
+Se escribe una nota @notation{sostenida} añadiendo @code{is} al
+nombre de la nota, y un @notation{bemol} añadiendo @code{es}.
+Como es de esperar, un @notation{dobles sostenido} y un
+@notation{doble bemol} se obtiene añadiendo @code{isis} o
+@code{eses}. Esta sintaxis deriva de los nombres de las notas en
+holandés. Para utilizar otros nombres para las alteraciones,
+consulte @ref{Nombres de las notas en otros idiomas}.
@lilypond[verbatim,quote,fragment]
\relative c'' { ais1 aes aisis aeses }
@end lilypond
-Un becuadro cancelará el efecto de una alteración accidental o de la
-armadura. Sin embargo, los becuadros no se codifican dentro de la
-sintaxis del nombre de la nota con un sufijo; una nota becuadro se
-muestra como un simple nombre de nota natural:
+Una nota natural se introduce como el nombre de la nota, sin más;
+no se necesita ningún sufijo. Se impirime un símbolo de becuadro
+si es necesario para cancelar el efecto de una alteración o
+armadura anterior.
@lilypond[verbatim,quote,fragment]
\relative c'' { a4 aes a2 }
@funindex ?
@funindex !
-Normalmente las alteraciones accidentales se imprimen automáticamente,
-pero también puede imprimirlas manualmente. Un alteración
-recordatoria se puede forzar añadiendo un signo de
-admiración@tie{}@code{!} después de la altura de la nota. Se puede
-obtener una alteración de precaución (o sea, una alteración entre
-paréntesis) añadiendo el signo de interrogación@tie{}@code{?} después
-del nombre de la nota. Estas alteraciones adicionales se pueden usar
-también para producir notas con becuadro.
+Normalmente las alteraciones accidentales se imprimen
+automáticamente, pero también puede imprimirlas manualmente. Un
+alteración recordatoria se puede forzar añadiendo un signo de
+admiración@tie{}@code{!} después de la altura de la nota. Se
+puede obtener una alteración de precaución (o sea, una alteración
+entre paréntesis) añadiendo el signo de
+interrogación@tie{}@code{?} después del nombre de la nota.
@lilypond[verbatim,quote,fragment]
\relative c'' { cis cis cis! cis? c c c! c? }
@cindex alteración en nota ligada
@cindex ligadura, alteraciones y
-Las alteraciones sobre notas unidas por ligadura sólo se imprimen al
-comienzo de un sistema:
+Las alteraciones sobre notas unidas por ligadura sólo se imprimen
+al comienzo de un sistema:
@lilypond[verbatim,quote,fragment,ragged-right]
\relative c'' {
@rglos{quarter tone}.
Manual de aprendizaje:
-@rlearning{Alteraciones accidentales y armaduras}.
+@rlearning{Alturas y armaduras}.
Referencia de la notación:
@ref{Alteraciones accidentales automáticas},
@cindex cuartos de tono, alteraciones
@knownissues
-No existen estándares reconocidos ampliamente para denotar
-los bemoles de tres cuartos, de manera que los símbolos de LilyPond
-no se ajustan a ningún estándar.
+No existen estándares reconocidos ampliamente para denotar los
+bemoles de tres cuartos, de manera que los símbolos de LilyPond no
+se ajustan a ningún estándar.
@node Nombres de las notas en otros idiomas
@cindex idioma, nombres de nota en otros
@cindex idioma, alturas en otros
-Existen conjuntos predefinidos de nombres de notas y sus alteraciones
-para algunos idiomas aparte del inglés. La selección del idioma de
-los nombres de las notas se suele hacer al principio del archivo; el
-ejemlo siguiente está escrito utilizando los nombres italianos de las
-notas:
+Existen conjuntos predefinidos de nombres de notas y sus
+alteraciones para algunos idiomas aparte del inglés. La selección
+del idioma de los nombres de las notas se suele hacer al principio
+del archivo; el ejemlo siguiente está escrito utilizando los
+nombres italianos de las notas:
@lilypond[quote,verbatim]
\language "italiano"
}
@end lilypond
-Los idiomas disponibles y los nombres de las notas que definen son los
-siguientes:
+Los idiomas disponibles y los nombres de las notas que definen son
+los siguientes:
@quotation
@multitable {@code{nederlands}} {do re mi fa sol la sib si}
@end multitable
@end quotation
-Además de los nombres de las notas, los sufijos de las alteraciones
-pueden también variar dependiendo del idioma:
+Además de los nombres de las notas, los sufijos de las
+alteraciones pueden también variar dependiendo del idioma:
@quotation
-@multitable {@code{nederlands}} {-s/-sharp} {-ess/-es} {-ss/-x/-sharpsharp} {-essess/-eses}
+@multitable {@code{nederlands}} {-@code{s}/-@code{-sharp}} {-@code{ess}/-@code{es}} {-@code{ss}/-@code{x}/-@code{-sharpsharp}} {-@code{essess}/-@code{eses}}
@headitem Idioma
@tab sostenido @tab bemol @tab doble sostenido @tab doble bemol
@item @code{nederlands}
- @tab -is @tab -es @tab -isis @tab -eses
+ @tab -@code{is} @tab -@code{es} @tab -@code{isis} @tab -@code{eses}
@item @code{catalan}
- @tab -d/-s @tab -b @tab -dd/-ss @tab -bb
+ @tab -@code{d}/-@code{s} @tab -@code{b} @tab -@code{dd}/-@code{ss} @tab -@code{bb}
@item @code{deutsch}
- @tab -is @tab -es @tab -isis @tab -eses
+ @tab -@code{is} @tab -@code{es} @tab -@code{isis} @tab -@code{eses}
@item @code{english}
- @tab -s/-sharp @tab -f/-flat @tab -ss/-x/-sharpsharp
- @tab -ff/-flatflat
-@item @code{espanol} o @code{español}
- @tab -s @tab -b @tab -ss/-x @tab -bb
-@item @code{italiano} o @code{français}
- @tab -d @tab -b @tab -dd @tab -bb
+ @tab -@code{s}/-@code{-sharp} @tab -@code{f}/-@code{-flat} @tab -@code{ss}/-@code{x}/-@code{-sharpsharp}
+ @tab -@code{ff}/-@code{-flatflat}
+@item @code{espanol} or @code{español}
+ @tab -@code{s} @tab -@code{b} @tab -@code{ss}/-@code{x} @tab -@code{bb}
+@item @code{italiano} or @code{français}
+ @tab -@code{d} @tab -@code{b} @tab -@code{dd} @tab -@code{bb}
@item @code{norsk}
- @tab -iss/-is @tab -ess/-es @tab -ississ/-isis
- @tab -essess/-eses
+ @tab -@code{iss}/-@code{is} @tab -@code{ess}/-@code{es} @tab -@code{ississ}/-@code{isis}
+ @tab -@code{essess}/-@code{eses}
@item @code{portugues}
- @tab -s @tab -b @tab -ss @tab -bb
+ @tab -@code{s} @tab -@code{b} @tab -@code{ss} @tab -@code{bb}
@item @code{suomi}
- @tab -is @tab -es @tab -isis @tab -eses
+ @tab -@code{is} @tab -@code{es} @tab -@code{isis} @tab -@code{eses}
@item @code{svenska}
- @tab -iss @tab -ess @tab -ississ @tab -essess
+ @tab -@code{iss} @tab -@code{ess} @tab -@code{ississ} @tab -@code{essess}
@item @code{vlaams}
- @tab -k @tab -b @tab -kk @tab -bb
+ @tab -@code{k} @tab -@code{b} @tab -@code{kk} @tab -@code{bb}
@end multitable
@end quotation
-En holandés, @code{aes} se contrae como @code{as}, pero las dos formas
-se aceptan en LilyPond. De forma similar, se aceptan tanto @code{es}
-como @code{ees}. Esto se aplica también a
+En holandés, @code{aes} se contrae como @code{as}, pero las dos
+formas se aceptan en LilyPond. De forma similar, se aceptan tanto
+@code{es} como @code{ees}. Esto se aplica también a
@code{aeses}@tie{}/@tie{}@code{ases} y a
-@code{eeses}@tie{}/@tie{}@code{eses}. A veces se definen solamente
-estos nombres contraídos en los archivos de idioma correspondientes.
+@code{eeses}@tie{}/@tie{}@code{eses}. A veces se definen
+solamente estos nombres contraídos en los archivos de idioma
+correspondientes.
@lilypond[verbatim,quote,fragment]
\relative c'' { a2 as e es a ases e eses }
@cindex sesqui-sostenido
@cindex sesqui-bemol
-Algunas músicas utilizan microtonos cuyas alteraciones son fracciones
-de un sostenido o bemol @q{normales}. La tabla siguiente relacione
-los nombres de las notas para las alteraciones de un cuarto de tono en
-distintos idiomas; aquí, los prefijos @notation{semi-} y
-@notation{sesqui-} respectivamente significan @q{medio} y @q{uno y
-medio}. Los idiomas que no aparecen en esta tabla no aportan aún
-nombres especiales para las notas.
+Algunas músicas utilizan microtonos cuyas alteraciones son
+fracciones de un sostenido o bemol @q{normales}. La tabla
+siguiente relacione los nombres de las notas para las alteraciones
+de un cuarto de tono en distintos idiomas; aquí, los prefijos
+@notation{semi-} y @notation{sesqui-} respectivamente significan
+@q{medio} y @q{uno y medio}. Los idiomas que no aparecen en esta
+tabla no aportan aún nombres especiales para las notas.
@quotation
@multitable {@code{nederlands}} {@b{semi-sostenido}} {@b{semi-bemol}} {@b{sesqui-sostenido}} {@b{sesqui-bemol}}
@end multitable
@end quotation
-Casi todos los idiomas presentados aquí están asociados comúnmente con
-la música clásica occidental, también conocida como @notation{Período
-de la práctica común}. Sin embargo, también están contempladas las
-alturas y los sistemas de afinación alternativos: véase @ref{Notación
-común para músicas no occidentales}.
+Casi todos los idiomas presentados aquí están asociados comúnmente
+con la música clásica occidental, también conocida como
+@notation{Período de la práctica común}. Sin embargo, también
+están contempladas las alturas y los sistemas de afinación
+alternativos: véase @ref{Notación común para músicas no
+occidentales}.
@seealso
Glosario musical:
@funindex octaveCheck
@funindex controlpitch
-En el modo relativo, es fácil olvidar una marca de cambio de octava.
-Las comprobaciones de octava hacen más fácil encontrar estos errores,
-mediante la presentación de una advertencia y corrigiendo la octava si
-la nota se encuentra en una octava distinta de lo esperado.
+En el modo relativo, es fácil olvidar una marca de cambio de
+octava. Las comprobaciones de octava hacen más fácil encontrar
+estos errores, mediante la presentación de una advertencia y
+corrigiendo la octava si la nota se encuentra en una octava
+distinta de lo esperado.
-Para comprobar la octava de una nota, especifique la octava absoluta
-después del símbolo@tie{}@code{=}. Este ejemplo genera un mensaje de
-advertencia (y corrige la altura) porque la segunda nota es la octava
-absoluta @code{d''} en lugar de @code{d'} como indica la corrección de
-octava.
+Para comprobar la octava de una nota, especifique la octava
+absoluta después del símbolo@tie{}@code{=}. Este ejemplo genera
+un mensaje de advertencia (y corrige la altura) porque la segunda
+nota es la octava absoluta @code{d''} en lugar de @code{d'} como
+indica la corrección de octava.
@lilypond[verbatim,quote]
\relative {
}
@end lilypond
-La octava de las notas se puede comprobar también con la instrucción
-@code{\octaveCheck@tie{}@var{altura_de_control}}.
-@code{@var{altura_de_control}} se especifica en modo absoluto. Esto
-comprueba que el intervalo entre la nota anterior y la
-@code{@var{altura_de_control}} se encuentra dentro de una cuarta (es decir, el
-cálculo normal para el modo relativo). Si esta comprobación fracasa,
-se imprime un mensaje de advertencia, pero la nota previa no se
-modifica. Las notas posteriores están en relación a la
-@code{@var{altura_de_control}}.
+La octava de las notas se puede comprobar también con la
+instrucción @code{\octaveCheck@tie{}@var{altura_de_control}}.
+@code{@var{altura_de_control}} se especifica en modo absoluto.
+Esto comprueba que el intervalo entre la nota anterior y la
+@code{@var{altura_de_control}} se encuentra dentro de una cuarta
+(es decir, el cálculo normal para el modo relativo). Si esta
+comprobación fracasa, se imprime un mensaje de advertencia.
+Aunque la nota previa no se modifica, las notas posteriores están
+en relación al valor corregido.
@lilypond[verbatim,quote]
\relative {
@funindex \transpose
@funindex transpose
-Una expresión musical se puede transportar mediante @code{\transpose}.
-La sintaxis es
+Una expresión musical se puede transportar mediante
+@code{\transpose}. La sintaxis es
@example
\transpose @var{nota_origen} @var{nota_destino} @var{expresión_musical}
@end example
-Esto significa que la @code{@var{expresión_musical}} se transporta el
-intervalo que hay entre las notas @code{@var{nota_origen}} y
-@code{@var{nota_destino}}: cualquier nota con la altura de @code{@var{nota_origen}}
-se cambia por @code{@var{nota_destino}} y cualquier otra nota se transporta
-el mismo intervalo. Las dos notas se introducen en modo absoluto.
+Esto significa que la @code{@var{expresión_musical}} se transporta
+el intervalo que hay entre las notas @code{@var{nota_origen}} y
+@code{@var{nota_destino}}: cualquier nota con la altura de
+@code{@var{nota_origen}} se cambia por @code{@var{nota_destino}} y
+cualquier otra nota se transporta el mismo intervalo. Las dos
+notas se introducen en modo absoluto.
-@warning{La música que está dentro de un bloque @code{@bs{}transpose}
-es absoluta, a no ser que se incluya una instrucción
-@code{@bs{}relative} dentro del bloque.}
+@warning{La música que está dentro de un bloque
+@code{@bs{}transpose} es absoluta, a no ser que se incluya una
+instrucción @code{@bs{}relative} dentro del bloque.}
-Por ejemplo, tomemos una pieza escrita en la tonalidad de Re mayor.
-Se puede transportar hacia arriba a Mi mayor; observe que también la
-armadura de la tonalidad se transporta automáticamente.
+Por ejemplo, tomemos una pieza escrita en la tonalidad de Re
+mayor. Se puede transportar hacia arriba a Mi mayor; observe que
+también la armadura de la tonalidad se transporta automáticamente.
@lilypond[verbatim,quote]
\transpose d e {
Si una particella escrita en Do (@notation{afinación de concierto}
normal) se debe tocar con un clarinete en La (para el que un La se
-escribe como un Do, y que suena una tercera menor por debajo de lo que
-está escrito), la particella correspondiente se produce mediante:
+escribe como un Do, y que suena una tercera menor por debajo de lo
+que está escrito), la particella correspondiente se produce
+mediante:
@lilypond[verbatim,quote]
\transpose a c' {
@end lilypond
@noindent
-Observe que especificamos @code{\key c \major} de forma explícita. Si
-no especificamos ninguna tonalidad, las notas se transportan pero no
-se imprime la armadura.
+Observe que especificamos @code{\key c \major} de forma explícita.
+Si no especificamos ninguna tonalidad, las notas se transportan
+pero no se imprime la armadura.
@code{\transpose} distingue entre notas enarmónicas: tanto
-@code{\transpose c cis} como @code{\transpose c des} transportan un
-semitono hacia arriba. La primera versión imprime sostenidos y las
-notas no se mueven de su lugar en la escala, en cambio la segunda
-imprime bemoles de la nota siguiente.
+@code{\transpose c cis} como @code{\transpose c des} transportan
+un semitono hacia arriba. La primera versión imprime sostenidos y
+las notas no se mueven de su lugar en la escala, en cambio la
+segunda imprime bemoles de la nota siguiente.
@lilypond[verbatim,quote]
music = \relative { c' d e f }
@cindex transpositores, instrumentos
@cindex instrumentos transpositores
-@code{\transpose} también se puede usar para introducir notas escritas
-para un instrumento transpositor. Los ejemplos anteriores muestran
-cómo escribir alturas en Do (o en @notation{afinación de concierto}) y
-tipografiarlas para un instrumento transpositor, pero también es
-posible el caso contrario si, por ejemplo, tenemos un conjunto de
-partes instrumentales y quiere hacer un guión en Do para el director.
+@code{\transpose} también se puede usar para introducir notas
+escritas para un instrumento transpositor. Los ejemplos
+anteriores muestran cómo escribir alturas en Do (o en
+@notation{afinación de concierto}) y tipografiarlas para un
+instrumento transpositor, pero también es posible el caso
+contrario si, por ejemplo, tenemos un conjunto de partes
+instrumentales y quiere hacer un guión en Do para el director.
Por ejemplo, al introducir música para trompeta en Si bemol que
comienza por un Mi en la partitura (Re de concierto), se puede
escribir:
@noindent
Para imprimir esta música en Fa (por ejemplo, al arreglarla para
-trompa) puede envolver la música existente con otro @code{\transpose}:
+trompa) puede envolver la música existente con otro
+@code{\transpose}:
@example
musicaEnSiBemol = @{ e4 @dots{} @}
@funindex relative
@knownissues
-La conversión relativa no afecta a las secciones @code{\transpose},
-@code{\chordmode} ni @code{\relative} dentro de su argumento. Para
-usar el modo relativo dentro de música transportada, se debe colocar
-otro @code{\relative} dentro de @code{\transpose}.
+La conversión relativa no afecta a las secciones
+@code{\transpose}, @code{\chordmode} ni @code{\relative} dentro de
+su argumento. Para usar el modo relativo dentro de música
+transportada, se debe colocar otro @code{\relative} dentro de
+@code{\transpose}.
No se imprimen alteraciones accidentales triples cuando se usa
-@code{\transpose}. En lugar de ello, se usará una nota @q{equivalente
-enarmónicamente} (p.ej., Re bemol en lugar de Mi triple bemol).
+@code{\transpose}. En lugar de ello, se usará una nota
+@q{equivalente enarmónicamente} (p.ej., Re bemol en lugar de Mi
+triple bemol).
@node Inversión
\inversion @var{nota-pivote} @var{nota-destino} @var{expresión_musical}
@end example
-La @code{@var{expresión_musical}} se invierte intervalo a intervalo
-alrededor de @code{@var{nota-pivote}}, y después se transporta de
-manera que @code{@var{nota-pivote}} se hace corresponder con
-@code{@var{nota-destino}}.
+La @code{@var{expresión_musical}} se invierte intervalo a
+intervalo alrededor de @code{@var{nota-pivote}}, y después se
+transporta de manera que @code{@var{nota-pivote}} se hace
+corresponder con @code{@var{nota-destino}}.
@lilypond[verbatim,quote]
music = \relative { c' d e f }
@end lilypond
@warning{Los motivos a invertir deberían venir expresados en modo
-absoluto o convertirse previamente a la forma absoluta encerrándolos
-en un bloque @code{\relative}.}
+absoluto o convertirse previamente a la forma absoluta
+encerrándolos en un bloque @code{\relative}.}
@seealso
Referencia de la notación:
@cindex operaciones modales
En una composición musical que está basada en una escala, con
-frecuencia se transforman los motivos de diversas formas. Un motivo
-se puede @notation{transportar} para que comience en distintos lugares
-de la escala o puede @notation{invertirse} alrededor de una nota
-pivote de la escala. También se puede revertir para producir una
-@notation{retrogradación}, véase @ref{Retrogradación}.
+frecuencia se transforman los motivos de diversas formas. Un
+motivo se puede @notation{transportar} para que comience en
+distintos lugares de la escala o puede @notation{invertirse}
+alrededor de una nota pivote de la escala. También se puede
+revertir para producir una @notation{retrogradación}, véase
+@ref{Retrogradación}.
-@warning{Cualquier nota que no entre en la escada dada, se dejará sin
-transformar.}
+@warning{Cualquier nota que no entre en la escada dada, se dejará
+sin transformar.}
@subsubsubheading Transposición modal
\modalTranspose @var{nota-origen} @var{nota-destino} @var{escala} @var{motivo}
@end example
-Las notas del @var{motivo} se desplazan dentro de la @var{escala} el
-número de grados de la escala dados por el intervalo entre
+Las notas del @var{motivo} se desplazan dentro de la @var{escala}
+el número de grados de la escala dados por el intervalo entre
@var{nota-destino} y @var{nota-origen}:
@lilypond[verbatim,quote]
}
@end lilypond
-Se pueden especificar escalas ascendentes de cualquier longitud y con
-cualesquiera intervalos:
+Se pueden especificar escalas ascendentes de cualquier longitud y
+con cualesquiera intervalos:
@lilypond[verbatim,quote]
pentatonicScale = \relative { ges aes bes des ees }
@end lilypond
Cuando se utiliza con una escala cromática, @code{\modalTranspose}
-tiene un efecto similar a @code{\transpose}, pero con la posibilidad
-de especificar los nombres de las notas que se quieren usar:
+tiene un efecto similar a @code{\transpose}, pero con la
+posibilidad de especificar los nombres de las notas que se quieren
+usar:
@lilypond[verbatim,quote]
chromaticScale = \relative { c' cis d dis e f fis g gis a ais b }
@funindex \modalInversion
@funindex modalInversion
-Se puede invertir un motivo dentro de una escala dada alrededor de una
-nota pivote dada y transportada al mismo tiempo en una única
+Se puede invertir un motivo dentro de una escala dada alrededor de
+una nota pivote dada y transportada al mismo tiempo en una única
operación, con:
@example
@end example
Las notas del @var{motivo} se colocan al mismo número de grados de
-distancia de la escala a partir de la @var{nota-pivote} dentro de la
-@var{escala}, pero en la dirección opuestoa, y el resultado se
-desplaza después dentro de la @var{escala} el número de grados de la
-escala dados por el intervalo entre la @var{nota-destino} y la
+distancia de la escala a partir de la @var{nota-pivote} dentro de
+la @var{escala}, pero en la dirección opuestoa, y el resultado se
+desplaza después dentro de la @var{escala} el número de grados de
+la escala dados por el intervalo entre la @var{nota-destino} y la
@var{nota-pivote}.
Así pues, para invertir sencillamente alrededor de una nota de la
@end lilypond
Para invertir alrededor de una nota pivote entre dos notas de la
-escala, invierta alrededor de una de las notas y después transporte en
-un grado de la escala. Las dos notas especificadas se pueden
-interpretar como que horquillan entre ellas a la nota pivote:
+escala, invierta alrededor de una de las notas y después
+transporte en un grado de la escala. Las dos notas especificadas
+se pueden interpretar como que horquillan entre ellas a la nota
+pivote:
@lilypond[verbatim,quote]
scale = \relative { c' g' }
@subsection Imprimir las alturas
@translationof Displaying pitches
-Esta sección trata de cómo alterar la presentación de la altura de las
-notas.
+Esta sección trata de cómo alterar la presentación de la altura de
+las notas.
@menu
* Clave::
@funindex \clef
@funindex clef
-Es posible cambiar la clave. En todos los ejemplos se muestra el Do
-central. Estos nombres de clave pueden (aunque no necesariamente)
-encerrarse entre comillas.
+Sin ninugna instrucción explícita, la clave predeterminada en
+LilyPond es la clave @qq{treble} (o clave de @emph{Sol}).
+
+@lilypond[verbatim,quote,fragment,ragged-right]
+c'2 c'
+@end lilypond
+
+Sin embargo, se puede cambiar la clave usando la instrucción
+@code{\clef} y el nombre de la clave correspondiente. En los
+siguientes ejemplos se muestra la posición del @emph{Do central}
+en distintas claves.
@lilypond[verbatim,quote,fragment]
\clef treble
c'2 c'
@end lilypond
-Otras claves son las siguientes:
-
-@lilypond[verbatim,quote,relative=1]
-\clef french
-c2 c
-\clef soprano
-c2 c
-\clef mezzosoprano
-c2 c
-\clef baritone
-c2 c
+Para ver el repertorio completo de los posibles nombes para las
+cllaves, consulte @ref{Estilos de clave}.
-\break
+Las claves especiales como las utilizadas en la música
+@emph{antigua}, se describen en @ref{Claves de la música mensural}
+y en @ref{Claves de canto gregoriano}. La música que requiere
+claves de tablatura se estudia en @ref{Tablaturas predeterminadas}
+y en @ref{Tablaturas personalizadas}.
-\clef varbaritone
-c2 c
-\clef subbass
-c2 c
-\clef percussion
-c2 c
+@cindex Claves de guía
+@cindex Claves con notas guía
-\break
-
-\clef G % synonym for treble
-c2 c
-\clef F % synonym for bass
-c2 c
-\clef C % synonym for alto
-c2 c
-@end lilypond
+Para emplear claves en las notas guía, véanse las instrucciones
+@code{\cueClef} y @code{\cueDuringWithClef} en
+@ref{Formateo de las notas guía}.
@cindex transpositoras, claves
@cindex clave transpositora
@cindex tenor, clave de, coral
Al añadir @code{_8} o @code{^8} al nombre de la clave, la clave se
-transpone una octava hacia abajo o hacia arriba, respectivamente, y
-@code{_15} y @code{^15} la transpone dos octavas. Si es necesario
-se pueden usar otros números enteros. El argumento
+transpone una octava hacia abajo o hacia arriba, respectivamente,
+y @code{_15} y @code{^15} la transpone dos octavas. Si es
+necesario se pueden usar otros números enteros. El argumento
@var{nombre_de_clave} se debe encerrar entre comillas si contiene
caracteres no alfabéticos:
Las alturas se imprimen como si el argumento numérico no tuviera
los paréntesis o corchetes.
-Ciertas claves para usos especiales se describen en @ref{Claves de la
-música mensural}, @ref{Claves de canto gregoriano}, @ref{Tablaturas
-predeterminadas} y @ref{Tablaturas personalizadas}. Para mezclar
-distintas claves al usar notas guía dentro de una partitura,
-consulte las funciones @code{\cueClef} y @code{\cueDuringWithClef}
-en la sección @ref{Formateo de las notas guía}.
+De forma predeterminada, un cambio de clave que se produce en un
+salto de línea provoca que el símbolo de clave nuevo se imprima al
+final de la línea anterior, como una clave @emph{de cortesía}, así
+como al principio del siguiente. Esta clave @emph{de cortesía} se
+puede suprimir.
+
+@lilypond[verbatim,quote,fragment]
+\clef treble { c'2 c' } \break
+\clef bass { c'2 c' } \break
+\clef alto
+ \set Staff.explicitClefVisibility = #end-of-line-invisible
+ { c'2 c' } \break
+ \unset Staff.explicitClefVisibility
+\clef bass { c'2 c' } \break
+@end lilypond
+
+De forma predeterminada, una clave que se ha impreso previamente
+no se vuelve a imprimir si se emplea de nuevo la misma instrucción
+@code{\clef}, y se ignora. La instrucción @code{\set
+Staff.forceClef = ##t} modifica este comportamiento.
+
+@lilypond[verbatim,quote,fragment]
+ \clef treble
+ c'1
+ \clef treble
+ c'1
+ \set Staff.forceClef = ##t
+ c'1
+ \clef treble
+ c'1
+@end lilypond
+
+Cuando hay un cambio de clave manual, el glifo de la clave
+modificada es pás pequeño de lo normal. Se puede sobreescribir
+este comportamiento.
+
+@lilypond[verbatim,quote,fragment]
+ \clef "treble"
+ c'1
+ \clef "bass"
+ c'1
+ \clef "treble"
+ c'1
+ \override Staff.Clef.full-size-change = ##t
+ \clef "bass"
+ c'1
+ \clef "treble"
+ c'1
+ \revert Staff.Clef.full-size-change
+ \clef "bass"
+ c'1
+ \clef "treble"
+ c'1
+@end lilypond
@snippets
@ref{Tablaturas personalizadas},
@ref{Formateo de las notas guía}.
+Archivos instalados:
+@file{scm/parser-clef.scm}.
+
Fragmentos de código:
@rlsr{Pitches}.
también al grob @var{ClefModifier} como un @code{\override}
diferente.
-@lilypond[fragment,quote,relative=1]
+@lilypond[fragment,quote,verbatim]
\new Staff \with {
- \override ClefModifier.color = #red
\override Clef.color = #blue
+ \override ClefModifier.color = #red
}
-\clef "treble_8" c4
+\clef "treble_8" c'4
@end lilypond
@c duplicated in Key signature and Accidentals
@warning{Las alteraciones accidentales y las armaduras son una
-frecuente causa de confusión para los nuevos usuarios. En LilyPond,
-los nombres de las notas son el código de entrada en bruto; la
-armadura y la clave determinan de qué forma se presenta este código en
-bruto. Una nota sin alteración como@tie{}@code{c} significa @q{Do
-natural}, si que le afecten la armadura ni la clave. Para ver más
-información, consulte @rlearning{Alteraciones accidentales y armaduras}.}
+frecuente causa de confusión para los nuevos usuarios. En
+LilyPond, los nombres de las notas son el código de entrada en
+bruto; la armadura y la clave determinan de qué forma se presenta
+este código en bruto. Una nota sin alteración como@tie{}@code{c}
+significa @q{Do natural}, si que le afecten la armadura ni la
+clave. Para ver más información, consulte @rlearning{Alturas y
+armaduras}.}
La armadura indica la tonalidad en que se toca una pieza. Está
denotada por un conjunto de alteraciones (bemoles o sostenidos) al
@cindex dórico, modo
@noindent
-Aquí, @code{@var{modo}} debe ser @code{\major} o @code{\minor} para obtener
-la tonalidad @code{@var{nota}} mayor o @code{@var{nota}} menor, respectivamente.
-También puede usar los nombres estándar de modo (también conocidos
-como @notation{modos eclesiásticos}): @code{\ionian} (jónico),
-@code{\dorian} (dórico), @code{\phrygian} (frigio), @code{\lydian}
-(lidio), @code{\mixolydian} (mixolidio), @code{\aeolian} (eolio) y
+Aquí, @code{@var{modo}} debe ser @code{\major} o @code{\minor}
+para obtener la tonalidad @code{@var{nota}} mayor o
+@code{@var{nota}} menor, respectivamente. También puede usar los
+nombres estándar de modo (también conocidos como @notation{modos
+eclesiásticos}): @code{\ionian} (jónico), @code{\dorian} (dórico),
+@code{\phrygian} (frigio), @code{\lydian} (lidio),
+@code{\mixolydian} (mixolidio), @code{\aeolian} (eolio) y
@code{\locrian} (locrio).
@lilypond[verbatim,quote,fragment]
@lilypondfile[verbatim,quote,texidoc,doctitle]
{non-traditional-key-signatures.ly}
+
@seealso
Glosario musical:
@rglos{church mode},
@rglos{scordatura}.
Manual de aprendizaje:
-@rlearning{Alteraciones accidentales y armaduras}.
+@rlearning{Alturas y armaduras}.
Fragmentos de código:
@rlsr{Pitches}.
@lilypondfile[verbatim,quote,texidoc,doctitle]
{adding-an-ottava-marking-to-a-single-voice.ly}
+@lilypondfile[verbatim,quote,texidoc,doctitle]
+{modifying-the-ottava-spanner-slope.ly}
+
@seealso
Glosario musical:
@rglos{octavation}.
Al tipografiar partituras donde participan instrumentos
transpositores, ciertas partes se pueden tipografiar en un tono
-distinto del @notation{tono de concierto}. En estos casos, se debe
-especificar la tonalidad del @notation{instrumento transpositor}; de
-otro modo, la salida MIDI y las notas guía en otras partes producirían
-alturas incorrectas. Para ver más información sobre partes citadas
-como guía, consulte @ref{Citar otras voces}.
+distinto del @notation{tono de concierto}. En estos casos, se
+debe especificar la tonalidad del @notation{instrumento
+transpositor}; de otro modo, la salida MIDI y las notas guía en
+otras partes producirían alturas incorrectas. Para ver más
+información sobre partes citadas como guía, consulte @ref{Citar
+otras voces}.
@example
\transposition @var{pitch}
@end example
-El tono usado para @code{\transposition} debe corresponderse con el
-sonido real que se oye cuando el instrumento transpositor interpreta
-un Do central @code{c'} escrito en el pentagrama. Esta nota se
-escribe en altura absoluta, por tanto un instrumento que produce un
-sonido real un tono más agudo que la música impresa (un instrumento en
-Re) debe usar @code{\transposition d'}. La instrucción
-@code{\transposition} se debe usar @emph{solamente} si las notas
-@emph{no} se van a escribir en afinación de concierto.
-
-A continuación pueden verse algunas notas para violín y para clarinete
-en Si bemol, donde las partes se han introducido usando las notas y la
-armadura tal y como aparecen en la partitura del director. Lo que
-tocan los dos instrumentos está sonando al unísono.
+El tono usado para @code{\transposition} debe corresponderse con
+el sonido real que se oye cuando el instrumento transpositor
+interpreta un Do central @code{c'} escrito en el pentagrama. Esta
+nota se escribe en altura absoluta, por tanto un instrumento que
+produce un sonido real un tono más agudo que la música impresa (un
+instrumento en Re) debe usar @code{\transposition d'}. La
+instrucción @code{\transposition} se debe usar @emph{solamente} si
+las notas @emph{no} se van a escribir en afinación de concierto.
+
+A continuación pueden verse algunas notas para violín y para
+clarinete en Si bemol, donde las partes se han introducido usando
+las notas y la armadura tal y como aparecen en la partitura del
+director. Lo que tocan los dos instrumentos está sonando al
+unísono.
@lilypond[verbatim,quote]
\new GrandStaff <<
@funindex voice
@funindex default
-Existen muchas convenciones distintas sobre la forma de tipografiar
-las alteraciones. LilyPond proporciona una función para especificar
-qué estilo de alteraciones usar. Esta función se invoca como sigue:
+Existen muchas convenciones distintas sobre la forma de
+tipografiar las alteraciones. LilyPond proporciona una función
+para especificar qué estilo de alteraciones usar. Esta función se
+invoca como sigue:
@example
\new Staff <<
>>
@end example
-El estilo de alteraciones se aplica al @code{Staff} en curso de forma
-predeterminada (con la excepción de los estilos @code{piano} y
-@code{piano-cautionary}, que se explican más adelante).
+El estilo de alteraciones se aplica al @code{Staff} en curso de
+forma predeterminada (con la excepción de los estilos @code{piano}
+y @code{piano-cautionary}, que se explican más adelante).
Opcionalmente, la función puede tomar un segundo argumento que
-determina en qué ámbito se debe cambiar el estilo. Por ejemplo, para
-usar el mismo estilo en todos los pentagramas del @code{StaffGroup} en
-curso, use
+determina en qué ámbito se debe cambiar el estilo. Por ejemplo,
+para usar el mismo estilo en todos los pentagramas del
+@code{StaffGroup} en curso, use
@example
\accidentalStyle StaffGroup.voice
@end example
-Están contemplados los siguientes estilos de alteración. Para dar una
-muestra de cada uno de los estilos, utilizamos el ejemplo siguiente:
+Están contemplados los siguientes estilos de alteración. Para dar
+una muestra de cada uno de los estilos, utilizamos el ejemplo
+siguiente:
@lilypond[verbatim,quote]
musicA = {
}
@end lilypond
-Observe que las últimas líneas de este ejemplo se pueden sustituir por
-las siguientes, siempre y cuando queramos usar el mismo estilo en los
-dos pentagramas.
+Observe que las últimas líneas de este ejemplo se pueden sustituir
+por las siguientes, siempre y cuando queramos usar el mismo estilo
+en los dos pentagramas.
@example
\new PianoStaff @{
Es el comportamiento de composición tipográfica predeterminado.
Corresponde a la práctica común del s. XVIII: las alteraciones
-accidentales se recuerdan hasta el final del compás en el que aparecen
-y sólo en la misma octava. Así, en el ejemplo siguiente, no se
-imprimen becuadros antes del Si natural en el segundo compás ni en el
-último Do:
+accidentales se recuerdan hasta el final del compás en el que
+aparecen y sólo en la misma octava. Así, en el ejemplo siguiente,
+no se imprimen becuadros antes del Si natural en el segundo compás
+ni en el último Do:
@lilypond[quote]
musicA = {
@funindex voice
-El comportamiento normal es recordar las alteraciones accidentales al
-nivel de @code{Staff}. En este estilo, sin embargo, se tipografían
-las alteraciones individualmente para cada voz. Aparte de esto, la
-regla es similar a @code{default}.
+El comportamiento normal es recordar las alteraciones accidentales
+al nivel de @code{Staff}. En este estilo, sin embargo, se
+tipografían las alteraciones individualmente para cada voz.
+Aparte de esto, la regla es similar a @code{default}.
Como resultado, las alteraciones de una voz no se cancelan en las
-otras voces, lo que con frecuencia lleva a un resultado no deseado: en
-el ejemplo siguiente, es difícil determinar si el segundo La se debe
-tocar natural o sostenido. Por tanto, la opción @code{voice} se debe
-usar sólo si las voces se van a leer individualmente por músicos
-distintos. Si el pentagrama va a utilizarse por parte de un solo
-músico (p.ej., un director, o en una partitura de piano), entonces se
-deben usar en su lugar los estilos @code{modern} o
-@code{modern-cautionary}.
+otras voces, lo que con frecuencia lleva a un resultado no
+deseado: en el ejemplo siguiente, es difícil determinar si el
+segundo La se debe tocar natural o sostenido. Por tanto, la
+opción @code{voice} se debe usar sólo si las voces se van a leer
+individualmente por músicos distintos. Si el pentagrama va a
+utilizarse por parte de un solo músico (p.ej., un director, o en
+una partitura de piano), entonces se deben usar en su lugar los
+estilos @code{modern} o @code{modern-cautionary}.
@lilypond[quote]
musicA = {
@funindex modern
-Esta regla corresponde a la práctica común del s. XX. Omite algunos
-becuadros adicionales, que tradicionalmente se imprimían precediendo a
-un sostenido que sigue a un doble sostenido, o a un bemol que sigue
-a un doble bemol. La regla @code{modern} imprime las mismas
-alteraciones que el estilo @code{default}, con dos adiciones que
-sirven para evitar la ambigüedad: después de alteraciones temporales
-se imprimen indicaciones de cancelación también en el compás siguiente
-(para notas en la misma octava) y, en el mismo compás, para notas en
-octavas distintas. De aquí los becuadros antes del Si natural y del
-Do en el segundo compás del pentagrama superior:
+Esta regla corresponde a la práctica común del s. XX. Omite
+algunos becuadros adicionales, que tradicionalmente se imprimían
+precediendo a un sostenido que sigue a un doble sostenido, o a un
+bemol que sigue a un doble bemol. La regla @code{modern} imprime
+las mismas alteraciones que el estilo @code{default}, con dos
+adiciones que sirven para evitar la ambigüedad: después de
+alteraciones temporales se imprimen indicaciones de cancelación
+también en el compás siguiente (para notas en la misma octava) y,
+en el mismo compás, para notas en octavas distintas. De aquí los
+becuadros antes del Si natural y del Do en el segundo compás del
+pentagrama superior:
@lilypond[quote]
musicA = {
@funindex modern-cautionary
Esta regla es similar a @code{modern}, pero las alteraciones
-@q{añadidas} (las que no se imprimen en el estilo @code{default}) se
-imprimen como alteraciones de precaución. Se imprimen de forma
-predeterminada con paréntesis, pero también se pueden imprimir en
-tamaño reducido definiendo la propiedad @code{cautionary-style} de
-@code{AccidentalSuggestion}.
+@q{añadidas} se imprimen como alteraciones de precaución (entre
+paréntesis). También se pueden imprimir en un tamaño distinto
+sobreescribiendo la propiedad @code{font-size} del objeto
+@code{AccidentalCautionary}.
@lilypond[quote]
musicA = {
@funindex modern-voice
Esta regla se usa para que puedan leer las alteraciones en varias
-voces, tanto músicos que tocan una voz como músicos que tocan todas
-las voces. Se imprimen las alteraciones para cada voz, pero @emph{se
-cancelan} entre voces dentro del mismo @code{Staff}. Por tanto, el La
-en el último compás se cancela porque la cancelación anterior estaba
-en una voz distinta, y el Re en el pentagrama inferior se cancela a
-causa de la alteración en otra voz en el compás previo:
+voces, tanto músicos que tocan una voz como músicos que tocan
+todas las voces. Se imprimen las alteraciones para cada voz, pero
+@emph{se cancelan} entre voces dentro del mismo @code{Staff}. Por
+tanto, el La en el último compás se cancela porque la cancelación
+anterior estaba en una voz distinta, y el Re en el pentagrama
+inferior se cancela a causa de la alteración en otra voz en el
+compás previo:
@lilypond[quote]
musicA = {
Esta regla es la misma que @code{modern-voice}, pero con las
alteraciones añadidas (las que el estilo @code{voice} no imprime)
-compuestas como de precaución. Incluso aunque todas las alteraciones
-impresas por el estilo @code{default} @emph{son} impresas con esta
-regla, algunas de ellas se tipografían como de precaución.
+compuestas como de precaución. Incluso aunque todas las
+alteraciones impresas por el estilo @code{default} @emph{son}
+impresas con esta regla, algunas de ellas se tipografían como de
+precaución.
@lilypond[quote]
musicA = {
@funindex piano
-Esta regla refleja la práctica del s.XX para la notación de piano. Su
-comportamiento es muy similar al estilo @code{modern}, pero aquí las
-alteraciones también se cancelan entre distintos pentagramas del mismo
-grupo @code{GrandStaff} o @code{PianoStaff}, de ahí todas las
-cancelaciones de las últimas notas.
+Esta regla refleja la práctica del s.XX para la notación de piano.
+Su comportamiento es muy similar al estilo @code{modern}, pero
+aquí las alteraciones también se cancelan entre distintos
+pentagramas del mismo grupo @code{GrandStaff} o @code{PianoStaff},
+de ahí todas las cancelaciones de las últimas notas.
-Este estilo de alteración se aplica de manera predeterminada al grupo
-@code{GrandStaff} o @code{PianoStaff} en curso.
+Este estilo de alteración se aplica de manera predeterminada al
+grupo @code{GrandStaff} o @code{PianoStaff} en curso.
@lilypond[quote]
musicA = {
@funindex piano-cautionary
-Igual que @code{\accidentalStyle piano} pero con las
-alteraciones añadidas compuestas como de precaución.
+Igual que @code{\accidentalStyle piano} pero con las alteraciones
+añadidas compuestas como de precaución.
@lilypond[quote]
musicA = {
@funindex neo-modern
-Esta regla reproduce una práctica común en la música contemporánea:
-las alteraciones accidentales se imprimen como en @code{modern}, pero
-se vuelven a imprimir si aparece la misma nota otra vez en el mismo
-compás (excepto si la nota se repite inmediatamente).
+Esta regla reproduce una práctica común en la música
+contemporánea: las alteraciones accidentales se imprimen como en
+@code{modern}, pero se vuelven a imprimir si aparece la misma nota
+otra vez en el mismo compás (excepto si la nota se repite
+inmediatamente).
@lilypond[quote]
musicA = {
@funindex neo-modern-cautionary
Esta regla es similar a @code{neo-modern}, pero las alteraciones
-adicionales se imprimen como alteraciones de precaución.
+@q{adicionales} se imprimen como alteraciones de precaución (con
+paréntesis). También se pueden imprimir en un tamaño distinto
+sobreescribiendo la propiedad @code{font-size} del objeto
+@code{AccidentalCautionary}.
@lilypond[quote]
musicA = {
@funindex neo-modern-voice
-Esta regla se usa para alteraciones accidentales sobre varias voces
-que se han de leer por parte de músicos que tocan una voz, así como
-por músicos que tocan todas las voces. Las alteraciones se imprimen
-para cada voz como con @code{neo-modern}, pero se cancelan para otras
-voces que están en el mismo pentagrama @code{Staff}.
+Esta regla se usa para alteraciones accidentales sobre varias
+voces que se han de leer por parte de músicos que tocan una voz,
+así como por músicos que tocan todas las voces. Las alteraciones
+se imprimen para cada voz como con @code{neo-modern}, pero se
+cancelan para otras voces que están en el mismo pentagrama
+@code{Staff}.
@lilypond[quote]
musicA = {
@funindex neo-modern-voice-cautionary
-Esta regla es similar a @code{neo-modern-voice}, pero las alteraciones
-adicionales se imprimen como alteraciones de precaución.
+Esta regla es similar a @code{neo-modern-voice}, pero las
+alteraciones adicionales se imprimen como alteraciones de
+precaución.
@lilypond[quote]
musicA = {
@funindex dodecaphonic
-Esta regla refleja una práctica introducida por los compositores de
-principios del s.XX, en un intento de abolir la jerarquía entre notas
-naturales y alteradas. Con este estilo, @emph{todas} las notas llevan
-alteración, incluso becuadros.
+Esta regla refleja una práctica introducida por los compositores
+de principios del s.XX, en un intento de abolir la jerarquía entre
+notas naturales y alteradas. Con este estilo, @emph{todas} las
+notas llevan alteración, incluso becuadros.
@lilypond[quote]
musicA = {
}
@end lilypond
+@item dodecaphonic-no-repeat
+
+@cindex dodecaphonic accidental style
+@cindex dodecaphonic style, neo-modern
+
+@funindex dodecaphonic-no-repeat
+
+Como con el estilo de alteraciones dodecafónico @emph{todas} las
+notas llevan una alteración de forma predeterminada, pero las
+alteriaciones se suprimen cuando hay notas repetidas
+inmediatamente en el mismo pentagrama.
+
+@lilypond[quote]
+musicA = {
+ <<
+ \relative {
+ cis''8 fis, bes4 <a cis>8 f bis4 |
+ cis2. <c, g'>4 |
+ }
+ \\
+ \relative {
+ ais'2 cis, |
+ fis8 b a4 cis2 |
+ }
+ >>
+}
+
+musicB = {
+ \clef bass
+ \new Voice {
+ \voiceTwo \relative {
+ <fis a cis>8[ <fis a cis>
+ \change Staff = up
+ cis' cis
+ \change Staff = down
+ <fis, a> <fis a>]
+ \showStaffSwitch
+ \change Staff = up
+ dis'4 |
+ \change Staff = down
+ <fis, a cis>4 gis <f a d>2 |
+ }
+ }
+}
+
+\new PianoStaff {
+ <<
+ \context Staff = "up" {
+ \accidentalStyle dodecaphonic-no-repeat
+ \musicA
+ }
+ \context Staff = "down" {
+ \accidentalStyle dodecaphonic-no-repeat
+ \musicB
+ }
+ >>
+}
+@end lilypond
+
+
+@item dodecaphonic-first
+
+@cindex dodecaphonic accidental style
+@cindex dodecaphonic style, neo-modern
+
+@funindex dodecaphonic-first
+
+Similar al estilo de alteraciones dodecafónico, @emph{todas} las
+notas llevan una alteración, pero solo la primera vez que se
+encuentran en el compás. Las alteraciones se recuerdan solamente
+para la octava actual pero a través de las voces.
+
+@lilypond[quote]
+musicA = {
+ <<
+ \relative {
+ cis''8 fis, bes4 <a cis>8 f bis4 |
+ cis2. <c, g'>4 |
+ }
+ \\
+ \relative {
+ ais'2 cis, |
+ fis8 b a4 cis2 |
+ }
+ >>
+}
+
+musicB = {
+ \clef bass
+ \new Voice {
+ \voiceTwo \relative {
+ <fis a cis>8[ <fis a cis>
+ \change Staff = up
+ cis' cis
+ \change Staff = down
+ <fis, a> <fis a>]
+ \showStaffSwitch
+ \change Staff = up
+ dis'4 |
+ \change Staff = down
+ <fis, a cis>4 gis <f a d>2 |
+ }
+ }
+}
+
+\new PianoStaff {
+ <<
+ \context Staff = "up" {
+ \accidentalStyle dodecaphonic-first
+ \musicA
+ }
+ \context Staff = "down" {
+ \accidentalStyle dodecaphonic-first
+ \musicB
+ }
+ >>
+}
+@end lilypond
+
+
@item teaching (enseñanza)
@cindex teaching (enseñanza), estilo de alteraciones
@funindex teaching
-Esta regla está pensada para estudiantes, y hace más sencillo crear
-hojas de escalas con alteraciones de precaución creadas
+Esta regla está pensada para estudiantes, y hace más sencillo
+crear hojas de escalas con alteraciones de precaución creadas
automáticamente. Las alteraciones se imprimen como en el estilo
-@code{modern}, pero se añaden alteraciones de precaución para todas
-las notas sostenidas o bemoles especificadas por la armadura, excepto
-si la nota se repite inmediatamente.
+@code{modern}, pero se añaden alteraciones de precaución para
+todas las notas sostenidas o bemoles especificadas por la
+armadura, excepto si la nota se repite inmediatamente.
@lilypond[quote,staffsize=18]
musicA = {
@funindex no-reset
-Es el mismo que @code{default} pero con alteraciones que duran @q{para
-siempre} y no sólo dentro del mismo compás:
+Es el mismo que @code{default} pero con alteraciones que duran
+@q{para siempre} y no sólo dentro del mismo compás:
@lilypond[quote]
musicA = {
@funindex forget
-Es lo opuesto a @code{no-reset}: Las alteraciones no se recuerdan en
-absoluto: de aquí que todas las alteraciones se compongan
-tipográficamente en relación a la armadura de la tonalidad, sin que
-estén afectadas por lo que viene antes.
+Es lo opuesto a @code{no-reset}: Las alteraciones no se recuerdan
+en absoluto: de aquí que todas las alteraciones se compongan
+tipográficamente en relación a la armadura de la tonalidad, sin
+que estén afectadas por lo que viene antes.
@lilypond[quote]
musicA = {
@cindex acordes, alteraciones dentro de
@knownissues
-Las notas simultáneas no se tienen en cuenta para la
-determinación automática de las alteraciones accidentales;
-sólo se consideran las notas anteriores y la armadura de
-la tonalidad. Puede ser necesario forzar las alteraciones
-accidentales con with@tie{}@code{!} o@tie{}@code{?} cuando
-la misma nota, con el mismo nombre, ocurre simultáneamente
-con distintas alteraciones, como en @samp{<f! fis!>}.
+Las notas simultáneas no se tienen en cuenta para la determinación
+automática de las alteraciones accidentales; sólo se consideran
+las notas anteriores y la armadura de la tonalidad. Puede ser
+necesario forzar las alteraciones accidentales con
+with@tie{}@code{!} o@tie{}@code{?} cuando la misma nota, con el
+mismo nombre, ocurre simultáneamente con distintas alteraciones,
+como en @samp{<f! fis!>}.
La cancelación de precaución de alteraciones se hace mirando el
compás previo. Sin embargo, en el bloque @code{\alternative} que
sigue a una sección de repetición de primera y segunda vez
-@code{\repeat volta N}, se esperaría que la cancelación se calculase
-utilizando el compás previo @emph{que se ha tocado}, no el compás
-previo @emph{que se ha impreso}. En el ejemplo siguiente, el Do
-natural de la casilla de segunda vez no necesita becuadro:
+@code{\repeat volta N}, se esperaría que la cancelación se
+calculase utilizando el compás previo @emph{que se ha tocado}, no
+el compás previo @emph{que se ha impreso}. En el ejemplo
+siguiente, el Do natural de la casilla de segunda vez no necesita
+becuadro:
@lilypond[quote]
{
}
@end lilypond
-Se puede usar el siguiente rodeo del problema: definir una función que
-cambie localmente el estilo de alteraciones a @code{forget}:
+Se puede usar el siguiente rodeo del problema: definir una función
+que cambie localmente el estilo de alteraciones a @code{forget}:
@lilypond[verbatim,quote]
forget = #(define-music-function (music) (ly:music?) #{
@cindex tesitura
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.
+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. Sólo se
+inicial. El rango se especifica gráficamente mediante dos cabezas
+de nota que representan a las notas inferior y superior. Sólo se
imprimen alteraciones si no forman parte de la armadura de la
tonalidad.
El estilo @code{cross} (aspas) se usa para representar una amplia
variedad de intenciones musicales. Las siguientes instrucciones
-genéricas predefinidas modifican la forma de la cabeza de las figuras
-tanto en el contexto de pentagrama normal como en el de tablatura, y
-se pueden usar para representar cualquier significado musical:
+genéricas predefinidas modifican la forma de la cabeza de las
+figuras tanto en el contexto de pentagrama normal como en el de
+tablatura, y se pueden usar para representar cualquier significado
+musical:
@lilypond[verbatim,quote]
\relative {
}
@end lilypond
-La forma de función musical de esta instrucción predefinida se puede
-usar dentro y fuera de los acordes para generar cabezas de nota en
-aspa, tanto en el contexto de pentagrama normal como en el de
-tablatura:
+La forma de función musical de esta instrucción predefinida se
+puede usar dentro y fuera de los acordes para generar cabezas de
+nota en aspa, tanto en el contexto de pentagrama normal como en el
+de tablatura:
@lilypond[verbatim,quote]
\relative {
}
@end lilypond
-Como sinónimos de @code{\xNote}, @code{\xNotesOn} y @code{\xNotesOff},
-se pueden usar @code{\deadNote}, @code{\deadNotesOn} y
-@code{\deadNotesOff}. El término @notation{dead note} (nota muerta)
-se utiliza corrientemente por parte de los guitarristas.
+Como sinónimos de @code{\xNote}, @code{\xNotesOn} y
+@code{\xNotesOff}, se pueden usar @code{\deadNote},
+@code{\deadNotesOn} y @code{\deadNotesOff}. El término
+@notation{dead note} (nota muerta) se utiliza corrientemente por
+parte de los guitarristas.
También existe una abreviatura similar para las formas en rombo:
@funindex \easyHeadsOff
@funindex easyHeadsOff
-Las notas con cabeza de @q{notación facilitada} tienen el nombre de la
-nota (en inglés) dentro de la cabeza. Se usan en la música para
-principiantes. Para que las letras sean legibles, se deben imprimir
-en un tamaño grande de fuente tipográfica. Para imprimir con una
-fuente más grande, véase @ref{Establecer el tamaño del pentagrama}.
+Las notas con cabeza de @q{notación facilitada} tienen el nombre
+de la nota (en inglés) dentro de la cabeza. Se usan en la música
+para principiantes. Para que las letras sean legibles, se deben
+imprimir en un tamaño grande de fuente tipográfica. Para imprimir
+con una fuente más grande, véase @ref{Establecer el tamaño del
+pentagrama}.
@lilypond[verbatim,quote]
#(set-global-staff-size 26)
@funindex \walkerHeads
@funindex walkerHeads
-En la 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. Las cabezas de nota con formas se pueden producir en los
-estilos @q{Sacred Harp}, @q{Southern Harmony},
-Funk (Harmonica Sacra), Walker y Aiken @q{(Christian
+En la 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. Las cabezas de nota con formas se
+pueden producir en los estilos @q{Sacred Harp}, @q{Southern
+Harmony}, Funk (Harmonica Sacra), Walker y Aiken @q{(Christian
Harmony)}:
@lilypond[verbatim,quote]
@funindex \walkerHeadsMinor
@funindex walkerHeadsMinor
-Las formas se determinan en función del grado de la escala, donde la
-tónica está determinada por la instrucción @code{\key} Cuando se
-escribe en un tono menor, la nota de la escala se puede determinar a
-partir del relativo mayor:
+Las formas se determinan en función del grado de la escala, donde
+la tónica está determinada por la instrucción @code{\key} Cuando
+se escribe en un tono menor, la nota de la escala se puede
+determinar a partir del relativo mayor:
@lilypond[verbatim,quote]
\relative c'' {
@funindex \improvisationOff
@funindex improvisationOff
-La improvisación se denota a veces mediante cabezas de nota en forma
-de barra inclinada, donde el ejecutante puede elegir cualquier nota
-pero con el ritmo especificado. Estas cabezas de nota se crean así:
+La improvisación se denota a veces mediante cabezas de nota en
+forma de barra inclinada, donde el ejecutante puede elegir
+cualquier nota pero con el ritmo especificado. Estas cabezas de
+nota se crean así:
@lilypond[verbatim,quote]
\new Voice \with {
@c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
@ignore
- Translation of GIT committish: 873151f815f8b8e27eb5231c74e28392561e4668
+ Translation of GIT committish: bcd127bc07fc7b53704f9db8a6cf3d53e9d4094a
When revising a translation, copy the HEAD committish of the
version that you are working on. For details, see the Contributors'
@lilypondfile[quote]{rhythms-headword.ly}
-Esta sección trata de los ritmos, los silencios, las duraciones, las
-barras y los compases.
+Esta sección trata de los ritmos, los silencios, las duraciones,
+las barras y los compases.
@menu
* Escritura de las duraciones (valores rítmicos)::
@funindex \maxima
@funindex maxima
-Las duraciones se designan mediante números y puntos. Las duraciones
-se introducen como sus valores recíprocos respecto de la redonda. Por
-ejemplo, una negra se escribe usando un @code{4} (puesto que es 1/4 de
-redonda), mientras que una blanca se escribe con un @code{2} (por ser
-1/2 de redonda). Para notas mayores de la redonda se deben usar las
-instrucciones @code{\longa} (que es una breve doble) y
-@code{\breve}. Se pueden especificar duraciones tan cortas como la
-garrapatea (con el número 128). Son posibles valores más cortos, pero
-sólo como notas unidas por una barra.
+Las duraciones se designan mediante números y puntos. Las
+duraciones se introducen como sus valores recíprocos respecto de
+la redonda. Por ejemplo, una negra se escribe usando un @code{4}
+(puesto que es 1/4 de redonda), mientras que una blanca se escribe
+con un @code{2} (por ser 1/2 de redonda). Para notas mayores de
+la redonda se deben usar las instrucciones @code{\longa} (que es
+una breve doble) y @code{\breve}. Se pueden especificar duraciones
+tan cortas como la garrapatea (con el número 128). Son posibles
+valores más cortos, pero sólo como notas unidas por una barra.
@c Two 64th notes are needed to obtain beams
@lilypond[quote,verbatim]
@end lilypond
Se puede escribir una nota con la duración de una cuádruple breve
-mediante @code{\maxima}, pero esto está contemplado solamente dentro
-de la notación musical antigua. Para ver más detalles, consulte
-@ref{Notación antigua}.
+mediante @code{\maxima}, pero esto está contemplado solamente
+dentro de la notación musical antigua. Para ver más detalles,
+consulte @ref{Notación antigua}.
@cindex duración predeterminada
@cindex predeterminada, duración de la nota
@cindex nota, duración predeterminada
-Si la duración se omite, su valor será el de la duración de la nota
-anterior. Por omisión, el valor de la primera nota es el de una
-negra.
+Si la duración se omite, su valor será el de la duración de la
+nota anterior. Por omisión, el valor de la primera nota es el de
+una negra.
@lilypond[quote,verbatim]
\relative { a' a a2 a a4 a a1 a }
@end lilypond
+Las duraciones aisladas en una secuencia musical toman la altura
+de la nota o acorde anterior.
+
+@lilypond[quote,verbatim]
+\relative {
+ \time 8/1
+ c'' \longa \breve 1 2
+ 4 8 16 32 64 128 128
+}
+@end lilypond
+
@cindex notas, con puntillo
@cindex puntillo, notas con
@cindex notas, con doble puntillo
@end lilypond
Ciertas duraciones no se pueden representar sólo con duraciones
-binarias y puntillos; la única forma de representarlas es ligando dos
-o más notas. Para ver más detalles, consulte @ref{Ligaduras de unión}.
+binarias y puntillos; la única forma de representarlas es ligando
+dos o más notas. Para ver más detalles, consulte @ref{Ligaduras
+de unión}.
Para ver de qué manera se pueden especificar las duraciones de las
sílabas de la letra y cómo alinear la letra a las notas, consulte
@funindex \dotsNeutral
@funindex dotsNeutral
-Normalmente los puntillos se desplazan hacia arriba para evitar las
-líneas del pentagrama, excepto en situaciones de polifonía. Se pueden
-situar los puntillos manualmente encima o debajo de las líneas de la
-pauta; véase @ref{Dirección y posición}.
+Normalmente los puntillos se desplazan hacia arriba para evitar
+las líneas del pentagrama, excepto en situaciones de polifonía. Se
+pueden situar los puntillos manualmente encima o debajo de las
+líneas de la pauta; véase @ref{Dirección y posición}.
@predefined
@code{\autoBeamOn},
@knownissues
@c Deliberately duplicated in Durations and Rests. -gp
-No existe un límite fundamental para las duraciones de los silencios
-(tanto para el más largo como para el más corto), pero el numero de
-glifos es limitado: sólo se pueden imprimir desde el silencio de
-garrapatea (128) hasta el de máxima (8 redondas).
+No existe un límite fundamental para las duraciones de los
+silencios (tanto para el más largo como para el más corto), pero
+el numero de glifos es limitado: sólo se pueden imprimir desde el
+silencio de garrapatea (128) hasta el de máxima (8 redondas).
@node Grupos especiales
@end example
@noindent
-El nomerador de la fracción se imprime encima o debajo de las
+El numerador de la fracción se imprime encima o debajo de las
notas, opcionalmente con un corchete. El grupo especial más común
es el tresillo, en el que 3@tie{}notas tienen el valor que
normalmente tienen@tie{}2:
-@lilypond[quote,verbatim,relative=2]
-a2 \tuplet 3/2 { b4 b b }
-c4 c \tuplet 3/2 { b4 a g }
+@lilypond[quote,verbatim]
+\relative {
+ a'2 \tuplet 3/2 { b4 4 4 }
+ c4 c \tuplet 3/2 { b4 a g }
+}
@end lilypond
@cindex agrupación de grupes especiales
@funindex tupletNeutral
Se pueden colocar manualmente los corchetes de tresillo encima o
-debajo de la pauta; véase @ref{Dirección y posición}.
+debajo de la pauta:
+
+@lilypond[quote,verbatim]
+\relative {
+ \tupletUp \tuplet 3/2 { c''8 d e }
+ \tupletNeutral \tuplet 3/2 { c8 d e }
+ \tupletDown \tuplet 3/2 { f,8 g a }
+ \tupletNeutral \tuplet 3/2 { f8 g a }
+}
+@end lilypond
Los grupos pueden anidarse unos dentro de otros:
}
@end lilypond
-La modificación de los grupos especiales anidados que comienzan en el
-mismo instante musical se debe hacer con @code{\tweak}.
+La modificación de los grupos especiales anidados que comienzan en
+el mismo instante musical se debe hacer con @code{\tweak}.
-Para modificar la duración de las notas sin imprimir un corchete de
-grupo especial, véase @ref{Escalar las duraciones}.
+Para modificar la duración de las notas sin imprimir un corchete
+de grupo especial, véase @ref{Escalar las duraciones}.
@predefined
@code{\tupletUp},
@rlearning{Métodos de trucaje}.
Referencia de la notación:
+@ref{Dirección y posición},
@ref{Gestión del tiempo},
@ref{Escalar las duraciones},
@ref{La instrucción tweak},
@rinternals{TupletNumber},
@rinternals{TimeScaledMusic}.
-@cindex adorno, notas de, dentro de corchetes de grupo especial
-
-@knownissues
-Las notas de adorno se pueden escribir dentro de los corchetes de
-grupo especial, @emph{excepto} cuando un pentagrama comienza por una
-nota de adorno seguida de un grupo de valoración especial. En este
-caso concreto, se debe poner la nota de adorno antes de la instrucción
-@code{\tuplet} para evitar errores.
-
-@cindex indicaciones de tempo dentro de corchetes de grupo especial
-
-Cuando se utiliza un grupo de valoración especial al comienzo de una
-pieza con una indicación de @code{\tempo}, la música se debe escribir
-explícitamente dentro de un bloque @code{\new Voice}, tal y como se
-explica en @rlearning{Las voces contienen música}.
-
@node Escalar las duraciones
@unnumberedsubsubsec Escalar las duraciones
@cindex escalar las duraciones
@cindex duraciones, escalado de
-La duración de las figuras, silencios o acordes se puede multiplicar
-por un factor @code{N/M} añadiendo @code{*N/M} (o @code{*N} si @code{M} es
-1) a la duración. Esto no afectará a la apariencia de las notas o
-silencios que se producen, pero la duración alterada se usará para
-calcular la posición dentro del compás y para establecer la duración
-en la salida MIDI. Los factores de multiplicación se pueden combinar
-en la forma @code{*L*M/N}. Los factores son parte de la duración: si
-no especificamos una duración para las notas siguientes, la duración
-por omisión que se toma de la nota anterior incluirá cualquier factor
-de escala que se haya aplicado.
+La duración de las figuras, silencios o acordes se puede
+multiplicar por un factor @code{N/M} añadiendo @code{*N/M} (o
+@code{*N} si @code{M} es 1) a la duración. Esto no afectará a la
+apariencia de las notas o silencios que se producen, pero la
+duración alterada se usará para calcular la posición dentro del
+compás y para establecer la duración en la salida MIDI. Los
+factores de multiplicación se pueden combinar en la forma
+@code{*L*M/N}. Los factores son parte de la duración: si no
+especificamos una duración para las notas siguientes, la duración
+por omisión que se toma de la nota anterior incluirá cualquier
+factor de escala que se haya aplicado.
-En el siguiente ejemplo las tres primeras notas duran exactamente dos
-partes, pero no se imprime ningún corchete de tresillo.
+En el siguiente ejemplo las tres primeras notas duran exactamente
+dos partes, pero no se imprime ningún corchete de tresillo.
@lilypond[quote,verbatim]
\relative {
}
@end lilypond
-La duración de los silencios espaciadores también se puede modificar
-mediante un multiplicador. Esto es útil para saltar muchos compases,
-como por ejemplo @code{s1*23}.
+La duración de los silencios espaciadores también se puede
+modificar mediante un multiplicador. Esto es útil para saltar
+muchos compases, como por ejemplo @code{s1*23}.
@cindex compresión de música
@cindex expansión de música
De la misma forma, se pueden comprimir por una fracción trozos de
música más largos, como si cada nota, acorde o silencio tuviera la
-fracción como multiplicador. Esto dejará intacta la apariencia de la
-@emph{música}, pero la duración interna de las notas se multiplicará
-por la fracción @emph{numerador}/@emph{denominador}.
-He aquí un ejemplo que muestra cómo
-se puede comprimir y expandir la música:
+fracción como multiplicador. Esto dejará intacta la apariencia de
+la @emph{música}, pero la duración interna de las notas se
+multiplicará por la fracción @emph{numerador}/@emph{denominador}.
+He aquí un ejemplo que muestra cómo se puede comprimir y expandir
+la música:
@lilypond[quote,verbatim]
\relative {
@funindex ~
-Una ligadura de unión conecta dos notas adyacentes de la misma altura. La ligadura
-en efecto extiende la longitud de una nota.
+Una ligadura de unión conecta dos notas adyacentes de la misma
+altura. La ligadura en efecto extiende la longitud de una nota.
@warning{No deben confundirse las ligaduras de unión con las
-@emph{ligaduras de expresión}, que indican articulación, ni con las
-@emph{ligaduras de fraseo}, que indican el fraseo musical. Una
-ligadura de unión es tan sólo una manera de extender la duración de
-una nota, algo parecido a lo que hace el puntillo.}
+@emph{ligaduras de expresión}, que indican articulación, ni con
+las @emph{ligaduras de fraseo}, que indican el fraseo musical.
+Una ligadura de unión es tan sólo una manera de extender la
+duración de una nota, algo parecido a lo que hace el puntillo.}
Se introduce una ligadura de unión escribiendo el símbolo de la
tilde curva (@code{~}) después de la primera de cada pareja de
{ a'2~ 4~ 16 r r8 }
@end lilypond
+Las ligaduras de unión pueden hacer uso de la interpretación
+@q{última altura explícita} para las duraciones aisladas:
+
+@lilypond[quote,verbatim]
+{ a'2~ 4~ 16 r r8 }
+@end lilypond
+
Se usan ligaduras de unión bien cuando la nota atraviesa la barra de
compás o bien cuando no se pueden usar puntillos para denotar el
ritmo. También se deben usar ligaduras cuando las notas atraviesan
@c KEEP LY
@lilypond[verbatim,quote]
-\relative c' {
- r8^"sí" c~ 2 r4 |
+\relative {
+ r8^"sí" c'~ 2 r4 |
r8^"no" c2~ 8 r4
}
@end lilypond
-Si necesitamos ligar muchas notas a través de las líneas divisorias,
-nos podría resultar más fácil utilizar la división automática de las
-notas, véase @ref{División automática de las notas}. Este mecanismo divide
-automáticamente las notas largas y las liga a través de las barras de
-compás.
+Si necesitamos ligar muchas notas a través de las líneas
+divisorias, nos podría resultar más fácil utilizar la división
+automática de las notas, véase @ref{División automática de las
+notas}. Este mecanismo divide automáticamente las notas largas y
+las liga a través de las barras de compás.
@cindex ligaduras y acordes
@cindex acordes y ligaduras
-Cuando se aplica una ligadura de unión a un acorde, se conectan todas
-las cabezas de las notas cuyas alturas coinciden. Si no coincide
-ningún par de cabezas, no se crea ninguna ligadura. Los acordes se
-pueden ligar parcialmente colocando las ligaduras dentro del acorde.
+Cuando se aplica una ligadura de unión a un acorde, se conectan
+todas las cabezas de las notas cuyas alturas coinciden. Si no
+coincide ningún par de cabezas, no se crea ninguna ligadura. Los
+acordes se pueden ligar parcialmente colocando las ligaduras
+dentro del acorde.
-@lilypond[quote,verbatim,relative=1]
-<c e g>~ <c e g c>
-<c~ e g~ b> <c e g b>
+@lilypond[quote,verbatim]
+\relative c' {
+ <c e g>2~ 2 |
+ <c e g>4~ <c e g c>
+ <c~ e g~ b> <c e g b> |
+}
@end lilypond
@cindex repetición, ligaduras de unión en
@funindex laissezVibrer
Las ligaduras @notation{L.v.} (@notation{laissez vibrer}, dejar
-vibrar) indican que las notas no se deben apagar al final. Se usan en
-la notación para piano, arpa y otros instrumentos de cuerda y
-percusión. Se pueden introducir de la siguiente manera:
+vibrar) indican que las notas no se deben apagar al final. Se
+usan en la notación para piano, arpa y otros instrumentos de
+cuerda y percusión. Se pueden introducir de la siguiente manera:
@lilypond[quote,verbatim,fragment]
<c' f' g'>1\laissezVibrer
}
@end lilypond
-Las definiciones de patrones de discontinuidad para las ligaduras de
-unión tienen la misma estructura que las definiciones de patrones de
-discontinuidad para las ligaduras de expresión. Para ver más
-información acerca de los patrones de discontinuidad complejos,
-consulte los fragmentos de código bajo @ref{Ligaduras de expresión}.
+Las definiciones de patrones de discontinuidad para las ligaduras
+de unión tienen la misma estructura que las definiciones de
+patrones de discontinuidad para las ligaduras de expresión. Para
+ver más información acerca de los patrones de discontinuidad
+complejos, consulte los fragmentos de código bajo
+@ref{Ligaduras de expresión}.
Sobreescriba las propiedades de disposición @var{whiteout} y
-@var{layer} para las ligaduras de unión que colisionen con otros
-objetos del pentagrama.
+@var{layer} de los objetos que puedan causar una discontinuidad en
+las ligaduras de unión.
@lilypond[verbatim,quote,ragged-right]
\relative {
@endpredefined
@snippets
+
@lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
{using-ties-with-arpeggios.ly}
@rinternals{Tie}.
@knownissues
-Un cambio de pentagrama cuando hay una ligadura activa no producirá
-una ligadura inclinada.
+Un cambio de pentagrama cuando hay una ligadura activa no
+producirá una ligadura inclinada.
Los cambios de clave o de octava durante una ligadura de unión no
-están bien definidos realmente. En estos casos puede ser preferible
-una ligadura de expresión.
+están bien definidos realmente. En estos casos puede ser
+preferible una ligadura de expresión.
@node Escritura de silencios
@funindex \breve
@funindex breve
-Los silencios se introducen como notas con el nombre @code{r}. Las
-duraciones mayores que la redonda utilizan las instrucciones
+Los silencios se introducen como notas con el nombre @code{r}.
+Las duraciones mayores que la redonda utilizan las instrucciones
predefinidas que se muestran aquí:
@c \time 16/1 is used to avoid spurious bar lines
@cindex silencios multicompás
@cindex silencios de compás completo
-Los silencios de un compás, centrados en medio del compás, se deben
-hacer con silencios multicompás. Se pueden usar para un solo compás
-así como para muchos compases, y se tratan en @ref{Silencios de compás completo}.
+Los silencios de un compás, centrados en medio del compás, se
+deben hacer con silencios multicompás. Se pueden usar para un
+solo compás así como para muchos compases, y se tratan en
+@ref{Silencios de compás completo}.
@cindex silencio, especificar la posición vertical
-Para especificar explícitamente la posición vertical de un silencio,
-escriba una nota seguida de @code{\rest}. Se colocará un silencio en
-la posición en que debería aparecer la nota. Esto posibilita la
-aplicación manual precisa de formato a la música polifónica, ya que el
-formateador automático de colisiones de silencios no mueve estos
-silencios.
+Para especificar explícitamente la posición vertical de un
+silencio, escriba una nota seguida de @code{\rest}. Se colocará
+un silencio en la posición en que debería aparecer la nota. Esto
+posibilita la aplicación manual precisa de formato a la música
+polifónica, ya que el formateador automático de colisiones de
+silencios no mueve estos silencios.
@lilypond[quote,verbatim]
\relative { a'4\rest d4\rest }
@end lilypond
@snippets
+
@lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
{rest-styles.ly}
@knownissues
@c Deliberately duplicated in Durations and Rests. -gp
No existe un límite fundamental respecto de las duraciones de los
-silencios (tanto para el más corto como para el más largo), pero el
-número de glifos es limitado: hay silencios desde la garrapatea (128)
-hasta la máxima (8 redondas).
+silencios (tanto para el más corto como para el más largo), pero
+el número de glifos es limitado: hay silencios desde la garrapatea
+(128) hasta la máxima (8 redondas).
@node Silencios invisibles
@cindex letra, desplazamiento de
-Los silencios de separación sólo están disponible en el modo de notas
-y en el modo de acordes. En otras situaciones, por ejemplo, cuando se
-introduce la letra, se usa la instrucción @code{\skip} para producir
-un desplazamiento de una cierta magnitud temporal. @code{\skip}
-requiere una duración explícita, pero se ignora si las sílabas de la
-letra toman sus duraciones de las notas de una melodía asociada, a
-través de @code{\addlyrics} o de @code{\lyricsto}.
+Los silencios de separación sólo están disponible en el modo de
+notas y en el modo de acordes. En otras situaciones, por ejemplo,
+cuando se introduce la letra, se usa la instrucción @code{\skip}
+para producir un desplazamiento de una cierta magnitud temporal.
+@code{\skip} requiere una duración explícita, pero se ignora si
+las sílabas de la letra toman sus duraciones de las notas de una
+melodía asociada, a través de @code{\addlyrics} o de
+@code{\lyricsto}.
@lilypond[quote,verbatim]
<<
>>
@end lilypond
-Dado que @code{\skip} es una instrucción, no afecta a las duraciones
-por omisión de las notas siguientes, a diferencia de@tie{}@code{s}.
+Dado que @code{\skip} es una instrucción, no afecta a las
+duraciones por omisión de las notas siguientes, a diferencia
+de@tie{}@code{s}.
@lilypond[quote,verbatim]
<<
@end lilypond
Un silencio de separación produce implícitamente contextos
-@code{Staff} y @code{Voice} si no existe ninguno, igual que las notas
-y los silencios normales:
+@code{Staff} y @code{Voice} si no existe ninguno, igual que las
+notas y los silencios normales:
@lilypond[quote,verbatim]
{ s1 s s }
@end lilypond
-@code{\skip} tan sólo desplaza un tiempo musical; no produce ninguna
-salida, de ninguna clase.
+@code{\skip} tan sólo desplaza un tiempo musical; no produce
+ninguna salida, de ninguna clase.
@lilypond[quote,verbatim]
% This is valid input, but does nothing
@cindex redonda, silencios de, para un compás completo
@cindex silencios de redonda para un compás completo
+@funindex compressMMRests
+@funindex \compressMMRests
@funindex R
-Los silencios de uno o más compases completos se introducen como notas
-con el nombre @code{R} en mayúscula:
+Los silencios de uno o más compases completos se introducen como
+notas con el nombre @code{R} en mayúscula:
-@lilypond[quote,verbatim,relative=2]
+@lilypond[quote,verbatim]
% Rest measures contracted to single measure
-\compressFullBarRests
-R1*4
-R1*24
-R1*4
-b2^"Tutti" b4 a4
+\compressMMRests {
+ R1*4
+ R1*24
+ R1*4
+ b'2^"Tutti" b'4 a'4
+}
@end lilypond
La duración de los silencios de compás completo es idéntica a la
-notación de la duración que se usa para las notas. La duración de un
-silencio multi-compás debe ser siempre un número entero de compases,
-por lo que con frecuencia han de utilizarse puntillos o fracciones:
-
-@lilypond[quote,verbatim,relative=2]
-\compressFullBarRests
-\time 2/4
-R1 | R2 |
-\time 3/4
-R2. | R2.*2 |
-\time 13/8
-R1*13/8 | R1*13/8*12 |
-\time 10/8
-R4*5*4 |
+notación de la duración que se usa para las notas. La duración de
+un silencio multi-compás debe ser siempre un número entero de
+compases, por lo que con frecuencia han de utilizarse puntillos o
+fracciones:
+
+@lilypond[quote,verbatim]
+\compressMMRests {
+ \time 2/4
+ R1 | R2 |
+ \time 3/4
+ R2. | R2.*2 |
+ \time 13/8
+ R1*13/8 | R1*13/8*12 |
+ \time 10/8
+ R4*5*4 |
+}
@end lilypond
Un silencio de un compás completo se imprime como un silencio de
@cindex multicompás, silencios, expansión de
@cindex multicompás, silencios, contracción de
-@funindex \expandFullBarRests
-@funindex expandFullBarRests
-@funindex \compressFullBarRests
-@funindex compressFullBarRests
-
De forma predeterminada un silencio multicompás se expande en la
-partitura impresa para mostrar explícitamente todos los compases de
-silencio. De forma alternativa, un silencio multicompás se puede
-presentar como un solo compás que contiene un símbolo de silencio
-multicompás, con el número de compases impreso encima del compás:
+partitura impresa para mostrar explícitamente todos los compases
+de silencio. De forma alternativa, un silencio multicompás se
+puede presentar como un solo compás que contiene un símbolo de
+silencio multicompás, con el número de compases impreso encima del
+compás:
-@lilypond[quote,verbatim,relative=2]
+@lilypond[quote,verbatim,fragment]
% Default behavior
\time 3/4 r2. | R2.*2 |
\time 2/4 R2 |
\time 4/4
% Rest measures contracted to single measure
-\compressFullBarRests
-r1 | R1*17 | R1*4 |
-% Rest measures expanded
-\expandFullBarRests
+\compressMMRests {
+ r1 | R1*17 | R1*4 |
+}
+% Rest measures expanded again
\time 3/4
R2.*2 |
@end lilypond
@funindex fermataMarkup
@funindex MultiMeasureRestText
-Se pueden añadir elementos de marcado a los silencios multicompás. Se
-proporciona la instrucción predefinida @code{\fermataMarkup} para
-añadir calderones.
+Se pueden añadir elementos de marcado a los silencios multicompás.
+Se proporciona la instrucción predefinida @code{\fermataMarkup}
+para añadir calderones.
-@lilypond[quote,verbatim,relative=2]
-\compressFullBarRests
-\time 3/4
-R2.*10^\markup { \italic "ad lib." }
-R2.^\fermataMarkup
+@lilypond[quote,verbatim]
+\compressMMRests {
+ \time 3/4
+ R2.*10^\markup { \italic "ad lib." }
+ R2.^\fermataMarkup
+}
@end lilypond
@warning{Los elementos de marcado que se añaden a un silencio
multicompás son objetos del tipo @code{MultiMeasureRestText}, no
@code{TextScript}. Las sobreescrituras de propiedades deben ir
-dirigidas hacia el objeto correcto, o se ignorarán. Véase el ejemplo
-siguiente:}
+dirigidas hacia el objeto correcto, o se ignorarán. Véase el
+ejemplo siguiente:}
@lilypond[quote,verbatim,fragment]
% This fails, as the wrong object name is specified
R1^"right"
@end lilypond
-Cuando un silencio multicompás sigue inmediatamente al establecimiento
-de un compás parcial con @code{\partial}, es posible que no se emitan
-las advertencias correspondientes de comprobación de compás.
+Cuando un silencio multicompás sigue inmediatamente al
+establecimiento de un compás parcial con @code{\partial}, es
+posible que no se emitan las advertencias correspondientes de
+comprobación de compás.
@funindex \textLengthOn
@funindex textLengthOn
@funindex textLengthOff
@funindex \fermataMarkup
@funindex fermataMarkup
-@funindex \compressFullBarRests
-@funindex compressFullBarRests
-@funindex \expandFullBarRests
-@funindex expandFullBarRests
+@funindex \compressMMRests
+@funindex compressMMRests
@predefined
@code{\textLengthOn},
@code{\textLengthOff},
@code{\fermataMarkup},
-@code{\compressFullBarRests},
-@code{\expandFullBarRests}.
+@code{\compressMMRests}.
@endpredefined
+
@snippets
@cindex eclesiásticos, silencios
@cindex silencios eclesiásticos
@cindex condensar silencios
@cindex silencio normal, condensar
-No hay ninguna forma de condensar automáticamente muchos silencios en
-un solo silencio multicompás.
+No hay ninguna forma de condensar automáticamente muchos silencios
+en un solo silencio multicompás.
@cindex silencio, colisiones de
\time 3/4 c''2.
@end lilypond
+Se estudian los cambios de indicación de compás en el medio de un
+compás en @ref{Anacrusas}.
+
@cindex compás, visibilidad de la indicación de
-La indicación de compás se imprime al comienzo de una pieza y siempre
-que hay un cambio de compás. Si se produce un cambio al final de una
-línea, se imprime una indicación de advertencia en dicho lugar. Se
-puede modificar este comportamiento predeterminado, véase
-@ref{Visibilidad de los objetos}.
+La indicación de compás se imprime al comienzo de una pieza y
+siempre que hay un cambio de compás. Si se produce un cambio al
+final de una línea, se imprime una indicación de advertencia en
+dicho lugar. Se puede modificar este comportamiento
+predeterminado, véase @ref{Visibilidad de los objetos}.
@lilypond[quote,verbatim]
\relative c'' {
predefinidos de estas propiedades están en
@file{scm/time-signature-settings.scm}.
-El valor predeterminado de @code{beatStructure} puede sobreescribirse
-dentro de la propia instrucción @code{\time} escribiéndolo como primer
-argumento opcional:
+El valor predeterminado de @code{beatStructure} puede
+sobreescribirse dentro de la propia instrucción @code{\time}
+escribiéndolo como primer argumento opcional:
@lilypond[quote,verbatim]
\score {
De forma alternativa, los valores predeterminados de todoas estas
variables basadas en la indicación de compás, incluidas
@code{baseMoment} y @code{beamExceptions}, se pueden establecer
-juntas. Los valores se pueden fijar independientemente para varios
-tipos de compás distintos. Los nuevos valores tienen efecto cuando se
-ejecuta una instrucción @code{\time} posterior con el mismo valor del
-tipo de compás:
+juntas. Los valores se pueden fijar independientemente para
+varios tipos de compás distintos. Los nuevos valores tienen
+efecto cuando se ejecuta una instrucción @code{\time} posterior
+con el mismo valor del tipo de compás:
@lilypond[quote,verbatim]
\score {
@enumerate
@item
-@code{@var{timeSignatureFraction}}, una fracción que describe
-el tipo de compás al que se aplican estos valores.
+@code{@var{timeSignatureFraction}}, una fracción que describe el
+tipo de compás al que se aplican estos valores.
@item
@code{@var{baseMomentFraction}}, una fracción que contiene el
-numerador y denominador de la unidad de medida básica de ese tipo de
-compás.
+numerador y denominador de la unidad de medida básica de ese tipo
+de compás.
@item
@code{@var{beatStructure}}, una lista de Scheme que indica la
@cindex restaurar las propiedades predeterminadas del tipo de compás
@funindex \revertTimeSignatureSettings
-Los valores modificados de las propiedades predeterminadas del tipo de
-compás se pueden restaurar a los valores originales:
+Los valores modificados de las propiedades predeterminadas del
+tipo de compás se pueden restaurar a los valores originales:
@lilypond[quote,verbatim]
\score{
Se pueden establecer diferentes valores de las propiedades
predeterminadas del tipo de compás para los distintos pentagramas
moviendo el @code{Timing_translator} y el
-@code{Default_bar_line_engraver} del contexto @code{Score} al contexto
-@code{Staff}.
+@code{Default_bar_line_engraver} del contexto @code{Score} al
+contexto @code{Staff}.
@lilypond[quote, verbatim]
\score {
}
@end lilypond
-Otro método para cambiar estas variables relacionadas con el tipo de
-compás, que evita la reimpresión de la indicación de compás en el
-momento del cambio, se muestra en
-@ref{Establecer el comportamiento de las barras automáticas}.
+Otro método para cambiar estas variables relacionadas con el tipo
+de compás, que evita la reimpresión de la indicación de compás en
+el momento del cambio, se muestra en @ref{Establecer el
+comportamiento de las barras automáticas}.
@predefined
@code{\numericTimeSignature},
}
@end lilypond
-También se pueden imprimir indicaciones metronómicas
-como un intervalo entre dos números:
+También se pueden imprimir indicaciones metronómicas como un
+intervalo entre dos números:
@lilypond[verbatim,quote]
\relative {
}
@end lilypond
-La combinación de una indicación metronómica y un texto hace que la
-marca de metrónomo se encierre entre paréntesis automáticamente:
+La combinación de una indicación metronómica y un texto hace que
+la marca de metrónomo se encierre entre paréntesis
+automáticamente:
@lilypond[verbatim,quote]
\relative {
predeterminado de ignorar las indicaciones de tempo para el
espaciado horizontal.
-@lilypond[verbatim,quote,relative=0]
-\compressFullBarRests
-\markLengthOn
-\tempo "Molto vivace"
-R1*12
-\tempo "Meno mosso"
-R1*16
-\markLengthOff
-\tempo "Tranquillo"
-R1*20
+@lilypond[verbatim,quote]
+\compressMMRests {
+ \markLengthOn
+ \tempo "Molto vivace"
+ R1*12
+ \tempo "Meno mosso"
+ R1*16
+ \markLengthOff
+ \tempo "Tranquillo"
+ R1*20
+}
@end lilypond
@snippets
@cindex compás parcial
@cindex parcial, compás
@cindex compás de anacrusa
+@cindex compás, indicación de, en medio de un compás
@funindex measurePosition
@funindex \partial
@funindex partial
-Los compases parciales como las @emph{anacrusas} o partes
-@emph{al alzar} se escriben usando la instrucción
-@code{\partial}:
+Los compases parciales como las @emph{anacrusas} o partes @emph{al
+alzar} se escriben usando la instrucción @code{\partial}:
@example
\partial @var{duración}
@end example
-@noindent
-donde @code{@var{duración}} es la longitud @emph{restante}
-del compás parcial @emph{antes} del comienzo del siguiente
-compás completo.
-
-@lilypond[quote,verbatim,relative=1]
-\time 3/4
-\partial 8
-e8 | a4 c8 b c4 |
-@end lilypond
-
-La @var{duración} puede ser cualquier valor menor de un compás
-completo:
+Cuando se usa @code{\partial} al principio de la partitura,
+@code{@var{duración}} es el tiempo de anacrusa, la longitud de la
+música que precede al primer compás.
@lilypond[quote,verbatim]
\relative {
}
@end lilypond
-El @code{\partial @var{duración}} se puede también escribir como:
+Cuando se usa @code{\partial} después del comienzo de la
+partitura, @code{@var{duración}} es la longitud @emph{restante}
+del compás actual. No crea un nuevo compás con numeración.
-@example
-\set Timing.measurePosition -@var{duración}
-@end example
+@lilypond[quote,verbatim]
+\relative {
+ \set Score.barNumberVisibility = #all-bar-numbers-visible
+ \override Score.BarNumber.break-visibility =
+ #end-of-line-invisible
+ \time 9/8
+ d''4.~ 4 d8 d( c) b | c4.~ 4. \bar "||"
+ \time 12/8
+ \partial 4.
+ c8( d) e | f2.~ 4 f8 a,( c) f |
+}
+@end lilypond
-Así que el primer ejemplo podría haberse escrito así:
+La instrucción @code{\partial} es @emph{necesaria} cuando cambia
+la indicación de compás en medio de un compás, pero también puede
+usarse sola.
-@lilypond[quote,verbatim,relative=1]
-\time 3/4
-\set Timing.measurePosition = #(ly:make-moment -1/8)
-e8 | a4 c8 b c4 |
+@lilypond[quote,verbatim]
+\relative {
+ \set Score.barNumberVisibility = #all-bar-numbers-visible
+ \override Score.BarNumber.break-visibility =
+ #end-of-line-invisible
+ \time 6/8
+ \partial 8
+ e'8 | a4 c8 b[ c b] |
+ \partial 4
+ r8 e,8 | a4 \bar "||"
+ \partial 4
+ r8 e8 | a4
+ c8 b[ c b] |
+}
@end lilypond
-La propiedad @code{measurePosition} contiene un número racional,
-que suele ser positivo y que indica qué porción del compás ha
-transcurrido hasta ahora en este punto. La instrucción
-@code{\partial @var{duración}} lo establece a un número negativo,
-en cuyo caso tiene un significado distinto: en esta ocasión indica
-que el compás actual (el primero) será @emph{precedido} por un
-compás cero (el compás parcial) con una duración dada por el valor
-@var{duración}.
+La instrucción @code{\partial} fija la propiedad
+@code{Timing.measurePosition}, que un número racional que indica
+cuánto tiempo ha transcurrido dentro del compás actual.
@seealso
Glosario musical:
Referencia de funcionamiento interno:
@rinternals{Timing_translator}.
-@knownissues
-La instrucción @code{\partial} debe usarse solamente en el comienzo de
-una pieza. Si se emplea después del comienzo se obtendrán varias
-advertencias o efectos desagradables, en este caso utilice en su lugar
-@code{\set Timing.measurePosition}.
-
-@lilypond[quote,verbatim,relative=1]
-\time 6/8
-\partial 8
-e8 | a4 c8 b[ c b] |
-\set Timing.measurePosition = #(ly:make-moment -1/4)
-r8 e,8 | a4 c8 b[ c b] |
-@end lilypond
-
@node Música sin compasear
@unnumberedsubsubsec Música sin compasear
@funindex \cadenzaOff
@funindex cadenzaOff
-En la música medida se insertan líneas divisorias
-y se calculan los números de compás automáticamente.
-En música sin metro (es decir, cadencias), esto no es deseable
-y se puede @q{desactivar} usando la instrucción
-@code{\cadenzaOn}, para despúes @q{reactivarlo} en el lugar
-adecuado usando @code{\cadenzaOff}.
+En la música medida se insertan líneas divisorias y se calculan
+los números de compás automáticamente. En música sin metro (es
+decir, cadencias), esto no es deseable y se puede @q{desactivar}
+usando la instrucción @code{\cadenzaOn}, para despúes
+@q{reactivarlo} en el lugar adecuado usando @code{\cadenzaOff}.
@lilypond[verbatim,quote]
\relative c'' {
@end lilypond
El barrado automático se desactiva mediante @code{\cadenzaOn}.
-Por tanto, todo el barrado en las
-cadencias se debe introducir manualmente.
-Véase @ref{Barras manuales}.
+Por tanto, todo el barrado en las cadencias se debe introducir
+manualmente. Véase @ref{Barras manuales}.
@lilypond[verbatim,quote]
\relative {
}
@end lilypond
-Estas instrucciones predefinidas afectan a todas las
-pautas de la partitura, aunque aparezcan en un solo contexto
-@code{Voice}. Para cambiar esto, traslade el
-@code{Timing_translator} del contexto @code{Score} al contexto
-@code{Staff}, véase @ref{Notación polimétrica}.
+Estas instrucciones predefinidas afectan a todas las pautas de la
+partitura, aunque aparezcan en un solo contexto @code{Voice}.
+Para cambiar esto, traslade el @code{Timing_translator} del
+contexto @code{Score} al contexto @code{Staff}, véase
+@ref{Notación polimétrica}.
@predefined
@code{\cadenzaOn},
@cindex saltos de página, música sin medida
@knownissues
-Sólo se insertan saltos de línea y de página automáticamente
-en las líneas divisorias,
-por lo que es necesario insertar manualmente líneas divisorias
-@q{invisibles} en fragmentos largos de música sin medir para permitir
-los saltos:
+Sólo se insertan saltos de línea y de página automáticamente en
+las líneas divisorias, por lo que es necesario insertar
+manualmente líneas divisorias @q{invisibles} en fragmentos largos
+de música sin medir para permitir los saltos:
@example
\bar ""
@funindex tuplet
Está contemplada la notación polimétrica, ya sea explícitamente o
-mediante la modificación manual de la indicación visible del compás y/o el
-escalado de la duración de las notas.
+mediante la modificación manual de la indicación visible del
+compás y/o el escalado de la duración de las notas.
@subsubsubheading Pentagramas con distintas indicaciones de compás y compases de igual longitud
-Establezca una indicación de compás común para cada pentagrama, y fije
-@code{timeSignatureFraction} a la fracción deseada. Luego use la función
-@code{\scaleDurations} para escalar las duraciones de las notas en cada
-pauta a la indicación de compás común.
+Establezca una indicación de compás común para cada pentagrama, y
+fije @code{timeSignatureFraction} a la fracción deseada. Luego
+use la función @code{\scaleDurations} para escalar las duraciones
+de las notas en cada pauta a la indicación de compás común.
@cindex barras en música polimétrica
@cindex polimétrico, metro, barras en
-En el siguiente ejemplo, se usa en paralelo música con compases de 3/4, 9/8 y
-10/8. En el segundo pentagrama, las duraciones mostradas se
-multiplican por 2/3 (pues 2/3 * 9/8 = 3/4), y en el tercer pentagrama,
-las duraciones que se muestran están multiplicadas por 3/5 (pues 3/5 *
-10/8 = 3/4). Con frecuencia habrá que insertar las barras de
-forma manual, pues el escalado de las duraciones afecta a las reglas
-de barrado automático.
+En el siguiente ejemplo, se usa en paralelo música con compases de
+3/4, 9/8 y 10/8. En el segundo pentagrama, las duraciones
+mostradas se multiplican por 2/3 (pues 2/3 * 9/8 = 3/4), y en el
+tercer pentagrama, las duraciones que se muestran están
+multiplicadas por 3/5 (pues 3/5 * 10/8 = 3/4). Con frecuencia
+habrá que insertar las barras de forma manual, pues el escalado de
+las duraciones afecta a las reglas de barrado automático.
@lilypond[quote,verbatim]
\relative <<
@subsubsubheading Pentagramas con distintas indicaciones de compás y longitudes de compás distintas
Se puede dar a cada pentagrama su propia indicación de compás
-independiente trasladando los grabadores @code{Timing_translator} y
-@code{Default_bar_line_engraver} al contexto de @code{Staff}.
+independiente trasladando los grabadores @code{Timing_translator}
+y @code{Default_bar_line_engraver} al contexto de @code{Staff}.
@lilypond[quote,verbatim]
\layout {
@end example
La construcción más simple es una lista única, en la que el
-@emph{último} número indica el denominador de la indicación de compás
-y los anteriores son los numeradores.
+@emph{último} número indica el denominador de la indicación de
+compás y los anteriores son los numeradores.
@lilypond[quote,verbatim]
\relative {
@knownissues
Al usar distintos compases en paralelo, las notas que están en el
-mismo instante de tiempo se colocan en la misma posición horizontal.
-Sin embargo, las barras de compás en los distintos pentagramas harán
-que el espaciado de notas sea menos regular en cada pentagrama
-individual de lo que sería normal sin las distintas indicaciones de
-compás.
+mismo instante de tiempo se colocan en la misma posición
+horizontal. Sin embargo, las barras de compás en los distintos
+pentagramas harán que el espaciado de notas sea menos regular en
+cada pentagrama individual de lo que sería normal sin las
+distintas indicaciones de compás.
@node División automática de las notas
@funindex Completion_heads_engraver
@funindex Completion_rest_engraver
-Las notas largas se pueden convertir automáticamente en notas ligadas.
-Se hace mediante la sustitución del @code{Note_heads_engraver} por el
-@code{Completion_heads_engraver}. De forma similar, los silencios largos que
-sobrepasan líneas de compás se dividen automáticamente sustituyendo el
-grabador @code{Rest_engraver} con el grabador @code{Completion_rest_engraver}.
-En el ejemplo siguiente, las notas y los silencios que atraviesan la barra
-de compás se dividen, y además las notas se unen mediante una ligadura.
+Las notas largas se pueden convertir automáticamente en notas
+ligadas. Se hace mediante la sustitución del
+@code{Note_heads_engraver} por el
+@code{Completion_heads_engraver}. De forma similar, los silencios
+largos que sobrepasan líneas de compás se dividen automáticamente
+sustituyendo el grabador @code{Rest_engraver} con el grabador
+@code{Completion_rest_engraver}. En el ejemplo siguiente, las
+notas y los silencios que atraviesan la barra de compás se
+dividen, y además las notas se unen mediante una ligadura.
@lilypond[quote,verbatim]
\new Voice \with {
@end lilypond
Estos grabadores dividen todas las notas y silencios largos en la
-barra de compás, e inserta ligaduras en las notas.
-Uno de sus usos es depurar partituras complejas:
-si los compases no están completos, las ligaduras mostrarán
-exactamente cuánto le falta a cada compás.
+barra de compás, e inserta ligaduras en las notas. Uno de sus
+usos es depurar partituras complejas: si los compases no están
+completos, las ligaduras mostrarán exactamente cuánto le falta a
+cada compás.
+
+La propiedad @code{completionUnit} fija una duración preferida
+para las notas divididas.
+
+@lilypond[quote,verbatim]
+\new Voice \with {
+ \remove "Note_heads_engraver"
+ \consists "Completion_heads_engraver"
+} \relative {
+ \time 9/8 g\breve. d''4. \bar "||"
+ \set completionUnit = #(ly:make-moment 3 8)
+ g\breve. d4.
+}
+@end lilypond
+
+Estos grabadores dividen las notas que tienen la duración
+escalada, como las de los tresillos, en notas que tienen el mismo
+factor de escala que la nota original de la entrada.
+
+@lilypond[quote,verbatim]
+\new Voice \with {
+ \remove "Note_heads_engraver"
+ \consists "Completion_heads_engraver"
+} \relative {
+ \time 2/4 r4
+ \tuplet 3/2 {g'4 a b}
+ \scaleDurations 2/3 {g a b}
+ g4*2/3 a b
+ \tuplet 3/2 {g4 a b}
+ r4
+}
+@end lilypond
@seealso
Glosario musical:
@rinternals{Forbid_line_break_engraver}.
@knownissues
-No todas las duraciones (sobre todo las que contienen grupos
-especiales) se pueden representar exactamente con notas normales y
-puntillos, pero el grabador @code{Completion_heads_engraver} nunca
-insertará grupos especiales.
-
-@code{Completion_heads_engraver} afecta sólo a las notas; no divide
-silencios.
+Por consistencia con el comportamiento anterior, las notas y
+silencios que tienen una duración mayor de un compás, como
+@code{c1*2}, se dividen en notas sin ningún factor de escala,
+@code{@{ c1 c1 @}}. La propiedad @code{completionFactor} controla
+este comportamiento, y al darle el valor @code{#f} podemos hacer
+que las notas y silencios divididos tengan el mismo factor de
+escala que las duraciones de las notas originales de la entrada.
@node Mostrar los ritmos de la melodía
@cindex duraciones de la melodía, mostrar
A veces podemos querer mostrar solamente el ritmo de una melodía.
-Esto se puede hacer con un pentagrama de ritmo. Todas las alturas de
-las notas se convierten en barras inclinadas, y el pentagrama tiene
-una sola línea:
+Esto se puede hacer con un pentagrama de ritmo. Todas las alturas
+de las notas se convierten en barras inclinadas, y el pentagrama
+tiene una sola línea:
@lilypond[quote,verbatim]
<<
@end lilypond
Cuando estas decisiones automáticas no son lo bastante buenas, se
-pueden escribir los barrados de forma explícita; véase @ref{Barras manuales}. Las barras @emph{se deben} introducir manualmente si se
-quieren extender por encima de los silencios.
+pueden escribir los barrados de forma explícita; véase
+@ref{Barras manuales}. Las barras @emph{se deben} introducir
+manualmente si se quieren extender por encima de los silencios.
Si no se necesita el barrado automático, se puede desactivar con
@code{\autoBeamOff} y activarse con @code{\autoBeamOn}:
@cindex melismas, barras en
@cindex barras y melismas
-@warning{Si se usan barras para indicar los melismas de las canciones,
-entonces se debe desactivar el barrado automático con
-@code{@bs{}autoBeamOff} e indicar las barras manualmente.
-La utilización de @code{@bs{}partcombine} con
-@code{@bs{}autoBeamOff} puede producir resultados no deseados. Véanse
-los fragmentos de código para mayor información.}
+@warning{Si se usan barras para indicar los melismas de las
+canciones, entonces se debe desactivar el barrado automático con
+@code{@bs{}autoBeamOff} e indicar las barras manualmente. La
+utilización de @code{@bs{}partcombine} con @code{@bs{}autoBeamOff}
+puede producir resultados no deseados. Véanse los fragmentos de
+código para mayor información.}
Se pueden crear patrones de barrado que difieran de los valores
-automáticos predeterminados; véase @ref{Establecer el comportamiento de las barras automáticas}.
+automáticos predeterminados; véase
+@ref{Establecer el comportamiento de las barras automáticas}.
@predefined
@code{\autoBeamOff},
@knownissues
Las propiedades de una barra vienen determinadas al
@emph{comienzo} de su construcción y cualquier cambio adicional en
-las propiedades de la barra que se produzca antes de que la barra se ha
-completado no tendrá efecto hasta que inicie la @emph{siguiente}
-barra nueva.
+las propiedades de la barra que se produzca antes de que la barra
+se ha completado no tendrá efecto hasta que inicie la
+@emph{siguiente} barra nueva.
@node Establecer el comportamiento de las barras automáticas
@funindex autoBeaming
@funindex baseMoment
@funindex beamExceptions
+@funindex \beamExceptions
@funindex beatStructure
@funindex measureLength
@funindex \time
barras; se ignoran los valores de @code{baseMoment} y
@code{beatStructure}.
-Si no está definida ninguna regla de
-@code{beamExceptions} para el tipo de compás en curso, la
-colocación de las barras está determinada por los valores de
-@code{baseMoment} y @code{beatStructure}.
+Si no está definida ninguna regla de @code{beamExceptions} para el
+tipo de compás en curso, la colocación de las barras está
+determinada por los valores de @code{baseMoment} y
+@code{beatStructure}.
@subsubsubheading Barrado basado en @code{baseMoment} y @code{beatStructure}
el denominador del compás. De forma predeterminada también, cada
unidad de longitud @code{baseMoment} es un único pulso.
+Observe que existen valores de @code{beatStructure} y de
+@code{baseMoment} diferentes para cada indicación de compás. Los
+cambios que se hacen a estas variables se aplican solamente al
+tipo de compás en vigor, por lo que dichos cambios se deben
+escribir después de la instrucción @code{\time} que da comienzo a
+una sección nueva con un tipo de compás distinto, no antes. Los
+valores nuevos que se dan a una indicación de compás concreta se
+retienen y se vuelven a aplicar cuando ese tipo de compás vuelve a
+establecerse.
+
@lilypond[quote,verbatim]
\relative c'' {
\time 5/16
}
@end lilypond
-Los cambios en los ajustes de barrado se pueden limitar a contextos
-específicos. Si no se incluye ningún ajuste en un contexto de nivel
-más bajo, se aplican los ajustes del contexto circundante.
+Los cambios en los ajustes de barrado se pueden limitar a
+contextos específicos. Si no se incluye ningún ajuste en un
+contexto de nivel más bajo, se aplican los ajustes del contexto
+circundante.
@lilypond[quote, verbatim]
\new Staff {
@end lilypond
El valor de @code{baseMoment} se puede ajustar para cambiar el
-comportamiento de las barras, si se desea. Cuando se hace, el valor
-de @code{beatStructure} se debe fijar de manera que sea compatible con
-el nuevo valor de @code{baseMoment}.
+comportamiento de las barras, si se desea. Cuando se hace, el
+valor de @code{beatStructure} se debe fijar de manera que sea
+compatible con el nuevo valor de @code{baseMoment}.
@lilypond[quote,verbatim,fragment]
\time 5/8
\repeat unfold 10 { a'16 }
@end lilypond
-@code{baseMoment} es un @i{momento}, una unidad de duración musical.
-Se crea una cantidad del tipo @i{momento} por medio de la función de
-Scheme @code{ly:make-moment}. Para ver más información acerca de esta
-función, consulte @ref{Gestión del tiempo}.
+@code{baseMoment} es un @i{momento}, una unidad de duración
+musical. Se crea una cantidad del tipo @i{momento} por medio de
+la función de Scheme @code{ly:make-moment}. Para ver más
+información acerca de esta función, consulte @ref{Gestión del
+tiempo}.
-De forma predeterminada @code{baseMoment} está fijado a una unidad más
-que el denominador del compás. Todas las excepciones a este valor
-predeterminado están en
+De forma predeterminada @code{baseMoment} está fijado a una unidad
+más que el denominador del compás. Todas las excepciones a este
+valor predeterminado están en
@file{scm/time-signature-settings.scm}.
@subsubsubheading Barrado basado en @code{beamExceptions}
-Las reglas de autobarrado especiales (distintas de terminar una barra
-sobre un pulso) están definidas en la propiedad @code{beamExceptions}.
-
-@lilypond[quote,relative=2,verbatim]
-\time 3/16
-\set Timing.beatStructure = #'(2 1)
-\set Timing.beamExceptions =
- #'( ;start of alist
- (end . ;entry for end of beams
- ( ;start of alist of end points
- ((1 . 32) . (2 2 2)) ;rule for 1/32 beams -- end each 1/16
- ))) %close all entries
-c16 c c |
-\repeat unfold 6 { c32 } |
-@end lilypond
-
-@code{beamExceptions} es una lista-A con una clave de rule-type y un
-valor de beaming-rules.
-
-En este momento el único valor disponible de rule-type es @code{'end}
-para la terminación de las barras.
-
-Beaming-rules es una lista-A de Scheme (o una lista de parejas) que
-indica el tipo de barra y la agrupación que se aplica a las barras que
-contienen notas con una duración más breve de ese tipo de barra.
-
-@example
-#'((tipo-barra1 . agrupación1)
- (tipo-barra2 . agrupación2)
- (tipo-barra3 . agrupación3))
-@end example
+Las reglas de autobarrado especiales (distintas de terminar una
+barra sobre un pulso) están definidas en la propiedad
+@code{beamExceptions}.
-Tipo de barra es una dupla de Scheme que indica la duración de la
-barra, p.ej. @code{(1 . 16)}.
+El valor de @code{beamExceptions}, que es una estructura de datos
+de Scheme bastante compleja, se genera fácilmente con la función
+@code{\beamExceptions}. Esta función recibe uno o más patrones
+rítmicos barrados manualmente y con un compás de duración (los
+compases se deben separar por una barra de comprobación de
+compás@tie{}@code{|} porque la función no tiene otra manera de
+discernir la longitud del compás). He aquí un ejemplo sencillo:
-Agrupación es una lista de Scheme que indica la agrupación que aplicar
-a la barra. El valor de agrupación está en unidades del tipo de
-barra.
+@lilypond[quote,verbatim]
+\relative c'' {
+ \time 3/16
+ \set Timing.beatStructure = #'(2 1)
+ \set Timing.beamExceptions =
+ \beamExceptions { 32[ 32] 32[ 32] 32[ 32] }
+ c16 c c |
+ \repeat unfold 6 { c32 } |
+}
+@end lilypond
-@warning{ Un valor de @code{beamExceptions} debe ser una lista de
-excepciones @emph{completa}. Esto es, toda excepción que se tenga que
-aplicar debe estar incluida en este ajuste. No es posible añadir,
-eliminar o cambiar sólo una de las excepciones. Aunque esto puede
-parecer engorroso, significa que no es necesario conocer los ajustes
-de barrado actuales para poder especificar un patrón de barrado
-nuevo.}
+@warning{Un valor de @code{beamExceptions} debe ser una lista de
+excepciones @emph{completa}. Esto es, toda excepción que se tenga
+que aplicar debe estar incluida en este ajuste. No es posible
+añadir, eliminar o cambiar sólo una de las excepciones. Aunque
+esto puede parecer engorroso, significa que no es necesario
+conocer los ajustes de barrado actuales para poder especificar un
+patrón de barrado nuevo.}
Cuando cambia el compás, se fijan los valores predeterminados de
@code{Timing.baseMoment}, @code{Timing.beatStructure} y
-@code{Timing.beamExceptions}. Un ajuste en el tipo de compás da como
-resultado un reinicio de los ajustes de barrado automático para el
-contexto @code{Timing} al comportamiento predeterminado.
+@code{Timing.beamExceptions}. Un ajuste en el tipo de compás da
+como resultado un reinicio de los ajustes de barrado automático
+para el contexto @code{Timing} al comportamiento predeterminado.
@lilypond[quote,verbatim]
\relative a' {
contienen una entrada para @code{beamExceptions}. Por ejemplo, el
compás de 4/4 trata de unir el compás en dos partes si solo hay
corcheas. La regla @code{beamExceptions} puede sobreescribir el
-ajuste @code{beatStructure} si no se reinicia @code{beamExceptions}.
+ajuste @code{beatStructure} si no se reinicia
+@code{beamExceptions}.
@lilypond[quote,verbatim,fragment]
\time 4/4
\repeat unfold 8 {c''8}
@end lilypond
-De forma similar, las corcheas en compás de 3/4 se unen mediante una
-sola barra para todo el compás, de forma predeterminada. Para unir
-las corcheas en 3/4 mediante una barra en cada parte, reinicie
-@code{beamExceptions}.
+De forma similar, las corcheas en compás de 3/4 se unen mediante
+una sola barra para todo el compás, de forma predeterminada. Para
+unir las corcheas en 3/4 mediante una barra en cada parte,
+reinicie @code{beamExceptions}.
@lilypond[quote,verbatim,fragment]
\time 3/4
@end lilypond
En la música tipografiada de los períodos clásico y romántico, con
-frecuencia las barras comienzan a mitad de un compás en 3/4, pero la
-práctica moderna es evitar la falsa impresión de 6/8 (véase Gould,
-pág. 153). Se producen situaciones similares en el compás de 3/8.
-Este comportamiento viene controlado mediante la propiedad de contexto
-@code{beamHalfMeasure}, que tiene efecto solamente sobre indicaciones
-de compás que tienen la cifra 3 en el numerador:
+frecuencia las barras comienzan a mitad de un compás en 3/4, pero
+la práctica moderna es evitar la falsa impresión de 6/8 (véase
+Gould, pág. 153). Se producen situaciones similares en el compás
+de 3/8. Este comportamiento viene controlado mediante la
+propiedad de contexto @code{beamHalfMeasure}, que tiene efecto
+solamente sobre indicaciones de compás que tienen la cifra 3 en el
+numerador:
@lilypond[quote,verbatim]
\relative a' {
@subsubsubheading Cómo funciona el barrado automático
-Cuando se habilita el barrado automático, la colocación de las barras
-de corchea automáticas viene determinada por las propiedades de
-contexto @code{baseMoment}, @code{beatStructure} y
+Cuando se habilita el barrado automático, la colocación de las
+barras de corchea automáticas viene determinada por las
+propiedades de contexto @code{baseMoment}, @code{beatStructure} y
@code{beamExceptions}.
-Son de aplicación las siguientes reglas, en orden de prioridad, cuando
-se determina el aspecto de las barras:
+Son de aplicación las siguientes reglas, en orden de prioridad,
+cuando se determina el aspecto de las barras:
@itemize
@item
-Si está especificada una barra manual con @code{[@dots{}]}, fijar la barra
-tal y como se ha especificado; en caso contrario,
+Si está especificada una barra manual con @code{[@dots{}]}, fijar
+la barra tal y como se ha especificado; en caso contrario,
@item
-si está definida en @code{beamExceptions} una regla de barrado para
-este tipo de barra, utilizarla para determinar los lugares válidos en
-que pueden terminar las barras; en caso contrario,
+si está definida en @code{beamExceptions} una regla de barrado
+para este tipo de barra, utilizarla para determinar los lugares
+válidos en que pueden terminar las barras; en caso contrario,
@item
-si está definida en @code{beamExceptions} una regla de final de barra
-para un tipo de barra más largo, utilizarla para determinar los
-lugares válidos en que pueden terminar las barras; en caso contrario,
+si está definida en @code{beamExceptions} una regla de final de
+barra para un tipo de barra más largo, utilizarla para determinar
+los lugares válidos en que pueden terminar las barras; en caso
+contrario,
@item
-usar los valores de @code{baseMoment} y de @code{beatStructure} para
-determinar los finales de los pulsos dentro del compás, y terminar las
-barras al final de los pulsos.
+usar los valores de @code{baseMoment} y de @code{beatStructure}
+para determinar los finales de los pulsos dentro del compás, y
+terminar las barras al final de los pulsos.
@end itemize
-En las reglas anteriores, el tipo de barra @emph{beam-type} es
-la duración de la nota más breve dentro del grupo unido por una barra.
+En las reglas anteriores, el tipo de barra @emph{beam-type} es la
+duración de la nota más breve dentro del grupo unido por una
+barra.
-Las reglas de barrado predefinidas están
-en el archivo @file{scm/time-signature-settings.scm}.
+Las reglas de barrado predefinidas están en el archivo
+@file{scm/time-signature-settings.scm}.
@snippets
@cindex barras, subdivisión
@rinternals{beam-interface}.
@knownissues
-Si una partitura termina mientras una barra de corchea automática no
-ha terminado y aún acepta notas, esta última barra no se imprime en
-absoluto. Lo mismo sirve para las voces polifónicas introducidas con
-@code{<< @dots{} \\ @dots{} >>}. Si una voz polifónica termina
-mientras una barra de corchea automática aún admite notas, no se
-imprime. El rodeo para estos problemas es aplicar el barrado manual a
-la última barra de la voz o partitura.
-
-De forma predeterminada, el traductor @code{Timing} recibe el nombre
-del contexto @code{Score} como alias. Esto significa que el
-establecimiento del compás en ua pauta afectará al barrado de las
-otras pautas también. Así, un ajuste en el compás en un pentagrama
-tardío reiniciará el barrado personalizado que se había ajustado en un
-pentagrama más temprano. Una forma de evitar este problema es ajustar
-la indicación de compás en un pentagrama solamente.
-
-@lilypond[quote,verbatim,relative=2]
+Si una partitura termina mientras una barra de corchea automática
+no ha terminado y aún acepta notas, esta última barra no se
+imprime en absoluto. Lo mismo sirve para las voces polifónicas
+introducidas con @code{<< @dots{} \\ @dots{} >>}. Si una voz
+polifónica termina mientras una barra de corchea automática aún
+admite notas, no se imprime. El rodeo para estos problemas es
+aplicar el barrado manual a la última barra de la voz o partitura.
+
+De forma predeterminada, el traductor @code{Timing} recibe el
+nombre del contexto @code{Score} como alias. Esto significa que
+el establecimiento del compás en ua pauta afectará al barrado de
+las otras pautas también. Así, un ajuste en el compás en un
+pentagrama tardío reiniciará el barrado personalizado que se había
+ajustado en un pentagrama más temprano. Una forma de evitar este
+problema es ajustar la indicación de compás en un pentagrama
+solamente.
+
+@lilypond[quote,verbatim]
<<
\new Staff {
\time 3/4
\set Timing.baseMoment = #(ly:make-moment 1/8)
\set Timing.beatStructure = #'(1 5)
- \repeat unfold 6 { a8 }
+ \set Timing.beamExceptions = #'()
+ \repeat unfold 6 { a'8 }
}
\new Staff {
- \repeat unfold 6 { a8 }
+ \repeat unfold 6 { a'8 }
}
>>
@end lilypond
-Los ajustes de barrado predeterminados para dicho compás también se
-pueden cambiar, de forma que siempre se utilice siempre el barrado
-deseado. La manera de efectuar cambios en los ajustes de barrado
-automático para una indicación de compás se describe en
+Los ajustes de barrado predeterminados para dicho compás también
+se pueden cambiar, de forma que siempre se utilice siempre el
+barrado deseado. La manera de efectuar cambios en los ajustes de
+barrado automático para una indicación de compás se describe en
@ref{Indicación de compás}.
@lilypond[quote,verbatim]
@funindex [
En ciertos casos puede ser preciso sobreescribir el algoritmo de
-barrado automático. Por ejemplo, el barrador automático no escribe
-barras por encima de los silencios o las líneas divisorias, y en las
-partituras corales el barrado se ajusta con frecuencia para que siga
-la medida de la letra en vez de la de las notas. Tales barras se
-especifican manualmente marcando los puntos de comienzo y final con
-@code{[} y @code{]}
+barrado automático. Por ejemplo, el barrador automático no
+escribe barras por encima de los silencios o las líneas
+divisorias, y en las partituras corales el barrado se ajusta con
+frecuencia para que siga la medida de la letra en vez de la de las
+notas. Tales barras se especifican manualmente marcando los
+puntos de comienzo y final con @code{[} y @code{]}
@lilypond[quote,verbatim]
\relative { r4 r8[ g' a r] r g[ | a] r }
@cindex barras manuales, abreviatura de dirección
@cindex barras manuales, notas de adorno
-La dirección de las barras se puede establecer manualmente utilizando
-indicadores de dirección:
+La dirección de las barras se puede establecer manualmente
+utilizando indicadores de dirección:
@lilypond[quote,verbatim]
\relative { c''8^[ d e] c,_[ d e f g] }
@funindex \noBeam
@funindex noBeam
-Se pueden marcar notas individuales con @code{\noBeam} para evitar que
-resulten unidas por una barra:
+Se pueden marcar notas individuales con @code{\noBeam} para evitar
+que resulten unidas por una barra:
@lilypond[quote,verbatim]
\relative {
}
@end lilypond
-Se pueden producir al mismo tiempo barras de notas de adorno y barras
-normales. Las notas de adorno sin barra no se colocan dentro de las
-barras de notas normales.
+Se pueden producir al mismo tiempo barras de notas de adorno y
+barras normales. Las notas de adorno sin barra no se colocan
+dentro de las barras de notas normales.
@lilypond[quote,verbatim]
\relative {
@funindex stemLeftBeamCount
@funindex stemRightBeamCount
-Se puede conseguir un control incluso más estricto sobre las barras
-estableciendo las propiedades @code{stemLeftBeamCount} y
+Se puede conseguir un control incluso más estricto sobre las
+barras estableciendo las propiedades @code{stemLeftBeamCount} y
@code{stemRightBeamCount}. Especifican el número de barras que se
dibujarán en los lados izquierdo y derecho, respectivamente, de la
-nota siguiente. Si cualquiera de estas dos propiedades está ajustada
-a un valor, dicho valor se usará una sola vez, y luego se borrará. En
-este ejemplo, el último Fa se imprime con sólo una barra en el lado
-izquierdo, es decir, la barra de corchea del grupo como un todo.
+nota siguiente. Si cualquiera de estas dos propiedades está
+ajustada a un valor, dicho valor se usará una sola vez, y luego se
+borrará. En este ejemplo, el último Fa se imprime con sólo una
+barra en el lado izquierdo, es decir, la barra de corchea del
+grupo como un todo.
@lilypond[quote,verbatim]
\relative a' {
@endpredefined
@snippets
+
@lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
{flat-flags-and-beam-nibs.ly}
@funindex featherDurations
@funindex grow-direction
-Las barras progresivas se usan para indicar que un pequeño grupo de
-notas se debe tocar a una velocidad creciente (o decreciente), sin
-cambiar el tempo general de la pieza. El ámbito de la barra progresiva
-se debe indicar manualmente usando @code{[} y @code{]}, el efecto de
-ángulo de la barra se inicia especificando una dirección en la
-propiedad @code{grow-direction} del objeto @code{Beam}.
-
-Si queremos que la colocación de las notas y el sonido de la salida
-MIDI refleje el @emph{ritardando} o @emph{accelerando}
-indicado por la barra
-progresiva, las notas se deben agrupar como una expresión musical
-delimitada por llaves y precedida de una instrucción
-@code{featheredDurations} que especifica la razón entre las duraciones
-de la primera y la última notas dentro del grupo.
+Las barras progresivas se usan para indicar que un pequeño grupo
+de notas se debe tocar a una velocidad creciente (o decreciente),
+sin cambiar el tempo general de la pieza. El ámbito de la barra
+progresiva se debe indicar manualmente usando @code{[} y @code{]},
+el efecto de ángulo de la barra se inicia especificando una
+dirección en la propiedad @code{grow-direction} del objeto
+@code{Beam}.
+
+Si queremos que la colocación de las notas y el sonido de la
+salida MIDI refleje el @emph{ritardando} o @emph{accelerando}
+indicado por la barra progresiva, las notas se deben agrupar como
+una expresión musical delimitada por llaves y precedida de una
+instrucción @code{featheredDurations} que especifica la razón
+entre las duraciones de la primera y la última notas dentro del
+grupo.
Los corchetes rectos muestran el ámbito de la barra y las llaves
muestran qué notas han de modificar sus duraciones. Normalmente
-delimitarían el mismo grupo de notas, pero no es un requisito: las dos
-instrucciones son independientes.
+delimitarían el mismo grupo de notas, pero no es un requisito: las
+dos instrucciones son independientes.
-En el ejemplo siguiente las ocho semicorcheas ocupan exactamente el
-mismo tiempo que una blanca, pero la primera nota tiene la mitad de
-duración que la última, con las notas intermedias alargándose
-gradualmente. Las cuatro primeras fusas se aceleran gradualmente,
-mientras que las últimas cuatro fusas están a un tempo constante.
+En el ejemplo siguiente las ocho semicorcheas ocupan exactamente
+el mismo tiempo que una blanca, pero la primera nota tiene la
+mitad de duración que la última, con las notas intermedias
+alargándose gradualmente. Las cuatro primeras fusas se aceleran
+gradualmente, mientras que las últimas cuatro fusas están a un
+tempo constante.
@lilypond[verbatim,quote]
\relative c' {
@rlsr{Rhythms}.
@knownissues
-La instrucción @code{\featherDurations} sólo funciona con fragmentos
-musicales muy breves, y cuando los números de la fracción son
-pequeños.
+La instrucción @code{\featherDurations} sólo funciona con
+fragmentos musicales muy breves, y cuando los números de la
+fracción son pequeños.
@node Compases
@funindex \bar
@funindex bar
-Las líneas divisorias delimitan a los compases pero también se pueden
-usar para indicar las repeticiones. Normalmente, las líneas
-divisorias normales se insertan de manera automática en la salida
-impresa en lugares que están basados en el compás actual.
+Las líneas divisorias delimitan a los compases pero también se
+pueden usar para indicar las repeticiones. Normalmente, las
+líneas divisorias normales se insertan de manera automática en la
+salida impresa en lugares que están basados en el compás actual.
-Las barras de compás sencillas insertadas automáticamente se pueden
-cambiar por otros tipos con la instrucción @code{\bar}. Por ejemplo,
-se suele poner una doble barra de cierre al final de la pieza:
+Las barras de compás sencillas insertadas automáticamente se
+pueden cambiar por otros tipos con la instrucción @code{\bar}.
+Por ejemplo, se suele poner una doble barra de cierre al final de
+la pieza:
@lilypond[quote,verbatim]
\relative { e'4 d c2 \bar "|." }
@end lilypond
-No deja de ser válida la última nota de un compás si no termina sobre
-la línea divisoria automática: se supone que la nota se prolonga sobre
-el compás siguiente. Pero una secuencia larga de dichos compases
-prolongados puede hacer que la música aparezca comprimida o incluso
-que se salga de la página. Esto es a causa de que los saltos de línea
-automáticos solamente se producen al final de compases completos, es
-decir, cuando todas las notas han finalizado antes de que el compás
-termine.
+No deja de ser válida la última nota de un compás si no termina
+sobre la línea divisoria automática: se supone que la nota se
+prolonga sobre el compás siguiente. Pero una secuencia larga de
+dichos compases prolongados puede hacer que la música aparezca
+comprimida o incluso que se salga de la página. Esto es a causa
+de que los saltos de línea automáticos solamente se producen al
+final de compases completos, es decir, cuando todas las notas han
+finalizado antes de que el compás termine.
-@warning{Una duración incorrecta puede hacer que se trate de evitar la
-producción de saltos de línea, dando como resultado una línea de
-música con una compresión exagerada o música que se sale de la
-página.}
+@warning{Una duración incorrecta puede hacer que se trate de
+evitar la producción de saltos de línea, dando como resultado una
+línea de música con una compresión exagerada o música que se sale
+de la página.}
@cindex línea, saltos
@cindex líneas divisorias invisibles
@cindex compás, barras invisibles de
También se permiten saltos de línea en las barras insertadas
-manualmente incluso dentro de compases incompletos. Para permitir un
-salto de línea donde no hay ninguna línea divisoria visible, utilice
-lo siguiente:
+manualmente incluso dentro de compases incompletos. Para permitir
+un salto de línea donde no hay ninguna línea divisoria visible,
+utilice lo siguiente:
@example
\bar ""
@end example
@noindent
-De esta manera se insertará una barra invisible de compás y se hará
-posible el salto de línea en este punto, sin forzarlo. No se
-incrementa el contador de los números de compás. Para forzar un salto
-de línea, consulte @ref{Saltos de línea}.
+De esta manera se insertará una barra invisible de compás y se
+hará posible el salto de línea en este punto, sin forzarlo. No se
+incrementa el contador de los números de compás. Para forzar un
+salto de línea, consulte @ref{Saltos de línea}.
@cindex manuales, líneas divisorias
@cindex manuales, barras de compás
@cindex líneas divisorias manuales
Esta y otras líneas divisorias especiales se pueden insertar
-manualmente en cualquier punto. Cuando coinciden con el final de un
-compás, sustituyen a la línea divisoria simple que se habría insertado
-automáticamente en dicho lugar. Cuando no coinciden con el final de
-un compás, se inserta la línea especificada en ese punto en la salida
-impresa.
-
-Observe que las líneas divisorias manuales son puramente visuales. No
-afectan a ninguna de las propiedades que una barra normal afectaría,
-como a los números de compás, alteraciones, saltos de línea, etc. No
-afectan tampoco al cálculo y colocación de las líneas divisorias
-subsiguientes. Cuando una divisoria se coloca manualmente donde ya
-existe una divisoria normal, los efectos de la línea original no se
-alteran.
+manualmente en cualquier punto. Cuando coinciden con el final de
+un compás, sustituyen a la línea divisoria simple que se habría
+insertado automáticamente en dicho lugar. Cuando no coinciden con
+el final de un compás, se inserta la línea especificada en ese
+punto en la salida impresa.
+
+Observe que las líneas divisorias manuales son puramente visuales.
+No afectan a ninguna de las propiedades que una barra normal
+afectaría, como a los números de compás, alteraciones, saltos de
+línea, etc. No afectan tampoco al cálculo y colocación de las
+líneas divisorias subsiguientes. Cuando una divisoria se coloca
+manualmente donde ya existe una divisoria normal, los efectos de
+la línea original no se alteran.
Están disponibles para su inserción manual dos tipos de líneas
divisorias simples y cinco tipos de doble barra:
@end lilypond
Además se puede imprimir una línea divisoria como una marca corta:
+
@lilypond[quote,fragment,verbatim]
f'1 \bar "'" g'1
@end lilypond
-Sin embargo, dado que las mencionadas marcas se utilizan usualmente en
-el canto gregoriano, es preferible en este caso utilizar
-@code{\divisioMinima}, que se describe en la sección @ref{Divisiones}
-dentro de Canto gregoriano.
+
+Sin embargo, dado que las mencionadas marcas se utilizan
+usualmente en el canto gregoriano, es preferible en este caso
+utilizar @code{\divisioMinima}, que se describe en la sección
+@ref{Divisiones} dentro de Canto gregoriano.
LilyPond contempla la notación del canto kievano y ofrece una
línea divisoria especial kievana:
+
@lilypond[quote,fragment,verbatim]
f'1 \bar "k"
@end lilypond
+
Pueden verse más detalles de esta notación explicados en
@ref{Tipografiado del canto kievano en notación cuadrada}.
@cindex segno
-Para los símbolos de segno en línea, existen tres tipos
-de barras de compás que se diferencian en su comportamiento
-en los saltos de línea:
+Para los símbolos de segno en línea, existen tres tipos de barras
+de compás que se diferencian en su comportamiento en los saltos de
+línea:
@lilypond[quote,verbatim]
\relative c'' {
@cindex repeticiones
-Aunque se pueden insertar manualmente barras de compás con significado
-de repeticiones, no se reconocen como repeticiones por parte de
-LilyPond. Las secciones repetidas se introducen mejor utilizando las
-diversas instrucciones de repetición (véase @ref{Repeticiones}), que
-imprimen automáticamente las barras correspondientes.
+Aunque se pueden insertar manualmente barras de compás con
+significado de repeticiones, no se reconocen como repeticiones por
+parte de LilyPond. Las secciones repetidas se introducen mejor
+utilizando las diversas instrucciones de repetición (véase
+@ref{Repeticiones}), que imprimen automáticamente las barras
+correspondientes.
-Además se puede especificar @code{".|:-||"}, que equivale a @code{".|:"}
-excepto en los saltos de línea, en que produce una doble barra al
-final de la línea y una repetición izquierda (de comienzo) al
-principio de la línea siguiente.
+Además se puede especificar @code{".|:-||"}, que equivale a
+@code{".|:"} excepto en los saltos de línea, en que produce una
+doble barra al final de la línea y una repetición izquierda (de
+comienzo) al principio de la línea siguiente.
@lilypond[quote,verbatim]
\relative c'' {
modificar o añadir barras de compás, consulte el archivo
@file{scm/bar-line.scm}.
-En las partituras con muchos pentagramas, una instrucción @code{\bar}
-en uno de ellos se aplica automáticamente a todos los demás. Las
-líneas resultantes se conectan entre los distintos pentagramas de un
-@code{StaffGroup}, @code{PianoStaff} o @code{GrandStaff}.
+En las partituras con muchos pentagramas, una instrucción
+@code{\bar} en uno de ellos se aplica automáticamente a todos los
+demás. Las líneas resultantes se conectan entre los distintos
+pentagramas de un @code{StaffGroup}, @code{PianoStaff} o
+@code{GrandStaff}.
@lilypond[quote,verbatim]
<<
@funindex bar
@funindex bartype
-La instrucción @samp{\bar @var{tipo de barra}} es una forma corta de
-hacer @samp{\set Timing.whichBar = @var{tipo de barra}}. Cuando
-@code{whichBar} se establece con el valor de una cadena, se crea una
-línea divisoria de ese tipo.
+La instrucción @samp{\bar @var{tipo de barra}} es una forma corta
+de hacer @samp{\set Timing.whichBar = @var{tipo de barra}}.
+Cuando @code{whichBar} se establece con el valor de una cadena, se
+crea una línea divisoria de ese tipo.
-El tipo de barra predeterminado que se usa para las líneas divisorias
-insertadas automáticamente es @code{"|"}. Se puede cambiar en
-cualquier momento con
-@samp{\set Timing.defaultBarType = @var{tipo de barra}}.
+El tipo de barra predeterminado que se usa para las líneas
+divisorias insertadas automáticamente es @code{"|"}. Se puede
+cambiar en cualquier momento con @samp{\set Timing.defaultBarType
+= @var{tipo de barra}}.
@seealso
Referencia de la notación:
@funindex currentBarNumber
Por defecto, los números de compás se imprimen al principio de la
-línea, excepto la primera. El número propiamente dicho se almacena en
-la propiedad @code{currentBarNumber}, que normalmente se actualiza
-automáticamente para cada compás. También se puede establecer
-manualmente:
+línea, excepto la primera. El número propiamente dicho se
+almacena en la propiedad @code{currentBarNumber}, que normalmente
+se actualiza automáticamente para cada compás. También se puede
+establecer manualmente:
@lilypond[verbatim,quote]
\relative c' {
@funindex barNumberVisibility
@funindex BarNumber
-Los números de compás se pueden tipografiar a intervalos regulares en
-vez de al principio de cada línea. Para hacerlo se debe sobreescribir
-el comportamiento predeterminado de forma que se puedan imprimir en
-otros lugares. Esto viene controlado por la propiedad
-@code{break-visibility} de @code{BarNumber}. Toma tres valores que se
-pueden fijar al valor @code{#t} o @code{#f} para especificar si el
-número de compás correspondiente es visible o no. El orden de los
-tres valores es @code{visible al final de la línea}, @code{visible en
-mitad de la línea}, @code{visible al principio de la línea}. En el
-ejemplo siguiente se imprimen los números de compás en todos los
-sitios posibles:
-
-@lilypond[verbatim,quote,relative=1]
-\override Score.BarNumber.break-visibility = #'#(#t #t #t)
-\set Score.currentBarNumber = #11
-% Permit first bar number to be printed
-\bar ""
-c1 | c | c | c
-\break
-c1 | c | c | c
+Los números de compás se pueden tipografiar a intervalos regulares
+en vez de al principio de cada línea. Para hacerlo se debe
+sobreescribir el comportamiento predeterminado de forma que se
+puedan imprimir en otros lugares. Esto viene controlado por la
+propiedad @code{break-visibility} de @code{BarNumber}. Toma tres
+valores que se pueden fijar al valor @code{#t} o @code{#f} para
+especificar si el número de compás correspondiente es visible o
+no. El orden de los tres valores es @code{visible al final de la
+línea}, @code{visible en mitad de la línea}, @code{visible al
+principio de la línea}. En el ejemplo siguiente se imprimen los
+números de compás en todos los sitios posibles:
+
+@lilypond[verbatim,quote]
+\relative c' {
+ \override Score.BarNumber.break-visibility = ##(#t #t #t)
+ \set Score.currentBarNumber = #11
+ % Permit first bar number to be printed
+ \bar ""
+ c1 | c | c | c |
+ \break
+ c1 | c | c | c |
+}
@end lilypond
@snippets
@lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
{printing-bar-numbers-at-regular-intervals.ly}
+@lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
+{printing-bar-numbers-with-changing-regular-intervals.ly}
+
@cindex compás, número de, formato
@cindex número de compases, formato de
@knownissues
Los números de compás pueden colisionar con el corchete
@code{StaffGroup}, si hay uno en la parte de arriba. Para
-solucionarlo, se puede usar la propiedad de relleno @code{padding} de
-@code{BarNumber} para colocar el número correctamente.
-Consulte @rinternals{StaffGroup} y @rinternals{BarNumber}
-para ver más información.
+solucionarlo, se puede usar la propiedad de relleno @code{padding}
+de @code{BarNumber} para colocar el número correctamente.
+Consulte @rinternals{StaffGroup} y @rinternals{BarNumber} para ver
+más información.
@node Comprobación de compás y de número de compás
@funindex |
Las comprobaciones de compás ayudan a detectar errores en las
-duraciones. Una comprobación de compás se escribe usando el símbolo
-de la barra vertical, @code{|}, en cualquier lugar donde se espera que
-caiga una línea divisoria. Si se encuentran líneas de comprobación de
-compás en otros lugares, se imprime una lista de advertencias en el
-archivo log de registro, mostrando los números de línea y columna en
-que han fallado las comprobaciones de compás. En el siguiente
-ejemplo, la segunda comprobación de compás avisará de un error
+duraciones. Una comprobación de compás se escribe usando el
+símbolo de la barra vertical, @code{|}, en cualquier lugar donde
+se espera que caiga una línea divisoria. Si se encuentran líneas
+de comprobación de compás en otros lugares, se imprime una lista
+de advertencias en el archivo log de registro, mostrando los
+números de línea y columna en que han fallado las comprobaciones
+de compás. En el siguiente ejemplo, la segunda comprobación de
+compás avisará de un error.
@example
\time 3/4 c2 e4 | g2 |
@end example
-Las comprobaciones de compás también se pueden usar en la letra de las
-canciones:
+Una duración incorrecta produce una partitura completamente
+desbaratada, especialmente si la partitura es polifónica, de
+manera que la mejor forma de empezar a corregir la entrada es
+buscar sistemáticamente la existencia de comprobaciones de compás
+fallidas y duraciones incorrectas.
+
+Si se producen varias comprobaciones de compás seguidas por valor
+de la misma duración musical, solo aparece el primer mensaje de
+advertencia. Así se consigue que el mensaje esté concentrado en
+la fuente del error de pulso.
+
+Las comprobaciones de compás también se pueden insertar dentro de
+la letra de las canciones:
@example
\lyricmode @{
\time 2/4
- Bri -- lla, | bri -- lla, |
+ Twin -- kle | Twin -- kle |
@}
@end example
-Las duraciones incorrectas a menudo desbaratan la partitura
-completamente, sobre todo si la música es polifónica, por ello el
-mejor sitio para empezar a corregir la entrada es hacer un barrido en
-busca de comprobaciones de compás fallidas y duraciones incorrectas.
+Observe que las comprobaciones de compás dentro de la letra de las
+canciones se evalúan en el momento musical de la sílaba
+@emph{siguiente} a la comprobación de compas que se procesa. Si
+la letra está asociada con las notas de una voz que tiene un
+silencio al principio del compás, no se puede poner ninguna sílaba
+al comienzo de ese compás y se imprimie un mensaje de advertencia
+si se escribe una comprobación de compás dentro de la letra, en
+esa posición.
-Si varias comprobaciones de compás corresponden al mismo intervalo
-musical, sólo se imprime el primer mensaje de advertencia. Esto
-permite que la advertencia se centre en la fuente del error de cuenta
-de tiempo.
@funindex |
@funindex "|"
-También es posible redefinir la acción que se lleva a cabo cuando se
-encuentra una barra vertical o símbolo de comprobación de compás,
-@code{|}, en el código de entrada, de forma que haga algo distinto a
-una comprobación de compás. Se hace asignando una expresión musical a
-@code{"|"}, el símbolo de barra vertical. En el ejemplo siguiente se
-establece @code{|} de forma que inserte una doble línea divisoria
-cuando aparece en el código de entrada, en vez de comprobar el final
-de un compás.
+También es posible redefinir la acción que se lleva a cabo cuando
+se encuentra una barra vertical o símbolo de comprobación de
+compás, @code{|}, en el código de entrada, de forma que haga algo
+distinto a una comprobación de compás. Se hace asignando una
+expresión musical a @code{"|"}, el símbolo de barra vertical. En
+el ejemplo siguiente se establece @code{|} de forma que inserte
+una doble línea divisoria cuando aparece en el código de entrada,
+en vez de comprobar el final de un compás.
@lilypond[quote,verbatim]
"|" = \bar "||"
@funindex \barNumberCheck
@funindex barNumberCheck
-Al copiar piezas musicales grandes puede servir de ayuda comprobar que
-el número de compás de LilyPond corresponde al original desde el que
-está copiando. Esto se puede comprobar con @code{\barNumberCheck},
-por ejemplo:
+Al copiar piezas musicales grandes puede servir de ayuda comprobar
+que el número de compás de LilyPond corresponde al original desde
+el que está copiando. Esto se puede comprobar con
+@code{\barNumberCheck}, por ejemplo:
@verbatim
\barNumberCheck #123
@end lilypond
@noindent
-La letra de ensayo se incrementa automáticamente si usa @code{\mark
-\default}, pero también puede utilizar un número entero como argumento
-para establecer la indicación manualmente. El valor que se utilizará
-se almacena dentro de la propiedad @code{rehearsalMark}.
+La letra de ensayo se incrementa automáticamente si usa
+@code{\mark \default}, pero también puede utilizar un número
+entero como argumento para establecer la indicación manualmente.
+El valor que se utilizará se almacena dentro de la propiedad
+@code{rehearsalMark}.
@lilypond[quote,verbatim]
\relative c'' {
@noindent
La letra@tie{}@q{I} se salta de acuerdo con las tradiciones de
grabado. Si quiere incluir la letra @q{I}, use una de las
-instrucciones siguientes, según el estilo de marcas de
-ensayo que desee (sólo letras, letras dentro de un rectángulo
-o letras dentro de un círculo).
+instrucciones siguientes, según el estilo de marcas de ensayo que
+desee (sólo letras, letras dentro de un rectángulo o letras dentro
+de un círculo).
@example
\set Score.markFormatter = #format-mark-alphabet
@cindex personalizada, marca de ensayo
@cindex manual, marca de ensayo
-El estilo se define por medio de la propiedad @code{markFormatter}.
-Es una función que toma como argumentos la marca en curso (un número
-entero) y el contexto actual. Debe devolver un objeto de marcado. En
-el ejemplo siguiente, se establece @code{markFormatter} con el valor
-de un procedimiento enlatado. Después de algunos compases, se
-establece con el valor de una función que produce un número encerrado
-en una caja.
+El estilo se define por medio de la propiedad
+@code{markFormatter}. Es una función que toma como argumentos la
+marca en curso (un número entero) y el contexto actual. Debe
+devolver un objeto de marcado. En el ejemplo siguiente, se
+establece @code{markFormatter} con el valor de un procedimiento
+enlatado. Después de algunos compases, se establece con el valor
+de una función que produce un número encerrado en una caja.
@lilypond[quote,verbatim]
\relative c'' {
@end lilypond
El archivo @file{scm/translation-functions.scm} contiene las
-definiciones de @code{format-mark-numbers} (el formato por omisión),
-@code{format-mark-box-numbers}, @code{format-mark-letters} y
-@code{format-mark-box-letters}. Se pueden usar éstos como inspiración
-para otras funciones de formateo.
+definiciones de @code{format-mark-numbers} (el formato por
+omisión), @code{format-mark-box-numbers},
+@code{format-mark-letters} y @code{format-mark-box-letters}. Se
+pueden usar éstos como inspiración para otras funciones de
+formateo.
Podemos utilizar @code{format-mark-barnumbers},
@code{format-mark-box-barnumbers} y
-@code{format-mark-circle-barnumbers} para obtener números de compás en
-lugar de números o letras secuenciales.
+@code{format-mark-circle-barnumbers} para obtener números de
+compás en lugar de números o letras secuenciales.
Se pueden especificar otros estilos de letra de ensayo de forma
manual:
@end example
@noindent
-Observe que @code{Score.markFormatter} no afecta a las marcas que se
-especifican de esta forma. Sin embargo, es posible aplicar un
+Observe que @code{Score.markFormatter} no afecta a las marcas que
+se especifican de esta forma. Sin embargo, es posible aplicar un
elemento @code{\markup} a la cadena.
@example
@funindex \musicglyph
@funindex musicglyph
-Los glifos musicales (como el segno) se pueden imprimir dentro de un
-elemento @code{\mark}
+Los glifos musicales (como el segno) se pueden imprimir dentro de
+un elemento @code{\mark}
@lilypond[quote,verbatim]
\relative c' {
@end lilypond
@noindent
-Consulte @ref{La tipografía Feta} para ver una lista de los símbolos que se
-pueden imprimir con @code{\musicglyph}.
+Consulte @ref{La tipografía Feta} para ver una lista de los
+símbolos que se pueden imprimir con @code{\musicglyph}.
Para ver formas comunes de trucar la colocación de las letras de
ensayo, consulte @ref{Formatear el texto}. Para un control más
El archivo @file{scm/translation-functions.scm} contiene las
definiciones de @code{format-mark-numbers} y de
-@code{format-mark-letters}. Se pueden utilizar como inspiración para
-escribir otras funciones de formateo.
+@code{format-mark-letters}. Se pueden utilizar como inspiración
+para escribir otras funciones de formateo.
@seealso
Referencia de la notación:
@funindex \acciaccatura
@funindex \appoggiatura
-Los mordentes y notas de adorno son ornamentos musicales,
-impresos en un tipo más pequeño y no ocupan ningún
-tiempo lógico adicional en el compás.
+Los mordentes y notas de adorno son ornamentos musicales, impresos
+en un tipo más pequeño y no ocupan ningún tiempo lógico adicional
+en el compás.
@lilypond[quote,verbatim]
\relative {
Hay otros tres tipos posibles de notas de adorno; la
@emph{acciaccatura} o mordente de una nota (una nota de adorno sin
-medida que se indica mediante una nota ligada y con el
-corchete tachado) y la @emph{appoggiatura}, que toma una fracción fija
-de la nota principal a la que se adjunta, y que se imprime sin
+medida que se indica mediante una nota ligada y con el corchete
+tachado) y la @emph{appoggiatura}, que toma una fracción fija de
+la nota principal a la que se adjunta, y que se imprime sin
tachar. Es posible escribir una nota de adorno con la plica
-tachada, como la @emph{acciaccatura} pero sin la ligadura, como para
-colocarla entre notas que están ligadas entre sí, utilizando la función
-@code{\slashedGrace}.
+tachada, como la @emph{acciaccatura} pero sin la ligadura, como
+para colocarla entre notas que están ligadas entre sí, utilizando
+la función @code{\slashedGrace}.
@lilypond[quote,verbatim]
\relative {
@end lilypond
La colocación de notas de adorno se sincroniza entre los distintos
-pentagramas. En el siguiente ejemplo, hay dos semicorcheas de adorno
-por cada corchea de adorno:
+pentagramas. En el siguiente ejemplo, hay dos semicorcheas de
+adorno por cada corchea de adorno:
@lilypond[quote,verbatim]
<<
\relative { c''1 \afterGrace d1 { c16[ d] } c1 }
@end lilypond
-Esto pone las notas de adorno después de un espacio que dura 3/4 de la
-longitud de la nota principal. La fracción predeterminada de 3/4 se
-puede cambiar estableciendo @code{afterGraceFraction}. El ejemplo
-siguiente muestra el resultado de establecer el espacio en su valor
-predeterminado, en 15/16, y por último en 1/2 de la nota principal.
+Esto pone las notas de adorno después de un espacio que dura 3/4
+de la longitud de la nota principal. La fracción predeterminada
+de 3/4 se puede cambiar estableciendo @code{afterGraceFraction}.
+El ejemplo siguiente muestra el resultado de establecer el espacio
+en su valor predeterminado, en 15/16, y por último en 1/2 de la
+nota principal.
@lilypond[quote,verbatim]
<<
@end lilypond
El espacio entre la nota principal y la de adorno también se puede
-especificar usando espaciadores. El ejemplo siguiente sitúa
-la nota de adorno después de un espacio que dura 7/8 de la
-nota principal.
+especificar usando espaciadores. El ejemplo siguiente sitúa la
+nota de adorno después de un espacio que dura 7/8 de la nota
+principal.
@lilypond[quote,verbatim]
\new Voice \relative {
@cindex notas de adorno, trucar
@cindex notas de adorno, cambiar los ajustes de disposición
-Una expresión musical @code{\grace} introduce ajustes de tipografía
-especiales, por ejemplo para producir un tipo más pequeño y para fijar
-las direcciones. Por ello, cuando se introducen trucos para la
-presentación, deben ir dentro de la expresión de adorno. Las
-sobreescrituras se deben también revertir dentro de la expresión de
-adorno. Aquí, la dirección predeterminada de la plica de la nota de
-adorno se sobreescribe y luego se revierte.
+Una expresión musical @code{\grace} introduce ajustes de
+tipografía especiales, por ejemplo para producir un tipo más
+pequeño y para fijar las direcciones. Por ello, cuando se
+introducen trucos para la presentación, deben ir dentro de la
+expresión de adorno. Las sobreescrituras se deben también revertir
+dentro de la expresión de adorno. Aquí, la dirección
+predeterminada de la plica de la nota de adorno se sobreescribe y
+luego se revierte.
@lilypond[quote,verbatim]
\new Voice \relative {
La sincronización de las notas de adorno también puede acarrear
sorpresas. La notación de pentagramas, como armaduras, líneas
-divisorias, etc., se sincronizan también. Ponga cuidado cuando mezcle
-pentagramas con adornos y sin adornos, por ejemplo
+divisorias, etc., se sincronizan también. Ponga cuidado cuando
+mezcle pentagramas con adornos y sin adornos, por ejemplo
@lilypond[quote,verbatim]
<<
@noindent
Esto se puede remediar insertando desplazamientos de adorno de las
-duraciones correspondientes en los otros pentagramas. Para el ejemplo
-anterior
+duraciones correspondientes en los otros pentagramas. Para el
+ejemplo anterior
@lilypond[quote,verbatim]
<<
>>
@end lilypond
-El uso de notas de adorno dentro de los contextos de voz tiende
-a confundir la manera en que se tipografía la voz.
-Esto se puede soslayar mediante la inserción de un silencio o nota
-entre la instrucción de voz y la nota de adorno.
-
-@lilypond[quote,verbatim]
-accMusic = {
- \acciaccatura { f8 } e8 r8 \acciaccatura { f8 } e8 r4
-}
-
-\new Staff {
- <<
- \new Voice {
- \relative c'' {
- r8 r8 \voiceOne \accMusic \oneVoice r8 |
- r8 \voiceOne r8 \accMusic \oneVoice r8 |
- }
- }
- \new Voice {
- \relative c' {
- s8 s8 \voiceTwo \accMusic \oneVoice s8 |
- s8 \voiceTwo r8 \accMusic \oneVoice s8 |
- }
- }
- >>
-}
-@end lilypond
+Es obligatorio usar la instrucción @code{\grace} para la parte de
+los desplazamientos, incluso si la parte visual usa
+@code{\acciaccatura} o @code{\appoggiatura} porque en caso
+contrario se imprime una fea ligadura que conecta a la nota de
+adorno invisible con la nota siguiente.
-Las secciones de adorno sólo se deben usar dentro de expresiones de
-música secuenciales. No están contemplados el anidado ni la
-yuxtaposición de secciones de adorno, y podría producir caídas u otros
-errores.
+Las secciones de adorno sólo se deben usar dentro de expresiones
+de música secuenciales. No están contemplados el anidado ni la
+yuxtaposición de secciones de adorno, y podría producir caídas u
+otros errores.
-Cada nota de adorno en la salida MIDI tiene una longitud que es 1/4 de
-su duración real. Si la duración combinada de las notas de adorno es
-mayor que la longitud de la nota precedente, se genera un error
-@qq{@code{Retrocediendo en el tiempo MIDI}}. Tiene dos opciones: en
-primer lugar, puede hacer más corta la duración de las notas de
-adorno, por ejemplo:
+Cada nota de adorno en la salida MIDI tiene una longitud que es
+1/4 de su duración real. Si la duración combinada de las notas de
+adorno es mayor que la longitud de la nota precedente, se genera
+un error @qq{@code{Retrocediendo en el tiempo MIDI}}. Tiene dos
+opciones: en primer lugar, puede hacer más corta la duración de
+las notas de adorno, por ejemplo:
@example
c'8 \acciaccatura @{ c'8[ d' e' f' g'] @}
@cindex cadenza (cadencia), alinear a
@cindex alineación a una cadenza (cadencia)
-En un contexto orquestal, las cadenzas presentan un problema especial:
-al construir una partitura que tiene una cadenza, todos los demás
-instrumentos deben saltar tantas notas como la longitud de la cadenza,
-pues en caso contrario empezarán demasiado pronto o demasiado tarde.
+En un contexto orquestal, las cadenzas presentan un problema
+especial: al construir una partitura que tiene una cadenza, todos
+los demás instrumentos deben saltar tantas notas como la longitud
+de la cadenza, pues en caso contrario empezarán demasiado pronto o
+demasiado tarde.
-Una solución a este problema son las funciones @code{mmrest-of-length}
-y @code{skip-of-length}. Estas funciones de Scheme toman un fragmento
-de música como argumento y generan un @code{\skip} o silencio
-multicompás, de la longitud exacta del fragmento.
+Una solución a este problema son las funciones
+@code{mmrest-of-length} y @code{skip-of-length}. Estas funciones
+de Scheme toman un fragmento de música como argumento y generan un
+@code{\skip} o silencio multicompás, de la longitud exacta del
+fragmento.
@lilypond[verbatim,quote]
MyCadenza = \relative {
@funindex measurePosition
@funindex measureLength
-El tiempo está administrado por el @code{Timing_translator}, que de
-forma predeterminada vive en el contexto de @code{Score}. Se añade un
-alias, @code{Timing}, al contexto en que se coloca el
-@code{Timing_translator}.
-Para asegurar que está disponible el alias @code{Timing}, quizá
-tenga que crear explícitamente una instancia del contexto
-contenedor (como @code{Voice} o @code{Staff}).
+El tiempo está administrado por el @code{Timing_translator}, que
+de forma predeterminada vive en el contexto de @code{Score}. Se
+añade un alias, @code{Timing}, al contexto en que se coloca el
+@code{Timing_translator}. Para asegurar que está disponible el
+alias @code{Timing}, quizá tenga que crear explícitamente una
+instancia del contexto contenedor (como @code{Voice} o
+@code{Staff}).
Se usan las siguientes propiedades de @code{Timing} para seguir la
pista del tiempo dentro de la partitura.
@table @code
@item currentBarNumber
-El número de compás en curso. Para ver un ejemplo que muestra el uso
-de esta propiedad, consulte @ref{Numeración de compases}.
+El número de compás en curso. Para ver un ejemplo que muestra el
+uso de esta propiedad, consulte @ref{Numeración de compases}.
@item measureLength
-La longitud de los compases dentro de la indicación actual de compás.
-Para un 4/4 esto es@tie{}1, y para el 6/8 es 3/4. Su valor determinad
-cuándo se insertan las líneas divisorias y cómo se generan las barras
-automáticas.
+La longitud de los compases dentro de la indicación actual de
+compás. Para un 4/4 esto es@tie{}1, y para el 6/8 es 3/4. Su
+valor determinad cuándo se insertan las líneas divisorias y cómo
+se generan las barras automáticas.
@item measurePosition
-El punto en que nos encontramos dentro del compás. Esta cantidad se
-reinicia sustrayendo @code{measureLength} cada vez que se alcanza o se
-excede @code{measureLength}. Cuando eso ocurre, se incrementa
-@code{currentBarNumber}.
+El punto en que nos encontramos dentro del compás. Esta cantidad
+se reinicia sustrayendo @code{measureLength} cada vez que se
+alcanza o se excede @code{measureLength}. Cuando eso ocurre, se
+incrementa @code{currentBarNumber}.
@item timing
-Si tiene un valor verdadero, las variables anteriores se actualizan a
-cada paso de tiempo. Cuando tiene un valor falso, el grabador se
-queda en el compás actual indefinidamente.
+Si tiene un valor verdadero, las variables anteriores se
+actualizan a cada paso de tiempo. Cuando tiene un valor falso, el
+grabador se queda en el compás actual indefinidamente.
@end table
La cuenta del tiempo se puede cambiar estableciendo el valor de
cualquiera de estas variables explícitamente. En el siguiente
-ejemplo, se imprime la indicación de compás predeterminada 4/4, pero
-@code{measureLength} tiene está ajustado a 5/4. En los 4/8 hasta el
-tercer compás, la posición @code{measurePosition} se adelanta en 1/8
-hasta 5/8, acortando ese compás en 1/8. Entonces, la siguiente línea
-divisoria cae en 9/8 en vez de hacerlo en 5/4.
+ejemplo, se imprime la indicación de compás predeterminada 4/4,
+pero @code{measureLength} tiene está ajustado a 5/4. En los 4/8
+hasta el tercer compás, la posición @code{measurePosition} se
+adelanta en 1/8 hasta 5/8, acortando ese compás en 1/8. Entonces,
+la siguiente línea divisoria cae en 9/8 en vez de hacerlo en 5/4.
@lilypond[quote,verbatim]
\new Voice \relative {
@end lilypond
@noindent
-Como lo ilustra el ejemplo, @code{ly:make-moment n m} construye una
-duración de la fracción n/m de una redonda. Por ejemplo,
+Como lo ilustra el ejemplo, @code{ly:make-moment n m} construye
+una duración de la fracción n/m de una redonda. Por ejemplo,
@code{ly:make-moment 1 8} es una duración de una corchea y
@code{ly:make-moment 7 16} es la duración de siete semicorcheas.
\input texinfo @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
@ignore
- Translation of GIT committish: 08560a1b8076630c4fc6cb9b902614d8b74fd6fc
+ Translation of GIT committish: 47db9a3883d726ca53e2133a3b2298f78dd6a32e
When revising a translation, copy the HEAD committish of the
version that you are working on. For details, see the Contributors'
prácticas} para una utilización eficiente.
@end macro
-@c `Usage' was born 1999-10-10 with git commit c82c30c...
+@c `Usage' was born 1999-10-11 with this commit:
+@c release: 1.2.13
+@c author: Han-Wen Nienhuys
+@c commit: 0cf97b5cdceecbba937f43ac827f4065aad5001e
+@c file: Documentation/user/invoking.itexi
+
@macro copyrightDeclare
Copyright @copyright{} 1999--2015 por los autores.
@end macro
@c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
@ignore
- Translation of GIT committish: b4a06339566ce7e7f17ba60745261fc26b32abb0
+ Translation of GIT committish: 99ce5fc4bd1169e8fa33855b3a13bc68f08fbe0b
When revising a translation, copy the HEAD committish of the
version that you are working on. For details, see the Contributors'
@ref{Contacto}: obtener ayuda, charlar y ¡mantenerse en contacto!
@item
-@ref{Ejemplos mínimos}: son @emph{muy} recomendables cuando se habla
-de LilyPond.
+@ref{Ejemplos mínimos}: son @emph{muy} recomendables cuando se
+habla de LilyPond.
@item
@ref{Informes de fallos}: algo ha ido mal.
@ref{Desarrollo}: para colaboradores y pilotos de prueba.
@item
-@ref{GSoC 2012}: nuestras ideas para la edición 2012 del «Google
-Summer of Code» (Verano del Código de Google).
+@ref{Google Summer of Code}: ideas para el «Google Summer of Code»
+(Verano del Código de Google).
@item
-@ref{Autores}: las personas que han hecho a LilyPond lo que hoy es.
+@ref{Autores}: las personas que han hecho a LilyPond lo que hoy
+es.
@item
-@ref{Acknowledgements}: proyectos e instituciones que apoyan a LilyPond
+@ref{Acknowledgements}: proyectos e instituciones que apoyan a
+LilyPond
@end itemize
@divEnd
@itemize
@item
-@ref{Publicaciones}: qué hemos escrito, y qué han escrito sobre nosotros.
+@ref{Publicaciones}: qué hemos escrito, y qué han escrito sobre
+nosotros.
@item
@ref{Noticias antiguas}: el archivo.
@item
-@ref{Desván}: anuncios y registros de cambios en versiones antiguas.
+@ref{Desván}: anuncios y registros de cambios en versiones
+antiguas.
@end itemize
@divEnd
* Preste su ayuda::
* Patrocinio::
* Desarrollo::
-* GSoC 2012::
+* Google Summer of Code::
* Autores::
* Reconocimientos::
* Publicaciones::
@subsubheading Lista de distribución de usuarios: @code{lilypond-user@@gnu.org}
-Esta lista de distribución de correo (en inglés) es el lugar principal
-que tienen los usuarios para discutir y prestarse mutua ayuda.
+Esta lista de distribución de correo (en inglés) es el lugar
+principal que tienen los usuarios para discutir y prestarse mutua
+ayuda.
@quotation
@uref{http://lists.gnu.org/mailman/listinfo/lilypond-user,
escribir a la lista lilypond-user a través de gmane}
@end quotation
-@warning{Al formular preguntas, por favor, ¡utilice @ref{Ejemplos mínimos}!}
+@warning{Al formular preguntas, por favor, ¡utilice
+@ref{Ejemplos mínimos}!}
@subsubheading El Repositorio de Fragmentos de Código de LilyPond
El Repositorio de Fragmentos de Código de LilyPond es una gran
-colección de ejemplos remitidos por los usuarios, que se pueden copiar
-y usar libremente en sus propias obras. ¡Vea las cosas que otros han
-escrito, y añada las suyas propias!
+colección de ejemplos remitidos por los usuarios, que se pueden
+copiar y usar libremente en sus propias obras. ¡Vea las cosas que
+otros han escrito, y añada las suyas propias!
@example
@uref{http://lsr.di.unimi.it}
@end example
-Los ejemplos del LSR que son especialmente instructivos se incluyen en
-nuestra documentación oficial, en @ref{Fragmentos}.
+Los ejemplos del LSR que son especialmente instructivos se
+incluyen en nuestra documentación oficial, en @ref{Fragmentos}.
@subsubheading IRC
@uref{http://lists.gnu.org/mailman/listinfo/lilypond-user-fr,
lista de correo en francés}
-
-@uref{http://www.lilypondforum.nl/,
-foro de holandés}
@end quotation
-
@divEnd
@divClass{column-right-top}
-@subheading Esté siempre informado
+@subheading El blog de LilyPond
-@subsubheading LilyPond Report (el Informe LilyPond)
-
-La manera más fácil de estar en contacto es leer el boletín de nuestra
-comunidad, el Informe LilyPond:
+Lea el bog de nuestra comunidad, @q{Scores of Beauty}:
@example
-@uref{http://web.archive.org/web/20110325004849/http://news.lilynet.net}
+@uref{http://lilypondblog.org}
@end example
@subsubheading Lista de correo de lanzamientos: @code{info-lilypond@@gnu.org}
@divClass{column-right-bottom}
-@subheading Discusión entre desarrolladores
+@subheading Discusiones y traducciones
@subsubheading La lista de distribución de desarrolladores: @code{lilypond-devel@@gnu.org}
-Casi toda la discusión entre desarrolladores tiene lugar en esta
-lista. Los parches se deben enviar aquí.
+La discusión entre desarrolladores tiene lugar en esta lista. Los
+parches se pueden también enviar aquí.
@quotation
@uref{http://lists.gnu.org/mailman/listinfo/lilypond-devel,
@subsubheading Lista de fallos: @code{bug-lilypond@@gnu.org}
-La discusión específica sobre fallos se produce aquí.
+Los informes de fallo y discusión sobre ellos se deben enviar
+aquí. No envíe parches a esta lista.
@quotation
@uref{http://lists.gnu.org/mailman/listinfo/bug-lilypond,
@c don't include gmane posting here. -gp
@end quotation
-@warning{Antes de enviar un mensaje a la lista de fallos, lea nuestras
-indicaciones para elaborar @ref{Informes de fallos}.}
+@warning{Antes de enviar un mensaje a la lista de fallos, lea
+nuestras indicaciones para elaborar @ref{Informes de fallos}.}
-@divEnd
-@divClass{column-right-bottom}
-@subheading Correos delicados
+@subsubheading Lista de correo de traducciones: @code{translations@@lilynet.org}
-Los asuntos privados se deben enviar a Graham Percival (gestor del
-proyecto), que lo discutirá con las personas pertinentes.
+Toda discusión sobre la traducción de los manuales de LilyPond se
+debe dirigir aquí. No envíe parches a esta lista.
+
+@quotation
+@uref{http://lilypond-translations.3384276.n2.nabble.com/,
+Archivo de la lista de correo de traducción}
+@end quotation
@divEnd
@divClass{column-center-top}
@subheading ¿Qué son los @qq{ejemplos mínimos}?
-Un ejemplo mínimo es un ejemplo del que no se puede eliminar @strong{nada}.
+Un ejemplo mínimo es un ejemplo del que no se puede eliminar
+@strong{nada}.
@divEnd
@divClass{column-left-bottom}
@item
Un ejemplo mínimo demuestra que se ha esforzado en resolver el
-problema por sí mismo. Cuando alguien envía bloques grandes de código
-de entrada, da la impresión de que no le importa que le ayudemos o que
-no.
+problema por sí mismo. Cuando alguien envía bloques grandes de
+código de entrada, da la impresión de que no le importa que le
+ayudemos o que no.
@item
La creación de un ejemplo mínimo le ayuda a entender lo que está
ocurriendo. Muchos informes falsos de problemas se podrían evitar
-intentando crear un ejemplo mínimo; si no puede reproducir un @qq{bug}
-en un ejemplo mínimo, probablemente el problema era una comprensión
-insuficiente sobre LilyPond, ¡no un verdadero bug!
+intentando crear un ejemplo mínimo; si no puede reproducir un
+@qq{bug} en un ejemplo mínimo, probablemente el problema era una
+comprensión insuficiente sobre LilyPond, ¡no un verdadero bug!
@end itemize
@divEnd
Incluya el número de versión en una instrucción @code{\version}.
@item
-¡Hágalo muy pequeño! Los ejemplos relacionados con el espaciado o la
-disposición de las páginas pueden requerir muchos compases, pero casi
-todos los problemas se pueden reproducir mediante un solo compás o menos.
+¡Hágalo muy pequeño! Los ejemplos relacionados con el espaciado o
+la disposición de las páginas pueden requerir muchos compases,
+pero casi todos los problemas se pueden reproducir mediante un
+solo compás o menos.
@item
-Cuando trate de crear un ejemplo, pruebe a convertir en comentarios
-@w{(@code{%} ó @code{%@{ @dots{} %@}})} distintas secciones del
-archivo. Si puede convertir un bloque en un comentario y aún mostrar
-la idea principal, entonces elimine ese bloque.
+Cuando trate de crear un ejemplo, pruebe a convertir en
+comentarios @w{(@code{%} ó @code{%@{ @dots{} %@}})} distintas
+secciones del archivo. Si puede convertir un bloque en un
+comentario y aún mostrar la idea principal, entonces elimine ese
+bloque.
@item
-Evite la utilización de notas, tonalidades o compases muy complicados,
-a no ser que el bug esté relacionado con el comportamiento de esos
-elementos.
+Evite la utilización de notas, tonalidades o compases muy
+complicados, a no ser que el bug esté relacionado con el
+comportamiento de esos elementos.
@item
-No utilice instrucciones @code{\override} ni @code{\set} a no ser que
-el bug se refiera a esas instrucciones en concreto.
+No utilice instrucciones @code{\override} ni @code{\set} a no ser
+que el bug se refiera a esas instrucciones en concreto.
@item
Opcionalmente, adjunte una imagen que muestre el resultado gráfico
@}
@end example
-Muy pocos ejemplos mínimos superan las 10 líneas de código;
-¡lo más corriente es que basten 4 líneas para mostrar el problema!
+Muy pocos ejemplos mínimos superan las 10 líneas de código; ¡lo
+más corriente es que basten 4 líneas para mostrar el problema!
@divEnd
@translationof Bug reports
@divClass{heading-center}
-Si tiene un código de entrada que produce una terminación abrupta o
-una salida defectuosa, eso es un bug.
+Si tiene un código de entrada que produce una terminación abrupta
+o una salida defectuosa, eso es un bug.
@divEnd
@divClass{column-center-top}
Probablemente ya estamos al tanto de este bug. Compruébelo aquí:
@example
-@uref{http://code.google.com/p/lilypond/issues/list}
+@uref{http://sourceforge.net/p/testlilyissues/issues/}
@end example
@warning{Le rogamos que @strong{NO} añada informes de fallos
-directamente al sistema de seguimiento. Una vez que un problema se ha
-añadido al sistema, ya puede añadir libremente más información a ese
-informe.}
+directamente al sistema de seguimiento. Una vez que un problema
+se ha añadido al sistema, ya puede añadir libremente más
+información a ese informe.}
@divEnd
Si ha descubierto un fallo que no está en la lista, ayúdenos
elaborando un informe de fallo.
-@warning{Sólo aceptamos informes en forma de @ref{Ejemplos mínimos}.
-Disponemos de recursos muy limitados, por lo que cualquier ejemplo que
-no sea mínimo va a ser rechazado. ¡Casi todos los bugs se pueden
-demostrar con cuatro notas o menos!}
+@warning{Sólo aceptamos informes en forma de @ref{Ejemplos
+mínimos}. Disponemos de recursos muy limitados, por lo que
+cualquier ejemplo que no sea mínimo va a ser rechazado. ¡Casi
+todos los bugs se pueden demostrar con cuatro notas o menos!}
He aquí un ejemplo de un buen informe de fallo:
@item
Si está suscrito a la lista de correo
-@uref{mailto:bug-lilypond@@gnu.org,bug-lilypond@@gnu.org},
-envíe un mensaje de la forma habitual.
+@uref{mailto:bug-lilypond@@gnu.org,bug-lilypond@@gnu.org}, envíe
+un mensaje de la forma habitual.
@item
Si no está suscrito, aún puede enviar un informe de fallo con el
interfaz web de gmane para lilypond.bugs}.
Sin embargo, existe una comprobación muy estricta de que no hay
-@qq{top-posting} (contestar por encima) en el interfaz de gmane, que se
-dispara incorrectamente con frecuencia a causa de los archivos de lilypond.
-Para evitarlo, escriba:
+@qq{top-posting} (contestar por encima) en el interfaz de gmane,
+que se dispara incorrectamente con frecuencia a causa de los
+archivos de lilypond. Para evitarlo, escriba:
@example
> I'm not top posting.
@end example
@noindent
-(@emph{debe} escribir el ángulo @code{>} ) al principio de su informe.
+(@emph{debe} escribir el ángulo @code{>} ) al principio de su
+informe.
@end itemize
@divEnd
Una vez que su informe de fallo se ha enviado a la lista, nuestro
Escuadrón de Fallos lo examinará el informe. Quizá le pidan más
-información. Se le avisará cuando el informe se añada al sistema de
-seguimiento de fallos. Déles un tiempo de unos 4 días, pues
+información. Se le avisará cuando el informe se añada al sistema
+de seguimiento de fallos. Déles un tiempo de unos 4 días, pues
disponemos de un número limitado de voluntarios para esta tarea.
-Una vez que el fallo se ha añadido al sistema de seguimiento, puede
-comentarlo para añadirle más información. Puede marcar el bug con una
-estrella de forma que reciba mensajes automáticamente cuando se
-produce cualquier actividad sobre él. Ello requiere que usted
-disponga de una cuenta en Google.
+Una vez que el fallo se ha añadido al sistema de seguimiento,
+puede comentarlo para añadirle más información. Puede marcar el
+bug con una estrella de forma que reciba mensajes automáticamente
+cuando se produce cualquier actividad sobre él. Ello requiere que
+usted disponga de una cuenta en Google.
@divEnd
@divClass{column-center-bottom}
@subheading Ayuda opcional: mostrar el resultado deseado
Una vez que el problema se ha añadido al sistema de seguimiento,
-puede ser de mucha ayuda que veamos la salida deseada.
-¡Con toda libertad añada código de entrada y/o imágenes
-(creadas posiblemente con otras herramientas)
-que muestren el aspecto que usted cree que debe tener!
+puede ser de mucha ayuda que veamos la salida deseada. ¡Con toda
+libertad añada código de entrada y/o imágenes (creadas
+posiblemente con otras herramientas) que muestren el aspecto que
+usted cree que debe tener!
@divEnd
@divClass{column-right-top}
@subheading Guidelines
-Cualquier usuario que quiera ofrecer dinero a cambio de un trabajo,
-debería tener en cuenta los siguientes puntos:
+Cualquier usuario que quiera ofrecer dinero a cambio de un
+trabajo, debería tener en cuenta los siguientes puntos:
@itemize
@item
-Los desarrolladores de LilyPond pueden anunciar sus servicios en las
-listas de correo de lilypond de vez en cuando.
+Los desarrolladores de LilyPond pueden anunciar sus servicios en
+las listas de correo de lilypond de vez en cuando.
@item
Cualquier acuerdo entre personas individuales debiera incluir las
precauciones normales cuando se hacen negocios: quién paga, cuánto
paga, qué método se utiliza para pagar, y sobre qué paquete de
-condiciones. Sugerimos que cualquier ambigüedad o incertidumbre en
-tales cuestiones se resuelvan antes de que dé comienzo cualquier
-trabajo.
+condiciones. Sugerimos que cualquier ambigüedad o incertidumbre
+en tales cuestiones se resuelvan antes de que dé comienzo
+cualquier trabajo.
@end itemize
@subheading Desarrolladores interesados
A continuación aparece una lista de las personas que han expresado
-interés en recibir recompensas. Observe que la cantidad de trabajo
-hecha por personas individuales varía bastante a lo largo de los
-años. No garantizamos que esta lista esté actualizada, ni que las
-personas aquí relacionadas tengan cualquier disponibilidad. El único
-criterio es "Fulanito ha pedido aparecer en esta página".
-
-El examen de la historia del sistema de control de versiones Git es
-una buena manera de determinar quiénes son los desarrolladores más
-activos y experimentados. Las estadísticas están al día hasta la
-versión @versionDevel{}:
+interés en recibir recompensas. Observe que la cantidad de
+trabajo hecha por personas individuales varía bastante a lo largo
+de los años. No garantizamos que esta lista esté actualizada, ni
+que las personas aquí relacionadas tengan cualquier
+disponibilidad. El único criterio es "Fulanito ha pedido aparecer
+en esta página".
+
+El examen de la historia del sistema de control de versiones Git
+es una buena manera de determinar quiénes son los desarrolladores
+más activos y experimentados. Las estadísticas están al día hasta
+la versión @versionDevel{}:
@multitable @columnfractions .3 .3 .3
@item @uref{http://lilypond.org/~graham/gitstats-all/, historia general}
Desarrolladores interesados:
@table @asis
@item @email{dak@@gnu.org, David Kastrup}
-Se necesitan donaciones para que yo pueda continuar mi atual trabajo a
-tiempo completo sobre LilyPond. Me concentro en diseño de interfaces
-de usuario y del programador, coherencia, implementación,
-simplificación, documentación y depuración.
+Se necesitan donaciones para que yo pueda continuar mi actual
+trabajo a tiempo completo sobre LilyPond. Me concentro en diseño
+de interfaces de usuario y del programador, coherencia,
+implementación, simplificación, documentación y depuración.
@c Format
@c @item @email{name@@adress.domain, Name}
@c we normally don't allow named references, but in this case
@c it's good to emphasize the "stable" part. -gp
-@warning{Éstas son las versiones @emph{inestables de desarrollo}. Si
-tiene la más ligera duda acerca de cómo usar o instalar LilyPond, le
-conminamos a que utilice la @ref{Descarga, descarga estable},
-y lea los @ref{Manuales, manuales estables}.}
+@warning{Éstas son las versiones @emph{inestables de desarrollo}.
+Si tiene la más ligera duda acerca de cómo usar o instalar
+LilyPond, le conminamos a que utilice la
+@ref{Descarga, descarga estable}, y lea los
+@ref{Manuales, manuales estables}.}
@divEnd
Existen dos conjuntos de lanzamientos para LilyPond: lanzamientos
estables, y lanzamientos inestables de desarrollo. Las versiones
-estables tienen un número de versión @q{menor} par (p.ej., 2.8, 2.10,
-2.12). Las versiones de desarrollo tienen un número @q{menor} de
-versión impar (p.ej., 2.7, 2.9, 2.11).
+estables tienen un número de versión @q{menor} par (p.ej., 2.8,
+2.10, 2.12). Las versiones de desarrollo tienen un número
+@q{menor} de versión impar (p.ej., 2.7, 2.9, 2.11).
@divEnd
@divClass{column-left-top}
@subheading Descarga
-Las instrucciones de Git y para la compilación están en la Guía del
-Colaborador.
+Las instrucciones de Git y para la compilación están en la Guía
+del Colaborador.
@quotation
@uref{http://git.sv.gnu.org/gitweb/?p=lilypond.git, Repositorio Git de lilypond}
@divClass{column-right-top}
@subheading Guía del colaborador
-El desarrollo de LilyPond es un asunto bastante complicado. LilyPond
-es un proyecto grande y (más o menos) estable. Para poder ayudar a
-los nuevos colaboradores, y para mantener todo el sistema (más o
-menos) estable, hemos escrito un manual para los colaboradores.
+El desarrollo de LilyPond es un asunto bastante complicado.
+LilyPond es un proyecto grande y (más o menos) estable. Para
+poder ayudar a los nuevos colaboradores, y para mantener todo el
+sistema (más o menos) estable, hemos escrito un manual para los
+colaboradores.
@docLinksBare{Guía del colaborador, contributor,
@rcontribnamed{Top,Guía del colaborador},
@subheading Manuales
@ifclear web_version
-@warning{Estos manuales son para LilyPond @version{}; los manuales más recientes
-están en @url{http://lilypond.org}}
+@warning{Estos manuales son para LilyPond @version{}; los manuales
+más recientes están en @url{http://lilypond.org}}
@end ifclear
@divClass{normal-table}
@divEnd
-
-
-@node GSoC 2012
-@unnumberedsec GSoC 2012
-@translationof GSoC 2012
+@node Google Summer of Code
+@unnumberedsec Google Summer of Code
+@translationof Google Summer of Code
@divClass{column-center-top}
@subheading ¿Qué es el Google Summer of Code (Verano del Código de Google)?
-Es un programa global llevado a cabo por Google que ofrece a
-estudiantes una ayuda para que trabajen en proyectos de software de
-fuentes abiertas durante las vacaciones de verano.
-
-El equipo de LilyPond decidió que ésta era una excelente oportunidad
-para encontrar colaboradores nuevos y animar a los estudiantes que ya
-participan en el desarrollo de LilyPond a que se impliquen aún más.
-Uno de nuestros colaboradores ha sido seleccionado para la edición
-2012 del programa como parte del
-@uref{http://www.gnu.org/, proyecto GNU}; esperamos poder participar
-también en futuras ediciones.
+@uref{https://developers.google.com/open-source/gsoc/, GSoC} es un
+programa global que ofrece a estudiantes una ayuda para que
+trabajen en proyectos de software de fuentes abiertas durante las
+vacaciones de verano. Es una excelente oportunidad para que los
+estudiantes obtengan experiencia en el desarrollo de software en
+el mundo real y hagan contribuciones que beneficie a todos. Atrae
+a colaboradores nuevos y anima a los estudiantes que ya participan
+en el desarrollo de LilyPond a que se impliquen aún más. LilyPond
+participa en el GSoC como parte del @uref{http://www.gnu.org/,
+proyecto GNU}.
+
+Hemos tenido participantes en el GSoC en 2012 y 2015 y animamos a
+los estudiantes a que envíen la solicitud para las futuras
+ediciones.
+
+Si tiene alguna pregunta o le gustaría solicitar la participación,
+envíenos un correo a la lista de desarrolladores (véase
+@ref{Contacto}).
@divEnd
@divClass{column-center-bottom}
-@subheading Nuestra lista de ideas para el 2012
-
-Más abajo aparece una lista de los proyectos que hemos sugerido para
-los estudiantes del GSoC 2012. Aunque ha finalizado el plazo de
-solicitudes, hemos decidido mantener visible esta página como
-inspiración para cualquier persona interesada en el desarrollo de
-LilyPond. Algunos miembros del equipo de desarrollo están dispuestos
-a prestar su ayuda a aquellos que quieran implicarse en estos
-proyectos.
-
-Por supuesto, hay muchas más cosas que mejorar en LilyPond, entre
-ellas algunas muy pequeñas. Hay una lista completa
+@subheading Lista de ideas del proyecto
+
+Más abajo aparece una lista de los proyectos que fue inicialmente
+sugerida para el GSoC 2012. Se mantiene aquí como inspiración
+para futuros proyectos del GSoC y para cualquier persona
+interesada en el desarrollo de LilyPond.
+
+Observe que no es una lista exhaustiva. También son posibles
+otros proyectos de GSoC. Existen varias áreas en las que LilyPond
+puede mejorar y el equipo de desarrollo de LilyPond está siempre
+dispuesto a servir de ayuda a aquellos que deseen implicarse en un
+proyecto como los que aparecen relacionados más abajo.
+
+Hay una lista completa de todas las incidencias abiertas
@uref{http://code.google.com/p/lilypond/issues/list, aquí}.
-@subheading Notas de adorno
+@divEnd
-Arreglar problemas con la sincronización de las notas de adorno,
-junto a toda la arquitectura subyacente (véase
-@uref{http://code.google.com/p/lilypond/issues/detail?id=34, el problema número 34 de nuestro sistema de seguimiento}).
-Las notas de adorno confunden al sistema de cuenta de tiempo de
-LilyPond porque son como ir hacia atrás en el tiempo. Esto causa
-efectos extraños, en especial cuando un pentagrama tiene una nota de
-adorno que otro no tiene.
+@divClass{column-center-middle-color3}
+@subheading ScholarLY
+
+ScholarLY es una biblioteca dentro de
+@uref{https://github.com/openlilylib/snippets, openLilyLib} que
+provee funcionalidades para la anotación de partituras, haciendo
+posible gestionar flujos de trabajo académicos completamente en el
+contexto del documento de la partitura. Hasta ahora es posible
+introducir anotaciones de distintos tipos, producir mensajes que
+se comportan como enlaces sobre la salida de consola y exportar a
+texto y a archivos de LaTeX.
+
+Hay muchas solicitudes de funcionalidad para la conversión de esta
+biblioteca en una herramienta mmás potente y completa aún, por
+ejemplo: inserción de ejemplos musicales, producción de notas al
+pie de página, aplicación automárica de estilos al elemento
+anotado (p. ej. trazar una ligadura en línea discontinua, poner
+una alteración entre paréntesis), creando informes con elementos
+sobre los que se puede apuntar y pulsar. Para ver una descripción
+completa de esta sugerencia de proyecto, visite
+@uref{https://github.com/openlilylib/scholarly/wiki/GSoC}.
@strong{Dificultad:} media
+@strong{Requisitos:} Scheme, posiblemente LaTeX, (opcionalmente
+Python)
+@strong{Conocimientos recomendados:} Experiencia con, o interés
+en, la edición académica y flujos de trabajo colaborativos.
+@strong{Mentor potencial:} Urs Liska
-@strong{Requisitos:} C++, MIDI
+@divEnd
-@strong{Recomendado:} familiaridad con el funcionamiento interno de LilyPond
+@divClass{column-center-middle-color3}
+@subheading Notas de adorno
+
+Arreglar problemas con la sincronización de las notas de adorno.
+Las notas de adorno pueden interferir con la cuenta del tiempo de
+LilyPond y causar efectos extraños, especialmente cuando se usan
+varios pentagramas en los que algunos tienen notas de adorno y
+otros no.
+
+@strong{Dificultad:} media
+@strong{Requisitos:} C++, MIDI
+@strong{Conocimientos recomendados:} familiaridad con el
+funcionamiento interno de LilyPond
+@strong{Mentores potenciales:} Mike Solomon, Carl Sorensen
-@strong{Mentor(es):} Mike Solomon, Carl Sorensen
+@divEnd
+@divClass{column-center-middle-color3}
@subheading MusicXML
-Añadir exportación completa de MusicXML y mejora de la importación,
-junto a las pruebas de comprobación de que funciona. Dependiendo del
-tiempo disponible, implementar algunos o todos los siguientes:
+Mejora de las funciones de importación y exportación de MusicXML:
@divClass{keep-bullets}
@itemize
@item
Manejo de la exportación del contenido musical básico como la
exportación MIDI (es decir, uso de clases exportadoras dedicadas,
-derivadas de la clase translator)
+derivadas de la clase translator).
@item
-Construir el árbol XML del contenido musical básico, y una conexión
-desde el evento musical a la etiqueta XML
+Construir el árbol XML del contenido musical básico, y una
+conexión desde el evento musical a la etiqueta XML.
@item
-Hacer que todos los grabadores de LilyPond hagan su trabajo
+Hacer que todos los grabadores de LilyPond hagan su trabajo.
@item
-Añadir la posibilidad de enlazar cada objeto de presentación
-(básicamente cada sello o grupo de sellos) a la causa musical (así
-como a la etiqueta XML dentro del árbol XML)
+Enlazar cada objeto de presentación (es decir, cada sello o grupo
+de sellos) a la causa musical (así como a la etiqueta XML dentro
+del árbol XML).
@item
-Añadir un @q{back-end} de salida XML, que puede después añadir la
-información de disposición para cada uno de los objetos de salida a
-las etiquetas del XML
+Añadir un @q{back-end} de salida XML, que puede después añadir
+información de disposición para cada uno de los objetos de salida
+a las etiquetas del XML.
@end itemize
@divEnd
-El objetivo se considerará conseguido cuando una partitura
-(previamente seleccionada) pueda importarse desde el MusicXML y
-exportada de nuevo sin ninguna pérdida de datos no intencionada.
-
@strong{Dificultad:} media
-
@strong{Requisitos:} MusicXML, Python, conocimiento básico de LilyPond
+@strong{Mentores potenciales:} Reinhold Kainhofer, Mike Solomon
-@strong{Mentor(es):} Reinhold Kainhofer, Mike Solomon
+Sería un buen tanto a su favor la familiaridad con otros editores
+de partituras para poder hacer pruebas cruzadas.
-Sería un buen tanto a su favor la familiaridad con otros editores de
-partituras para poder hacer pruebas cruzadas.
+@divEnd
+@divClass{column-center-middle-color3}
@subheading Mejora de las ligaduras de unión y de expresión
-A menudo la forma predeterminada de las curvas de ligadura no es
-satisfactoria. No están contempladas las ligaduras de unión entre
-notas enarmónicas @code{@{ dos'~ reb' @}}, las ligaduras "rotas" por
-una clave o un cambio de pauta no están bien contempladas. El
-proyecto incluye la recolección y ordenación de ejemmplos de salida
-defectuosa, decidir sobre la salida que se desea tener y escribir el
-código correspondiente.
+Con frecuencia, las curvas de las ligaduras de unión y de
+expresión no son satisfactorias. No se manejan bien las ligaduras
+@q{interrumpidas} por cambios de clave o de pentagrama. El
+proyecto podría incluir y organizar ejemplos de mala salida,
+decidir sobre la salida perseguida y escibir código para
+mejorarla.
@strong{Dificultad:} alta
-
@strong{Requisitos:} C++, experiencia con heurística de la escritura
-
@strong{Conocimientos recomendados:} LilyPond, sentido estético
+@strong{Mentor potencial:} Mike Solomon
-@strong{Mentor(es):} Mike Solomon
+@divEnd
+@divClass{column-center-middle-color3}
@subheading Añadir una variante especial de los glifos de fuente tipográfica
-Añadir variantes para algunos glifos, como los signos de alteración,
-para líneas sobre la pauta, entre pautas, acortadas y estrechadas, así
-como una infraestructura genérica para incorporarlos. Un ejemplo es
-la cabeza de la breve de na notación antigua, que viene en dos
-variantes, con el orificio pequeño y grande.
-@strong{Dificultad:} fácil
+@divClass{keep-bullets}
+@itemize
-@strong{Requisitos:} MetaFont, C++, buen ojo para los detalles
+@item
+Añadir variantes @q{sobre} y @q{entre} líneas del pentagrama.
+
+@item
+Variantes más bajas y estrechas de ciertos glifos, como
+alteraciones alccidentales. Otro ejemplo más específico sería una
+cabeza de nota breve de la notación antigua en dos variantes, una
+con un hueco pequeño dentro, y otra con un hueco grande.
+@end itemize
+@divEnd
+
+@strong{Dificultad:} fácil
+@strong{Requisitos:} MetaFont, C++, buen ojo para los detalles
@strong{Conocimientos recomendados:} conocimientos básicos de LilyPond
+@strong{Mentor potencial:} Werner Lemberg
-@strong{Mentor(es):} Werner Lemberg
+@divEnd
-@subheading Mejora del barrado
+@divClass{column-center-middle-color3}
+@subheading Mejora del posicionamiento de las barras de corchea (y figuras menores)
-Debería mejorarse el posicionamiento predeterminado de las barras de
-corchea (y figuras menores) normales, de pentagrama cruzado,
-interrumpidas y en ángulo. El barrado debería depender del contexto y
-de las notas vecinas (véase la
+Para barras de corchea normales, de pentagrama cruzado,
+interrumpidas y en ángulo. El barrado debería depender del
+contexto y de las notas vecinas (véase la
@uref{http://icking-music-archive.org/lists/sottisier/sottieng.pdf,
-sección 2.2}).
-Si es posible, reducir el tiempo de cálculo del barrado.
+sección 2.2}). Si es posible, reducir el tiempo de cálculo del
+barrado.
@strong{Dificultad:} media
-
@strong{Requisitos:} C++, experiencia con heurística de la escritura
-
@strong{Conocimientos recomendados:} sentido estético
+@strong{Mentores potenciales:} Mike Solomon, Carl Sorensen
+
-@strong{Mentor(es):} Mike Solomon, Carl Sorensen
+@divEnd
-@subheading Limpieza de diversas advertencias de compliación
+@divClass{column-center-middle-color3}
+@subheading Ayudar a mejorar el comportamiento de la compilación
-Limpieza de las advertencias de compilación, análisis estático del
-código, y advertencias de valgrind. Las herramientoas de análisis
-automático del código (advertencias de @code{g++} y @code{clang}) y
-herramientas de análisis como la detección de filtraciones de memoria
-de los perfiladores de código valgrind y callgrind aportan valiosa
-información sobre posibles problemas en el código de C++. La limpieza
-de estas advertencias nos permitiría rechazar automáticamente
-cualquier parche que introdujese más advertencias de las que hay
+Las herramientas de análisis automático del código, como la
+detección de filtraciones de memoria de Valgrind o el perfilador
+de código Callgrind, proveen una información valiosa acerca de los
+posibles problemas de nuestro código de C++. La limpieza de estas
+advertencias nos permitiría rechazar automáticamente cualquier
+parche que introdujese más advertencias de las que hay
actualmente.
@strong{Dificultad:} media
-
@strong{Requisitos:} C++
-
-@strong{Mentor(es):} Joe Neeman, Reinhold Kainhofer
+@strong{Mentores potenciales:} Joe Neeman, Reinhold Kainhofer
@divEnd
@c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
@ignore
- Translation of GIT committish: 53ea968b35ad64c914a7bd503786aaf8d3b0c762
+ Translation of GIT committish: 43c2555cc5bef3b10f0f9d5c5431697fe7b4cb3c
When revising a translation, copy the HEAD committish of the
version that you are working on. For details, see the Contributors'
@divEnd
-@divClass{column-center-bottom}
+@divClass{column-center-middle-color2}
@subheading Licencia del Software
@divEnd
-@divClass{color1}
+@divClass{column-center-bottom}
@subheading Patrocinadores
@sourceimage{VTlogo_ITF,,,}
@sourceimage{lao_banner_06_on_white_demo,,,}
+@divEnd
+
+@divClass{column-center-bottom}
@subheading Legalismos
@divClass{legal}
@divClass{column-center-top}
@subheading ¿Paquetes genéricos, o paquetes específicos de la distribución?
-Muchas distribuciones ya incluyen a LilyPond dentro de sus
-repositorios normales de paquetes y con frecuencia son mucho más
-fáciles de instalar que los paquetes genéricos que ofrecemos aquí.
-Sin embargo, la versión de LilyPond de dichos repositorios podría
-ser @emph{significativamente} más antigua que la versión estable
-actual. Si quiere utilizar nuestros paquetes genéricos, compruebe
+Muchas distribuciones incluyen a LilyPond dentro de sus
+repositorios normales de paquetes que con frecuencia son
+@emph{significativamente} más antiguos que la versión estable
+actual. Aunque dichos paquetes antiguos pueden ser mucho más
+fáciles de instalar, recomendamos@emph{encarecidamente} que utilice nuestros paquetes genéricos. En tal caso, compruebe
que su editor de LilyPond está usando la versión correcta del
-programa lilypond. Véase @ref{Entornos mejorados}.
+programa. Véase @ref{Entornos mejorados}.
@divEnd
@downloadDevelLinuxNormal
@end ifclear
@ifset web_version
-@downloadStableLinuxNormal
+ @downloadStableLinuxNormal
@end ifset
-
-(si no está seguro, utilice éste)
+Sistemas de 32 bits.
@item
@sourceimage{logo-linux,,,}
@downloadStableLinuxBig
+Sistemas de 64 bits.
@item
@sourceimage{logo-linux,,,}
@item
@sourceimage{logo-freebsd,,,}
@downloadStableFreeBSDNormal
+Sistemas de 32 bits.
@item
@sourceimage{logo-freebsd,,,}
@downloadStableFreeBSDBig
+Sistemas de 64 bits.
@end itemize
@divClass{column-right-top}
-@subheading Paquetes específicos de cada distribución
-
-Utilice el gestor de paquetes de su distribución para instalar o
-actualizar a estas versiones.
-
-@itemize
-
-@item
-@sourceimage{logo-fedora,,,}
-@uref{http://koji.fedoraproject.org/koji/packageinfo?packageID=2447,
-Fedora: LilyPond 2.14.2}
-
-@item
-@sourceimage{logo-ubuntu,,,}
-@uref{http://packages.ubuntu.com/search?keywords=lilypond,
-Ubuntu: LilyPond 2.14.2}
-
-@item
-@sourceimage{logo-slackware,,,}
-@uref{http://www.johannes-schoepfer.de/lilypond/,
-Slackware: LilyPond 2.14.2}
-
-@item
-@sourceimage{logo-debian,,,}
-@uref{http://packages.debian.org/search?keywords=lilypond,
-Debian: LilyPond 2.12.3}
-
-@item
-@sourceimage{logo-suse,,,}
-@uref{http://software.opensuse.org/search?baseproject=openSUSE%3A11.2&p=1&q=lilypond,
-openSUSE: LilyPond 2.12.3}
-
-@end itemize
-
-@divEnd
-
-
-@divClass{column-center-top}
@subheading Compilación de un archivo
@lilypadCommandLine
[@var{ruta preestablecida}];@var{CARPETA}\LilyPond\usr\bin
@end example
-@warning{@var{CARPETA} será por lo general @code{C:@bs{}Archivos de programa}.}
+@warning{@var{CARPETA} será por lo general @code{C:@bs{}Archivos de programa (x86)}
+para los sistemas de 64 bits o @code{C:@bs{}Archivos de programa} para los de 32 bits.}
@noindent
y pulse el botón @qq{Aceptar} para cerrar la ventana.
@c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
@ignore
- Translation of GIT committish: fdb9b90f39b33d15d097f69c43c7799b1c1dce9b
+ Translation of GIT committish: 0ea80a5e850c6114d1ba7dc4cfd81d5a45d9604a
When revising a translation, copy the HEAD committish of the
version that you are working on. For details, see the Contributors'
@c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
@ignore
- Translation of GIT committish: 08c1ead90d9f49e66ce54208639fb9ef48ca52a6
+ Translation of GIT committish: df759fb23c969916ac0c4d820b94a460aeb3f35b
When revising a translation, copy the HEAD committish of the
version that you are working on. For details, see the Contributors'
@c used for news about the upcoming release; see CG 10.2
@newsItem
-@subheading Lanzado LilyPond 2.19.34 @emph{22 de diciembre de 2015}
-
-Nos complace anunciar el lanzamiento de LilyPond 2.19.34. Esta
-versión contiene el conjunto habitual de correcciones de fallos y
-ampliación de las funcionalidades, y contiene trabajos en
-desarrollo. Tendrá acceso a las últimas posibilidades, pero
-algunas podrían estar incompletas, y podría encontrar fallos y
-finalizaciones abruptas. Si necesita una versión estable de
-LilyPond, nuestro consejo es que utilice la versión 2.18.
+@subheading LilyPond 2.19.36 released @emph{January 31, 2016}
+
+We are happy to announce the release of LilyPond
+2.19.36. This release includes a number of enhancements, and contains some
+work in progress. You will have access to the very latest features, but
+some may be incomplete, and you may encounter bugs and crashes. If you
+require a stable version of Lilypond, we recommend using the 2.18
+version.
@newsEnd
@c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
@ignore
- Translation of GIT committish: 08c1ead90d9f49e66ce54208639fb9ef48ca52a6
+ Translation of GIT committish: df759fb23c969916ac0c4d820b94a460aeb3f35b
When revising a translation, copy the HEAD committish of the
version that you are working on. For details, see the Contributors'
* don't duplicate entries from news-front.itexi
@end ignore
+@newsItem
+@subheading Lanzado LilyPond 2.19.35 @emph{2 de enero de 2016}
+
+Nos complace anunciar el lanzamiento de LilyPond 2.19.35. Esta
+versión contiene el conjunto habitual de correcciones de fallos y
+ampliación de las funcionalidades, y contiene trabajos en
+desarrollo. Tendrá acceso a las últimas posibilidades, pero
+algunas podrían estar incompletas, y podría encontrar fallos y
+finalizaciones abruptas. Si necesita una versión estable de
+LilyPond, nuestro consejo es que utilice la versión 2.18.
+
+@newsEnd
+
+@newsItem
+@subheading Lanzado LilyPond 2.19.34 @emph{22 de diciembre de 2015}
+
+Nos complace anunciar el lanzamiento de LilyPond 2.19.34. Esta
+versión contiene el conjunto habitual de correcciones de fallos y
+ampliación de las funcionalidades, y contiene trabajos en
+desarrollo. Tendrá acceso a las últimas posibilidades, pero
+algunas podrían estar incompletas, y podría encontrar fallos y
+finalizaciones abruptas. Si necesita una versión estable de
+LilyPond, nuestro consejo es que utilice la versión 2.18.
+
+@newsEnd
+
@newsItem
@subheading Lanzado LilyPond 2.19.33 @emph{6 de diciembre de 2015}
@item
When a music function (as opposed to an event function) returns an
expression of type post-event, LilyPond requires one of the named
-direction indicators (@code{-}, @code{^}, @w{and @code{_}})) in order to
+direction indicators (@code{-}, @code{^}, @w{and @code{_}}) in order to
properly integrate the post-event produced by the music function call
into the surrounding expression.
It is possible to output one or more fragments of a score by defining
the explicit location of the music to be extracted within the
-@code{\layout} block of the the input file using the @code{clip-regions}
+@code{\layout} block of the input file using the @code{clip-regions}
function, and then running LilyPond with the @option{-dclip-systems}
option;
By default, a clef that has previously been printed will not be
re-printed if the same @code{\clef} command is issued again and
-will be ignored. The the command
+will be ignored. The command
@code{\set Staff.forceClef = ##t} changes this behaviour.
@lilypond[verbatim,quote,fragment]
\key c \major
\relative c''
{
- % disable the following line to see the the noteheads while writing the song
+ % disable the following line to see the noteheads while writing the song
\NoNoteHead
\override NoteHead.no-ledgers = ##t
@item
@sourceimage{logo-freebsd,,,}
@downloadStableFreeBSDBig
-64bit Systems
+64bit Systems.
@end itemize
projects / lilypond.git / commitdiff