@c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
@ignore
- Translation of GIT committish: b446ebc24f8d43acb323818988fe8b1d8072afc8
+ Translation of GIT committish: 5e9d7b07e1da12e32ae7be0253b22cb28cf2fe58
When revising a translation, copy the HEAD committish of the
version that you are working on. For details, see the Contributors'
Guide, node Updating translation committishes..
@end ignore
-@c \version "2.13.39"
+@c \version "2.14.0"
@node Problemas de espaciado
@chapter Problemas de espaciado
que ni el espaciado horizontal ni el vertical estén demasiado
estrechos ni estirados.
-Los ajustes que influyen en la disposición se pueden agrupar en dos
-bloques. El bloque @code{\paper @{...@}} se sitúa fuera de los
-bloques @code{\score @{...@}} y contiene ajustes relacionados con el
-documento como un todo. El bloque @code{\layout @{...@}} se sitúa
-dentro de un bloque @code{\score @{...@}} y contiene ajustes para
-dicha partitura en concreto. Si sólo tiene un bloque @code{\score
-@{...@}}, los dos tienen el mismo efecto. En general las
-instrucciones que se muestran en este capítulo se pueden poner en
-cualquiera de los dos.
+Hay dos tipos de bloques que pueden contener ajustes de disposición:
+@code{\paper @{@dots{}@}} y @code{\layout @{@dots{}@}}. El bloque
+@code{\paper} contiene ajustes de disposición de la página que se
+espera sean los mismos para todas las partituras de un libro, como la
+altura de la hoja o si se imprimen los números de página, etc. Véase
+@ref{Disposición de la página}. El bloque @code{\layout} contiene
+ajustes de disposición de la partitura, como el número de sistemas que
+utilizar, o la separación entre grupos de pentagramas, etc. Véase
+@ref{Disposición de la partitura}.
@menu
-* El papel y las páginas::
-* Disposición de la música::
+* Disposición de la página::
+* Disposición de la partitura::
* Saltos::
* Espaciado vertical::
* Espaciado horizontal::
@end menu
-@node El papel y las páginas
-@section El papel y las páginas
-@translationof Paper and pages
+@node Disposición de la página
+@section Disposición de la página
+@translationof Page layout
-Esta sección se ocupa de los límites que definen la zona del papel en
-que se puede imprimir la música.
+Esta sección estudia las opciones de disposición de la página para el
+bloque @code{\paper}.
@menu
-* Tamaño del papel::
-* Formateo de las páginas::
+* El bloque \paper::
+* Tamaño del papel y escalado automático::
+* Variables de espaciado de \paper verticales fijas::
+* Variables de espaciado de \paper verticales flexibles::
+* Variables de espaciado de \paper horizontales::
+* Otras variables de \paper::
@end menu
-@node Tamaño del papel
-@subsection Tamaño del papel
-@translationof Paper size
+@node El bloque \paper
+@subsection El bloque @code{\paper}
+@translationof The \paper block
+
+El bloque @code{\paper} puede aparecer dentro de un bloque
+@code{\book}, pero no dentro de un bloque @code{\score}. Los ajustes
+de un bloque @code{\paper} se aplican a todo el libro, que puede
+comprender varias partituras. Entre los ajustes que pueden aparecer
+dentro de un bloque @code{\paper} están los siguientes:
+
+@itemize
+
+@item
+la función de Scheme @code{set-paper-size},
+
+@item
+variables de @code{\paper} utilizadas para personalizar la disposición
+de la página, y
+
+@item
+definiciones de marcado utilizadas para personalizar la disposición de
+los encabezamientos, pies y títulos.
+
+@end itemize
+
+La función @code{set-paper-size} se estudia en la sección siguiente,
+@ref{Tamaño del papel y escalado automático}. Las variables de
+@code{\paper} variables que se ocupan de la disposición de la página
+se estudian en secciones posteriores. Las definiciones de elementos
+de marcado que se encargan de los encabezamientos, pies y títulos se
+estudian en @ref{Encabezamientos pies y títulos personalizados}.
+
+Casi todas las variables de @code{\paper} funcionan solamente dentro
+de un bloque @code{\paper}. Las pocas que funcionan también en un
+bloque @code{\layout} están relacionadas en @ref{El bloque \layout}.
+
+Excepto cuando se especifica lo contrario, todas las variables de
+@code{\paper} que corresponden a distancias sobre la página se miden
+en milímetros, a no ser que se especifiquen unas unidades diferentes
+por parte del usuario. Por ejemplo, la declaración siguiente
+establece el margen superior @code{top-margin} a diez milímetros:
+
+@example
+\paper @{
+ top-margin = 10
+@}
+@end example
+
+Para fijarlo en @code{0.5} pulgadas, utilice el sufijo de unidades
+@code{\in}:
+
+@example
+\paper @{
+ top-margin = 0.5\in
+@}
+@end example
+
+Los sufijos de unidades que están disponibles son @code{\mm},
+@code{\cm}, @code{\in} y @code{\pt}. Estas unidades son valores
+simples para convertir a partir de milímetros; están definidos en
+@file{ly/paper-defaults-init.ly}. Por claridad, al usar milímetros,
+se suele escribir el sufijo @code{\mm} aunque no es necesario
+técnicamente.
+
+También es posible definir valores de @code{\paper} utilizando Scheme.
+El equivalente de Scheme del ejemplo anterior es:
+
+@example
+\paper @{
+ #(define top-margin (* 0.5 in))
+@}
+@end example
+
+@seealso
+Referencia de la notación:
+@ref{Tamaño del papel y escalado automático},
+@ref{Encabezamientos pies y títulos personalizados},
+@ref{El bloque \layout}.
+
+Archivos instalados:
+@file{ly/paper-defaults-init.ly}.
+
+
+@node Tamaño del papel y escalado automático
+@subsection Tamaño del papel y escalado automático
+@translationof Paper size and automatic scaling
+
+@cindex tamaño del papel
+@cindex tamaño de la página
+
+@funindex \paper
+
+@menu
+* Fijar el tamaño del papel::
+* Escalado automático al tamaño del papel::
+@end menu
+
-@cindex papel, tamaño del
-@cindex página, tamaño de la
+@node Fijar el tamaño del papel
+@unnumberedsubsubsec Fijar el tamaño del papel
+@translationof Setting paper size
Existen dos funciones para cambiar el tamaño del papel:
@code{set-default-paper-size} (establecer tamaño de página
@end example
@noindent
+Dentro del ámbito del nivel jerárquico superior, se puede llamar sin
+riesgo a la función @code{set-default-paper-size} desde cualquier
+lugar antes del primer bloque @code{\paper} block. Dentro de un
+bloque @code{\paper}, el lugar más seguro para llamar a
+@code{set-paper-size} es al principio, por encima de la lista de
+declaraciones de variables. Se explican las razones de esto en
+@ref{Escalado automático al tamaño del papel}.
+
@code{set-default-paper-size} establece el tamaño de todas las
páginas, mientras que @code{set-paper-size} establece sólo el tamaño
de las páginas a las que se aplica el bloque @code{\paper}. Por
ellos @code{a4}, @code{letter}, @code{legal} y @code{11x17} (conocido
también como tabloide). Están contemplados muchos más tamaños de papel
de forma predeterminada. Para ver más detalles, consulte
-@file{scm/@/paper@/.scm} y busque la definición de @code{paper-alist}.
+@file{scm/paper.scm} y busque la definición de @code{paper-alist}.
@c TODO add a new appendix for paper sizes (auto-generated) -pm
@warning{El tamaño predeterminado del papel es @code{a4}.}
Se pueden añadir tamaños adicionales editando la definición de
-@code{paper-alist} en el archivo de inicio @file{scm/@/paper@/.scm},
+@code{paper-alist} en el archivo de inicio @file{scm/paper.scm},
aunque se sobreescribirán en la siguiente reinstalación del programa.
@cindex orientación
#(set-default-paper-size "a6" 'landscape)
@end example
-Al establecer el tamaño del papel se ajustan un cierto número de
-variables del @code{\paper}, tales como los márgenes. Para utilizar
-un tamaño de página determinado con variables de @code{\paper}
-alteradas, establezca el tamaño de página antes de dar valores a las
-variables.
+@seealso
+Referencia de la notación:
+@ref{Escalado automático al tamaño del papel}.
+Archivos instalados:
+@file{scm/paper.scm}.
+
+
+@node Escalado automático al tamaño del papel
+@unnumberedsubsubsec Escalado automático al tamaño del papel
+@translationof Automatic scaling to paper size
+
+Si se cambia el tamaño del papel con una de las funciones de Scheme
+(@code{set-default-paper-size} o @code{set-paper-size}), los valores
+de algunas variables de @code{\paper} se escalan automáticamente al
+nuevo tamaño. Para sortear el escalado automático para una variable
+determinada, fije el valor de la variable después de establecer el
+tamaño del papel. Observe que el escalado automático no se activa
+mediante el ajuste de las variables
+@code{paper-height} o de @code{paper-width},
+incluso aunque @code{paper-width} puede influir sobre otros valores
+(esto es distinto al escalado y se estudia más abajo). Las funciones
+@code{set-default-paper-size} y @code{set-paper-size} se describen en
+@ref{Fijar el tamaño del papel}.
+
+Las dimensiones verticales afectadas por el escalado automático son
+@code{top-margin} y @code{bottom-margin}
+(véase @ref{Variables de espaciado de \paper verticales fijas}).
+Las dimensiones
+horizontales afectadas por el escalado automático son
+@code{left-margin}, @code{right-margin}, @code{inner-margin},
+@code{outer-margin}, @code{binding-offset}, @code{indent} y
+@code{short-indent} (véase
+@ref{Variables de espaciado de \paper horizontales}).
+
+Los valores predeterminados para estas dimensiones están fijados en el
+archivo @file{ly/paper-defaults-init.ly}, usando variables internas
+llamadas @code{top-margin-default}, @code{bottom-margin-default}, etc.
+Estos son los valores que resultan del tamaño predeterminado del papel
+@code{a4}. Como referencia, con el papel @code{a4} la altura
+@code{paper-height} es @code{297\mm} y la anchura @code{paper-width}
+es @code{210\mm}.
@seealso
-Archivos instalados:
-@file{scm/@/paper@/.scm}.
+Referencia de la notación:
+@ref{Variables de espaciado de \paper verticales fijas},
+@ref{Variables de espaciado de \paper horizontales}.
-Fragmentos de código:
-@rlsr{Spacing}.
+Archivos de inicio:
+@file{ly/paper-defaults-init.ly},
+@file{scm/paper.scm}.
-@node Formateo de las páginas
-@subsection Formateo de las páginas
-@translationof Page formatting
+@node Variables de espaciado de \paper verticales fijas
+@subsection Variables de espaciado de @code{\paper} verticales fijas
+@translationof Fixed vertical spacing \paper variables
-@funindex \paper
+@warning{Algunas dimensiones de @code{@bs{}paper} se escalan
+automáticamente al tamaño del papel, lo que puede llevar a un
+comportamiento no esperado. Véase @ref{Escalado automático al tamaño
+del papel}.}
-Los márgenes, encabezamientos y pies de página y otras variables de
-diseño de página se establecen automáticamente de acuerdo con el
-tamaño del papel.
+Los valores predeterminados (previos al escalado) están definidos en
+el archivo @file{ly/paper-defaults-init.ly}.
-El valor predeterminado de los márgenes está accesible en el archivo
-@file{ly/@/paper@/-defaults@/-init@/.ly}. Estos valores se aplican al
-tamaño predeterminado del papel (A4, a no ser que se especifique de
-otra forma) y se escalan adecuadamente para otros tamaños del papel.
+@table @code
+@item paper-height (altura del papel)
+@funindex paper-height
-Esta sección relaciona y describe cierto número de variables del papel
-que se pueden alterar.
+Altura de la página, no fijada de forma predeterminada. Observe que
+el escalado automático de algunas dimensiones verticales no resulta
+afectado por esto.
-@menu
-* Dimensiones verticales fijas::
-* Dimensiones verticales flexibles::
-* Dimensiones horizontales::
-* Otras variables de diseño de página::
-@end menu
+@item top-margin (margen superior)
+@funindex top-margin
+Margen entre el extremo superior de la página y la parte superior de
+la zona imprimible. Si se modifica el tamaño del papel, el valor
+predeterminado de esta dimensión se escala de acuerdo con ello.
-@node Dimensiones verticales fijas
-@unnumberedsubsubsec Dimensiones verticales fijas
-@translationof Fixed vertical dimensions
+@item bottom-margin (margen inferior)
+@funindex bottom-margin
-@table @code
-@item paper-height
-@funindex paper-height
+Margen entre la parte inferior de la zona imprimible y el extremo
+inferior de la página. Si se modifica el tamaño del papel, se escala
+de acuerdo con ello el valor predeterminado de esta dimensión.
-Altura de la página. Valor predeterminado: altura del tamaño actual
-del papel. Para ver más detalles, consulte @ref{Tamaño del papel}.
+@item ragged-bottom (sin justificar por abajo)
+@funindex ragged-bottom
-@item top-margin
-@funindex top-margin
+Si se fija al valor verdadero, los sistemas no se reparten
+verticalmente hasta abajo de la página. Esto no afecta a la última
+página. Se debe fijar a verdadero para piezas que sólo tienen dos o
+tres sistemas por página, como por ejemplo las partituras orquestales.
-Margen entre el extremo superior de la página y la parte superior del
-área imprimible. Valor predeterminado: @code{5\mm}.
+@item ragged-last-bottom (sin justificar la última por abajo)
+@funindex ragged-last-bottom
-@item bottom-margin
-@funindex bottom-margin
+Si se establece al valor falso, los sistemas se reparten verticalmente
+hasta abajo de la última página. Las piezas que llenan sobradamente
+dos o más páginas deben tener este valor fijado a verdadero. También
+afecta a la última página de las partes de libro, es decir, partes de
+un libro creadas con bloques @code{\bookpart}.
-Margen entre el extremo inferior del área imprimible y la parte
-inferior de la página. Valor predeterminado: @code{6\mm}.
@end table
+@seealso
+Referencia de la notación:
+@ref{Escalado automático al tamaño del papel}.
+
+Archivos de inicio:
+@file{ly/paper-defaults-init.ly}.
+
+Fragmentos de código:
+@rlsr{Spacing}.
+
+@knownissues
-@node Dimensiones verticales flexibles
-@unnumberedsubsubsec Dimensiones verticales flexibles
-@translationof Flexible vertical dimensions
+Los títulos (extraídos del bloque @code{\header}) se tratan como
+sistemas, así pues @code{ragged-bottom} y @code{ragged-last-bottom}
+aumentan la separación entre los títulos y el primer sistema de la
+partitura.
+
+
+@node Variables de espaciado de \paper verticales flexibles
+@subsection Variables de espaciado de @code{\paper} verticales flexibles
+@translationof Flexible vertical spacing \paper variables
En casi todos los casos es preferible que las distancias verticales
entre ciertos elementos (como márgenes, títulos, sistemas y las
sección no controlan el espaciado de los pentagramas que están dentro
de los sistemas individuales. El espaciado dentro de los sistemas se
controla por medio de propiedades de grob, con ajustes que se escriben
-normalmente dentro de un bloque @code{\score} o @code{layout},
-y no dentro del bloque @code{\paper}
+normalmente dentro de un bloque @code{\score} o @code{\layout}, y no
+dentro del bloque @code{\paper}.
Véase @ref{Espaciado vertical flexible dentro de los sistemas}.
+@menu
+* Estructura de las listas-A de espaciado vertical flexible::
+* Lista de variables de espaciado de \paper verticales flexibles::
+@end menu
+
-@subsubheading Esctructura de las listas-A de espaciado para las variables de @code{\paper}
+@node Estructura de las listas-A de espaciado vertical flexible
+@unnumberedsubsubsec Estructura de las listas-A de espaciado vertical flexible
+@translationof Structure of flexible vertical spacing alists
-Cada una de estas variables es una lista-A (lista asociativa) que
-contiene cuatro @emph{claves}:
+Cada una de las variables de espaciado de @code{\paper} flexibles es
+una lista-A (lista asociativa) que contiene cuatro @emph{claves}:
@itemize
-@item @code{padding} (relleno):
-mínimo espacio vertical vacío necesario entre dos elementos, medido en
-espacios de pentagrama. Se puede pensar como la altura mínima de un
-rectángulo invisible que abarca desde el punto más a la izquierda
-hasta el situado más a la derecha de los elementos combinados.
-
-@item @code{space} (espacio):
-distancia vertical predeterminada, medida en espacios de pentagrama,
-entre los @emph{puntos de referencia} de los dos elementos, cuando no
-resulte ninguna colisión, y no se produzca ninguna ampliación o
-compresión. El punto de referencia de un elemento de marcado (de
-título o del nivel jerárquico superior) es su punto más alto, y el
-punto de referencia de un sistema es el centro vertical del
-@code{StaffSymbol} más cercano
-(incluso si se trata de una línea que no es un pentagrama, como
-un contexto @code{Lyrics}).
-Los valores de @code{space} menores de @code{padding} o
-de @code{minimum-distance} no son significativos, porque la distancia
-resultante nunca será menor de @code{padding} o de
+
+@item
+@code{basic-distance} (distancia básica):
+distancia vertical, medida en espacios de pentagrama, entre los
+@emph{puntos de referencia} de los dos elementos, cuando no resulte
+ninguna colisión, y no se produzca ninguna ampliación o compresión.
+El punto de referencia de un elemento de marcado (de título o del
+nivel jerárquico superior) es su punto más alto, y el punto de
+referencia de un sistema es el centro vertical del @code{StaffSymbol}
+más cercano (incluso si se trata de una línea que no es un pentagrama,
+como un contexto @code{Lyrics}). Los valores de @code{distancia básica} menores
+de @code{padding} o de @code{minimum-distance} no son significativos,
+porque la distancia resultante nunca será menor de @code{padding} o de
@code{minimum-distance}.
-@item @code{minimum-distance} (distancia mínima):
-la distancia vertical mínima requerida, medida en espacios de
+@item
+@code{minimum-distance} (distancia mínima):
+la distancia vertical mínima permitida, medida en espacios de
pentagrama, entre los puntos de referencia de los dos elementos,
cuando se produce una compresión. Los valores de
@code{minimum-distance} menores de @code{padding} no son
significativos, porque la distancia resultante nunca será menor de
@code{padding}.
-@item @code{stretchability} (ampliabilidad):
+@c TODO: explain skylines somewhere and xref to it from here.
+
+@item
+@code{padding} (relleno):
+mínimo espacio vertical vacío necesario entre los rectángulos
+circundantes (o las líneas de horizonte) de los dos elementos,
+medido en espacios de pentagrama.
+
+@item
+@code{stretchability} (ampliabilidad):
medida sin unidades de la propensión relativa de esta dimensión a
ampliarse. Si es cero, la distancia no se ampliará (a no ser que
resultasen colisiones). Si es positiva, la significación del valor de
Los valores deben ser no negativos y finitos. El valor @code{+inf.0}
desencadena un error de programación y se ignora, pero se puede usar
@code{1.0e7} para un muelle casi infinitamente ampliable. Si no se
-fija un valor, el valor predeterminado se establece a @code{space}.
+fija un valor, el valor predeterminado se establece a @code{basic-distance}.
Observe que la propensión de la dimensión a @emph{comprimirse} no se
puede establecer directamente por el usuario y es igual a
-(@code{space}@tie{}@minus{}@tie{}@code{minimum-distance}).
+(@code{basic-distance}@tie{}@minus{}@tie{}@code{minimum-distance}).
+
@end itemize
Si una página tiene un margen inferior no justificado, la distancia
resultante es la mayor de:
@itemize
-@item @code{space},
-@item @code{minimum-distance}, y
-@item @code{padding} más la menor distancia necesaria para eliminar las colisiones.
+
+@item
+@code{basic-distance},
+
+@item
+@code{minimum-distance}, y
+
+@item
+@code{padding} más la menor distancia necesaria
+para eliminar las colisiones.
+
@end itemize
Los métodos específicos para la modificación de las listas-A se
-estudian en @ref{Modificación de las listas-A}. Las variables de
-dimensión de @code{\paper} verticales flexibles sólo se pueden fijar
-dentro de un bloque @code{\paper}.
-
-El siguiente ejemplo muestra las
-dos formas en que pueden modificarse estas listas-A. La primera
-declaración actualiza un par clave-valor individualmente,
-y la segunda redefine la variable completamente:
+estudian en @ref{Modificación de las listas-A}. El siguiente ejemplo
+muestra las dos formas en que pueden modificarse estas listas-A. La
+primera declaración actualiza un par clave-valor individualmente, y la
+segunda redefine la variable completamente:
@example
\paper @{
- system-system-spacing #'space = #8
-
+ system-system-spacing #'basic-distance = #8
score-system-spacing =
- #'((padding . 1)
- (space . 12)
+ #'((basic-distance . 12)
(minimum-distance . 6)
+ (padding . 1)
(stretchability . 12))
@}
@end example
-Los ajustes predeterminados de inicio para estas variables están
-definidos en el archivo @file{ly/@/paper@/-defaults@/-init@/.ly}.
-
-@subsubheading Variables de dimensión de @code{\paper} verticales flexibles
+@node Lista de variables de espaciado de \paper verticales flexibles
+@unnumberedsubsubsec Lista de variables de espaciado de @code{\paper} verticales flexibles
+@translationof List of flexible vertical spacing \paper variables
Los nombres de estas variables siguen el formato
@code{@var{superior}-@var{inferior}-spacing}, donde
@code{@var{superior}} e @code{@var{inferior}} son los elementos que
van a ser espaciados. Cada distancia se mide entre los puntos de
-referencia de los dos elementos
-(véase más arriba la descripción de la estructura de la lista-A).
-Observe que en estos nombres de variable, el término
-@q{@code{markup}} se refiere tanto a @emph{elementos de marcado de
-título} (@code{bookTitleMarkup} o @code{scoreTitleMarkup}) como a
-@emph{elementos de marcado del nivel superior} (véase @ref{Estructura
-del archivo}).
+referencia de los dos elementos (véase más arriba la descripción de la
+estructura de la lista-A). Observe que en estos nombres de variable,
+el término @q{@code{markup}} se refiere tanto a @emph{elementos de
+marcado de título} (@code{bookTitleMarkup} o @code{scoreTitleMarkup})
+como a @emph{elementos de marcado del nivel superior} (véase
+@ref{Estructura del archivo}). Todas las distancias se miden en
+espacios de pentagrama.
+
+Los ajustes predeterminados están definidos en el archivo
+@file{ly/paper-defaults-init.ly}.
+
+@c TODO: Where do headers/footers fit in? -mp
@table @code
@item markup-system-spacing
hay ningún sistema entre los dos.
@end table
+@seealso
+Referencia de la notación:
+@ref{Espaciado vertical flexible dentro de los sistemas}.
-@snippets
+Archivos de inicio:
+@file{ly/paper-defaults-init.ly}.
-El encabezamiento y el pie se crean por parte de las funciones
-@code{make-footer} y @code{make-header}, definidas dentro de
-@code{\paper}. Las implementaciones predeterminadas están en
-@file{ly/@/paper@/-defaults@/.ly} y en @file{ly/@/titling@/-init@/.ly}.
+Fragmentos de código:
+@rlsr{Spacing}.
-El diseño de la página en sí está realizado por dos funciones dentro
-del bloque @code{\paper}, @code{page-music-height} y
-@code{page-make-stencil}. El primero informa al algoritmo de saltos
-de línea de la cantidad de espacio que está disponible en una página,
-y el último crea la propia página dado el sistema que poner sobre
-ella.
-Se pueden definir valores del bloque @code{\paper} en Scheme. En tal
-caso, @code{mm}, @code{in}, @code{pt}, y @code{cm} son variables que
-están definidas en @file{paper@/-defaults@/.ly} con valores en milímetros.
-Por ello el valor @w{@code{2 cm}} se debe multiplicar en el siguiente
-ejemplo:
+@node Variables de espaciado de \paper horizontales
+@subsection Variables de espaciado de \paper horizontales
+@translationof Horizontal spacing \paper variables
-@example
-\paper @{
- #(define bottom-margin (* 2 cm))
-@}
-@end example
+@warning{Algunas dimensiones de @code{@bs{}paper} se escalan
+automáticamente al tamaño del papel, lo que puede dar lugar a un
+comportamiento distinto al esperado. Véase
+@ref{Escalado automático al tamaño del papel}.}
+@menu
+* Variables de \paper para la anchura y los márgenes::
+* Variables de \paper para el modo de doble cara::
+* Variables de \paper para desplazamientos y sangrados::
+@end menu
-Ejemplo:
-@example
-\paper @{
- paper-width = 2\cm
- top-margin = 3\cm
- bottom-margin = 3\cm
- ragged-last-bottom = ##t
-@}
-@end example
+@node Variables de \paper para la anchura y los márgenes
+@unnumberedsubsubsec Variables de @code{\paper} para la anchura y los márgenes
+@translationof \paper variables for widths and margins
-Este segundo ejemplo centra los números de página en la parte baja del
-papel.
+Los valores predeterminados (antes del escalado) que no están
+relacionados aquí se encuentran definidos en el archivo
+@file{ly/paper-defaults-init.ly}.
-@example
-\paper @{
- print-page-number = ##t
- print-first-page-number = ##t
- oddHeaderMarkup = \markup \fill-line @{ " " @}
- evenHeaderMarkup = \markup \fill-line @{ " " @}
- oddFooterMarkup = \markup @{ \fill-line @{
- \bold \fontsize #3 \on-the-fly #print-page-number-check-first
- \fromproperty #'page:page-number-string @} @}
- evenFooterMarkup = \markup @{ \fill-line @{
- \bold \fontsize #3 \on-the-fly #print-page-number-check-first
- \fromproperty #'page:page-number-string @} @}
-@}
-@end example
+@table @code
-@seealso
-Referencia de la notación:
-@ref{Espaciado vertical flexible dentro de los sistemas}.
+@item paper-width
+@funindex paper-width
-Fragmentos de código:
-@rlsr{Spacing}.
+Anchura de la página, sin fijar de forma predeterminada. Aunque
+@code{paper-width} no tiene ningún efecto sobre el escalado automático
+de algunas dimensiones horizontales, sí influye sobre la variable
+@code{line-width}. Si están establecidas las dos variables
+@code{paper-width} y @code{line-width}, entonces también se actualizan
+@code{left-margin} y @code{right-margin}. Véase también
+@code{check-consistency}.
+@item line-width
+@funindex line-width
-@node Dimensiones horizontales
-@unnumberedsubsubsec Dimensiones horizontales
-@translationof Horizontal dimensions
+Dimensiones horizontales de las líneas del pentagrama en los sistemas
+sin sangrado y justificados, igual a
+@code{(paper-width@tie{}@minus{}@tie{}left-margin@tie{}@minus{}@tie{}right-margin)}
+cuando está sin fijar. Si @code{line-width} está fijado, y tanto
+@code{left-margin} como @code{right-margin} están sin fijar, entonces
+los márgenes se actualizan para centrar los sistemas automáticamente
+sobre la página. Véase también @code{check-consistency}.
+Esta variable también se puede fijar dentro de un bloque @code{\layout}.
+@item left-margin
+@funindex left-margin
-Existe un cierto número de variables que determinan las dimensiones
-horizontales de una página:
+Margen entre el extremos izquierdo de la página y el comienzo de las
+líneas del pentagrama en los sistemas sin sangrado. Si el tamaño del
+papel se modifica, el valor predeterminado de esta dimensión se escala
+de acuerdo con ello. Si no se fija el valor de @code{left-margin}, y
+tanto @code{line-width} como @code{right-margin} están fijados,
+entonces se establece el valor de @code{left-margin} a
+@code{(paper-width@tie{}@minus{}@tie{}line-width@tie{}@minus{}@tie{}right-margin)}.
+Si solamente está fijado @code{line-width}, entonces los dos márgenes
+se establecen a
+@code{((paper-width@tie{}@minus{}@tie{}line-width)@tie{}/@tie{}2)}, y
+como consecuencia los sistemas se centran sobre la página. Véase
+también @code{check-consistency}.
-@table @code
+@item right-margin
+@funindex right-margin
-@item binding-offset
-@funindex binding-offset
+Margen entre el extremo derecho de la página y el final de las líneas
+del pentagrama en sistemas justificados. Si el tamaño de la página se
+modifica, el valor predeterminado de esta dimensión se escala de
+acuerdo con ello. Si @code{right-margin} está sin fijar, y tanto
+@code{line-width} como @code{left-margin} están fijados, el valor de
+@code{right-margin} se establece a
+@code{(paper-width@tie{}@minus{}@tie{}line-width@tie{}@minus{}@tie{}left-margin)}.
+Si solamente está fijado @code{line-width}, los dos márgenes se
+establecen a
+@code{((paper-width@tie{}@minus{}@tie{}line-width)@tie{}/@tie{}2)}, y
+como consecuencia los sistemas aparecen centrados sobre la página.
+Véase también @code{check-consistency}.
-Se aumenta la cantidad @code{inner-margin} para asegurar que el
-encuadernado no va a tapar nada. Sólo funciona con @code{two-sided}
-establecido al valor verdadero. Valor predeterminado: @code{0}.
+@item check-consistency
+@funindex check-consistency
-@item horizontal-shift
-@funindex horizontal-shift
+Si se establece al valor verdadero, se imprime una advertencia en caso
+de que la suma de @code{left-margin}, @code{line-width} y
+@code{right-margin} no coincida exactamente con el valor de
+@code{paper-width}, y se sustituye cada uno de estos valores (excepto
+@code{paper-width}) con su valor predeterminado (escalado al tamaño
+del papel si es necesario). Si está fijado al valor falso, se ignora
+cualquier inconsistencia y se permite que los sistemas se salgan del
+borde del papel.
-Medida en que todos los sistemas (incluidos los títulos de cabecera y
-los separadores de sistemas) se desplazan a la derecha.
-Predeterminado: @code{0.0}.
+@item ragged-right
+@funindex ragged-right
-@item indent
-@funindex indent
+Si está fijado al valor verdadero, los sistemas no cubren el ancho de
+la línea. En lugar de ello, los sistemas finalizan en su longitud
+horizontal natural. Valor predeterminado: @code{#t} para las
+partituras con un solo sistema, y @code{#f} para partituras que tienen
+dos o más sistemas. Esta variable también se puede establecer dentro
+de un bloque @code{\layout}.
-Nivel de sangrado para el primer sistema de una partitura. Valor
-predeterminado: @code{15\mm}.
+@item ragged-last
+@funindex ragged-last
-@item inner-margin
-@funindex inner-margin
+Si está fijado al valor verdadero, el último sistema de la partitura
+no llena toda la anchura de la línea. En lugar de ello, el último
+sistema finaliza en su longitud horizontal natural. Valor
+predeterminado: @code{#f}. Esta variable también puede ajustarse
+dentro de un bloque @code{\layout}.
-Margen que tienen todas las páginas en el lado interior si son parte
-de un libro. Sólo funciona con @code{two-sided} establecido al valor
-verdadero. Valor predeterminado: @code{10\mm}.
+@end table
-@item left-margin
-@funindex left-margin
+@seealso
+Referencia de la notación:
+@ref{Escalado automático al tamaño del papel}.
-El margen entre el límite izquierdo del papel y el comienzo de los
-sistemas. Predeterminado: @code{10\mm}.
+Archivos de inicio:
+@file{ly/paper-defaults-init.ly}.
-@item line-width
-@funindex line-width
-Ancho de los sistemas. Predeterminado: @code{paper-width} menos
-@code{left-margin} y @code{right-margin}.
+@node Variables de \paper para el modo de doble cara
+@unnumberedsubsubsec Variables de @code{\paper} para el modo de doble cara
+@translationof \paper variables for two-sided mode
+
+Los valores predeterminados (antes del escalado) se definen en
+@file{ly/paper-defaults-init.ly}.
+
+@table @code
+
+@item two-sided
+@funindex two-sided
+
+@cindex encuadernación
+@cindex margen de encuadernación
+
+Si tiene el valor verdadero, utilizar @code{inner-margin},
+@code{outer-margin} y @code{binding-offset} para determinar los
+márgenes dependiendo de si el número de la página es par o impar.
+Esto sobreescribe a @code{left-margin} y a @code{right-margin}.
+
+@item inner-margin
+@funindex inner-margin
+
+Margen que todas las páginas tienen en el lado interno si forman parte
+de un libro. Si el tamaño del papel se modifica, el valor
+predeterminado de esta dimensión se escala de acuerdo con ello.
+Solamente funciona con @code{two-sided} fijado al valor verdadero.
@item outer-margin
@funindex outer-margin
-Margen que todas las páginas tienen en la parte exterior si son parte
-de un libro. Sólo funciona con @code{two-sided} establecido al valor
-verdadero. Valor predeterminado: @code{20\mm}.
+Margen que todas las páginas tienen en el lado externo si forman parte
+de un libro. Si el tamaño del papel se modifica, el valor
+predeterminado de esta dimensión se escala de acuerdo con ello.
+Solamente funciona con @code{two-sided} fijado al valor verdadero.
-@item paper-width
-@funindex paper-width
+@item binding-offset
+@funindex binding-offset
-Ancho de la página. Predeterminado: la anchura del tamaño actual del
-papel. Para ver más detalles, consulte @ref{Tamaño del papel}.
+Medida en que se aumenta @code{inner-margin} para asegurar que no se
+oculta nada a causa de la encuadernación. Si el tamaño del papel se
+modifica, el valor predeterminado de esta dimensión se escala de
+acuerdo con ello. Solamente funciona con @code{two-sided} fijado al
+valor verdadero.
-@item right-margin
-@funindex right-margin
-Margen entre el borde derecho de la página y el final de cada sistema.
-Valor predeterminado: @code{10\mm}.
+@end table
+
+@seealso
+Referencia de la notación:
+@ref{Escalado automático al tamaño del papel}.
+
+Archivos de inicio:
+@file{ly/paper-defaults-init.ly}.
+
+
+@node Variables de \paper para desplazamientos y sangrados
+@unnumberedsubsubsec Variables de @code{\paper} para desplazamientos y sangrados
+@translationof \paper variables for shifts and indents
+
+Los valores predeterminados (antes del escalado) que no se relacionan
+aquí están definidos en el archivo @file{ly/paper-defaults-init.ly}.
+
+@table @code
+
+@item horizontal-shift
+@funindex horizontal-shift
+
+@c This default value is buried in the middle of page.scm. -mp
+
+Medida en que todos los sistemas (incluidos los títulos de cabecera y
+los separadores de sistemas) se desplazan a la derecha.
+Predeterminado: @code{0.0}.
+
+@item indent
+@funindex indent
+
+Nivel de sangrado para el primer sistema de una partitura. Si se
+modifica el tamaño del papel, el valor predeterminado de esta
+dimensión se escala de acuerdo con ello. Esta variable también se
+puede ajustar dentro de un bloque @code{\layout}.
@item short-indent
@funindex short-indent
Nivel de sangrado para todos los sistemas de una partitura excepto el
-primero. Predeterminado: @code{0}.
+primero. Si el tamaño del papel se modifica, el valor predeterminado
+de esta dimensión se escala de acuerdo con ello. Esta variable
+también se puede ajustar dentro de un bloque @code{\layout}.
@end table
-Si hay valores sin ajustar, se toman los predeterminados. Se ajusta
-su valor exacto, dependiendo del tamaño de papel especificado. Por el
-momento, los siguientes valores se ven afectados por este escalado:
+@seealso
+Referencia de la notación:
+@ref{Escalado automático al tamaño del papel}.
-@itemize
-@item @var{left-margin}
-@item @var{right-margin}
-@item @var{top-margin}
-@item @var{bottom-margin}
-@item @var{head-separation}
-@item @var{foot-separation}
-@item @var{indent}
-@item @var{short-indent}
-@end itemize
+Archivos de inicio:
+@file{ly/paper-defaults-init.ly}.
-Los ajustes para @code{line-width}, @code{left-margin},
-@code{right-margin} y @code{paper-width} dependen entre sí, pero no
-tienen que especificarse completamente.
+Fragmentos de código:
+@rlsr{Spacing}.
-@example
-\paper @{
- left-margin = 30\mm
-@}
-@end example
-En este ejemplo, sólo se establece un valor para @code{left-margin}.
-El valor de @code{right-margin} sigue siendo el predeterminado,
-@code{line-width} se calcula automáticamente.
+@node Otras variables de \paper
+@subsection Otras variables de @code{\paper}
+@translationof Other \paper variables
-@example
-\paper @{
- line-width = 150\mm
-@}
-@end example
+@menu
+* Variables de \paper para los saltos de línea::
+* Variables de \paper para los saltos de página::
+* Variables de \paper para la numeración de las páginas::
+* Variables de \paper diversas::
+@end menu
-Aquí @code{left-margin} y @code{right-margin} se ajustan al mismo
-valor. Por tanto, @code{line-width} se sustrae de @code{paper-width}
-y se divide entre dos. Esto significa que los sistemas se imprimen
-centrados en la página, si sólo se especifica @code{line-width}.
-Tienen lugar algunas comprobaciones para asegurar que los valores se
-establecen correctamente. Si los valores no encajasen o los sistemas
-se fueran a salir de la página, se imprime una advertencia y se
-establecen los valores predeterminados.
+@node Variables de \paper para los saltos de línea
+@unnumberedsubsubsec Variables de @code{\paper} para los saltos de línea
+@translationof \paper variables for line breaking
-@example
-\paper @{
- paper-width = 210\mm
- left-margin = 20\mm
- right-margin = 30\mm
- line-width = 100\mm
-@}
-@end example
+@c TODO: Mention that ly:optimal-breaking is on by default? -mp
-Estas comprobaciones se pueden evitar estableciendo
-@code{check-consistency} al valor falso.
+@table @code
-@example
-\paper @{
- paper-width = 210\mm
- left-margin = 20\mm
- line-width = 200\mm
- check-consistency = ##f
-@}
-@end example
+@item max-systems-per-page
+@funindex max-systems-per-page
-@warning{Si @code{paper-width} se ajusta manualmente,
-@code{line-width}, @code{left-margin}, @code{indent} y
-@code{short-indent} podrían tener que ajustarse también.}
+Número máximo de sistemas que se colocan sobre una página. Solo está
+contemplado por el algoritmo @code{ly:optimal-breaking}. Valor
+predeterminado: no fijado.
-@seealso
-Fragmentos de código:
-@rlsr{Spacing}.
+@item min-systems-per-page
+@funindex min-systems-per-page
+Número mínimo de sistemas que se colocan sobre una página. Puede
+causar que las páginas aparezcan atiborradas si el valor es demasiado
+grande En el momento actual solo está contemplado por el algoritmo
+@code{ly:optimal-breaking}. Valor predeterminado: no fijado.
+@item systems-per-page
+@funindex systems-per-page
-@node Otras variables de diseño de página
-@unnumberedsubsubsec Otras variables de diseño de página
-@translationof Other layout variables
+Número de sistemas que se deben colocar en cada página. En el momento
+actual solo está contemplado por el algoritmo
+@code{ly:optimal-breaking}. Valor predeterminado: no fijado.
-Estas variables se pueden usar para ajustar el diseño de la página en
-general.
+@item system-count
+@funindex system-count
-@table @code
+Número de sistemas que utilizar para una partitura. Valor
+predeterminado: no fijado. Esta variables también se puede ajustar
+dentro de un bloque @code{\layout}.
-@item auto-first-page-number
-@funindex auto-first-page-number
+@end table
-El algoritmo de división de páginas está afectado por el hecho de que
-el número de la primera página sea par o impar. Si está establecido
-al valor verdadero, el algoritmo de división de páginas decide si
-comenzar con un número par o impar. Esto hace que el número de la
-primera página se quede como está, o que se aumente en una unidad.
-Predeterminado: @code{##f}.
+@seealso
+Referencia de la notación:
+@ref{Saltos de línea}.
-@ignore
-FIXME: this variable is used, but I don't know what it does. -pm
+@node Variables de \paper para los saltos de página
+@unnumberedsubsubsec Variables de @code{\paper} para los saltos de página
+@translationof \paper variables for page breaking
+
+Los valores predeterminados que no están relacionados aquí, se definen
+en el archivo @file{ly/paper-defaults-init.ly}
+
+@table @code
+
@item blank-after-score-page-force
@funindex blank-after-score-page-force
-Default: @code{2}.
-
-@end ignore
+Penalización por tener una página vacía después del final de una
+partitura y antes de la siguiente. De forma predeterminada, es menor
+que @code{blank-page-force}, de manera que preferimos páginas vacías
+después de las partituras que páginas vacías dentro de una partitura.
@item blank-last-page-force
@funindex blank-last-page-force
-Penalización por terminar la partitura en una página de numeración
-impar. Predeterminado: @code{0}.
+Penalización por terminar la partitura sobre una página impar.
@item blank-page-force
@funindex blank-page-force
-Penalización por tener una página en blanco en medio de una partitura.
-Esto no se usa por parte de @code{ly:optimal-breaking} porque éste
-nunca considera la posibilidad de tener páginas en blanco en mitad de
-una partitura. Predeterminado: @code{5}.
+Penalización por tener una página vacía en medio de una partitura. No
+se utiliza por parte de @code{ly:optimal-breaking} porque nunca
+considera páginas vacías en mitad de una partitura.
-@item check-consistency
-@funindex check-consistency
+@item page-breaking
+@funindex page-breaking
-Si es verdadero, comprobar si @code{left-margin}, @code{right-margin}
-y @code{line-width} encajan entre sí. También asegurar que su
-combinación no excede del @code{paper-width} disponible. Valor
-predeterminado: @code{##t}.
+Algoritmo de saltos de página que utilizar. Se puede elegir entre
+@code{ly:minimal-breaking}, @code{ly:page-turn-breaking} o
+@code{ly:optimal-breaking}.
-@item first-page-number
-@funindex first-page-number
+@item page-breaking-system-system-spacing
+@funindex page-breaking-system-system-spacing
-Valor del número de la primera página. Predeterminado: @code{#1}.
+Engaña a la parte del programa encargada de los saltos de página para
+que piense que @code{system-system-spacing} está establecido a un
+valor distinto al que tiene realmente. Por ejemplo, si
+@code{page-breaking-system-system-spacing #'padding} está establecido
+a algo que es mucho mayor que @code{system-system-spacing #'padding},
+entonces el divisor de páginas pone menos sistemas en cada página.
+Valor predeterminado: sin ajustar.
-@item max-systems-per-page
-@funindex max-systems-per-page
+@item page-count
+@funindex page-count
-Máximo número de sistemas que tendrán cabida en una página. Está
-contemplado por el momento solamente por parte del algoritmo
-@code{ly:optimal-breaking}. Predeterminado: no establecido.
+Número de páginas que utilizar en una partitura, no ajustado de forma
+predeterminada.
-@item min-systems-per-page
-@funindex min-systems-per-page
+@end table
+
+@seealso
+Referencia de la notación:
+@ref{Saltos de página},
+@ref{Saltos de página óptimos},
+@ref{Paso de página óptimo},
+@ref{Saltos de página mínimos}.
-Mínimo número de sistemas que habrá en una página. Puede hacer que
-las páginas se llenen en exceso si se establece a un valor grande.
-Por el momento solamente está contemplado por parte del algoritmo
-@code{ly:optimal-breaking}. Predeterminado: no establecido.
+Archivos de inicio:
+@file{ly/paper-defaults-init.ly}.
-@item page-breaking-system-system-spacing
-@funindex page-breaking-system-system-spacing
-Engaña al divisor de páginas para que crea que
-@code{system-system-spacing} está establecido a algo distinto de lo
-que está realmente. Por ejemplo, si
-@code{page-breaking-system-system-spacing #'padding} se establece a algo
-mucho mayor que @code{system-system-spacing #'padding}, entonces
-el divisor de páginas colocará menos sistemas en cada página.
-Predeterminado: no establecido.
+@node Variables de \paper para la numeración de las páginas
+@unnumberedsubsubsec Variables de @code{\paper} para la numeración de las páginas
+@translationof \paper variables for page numbering
-@item page-count
-@funindex page-count
+Los valores predeterminados que no se relacionan aquí están definidos
+en el archivo @file{ly/paper-defaults-init.ly}
-Número de páginas que usar para una partitura. Predeterminado: sin
-fijar.
+@table @code
-@item page-spacing-weight
-@funindex page-spacing-weight
+@cindex números de página, automáticos
+@item auto-first-page-number
+@funindex auto-first-page-number
-Importancia relativa del espacio (vertical) de las páginas y el
-espaciado (horizontal) de las líneas. Los valores altos hacen que el
-espaciado de la página tenga más importancia. Predeterminado:
-@code{#10}.
+El algoritmo de división de páginas está afectado por el hecho de que
+el número de la primera página sea par o impar. Si está establecido
+al valor verdadero, el algoritmo de división de páginas decide si
+comenzar con un número par o impar. Esto hace que el número de la
+primera página se quede como está, o que se aumente en una unidad.
+Predeterminado: @code{#f}.
-@item print-all-headers
-@funindex print-all-headers
+@cindex números de página, especificar el primero
+@item first-page-number
+@funindex first-page-number
-Si está establecido a un valor verdadero, imprime todas las cabeceras
-para cada una de las @code{\score} en la salida impresa. Normalmente
-sólo se imprimen las variables de encabezamiento de pieza y opus.
-Predeterminado: @code{##f}.
+Valor del número de pátina en la primera página.
@item print-first-page-number
@funindex print-first-page-number
-Si está establecido a un valor verdadero, se imprime un número de
-página en la primera página. Predeterminado: @code{##f}.
+Si está fijado a verdadero, se imprime un número de página en la
+primera página.
+@cindex números de página, suprimir
@item print-page-number
@funindex print-page-number
-Si está establecido a un valor falso, no se imprimen los números de
-página. Predeterminado: @code{##t}.
+Si está fijado a falso, no se imprimen los números de página.
-@item ragged-bottom
-@funindex ragged-bottom
-
-Si está establecido a un valor verdadero, los sistemas no ocuparán
-verticalmente toda la altura de la página. Esto no afecta a la última
-página. Predeterminado: @code{##f}.
-
-Esto se debería establecer al valor verdadero para piezas que tienen
-sólo dos o tres sistemas por página, por ejemplo partituras
-orquestales.
-
-@item ragged-last
-@funindex ragged-last
+@end table
-Si está establecido a un valor verdadero, el último sistema de la
-partitura no llenará la anchura de la línea. En su lugar, el último
-sistema termina en su longitud horizontal natural. Predeterminado:
-@code{##f}.
+@seealso
+Archivos de inicio:
+@file{ly/paper-defaults-init.ly}.
-@item ragged-last-bottom
-@funindex ragged-last-bottom
+@knownissues
+Los números de página impares siempre están a la derecha.
+Si quiere que la música comience en la página 1 debe haber
+una página en blanco en el reverso de la página de cubierta
+de manera que la página 1 esté en el lado derecho.
-Si está establecido a un valor falso, los sistemas se repartirán
-verticalmente por toda la última página. Predeterminado: @code{##t}.
+@node Variables de \paper diversas
+@unnumberedsubsubsec Variables de @code{\paper} diversas
+@translationof Miscellaneous \paper variables
-Las piezas que llenan generosamente dos o más páginas deberían tener
-esto establecido al valor verdadero.
+@table @code
-También afecta a la última página de las partes de libro, es decir,
-partes de un libro que se han creado con bloques @code{\bookpart}.
+@item page-spacing-weight
+@funindex page-spacing-weight
-@item ragged-right
-@funindex ragged-right
+Importancia relativa del espacio (vertical) de las páginas y el
+espaciado (horizontal) de las líneas. Los valores altos hacen que el
+espaciado de la página tenga más importancia. Predeterminado:
+@code{#10}.
-Si está establecido a un valor verdadero, los sistemas no llenarán el
-ancho de línea disponible. En su lugar, los sistemas terminan en su
-longitud horizontal natural. Predeterminado: @code{##f}.
+@item print-all-headers
+@funindex print-all-headers
-Si la partitura sólo tiene un sistema, el valor predeterminado es
-@code{##t}.
+Si está fijado a verdadero, imprime todos los encabezamientos para
+cada una de las partituras @code{\score} de la salida. Normalmente
+sólo se imprimen las variables de encabezamiento @code{piece} y
+@code{opus}. Valor predeterminado: @code{#f}.
@item system-separator-markup
@funindex system-separator-markup
Objeto de marcado que se inserta entre los sistemas. Se suele usar
-para partituras orquestales. Predeterminado: sin establecer.
+para partituras orquestales. Predeterminado: sin establecer. El
+elemento de marcado @code{\slashSeparator}, definido en el archivo
+@file{ly/titling-init.ly}, se aporta como un valor predeterminado
+adecuado, por ejemplo:
-Se ofrece la instrucción de marcado @code{\slashSeparator} como un
-valor predeterminado apropiado, por ejemplo
+@lilypond[quote,verbatim,noragged-right,line-width=30\mm]
+#(set-default-paper-size "a8")
-@lilypond[quote,ragged-right]
-#(set-default-paper-size "a6" 'landscape)
\book {
- \score {
- \relative c' { c1 \break c1 }
- }
\paper {
system-separator-markup = \slashSeparator
}
+ \header {
+ tagline = ##f
+ }
+ \score {
+ \relative c'' { c1 \break c1 \break c1 }
+ }
}
@end lilypond
-@item system-count
-@funindex system-count
-
-Cantidad de sistemas que usar por parte de la partitura.
-Predeterminado: sin establecer.
-
-@item systems-per-page
-@funindex systems-per-page
-
-Número de sistemas que se deben colocar en cada página. Está
-contemplado solamente por parte del algoritmo
-@code{ly:optimal-breaking} por el momento. Predeterminado: no
-establecido.
-
-@item two-sided
-@funindex two-sided
-
-@cindex encuadernación
-@cindex margen de encuadernación
-
-Si es verdadero, usar @code{inner-margin}, @code{outer-margin} y
-@code{binding-offset} para determinad los márgenes dependiendo de si
-el número de página es par o impar. Esto sobreescribe a
-@code{left-margin} y a @code{right-margin}. Valor predeterminado:
-@code{##f}.
-
@end table
@seealso
+Archivos de inicio:
+@file{ly/titling-init.ly}.
+
Fragmentos de código:
@rlsr{Spacing}.
el campo @code{instrument} del bloque @code{\header} sobre la misma
línea.
-Los títulos de cabecera (tomados de la sección @code{\header@{@}}) se
-tratan como un sistema, por lo que @code{ragged-bottom} y
-@code{ragged-last-bottom} añaden espacio entre los títulos y el primer
-sistema de la partitura.
+@node Disposición de la partitura
+@section Disposición de la partitura
+@translationof Score layout
-@node Disposición de la música
-@section Disposición de la música
-@translationof Music layout
+Esta sección trata de las opciones de disposición de la partitura para
+el bloque @code{\layout}.
@menu
+* El bloque \layout::
* Establecer el tamaño del pentagrama::
-* Disposición de la partitura::
@end menu
+@node El bloque \layout
+@subsection El bloque @code{\layout}
+@translationof The \layout block
+
+@funindex \layout
+
+Así como el bloque @code{\paper} contiene ajustes relativos al
+formateo de la página para todo el documento, el bloque @code{\layout}
+contiene ajustes para la disposición específica de las partituras.
+Para fijar las opciones de disposición de partituras de forma global,
+escríbalas en un bloque @code{\layout} del nivel jerárquico superior.
+Para fijar opciones de disposición para una partitura individual
+escríbalas dentro de un bloque @code{\layout} dentro del bloque
+@code{\score}, después de la música. Entre los ajustes que pueden
+aparecer en un bloque @code{\layout} se encuentran los siguientes:
+
+@itemize
+@item la función de Scheme @code{layout-set-staff-size},
+@item las modificaciones de contexto de los bloques @code{\context}, y
+@item las variables de @code{\paper} que afectan a la disposición de la partitura.
+@end itemize
+
+La función @code{layout-set-staff-size} se estudia en la sección
+siguiente, @ref{Establecer el tamaño del pentagrama}. Las
+modificaciones de contexto se estudian en un capítulo distinto; véase
+@ref{Modificar los complementos (plug-ins) de contexto} y
+@ref{Cambiar los valores por omisión de los contextos}. Las variables de
+@code{\paper} que pueden aparecer dentro de un bloque @code{\layout}
+son:
+
+@itemize
+
+@item
+@code{line-width}, @code{ragged-right} y @code{ragged-last}
+(véase @ref{Variables de \paper para la anchura y los márgenes})
+
+@item
+@code{indent} y @code{short-indent}
+(véase @ref{Variables de \paper para desplazamientos y sangrados})
+
+@item
+@code{system-count}
+(véase @ref{Variables de \paper para los saltos de línea})
+
+@end itemize
+
+He aquí un ejemplo de un bloque @code{\layout}:
+
+@example
+\layout @{
+ indent = 2\cm
+ \context @{
+ \StaffGroup
+ \override StaffGrouper #'staff-staff-spacing #'basic-distance = #8
+ @}
+ \context @{
+ \Voice
+ \override TextScript #'padding = #1
+ \override Glissando #'thickness = #3
+ @}
+@}
+@end example
+
+
+@seealso
+Referencia de la notación:
+@ref{Cambiar los valores por omisión de los contextos}.
+
+Fragmentos de código:
+@rlsr{Spacing}.
+
+
@node Establecer el tamaño del pentagrama
@subsection Establecer el tamaño del pentagrama
@translationof Setting the staff size
-@cindex tipografía, establecer tamaño de
-@cindex pentagrama, establecer tamaño de
-@funindex layout file
+@cindex tipografía, fijar el tamaño de
+@cindex pentagrama, fijar el tamaño de
+@funindex disposición, archivo de
El @strong{tamaño de pentagrama} predeterminado se establece en 20
puntos. Esto se puede modificar de dos maneras:
partitura, use
@example
\score@{
- ...
- \layout@{
- #(layout-set-staff-size 15)
+ @dots{}
+ \layout @{
+ #(layout-set-staff-size 15)
@}
@}
@end example
del pentagrama.
-@node Disposición de la partitura
-@subsection Disposición de la partitura
-@translationof Score layout
-
-@funindex \layout
-
-Mientras que @code{\paper} contiene ajustes relativos al formato de
-página del documento completo, @code{\layout} contiene ajustes para la
-disposición específica de cada partitura.
-
-@example
-\layout @{
- indent = 2.0\cm
- \context @{ \Staff
- \override VerticalAxisGroup #'minimum-Y-extent = #'(-6 . 6)
- @}
- \context @{ \Voice
- \override TextScript #'padding = #1.0
- \override Glissando #'thickness = #3
- @}
-@}
-@end example
-
-
-@seealso
-Referencia de la notación:
-@ref{Cambiar los valores por omisión de los contextos}.
-
-Fragmentos de código:
-@rlsr{Spacing}.
-
-
@node Saltos
@section Saltos
@translationof Breaks
Normalmente los saltos de línea se determinan automáticamente. Se
eligen de forma que las líneas no aparezcan demasiado apretadas ni
demasiado sueltas, y que las líneas consecutivas tengan una densidad
-similar. Ocasionalmente podemos querer sobreescribir los saltos
-automáticos; podemos hacerlo especificando @code{\break}. Esto fuerza
-un salto de línea en ese punto. Sin embargo, los saltos de línea sólo
-pueden suceder al final de los compases @q{completos}, es decir, donde
-no queda ninguna nota o grupo especial @q{colgando} por encima de la
-línea divisoria. Si queremos poner un salto de línea donde no hay
-línea divisoria, podemos forzar una barra de compás invisible
-introduciendo @code{\bar ""}, aunque de nuevo no deben quedar notas
-colgando en ninguno de los pentagramas en este punto, o se ignorarán.
-
-La instrucción opuesta, @code{\noBreak}, prohíbe un salto de línea en
+similar.
+
+Para forzar manualmente un salto de línea sobre la línea divisoria,
+utilice la instrucción @code{\break}:
+
+@lilypond[quote,ragged-right,relative=2,verbatim]
+c4 c c c | \break
+c4 c c c |
+@end lilypond
+
+De forma predeterminada se ignora cualquier @code{\break} en la mitad
+de un compás, y se imprime una advertencia. Para forzar un salto de
+línea en medio de un compás, añada una barra de compás invisible con
+@w{@samp{\bar ""}}:
+
+@lilypond[quote,ragged-right,relative=2,verbatim]
+c4 c c
+\bar "" \break
+c |
+c4 c c c |
+@end lilypond
+
+También se ignora un @code{\break} que se produce en la línea
+divisoria si el compás anterior termina en medio de una nota, como
+cuando un grupo de valoración especial inicia y termina en compases
+diferentes. Para permitir que las instrucciones @code{\break}
+funcionen en estas situaciones, elimine el grabador
+@code{Forbid_line_break_engraver} del contexto @code{Voice}. Observe
+que los saltos de línea forzados manualmente se deben añadir en
+paralelo con la música:
+
+@lilypond[quote,ragged-right,verbatim]
+\new Voice \with {
+ \remove Forbid_line_break_engraver
+} \relative c'' {
+ <<
+ { c2. \times 2/3 { c4 c c } c2. | }
+ { s1 | \break s1 | }
+ >>
+}
+@end lilypond
+
+De forma similar, los saltos de línea están normalmente prohibidos
+cuando hay barras de corchea que cruzan la línea divisoria. Se puede
+cambiar este comportamiento fijando @code{\override Beam #'breakable =
+##t}:
+
+@lilypond[quote,ragged-right,relative=2,verbatim]
+\override Beam #'breakable = ##t
+c2. c8[ c | \break
+c8 c] c2. |
+@end lilypond
+
+La instrucción @code{\noBreak}, prohíbe un salto de línea en
la barra divisoria en que se inserta.
Los ajustes más básicos que influyen sobre el espaciado de las líneas
@example
\layout @{
-indent = #0
-line-width = #150
-ragged-last = ##t
+ indent = 0\mm
+ line-width = 150\mm
+ ragged-last = ##t
@}
@end example
compases, y sólo en dichos lugares:
@example
-<< \repeat unfold 7 @{
- s1 \noBreak s1 \noBreak
- s1 \noBreak s1 \break @}
- @emph{the real music}
+<<
+ \repeat unfold 7 @{
+ s1 \noBreak s1 \noBreak
+ s1 \noBreak s1 \break
+ @}
+ @{ @var{la música real@dots{}} @}
>>
@end example
@c TODO Check this
Una configuración de división de líneas se puede guardar como archivo
-@code{@/.ly} automáticamente. Ello permite que alineaciones verticales
+@file{.ly} automáticamente. Ello permite que alineaciones verticales
se estiren para que encajen en las páginas durante una segunda
ejecución del proceso de formateo. Esta posibilidad es bastante
novedosa y difícil. Hay más detalles disponibles en @rlsr{Spacing}.
@seealso
-Referencia de funcionamiento interno:
-@rinternals{LineBreakEvent}.
+Referencia de la notación:
+@ref{Variables de \paper para los saltos de línea}.
Fragmentos de código:
@rlsr{Spacing}.
-
-@knownissues
-
-Sólo pueden ocurrir saltos de línea si hay una @q{buena} línea
-divisoria. Una nota colgando de una línea divisoria no es adecuada,
-como
-
-@lilypond[quote,ragged-right,relative=2,verbatim]
-c4 c2 << c2 {s4 \break } >> % this does nothing
-c2 c4 | % a break here would work
-c4 c2 c4 ~ \break % as does this break
-c4 c2 c4
-@end lilypond
-
-Esto se puede evitar eliminando el grabador
-@code{Forbid_line_break_engraver}. Observe que los saltos de línea
-forzados manualmente se tienen que añadir en paralelo con la música.
-
-@lilypond[quote,ragged-right,verbatim]
-\new Voice \with {
- \remove Forbid_line_break_engraver
-} {
- c4 c2 << c2 {s4 \break } >> % now the break is allowed
- c2 c4
-}
-@end lilypond
-
-De forma parecida, los saltos de línea están prohibidos normalmente
-cuando las barras cruzan a las líneas divisorias. Este comportamiento
-se puede modificar con el establecimiento de @code{\override Beam
-#'breakable = ##t}.
+Referencia de funcionamiento interno:
+@rinternals{LineBreakEvent}.
@node Saltos de página
@code{ragged-bottom} y @code{ragged-last-bottom}. Si están
establecidos a @code{##t} los sistemas de todas las páginas o sólo de
la última página, respectivamente, no se verán justificados
-verticalmente.
-
-Para ver más detalles, consulte @ref{Espaciado vertical}.
+verticalmente. Véase
+@ref{Variables de espaciado de \paper verticales fijas}.
Los saltos de página se calculan por medio de la función
@code{page-breaking}. LilyPond ofrece tres algoritmos para el cómputo
cambiar en el bloque @code{\paper}:
@example
-\paper@{
- #(define page-breaking ly:page-turn-breaking)
+\paper @{
+ page-breaking = #ly:page-turn-breaking
@}
@end example
\paper @{
%% En una parte que consiste en texto principalmente,
%% puede ser preferible ly:minimal-breaking
- #(define page-breaking ly:minimal-breaking)
+ page-breaking = #ly:minimal-breaking
@}
\markup @{ @dots{} @}
@dots{}
@seealso
+Referencia de la notación:
+@ref{Variables de \paper para los saltos de página}.
+
Fragmentos de código:
@rlsr{Spacing}.
\new Staff \with @{ \consists "Page_turn_engraver" @}
@{
a4 b c d |
- R1 | % a page turn will be allowed here
+ R1 | % aquí se permite un salto de página
a4 b c d |
\set Staff.minimumPageTurnLength = #(ly:make-moment 5 2)
- R1 | % a page turn will not be allowed here
+ R1 | % aquí no se permite un salto de página
a4 b r2 |
- R1*2 | % a page turn will be allowed here
+ R1*2 | % aquí se permite un salto de página
a1
@}
@end example
@example
\paper @{
- #(define page-breaking ly:minimal-breaking)
+ page-breaking = #ly:minimal-breaking
@}
@end example
ragged-bottom = ##t
}
+music = \relative c'' { c8 c c c }
+
\score {
\new Staff {
- \repeat unfold 2 { c'8 c'8 c'8 c'8 } \break
- \repeat unfold 4 { c'8 c'8 c'8 c'8 } \break
- \repeat unfold 6 { c'8 c'8 c'8 c'8 } \break
- \repeat unfold 8 { c'8 c'8 c'8 c'8 } \pageBreak
- \repeat unfold 8 { c'8 c'8 c'8 c'8 } \break
- \repeat unfold 6 { c'8 c'8 c'8 c'8 } \break
- \repeat unfold 4 { c'8 c'8 c'8 c'8 } \break
- \repeat unfold 2 { c'8 c'8 c'8 c'8 }
- }
+ \repeat unfold 2 { \music } \break
+ \repeat unfold 4 { \music } \break
+ \repeat unfold 6 { \music } \break
+ \repeat unfold 8 { \music } \pageBreak
+ \repeat unfold 8 { \music } \break
+ \repeat unfold 6 { \music } \break
+ \repeat unfold 4 { \music } \break
+ \repeat unfold 2 { \music }
+ }
\layout {
\context {
\Score
directamente entremezclado dentro del código de notas.
@example
+music = \relative c'' @{ c4 c c c @}
+
\score @{
\new Staff @{
- \repeat unfold 2 @{ c'4 c'4 c'4 c'4 @}
- \break
- \repeat unfold 3 @{ c'4 c'4 c'4 c'4 @}
+ \repeat unfold 2 @{ \music @} \break
+ \repeat unfold 3 @{ \music @}
@}
@}
@end example
disposición de los saltos.
@lilypond[quote,verbatim]
+music = \relative c'' { c4 c c c }
+
\score {
\new Staff <<
\new Voice {
s1 * 5 \break
}
\new Voice {
- \repeat unfold 2 { c'4 c'4 c'4 c'4 }
- \repeat unfold 3 { c'4 c'4 c'4 c'4 }
- \repeat unfold 6 { c'4 c'4 c'4 c'4 }
- \repeat unfold 5 { c'4 c'4 c'4 c'4 }
+ \repeat unfold 2 { \music }
+ \repeat unfold 3 { \music }
+ \repeat unfold 6 { \music }
+ \repeat unfold 5 { \music }
}
>>
}
@ref{Espaciado vertical}.
@lilypond[quote,verbatim]
+music = \relative c'' { c4 c c c }
+
\score {
\new Staff <<
\new Voice {
s1 * 5 \break
}
\new Voice {
- \repeat unfold 2 { c'4 c'4 c'4 c'4 }
- \repeat unfold 3 { c'4 c'4 c'4 c'4 }
- \repeat unfold 6 { c'4 c'4 c'4 c'4 }
- \repeat unfold 5 { c'4 c'4 c'4 c'4 }
+ \repeat unfold 2 { \music }
+ \repeat unfold 3 { \music }
+ \repeat unfold 6 { \music }
+ \repeat unfold 5 { \music }
}
>>
}
dentro de los sistemas, uno por cada una de las categorías siguientes:
@itemize
-@item @emph{pautas sin agrupar},
-@item @emph{pautas agrupadas} (pautas dentro de un grupo de pentagramas como
+
+@item
+@emph{pautas sin agrupar},
+
+@item
+@emph{pautas agrupadas} (pautas dentro de un grupo de pentagramas como
@code{ChoirStaff}, etc.), y
-@item @emph{líneas que no son pautas} (como @code{Lyrics},
+
+@item
+@emph{líneas que no son pautas} (como @code{Lyrics},
@code{ChordNames}, etc.).
+
@end itemize
@c TODO: Clarify this. This almost implies that non-staff lines
entre las pautas.
Observe que los mecanismos de espaciado estudiados en esta sección
-solamente controlan el espaciado vertical de pas pautas y líneas que
+solamente controlan el espaciado vertical de las pautas y líneas que
no son pautas dentro de los sistemas individuales. El espaciado
vertical entre distintos sistemas, partituras, marcados y márgenes se
controla mediante variables de @code{\paper} que se estudian en
-@ref{Dimensiones verticales flexibles}.
+@ref{Flexible vertical spacing \paper variables}.
@menu
* Propiedades de espaciado dentro de los sistemas::
@unnumberedsubsubsec Propiedades de espaciado dentro de los sistemas
@translationof Within-system spacing properties
+@funindex staff-affinity
+@funindex staffgroup-staff-spacing
+@funindex staff-staff-spacing
+@funindex nonstaff-unrelatedstaff-spacing
+@funindex nonstaff-relatedstaff-spacing
+@funindex nonstaff-nonstaff-spacing
+@funindex default-staff-staff-spacing
+@funindex minimum-Y-extent
+@funindex extra-offset
+@funindex self-alignment-X
+@funindex X-offset
+@funindex VerticalAxisGroup
+
Los mecanismos de espaciado vertical dentro del sistema están
controlados por dos conjuntos de propiedades de grob. El primer
conjunto está asociado con el grob @code{VerticalAxisGroup}, que se
donde @code{@var{elemento1}} y @code{@var{elemento2}} son los
elementos que se van a espaciar. Observe que @code{@var{elemento2}}
no está necesariamente por debajo de @code{@var{elemento1}}; por
-ejemplo, @code{nonstaff-relatedstaff-spacing} mide hadcia arriba a
+ejemplo, @code{nonstaff-relatedstaff-spacing} mide hacia arriba a
partir de la línea del tipo no-pauta si @code{staff-affinity} es
@code{#UP}.
de estos puntos de referencia:
@lilypond[quote,noragged-right,line-width=110\mm]
-#(define zero-space '((padding . -inf.0) (space . 0)))
+#(define zero-space '((padding . -inf.0) (basic-distance . 0)))
alignToZero = \with {
\override VerticalAxisGroup #'nonstaff-relatedstaff-spacing = #zero-space
\context { \Dynamics \alignToZero }
\context { \FiguredBass \alignToZero }
\context { \Lyrics \alignToZero }
- \context { \NoteNames \alignToZero }
- \context { \ChordNames \alignToZero \lowerCaseChords }
+ \context { \NoteNames \alignToZero \staffAffinityDown }
+ \context { \ChordNames \alignToZero
+ \staffAffinityDown
+ \lowerCaseChords }
\context { \FretBoards \alignToZero \staffAffinityDown }
\context { \Score
\override BarLine #'stencil = ##f
\new RhythmicStaff {
\set RhythmicStaff.instrumentName = #"baseline "
\textLengthOn
- \labelContext "ChordNames" s1 |
- \labelContext "NoteNames" s1 |
+ \labelContext "ChordNames " s1 |
+ \labelContext "NoteNames " s1 |
\labelContext "Lyrics" s1 |
}
\new Lyrics { \lyrics { \skip 1*2 | ghijk1 | } }
\set RhythmicStaff.instrumentName = #"vertical center "
\labelContext "Dynamics" s1*3
}
- \new Dynamics { s2\mp s\fp }
+ \new Dynamics { s1\mp s\fp }
>>
%% The reference point for FiguredBass is its highest point
@end lilypond
Cada una de las propiedades de grob del espaciado vertical (excepto
-@code{staff-affinity}) se almacena como una lista-A (lista
-asociativa), y todas usan la misma estructura de lista-A que las
+@code{staff-affinity})
+usa la misma estructura de lista-A que las
variables de espaciado del bloque @code{\paper} que se han estudiado
-en @ref{Dimensiones verticales flexibles}. En @ref{Modificación de
-las listas-A} se estudian métodos específicos para la modificación de
+en @ref{Flexible vertical spacing \paper variables}.
+En @ref{Modificación de las listas-A}
+se estudian métodos específicos para la modificación de
las listas-A. Las propiedades de los grobs deben ajustarse con un
@code{\override} dentro de un bloque @code{\score} o @code{\layout}, y
no dentro de un bloque @code{\paper}.
El ejemplo que sigue muestra las dos maneras en que pueden modificarse
-estas listas-A. La primera declaración ctualiza un par clave-valor de
+estas listas-A. La primera declaración actualiza un par clave-valor de
forma individual, y la segunda redefine la propiedad completamente:
@example
\new Staff \with @{
- \override VerticalAxisGroup #'staff-staff-spacing #'space = #10
+ \override VerticalAxisGroup #'default-staff-staff-spacing
+ #'basic-distance = #10
@} @{ @dots{} @}
\new Staff \with @{
- \override VerticalAxisGroup #'staff-staff-spacing =
- #'((padding . 1)
- (space . 10)
+ \override VerticalAxisGroup #'default-staff-staff-spacing =
+ #'((basic-distance . 10)
(minimum-distance . 9)
+ (padding . 1)
(stretchability . 10))
@} @{ @dots{} @}
@end example
\layout @{
\context @{
\Staff
- \override VerticalAxisGroup #'staff-staff-spacing #'space = #10
+ \override VerticalAxisGroup #'default-staff-staff-spacing
+ #'basic-distance = #10
@}
@}
@end example
@rinternals{Contexts}.
-@subsubheading Propieades del grob @code{VerticalAxisGroup}
+@subsubheading Propiedades del grob @code{VerticalAxisGroup}
Las propiedades de @code{VerticalAxisGroup} se suelen ajustar con una
instrucción @code{\override} en el nivel de @code{Staff} (o
@table @code
@item staff-staff-spacing
-Distancia entre la pauta actual y la pauta que está justo por debajo
+Se utiliza para determinar la distancia entre la pauta actual
+y la pauta que está justo por debajo
de ella dentro del mismo sistema, incluso si hay más líneas que no son
pautas (tales como @code{Lyrics}) entre las dos pautas. No se aplica
-a la pauta inferior de un sistema. Esto susituye a cualquier ajuste
-heredado del grob @code{StaffGrouper} del grupo de pautas contenedor,
-si existe. Si no está fijado, y no hay ninguna propiedad de
-@code{StaffGrouper} que heredar, se usa la propiedad
-@code{default-staff-staff-spacing}.
+a la pauta inferior de un sistema.
+
+Inicialmente, el valor de espaciado @code{staff-staff-spacing} de un
+grupo @code{VerticalAxisGroup} es una función de Scheme que aplica las
+propiedades del @code{StaffGrouper} si la pauta forma parte de un
+grupo, o el @code{default-staff-staff-spacing} de la pauta en caso
+contrario. Esto hace posible que las pautas estén espaciadas de forma
+diferente cuando están agrupadas. Para conseguir un espaciado regular
+sin importar el agrupamiento, esta función se puede sustituir por una
+lista-A de espaciado flexible, utilizando la forma de
+sobreescritura de redefinición completa que se ha mostrado más arriba.
@item default-staff-staff-spacing
-Ajustes que utilizar para @code{staff-staff-spacing} cuando está sin
-establecer. Se aplica a las pautas no agrupadas y a las pautas
-agrupadas que no heredan los ajustes del grob @code{StaffGrouper}.
+Una lista-A de espaciado flexible que define el
+espacio @code{staff-staff-spacing} que se usará para las pautas sin
+agrupar, a no ser que se haya sobreescrito explícitamente
+@code{staff-staff-spacing} con una instrucción @code{\override}.
@item staff-affinity
Dirección de la pauta que utilizar para el espaciado de la línea
para una pauta hace que se le trate como una línea que no es una
pauta. El establecimiento de @code{staff-affinity} a @code{#f} para
una línea que no es una pauta hace que se trate como una pauta.
-
-@c TODO: verify last clause below ("even if other...")
+Establecer @code{staff-affinity} a @code{UP}, @code{CENTER}, o
+@code{DOWN} hace que el pentagrama resulte espaciado como si fuera una
+línea que no es una pauta.
@item nonstaff-relatedstaff-spacing
Distancia entre la línea del tipo no-pauta actual y la pauta más
entonces se usa @code{nonstaff-relatedstaff-spacing} para las pautas
más próximas @emph{a los dos lados}, incluso aunque aparezcan otras
líneas del tipo no-pauta entre la pauta actual y una de las otras.
+Esto significa que la colocación de una línea que no es una pauta
+depende tanto de las pautas que la rodean como de las líneas que no
+son pautas y que la rodean. Establecer la ampliabilidad
+@code{stretchability} de uno de estos tipos de espaciado a un valor
+más pequeño provoca que este espaciado domine. El establecimiento de
+@code{stretchability} a un valor mayor hace que dicho espaciado tenga
+un menor efecto.
@item nonstaff-nonstaff-spacing
Distancia entre la línea actual del tipo no-pauta y la siguiente línea
@item staff-staff-spacing
Distancia entre pautas consecutivas dentro del grupo de pautas actual.
La propiedad @code{staff-staff-spacing} del grob
-@code{VerticalAxisGroup} de una pauta individual se usará en su lugar
-para cualquier pauta que esté dentro del grupo que tiene el valor
-fijado. Véase también @code{default-staff-staff-spacing}.
+@code{VerticalAxisGroup} de una pauta individual se puede
+sobreescribir con distintos ajustes de espaciado para dicha
+pauta.
@item staffgroup-staff-spacing
Distancia entre la última pauta del grupo en curso y la pauta que está
una o más líneas que no son pautas (tales como @code{Lyrics}) entre
las dos pautas. No se aplica al pentagrama o pauta inferior de un
sistema. La propiedad @code{staff-staff-spacing} del grob
-@code{VerticalAxisGroup} de una pauta individual se usará en su lugar
-para cualquier pauta dentro del grupo que tenga el valor fijado.
-Véase también @code{default-staff-staff-spacing}.
+@code{VerticalAxisGroup} de una pauta individual se puede
+sobreescribir con distintos ajustes de espaciado para dicha
+pauta.
@end table
@seealso
-Archivos de inicio:
-@file{ly/@/engraver@/-init@/.ly},
-@file{scm/@/define@/-grobs@/.scm}.
+Referencia de la notación:
+@ref{Variables de espaciado de \paper verticales flexibles},
+@ref{Modificación de las listas-A}.
Referencia de funcionamiento interno:
@rinternals{Contexts},
@rinternals{VerticalAxisGroup},
@rinternals{StaffGrouper}.
+Archivos de inicio:
+@file{ly/engraver-init.ly},
+@file{scm/define-grobs.scm}.
+
@node Espaciado de pautas no agrupadas
@unnumberedsubsubsec Espaciado de pautas no agrupadas
@itemize
@item Propiedades de @code{VerticalAxisGroup}:
@itemize
+@item @code{default-staff-staff-spacing}
@item @code{staff-staff-spacing}
@end itemize
@end itemize
Estas propiedades de grob se describen individualmente más arriba;
-véase @ref{Propiedades de espaciado dentro de un sistema}.
+véase @ref{Propiedades de espaciado dentro de los sistemas}.
Están implicadas ciertas propiedades adicionales para las pautas que
son parte de un grupo; véase @ref{Espaciado de pautas agrupadas}.
El ejemplo siguiente muestra cómo la propiedad
-@code{staff-staff-spacing} puede afectar al espaciado de pautas no
-agrupadas:
+@code{default-staff-staff-spacing} puede afectar al espaciado de pautas no
+agrupadas. Las mismas sobreescrituras aplicadas a
+@code{staff-staff-spacing}
+tendrían el mismo efecto, pero también se aplicaría en caso de que las
+pautas estuvieran combinadas en un grupo o grupos.
@lilypond[verbatim,quote,staffsize=16]
\layout {
\context {
\Staff
- \override VerticalAxisGroup #'staff-staff-spacing =
- #'((padding . 1)
- (space . 8)
- (minimum-distance . 7))
+ \override VerticalAxisGroup #'default-staff-staff-spacing =
+ #'((basic-distance . 8)
+ (minimum-distance . 7)
+ (padding . 1))
}
}
-\new StaffGroup <<
- % The very low note here needs more room than 'space can
- % provide, so the distance between this staff and the next is
- % determined by 'padding.
+<<
+ % The very low note here needs more room than 'basic-distance
+ % can provide, so the distance between this staff and the next
+ % is determined by 'padding.
\new Staff { b,2 r | }
- % Here, 'space provides enough room, and there is no need to
- % compress the space (towards 'minimum-distance) to make room
- % for anything else on the page, so the distance between this
- % staff and the next is determined by 'space.
+ % Here, 'basic-distance provides enough room, and there is no
+ % need to compress the space (towards 'minimum-distance) to make
+ % room for anything else on the page, so the distance between
+ % this staff and the next is determined by 'basic-distance.
\new Staff { \clef bass g2 r | }
% By setting 'padding to a negative value, staves can be made to
- % collide. The lowest acceptable value for 'space is 0.
+ % collide. The lowest acceptable value for 'basic-distance is 0.
\new Staff \with {
- \override VerticalAxisGroup #'staff-staff-spacing =
- #'((padding . -10)
- (space . 3.5))
+ \override VerticalAxisGroup #'default-staff-staff-spacing =
+ #'((basic-distance . 3.5)
+ (padding . -10))
} { \clef bass g2 r | }
\new Staff { \clef bass g2 r | }
>>
@seealso
Archivos de inicio:
-@file{scm/@/define@/-grobs@/.scm}.
+@file{scm/define-grobs.scm}.
Fragmentos de código:
@rlsr{Spacing}.
@item Propiedades de @code{VerticalAxisGroup}:
@itemize
@item @code{staff-staff-spacing}
-@item @code{default-staff-staff-spacing}
@end itemize
@item Propiedades de @code{StaffGrouper}:
@itemize
@end itemize
Estas propiedades de grob se describen individualmente más arriba;
-véase @ref{Propiedades de espaciado dentro de un sistema}.
+véase @ref{Propiedades de espaciado dentro de los sistemas}.
El ejemplo siguiente muestra cómo pueden afectar las propiedades del
grob @code{StaffGrouper} al espaciado de las pautas agrupadas:
\context {
\Score
\override StaffGrouper #'staff-staff-spacing #'padding = #0
- \override StaffGrouper #'staff-staff-spacing #'space = #1
+ \override StaffGrouper #'staff-staff-spacing #'basic-distance = #1
}
}
<<
\new PianoStaff \with {
- \override StaffGrouper #'staffgroup-staff-spacing #'space = #20
+ \override StaffGrouper #'staffgroup-staff-spacing #'basic-distance = #20
} <<
\new Staff { c'1 }
\new Staff { c'1 }
@end lilypond
@seealso
-Installed Files:
-@file{scm/@/define@/-grobs@/.scm}.
+Archivos de inicio:
+@file{scm/define-grobs.scm}.
-Snippets:
+Fragmentos de código:
@rlsr{Spacing}.
-Internals Reference:
+Referencia de funcionamiento interno:
@rinternals{VerticalAxisGroup},
@rinternals{StaffGrouper}.
@end itemize
Estas propiedades de grob se describen individualmente más arriba;
-véase @ref{Propiedades de espaciado dentro del sistema}.
+véase @ref{Propiedades de espaciado dentro de los sistemas}.
El ejemplo siguiente muestra cómo la propiedad
@code{nonstaff-nonstaff-spacing} puede afectar el espaciado de líneas
\new StaffGroup
<<
\new Staff \with {
- \override VerticalAxisGroup #'staff-staff-spacing = #'((space . 30))
+ \override VerticalAxisGroup #'staff-staff-spacing = #'((basic-distance . 30))
} { c'1 }
\new Lyrics \with {
\override VerticalAxisGroup #'staff-affinity = #UP
@seealso
Archivos de inicio:
-@file{ly/@/engraver@/-init@/.ly},
-@file{scm/@/define@/-grobs@/.scm}.
+@file{ly/engraver-init.ly},
+@file{scm/define-grobs.scm}.
Fragmentos de código:
@rlsr{Spacing}.
@subsection Posicionamiento explícito de los pentagramas y los sistemas
@translationof Explicit staff and system positioning
-Una forma de comprender los ajustes de @code{VerticalAxisGroup} y de
-@code{\paper} que se han explicado en las dos secciones precedentes es
-como una colección de distintos ajustes que conciernen principalmente
-a la cantidad de relleno vertical entre distintos pentagramas y
-sistemas que ocupan toda la página.
-@c running down the page.
+Una forma de entender los mecanismos del espaciado vertical
+flexible que se han explicado más arriba es como una
+colección de ajustes que controlan la cantidad de relleno
+vertical entre los pentagramas y los sistemas.
Es posible enfrentarse al espaciado vertical de una forma distinta
utilizando @code{NonMusicalPaperColumn #'line-break-system-details}.
-Cuando los ajustes de @code{VerticalAxisGroup} y de @code{\paper}
+Mientras que los mecanismos del espaciado vertical flexible
especifican relleno vertical, @code{NonMusicalPaperColumn
-#'line-break-system-details} especifica posiciones verticales exactas
-sobre la página.
+#'line-break-system-details} puede especificar posiciones verticales
+exactas sobre la página.
@code{NonMusicalPaperColumn #'line-break-system-details} acepta una
lista asociativa de tres ajustes diferentes:
#'line-break-system-details #'((Y-offset . 40))
\overrideProperty NonMusicalPaperColumn
- #'line-break-system-details #'((X-offset . 20) (Y-offset . 40))
+ #'line-break-system-details #'((X-offset . 20)
+ (Y-offset . 40))
\overrideProperty NonMusicalPaperColumn
#'line-break-system-details #'((alignment-distances . (15)))
\overrideProperty NonMusicalPaperColumn
- #'line-break-system-details #'((X-offset . 20) (Y-offset . 40)
+ #'line-break-system-details #'((X-offset . 20)
+ (Y-offset . 40)
(alignment-distances . (15)))
@end example
@c \book { } is required in these examples to ensure the spacing
@c overrides can be seen between systems. -np
-@lilypond[quote]
+@lilypond[verbatim,quote,staffsize=16]
\header { tagline = ##f }
\paper { left-margin = 0\mm }
\book {
@code{Y-offset} en el atributo @code{line-break-system-details} del
grob (objeto gráfico) @code{NonMusicalPaperColumn}:
-@lilypond[quote]
+@lilypond[verbatim,quote,staffsize=16]
\header { tagline = ##f }
\paper { left-margin = 0\mm }
\book {
usando la subpropiedad @code{alignment-distances} de
@code{line-break-system-details}.
-@lilypond[quote]
+@lilypond[verbatim,quote,staffsize=16]
\header { tagline = ##f }
\paper { left-margin = 0\mm }
\book {
observe que @code{alignment-distances} especifica el posicionamiento
vertical de los pentagramas pero no de los grupos de pentagramas.
-@lilypond[quote]
+@lilypond[verbatim,quote,staffsize=16]
\header { tagline = ##f }
\paper { left-margin = 0\mm }
\book {
@rinternals{StaffSpacing},
@rinternals{NonMusicalPaperColumn}.
+Ensayo sobre grabado musical automatizado:
+@ressay{Espaciado óptico}.
+
@knownissues
@code{Separating_line_group_engraver} y veremos por qué las partituras
proporcionales con frecuencia eliminan este grabador. El ejemplo
siguiente muestra que hay una pequeña cantidad de espacio
-@qq{preparatorio} justo antes de la primera nota de cada sistema.
+@qq{preliminar} justo antes de la primera nota de cada sistema.
@lilypond[quote,verbatim,ragged-right]
\paper {
@end lilypond
-Esta cantidad de espacio preparatorio es la misma ya sea después de
+Esta cantidad de espacio preliminar es la misma ya sea después de
una indicación de compás, una armadura o una clave. El grabador
@code{Separating_line_group_engraver} es responsable de este espacio.
La eliminación de @code{Separating_line_group_engraver} reduce este
La salida de @code{annotate-spacing} revela las dimensiones verticales
con gran detalle. Para ver más detalles acerca de la modificación de
los márgenes y otras variables de diseño de la página, consulte
-@ref{Formateo de las páginas}.
+@ref{Disposición de la página}.
Aparte de los márgenes, hay algunas otras opciones para ahorrar espacio:
@example
\paper @{
- system-system-spacing = #'((padding . 0) (space . 0.1))
+ system-system-spacing = #'((basic-distance . 0.1) (padding . 0))
ragged-last-bottom = ##f
ragged-bottom = ##f
@}
@seealso
Referencia de la notación:
-@ref{Formateo de las páginas},
+@ref{Disposición de la página},
@ref{Cambiar el espaciado horizontal}.
Fragmentos de código:
projects / lilypond.git / blobdiff