Documentation/es/notation/spacing.itely

   1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
   2
   3 @ignore
   4     Translation of GIT committish: b446ebc24f8d43acb323818988fe8b1d8072afc8
   5
   6     When revising a translation, copy the HEAD committish of the
   7     version that you are working on.  For details, see the Contributors'
   8     Guide, node Updating translation committishes..
   9 @end ignore
  10
  11 @c \version "2.13.39"
  12
  13 @node Problemas de espaciado
  14 @chapter Problemas de espaciado
  15 @translationof Spacing issues
  16
  17 La disposición global sobre el papel viene determinada por tres
  18 factores: el diseño de página, los saltos de línea y el espaciado.
  19 Estos factores influyen entre sí.  La elección de uno u otro espaciado
  20 determina qué densidad termina teniendo cada sistema de música.  Esto
  21 influye en el lugar en que se eligen los saltos de línea y, en último
  22 término, en el número de páginas que tiene una partitura.
  23
  24 Considerado globalmente, este proceso se produce en cuatro fases: en
  25 primer lugar se eligen unas distancias elásticas o @q{muelles},
  26 basados en la duración de las figuras.  Se prueban todas las
  27 combinaciones de saltos de línea posibles, y para cada una de ellas se
  28 calcula una puntuación de @q{maldad}.  Después se hace una estimación
  29 de la altura de cada uno de los posibles sistemas.  Finalmente se
  30 selecciona una combinación de saltos de página y de línea de tal forma
  31 que ni el espaciado horizontal ni el vertical estén demasiado
  32 estrechos ni estirados.
  33
  34 Los ajustes que influyen en la disposición se pueden agrupar en dos
  35 bloques.  El bloque @code{\paper @{...@}} se sitúa fuera de los
  36 bloques @code{\score @{...@}} y contiene ajustes relacionados con el
  37 documento como un todo.  El bloque @code{\layout @{...@}} se sitúa
  38 dentro de un bloque @code{\score @{...@}} y contiene ajustes para
  39 dicha partitura en concreto.  Si sólo tiene un bloque @code{\score
  40 @{...@}}, los dos tienen el mismo efecto.  En general las
  41 instrucciones que se muestran en este capítulo se pueden poner en
  42 cualquiera de los dos.
  43
  44 @menu
  45 * El papel y las páginas::
  46 * Disposición de la música::
  47 * Saltos::
  48 * Espaciado vertical::
  49 * Espaciado horizontal::
  50 * Encajar la música en menos páginas::
  51 @end menu
  52
  53
  54 @node El papel y las páginas
  55 @section El papel y las páginas
  56 @translationof Paper and pages
  57
  58 Esta sección se ocupa de los límites que definen la zona del papel en
  59 que se puede imprimir la música.
  60
  61 @menu
  62 * Tamaño del papel::
  63 * Formateo de las páginas::
  64 @end menu
  65
  66
  67 @node Tamaño del papel
  68 @subsection Tamaño del papel
  69 @translationof Paper size
  70
  71 @cindex papel, tamaño del
  72 @cindex página, tamaño de la
  73
  74 Existen dos funciones para cambiar el tamaño del papel:
  75 @code{set-default-paper-size} (establecer tamaño de página
  76 predeterminado) y @code{set-paper-size} (establecer tamaño de página).
  77 @code{set-default-paper-size} se debe poner en el ámbito del nivel
  78 superior, y @code{set-paper-size} se debe poner en un bloque
  79 @code{\paper}:
  80
  81 @example
  82 #(set-default-paper-size "a4")
  83 @end example
  84
  85 @example
  86 \paper @{
  87   #(set-paper-size "a4")
  88 @}
  89 @end example
  90
  91 @noindent
  92 @code{set-default-paper-size} establece el tamaño de todas las
  93 páginas, mientras que @code{set-paper-size} establece sólo el tamaño
  94 de las páginas a las que se aplica el bloque @code{\paper}.  Por
  95 ejemplo, si el bloque @code{\paper} está al principio del archivo,
  96 aplica el tamaño de papel a todas las páginas.  Si el bloque
  97 @code{\paper} está dentro de un bloque @code{\book}, entonces el
  98 tamaño del papel sólo se aplica a ese libro.
  99
 100 Se encuentran disponibles los tamaños de papel más comunes, entre
 101 ellos @code{a4}, @code{letter}, @code{legal} y @code{11x17} (conocido
 102 también como tabloide). Están contemplados muchos más tamaños de papel
 103 de forma predeterminada.  Para ver más detalles, consulte
 104 @file{scm/@/paper@/.scm} y busque la definición de @code{paper-alist}.
 105
 106 @c TODO add a new appendix for paper sizes (auto-generated) -pm
 107
 108 @warning{El tamaño predeterminado del papel es @code{a4}.}
 109
 110 Se pueden añadir tamaños adicionales editando la definición de
 111 @code{paper-alist} en el archivo de inicio @file{scm/@/paper@/.scm},
 112 aunque se sobreescribirán en la siguiente reinstalación del programa.
 113
 114 @cindex orientación
 115 @cindex apaisado
 116 @cindex horizontal, papel
 117
 118 Si se añade el símbolo @code{'landscape} (apaisado) como argumento a
 119 @code{set-default-paper-size}, las páginas se giran 90 grados y se
 120 establece en consonancia una mayor longitud de las líneas.
 121
 122 @example
 123 #(set-default-paper-size "a6" 'landscape)
 124 @end example
 125
 126 Al establecer el tamaño del papel se ajustan un cierto número de
 127 variables del @code{\paper}, tales como los márgenes.  Para utilizar
 128 un tamaño de página determinado con variables de @code{\paper}
 129 alteradas, establezca el tamaño de página antes de dar valores a las
 130 variables.
 131
 132
 133 @seealso
 134 Archivos instalados:
 135 @file{scm/@/paper@/.scm}.
 136
 137 Fragmentos de código:
 138 @rlsr{Spacing}.
 139
 140
 141 @node Formateo de las páginas
 142 @subsection Formateo de las páginas
 143 @translationof Page formatting
 144
 145 @funindex \paper
 146
 147 Los márgenes, encabezamientos y pies de página y otras variables de
 148 diseño de página se establecen automáticamente de acuerdo con el
 149 tamaño del papel.
 150
 151 El valor predeterminado de los márgenes está accesible en el archivo
 152 @file{ly/@/paper@/-defaults@/-init@/.ly}.  Estos valores se aplican al
 153 tamaño predeterminado del papel (A4, a no ser que se especifique de
 154 otra forma) y se escalan adecuadamente para otros tamaños del papel.
 155
 156 Esta sección relaciona y describe cierto número de variables del papel
 157 que se pueden alterar.
 158
 159 @menu
 160 * Dimensiones verticales fijas::
 161 * Dimensiones verticales flexibles::
 162 * Dimensiones horizontales::
 163 * Otras variables de diseño de página::
 164 @end menu
 165
 166
 167 @node Dimensiones verticales fijas
 168 @unnumberedsubsubsec Dimensiones verticales fijas
 169 @translationof Fixed vertical dimensions
 170
 171 @table @code
 172 @item paper-height
 173 @funindex paper-height
 174
 175 Altura de la página.  Valor predeterminado: altura del tamaño actual
 176 del papel.  Para ver más detalles, consulte @ref{Tamaño del papel}.
 177
 178 @item top-margin
 179 @funindex top-margin
 180
 181 Margen entre el extremo superior de la página y la parte superior del
 182 área imprimible.  Valor predeterminado: @code{5\mm}.
 183
 184 @item bottom-margin
 185 @funindex bottom-margin
 186
 187 Margen entre el extremo inferior del área imprimible y la parte
 188 inferior de la página.  Valor predeterminado: @code{6\mm}.
 189 @end table
 190
 191
 192 @node Dimensiones verticales flexibles
 193 @unnumberedsubsubsec Dimensiones verticales flexibles
 194 @translationof Flexible vertical dimensions
 195
 196 En casi todos los casos es preferible que las distancias verticales
 197 entre ciertos elementos (como márgenes, títulos, sistemas y las
 198 distintas partituras) sean flexibles, de manera que se amplíen y
 199 compriman adecuadamente dependiendo de la situación.  Están
 200 disponibles un cierto número de variables del bloque @code{\paper}
 201 (relacionadas más abajo) para realizar un ajuste fino del
 202 comportamiento de estas dimensiones frente a su ampliación o
 203 compresión.
 204
 205 Observe que las variables de @code{\paper} que se estudian en esta
 206 sección no controlan el espaciado de los pentagramas que están dentro
 207 de los sistemas individuales.  El espaciado dentro de los sistemas se
 208 controla por medio de propiedades de grob, con ajustes que se escriben
 209 normalmente dentro de un bloque @code{\score} o @code{layout},
 210 y no dentro del bloque @code{\paper}
 211 Véase @ref{Espaciado vertical flexible dentro de los sistemas}.
 212
 213
 214 @subsubheading Esctructura de las listas-A de espaciado para las variables de @code{\paper}
 215
 216 Cada una de estas variables es una lista-A (lista asociativa) que
 217 contiene cuatro @emph{claves}:
 218
 219 @itemize
 220 @item @code{padding} (relleno):
 221 mínimo espacio vertical vacío necesario entre dos elementos, medido en
 222 espacios de pentagrama.  Se puede pensar como la altura mínima de un
 223 rectángulo invisible que abarca desde el punto más a la izquierda
 224 hasta el situado más a la derecha de los elementos combinados.
 225
 226 @item @code{space} (espacio):
 227 distancia vertical predeterminada, medida en espacios de pentagrama,
 228 entre los @emph{puntos de referencia} de los dos elementos, cuando no
 229 resulte ninguna colisión, y no se produzca ninguna ampliación o
 230 compresión.  El punto de referencia de un elemento de marcado (de
 231 título o del nivel jerárquico superior) es su punto más alto, y el
 232 punto de referencia de un sistema es el centro vertical del
 233 @code{StaffSymbol} más cercano
 234 (incluso si se trata de una línea que no es un pentagrama, como
 235 un contexto @code{Lyrics}).
 236 Los valores de @code{space} menores de @code{padding} o
 237 de @code{minimum-distance} no son significativos, porque la distancia
 238 resultante nunca será menor de @code{padding} o de
 239 @code{minimum-distance}.
 240
 241 @item @code{minimum-distance} (distancia mínima):
 242 la distancia vertical mínima requerida, medida en espacios de
 243 pentagrama, entre los puntos de referencia de los dos elementos,
 244 cuando se produce una compresión.  Los valores de
 245 @code{minimum-distance} menores de @code{padding} no son
 246 significativos, porque la distancia resultante nunca será menor de
 247 @code{padding}.
 248
 249 @item @code{stretchability} (ampliabilidad):
 250 medida sin unidades de la propensión relativa de esta dimensión a
 251 ampliarse.  Si es cero, la distancia no se ampliará (a no ser que
 252 resultasen colisiones).  Si es positiva, la significación del valor de
 253 ampliabilidad de una dimensión concreta depende solamente de su
 254 relación con los valores de @code{stretchability} de las otras
 255 dimensiones.  Por ejemplo, si una dimensión tiene el doble de
 256 @code{stretchability} que otra, se ampliará con el doble de facilidad.
 257 Los valores deben ser no negativos y finitos.  El valor @code{+inf.0}
 258 desencadena un error de programación y se ignora, pero se puede usar
 259 @code{1.0e7} para un muelle casi infinitamente ampliable.  Si no se
 260 fija un valor, el valor predeterminado se establece a @code{space}.
 261 Observe que la propensión de la dimensión a @emph{comprimirse} no se
 262 puede establecer directamente por el usuario y es igual a
 263 (@code{space}@tie{}@minus{}@tie{}@code{minimum-distance}).
 264 @end itemize
 265
 266 Si una página tiene un margen inferior no justificado, la distancia
 267 resultante es la mayor de:
 268
 269 @itemize
 270 @item @code{space},
 271 @item @code{minimum-distance}, y
 272 @item @code{padding} más la menor distancia necesaria para eliminar las colisiones.
 273 @end itemize
 274
 275 Los métodos específicos para la modificación de las listas-A se
 276 estudian en @ref{Modificación de las listas-A}.  Las variables de
 277 dimensión de @code{\paper} verticales flexibles sólo se pueden fijar
 278 dentro de un bloque @code{\paper}.
 279
 280 El siguiente ejemplo muestra las
 281 dos formas en que pueden modificarse estas listas-A.  La primera
 282 declaración actualiza un par clave-valor individualmente,
 283 y la segunda redefine la variable completamente:
 284
 285 @example
 286 \paper @{
 287   system-system-spacing #'space = #8
 288
 289   score-system-spacing =
 290     #'((padding . 1)
 291        (space . 12)
 292        (minimum-distance . 6)
 293        (stretchability . 12))
 294 @}
 295 @end example
 296
 297 Los ajustes predeterminados de inicio para estas variables están
 298 definidos en el archivo @file{ly/paper-defaults-init.ly}.
 299
 300
 301 @subsubheading Variables de dimensión de @code{\paper} verticales flexibles
 302
 303 Los nombres de estas variables siguen el formato
 304 @code{@var{superior}-@var{inferior}-spacing}, donde
 305 @code{@var{superior}} e @code{@var{inferior}} son los elementos que
 306 van a ser espaciados.  Cada distancia se mide entre los puntos de
 307 referencia de los dos elementos
 308 (véase más arriba la descripción de la estructura de la lista-A).
 309 Observe que en estos nombres de variable, el término
 310 @q{@code{markup}} se refiere tanto a @emph{elementos de marcado de
 311 título} (@code{bookTitleMarkup} o @code{scoreTitleMarkup}) como a
 312 @emph{elementos de marcado del nivel superior} (véase @ref{Estructura
 313 del archivo}).
 314
 315 @table @code
 316 @item markup-system-spacing
 317 @funindex markup-system-spacing
 318
 319 distancia entre un elemento de marcado (de título o del nivel
 320 superior) y el sistema que le sigue.
 321
 322 @item score-markup-spacing
 323 @funindex score-markup-spacing
 324
 325 distancia entre el último sistema de una partitura y el elemento de
 326 marcado (de título o del nivel superior) que le sigue.
 327
 328 @item score-system-spacing
 329 @funindex score-system-spacing
 330
 331 distancia entre el último sistema de una partitura y el primer sistema
 332 de la partitura que le sigue, cuando no existe ningún elemento de
 333 marcado (de título o del nivel superior) entre ellos.
 334
 335 @item system-system-spacing
 336 @funindex system-system-spacing
 337
 338 distancia entre dos sistemas dentro de la misma partitura.
 339
 340 @item markup-markup-spacing
 341 @funindex markup-markup-spacing
 342
 343 distancia entre dos elementos de marcado (de título o del nivel
 344 superior).
 345
 346 @item last-bottom-spacing
 347 @funindex last-bottom-spacing
 348
 349 distancia desde el último sistema o elemento de marcado del nivel
 350 superior en una página, hasta la parte inferior de la zona imprimible
 351 (es decir, el extremo superior del margen inferior).
 352
 353 @item top-system-spacing
 354 @funindex top-system-spacing
 355
 356 distancia desde la parte superior de la zona imprimible (es decir, el
 357 extremo inferior del margen superior) hasta el primer sistema de una
 358 página, cuando no hay ningún elemento de marcado (de título o del
 359 nivel superior) entre los dos.
 360
 361 @item top-markup-spacing
 362 @funindex top-markup-spacing
 363
 364 distancia desde el extremo superior de la zona imprimible (es decir,
 365 el extremo inferior del margen superior) hasta el primer elemento de
 366 marcado (de título o del nivel superior) sobre una página, cuando no
 367 hay ningún sistema entre los dos.
 368 @end table
 369
 370
 371 @snippets
 372
 373 El encabezamiento y el pie se crean por parte de las funciones
 374 @code{make-footer} y @code{make-header}, definidas dentro de
 375 @code{\paper}.  Las implementaciones predeterminadas están en
 376 @file{ly/paper-defaults.ly} y en @file{ly/titling-init.ly}.
 377
 378 El diseño de la página en sí está realizado por dos funciones dentro
 379 del bloque @code{\paper}, @code{page-music-height} y
 380 @code{page-make-stencil}.  El primero informa al algoritmo de saltos
 381 de línea de la cantidad de espacio que está disponible en una página,
 382 y el último crea la propia página dado el sistema que poner sobre
 383 ella.
 384
 385 Se pueden definir valores del bloque @code{\paper} en Scheme.  En tal
 386 caso, @code{mm}, @code{in}, @code{pt}, y @code{cm} son variables que
 387 están definidas en @file{paper-defaults.ly} con valores en milímetros.
 388 Por ello el valor @w{@code{2 cm}} se debe multiplicar en el siguiente
 389 ejemplo:
 390
 391 @example
 392 \paper @{
 393  #(define bottom-margin (* 2 cm))
 394 @}
 395 @end example
 396
 397
 398 Ejemplo:
 399
 400 @example
 401 \paper @{
 402   paper-width = 2\cm
 403   top-margin = 3\cm
 404   bottom-margin = 3\cm
 405   ragged-last-bottom = ##t
 406 @}
 407 @end example
 408
 409 Este segundo ejemplo centra los números de página en la parte baja del
 410 papel.
 411
 412 @example
 413 \paper @{
 414   print-page-number = ##t
 415   print-first-page-number = ##t
 416   oddHeaderMarkup = \markup \fill-line @{ " " @}
 417   evenHeaderMarkup = \markup \fill-line @{ " " @}
 418   oddFooterMarkup = \markup @{ \fill-line @{
 419      \bold \fontsize #3 \on-the-fly #print-page-number-check-first
 420      \fromproperty #'page:page-number-string @} @}
 421   evenFooterMarkup = \markup @{ \fill-line @{
 422      \bold \fontsize #3 \on-the-fly #print-page-number-check-first
 423      \fromproperty #'page:page-number-string @} @}
 424 @}
 425 @end example
 426
 427 @seealso
 428 Referencia de la notación:
 429 @ref{Espaciado vertical flexible dentro de los sistemas}.
 430
 431 Fragmentos de código:
 432 @rlsr{Spacing}.
 433
 434
 435 @node Dimensiones horizontales
 436 @unnumberedsubsubsec Dimensiones horizontales
 437 @translationof Horizontal dimensions
 438
 439
 440 Existe un cierto número de variables que determinan las dimensiones
 441 horizontales de una página:
 442
 443 @table @code
 444
 445 @item binding-offset
 446 @funindex binding-offset
 447
 448 Se aumenta la cantidad @code{inner-margin} para asegurar que el
 449 encuadernado no va a tapar nada.  Sólo funciona con @code{two-sided}
 450 establecido al valor verdadero.  Valor predeterminado: @code{0}.
 451
 452 @item horizontal-shift
 453 @funindex horizontal-shift
 454
 455 Medida en que todos los sistemas (incluidos los títulos de cabecera y
 456 los separadores de sistemas) se desplazan a la derecha.
 457 Predeterminado: @code{0.0}.
 458
 459 @item indent
 460 @funindex indent
 461
 462 Nivel de sangrado para el primer sistema de una partitura.  Valor
 463 predeterminado: @code{15\mm}.
 464
 465 @item inner-margin
 466 @funindex inner-margin
 467
 468 Margen que tienen todas las páginas en el lado interior si son parte
 469 de un libro.  Sólo funciona con @code{two-sided} establecido al valor
 470 verdadero.  Valor predeterminado: @code{10\mm}.
 471
 472 @item left-margin
 473 @funindex left-margin
 474
 475 El margen entre el límite izquierdo del papel y el comienzo de los
 476 sistemas.  Predeterminado: @code{10\mm}.
 477
 478 @item line-width
 479 @funindex line-width
 480
 481 Ancho de los sistemas.  Predeterminado: @code{paper-width} menos
 482 @code{left-margin} y @code{right-margin}.
 483
 484 @item outer-margin
 485 @funindex outer-margin
 486
 487 Margen que todas las páginas tienen en la parte exterior si son parte
 488 de un libro.  Sólo funciona con @code{two-sided} establecido al valor
 489 verdadero.  Valor predeterminado: @code{20\mm}.
 490
 491 @item paper-width
 492 @funindex paper-width
 493
 494 Ancho de la página.  Predeterminado: la anchura del tamaño actual del
 495 papel.  Para ver más detalles, consulte @ref{Tamaño del papel}.
 496
 497 @item right-margin
 498 @funindex right-margin
 499
 500 Margen entre el borde derecho de la página y el final de cada sistema.
 501 Valor predeterminado: @code{10\mm}.
 502
 503 @item short-indent
 504 @funindex short-indent
 505
 506 Nivel de sangrado para todos los sistemas de una partitura excepto el
 507 primero.  Predeterminado: @code{0}.
 508
 509 @end table
 510
 511 Si hay valores sin ajustar, se toman los predeterminados.  Se ajusta
 512 su valor exacto, dependiendo del tamaño de papel especificado.  Por el
 513 momento, los siguientes valores se ven afectados por este escalado:
 514
 515 @itemize
 516 @item @var{left-margin}
 517 @item @var{right-margin}
 518 @item @var{top-margin}
 519 @item @var{bottom-margin}
 520 @item @var{head-separation}
 521 @item @var{foot-separation}
 522 @item @var{indent}
 523 @item @var{short-indent}
 524 @end itemize
 525
 526 Los ajustes para @code{line-width}, @code{left-margin},
 527 @code{right-margin} y @code{paper-width} dependen entre sí, pero no
 528 tienen que especificarse completamente.
 529
 530 @example
 531 \paper @{
 532   left-margin = 30\mm
 533 @}
 534 @end example
 535
 536 En este ejemplo, sólo se establece un valor para @code{left-margin}.
 537 El valor de @code{right-margin} sigue siendo el predeterminado,
 538 @code{line-width} se calcula automáticamente.
 539
 540 @example
 541 \paper @{
 542   line-width = 150\mm
 543 @}
 544 @end example
 545
 546 Aquí @code{left-margin} y @code{right-margin} se ajustan al mismo
 547 valor.  Por tanto, @code{line-width} se sustrae de @code{paper-width}
 548 y se divide entre dos.  Esto significa que los sistemas se imprimen
 549 centrados en la página, si sólo se especifica @code{line-width}.
 550
 551 Tienen lugar algunas comprobaciones para asegurar que los valores se
 552 establecen correctamente.  Si los valores no encajasen o los sistemas
 553 se fueran a salir de la página, se imprime una advertencia y se
 554 establecen los valores predeterminados.
 555
 556 @example
 557 \paper @{
 558   paper-width = 210\mm
 559   left-margin = 20\mm
 560   right-margin = 30\mm
 561   line-width = 100\mm
 562 @}
 563 @end example
 564
 565 Estas comprobaciones se pueden evitar estableciendo
 566 @code{check-consistency} al valor falso.
 567
 568 @example
 569 \paper @{
 570   paper-width = 210\mm
 571   left-margin = 20\mm
 572   line-width = 200\mm
 573   check-consistency = ##f
 574 @}
 575 @end example
 576
 577 @warning{Si @code{paper-width} se ajusta manualmente,
 578 @code{line-width}, @code{left-margin}, @code{indent} y
 579 @code{short-indent} podrían tener que ajustarse también.}
 580
 581 @seealso
 582 Fragmentos de código:
 583 @rlsr{Spacing}.
 584
 585
 586
 587 @node Otras variables de diseño de página
 588 @unnumberedsubsubsec Otras variables de diseño de página
 589 @translationof Other layout variables
 590
 591 Estas variables se pueden usar para ajustar el diseño de la página en
 592 general.
 593
 594 @table @code
 595
 596 @item auto-first-page-number
 597 @funindex auto-first-page-number
 598
 599 El algoritmo de división de páginas está afectado por el hecho de que
 600 el número de la primera página sea par o impar.  Si está establecido
 601 al valor verdadero, el algoritmo de división de páginas decide si
 602 comenzar con un número par o impar.  Esto hace que el número de la
 603 primera página se quede como está, o que se aumente en una unidad.
 604 Predeterminado: @code{##f}.
 605
 606 @ignore
 607
 608 FIXME: this variable is used, but I don't know what it does. -pm
 609 @item blank-after-score-page-force
 610 @funindex blank-after-score-page-force
 611
 612 Default: @code{2}.
 613
 614 @end ignore
 615
 616 @item blank-last-page-force
 617 @funindex blank-last-page-force
 618
 619 Penalización por terminar la partitura en una página de numeración
 620 impar.  Predeterminado: @code{0}.
 621
 622 @item blank-page-force
 623 @funindex blank-page-force
 624
 625 Penalización por tener una página en blanco en medio de una partitura.
 626 Esto no se usa por parte de @code{ly:optimal-breaking} porque éste
 627 nunca considera la posibilidad de tener páginas en blanco en mitad de
 628 una partitura.  Predeterminado: @code{5}.
 629
 630 @item check-consistency
 631 @funindex check-consistency
 632
 633 Si es verdadero, comprobar si @code{left-margin}, @code{right-margin}
 634 y @code{line-width} encajan entre sí.  También asegurar que su
 635 combinación no excede del @code{paper-width} disponible.  Valor
 636 predeterminado: @code{##t}.
 637
 638 @item first-page-number
 639 @funindex first-page-number
 640
 641 Valor del número de la primera página.  Predeterminado: @code{#1}.
 642
 643 @item max-systems-per-page
 644 @funindex max-systems-per-page
 645
 646 Máximo número de sistemas que tendrán cabida en una página.  Está
 647 contemplado por el momento solamente por parte del algoritmo
 648 @code{ly:optimal-breaking}.  Predeterminado: no establecido.
 649
 650 @item min-systems-per-page
 651 @funindex min-systems-per-page
 652
 653 Mínimo número de sistemas que habrá en una página.  Puede hacer que
 654 las páginas se llenen en exceso si se establece a un valor grande.
 655 Por el momento solamente está contemplado por parte del algoritmo
 656 @code{ly:optimal-breaking}.  Predeterminado: no establecido.
 657
 658 @item page-breaking-system-system-spacing
 659 @funindex page-breaking-system-system-spacing
 660
 661 Engaña al divisor de páginas para que crea que
 662 @code{system-system-spacing} está establecido a algo distinto de lo
 663 que está realmente.  Por ejemplo, si
 664 @code{page-breaking-system-system-spacing #'padding} se establece a algo
 665 mucho mayor que @code{system-system-spacing #'padding}, entonces
 666 el divisor de páginas colocará menos sistemas en cada página.
 667 Predeterminado: no establecido.
 668
 669 @item page-count
 670 @funindex page-count
 671
 672 Número de páginas que usar para una partitura. Predeterminado: sin
 673 fijar.
 674
 675 @item page-spacing-weight
 676 @funindex page-spacing-weight
 677
 678 Importancia relativa del espacio (vertical) de las páginas y el
 679 espaciado (horizontal) de las líneas.  Los valores altos hacen que el
 680 espaciado de la página tenga más importancia.  Predeterminado:
 681 @code{#10}.
 682
 683 @item print-all-headers
 684 @funindex print-all-headers
 685
 686 Si está establecido a un valor verdadero, imprime todas las cabeceras
 687 para cada una de las @code{\score} en la salida impresa.  Normalmente
 688 sólo se imprimen las variables de encabezamiento de pieza y opus.
 689 Predeterminado: @code{##f}.
 690
 691 @item print-first-page-number
 692 @funindex print-first-page-number
 693
 694 Si está establecido a un valor verdadero, se imprime un número de
 695 página en la primera página.  Predeterminado: @code{##f}.
 696
 697 @item print-page-number
 698 @funindex print-page-number
 699
 700 Si está establecido a un valor falso, no se imprimen los números de
 701 página.  Predeterminado: @code{##t}.
 702
 703 @item ragged-bottom
 704 @funindex ragged-bottom
 705
 706 Si está establecido a un valor verdadero, los sistemas no ocuparán
 707 verticalmente toda la altura de la página.  Esto no afecta a la última
 708 página.  Predeterminado: @code{##f}.
 709
 710 Esto se debería establecer al valor verdadero para piezas que tienen
 711 sólo dos o tres sistemas por página, por ejemplo partituras
 712 orquestales.
 713
 714 @item ragged-last
 715 @funindex ragged-last
 716
 717 Si está establecido a un valor verdadero, el último sistema de la
 718 partitura no llenará la anchura de la línea.  En su lugar, el último
 719 sistema termina en su longitud horizontal natural.  Predeterminado:
 720 @code{##f}.
 721
 722 @item ragged-last-bottom
 723 @funindex ragged-last-bottom
 724
 725 Si está establecido a un valor falso, los sistemas se repartirán
 726 verticalmente por toda la última página.  Predeterminado: @code{##t}.
 727
 728 Las piezas que llenan generosamente dos o más páginas deberían tener
 729 esto establecido al valor verdadero.
 730
 731 También afecta a la última página de las partes de libro, es decir,
 732 partes de un libro que se han creado con bloques @code{\bookpart}.
 733
 734 @item ragged-right
 735 @funindex ragged-right
 736
 737 Si está establecido a un valor verdadero, los sistemas no llenarán el
 738 ancho de línea disponible.  En su lugar, los sistemas terminan en su
 739 longitud horizontal natural.  Predeterminado: @code{##f}.
 740
 741 Si la partitura sólo tiene un sistema, el valor predeterminado es
 742 @code{##t}.
 743
 744 @item system-separator-markup
 745 @funindex system-separator-markup
 746
 747 Objeto de marcado que se inserta entre los sistemas.  Se suele usar
 748 para partituras orquestales.  Predeterminado: sin establecer.
 749
 750 Se ofrece la instrucción de marcado @code{\slashSeparator} como un
 751 valor predeterminado apropiado, por ejemplo
 752
 753 @lilypond[quote,ragged-right]
 754 #(set-default-paper-size "a6" 'landscape)
 755 \book {
 756   \score {
 757     \relative c' { c1 \break c1 }
 758   }
 759   \paper {
 760     system-separator-markup = \slashSeparator
 761   }
 762 }
 763 @end lilypond
 764
 765 @item system-count
 766 @funindex system-count
 767
 768 Cantidad de sistemas que usar por parte de la partitura.
 769 Predeterminado: sin establecer.
 770
 771 @item systems-per-page
 772 @funindex systems-per-page
 773
 774 Número de sistemas que se deben colocar en cada página.  Está
 775 contemplado solamente por parte del algoritmo
 776 @code{ly:optimal-breaking} por el momento.  Predeterminado: no
 777 establecido.
 778
 779 @item two-sided
 780 @funindex two-sided
 781
 782 @cindex encuadernación
 783 @cindex margen de encuadernación
 784
 785 Si es verdadero, usar @code{inner-margin}, @code{outer-margin} y
 786 @code{binding-offset} para determinad los márgenes dependiendo de si
 787 el número de página es par o impar.  Esto sobreescribe a
 788 @code{left-margin} y a @code{right-margin}.  Valor predeterminado:
 789 @code{##f}.
 790
 791 @end table
 792
 793
 794 @seealso
 795 Fragmentos de código:
 796 @rlsr{Spacing}.
 797
 798
 799 @knownissues
 800
 801 El encabezamiento de página predeterminado pone el número de página y
 802 el campo @code{instrument} del bloque @code{\header} sobre la misma
 803 línea.
 804
 805 Los títulos de cabecera (tomados de la sección @code{\header@{@}}) se
 806 tratan como un sistema, por lo que @code{ragged-bottom} y
 807 @code{ragged-last-bottom} añaden espacio entre los títulos y el primer
 808 sistema de la partitura.
 809
 810
 811 @node Disposición de la música
 812 @section Disposición de la música
 813 @translationof Music layout
 814
 815 @menu
 816 * Establecer el tamaño del pentagrama::
 817 * Disposición de la partitura::
 818 @end menu
 819
 820
 821 @node Establecer el tamaño del pentagrama
 822 @subsection Establecer el tamaño del pentagrama
 823 @translationof Setting the staff size
 824
 825 @cindex tipografía, establecer tamaño de
 826 @cindex pentagrama, establecer tamaño de
 827 @funindex layout file
 828
 829 El @strong{tamaño de pentagrama} predeterminado se establece en 20
 830 puntos.  Esto se puede modificar de dos maneras:
 831
 832 Para establecer globalmente el tamaño del pentagrama para todas las
 833 partituras de un archivo (o en un bloque @code{book}, para ser
 834 exactos), utilice @code{set-global-staff-size}.
 835
 836 @example
 837 #(set-global-staff-size 14)
 838 @end example
 839
 840 @noindent
 841 Esto establece el tamaño global predeterminado a una altura de
 842 pentagrama de 14pt y escala todas las tipografías según corresponda.
 843
 844 Para establecer el tamaño del pentagrama de forma individual para cada
 845 partitura, use
 846 @example
 847 \score@{
 848   ...
 849   \layout@{
 850   #(layout-set-staff-size 15)
 851   @}
 852 @}
 853 @end example
 854
 855 La fuente tipográfica Feta ofrece símbolos musicales a ocho tamaños
 856 distintos.  Cada fuente tipográfica está afinada para un tamaño de
 857 pentagrama distinto: a un tamaño menor la tipografía se vuelve más
 858 pesada, para que coincida con las líneas de pentagrama relativamente
 859 más gruesas.  Los tamaños de tipografía recomendados están
 860 relacionados en la tabla siguiente:
 861
 862 @quotation
 863 @multitable @columnfractions .15 .2 .22 .2
 864
 865 @item @b{nombre de la fuente}
 866 @tab @b{altura del pentagrama (pt)}
 867 @tab @b{altura del pentagrama (mm)}
 868 @tab @b{usos}
 869
 870 @item feta11
 871 @tab 11.22
 872 @tab 3.9
 873 @tab partituras de bolsillo
 874
 875 @item feta13
 876 @tab 12.60
 877 @tab 4.4
 878 @tab
 879
 880 @item feta14
 881 @tab 14.14
 882 @tab 5.0
 883 @tab
 884
 885 @item feta16
 886 @tab 15.87
 887 @tab 5.6
 888 @tab
 889
 890 @item feta18
 891 @tab 17.82
 892 @tab 6.3
 893 @tab cancioneros
 894
 895 @item feta20
 896 @tab 20
 897 @tab 7.0
 898 @tab particellas estándar
 899
 900 @item feta23
 901 @tab 22.45
 902 @tab 7.9
 903 @tab
 904
 905 @item feta26
 906 @tab 25.2
 907 @tab 8.9
 908 @tab
 909 @c modern rental material?
 910
 911 @end multitable
 912 @end quotation
 913
 914 Estas tipografías están disponibles en cualquier tamaño.  La propiedad
 915 de contexto @code{fontSize} y la propiedad de disposición
 916 @code{staff-space} (en @rinternals{StaffSymbol}) se pueden usar para
 917 afinar el tamaño de los pentagramas individuales.  Los tamaños de
 918 pentagrama individuales están en relación al tamaño global.
 919
 920
 921 @seealso
 922 Referencia de la notación:
 923 @ref{Seleccionar el tamaño de la tipografía para la notación}.
 924
 925 Fragmentos de código:
 926 @rlsr{Spacing}.
 927
 928
 929 @knownissues
 930
 931 @code{layout-set-staff-size} no cambia la distancia entre las líneas
 932 del pentagrama.
 933
 934
 935 @node Disposición de la partitura
 936 @subsection Disposición de la partitura
 937 @translationof Score layout
 938
 939 @funindex \layout
 940
 941 Mientras que @code{\paper} contiene ajustes relativos al formato de
 942 página del documento completo, @code{\layout} contiene ajustes para la
 943 disposición específica de cada partitura.
 944
 945 @example
 946 \layout @{
 947   indent = 2.0\cm
 948   \context @{ \Staff
 949     \override VerticalAxisGroup #'minimum-Y-extent = #'(-6 . 6)
 950   @}
 951   \context @{ \Voice
 952     \override TextScript #'padding = #1.0
 953     \override Glissando #'thickness = #3
 954   @}
 955 @}
 956 @end example
 957
 958
 959 @seealso
 960 Referencia de la notación:
 961 @ref{Cambiar los valores por omisión de los contextos}.
 962
 963 Fragmentos de código:
 964 @rlsr{Spacing}.
 965
 966
 967 @node Saltos
 968 @section Saltos
 969 @translationof Breaks
 970
 971 @menu
 972 * Saltos de línea::
 973 * Saltos de página::
 974 * Saltos de página óptimos::
 975 * Paso de página óptimo::
 976 * Saltos de página mínimos::
 977 * Saltos de línea explícitos::
 978 * Utilizar una voz adicional para los saltos de línea::
 979 @end menu
 980
 981
 982 @node Saltos de línea
 983 @subsection Saltos de línea
 984 @translationof Line breaking
 985
 986 @cindex saltos de línea
 987 @cindex línea, saltos de
 988
 989 Normalmente los saltos de línea se determinan automáticamente. Se
 990 eligen de forma que las líneas no aparezcan demasiado apretadas ni
 991 demasiado sueltas, y que las líneas consecutivas tengan una densidad
 992 similar.  Ocasionalmente podemos querer sobreescribir los saltos
 993 automáticos; podemos hacerlo especificando @code{\break}. Esto fuerza
 994 un salto de línea en ese punto.  Sin embargo, los saltos de línea sólo
 995 pueden suceder al final de los compases @q{completos}, es decir, donde
 996 no queda ninguna nota o grupo especial @q{colgando} por encima de la
 997 línea divisoria.  Si queremos poner un salto de línea donde no hay
 998 línea divisoria, podemos forzar una barra de compás invisible
 999 introduciendo @code{\bar ""}, aunque de nuevo no deben quedar notas
1000 colgando en ninguno de los pentagramas en este punto, o se ignorarán.
1001
1002 La instrucción opuesta, @code{\noBreak}, prohíbe un salto de línea en
1003 la barra divisoria en que se inserta.
1004
1005 Los ajustes más básicos que influyen sobre el espaciado de las líneas
1006 son @code{indent} y @code{line-width}. Se establecen dentro del bloque
1007 @code{\layout}.  Controlan el sangrado de la primera línea de música,
1008 y la longitud de las líneas.
1009
1010 Si se establece @code{ragged-right} a verdadero en el bloque
1011 @code{\layout}, los sistemas terminan en su longitud horizontal
1012 natural, en lugar de distribuirse horizontalmente para llenar toda la
1013 línea. Esto es de utilidad para fragmentos cortos, y para efectuar una
1014 comprobación de lo apretado que es el espaciado natural.
1015
1016 @c TODO Check and add para on default for ragged-right
1017
1018 La opción @code{ragged-last} es similar a @code{ragged-right}, pero
1019 afecta sólo a la última línea de la pieza.
1020
1021 @example
1022 \layout @{
1023 indent = #0
1024 line-width = #150
1025 ragged-last = ##t
1026 @}
1027 @end example
1028
1029
1030
1031 @cindex saltos de línea normales
1032 @cindex música de cuatro compases por línea
1033
1034 Para saltos de línea a intervalos regulares utilice @code{\break}
1035 separado mediante desplazamientos con @code{\skip} y repetidos con
1036 @code{\repeat}.  Por ejemplo, esto haría que los 28 compases
1037 siguientes (suponiendo un compás de 4/4) se dividan cada cuatro
1038 compases, y sólo en dichos lugares:
1039
1040 @example
1041 << \repeat unfold 7 @{
1042          s1 \noBreak s1 \noBreak
1043          s1 \noBreak s1 \break @}
1044    @emph{the real music}
1045 >>
1046 @end example
1047
1048 @c TODO Check this
1049 Una configuración de división de líneas se puede guardar como archivo
1050 @code{.ly} automáticamente.  Ello permite que alineaciones verticales
1051 se estiren para que encajen en las páginas durante una segunda
1052 ejecución del proceso de formateo.  Esta posibilidad es bastante
1053 novedosa y difícil.  Hay más detalles disponibles en @rlsr{Spacing}.
1054
1055
1056 @predefined
1057 @funindex \break
1058 @code{\break},
1059 @funindex \noBreak
1060 @code{\noBreak}.
1061 @endpredefined
1062
1063
1064 @seealso
1065 Referencia de funcionamiento interno:
1066 @rinternals{LineBreakEvent}.
1067
1068 Fragmentos de código:
1069 @rlsr{Spacing}.
1070
1071
1072 @knownissues
1073
1074 Sólo pueden ocurrir saltos de línea si hay una @q{buena} línea
1075 divisoria.  Una nota colgando de una línea divisoria no es adecuada,
1076 como
1077
1078 @lilypond[quote,ragged-right,relative=2,verbatim]
1079 c4 c2 << c2 {s4 \break } >>  % this does nothing
1080 c2 c4 |           % a break here would work
1081 c4 c2 c4 ~ \break % as does this break
1082 c4 c2 c4
1083 @end lilypond
1084
1085 Esto se puede evitar eliminando el grabador
1086 @code{Forbid_line_break_engraver}.  Observe que los saltos de línea
1087 forzados manualmente se tienen que añadir en paralelo con la música.
1088
1089 @lilypond[quote,ragged-right,verbatim]
1090 \new Voice \with {
1091   \remove Forbid_line_break_engraver
1092 } {
1093   c4 c2 << c2 {s4 \break } >>  % now the break is allowed
1094   c2 c4
1095 }
1096 @end lilypond
1097
1098 De forma parecida, los saltos de línea están prohibidos normalmente
1099 cuando las barras cruzan a las líneas divisorias.  Este comportamiento
1100 se puede modificar con el establecimiento de @code{\override Beam
1101 #'breakable = ##t}.
1102
1103
1104 @node Saltos de página
1105 @subsection Saltos de página
1106 @translationof Page breaking
1107
1108 Se puede sobreescribir el mecanismo predeterminado de salto de página
1109 insertando instrucciones @code{\pageBreak} o @code{\noPageBreak}.
1110 Estas instrucciones son análogas a @code{\break} y @code{\noBreak}.
1111 Se deben insertar en una línea divisoria.  Estas instrucciones fuerzan
1112 y prohíben, respectivamente, la eventualidad de un salto de página.
1113 Por supuesto, la instrucción @code{\pageBreak} también fuerza un salto
1114 de línea.
1115
1116 Las instrucciones @code{\pageBreak} y @code{\noPageBreak} también se
1117 pueden insertar en el nivel más alto, entre las partituras y los
1118 elementos de marcado situados en el nivel superior.
1119
1120 Hay ajustes análogos a @code{ragged-right} y @code{ragged-last} que
1121 tienen el mismo efecto sobre el espaciado vertical:
1122 @code{ragged-bottom} y @code{ragged-last-bottom}.  Si están
1123 establecidos a @code{##t} los sistemas de todas las páginas o sólo de
1124 la última página, respectivamente, no se verán justificados
1125 verticalmente.
1126
1127 Para ver más detalles, consulte @ref{Espaciado vertical}.
1128
1129 Los saltos de página se calculan por medio de la función
1130 @code{page-breaking}.  LilyPond ofrece tres algoritmos para el cómputo
1131 de los saltos de página: @code{ly:optimal-breaking},
1132 @code{ly:page-turn-breaking} y @code{ly:minimal-breaking}.  El
1133 predeterminado es @code{ly:optimal-breaking}, pero el valor se puede
1134 cambiar en el bloque @code{\paper}:
1135
1136 @example
1137 \paper@{
1138   #(define page-breaking ly:page-turn-breaking)
1139 @}
1140 @end example
1141
1142 @funindex \bookpart
1143
1144 Cuando un libro tiene muchas partituras y páginas, puede ser difícil
1145 resolver el problema de los saltos de página, necesitando mucha
1146 memoria y prolongados tiempos de procesamiento.  Para facilitar el
1147 proceso de división en páginas, se usan los bloques @code{\bookpart}
1148 para dividir el libro en varias partes: los saltos de página se
1149 producen de manera independiente en cada parte.  También se pueden
1150 usar diferentes funciones de división en páginas para las distintas
1151 partes del libro.
1152
1153 @example
1154 \bookpart @{
1155   \header @{
1156     subtitle = "Prefacio"
1157   @}
1158   \paper @{
1159      %% En una parte que consiste en texto principalmente,
1160      %% puede ser preferible ly:minimal-breaking
1161      #(define page-breaking ly:minimal-breaking)
1162   @}
1163   \markup @{ @dots{} @}
1164   @dots{}
1165 @}
1166 \bookpart @{
1167   %% En esta parte, consistente en música, se usa la función
1168   %% óptima predeterminada de saltos de página.
1169   \header @{
1170     subtitle = "Primer movimiento"
1171   @}
1172   \score @{ @dots{} @}
1173   @dots{}
1174 @}
1175 @end example
1176
1177
1178 @predefined
1179 @funindex \pageBreak
1180 @code{\pageBreak},
1181 @funindex \noPageBreak
1182 @code{\noPageBreak}.
1183 @endpredefined
1184
1185
1186 @seealso
1187 Fragmentos de código:
1188 @rlsr{Spacing}.
1189
1190
1191 @node Saltos de página óptimos
1192 @subsection Saltos de página óptimos
1193 @translationof Optimal page breaking
1194
1195 @funindex ly:optimal-breaking
1196
1197 La función @code{ly:optimal-breaking} es el método predeterminado de
1198 LilyPond para determinar los saltos de página.  Intenta hallar una
1199 división de páginas que haga mínimos el apretujamiento y la
1200 distensión, tanto horizontal como verticalmente.  A diferencia de
1201 @code{ly:page-turn-breaking}, no tiene un concepto de los pasos de
1202 página.
1203
1204
1205 @seealso
1206 Fragmentos de código:
1207 @rlsr{Spacing}.
1208
1209
1210 @node Paso de página óptimo
1211 @subsection Paso de página óptimo
1212 @translationof Optimal page turning
1213
1214 @funindex ly:page-turn-breaking
1215
1216 Con frecuencia es necesario encontrar una configuración de división de
1217 páginas de manera que haya un silencio al final de una página de cada
1218 dos.  De esta forma, el músico puede pasar la página sin perder notas.
1219 La función @code{ly:page-turn-breaking} trata de encontrar una
1220 división de páginas que haga mínimos el apretujamiento y el
1221 estiramiento, pero con la restricción añadida de que sólo se permite
1222 introducir vueltas de página en los lugares especificados.
1223
1224 Hay dos etapas en el uso de esta función de división de páginas.  En
1225 primer lugar debemos habilitarlo en el bloque @code{\paper}, como se
1226 explicó en @ref{Saltos de página}.  Entonces debemos decirle a la función
1227 dónde nos gustaría permitir los saltos de página.
1228
1229 Hay dos formas de conseguir la segunda tarea.  Primero, podemos
1230 especificar manualmente cada uno de los pasos de página potenciales,
1231 insertando @code{\allowPageTurn} en nuestro archivo de entrada en los
1232 lugares adecuados.
1233
1234 Si esto es demasiado tedioso, podemos añadir un grabador
1235 @code{Page_turn_engraver} a un contexto Staff o Voice.  El grabador
1236 @code{Page_turn_engraver} analizará el contexto en busca de secciones
1237 sin notas (observe que no busca silencios, sino la ausencia de notas.
1238 Se hace así para que la polifonía en un solo pentagrama con silencios
1239 en una de las voces no arruine la labor del grabador
1240 @code{Page_turn_engraver}).  Cuando encuentra una sección sin notas
1241 suficientemente larga, el grabador @code{Page_turn_engraver} inserta
1242 un @code{\allowPageTurn} en la última barra de compás de dicha
1243 sección, a no ser que haya una barra @q{especial} de compás (como una
1244 doble barra), en cuyo caso se insertará el @code{\allowPageTurn} en la
1245 última barra @q{especial} de compás de la sección.
1246
1247 @funindex minimumPageTurnLength
1248 El grabador @code{Page_turn_engraver} lee la propiedad de contexto
1249 @code{minimumPageTurnLength} para determinar qué longitud debe tener
1250 una sección sin notas antes de que se considere la posibilidad de un
1251 paso de página.  El valor predeterminado para
1252 @code{minimumPageTurnLength} es @code{#(ly:make-moment 1 1)}.  Si
1253 quiere inhabilitar las vueltas de página, puede establecerlo a algún
1254 valor muy grande.
1255
1256 @example
1257 \new Staff \with @{ \consists "Page_turn_engraver" @}
1258 @{
1259   a4 b c d |
1260   R1 | % a page turn will be allowed here
1261   a4 b c d |
1262   \set Staff.minimumPageTurnLength = #(ly:make-moment 5 2)
1263   R1 | % a page turn will not be allowed here
1264   a4 b r2 |
1265   R1*2 | % a page turn will be allowed here
1266   a1
1267 @}
1268 @end example
1269
1270 @funindex minimumRepeatLengthForPageTurn
1271 El grabador @code{Page_turn_engraver} detecta las repeticiones de
1272 primera y segunda vez.  Sólo permite un pase de página durante la
1273 repetición si hay suficiente tiempo al principio y al final de la
1274 repetición para volver a pasar la página hacia atrás. El grabador
1275 @code{Page_turn_engraver} también puede inhabilitar los pasos de
1276 página si la repetición es muy corta.  Si establecemos la propiedad de
1277 contexto @code{minimumRepeatLengthForPageTurn} entonces el grabador
1278 @code{Page_turn_engraver} sólo permitirá los pases de página en las
1279 repeticiones cuya duración sea mayor que este valor.
1280
1281 Las instrucciones de paso de página, @code{\pageTurn},
1282 @code{\noPageTurn} y @code{\allowPageTurn}, se pueden usar también en
1283 el nivel más elevado del código, entre las partituras y los elementos
1284 de marcado del nivel superior.
1285
1286
1287 @predefined
1288 @funindex \pageTurn
1289 @code{\pageTurn},
1290 @funindex \noPageTurn
1291 @code{\noPageTurn},
1292 @funindex \allowPageTurn
1293 @code{\allowPageTurn}.
1294 @endpredefined
1295
1296
1297 @seealso
1298 Fragmentos de código:
1299 @rlsr{Spacing}.
1300
1301
1302 @knownissues
1303
1304 Sólo debería haber un grabador @code{Page_turn_engraver} dentro de una
1305 partitura.  Si hay más de uno, se interferirán entre sí.
1306
1307
1308 @node Saltos de página mínimos
1309 @subsection Saltos de página mínimos
1310 @translationof Minimal page breaking
1311
1312 @funindex ly:minimal-breaking
1313
1314 La función @code{ly:minimal-breaking} efectúa unos cálculos mínimos
1315 para determinar los saltos de página: completa una página con tantos
1316 sistemas como sea posible antes de continuar con la siguiente.  Así,
1317 puede preferirse para partituras con muchas páginas, donde las otras
1318 funciones de salto de página pueden resultar demasiado lentas o ávidas
1319 de memoria, o con una gran cantidad de textos.  Se habilita utilizando:
1320
1321 @example
1322 \paper @{
1323   #(define page-breaking ly:minimal-breaking)
1324 @}
1325 @end example
1326
1327
1328 @seealso
1329 Fragmentos de código:
1330 @rlsr{Spacing}.
1331
1332
1333 @node Saltos de línea explícitos
1334 @subsection Saltos de línea explícitos
1335 @translationof Explicit breaks
1336
1337 Lily a veces rechaza las instrucciones @code{\break} y
1338 @code{\pageBreak} explícitas.  Hay dos instrucciones para
1339 sobreescribir este comportamiento:
1340
1341 @example
1342 \override NonMusicalPaperColumn #'line-break-permission = ##f
1343 \override NonMusicalPaperColumn #'page-break-permission = ##f
1344 @end example
1345
1346 Cuando se sobreescribe el valor de @code{line-break-permission} a
1347 falso, Lily inserta saltos de línea en las instrucciones @code{\break}
1348 explícitas y en ningún otro lugar. Cuando se sobreescribe el valor de
1349 @code{page-break-permission} a falso, Lily inserta saltos de página en
1350 las instrucciones @code{\pageBreak} explícitas y en ningún otro lugar.
1351
1352 @lilypond[quote,verbatim]
1353 \paper {
1354   indent = #0
1355   ragged-right = ##t
1356   ragged-bottom = ##t
1357 }
1358
1359 \score {
1360   \new Staff {
1361     \repeat unfold 2 { c'8 c'8 c'8 c'8 } \break
1362     \repeat unfold 4 { c'8 c'8 c'8 c'8 } \break
1363     \repeat unfold 6 { c'8 c'8 c'8 c'8 } \break
1364     \repeat unfold 8 { c'8 c'8 c'8 c'8 } \pageBreak
1365     \repeat unfold 8 { c'8 c'8 c'8 c'8 } \break
1366     \repeat unfold 6 { c'8 c'8 c'8 c'8 } \break
1367     \repeat unfold 4 { c'8 c'8 c'8 c'8 } \break
1368     \repeat unfold 2 { c'8 c'8 c'8 c'8 }
1369     }
1370   \layout {
1371     \context {
1372       \Score
1373       \override NonMusicalPaperColumn #'line-break-permission = ##f
1374       \override NonMusicalPaperColumn #'page-break-permission = ##f
1375     }
1376   }
1377 }
1378 @end lilypond
1379
1380
1381 @seealso
1382 Fragmentos de código:
1383 @rlsr{Spacing}.
1384
1385
1386 @node Utilizar una voz adicional para los saltos de línea
1387 @subsection Utilizar una voz adicional para los saltos de línea
1388 @translationof Using an extra voice for breaks
1389
1390 La información sobre saltos de línea y de página suele aparecer
1391 directamente entremezclado dentro del código de notas.
1392
1393 @example
1394 \score @{
1395   \new Staff @{
1396     \repeat unfold 2 @{ c'4 c'4 c'4 c'4 @}
1397     \break
1398     \repeat unfold 3 @{ c'4 c'4 c'4 c'4 @}
1399   @}
1400 @}
1401 @end example
1402
1403 Esto hace sencillas de introducir a las instrucciones @code{\break} y
1404 @code{\pageBreak}, pero mezcla la escritura de música con información
1405 que especifica cómo se debe disponer la música sobre la página.
1406 Podemos mantener la introducción de música y la información de saltos
1407 de línea y de página en dos lugares separados mediante la introducción
1408 de una voz adicional que contenga los saltos.  Esta voz adicional
1409 contiene solamente desplazamientos o @q{skips} junto con los
1410 @code{\break}, @code{pageBreak} y otras informaciones sobre la
1411 disposición de los saltos.
1412
1413 @lilypond[quote,verbatim]
1414 \score {
1415   \new Staff <<
1416     \new Voice {
1417       s1 * 2 \break
1418       s1 * 3 \break
1419       s1 * 6 \break
1420       s1 * 5 \break
1421     }
1422     \new Voice {
1423       \repeat unfold 2 { c'4 c'4 c'4 c'4 }
1424       \repeat unfold 3 { c'4 c'4 c'4 c'4 }
1425       \repeat unfold 6 { c'4 c'4 c'4 c'4 }
1426       \repeat unfold 5 { c'4 c'4 c'4 c'4 }
1427     }
1428   >>
1429 }
1430 @end lilypond
1431
1432 Este patrón resulta especialmente útil cuando se sobreescribe
1433 @code{line-break-system-details} y las otras útiles (pero largas)
1434 propiedades de @code{NonMusicalPaperColumnGrob}, como se explica en
1435 @ref{Espaciado vertical}.
1436
1437 @lilypond[quote,verbatim]
1438 \score {
1439   \new Staff <<
1440     \new Voice {
1441       \overrideProperty "Score.NonMusicalPaperColumn"
1442         #'line-break-system-details #'((Y-offset . 0))
1443       s1 * 2 \break
1444
1445       \overrideProperty "Score.NonMusicalPaperColumn"
1446         #'line-break-system-details #'((Y-offset . 35))
1447       s1 * 3 \break
1448
1449       \overrideProperty "Score.NonMusicalPaperColumn"
1450         #'line-break-system-details #'((Y-offset . 70))
1451       s1 * 6 \break
1452
1453       \overrideProperty "Score.NonMusicalPaperColumn"
1454         #'line-break-system-details #'((Y-offset . 105))
1455       s1 * 5 \break
1456     }
1457     \new Voice {
1458       \repeat unfold 2 { c'4 c'4 c'4 c'4 }
1459       \repeat unfold 3 { c'4 c'4 c'4 c'4 }
1460       \repeat unfold 6 { c'4 c'4 c'4 c'4 }
1461       \repeat unfold 5 { c'4 c'4 c'4 c'4 }
1462     }
1463   >>
1464 }
1465 @end lilypond
1466
1467
1468 @seealso
1469 Referencia de la notación:
1470 @ref{Espaciado vertical}.
1471
1472 Fragmentos de código:
1473 @rlsr{Spacing}.
1474
1475
1476 @node Espaciado vertical
1477 @section Espaciado vertical
1478 @translationof Vertical spacing
1479
1480 @cindex espaciado vertical
1481 @cindex vertical, espaciado
1482
1483 El espaciado vertical está controlado por tres factores: la cantidad
1484 de espacio disponible (es decir, el tamaño del papel y los márgenes),
1485 la separación entre los sistemas, y la separación entre los
1486 pentagramas dentro de un sistema.
1487
1488 @menu
1489 * Espaciado vertical flexible dentro de los sistemas::
1490 * Posicionamiento explícito de los pentagramas y los sistemas::
1491 * Evitar las colisiones verticales::
1492 @end menu
1493
1494
1495 @node Espaciado vertical flexible dentro de los sistemas
1496 @subsection Espaciado vertical flexible dentro de los sistemas
1497 @translationof Flexible vertical spacing within systems
1498
1499 @cindex distancia entre pentagramas
1500 @cindex pentagrama, distancia entre los
1501 @cindex espacio entre pentagramas
1502 @cindex espacio dentro de los sistemas
1503
1504 Tres mecanismos distintos controlan el espaciado vertical flexible
1505 dentro de los sistemas, uno por cada una de las categorías siguientes:
1506
1507 @itemize
1508 @item @emph{pautas sin agrupar},
1509 @item @emph{pautas agrupadas} (pautas dentro de un grupo de pentagramas como
1510 @code{ChoirStaff}, etc.), y
1511 @item @emph{líneas que no son pautas} (como @code{Lyrics},
1512 @code{ChordNames}, etc.).
1513 @end itemize
1514
1515 @c TODO: Clarify this.  This almost implies that non-staff lines
1516 @c       have NO effect on the spacing between staves.  -mp
1517
1518 La altura de cada sistema se determina en dos fases.  Primero, todos
1519 los pentagramas se disponen según la cantidad de espacio vacío
1520 disponible.  Después, las líneas que no son pautas se distribuyen
1521 entre las pautas.
1522
1523 Observe que los mecanismos de espaciado estudiados en esta sección
1524 solamente controlan el espaciado vertical de pas pautas y líneas que
1525 no son pautas dentro de los sistemas individuales.  El espaciado
1526 vertical entre distintos sistemas, partituras, marcados y márgenes se
1527 controla mediante variables de @code{\paper} que se estudian en
1528 @ref{Dimensiones verticales flexibles}.
1529
1530 @menu
1531 * Propiedades de espaciado dentro de los sistemas::
1532 * Espaciado de pautas no agrupadas::
1533 * Espaciado de pautas agrupadas::
1534 @end menu
1535
1536
1537 @node Propiedades de espaciado dentro de los sistemas
1538 @unnumberedsubsubsec Propiedades de espaciado dentro de los sistemas
1539 @translationof Within-system spacing properties
1540
1541 Los mecanismos de espaciado vertical dentro del sistema están
1542 controlados por dos conjuntos de propiedades de grob.  El primer
1543 conjunto está asociado con el grob @code{VerticalAxisGroup}, que se
1544 crea por parte de todas las pautas y líneas que no son pautas.  El
1545 segundo conjunto está asociado con el grob @code{StaffGrouper}, que
1546 puede crearse por parte de los grupos de pentagramas, pero solamente
1547 si se le llama explícitamente.  Estas propiedades se describen
1548 individualmente al final de la presente sección.
1549
1550 Los nombres de estas propiedades (excepto para @code{staff-affinity})
1551 siguen el formato @code{@var{elemento1}-@var{elemento2}-spacing},
1552 donde @code{@var{elemento1}} y @code{@var{elemento2}} son los
1553 elementos que se van a espaciar.  Observe que @code{@var{elemento2}}
1554 no está necesariamente por debajo de @code{@var{elemento1}}; por
1555 ejemplo, @code{nonstaff-relatedstaff-spacing} mide hadcia arriba a
1556 partir de la línea del tipo no-pauta si @code{staff-affinity} es
1557 @code{#UP}.
1558
1559 Cada distancia se mide entre los @emph{puntos de referencia} de los
1560 dos elementos.  El @emph{punto de referencia} para un pentagrama y
1561 otro tipo de pauta es el centro vertical de su @code{StaffSymbol} (es
1562 decir, la línea central si @code{line-count} es un número impar; el
1563 espacio central si @code{line-count} es par).  Los puntos de
1564 referencia para las líneas individuales que no son pautas aparecen en
1565 la tabla siguiente:
1566
1567 @multitable {Línea que no es una pauta} {Punto de referencia}
1568 @headitem Línea que no es una pauta @tab Punto de referencia
1569 @item @code{ChordNames}  @tab línea de base
1570 @item @code{NoteNames}   @tab línea de base
1571 @item @code{Lyrics}      @tab línea de base
1572 @item @code{Dynamics}    @tab centro vertical
1573 @item @code{FiguredBass} @tab punto más alto
1574 @item @code{FretBoards}  @tab línea superior
1575 @end multitable
1576
1577 En la siguiente imagen, las líneas horizontales indican las posiciones
1578 de estos puntos de referencia:
1579
1580 @lilypond[quote,noragged-right,line-width=110\mm]
1581 #(define zero-space '((padding . -inf.0) (space . 0)))
1582
1583 alignToZero = \with {
1584   \override VerticalAxisGroup #'nonstaff-relatedstaff-spacing = #zero-space
1585   \override VerticalAxisGroup #'nonstaff-nonstaff-spacing = #zero-space
1586 }
1587 lowerCaseChords = \with {
1588   chordNameLowercaseMinor = ##t
1589 }
1590 staffAffinityDown = \with {
1591   \override VerticalAxisGroup #'staff-affinity = #DOWN
1592 }
1593 labelContext =
1594 #(define-music-function
1595      (parser location context)
1596      (string?)
1597    #{ s1*0^\markup { \typewriter $context } #})
1598
1599 \layout {
1600   \context { \Dynamics    \alignToZero }
1601   \context { \FiguredBass \alignToZero }
1602   \context { \Lyrics      \alignToZero }
1603   \context { \NoteNames   \alignToZero }
1604   \context { \ChordNames  \alignToZero \lowerCaseChords }
1605   \context { \FretBoards  \alignToZero \staffAffinityDown }
1606   \context { \Score
1607     \override BarLine #'stencil = ##f
1608     \override DynamicText #'self-alignment-X = #-1
1609     \override FretBoard #'X-offset = #1.75
1610     \override InstrumentName #'minimum-Y-extent = #'(-2 . 2)
1611     \override InstrumentName #'extra-offset = #'(0 . -0.5)
1612     \override TextScript #'minimum-Y-extent = #'(-2 . 3)
1613     \override TimeSignature #'stencil = ##f
1614   }
1615 }
1616
1617 %% These contexts have reference points at the baseline:
1618 %%   ChordNames, NoteNames, and Lyrics
1619 <<
1620   \new ChordNames { \chords { g1:m } }
1621   \new NoteNames { s1 | g1 | }
1622   \new RhythmicStaff {
1623     \set RhythmicStaff.instrumentName = #"baseline "
1624     \textLengthOn
1625     \labelContext "ChordNames" s1 |
1626     \labelContext "NoteNames"  s1 |
1627     \labelContext "Lyrics"     s1 |
1628   }
1629   \new Lyrics { \lyrics { \skip 1*2 | ghijk1 | } }
1630 >>
1631
1632 %% The reference point for Dynamics is its vertical center
1633 <<
1634   \new RhythmicStaff {
1635     \set RhythmicStaff.instrumentName = #"vertical center "
1636     \labelContext "Dynamics" s1*3
1637   }
1638   \new Dynamics { s2\mp s\fp }
1639 >>
1640
1641 %% The reference point for FiguredBass is its highest point
1642 <<
1643   \new RhythmicStaff {
1644     \set RhythmicStaff.instrumentName = #"highest point "
1645     \labelContext "FiguredBass" s1
1646   }
1647   \new FiguredBass { \figuremode { <6 5>1 } }
1648 >>
1649
1650 %% The reference point for FretBoards is the top line
1651 \include "predefined-guitar-fretboards.ly"
1652 <<
1653   \new FretBoards { \chordmode { e1 } }
1654   \new RhythmicStaff {
1655     \set RhythmicStaff.instrumentName = #"top line "
1656     \labelContext "FretBoards " s1
1657   }
1658 >>
1659 @end lilypond
1660
1661 Cada una de las propiedades de grob del espaciado vertical (excepto
1662 @code{staff-affinity}) se almacena como una lista-A (lista
1663 asociativa), y todas usan la misma estructura de lista-A que las
1664 variables de espaciado del bloque @code{\paper} que se han estudiado
1665 en @ref{Dimensiones verticales flexibles}.  En @ref{Modificación de
1666 las listas-A} se estudian métodos específicos para la modificación de
1667 las listas-A.  Las propiedades de los grobs deben ajustarse con un
1668 @code{\override} dentro de un bloque @code{\score} o @code{\layout}, y
1669 no dentro de un bloque @code{\paper}.
1670
1671 El ejemplo que sigue muestra las dos maneras en que pueden modificarse
1672 estas listas-A.  La primera declaración ctualiza un par clave-valor de
1673 forma individual, y la segunda redefine la propiedad completamente:
1674
1675 @example
1676 \new Staff \with @{
1677   \override VerticalAxisGroup #'staff-staff-spacing #'space = #10
1678 @} @{ @dots{} @}
1679
1680 \new Staff \with @{
1681   \override VerticalAxisGroup #'staff-staff-spacing =
1682     #'((padding . 1)
1683        (space . 10)
1684        (minimum-distance . 9)
1685        (stretchability . 10))
1686 @} @{ @dots{} @}
1687 @end example
1688
1689 Para modificar globalmente cualquiera de los ajustes de espaciado,
1690 póngalos dentro del bloque @code{\layout}:
1691
1692 @example
1693 \layout @{
1694   \context @{
1695     \Staff
1696     \override VerticalAxisGroup #'staff-staff-spacing #'space = #10
1697   @}
1698 @}
1699 @end example
1700
1701 Los ajustes estándar para las propiedades de grob del espaciado
1702 vertical están relacionadas en @rinternals{VerticalAxisGroup} y en
1703 @rinternals{StaffGrouper}.  Las sobreescrituras predeterminadas para
1704 los tipos específicos de líneas que no son pautas están relacionadas
1705 en las descripciones de contexto correspondientes en
1706 @rinternals{Contexts}.
1707
1708
1709 @subsubheading Propieades del grob @code{VerticalAxisGroup}
1710
1711 Las propiedades de @code{VerticalAxisGroup} se suelen ajustar con una
1712 instrucción @code{\override} en el nivel de @code{Staff} (o
1713 equivalente).
1714
1715 @table @code
1716 @item staff-staff-spacing
1717 Distancia entre la pauta actual y la pauta que está justo por debajo
1718 de ella dentro del mismo sistema, incluso si hay más líneas que no son
1719 pautas (tales como @code{Lyrics}) entre las dos pautas.  No se aplica
1720 a la pauta inferior de un sistema.  Esto susituye a cualquier ajuste
1721 heredado del grob @code{StaffGrouper} del grupo de pautas contenedor,
1722 si existe.  Si no está fijado, y no hay ninguna propiedad de
1723 @code{StaffGrouper} que heredar, se usa la propiedad
1724 @code{default-staff-staff-spacing}.
1725
1726 @item default-staff-staff-spacing
1727 Ajustes que utilizar para @code{staff-staff-spacing} cuando está sin
1728 establecer.  Se aplica a las pautas no agrupadas y a las pautas
1729 agrupadas que no heredan los ajustes del grob @code{StaffGrouper}.
1730
1731 @item staff-affinity
1732 Dirección de la pauta que utilizar para el espaciado de la línea
1733 actual que no es pauta.  Se puede elegir entre @code{UP} (arriba),
1734 @code{DOWN} (abajo) y @code{CENTER} (centro).  Si es @code{CENTER}, la
1735 línea del tipo no-pauta se coloca equidistante entre las dos pautas
1736 contiguas a ambos lados, a no ser que lo impidan colisiones u otras
1737 restricciones de espaciado.  Las líneas del tipo no-pauta adyacentes
1738 han de llevar valores de @code{staff-affinity} no crecientes desde la
1739 parte superior hasta la inferior, p.ej. una línea del tipo no-pauta
1740 establecida a @code{UP} no debería seguir inmediatamente a otra que
1741 esté establecida a @code{DOWN}.  Las líneas del tipo no-pauta en la
1742 parte superior de un sistema deben usar @code{DOWN}; las de la parte
1743 inferior deben usar @code{UP}.  El ajuste de @code{staff-affinity}
1744 para una pauta hace que se le trate como una línea que no es una
1745 pauta.  El establecimiento de @code{staff-affinity} a @code{#f} para
1746 una línea que no es una pauta hace que se trate como una pauta.
1747
1748 @c TODO: verify last clause below ("even if other...")
1749
1750 @item nonstaff-relatedstaff-spacing
1751 Distancia entre la línea del tipo no-pauta actual y la pauta más
1752 próxima en la dirección de @code{staff-affinity}, si no hay ninguna
1753 línea que no sea una pauta entre las dos, y @code{staff-affinity} es
1754 @code{UP} o @code{DOWN}.  Si @code{staff-affinity} es @code{CENTER},
1755 entonces se usa @code{nonstaff-relatedstaff-spacing} para las pautas
1756 más próximas @emph{a los dos lados}, incluso aunque aparezcan otras
1757 líneas del tipo no-pauta entre la pauta actual y una de las otras.
1758
1759 @item nonstaff-nonstaff-spacing
1760 Distancia entre la línea actual del tipo no-pauta y la siguiente línea
1761 del tipo no-pauta en la dirección de @code{staff-affinity}, si las dos
1762 están al mismo lado de la pauta relacionada, y @code{staff-affinity}
1763 es @code{UP} o @code{DOWN}.
1764
1765 @item nonstaff-unrelatedstaff-spacing
1766 Distancia entre la línea actual del tipo no-pauta y la pauta en la
1767 dirección opuesta de @code{staff-affinity}, si no hay ninguna otra
1768 línea del tipo no-pauta entre las dos, y @code{staff-affinity} es
1769 @code{UP} o @code{DOWN}.  Se puede usar, por ejemplo, para requerir
1770 una cantidad de relleno mínima entre una línea de @code{Lyrics} y la
1771 pauta a la que no pertenece.
1772 @end table
1773
1774
1775 @subsubheading Propiedades del grob @code{StaffGrouper}
1776
1777 Las propiedades de @code{StaffGrouper} se suelen ajustar con una
1778 instrucción @code{\override} en el nivel de @code{StaffGroup} (o
1779 equivalente).
1780
1781 @table @code
1782 @item staff-staff-spacing
1783 Distancia entre pautas consecutivas dentro del grupo de pautas actual.
1784 La propiedad @code{staff-staff-spacing} del grob
1785 @code{VerticalAxisGroup} de una pauta individual se usará en su lugar
1786 para cualquier pauta que esté dentro del grupo que tiene el valor
1787 fijado.  Véase también @code{default-staff-staff-spacing}.
1788
1789 @item staffgroup-staff-spacing
1790 Distancia entre la última pauta del grupo en curso y la pauta que está
1791 justo por debajo de ella dentro del mismo sistema, incluso si existen
1792 una o más líneas que no son pautas (tales como @code{Lyrics}) entre
1793 las dos pautas.  No se aplica al pentagrama o pauta inferior de un
1794 sistema.  La propiedad @code{staff-staff-spacing} del grob
1795 @code{VerticalAxisGroup} de una pauta individual se usará en su lugar
1796 para cualquier pauta dentro del grupo que tenga el valor fijado.
1797 Véase también @code{default-staff-staff-spacing}.
1798 @end table
1799
1800 @seealso
1801 Archivos de inicio:
1802 @file{ly/engraver-init.ly},
1803 @file{scm/define-grobs.scm}.
1804
1805 Referencia de funcionamiento interno:
1806 @rinternals{Contexts},
1807 @rinternals{VerticalAxisGroup},
1808 @rinternals{StaffGrouper}.
1809
1810
1811 @node Espaciado de pautas no agrupadas
1812 @unnumberedsubsubsec Espaciado de pautas no agrupadas
1813 @translationof Spacing of ungrouped staves
1814
1815 Las @emph{pautas}, tales como los pentagramas (@code{Staff}), pautas
1816 de percusión (@code{DrumStaff}) o de tablatura (@code{TabStaff}),
1817 etc. son contextos que pueden contener uno o más contextos de voz,
1818 pero no pueden contener otras pautas.
1819
1820 Las siguientes propiedades afectan al espaciado de las pautas @emph{no
1821 agrupadas}:
1822
1823 @itemize
1824 @item Propiedades de @code{VerticalAxisGroup}:
1825 @itemize
1826 @item @code{staff-staff-spacing}
1827 @end itemize
1828 @end itemize
1829
1830 Estas propiedades de grob se describen individualmente más arriba;
1831 véase @ref{Propiedades de espaciado dentro de un sistema}.
1832
1833 Están implicadas ciertas propiedades adicionales para las pautas que
1834 son parte de un grupo; véase @ref{Espaciado de pautas agrupadas}.
1835
1836 El ejemplo siguiente muestra cómo la propiedad
1837 @code{staff-staff-spacing} puede afectar al espaciado de pautas no
1838 agrupadas:
1839
1840 @lilypond[verbatim,quote,staffsize=16]
1841 \layout {
1842   \context {
1843     \Staff
1844     \override VerticalAxisGroup #'staff-staff-spacing =
1845       #'((padding . 1)
1846          (space . 8)
1847          (minimum-distance . 7))
1848   }
1849 }
1850
1851 \new StaffGroup <<
1852   % The very low note here needs more room than 'space can
1853   % provide, so the distance between this staff and the next is
1854   % determined by 'padding.
1855   \new Staff { b,2 r | }
1856
1857   % Here, 'space provides enough room, and there is no need to
1858   % compress the space (towards 'minimum-distance) to make room
1859   % for anything else on the page, so the distance between this
1860   % staff and the next is determined by 'space.
1861   \new Staff { \clef bass g2 r | }
1862
1863   % By setting 'padding to a negative value, staves can be made to
1864   % collide.  The lowest acceptable value for 'space is 0.
1865   \new Staff \with {
1866     \override VerticalAxisGroup #'staff-staff-spacing =
1867       #'((padding . -10)
1868          (space . 3.5))
1869   } { \clef bass g2 r | }
1870   \new Staff { \clef bass g2 r | }
1871 >>
1872 @end lilypond
1873
1874 @seealso
1875 Archivos de inicio:
1876 @file{scm/define-grobs.scm}.
1877
1878 Fragmentos de código:
1879 @rlsr{Spacing}.
1880
1881 Referencia de funcionamiento interno:
1882 @rinternals{VerticalAxisGroup}.
1883
1884
1885 @node Espaciado de pautas agrupadas
1886 @unnumberedsubsubsec Espaciado de pautas agrupadas
1887 @translationof Spacing of grouped staves
1888
1889 En partituras grandes como las orquestales, es común colocar los
1890 pentagramas en grupos.  El espacio entre los grupos suele ser mayor
1891 que el espacio que hay entre los pentagramas dentro del mismo grupo.
1892
1893 Los grupos de pautas, @emph{Staff-groups} (tales como
1894 @code{StaffGroup}, @code{ChoirStaff}, etc.) son contextos que pueden
1895 contener al mismo tiempo uno o más pentagramas o pautas.
1896
1897 Las siguientes propiedades afectan al espaciado de las pautas dentro
1898 de los grupos:
1899
1900 @itemize
1901 @item Propiedades de @code{VerticalAxisGroup}:
1902 @itemize
1903 @item @code{staff-staff-spacing}
1904 @item @code{default-staff-staff-spacing}
1905 @end itemize
1906 @item Propiedades de @code{StaffGrouper}:
1907 @itemize
1908 @item @code{staff-staff-spacing}
1909 @item @code{staffgroup-staff-spacing}
1910 @end itemize
1911 @end itemize
1912
1913 Estas propiedades de grob se describen individualmente más arriba;
1914 véase @ref{Propiedades de espaciado dentro de un sistema}.
1915
1916 El ejemplo siguiente muestra cómo pueden afectar las propiedades del
1917 grob @code{StaffGrouper} al espaciado de las pautas agrupadas:
1918
1919 @lilypond[verbatim,quote,staffsize=16]
1920 \layout {
1921   \context {
1922     \Score
1923     \override StaffGrouper #'staff-staff-spacing #'padding = #0
1924     \override StaffGrouper #'staff-staff-spacing #'space = #1
1925   }
1926 }
1927
1928 <<
1929   \new PianoStaff \with {
1930     \override StaffGrouper #'staffgroup-staff-spacing #'space = #20
1931   } <<
1932     \new Staff { c'1 }
1933     \new Staff { c'1 }
1934   >>
1935
1936   \new StaffGroup <<
1937     \new Staff { c'1 }
1938     \new Staff { c'1 }
1939   >>
1940 >>
1941 @end lilypond
1942
1943 @seealso
1944 Installed Files:
1945 @file{scm/define-grobs.scm}.
1946
1947 Snippets:
1948 @rlsr{Spacing}.
1949
1950 Internals Reference:
1951 @rinternals{VerticalAxisGroup},
1952 @rinternals{StaffGrouper}.
1953
1954
1955 @unnumberedsubsubsec Espaciado de las líneas que no son pautas
1956
1957 Las @emph{Líneas que no son pautas} (tales como @code{Lyrics},
1958 @code{ChordNames}, etc.) son contextos cuyos objetos de presentación
1959 se imprimen como pentagramas (es decir, en líneas horizontales dentro
1960 de los sistemas).  Específicamente, las líneas que no son pautas son
1961 contextos del tipo no-pauta que crean el objeto de presentación
1962 @code{VerticalAxisGroup}.
1963
1964 Las siguientes propiedades afectan al espaciado de las líneas que no
1965 son pautas:
1966
1967 @itemize
1968 @item Propiedades de @code{VerticalAxisGroup}:
1969 @itemize
1970 @item @code{staff-affinity}
1971 @item @code{nonstaff-relatedstaff-spacing}
1972 @item @code{nonstaff-nonstaff-spacing}
1973 @item @code{nonstaff-unrelatedstaff-spacing}
1974 @end itemize
1975 @end itemize
1976
1977 Estas propiedades de grob se describen individualmente más arriba;
1978 véase @ref{Propiedades de espaciado dentro del sistema}.
1979
1980 El ejemplo siguiente muestra cómo la propiedad
1981 @code{nonstaff-nonstaff-spacing} puede afectar el espaciado de líneas
1982 consecutivas que no son pautas.  Aquí, mediante el establecimiento de
1983 la clave de ampliabilidad @code{stretchability} a un valor muy grande,
1984 la línea de letra es capaz de ampliarse mucho más de lo que es usual:
1985
1986 @lilypond[verbatim,quote,staffsize=16]
1987 \layout {
1988   \context {
1989     \Lyrics
1990     \override VerticalAxisGroup
1991       #'nonstaff-nonstaff-spacing #'stretchability = #1000
1992   }
1993 }
1994
1995 \new StaffGroup
1996 <<
1997   \new Staff \with {
1998     \override VerticalAxisGroup #'staff-staff-spacing = #'((space . 30))
1999   } { c'1 }
2000   \new Lyrics \with {
2001     \override VerticalAxisGroup #'staff-affinity = #UP
2002   } \lyricmode { up }
2003   \new Lyrics \with {
2004     \override VerticalAxisGroup #'staff-affinity = #CENTER
2005   } \lyricmode { center }
2006   \new Lyrics \with {
2007     \override VerticalAxisGroup #'staff-affinity = #DOWN
2008   } \lyricmode { down }
2009   \new Staff { c'1 }
2010 >>
2011 @end lilypond
2012
2013
2014 @seealso
2015 Archivos de inicio:
2016 @file{ly/engraver-init.ly},
2017 @file{scm/define-grobs.scm}.
2018
2019 Fragmentos de código:
2020 @rlsr{Spacing}.
2021
2022 @c @lsr{spacing,page-spacing.ly},
2023 @c @lsr{spacing,alignment-vertical-spacing.ly}.
2024
2025 Referencia de funcionamiento interno:
2026 @rinternals{Contexts},
2027 @rinternals{VerticalAxisGroup}.
2028
2029
2030 @node Posicionamiento explícito de los pentagramas y los sistemas
2031 @subsection Posicionamiento explícito de los pentagramas y los sistemas
2032 @translationof Explicit staff and system positioning
2033
2034 Una forma de comprender los ajustes de @code{VerticalAxisGroup} y de
2035 @code{\paper} que se han explicado en las dos secciones precedentes es
2036 como una colección de distintos ajustes que conciernen principalmente
2037 a la cantidad de relleno vertical entre distintos pentagramas y
2038 sistemas que ocupan toda la página.
2039 @c running down the page.
2040
2041 Es posible enfrentarse al espaciado vertical de una forma distinta
2042 utilizando @code{NonMusicalPaperColumn #'line-break-system-details}.
2043 Cuando los ajustes de @code{VerticalAxisGroup} y de @code{\paper}
2044 especifican relleno vertical, @code{NonMusicalPaperColumn
2045 #'line-break-system-details} especifica posiciones verticales exactas
2046 sobre la página.
2047
2048 @code{NonMusicalPaperColumn #'line-break-system-details} acepta una
2049 lista asociativa de tres ajustes diferentes:
2050
2051 @itemize
2052 @item @code{X-offset} (desplazamiento en X)
2053 @item @code{Y-offset} (desplazamiento en Y)
2054 @item @code{alignment-distances} (distancias de alineación)
2055 @end itemize
2056
2057 Las sobreescrituras de los objetos gráficos, entre ellas las de
2058 @code{NonMusicalPaperColumn} que aparecen más abajo, pueden ocurrir en
2059 tres lugares distintos dentro de un archivo de entrada:
2060
2061 @itemize
2062 @item directamente en medio de las notas
2063 @item en un bloque @code{\context}
2064 @item en el bloque @code{\with}
2065 @end itemize
2066
2067 Cuando sobreescribimos @code{NonMusicalPaperColumn}, usamos la
2068 instrucción @code{\override} usual en los bloques @code{\context} y en
2069 el bloque @code{\with}.  Por otra parte, cuando sobreescribimos
2070 @code{NonMusicalPaperColumn} en medio de las notas, debemos usar la
2071 instrucción especial @code{\overrideProperty}.  He aquí algunas
2072 sobreescrituras de @code{NonMusicalPaperColumn} de ejemplo con la
2073 instrucción especial @code{\overrideProperty}:
2074
2075 @example
2076 \overrideProperty NonMusicalPaperColumn
2077   #'line-break-system-details #'((X-offset . 20))
2078
2079 \overrideProperty NonMusicalPaperColumn
2080   #'line-break-system-details #'((Y-offset . 40))
2081
2082 \overrideProperty NonMusicalPaperColumn
2083   #'line-break-system-details #'((X-offset . 20) (Y-offset . 40))
2084
2085 \overrideProperty NonMusicalPaperColumn
2086   #'line-break-system-details #'((alignment-distances . (15)))
2087
2088 \overrideProperty NonMusicalPaperColumn
2089   #'line-break-system-details #'((X-offset . 20) (Y-offset . 40)
2090                                  (alignment-distances . (15)))
2091 @end example
2092
2093 Para entender cómo funciona cada uno de los distintos ajustes,
2094 empezamos observando un ejemplo que no incluye absolutamente ninguna
2095 sobreescritura.
2096
2097 @c \book { } is required in these examples to ensure the spacing
2098 @c overrides can be seen between systems. -np
2099
2100 @lilypond[quote]
2101 \header { tagline = ##f }
2102 \paper { left-margin = 0\mm }
2103 \book {
2104   \score {
2105     <<
2106       \new Staff <<
2107         \new Voice {
2108           s1*5 \break
2109           s1*5 \break
2110           s1*5 \break
2111         }
2112         \new Voice { \repeat unfold 15 { c'4 c' c' c' } }
2113       >>
2114       \new Staff {
2115         \repeat unfold 15 { d'4 d' d' d' }
2116       }
2117     >>
2118   }
2119 }
2120 @end lilypond
2121
2122 Esta partitura mantiene aislada la información de los saltos de línea
2123 y de página en una voz dedicada a ello.  Esta técnica de crear una voz
2124 de saltos ayuda a mantener separada de la escritura de notas conforme
2125 el ejemplo se vuelve más complicado.  Consulte
2126 @ref{Utilizar una voz adicional para los saltos de línea}.
2127
2128 Los saltos explícitos dividen la música de forma regular en seis
2129 compases por línea.  El espaciado vertical es el resultado de los
2130 ajustes predeterminados de LilyPond.  Para establecer explícitamente
2131 el punto de origen vertical de cada sistema, podemos establecer el par
2132 @code{Y-offset} en el atributo @code{line-break-system-details} del
2133 grob (objeto gráfico) @code{NonMusicalPaperColumn}:
2134
2135 @lilypond[quote]
2136 \header { tagline = ##f }
2137 \paper { left-margin = 0\mm }
2138 \book {
2139   \score {
2140     <<
2141       \new Staff <<
2142         \new Voice {
2143           \overrideProperty #"Score.NonMusicalPaperColumn"
2144             #'line-break-system-details #'((Y-offset . 0))
2145           s1*5 \break
2146           \overrideProperty #"Score.NonMusicalPaperColumn"
2147             #'line-break-system-details #'((Y-offset . 40))
2148           s1*5 \break
2149           \overrideProperty #"Score.NonMusicalPaperColumn"
2150             #'line-break-system-details #'((Y-offset . 80))
2151           s1*5 \break
2152         }
2153         \new Voice { \repeat unfold 15 { c'4 c' c' c' } }
2154       >>
2155       \new Staff {
2156         \repeat unfold 15 { d'4 d' d' d' }
2157       }
2158     >>
2159   }
2160 }
2161 @end lilypond
2162
2163 Observe que @code{line-break-system-details} toma una lista asociativa
2164 de una cantidad de valores potencialmente elevada, pero aquí sólo
2165 fijamos un valor.  Observe también que aquí la propiedad
2166 @code{Y-offset} determina la posición vertical exacta sobre la página
2167 en la que se trazará cada uno de los nuevos sistemas.
2168
2169 Ahora que hemos establecido explícitamente el punto de origen vertical
2170 de cada sistema, podemos también establecer manualmente las distancias
2171 verticales entre los pentagramas dentro de cada sistema.  Lo hacemos
2172 usando la subpropiedad @code{alignment-distances} de
2173 @code{line-break-system-details}.
2174
2175 @lilypond[quote]
2176 \header { tagline = ##f }
2177 \paper { left-margin = 0\mm }
2178 \book {
2179   \score {
2180     <<
2181       \new Staff <<
2182         \new Voice {
2183           \overrideProperty #"Score.NonMusicalPaperColumn"
2184             #'line-break-system-details #'((Y-offset . 20)
2185                                            (alignment-distances . (15)))
2186           s1*5 \break
2187           \overrideProperty #"Score.NonMusicalPaperColumn"
2188             #'line-break-system-details #'((Y-offset . 60)
2189                                            (alignment-distances . (15)))
2190           s1*5 \break
2191           \overrideProperty #"Score.NonMusicalPaperColumn"
2192             #'line-break-system-details #'((Y-offset . 100)
2193                                            (alignment-distances . (15)))
2194           s1*5 \break
2195         }
2196         \new Voice { \repeat unfold 15 { c'4 c' c' c' } }
2197       >>
2198       \new Staff {
2199         \repeat unfold 15 { d'4 d' d' d' }
2200       }
2201     >>
2202   }
2203 }
2204 @end lilypond
2205
2206 Observe que aquí asignamos dos valores distintos al atributo
2207 @code{line-break-system-details} del grob
2208 @code{NonMusicalPaperColumn}.  Aunque el atributo alist de
2209 @code{line-break-system-details} acepta muchos parámetros de espaciado
2210 adicionales (entre ellos, por ejemplo, un par @code{X-offset}
2211 correspondiente), sólo tenemos que establecer el desplazamiento
2212 @code{Y-offset} y los pares @code{alignment-distances} para controlar
2213 el punto de origen vertical de cada sistema y pentagrama.  Finalmente,
2214 observe que @code{alignment-distances} especifica el posicionamiento
2215 vertical de los pentagramas pero no de los grupos de pentagramas.
2216
2217 @lilypond[quote]
2218 \header { tagline = ##f }
2219 \paper { left-margin = 0\mm }
2220 \book {
2221   \score {
2222     <<
2223       \new Staff <<
2224         \new Voice {
2225           \overrideProperty #"Score.NonMusicalPaperColumn"
2226             #'line-break-system-details #'((Y-offset . 0)
2227                                            (alignment-distances . (30 10)))
2228           s1*5 \break
2229           \overrideProperty #"Score.NonMusicalPaperColumn"
2230             #'line-break-system-details #'((Y-offset . 60)
2231                                            (alignment-distances . (10 10)))
2232           s1*5 \break
2233           \overrideProperty #"Score.NonMusicalPaperColumn"
2234             #'line-break-system-details #'((Y-offset . 100)
2235                                            (alignment-distances . (10 30)))
2236           s1*5 \break
2237         }
2238         \new Voice { \repeat unfold 15 { c'4 c' c' c' } }
2239       >>
2240       \new StaffGroup <<
2241         \new Staff { \repeat unfold 15 { d'4 d' d' d' } }
2242         \new Staff { \repeat unfold 15 { e'4 e' e' e' } }
2243       >>
2244     >>
2245   }
2246 }
2247 @end lilypond
2248
2249 Algunos puntos que tener en cuenta:
2250
2251 @itemize
2252 @item Al usar @code{alignment-distances}, la letra
2253 y otras líneas que no son pautas, no cuentan como un pentagrama.
2254
2255 @item Las unidades de los números que se pasan a @code{X-offset},
2256 @code{Y-offset} y @code{alignment-distances} se interpretan como
2257 múltiplos de la distancia entre líneas de pentagrama adyacentes.  Los
2258 valores positivos mueven a los pentagramas y a la letra hacia arriba,
2259 los valores negativos mueven los pentagramas y la letra hacia abajo.
2260
2261 @item A causa de que los ajustes a @code{NonMusicalPaperColumn
2262 #'line-break-system-details} dados aquí permiten el posicionamiento de
2263 pentagramas y sistemas en cualquier lugar de la página, es posible
2264 violar los márgenes o los límites del papel, o incluso imprimir
2265 pentagramas o sistemas unos encima de otros.  Esto se evitaría pasando
2266 a los diferentes ajustes unos valores razonables.
2267 @end itemize
2268
2269
2270 @seealso
2271 Fragmentos de código:
2272 @rlsr{Spacing}.
2273
2274
2275 @node Evitar las colisiones verticales
2276 @subsection Evitar las colisiones verticales
2277 @translationof Vertical collision avoidance
2278
2279 @funindex outside-staff-priority
2280 @funindex outside-staff-padding
2281 @funindex outside-staff-horizontal-padding
2282
2283 Podemos decir intuitivamente que algunos objetos de la notación
2284 musical pertenecen al pentagrama y otros se sitúan fuera del
2285 pentagrama.  Entre los objetos que pertenecen al exterior del
2286 pentagrama están las marcas de ensayo, las marcas textuales y las
2287 indicaciones de dinámica (en lo sucesivo, les llamaremos objetos fuera
2288 del pentagrama).  La regla de LilyPond para la colocación vertical de
2289 los objetos fuera del pentagrama es ponerlos tan cerca del pentagrama
2290 como sea posible pero no tan próximos como para que choquen con otro
2291 objeto.
2292
2293 LilyPond utiliza la propiedad @code{outside-staff-priority} para
2294 determinar si un grob es un objeto fuera del pentagrama: si
2295 @code{outside-staff-priority} es un número, el grob es un objeto fuera
2296 del pentagrama.  Además, @code{outside-staff-priority} informa a
2297 LilyPond en qué orden se debe situar los objetos.
2298
2299 En primer lugar, LilyPond sitúa todos los objetos que no pertenecen al
2300 exterior del pentagrama.  Después ordena los objetos fuera del
2301 pentagrama de acuerdo a su prioridad @code{outside-staff-priority} (en
2302 orden creciente).  LilyPond toma los objetos fuera del pentagrama uno
2303 a uno y los coloca de forma que no choquen con ningún objeto que ya
2304 haya sido colocado.  Esto es, si dos grobs fuera del pentagrama
2305 compiten por el mismo espacio, el que tiene la prioridad
2306 @code{outside-staff-priority} más baja se colocará más próximo al
2307 pentagrama.
2308
2309 @lilypond[quote,ragged-right,relative=2,verbatim]
2310 c4_"Text"\pp
2311 r2.
2312 \once \override TextScript #'outside-staff-priority = #1
2313 c4_"Text"\pp % this time the text will be closer to the staff
2314 r2.
2315 % by setting outside-staff-priority to a non-number,
2316 % we disable the automatic collision avoidance
2317 \once \override TextScript #'outside-staff-priority = ##f
2318 \once \override DynamicLineSpanner #'outside-staff-priority = ##f
2319 c4_"Text"\pp % now they will collide
2320 @end lilypond
2321
2322 El relleno vertical entre un objeto fuera del pentagrama y los grobs
2323 posicionados previamente se puede controlar con
2324 @code{outside-staff-padding}.
2325
2326 @lilypond[quote,ragged-right,relative=2,verbatim]
2327 \once \override TextScript #'outside-staff-padding = #0
2328 a'^"This text is placed very close to the note"
2329 \once \override TextScript #'outside-staff-padding = #3
2330 c^"This text is padded away from the previous text"
2331 c^"This text is placed close to the previous text"
2332 @end lilypond
2333
2334 De forma predeterminada, los objetos fuera del pentagrama se colocan
2335 sólo para evitar una colisión horizontal con los grobs posicionados
2336 previamente.  Esto puede llevar a situaciones en las que los objetos
2337 se colocan muy próximos entre sí en el sentido horizontal.  El espacio
2338 vertical entre pentagramas se puede fijar también de manera que los
2339 objetos fuera del pentagrama se sitúen de forma intercalada.  El
2340 establecimiento del relleno horizontal
2341 @code{outside-staff-horizontal-padding} ocasiona que un objeto se
2342 desplace verticalmente para que tal situación no ocurra.
2343
2344 @lilypond[quote,ragged-right,relative=2,verbatim]
2345 % the markup is too close to the following note
2346 c4^"Text"
2347 c4
2348 c''2
2349 % setting outside-staff-horizontal-padding fixes this
2350 R1
2351 \once \override TextScript #'outside-staff-horizontal-padding = #1
2352 c,,4^"Text"
2353 c4
2354 c''2
2355 @end lilypond
2356
2357
2358 @seealso
2359 Fragmentos de código:
2360 @rlsr{Spacing}.
2361
2362
2363 @node Espaciado horizontal
2364 @section Espaciado horizontal
2365 @translationof Horizontal spacing
2366
2367 @cindex horizontal, espaciado
2368 @cindex espaciado horizontal
2369
2370 @menu
2371 * Panorámica del espaciado horizontal::
2372 * Área de espaciado nueva::
2373 * Cambiar el espaciado horizontal::
2374 * Longitud de la línea::
2375 * Notación proporcional::
2376 @end menu
2377
2378
2379 @node Panorámica del espaciado horizontal
2380 @subsection Panorámica del espaciado horizontal
2381 @translationof Horizontal spacing overview
2382
2383 El motor de espaciado traduce las diferencias en las duraciones a
2384 distancias ampliables (@q{muelles}) de distintas longitudes.  Las
2385 duraciones más largas reciben un espacio mayor y las duraciones más
2386 cortas reciben menos.  Las duraciones más breves reciben un espacio de
2387 tamaño fijo (que se controla mediante @code{shortest-duration-space}
2388 en el objeto @rinternals{SpacingSpanner}).  Cuanto más larga es la
2389 duración, más espacio recibe: al doblar una duración se añade un
2390 espacio de tamaño fijo (este tamaño se controla mediante
2391 @code{spacing-increment}) a la nota.
2392
2393 Por ejemplo, la pieza siguiente contiene numerosas blancas, negras y
2394 corcheas; la corchea va seguida de un ancho de cabeza de blanca (ACB).
2395 La negra va seguida de 2 ACB, la blanca por 3 ACB, etc.
2396
2397 @lilypond[quote,verbatim,relative=1]
2398 c2 c4. c8 c4. c8 c4. c8 c8
2399 c8 c4 c4 c4
2400 @end lilypond
2401
2402 Normalmente, el valor de @code{spacing-increment} está establecido en
2403 1.2 espacios de pentagrama, lo que es aproximadamente el ancho de una
2404 cabeza, y @code{shortest-duration-space} está establecido en 2.0, lo
2405 que significa que la nota más breve recibe 2.4 espacios de pentagrama
2406 (2.0 multiplicado por el @code{spacing-increment}) de espacio
2407 horizontal.  Este espacio se cuenta a partir del borde izquierdo del
2408 símbolo, de manera que las notas más breves van seguidas generalmente
2409 por un espacio de 1 ACB.
2410
2411 Si siguiésemos el procedimiento anterior exactamente, entonces la
2412 adición de una sola fusa a una partitura que usa corcheas y
2413 semicorcheas, aumentaría enormemente la anchura de la partitura
2414 completa.  La nota más breve ya no es la semicorchea, sino la fusa,
2415 añadiendo así 1 ACB a cada una de las notas.  Para evitarlo, la
2416 duración más breve a efectos de espaciado no es la nota más breve de
2417 la partitura, sino la que ocurre con más frecuencia.
2418
2419 La duración más breve que es más común se determina de la siguiente
2420 manera: en cada compás se determina la duración más breve.  La menor
2421 duración más común se toma como base para el espaciado, habiendo
2422 estipulado que esta duración menor siempre debe ser igual o menor que
2423 una corchea.  La duración más breve se imprime cuando se ejecuta
2424 @code{lilypond} con la opción @code{--verbose}.
2425
2426 Estas duraciones también se pueden personalizar.  Si establecemos la
2427 @code{common-shortest-duration} en @rinternals{SpacingSpanner},
2428 entonces éste establece la duración base para el espaciado.  La
2429 duración máxima para esta base (normalmente una corchea), se fija a
2430 través de @code{base-shortest-duration}.
2431
2432 @funindex common-shortest-duration
2433 @funindex base-shortest-duration
2434 @funindex stem-spacing-correction
2435 @funindex spacing
2436
2437 Las notas que son aún más breves que la nota común más breve van
2438 seguidas por un espacio proporcional a su duración en relación con la
2439 nota común más breve.  Así pues, si fuésemos a añadir tan sólo algunas
2440 semicorcheas al ejemplo anterior, irían seguidas por medio ACB:
2441
2442 @lilypond[quote,verbatim,relative=2]
2443 c2 c4. c8 c4. c16[ c] c4. c8 c8 c8 c4 c4 c4
2444 @end lilypond
2445
2446
2447 En el @emph{Ensayo sobre grabado musical automatizado},
2448 se explicó que las
2449 direcciones de las plicas influyen en el espaciado
2450 (véase @ressay{Espaciado óptico}).  Esto se controla
2451 con la propiedad @code{stem-spacing-correction} en el objeto
2452 @rinternals{NoteSpacing}.  Estos se generan para cada uno de los
2453 contextos de @rinternals{Voice}.  El objeto @code{StaffSpacing}
2454 (generado en el contexto de @rinternals{Staff}) contiene la misma
2455 propiedad para controlar el espaciado de las líneas de plica o
2456 divisorias.  El ejemplo siguiente muestra estas correcciones, una vez
2457 con los valores predeterminados y otra con correcciones exageradas:
2458
2459 @lilypond[quote,ragged-right]
2460 {
2461   c'4 e''4 e'4 b'4 |
2462   b'4 e''4 b'4 e''4 |
2463   \override Staff.NoteSpacing #'stem-spacing-correction = #1.5
2464   \override Staff.StaffSpacing #'stem-spacing-correction = #1.5
2465   c'4 e''4 e'4 b'4 |
2466   b'4 e''4 b'4 e''4 |
2467 }
2468 @end lilypond
2469
2470 Está contemplada la notación proporcional; consulte
2471 @ref{Notación proporcional}.
2472
2473
2474 @seealso
2475 Fragmentos de código:
2476 @rlsr{Spacing}.
2477
2478 Referencia de funcionamiento interno:
2479 @rinternals{SpacingSpanner},
2480 @rinternals{NoteSpacing},
2481 @rinternals{StaffSpacing},
2482 @rinternals{NonMusicalPaperColumn}.
2483
2484
2485 @knownissues
2486
2487 No existe ningún mecanismo conveniente para sobreescribir el espaciado
2488 manualmente.  Se puede usar el siguiente rodeo para insertar espacio
2489 adicional en una partitura, ajustando el valor del relleno en la
2490 medida necesaria.
2491
2492 @example
2493  \override Score.NonMusicalPaperColumn #'padding = #10
2494 @end example
2495
2496 No existe ningún rodeo para disminuir la magnitud de la separación.
2497
2498
2499 @node Área de espaciado nueva
2500 @subsection Área de espaciado nueva
2501 @translationof New spacing area
2502
2503 Se pueden iniciar secciones nuevas con diferentes parámetros de
2504 espaciado, con @code{newSpacingSection}.  Esto es útil cuando hay
2505 secciones que tienen distinta noción de las notas largas y cortas.
2506
2507 En el ejemplo siguiente, el cambio de compás introduce una sección
2508 nueva, y por ello las semicorcheas se separan de manera más amplia.
2509
2510 @lilypond[relative=1,verbatim,quote]
2511 \time 2/4
2512 c4 c8 c
2513 c8 c c4 c16[ c c8] c4
2514 \newSpacingSection
2515 \time 4/16
2516 c16[ c c8]
2517 @end lilypond
2518
2519 La instrucción @code{\newSpacingSection} crea un nuevo objeto
2520 @code{SpacingSpanner}, y de ahí que se puedan usar nuevas
2521 instrucciones de sobreescritura @code{\override} en dicho punto.
2522
2523
2524 @seealso
2525 Fragmentos de código:
2526 @rlsr{Spacing}.
2527
2528 Referencia de funcionamiento interno:
2529 @rinternals{SpacingSpanner}.
2530
2531
2532 @node Cambiar el espaciado horizontal
2533 @subsection Cambiar el espaciado horizontal
2534 @translationof Changing horizontal spacing
2535
2536 Se puede alterar el espaciado horizontal con la propiedad
2537 @code{base-shortest-duration}.  Aquí compararemos la misma música, una
2538 vez sin alterar la propiedad, y luego alterándola.  Los valores
2539 mayores de @code{ly:make-moment} producen música más pequeña.  Observe
2540 que @code{ly:make-moment} construye una duración, por lo que @code{1
2541 4} es una duración mayor que @code{1 16}.
2542
2543 @lilypond[verbatim,line-width=12\cm]
2544 \score {
2545   \relative c'' {
2546     g4 e e2 | f4 d d2 | c4 d e f | g4 g g2 |
2547     g4 e e2 | f4 d d2 | c4 e g g | c,1 |
2548     d4 d d d | d4 e f2 | e4 e e e | e4 f g2 |
2549     g4 e e2 | f4 d d2 | c4 e g g | c,1 |
2550   }
2551 }
2552 @end lilypond
2553
2554 @lilypond[verbatim,line-width=12\cm]
2555 \score {
2556   \relative c'' {
2557     g4 e e2 | f4 d d2 | c4 d e f | g4 g g2 |
2558     g4 e e2 | f4 d d2 | c4 e g g | c,1 |
2559     d4 d d d | d4 e f2 | e4 e e e | e4 f g2 |
2560     g4 e e2 | f4 d d2 | c4 e g g | c,1 |
2561   }
2562   \layout {
2563     \context {
2564       \Score
2565       \override SpacingSpanner
2566         #'base-shortest-duration = #(ly:make-moment 1 16)
2567     }
2568   }
2569 }
2570 @end lilypond
2571
2572
2573 @snippets
2574
2575 De forma predeterminada, el espaciado en los grupos de valoración
2576 especial depende de varios factores ajenos a la duración (como
2577 alteraciones, cambios de clave, etc.).  Para pasar por alto estos
2578 símbolos y forzar un espaciado de duraciones iguales uniforme, use
2579 @code{Score.SpacingSpanner #'uniform-stretching}.  Esta propiedad sólo
2580 puede cambiarse al principio de la partitura:
2581
2582 @lilypond[quote,ragged-right,verbatim]
2583 \score {
2584   <<
2585     \new Staff {
2586       \times 4/5 {
2587         c8 c8 c8 c8 c8
2588       }
2589       c8 c8 c8 c8
2590     }
2591     \new Staff {
2592       c8 c8 c8 c8
2593       \times 4/5 {
2594         c8 c8 c8 c8 c8
2595       }
2596     }
2597   >>
2598   \layout {
2599     \context {
2600       \Score
2601       \override SpacingSpanner #'uniform-stretching = ##t
2602     }
2603   }
2604 }
2605 @end lilypond
2606
2607 Cuando se establece @code{strict-note-spacing}, las notas se separan
2608 sin tener en cuenta las claves, líneas divisorias ni notas de adorno:
2609
2610 @lilypond[quote,ragged-right,relative=2,verbatim]
2611 \override Score.SpacingSpanner #'strict-note-spacing = ##t
2612 \new Staff { c8[ c \clef alto c \grace { c16[ c] } c8 c c]  c32[ c32] }
2613 @end lilypond
2614
2615
2616 @seealso
2617 Fragmentos de código:
2618 @rlsr{Spacing}.
2619
2620
2621 @node Longitud de la línea
2622 @subsection Longitud de la línea
2623 @translationof Line length
2624
2625 @cindex saltos de página
2626 @cindex página, saltos de
2627
2628 @funindex indent
2629 @funindex line-width
2630 @funindex ragged-right
2631 @funindex ragged-last
2632
2633 @c Although line-width can be set in \layout, it should be set in paper
2634 @c block, to get page layout right.
2635 @c Setting indent in \paper block makes not much sense, but it works.
2636
2637 @c Bit verbose and vague, use examples?
2638 Los ajustes más básicos que influyen en el espaciado son @code{indent}
2639 y @code{line-width}.  Se definen en el bloque @code{\layout}.
2640 Controlan el sangrado de la primera línea de música y la longitud de
2641 las líneas.
2642
2643 Si se fija un valor verdadero para @code{ragged-right} en el bloque
2644 @code{\layout}, entonces los sistemas terminan en su longitud
2645 horizontal natural, en lugar de repartirse horizontalmente hasta
2646 llenar toda la línea.  Esto es útil para fragmentos cortos, y para
2647 comprobar qué tan apretado es el espaciado natural.
2648 El valor normal predeterminado es falso, pero si la partitura
2649 tiene un solo sistema, el valor predeterminado es verdadero.
2650
2651
2652 @cindex diseño de página
2653 @cindex página, disposición de la
2654 @cindex vertical, espaciado
2655
2656 La opción @code{ragged-last} es similar a @code{ragged-right}, pero
2657 afecta sólo a la última línea de la pieza.  No se efectúa ninguna
2658 restricción sobre dicha línea.  El resultado es similar al formateo de
2659 los párrafos de texto.  En un párrafo, la última línea sencillamente
2660 ocupa su longitud horizontal natural.
2661 @c Note that for text there are several options for the last line.
2662 @c While Knuth TeX uses natural length, lead typesetters use the same
2663 @c stretch as the previous line.  eTeX uses \lastlinefit to
2664 @c interpolate between both these solutions.
2665
2666 @example
2667 \layout @{
2668   indent = #0
2669   line-width = #150
2670   ragged-last = ##t
2671 @}
2672 @end example
2673
2674
2675 @seealso
2676 Fragmentos de código:
2677 @rlsr{Spacing}.
2678
2679
2680 @node Notación proporcional
2681 @subsection Notación proporcional
2682 @translationof Proportional notation
2683
2684 LilyPond contempla la notación proporcional, un tipo de espaciado
2685 horizontal en el que cada nota consume una medida horizontal que
2686 equivale exactamente a su duración rítmica.  Este tipo de espaciado
2687 proporcional es comparable al espaciado horizontal hecho sobre un
2688 papel milimetrado.  Ciertas partituras del finales del s.XX y
2689 principios del s.XXI utilizan notación proporcional para clarificar
2690 relaciones rítmicas complejas o para facilitar la colocación de líneas
2691 cronométricas u otros gráficos directamente en la partitura.
2692
2693 LilyPond contempla cinco ajustes distintos para la notación
2694 proporcional, que se pueden usar solos o combinados:
2695
2696 @itemize
2697 @item @code{proportionalNotationDuration}
2698 @item @code{uniform-stretching}
2699 @item @code{strict-note-spacing}
2700 @item @code{\remove Separating_line_group_engraver}
2701 @item @code{\override PaperColumn #'used = ##t}
2702 @end itemize
2703
2704 En los ejemplos que siguen, exploramos el uso de estos cinco ajustes
2705 de la notación proporcional y examinamos la forma en que interactúan.
2706
2707 Comenzamos con el siguiente ejemplo de un solo compás, que usa un
2708 espaciado clásico sin justificación por la derecha.
2709
2710 @lilypond[quote,verbatim,ragged-right]
2711 \score {
2712   <<
2713     \new RhythmicStaff {
2714       c'2
2715       c'16 c'16 c'16 c'16
2716       \times 4/5 {
2717         c'16 c'16 c'16 c'16 c'16
2718       }
2719     }
2720   >>
2721 }
2722 @end lilypond
2723
2724 Observe que la blanca que inicia el compás ocupa mucho menos de la
2725 mitad de todo el espacio horizontal del compás.  De forma similar, las
2726 semicorcheas y el cinquillo de semicorcheas con que finaliza el compás
2727 ocupan en conjunto mucho más de la mitad de todo el espacio horizontal
2728 del compás.
2729
2730 En el grabado clásico, este espaciado puede ser exactamente el que
2731 deseamos porque podemos tomar prestado el espacio horizontal de la
2732 blanca y conservar el espacio horizontal a lo largo del compás como un
2733 todo.
2734
2735 Por otro lado, si queremos insertar una línea de tiempo graduada o
2736 algún otro gráfico encima o debajo de la partitura, necesitamos la
2737 notación proporcional.  Se activa la notación proporcional con el
2738 ajuste @code{proportionalNotationDuration}.
2739
2740 @lilypond[quote,verbatim,ragged-right]
2741 \score {
2742   <<
2743     \new RhythmicStaff {
2744       c'2
2745       c'16 c'16 c'16 c'16
2746       \times 4/5 {
2747         c'16 c'16 c'16 c'16 c'16
2748       }
2749     }
2750   >>
2751  \layout {
2752     \context {
2753       \Score
2754       proportionalNotationDuration = #(ly:make-moment 1 20)
2755     }
2756   }
2757 }
2758 @end lilypond
2759
2760 La blanca al principio del compás y las notas rápidas de la segunda
2761 mitad del compás ocupan ahora cantidades iguales de espacio
2762 horizontal.  Podríamos colocar una línea de tiempo graduada o un
2763 gráfico encima o debajo de este ejemplo.
2764
2765 El ajuste @code{proportionalNotationDuration} es un ajuste de contexto
2766 que reside en @code{Score}.  Recordemos que los ajustes de contexto
2767 aparecen en uno de tres posibles lugares del archivo de entrada: en un
2768 bloque @code{\with}, en un bloque @code{\context}, o directamente
2769 entre la música precedido por la instrucción @code{\set}.  Como con
2770 todos los ajustes de contexto, el usuario puede elegir en cuál de los
2771 tres lugares diferentes prefiere establecer el valor de
2772 @code{proportionalNotationDuration}.
2773
2774 El ajuste @code{proportionalNotationDuration} acepta un solo
2775 argumento, que es la duración de referencia contra el que se aplica el
2776 espaciado de toda la música.  La función Scheme de LilyPond
2777 @code{make-moment} acepta dos argumentos: un numerador y un
2778 denominador que, juntos, expresan una cierta fracción de redonda.  La
2779 llamada @code{#(ly:make-moment 1 20)}, por tanto, produce una duración
2780 de referencia de una nota de un veinteavo de redonda (semicorcheas de
2781 cinquillo).  Son también posibles valores como
2782 @code{#(ly:make-moment 1 16)},
2783 @code{#(ly:make-moment 1 8)} y @code{#(ly:make-moment 3 97)}.
2784
2785 ¿Cómo seleccionamos la duración correcta de referencia para pasarla a
2786 @code{proportionalNotationDuration}?  Normalmente mediante un proceso
2787 de ensayo y error, comenzando con una duración cercana a la más rápida
2788 (o más breve) duración de la pieza.  Las duraciones de referencia más
2789 pequeñas aplican un espaciado más suelto; las duraciones de referencia
2790 más largas aplican un espaciado más apretado.
2791
2792 @lilypond[quote,verbatim,ragged-right]
2793 \score {
2794   <<
2795     \new RhythmicStaff {
2796       c'2
2797       c'16 c'16 c'16 c'16
2798       \times 4/5 {
2799         c'16 c'16 c'16 c'16 c'16
2800       }
2801     }
2802   >>
2803   \layout {
2804     \context {
2805       \Score
2806       proportionalNotationDuration = #(ly:make-moment 1 8)
2807     }
2808   }
2809 }
2810
2811 \score {
2812   <<
2813     \new RhythmicStaff {
2814       c'2
2815       c'16 c'16 c'16 c'16
2816       \times 4/5 {
2817         c'16 c'16 c'16 c'16 c'16
2818       }
2819     }
2820   >>
2821   \layout {
2822     \context {
2823       \Score
2824       proportionalNotationDuration = #(ly:make-moment 1 16)
2825     }
2826   }
2827 }
2828
2829 \score {
2830   <<
2831     \new RhythmicStaff {
2832       c'2
2833       c'16 c'16 c'16 c'16
2834       \times 4/5 {
2835         c'16 c'16 c'16 c'16 c'16
2836       }
2837     }
2838   >>
2839   \layout {
2840     \context {
2841       \Score
2842       proportionalNotationDuration = #(ly:make-moment 1 32)
2843     }
2844   }
2845 }
2846 @end lilypond
2847
2848 Observe que una duración de referencia demasiado grande (como la
2849 corchea, en el ejemplo de arriba) produce un espaciado excesivamente
2850 apretado y puede ser causa de colisiones entre las cabezas de nota.
2851 Observe también que la notación proporcional en general ocupa más
2852 espacio horizontal que el espaciado clásico.  El espaciado
2853 proporcional aporta claridad rítmica a expensas del espacio
2854 horizontal.
2855
2856 Ahora veremos cómo espaciar de forma óptima grupos de valoración
2857 especial que se superponen.
2858
2859 Empezamos por examinar qué le ocurre a nuestro ejemplo original, con
2860 espaciado clásico, cuando añadimos un segundo pentagrama con un tipo
2861 diferente de grupo especial.
2862
2863 @lilypond[quote,verbatim,ragged-right]
2864 \score {
2865   <<
2866     \new RhythmicStaff {
2867       c'2
2868       c'16 c'16 c'16 c'16
2869       \times 4/5 {
2870         c'16 c'16 c'16 c'16 c'16
2871       }
2872     }
2873     \new RhythmicStaff {
2874       \times 8/9 {
2875         c'8 c'8 c'8 c'8 c'8 c'8 c'8 c'8 c'8
2876       }
2877     }
2878   >>
2879 }
2880 @end lilypond
2881
2882 El espaciado es defectuoso porque las notas regularmente espaciadas
2883 del pentagrama inferior no se amplían de manera uniforme.  Los grabados
2884 clásicos incluyen muy pocos tresillos complejos y así las reglas del
2885 grabado clásico pueden generar este tipo de resultado.  El
2886 establecimiento de @code{proportionalNotationDuration} lo
2887 soluciona.
2888
2889 @lilypond[quote,verbatim,ragged-right]
2890 \score {
2891   <<
2892     \new RhythmicStaff {
2893       c'2
2894       c'16 c'16 c'16 c'16
2895       \times 4/5 {
2896         c'16 c'16 c'16 c'16 c'16
2897       }
2898     }
2899     \new RhythmicStaff {
2900       \times 8/9 {
2901         c'8 c'8 c'8 c'8 c'8 c'8 c'8 c'8 c'8
2902       }
2903     }
2904   >>
2905   \layout {
2906     \context {
2907       \Score
2908       proportionalNotationDuration = #(ly:make-moment 1 20)
2909     }
2910   }
2911 }
2912 @end lilypond
2913
2914
2915 Pero si observamos con mucho cuidado podremos ver que las notas de la
2916 segunda mitad del 9-illo están espaciadas de forma ligeramente más
2917 ancha que las de la primera mitad del 9-illo.  Para asegurar una
2918 ampliación uniforme, activamos @code{uniform-stretching}, que es una
2919 propiedad de @code{SpacingSpanner}.
2920
2921 @lilypond[quote,verbatim,ragged-right]
2922 \score {
2923   <<
2924     \new RhythmicStaff {
2925       c'2
2926       c'16 c'16 c'16 c'16
2927       \times 4/5 {
2928         c'16 c'16 c'16 c'16 c'16
2929       }
2930     }
2931     \new RhythmicStaff {
2932       \times 8/9 {
2933         c'8 c'8 c'8 c'8 c'8 c'8 c'8 c'8 c'8
2934       }
2935     }
2936   >>
2937   \layout {
2938     \context {
2939       \Score
2940       proportionalNotationDuration = #(ly:make-moment 1 20)
2941       \override SpacingSpanner #'uniform-stretching = ##t
2942     }
2943   }
2944 }
2945 @end lilypond
2946
2947 Nuestro ejemplo de dos pentagramas ahora está espaciado exactamente,
2948 nuestras relaciones rítmicas son visualmente claras, y podemos incluir
2949 una línea de tiempo graduada o un gráfico, si queremos.
2950
2951 Observe que el paquete de notación proporcional de LilyPond espera que
2952 todas las partituras proporcionales establezcan el atributo
2953 @code{uniform-stretching} de @code{SpacingSpanner} al valor ##t.  El
2954 establecimiento de @code{proportionalNotationDuration} sin ajustar
2955 también el atributo @code{uniform-stretching} de @code{SpacingSpanner}
2956 al valor ##t causará, por ejemplo, que los desplazamientos
2957 (@code{skips}) consuman una cantidad de espacio horizontal incorrecta.
2958
2959 El @code{SpacingSpanner} es un grob abstracto que reside en el
2960 contexto de @code{Score}. Como con nuestros ajustes de
2961 @code{proportionalNotationDuration}, las sobreescrituras al
2962 @code{SpacingSpanner} sólo pueden ocurrir en uno de estos tres lugares
2963 dentro del archivo de entrada: en el bloque @code{\with}, en el bloque
2964 @code{\context} o directamente dentro de la escritura de notas.
2965
2966 De manera predeterminada, sólo hay un @code{SpacingSpanner} por
2967 @code{Score}.  Esto supone que, por omisión, @code{uniform-stretching}
2968 está activado para la partitura completa o desactivado para la
2969 partitura completa.  Sin embargo, podemos sobreescribir este
2970 comportamiento y activar distintas posibilidades de espaciado en
2971 distintos lugares de la partitura.  Lo hacemos con la instrucción
2972 @code{\newSpacingSection}.  Consulte @ref{Área de espaciado nueva}
2973 para más información.
2974
2975 A continuación examinamos los efectos del grabador
2976 @code{Separating_line_group_engraver} y veremos por qué las partituras
2977 proporcionales con frecuencia eliminan este grabador.  El ejemplo
2978 siguiente muestra que hay una pequeña cantidad de espacio
2979 @qq{preparatorio} justo antes de la primera nota de cada sistema.
2980
2981 @lilypond[quote,verbatim,ragged-right]
2982 \paper {
2983   indent = #0
2984 }
2985
2986 \new Staff {
2987   c'1
2988   \break
2989   c'1
2990 }
2991 @end lilypond
2992
2993
2994 Esta cantidad de espacio preparatorio es la misma ya sea después de
2995 una indicación de compás, una armadura o una clave.  El grabador
2996 @code{Separating_line_group_engraver} es responsable de este espacio.
2997 La eliminación de @code{Separating_line_group_engraver} reduce este
2998 espacio a cero.
2999
3000 @lilypond[quote,verbatim,ragged-right]
3001 \paper {
3002   indent = #0
3003 }
3004
3005 \new Staff \with {
3006   \remove Separating_line_group_engraver
3007 } {
3008   c'1
3009   \break
3010   c'1
3011 }
3012 @end lilypond
3013
3014 Los elementos no musicales como la indicación de compás, la armadura,
3015 la clave y las alteraciones son problemáticos en notación
3016 proporcional.  Ninguno de estos elementos tiene duración rítmica.
3017 Pero todos ellos consumen espacio horizontal.  Las distintas
3018 partituras proporcionales abordan este problema de distinta manera.
3019
3020 Sería posible evitar los problemas de espaciado con las armaduras,
3021 simplemente evitando tenerlas.  Esta es una opción válida pues casi
3022 todas las partituras proporcionales son música contemporánea.  Lo
3023 mismo puede valer para las indicaciones de compás, especialmente para
3024 las partituras que incluyen una línea de tiempo graduada u otro
3025 gráfico.  Pero estas partituras son excepcionales y casi todas las
3026 partituras proporcionales incluyen al menos unas pocas indicaciones de
3027 compás.  Las claves y las alteraciones son aún más esenciales.
3028
3029 Así pues ¿qué estrategias existen para el espaciado de los elementos
3030 no musicales en un contexto proporcional?  Una buena opción es la
3031 propiedad @code{strict-note-spacing} de @code{SpacingSpanner}.
3032 Compare las dos partituras siguientes:
3033
3034 @lilypond[quote,verbatim,ragged-right]
3035 \new Staff {
3036   \set Score.proportionalNotationDuration = #(ly:make-moment 1 16)
3037   c''8
3038   c''8
3039   c''8
3040   \clef alto
3041   d'8
3042   d'2
3043 }
3044
3045 \new Staff {
3046   \set Score.proportionalNotationDuration = #(ly:make-moment 1 16)
3047   \override Score.SpacingSpanner #'strict-note-spacing = ##t
3048   c''8
3049   c''8
3050   c''8
3051   \clef alto
3052   d'8
3053   d'2
3054 }
3055 @end lilypond
3056
3057 Las dos partituras son proporcionales, pero el espaciado de la
3058 primera es muy suelto a causa del cambio de clave. Sin embargo, el
3059 espaciado de la segunda partitura se mantiene estricto, porque
3060 @code{strict-note-spacing} está activado.  La activación de
3061 @code{strict-note-spacing} hace que el ancho de las indicaciones de
3062 compás, armaduras, cambios de clave y alteraciones no tomen parte en
3063 el algoritmo de espaciado.
3064
3065 Además de los ajustes dados aquí, hay otros que aparecen con
3066 frecuencia en las partituras proporcionales.  Entre ellos están:
3067
3068 @itemize
3069 @item @code{\override SpacingSpanner #'strict-grace-spacing = ##t}
3070 @item @code{tupletFullLength = ##t}
3071 @item @code{\override Beam #'breakable = ##t}
3072 @item @code{\override Glissando #'breakable = ##t}
3073 @item @code{\override TextSpanner #'breakable = ##t}
3074 @item @code{\remove Forbid_line_break_engraver in the Voice context}
3075 @end itemize
3076
3077 Estos ajustes dan a las notas de adorno un espaciado estricto,
3078 extienden los corchetes de grupo especial para que marquen tanto los
3079 puntos de comienzo como de final, y permiten que los elementos de
3080 extensión se dividan entre los sistemas y las páginas.  Consulte las
3081 partes respectivas del manual para ver estos ajustes relacionados.
3082
3083
3084 @seealso
3085 Referencia de la notación:
3086 @ref{Área de espaciado nueva}.
3087
3088 Fragmentos de código:
3089 @rlsr{Spacing}.
3090
3091
3092 @node Encajar la música en menos páginas
3093 @section Encajar la música en menos páginas
3094 @translationof Fitting music onto fewer pages
3095
3096 En ocasiones, podemos terminar con uno o dos pentagramas en una
3097 segunda página (o tercera, o cuarta...).  Es fastidioso, especialmente
3098 cuando vemos que las páginas anteriores parecen tener espacio de
3099 sobra.
3100
3101 Al investigar los problemas de disposición, una herramienta de valor
3102 incalculable es @code{annotate-spacing}.  Esta instrucción imprime los
3103 valores de un cierto número de variables de espaciado; para ver más
3104 detalles consulte la sección siguiente, @ref{Mostrar el espaciado}.
3105
3106 @menu
3107 * Mostrar el espaciado::
3108 * Cambiar el espaciado::
3109 @end menu
3110
3111
3112 @node Mostrar el espaciado
3113 @subsection Mostrar el espaciado
3114 @translationof Displaying spacing
3115
3116 @cindex espaciado, presentación del
3117 @funindex annotate-spacing
3118
3119 Para presentar gráficamente las dimensiones de las variables de
3120 disposición vertical que pueden verse alteradas por el formato de la
3121 página, establezca @code{annotate-spacing} en el bloque @code{\paper}:
3122
3123 @c need to have \book{} otherwise we get the separate systems. -hwn
3124 @lilypond[verbatim,quote]
3125 #(set-default-paper-size "a6" 'landscape)
3126 \book {
3127   \score { { c4 } }
3128   \paper { annotate-spacing = ##t }
3129 }
3130 @end lilypond
3131
3132
3133 @noindent
3134 Todas las dimensiones de disposición se muestran en espacios de
3135 pentagrama, independientemente de las unidades especificadas en los
3136 bloques @code{\paper} o @code{\layout}. En el ejemplo anterior,
3137 @code{paper-height} tiene un valor de 59.75 @code{staff-spaces}
3138 (espacios de pentagrama), y el @code{staff-size} (tamaño del
3139 pentagrama) es de 20 puntos, el valor predeterminado. Observe que:
3140
3141 @multitable {1 staff-space} {staff-size)/4 * (25.4/72.27) mm}
3142
3143 @item 1 punto
3144 @tab = (25.4/72.27) mm
3145
3146 @item 1 staff-space
3147 @tab = (@code{staff-size})/4 pts
3148 @item
3149 @tab = (@code{staff-size})/4 * (25.4/72.27) mm
3150
3151 @end multitable
3152
3153 @noindent
3154 En este caso, un @code{staff-space} equivale aproximadamente a
3155 1.757mm.  Así, la medida @code{paper-height} de 59.75
3156 @code{staff-spaces} equivale a 105 milímetros, la altura de una hoja
3157 @code{a6} en orientación apaisada.  Las parejas (@var{a},@var{b}) son
3158 intervalos, donde @var{a} es el límite inferior y @var{b} es el límite
3159 superior del intervalo.
3160
3161
3162 @seealso
3163 Referencia de la notación:
3164 @ref{Establecer el tamaño del pentagrama}.
3165
3166 Fragmentos de código:
3167 @rlsr{Spacing}.
3168
3169
3170 @node Cambiar el espaciado
3171 @subsection Cambiar el espaciado
3172 @translationof Changing spacing
3173
3174 La salida de @code{annotate-spacing} revela las dimensiones verticales
3175 con gran detalle.  Para ver más detalles acerca de la modificación de
3176 los márgenes y otras variables de diseño de la página, consulte
3177 @ref{Formateo de las páginas}.
3178
3179 Aparte de los márgenes, hay algunas otras opciones para ahorrar espacio:
3180
3181 @itemize
3182 @item
3183 Forzar los sistemas para que se junten lo más posible entre sí (de
3184 forma que quepan la mayor cantidad de ellos en la página) y al mismo
3185 tiempo estén espaciados de forma que no exista un espacio vacío en la
3186 parte baja del papel.
3187
3188 @example
3189 \paper @{
3190   system-system-spacing = #'((padding . 0) (space . 0.1))
3191   ragged-last-bottom = ##f
3192   ragged-bottom = ##f
3193 @}
3194 @end example
3195
3196 @item
3197 Forzar el número de sistemas.  Puede ser de utilidad de dos formas.
3198 Si tan sólo se establece un valor, incluso el mismo valor que el
3199 número de sistemas que se están trazando de forma predeterminada, ello
3200 ocasionará a veces que se traten de introducir más sistemas en cada
3201 página, pues en este caso se omite un paso en que se produce una
3202 estimación, dando así un encaje mejor en cada página.  Asimismo, el
3203 forzar una reducción neta en el número de sistemas puede producir el
3204 ahorro de una página adicional.  Por ejemplo, si la disposición
3205 predeterminada tiene 11 sistemas, la asignación siguiente fuerza una
3206 disposición con 10 sistemas.
3207
3208 @example
3209 \paper @{
3210   system-count = #10
3211 @}
3212 @end example
3213
3214 @item
3215 Evitar (o reducir en número) los objetos que aumentan el tamaño
3216 vertical de un sistema.  Por ejemplo, las repeticiones de primera y
3217 segunda vez (o repeticiones con finales alternativos) necesitan
3218 espacio adicional.  Si estas repeticiones se reparten a lo largo de
3219 dos sistemas, ocupan más espacio que un sistema con las casillas de
3220 repetición y otro sistema sin ellas.  Por ejemplo, las indicaciones
3221 dinámicas que se @q{salen} de un sistema se pueden acercar al
3222 pentagrama:
3223
3224 @lilypond[verbatim,quote,relative=1]
3225 e4 c g\f c
3226 e4 c g-\tweak #'X-offset #-2.7 -\tweak #'Y-offset #2.5 \f c
3227 @end lilypond
3228
3229 @item
3230 Alterar el espaciado horizontal por medio de @code{SpacingSpanner}.
3231 Para ver más detalles, consulte @ref{Cambiar el espaciado horizontal}.
3232 El ejemplo siguiente ilustra el espaciado predeterminado:
3233
3234 @lilypond[verbatim,quote]
3235 \score {
3236   \relative c'' {
3237     g4 e e2 |
3238     f4 d d2 |
3239     c4 d e f |
3240     g4 g g2 |
3241     g4 e e2 |
3242   }
3243 }
3244 @end lilypond
3245
3246 @noindent
3247 El ejemplo siguiente modifica @code{common-shortest-duration} de un
3248 valor de @code{1/4} (negra) a @code{1/2} (blanca).  La negra es la
3249 nota más común y la más breve del ejemplo, por lo que al agrandar esta
3250 duración se produce un efecto de @q{apretujamiento}:
3251
3252 @lilypond[verbatim,quote]
3253 \score {
3254   \relative c'' {
3255     g4 e e2 |
3256     f4 d d2 |
3257     c4 d e f |
3258     g4 g g2 |
3259     g4 e e2 |
3260   }
3261   \layout {
3262     \context {
3263       \Score
3264       \override SpacingSpanner
3265         #'common-shortest-duration = #(ly:make-moment 1 2)
3266     }
3267   }
3268 }
3269 @end lilypond
3270
3271 @noindent
3272 La propiedad @code{common-shortest-duration} no se puede modificar de
3273 manera dinámica, por lo que se debe situar siempre dentro de un
3274 bloque @code{\context} de forma que se aplique a la partitura
3275 completa.
3276
3277 @end itemize
3278
3279
3280 @seealso
3281 Referencia de la notación:
3282 @ref{Formateo de las páginas},
3283 @ref{Cambiar el espaciado horizontal}.
3284
3285 Fragmentos de código:
3286 @rlsr{Spacing}.