]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/es/notation/spacing.itely
Merge branch 'translation' into staging
[lilypond.git] / Documentation / es / notation / spacing.itely
index 48a61c049bda5bf2df236460626ce66534bccb66..06b6f496c87ccf7b55be0de0857412a1c1d0c35b 100644 (file)
@@ -1,14 +1,14 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
 
 @ignore
-    Translation of GIT committish: 312f7ebc83ec9fb8cbbddfcf78b65a8502c16ab2
+    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
@@ -141,7 +141,7 @@ La función @code{set-paper-size} se estudia en la sección siguiente,
 @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
@@ -187,7 +187,7 @@ El equivalente de Scheme del ejemplo anterior es:
 @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:
@@ -283,8 +283,21 @@ anchura de las líneas.
 #(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.
+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:
@@ -921,21 +934,21 @@ en el archivo @file{ly/paper-defaults-init.ly}
 
 @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
@@ -972,7 +985,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}.
@@ -1167,6 +1181,106 @@ 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:
 @ref{Cambiar los valores por omisión de los contextos}.
@@ -1296,6 +1410,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
@@ -1344,7 +1459,7 @@ paralelo con la música:
 
 @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. | }
@@ -1410,12 +1525,6 @@ compases, y sólo en dichos lugares:
 >>
 @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
@@ -1657,6 +1766,22 @@ de memoria, o con una gran cantidad de textos.  Se habilita utilizando:
 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
@@ -2704,7 +2829,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
@@ -3070,7 +3195,7 @@ proporcional, que se pueden usar solos o combinados:
 @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
 
@@ -3374,7 +3499,7 @@ espacio a cero.
 }
 
 \new Staff \with {
-  \remove Separating_line_group_engraver
+  \remove "Separating_line_group_engraver"
 } {
   c'1
   \break
@@ -3442,7 +3567,7 @@ frecuencia en las partituras proporcionales.  Entre ellos están:
 @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,