]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/es/notation/spacing.itely
Doc-es: full update of manuals and texidocs.
[lilypond.git] / Documentation / es / notation / spacing.itely
index 58717452e4e61bee2dca30f842c737dd5b626447..8d18cbdb82beba5129696cdb365ce9b4b2e02b57 100644 (file)
@@ -1,7 +1,7 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
 
 @ignore
-    Translation of GIT committish: 61edc58d607808615f5df61a0164b4bef4d1cfd5
+    Translation of GIT committish: 844e5387a003bde2c10389ad863184defe893b6c
 
     When revising a translation, copy the HEAD committish of the
     version that you are working on.  For details, see the Contributors'
@@ -213,32 +213,27 @@ 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
@@ -247,35 +242,54 @@ aplica el tamaño de papel a todas las páginas.  Si el bloque
 @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,
 
-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.
+@example
+#(set! paper-alist (cons '("mi tamaño" . (cons (* 15 in) (* 3 in))) paper-alist))
 
-@cindex orientación
-@cindex apaisado
-@cindex horizontal, papel
+\paper @{
+  #(set-paper-size "mi tamaño")
+@}
+@end example
 
-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.
+Se puede usar cualquiera de las unidades @code{in} (pulgadas),
+@code{cm} (centímetros) o @code{mm} (milímetros).
+
+@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} 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
 
+La salida de música @emph{no} se gira, solo las dimensiones de la
+página lo hacen.
+
 @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}.
@@ -390,7 +404,6 @@ Fragmentos de código:
 @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
@@ -736,7 +749,6 @@ Archivos de inicio:
 @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.
@@ -787,7 +799,6 @@ modifica, el valor predeterminado de esta dimensión se escala de
 acuerdo con ello.  Solamente funciona con @code{two-sided} fijado al
 valor verdadero.
 
-
 @end table
 
 @seealso
@@ -961,7 +972,8 @@ 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}.
+@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}.
@@ -1067,7 +1079,6 @@ adecuado, por ejemplo:
 
 @end table
 
-
 @seealso
 Archivos de inicio:
 @file{ly/titling-init.ly}.
@@ -1075,9 +1086,7 @@ Archivos de inicio:
 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.
@@ -1159,6 +1168,105 @@ He aquí un ejemplo de un bloque @code{\layout}:
 @}
 @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:
@@ -1267,7 +1375,6 @@ de contexto @code{fontSize} y la propiedad de disposició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}.
@@ -1275,9 +1382,7 @@ Referencia de 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.
 
@@ -1292,6 +1397,7 @@ 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
@@ -1387,8 +1493,6 @@ afecta sólo a la última línea de la pieza.
 @}
 @end example
 
-
-
 @cindex saltos de línea normales
 @cindex música de cuatro compases por línea
 
@@ -1415,7 +1519,6 @@ 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{\break},
@@ -1423,7 +1526,6 @@ novedosa y difícil.  Hay más detalles disponibles en @rlsr{Spacing}.
 @code{\noBreak}.
 @endpredefined
 
-
 @seealso
 Referencia de la notación:
 @ref{Variables de \paper para los saltos de línea}.
@@ -1507,7 +1609,6 @@ partes del libro.
 @}
 @end example
 
-
 @predefined
 @funindex \pageBreak
 @code{\pageBreak},
@@ -1515,7 +1616,6 @@ partes del libro.
 @code{\noPageBreak}.
 @endpredefined
 
-
 @seealso
 Referencia de la notación:
 @ref{Variables de \paper para los saltos de página}.
@@ -1537,7 +1637,6 @@ distensión, tanto horizontal como verticalmente.  A diferencia de
 @code{ly:page-turn-breaking}, no tiene un concepto de los pasos de
 página.
 
-
 @seealso
 Fragmentos de código:
 @rlsr{Spacing}.
@@ -1619,7 +1718,6 @@ Las instrucciones de paso de página, @code{\pageTurn},
 el nivel más elevado del código, entre las partituras y los elementos
 de marcado del nivel superior.
 
-
 @predefined
 @funindex \pageTurn
 @code{\pageTurn},
@@ -1629,14 +1727,11 @@ de marcado del nivel superior.
 @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í.
 
