@c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
@ignore
- Translation of GIT committish: 17ca0c2843f39775c3a9632e132b62dceba19a69
+ Translation of GIT committish: b2bdfeb83d3dd8460ffe0afef5f99e08dbe7f1ba
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.15.20"
+@c \version "2.17.0"
@ignore
GDP TODO list
@code{\paper} 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{Cabeceras pies y títulos personalizados}.
+estudian en @ref{Títulos encabezamientos y pies de página personalizados}.
Casi todas las variables de @code{\paper} funcionan solamente dentro
de un bloque @code{\paper}. Las pocas que funcionan también en un
@seealso
Referencia de la notación:
@ref{Tamaño del papel y escalado automático},
-@ref{Cabeceras pies y títulos personalizados},
+@ref{Títulos encabezamientos y pies de página personalizados},
@ref{El bloque \layout}.
Archivos instalados:
@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
-predeterminado) y @code{set-paper-size} (establecer tamaño de página).
-@code{set-default-paper-size} se debe poner en el ámbito del nivel
-superior, y @code{set-paper-size} se debe poner en un bloque
-@code{\paper}:
+@q{A4} es el valor predeterminado si no se establece ningún tamaño de
+página explícitamente. Sin embargo, existen dos funciones que se
+pueden usar para modificarlo: @code{set-default-paper-size},
@example
-#(set-default-paper-size "a4")
+#(set-default-paper-size "quarto")
@end example
+que siempre se debe colocar en el ámbito superior, y
+@code{set-paper-size},
+
@example
\paper @{
- #(set-paper-size "a4")
+ #(set-paper-size "tabloid")
@}
@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}.
+que se debe colocar siempre dentro de un bloque @code{\paper}.
+Si se usa la función @code{set-default-paper-size} en el ámbito
+superior jerárquico, debe ir antes de cualquier bloque @code{\paper}.
@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
@code{\paper} está dentro de un bloque @code{\book}, entonces el
tamaño del papel sólo se aplica a ese libro.
-Se encuentran disponibles los tamaños de papel más comunes, entre
-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}.
+Cuando se usa la función @code{set-paper-size}, se debe colocar
+@emph{antes} de cualquier otra función que se utilice dentro del mismo
+bloque @code{\paper}. Véase @ref{Escalado automático al tamaño del
+papel}.
+
+Los tamaños de página están definidos en el archivo
+@file{scm/paper.scm}, y aunque es posible añadir tamaños
+personalizados, se sobreescribirán en las actualizaciones del software
+posteriores. La lista de todos los tamaños de papel disponibles
+está en @ref{Tamaños de página predefinidos}.
-@c TODO add a new appendix for paper sizes (auto-generated) -pm
+@c An appendix entry exists for paper sizes but is not auto-generated
-@warning{El tamaño predeterminado del papel es @code{a4}.}
+Se puede usar la siguiente instrucción en el archivo para añadir un
+tamaño de página personalizado que se puede usar después con
+@code{set-default-paper-size} o con @code{set-paper-size} según
+convenga,
+
+@example
+#(set! paper-alist (cons '("mi tamaño" . (cons (* 15 in) (* 3 in))) paper-alist))
+
+\paper @{
+ #(set-paper-size "mi tamaño")
+@}
+@end example
-Se pueden añadir tamaños adicionales editando la definición de
-@code{paper-alist} en el archivo de inicio @file{scm/paper.scm},
-aunque se sobreescribirán en la siguiente reinstalación del programa.
+Se puede usar cualquiera de las unidades @code{in} (pulgadas),
+@code{cm} (centímetros) o @code{mm} (milímetros).
-@cindex orientación
-@cindex apaisado
-@cindex horizontal, papel
+@cindex papel, tamaño, orientación
+@cindex página, orientación de la
+@cindex papel, tamaño, apaisado
-Si se añade el símbolo @code{'landscape} (apaisado) como argumento a
-@code{set-default-paper-size}, las páginas se giran 90 grados y se
-establece en consonancia una mayor longitud de las líneas.
+Si se añade el símbolo @code{'landscape} a la función del tamaño de la
+página, el papel se gira 90 grados y se establece adecuadamente la
+anchura de las líneas.
@example
#(set-default-paper-size "a6" 'landscape)
@end example
+Se pueden intercambiar las dimensiones del papel @emph{sin que la
+impresión resulte girada} (como cuando se imprime en tamaño tarjeta
+postal, o al crear gráficos para su inclusión en lugar de un documento
+independiente) añadiendo @samp{landscape} después del nombre del
+propio tamaño del papel:
+
+@example
+#(set-default-paper-size "a6landscape")
+@end example
+
+Cuando el tamaño del papel termina de forma explícita con
+@samp{landscape} o con @samp{portrait}, la presencia de un símbolo
+@code{'landscape} @emph{solamente} afecta a la orientación de la
+impresión, no a las dimensiones del papel que se usan para la
+disposición.
+
@seealso
Referencia de la notación:
-@ref{Escalado automático al tamaño del papel}.
+@ref{Escalado automático al tamaño del papel},
+@ref{Tamaños de página predefinidos}.
Archivos instalados:
@file{scm/paper.scm}.
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
+dos o más páginas deben tener este valor fijado a falso. También
afecta a la última página de las partes de libro, es decir, partes de
un libro creadas con bloques @code{\bookpart}.
@rlsr{Spacing}.
@knownissues
-
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
@end itemize
+Para partituras de varias páginas con la parte inferior
+no justificada en la última página, ésta usará el mismo
+espaciado que la página anterior
+siempre y cuando haya espacio suficiente para ello.
+
Los métodos específicos para la modificación de las listas-A se
estudian en @ref{Modificación de las listas-A}. El siguiente ejemplo
muestra las dos formas en que pueden modificarse estas listas-A. La
@file{ly/paper-defaults-init.ly}.
@knownissues
-
Los tamaños de papel definidos explícitamente
sobreescriben cualquier ajuste de los márgenes
izquierdo o derecho definidos por el usuario.
acuerdo con ello. Solamente funciona con @code{two-sided} fijado al
valor verdadero.
-
@end table
@seealso
@table @code
-@item blank-after-score-page-force
-@funindex blank-after-score-page-force
+@item blank-after-score-page-penalty
+@funindex blank-after-score-page-penalty
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
+que @code{blank-page-penalty}, 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
+@item blank-last-page-penalty
+@funindex blank-last-page-penalty
Penalización por terminar la partitura sobre una página impar.
-@item blank-page-force
-@funindex blank-page-force
+@item blank-page-penalty
+@funindex blank-page-penalty
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
@ref{Saltos de página},
@ref{Saltos de página óptimos},
@ref{Paso de página óptimo},
-@ref{Saltos de página mínimos}.
+@ref{Saltos de página mínimos},
+@ref{Saltos de página de una línea}.
Archivos de inicio:
@file{ly/paper-defaults-init.ly}.
@end table
-
@seealso
Archivos de inicio:
@file{ly/titling-init.ly}.
Fragmentos de código:
@rlsr{Spacing}.
-
@knownissues
-
El encabezamiento de página predeterminado pone el número de página y
el campo @code{instrument} del bloque @code{\header} sobre la misma
línea.
@}
@end example
+Se pueden escribir varios bloques @code{\layout} como expresiones del
+nivel superior. Esto puede ser útil, por ejemplo, si hay distintos
+ajustes almacenados en diversos archivos y se incluyen opcionalmente.
+Internamente, cuando se evalúa un bloque @code{\layout}, se hace una
+copia de la configuración de @code{\layout} actual, y después se
+aplican los cambios definidos en el bloque; el resultado se guarda
+como la nueva configuración actual. Desde el punto de vista del
+usuario, los bloques @code{\layout} se combinan, pero en situaciones
+de conflicto (cuando se cambia la misma propiedad en diferentes
+bloques) las definiciones más tarías toman precedencia.
+
+Por ejemplo: si este bloque:
+
+@example
+\layout @{
+ \context @{
+ \Voice
+ \override TextScript #'color = #magenta
+ \override Glissando #'thickness = #1.5
+ @}
+@}
+@end example
+
+se coloca después del del ejemplo anterior, las sobreescrituras de
+@code{'padding} y de @code{'color} para @code{TextScript} se combinan,
+pero la última sobreescritura @code{'thickness} para @code{Glissando}
+sustituye (u oculta) a la anterior.
+
+Los bloques @code{\layout} se pueden asignar a variables para una
+reutilización posterior, pero la forma en que esto funciona es ligera
+y significativamente diferente del hecho de escribirlas literalmente.
+
+Si se define una variable de la siguiente manera:
+
+@example
+variable_de_Layout = \layout @{
+ \context @{
+ \Voice
+ \override NoteHead #'font-size = #4
+ @}
+@}
+@end example
+
+guardará la configuración actual de @code{\layout} con la
+sobreescritura añadida de @code{NoteHead #'font-size}, pero esta
+combinación @emph{no} se guarda como la nueva configuración actual.
+Tenga en cuenta que la @q{configuración actual} se lee cuando la
+variable se define y no cuando se usa, de manera que el contenido de
+la variable depende de su posición dentro del código fuente.
+
+La variable se puede entonces usar dentro de otro bloque
+@code{\layout}, por ejemplo:
+
+@example
+\layout @{
+ \variable_de_layout
+ \context @{
+ \Voice
+ \override NoteHead #'color = #red
+ @}
+@}
+@end example
+
+Un bloque @code{\layout} que contiene una variable, como en el ejemplo
+anterior, @emph{no} copia la configuración actual, sino que en lugar
+de ello usa el contenido de @code{\variable_de_layout} como la
+configuración base para las adiciones posteriores. Esto significa que
+cualquier cambio definido entre la definición y el uso de la variable,
+se pierde.
+
+Si la @code{variable_de_layout} se define (o se incluye con
+@code{\include}) inmediatamente antes de que se utilice, su contenido
+es sencillamente la configuración en curso más las sobreescrituras que
+se hayan definido dentro de él. Así pues, en el ejemplo anterior que
+muestra el uso de @code{\variable_de_layout} el último bloque
+@code{\layout} consistiría en:
+
+@example
+ TextScript #'padding = #1
+ TextScript #'color = #magenta
+ Glissando #'thickness = #1.5
+ NoteHead #' font-size = #4
+ NoteHead #' color = #red
+@end example
+
+más las sobreescrituras de @code{indent} y de @code{StaffGrouper}.
+
+Pero si la variable ya hubiera sido definida antes del primer bloque
+@code{\layout} la configuración actual contendría ahora solamente
+
+@example
+ NoteHead #' font-size= #4 % (escrita en la definición de la variable)
+ NoteHead #' color = #red % (añadida después del uso de la variable)
+@end example
+
+Si se planifica cuidadosamente, las variables de @code{\layout} pueden
+ser una herramienta valiosa para estructurar el diseño de la
+disposición de las fuentes, y tambiién para reiniciar la configuración
+de @code{\layout} a un estado conocido.
@seealso
Referencia de la notación:
afinar el tamaño de los pentagramas individuales. Los tamaños de
pentagrama individuales están en relación al tamaño global.
-
@seealso
Referencia de la notación:
@ref{Seleccionar el tamaño de la tipografía para la notación}.
Fragmentos de código:
@rlsr{Spacing}.
-
@knownissues
-
@code{layout-set-staff-size} no cambia la distancia entre las líneas
del pentagrama.
* Saltos de página óptimos::
* Paso de página óptimo::
* Saltos de página mínimos::
+* Saltos de página de una línea::
* Saltos de línea explícitos::
* Utilizar una voz adicional para los saltos de línea::
@end menu
@lilypond[quote,ragged-right,verbatim]
\new Voice \with {
- \remove Forbid_line_break_engraver
+ \remove "Forbid_line_break_engraver"
} \relative c'' {
<<
{ c2. \times 2/3 { c4 c c } c2. | }
@}
@end example
-
-
@cindex saltos de línea normales
@cindex música de cuatro compases por línea
>>
@end example
-@c TODO Check this
-Una configuración de división de líneas se puede guardar como archivo
-@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}.
-
@predefined
@funindex \break
@code{\noBreak}.
@endpredefined
-
@seealso
Referencia de la notación:
@ref{Variables de \paper para los saltos de línea}.
@}
@end example
-
@predefined
@funindex \pageBreak
@code{\pageBreak},
@code{\noPageBreak}.
@endpredefined
-
@seealso
Referencia de la notación:
@ref{Variables de \paper para los saltos de página}.
@code{ly:page-turn-breaking}, no tiene un concepto de los pasos de
página.
-
@seealso
Fragmentos de código:
@rlsr{Spacing}.
el nivel más elevado del código, entre las partituras y los elementos
de marcado del nivel superior.
-
@predefined
@funindex \pageTurn
@code{\pageTurn},
@code{\allowPageTurn}.
@endpredefined
-
@seealso
Fragmentos de código:
@rlsr{Spacing}.
-
@knownissues
-
Sólo debería haber un grabador @code{Page_turn_engraver} dentro de una
partitura. Si hay más de uno, se interferirán entre sí.
@}
@end example
-
@seealso
Fragmentos de código:
@rlsr{Spacing}.
+@node Saltos de página de una línea
+@subsection Saltos de página de una línea
+@translationof One-line page breaking
+
+@funindex ly:one-line-breaking
+
+La función @code{ly:one-line-breaking} es un algoritmo de saltos de
+página para uso especial que pone cada partitura en una página y en
+una sola línea. Esta función de salto de página no compone los
+títulos ni los márgenes; solamente se imprime la partitura.
+
+El ancho de la página se ajusta de forma que la partitura más larga
+quepa en una línea. Concretamente, las variables @code{paper-width},
+@code{line-width} y @code{indent} del bloque @code{\paper} se ignoran,
+aunque @code{left-margin} y @code{right-margin} aún se respetan. La
+altura de la página se deja sin cambios.
@node Saltos de línea explícitos
@subsection Saltos de línea explícitos
}
@end lilypond
-
@seealso
Fragmentos de código:
@rlsr{Spacing}.
}
@end lilypond
-
@seealso
Referencia de la notación:
@ref{Espaciado vertical}.
en las descripciones de contexto correspondientes en
@rinternals{Contexts}.
-
@subsubheading Propiedades del grob @code{VerticalAxisGroup}
Las propiedades de @code{VerticalAxisGroup} se suelen ajustar con una
pauta a la que no pertenece.
@end table
-
@subsubheading Propiedades del grob @code{StaffGrouper}
Las propiedades de @code{StaffGrouper} se suelen ajustar con una
@ref{Variables de espaciado de \paper verticales flexibles},
@ref{Modificación de las listas-A}.
+Archivos de inicio:
+@file{ly/engraver-init.ly},
+@file{scm/define-grobs.scm}.
+
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
>>
@end lilypond
-
@seealso
Archivos de inicio:
@file{ly/engraver-init.ly},
a los diferentes ajustes unos valores razonables.
@end itemize
-
@seealso
Fragmentos de código:
@rlsr{Spacing}.
posicionados previamente se puede controlar con
@code{outside-staff-padding}.
-@lilypond[quote,ragged-right,relative=2,verbatim]
+@lilypond[quote,ragged-right,relative=2,verbatim,staffsize=18]
\once \override TextScript #'outside-staff-padding = #0
a'^"This text is placed very close to the note"
\once \override TextScript #'outside-staff-padding = #3
c''2
@end lilypond
-
@seealso
Fragmentos de código:
@rlsr{Spacing}.
c2 c4. c8 c4. c16[ c] c4. c8 c8 c8 c4 c4 c4
@end lilypond
-
En el @emph{Ensayo sobre grabado musical automatizado},
se explicó que las
direcciones de las plicas influyen en el espaciado
Está contemplada la notación proporcional; consulte
@ref{Notación proporcional}.
-
@seealso
+Ensayo sobre grabado musical automatizado:
+@ressay{Espaciado óptico}.
+
Fragmentos de código:
@rlsr{Spacing}.
@rinternals{StaffSpacing},
@rinternals{NonMusicalPaperColumn}.
-Ensayo sobre grabado musical automatizado:
-@ressay{Espaciado óptico}.
-
-
@knownissues
-
No existe ningún mecanismo conveniente para sobreescribir el espaciado
manualmente. Se puede usar el siguiente rodeo para insertar espacio
adicional en una partitura, ajustando el valor del relleno en la
@code{SpacingSpanner}, y de ahí que se puedan usar nuevas
instrucciones de sobreescritura @code{\override} en dicho punto.
-
@seealso
Fragmentos de código:
@rlsr{Spacing}.
}
@end lilypond
-
@snippets
-
De forma predeterminada, el espaciado en los grupos de valoración
especial depende de varios factores ajenos a la duración (como
alteraciones, cambios de clave, etc.). Para pasar por alto estos
\new Staff { c8[ c \clef alto c \grace { c16[ c] } c8 c c] c32[ c32] }
@end lilypond
-
@seealso
Fragmentos de código:
@rlsr{Spacing}.
El valor normal predeterminado es falso, pero si la partitura
tiene un solo sistema, el valor predeterminado es verdadero.
-
@cindex diseño de página
@cindex página, disposición de la
@cindex vertical, espaciado
@}
@end example
-
@seealso
Fragmentos de código:
@rlsr{Spacing}.
@item @code{proportionalNotationDuration}
@item @code{uniform-stretching}
@item @code{strict-note-spacing}
-@item @code{\remove Separating_line_group_engraver}
+@item @code{\remove "Separating_line_group_engraver"}
@item @code{\override PaperColumn #'used = ##t}
@end itemize
}
@end lilypond
-
Pero si observamos con mucho cuidado podremos ver que las notas de la
segunda mitad del 9-illo están espaciadas de forma ligeramente más
ancha que las de la primera mitad del 9-illo. Para asegurar una
}
@end lilypond
-
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.
}
\new Staff \with {
- \remove Separating_line_group_engraver
+ \remove "Separating_line_group_engraver"
} {
c'1
\break
@item @code{\override Beam #'breakable = ##t}
@item @code{\override Glissando #'breakable = ##t}
@item @code{\override TextSpanner #'breakable = ##t}
-@item @code{\remove Forbid_line_break_engraver in the Voice context}
+@item @code{\remove "Forbid_line_break_engraver" in the Voice context}
@end itemize
Estos ajustes dan a las notas de adorno un espaciado estricto,
extensión se dividan entre los sistemas y las páginas. Consulte las
partes respectivas del manual para ver estos ajustes relacionados.
-
@seealso
Referencia de la notación:
@ref{Área de espaciado nueva}.
}
@end lilypond
-
@noindent
Todas las dimensiones de disposición se muestran en espacios de
pentagrama, independientemente de las unidades especificadas en los
intervalos, donde @var{a} es el límite inferior y @var{b} es el límite
superior del intervalo.
-
@seealso
Referencia de la notación:
@ref{Establecer el tamaño del pentagrama}.
@}
@end example
+@item
+Forzar el número de páginas. Por ejemplo, la asignación
+siguiente fuerza una disposición con dos páginas.
+
+@example
+\paper @{
+ page-count = #2
+@}
+@end example
+
@item
Evitar (o reducir en número) los objetos que aumentan el tamaño
vertical de un sistema. Por ejemplo, las repeticiones de primera y
@end itemize
-
@seealso
Referencia de la notación:
@ref{Disposición de la página},
projects / lilypond.git / blobdiff