@@ -1660,11 +1755,26 @@ de memoria, o con una gran cantidad de textos.  Se habilita utilizando:
 @}
 @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
@@ -1715,7 +1825,6 @@ music = \relative c'' { c8 c c c }
 }
 @end lilypond
 
-
 @seealso
 Fragmentos de código:
 @rlsr{Spacing}.
@@ -1807,7 +1916,6 @@ music = \relative c'' { c4 c c c }
 }
 @end lilypond
 
-
 @seealso
 Referencia de la notación:
 @ref{Espaciado vertical}.
@@ -2074,7 +2182,6 @@ los tipos específicos de líneas que no son pautas están relacionadas
 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
@@ -2156,7 +2263,6 @@ una cantidad de relleno mínima entre una línea de @code{Lyrics} y la
 pauta a la que no pertenece.
 @end table
 
-
 @subsubheading Propiedades del grob @code{StaffGrouper}
 
 Las propiedades de @code{StaffGrouper} se suelen ajustar con una
@@ -2187,14 +2293,15 @@ Referencia de la notación:
 @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
@@ -2404,7 +2511,6 @@ la línea de letra es capaz de ampliarse mucho más de lo que es usual:
 >>
 @end lilypond
 
-
 @seealso
 Archivos de inicio:
 @file{ly/engraver-init.ly},
@@ -2660,7 +2766,6 @@ pentagramas o sistemas unos encima de otros.  Esto se evitaría pasando
 a los diferentes ajustes unos valores razonables.
 @end itemize
 
-
 @seealso
 Fragmentos de código:
 @rlsr{Spacing}.
@@ -2717,7 +2822,7 @@ El relleno vertical entre un objeto fuera del pentagrama y los grobs
 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
@@ -2748,7 +2853,6 @@ c4
 c''2
 @end lilypond
 
-
 @seealso
 Fragmentos de código:
 @rlsr{Spacing}.
@@ -2837,7 +2941,6 @@ semicorcheas al ejemplo anterior, irían seguidas por medio ACB:
 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
@@ -2864,8 +2967,10 @@ con los valores predeterminados y otra con correcciones exageradas:
 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}.
 
@@ -2875,12 +2980,7 @@ Referencia de funcionamiento interno:
 @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
@@ -2917,7 +3017,6 @@ La instrucción @code{\newSpacingSection} crea un nuevo objeto
 @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}.
@@ -2966,9 +3065,7 @@ que @code{ly:make-moment} construye una duración, por lo que @code{1
 }
 @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
@@ -3009,7 +3106,6 @@ sin tener en cuenta las claves, líneas divisorias ni notas de adorno:
 \new Staff { c8[ c \clef alto c \grace { c16[ c] } c8 c c]  c32[ c32] }
 @end lilypond
 
-
 @seealso
 Fragmentos de código:
 @rlsr{Spacing}.
@@ -3045,7 +3141,6 @@ comprobar qué tan apretado es el espaciado natural.
 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
@@ -3068,7 +3163,6 @@ ocupa su longitud horizontal natural.
 @}
 @end example
 
-
 @seealso
 Fragmentos de código:
 @rlsr{Spacing}.
@@ -3308,7 +3402,6 @@ soluciona.
 }
 @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
@@ -3387,7 +3480,6 @@ siguiente muestra que hay una pequeña cantidad de espacio
 }
 @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.
@@ -3477,7 +3569,6 @@ puntos de comienzo como de final, y permiten que los elementos de
 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}.
@@ -3526,7 +3617,6 @@ página, establezca @code{annotate-spacing} en el bloque @code{\paper}:
 }
 @end lilypond
 
-
 @noindent
 Todas las dimensiones de disposición se muestran en espacios de
 pentagrama, independientemente de las unidades especificadas en los
@@ -3555,7 +3645,6 @@ En este caso, un @code{staff-space} equivale aproximadamente a
 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}.
@@ -3608,6 +3697,16 @@ disposición con 10 sistemas.
 @}
 @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
@@ -3673,7 +3772,6 @@ completa.
 
 @end itemize
 
-
 @seealso
 Referencia de la notación:
 @ref{Disposición de la página},