X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Fes%2Fnotation%2Fspacing.itely;h=788ada17e802c5ea71092528a4ed1247e17fc5cc;hb=9b5c4a447d35e1f6fcedaf692587c23cc4554a5c;hp=49dcb003e2e093858a4c19384f1ea07b1c53d9b1;hpb=55ac733b69643a6bc6a83b706c65cb56efd388ef;p=lilypond.git diff --git a/Documentation/es/notation/spacing.itely b/Documentation/es/notation/spacing.itely index 49dcb003e2..788ada17e8 100644 --- a/Documentation/es/notation/spacing.itely +++ b/Documentation/es/notation/spacing.itely @@ -1,14 +1,57 @@ @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*- @ignore - Translation of GIT committish: efa7af705ab6beb1f9c4d71ef4897b103f69b23c + Translation of GIT committish: 17ca0c2843f39775c3a9632e132b62dceba19a69 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.42" +@c \version "2.15.20" + +@ignore +GDP TODO list +This block comment is copied here to ease comparation of +original and its translation. + +Negative numbers are allowed: +> Are you sure? The following works well +> \paper{ +> first-page-number = -2 +> } +> and prints page number -1 on the second page, for example. + + +In 5.2.1 the @refbugs (line 495 in spacing.itely on master) it +states: + +"@code{layout-set-staff-size} does not change the distance between +the +staff lines." + +Could we add a sentence: +"Use instead the pair fontSize = #@var{N} + \override StaffSymbol #'staff-space = #(magstep +@var{N}) +inside the Staff context to change the size of the font and the +distance between +staff lines accordingly." + +Actually I found, that the @internalsref{StaffSymbol} at line 481 +sends to an incomplete +documentation. The property staff-space is not explained here. I +thought Y-extent might be of +help, but it is in turn explained by x-space which again is +missing from the list. Who has the +knowledge to fix this? + + +Clarify +http://code.google.com/p/lilypond/issues/detail?id=68 + +@end ignore + @node Problemas de espaciado @chapter Problemas de espaciado @@ -95,10 +138,10 @@ los encabezamientos, pies y títulos. 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 +@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{Encabezamientos pies y títulos personalizados}. +estudian en @ref{Cabeceras 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 @@ -106,8 +149,8 @@ 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 +en milímetros, a no ser que el usuario especifique unas unidades +diferentes. Por ejemplo, la declaración siguiente establece el margen superior @code{top-margin} a diez milímetros: @example @@ -144,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{Encabezamientos pies y títulos personalizados}, +@ref{Cabeceras pies y títulos personalizados}, @ref{El bloque \layout}. Archivos instalados: @@ -353,6 +396,10 @@ 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. +Los tamaños de papel definidos explícitamente +sobreescriben cualquier ajuste de los márgenes +superior o inferior definidos por el usuario. + @node Variables de espaciado de \paper verticales flexibles @subsection Variables de espaciado de @code{\paper} verticales flexibles @@ -683,6 +730,12 @@ Referencia de la notación: 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. + @node Variables de \paper para el modo de doble cara @unnumberedsubsubsec Variables de @code{\paper} para el modo de doble cara @@ -918,6 +971,7 @@ en el archivo @file{ly/paper-defaults-init.ly} @table @code +@cindex números de página, automáticos @item auto-first-page-number @funindex auto-first-page-number @@ -928,6 +982,7 @@ 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}. +@cindex números de página, especificar el primero @item first-page-number @funindex first-page-number @@ -939,6 +994,7 @@ Valor del número de pátina en la primera página. 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 @@ -956,6 +1012,7 @@ 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. + @node Variables de \paper diversas @unnumberedsubsubsec Variables de @code{\paper} diversas @translationof Miscellaneous \paper variables @@ -968,7 +1025,7 @@ de manera que la página 1 esté en el lado derecho. 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}. +@code{10}. @item print-all-headers @funindex print-all-headers @@ -1392,7 +1449,7 @@ elementos de marcado situados en el nivel superior. Hay ajustes análogos a @code{ragged-right} y @code{ragged-last} que tienen el mismo efecto sobre el espaciado vertical: @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 +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. Véase @ref{Variables de espaciado de \paper verticales fijas}. @@ -1523,7 +1580,7 @@ El grabador @code{Page_turn_engraver} lee la propiedad de contexto @code{minimumPageTurnLength} para determinar qué longitud debe tener una sección sin notas antes de que se considere la posibilidad de un paso de página. El valor predeterminado para -@code{minimumPageTurnLength} es @code{#(ly:make-moment 1 1)}. Si +@code{minimumPageTurnLength} es @code{(ly:make-moment 1 1)}. Si quiere inhabilitar las vueltas de página, puede establecerlo a algún valor muy grande. @@ -1819,6 +1876,7 @@ controla mediante variables de @code{\paper} que se estudian en * Propiedades de espaciado dentro de los sistemas:: * Espaciado de pautas no agrupadas:: * Espaciado de pautas agrupadas:: +* Espaciado de las líneas que no son pautas:: @end menu @@ -1826,6 +1884,19 @@ controla mediante variables de @code{\paper} que se estudian en @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 @@ -1842,7 +1913,7 @@ 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 hacia arriba a partir de la línea del tipo no-pauta si @code{staff-affinity} es -@code{#UP}. +@code{UP}. Cada distancia se mide entre los @emph{puntos de referencia} de los dos elementos. El @emph{punto de referencia} para un pentagrama y @@ -1882,14 +1953,16 @@ labelContext = #(define-music-function (parser location context) (string?) - #{ s1*0^\markup { \typewriter $context } #}) + #{ s1*0^\markup { \typewriter #context } #}) \layout { \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 @@ -1910,8 +1983,8 @@ labelContext = \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 | } } @@ -1923,7 +1996,7 @@ labelContext = \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 @@ -1947,8 +2020,8 @@ labelContext = @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{Flexible vertical spacing \paper variables}. En @ref{Modificación de las listas-A} @@ -1963,11 +2036,12 @@ forma individual, y la segunda redefine la propiedad completamente: @example \new Staff \with @{ - \override VerticalAxisGroup #'staff-staff-spacing #'basic-distance = #10 + \override VerticalAxisGroup #'default-staff-staff-spacing + #'basic-distance = #10 @} @{ @dots{} @} \new Staff \with @{ - \override VerticalAxisGroup #'staff-staff-spacing = + \override VerticalAxisGroup #'default-staff-staff-spacing = #'((basic-distance . 10) (minimum-distance . 9) (padding . 1) @@ -1982,7 +2056,8 @@ póngalos dentro del bloque @code{\layout}: \layout @{ \context @{ \Staff - \override VerticalAxisGroup #'staff-staff-spacing #'basic-distance = #10 + \override VerticalAxisGroup #'default-staff-staff-spacing + #'basic-distance = #10 @} @} @end example @@ -2003,19 +2078,27 @@ equivalente). @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 sustituye 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 @@ -2033,8 +2116,9 @@ inferior deben usar @code{UP}. El ajuste de @code{staff-affinity} 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 @@ -2044,6 +2128,13 @@ línea que no sea una pauta entre las dos, y @code{staff-affinity} es 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 @@ -2071,9 +2162,9 @@ equivalente). @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á @@ -2081,21 +2172,25 @@ justo por debajo de ella dentro del mismo sistema, incluso si existen 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 @@ -2112,6 +2207,7 @@ agrupadas}: @itemize @item Propiedades de @code{VerticalAxisGroup}: @itemize +@item @code{default-staff-staff-spacing} @item @code{staff-staff-spacing} @end itemize @end itemize @@ -2123,21 +2219,24 @@ 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 = + \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 'basic-distance % can provide, so the distance between this staff and the next % is determined by 'padding. @@ -2152,7 +2251,7 @@ agrupadas: % By setting 'padding to a negative value, staves can be made to % collide. The lowest acceptable value for 'basic-distance is 0. \new Staff \with { - \override VerticalAxisGroup #'staff-staff-spacing = + \override VerticalAxisGroup #'default-staff-staff-spacing = #'((basic-distance . 3.5) (padding . -10)) } { \clef bass g2 r | } @@ -2190,7 +2289,6 @@ de los grupos: @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 @@ -2241,7 +2339,9 @@ Referencia de funcionamiento interno: @rinternals{StaffGrouper}. +@node Espaciado de las líneas que no son pautas @unnumberedsubsubsec Espaciado de las líneas que no son pautas +@translationof Spacing of non-staff lines Las @emph{Líneas que no son pautas} (tales como @code{Lyrics}, @code{ChordNames}, etc.) son contextos cuyos objetos de presentación @@ -2710,7 +2810,7 @@ manera: en cada compás se determina la duración más breve. La menor duración más común se toma como base para el espaciado, habiendo estipulado que esta duración menor siempre debe ser igual o menor que una corchea. La duración más breve se imprime cuando se ejecuta -@code{lilypond} con la opción @code{--verbose}. +@code{lilypond} con la opción @option{--verbose}. Estas duraciones también se pueden personalizar. Si establecemos la @code{common-shortest-duration} en @rinternals{SpacingSpanner}, @@ -2770,6 +2870,9 @@ Referencia de funcionamiento interno: @rinternals{StaffSpacing}, @rinternals{NonMusicalPaperColumn}. +Ensayo sobre grabado musical automatizado: +@ressay{Espaciado óptico}. + @knownissues @@ -3065,11 +3168,11 @@ argumento, que es la duración de referencia contra el que se aplica el espaciado de toda la música. La función Scheme de LilyPond @code{make-moment} acepta dos argumentos: un numerador y un denominador que, juntos, expresan una cierta fracción de redonda. La -llamada @code{#(ly:make-moment 1 20)}, por tanto, produce una duración +llamada @code{(ly:make-moment 1 20)}, por tanto, produce una duración de referencia de una nota de un veinteavo de redonda (semicorcheas de cinquillo). Son también posibles valores como -@code{#(ly:make-moment 1 16)}, -@code{#(ly:make-moment 1 8)} y @code{#(ly:make-moment 3 97)}. +@code{(ly:make-moment 1 16)}, +@code{(ly:make-moment 1 8)} y @code{(ly:make-moment 3 97)}. ¿Cómo seleccionamos la duración correcta de referencia para pasarla a @code{proportionalNotationDuration}? Normalmente mediante un proceso @@ -3265,7 +3368,7 @@ A continuación examinamos los efectos del grabador @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 { @@ -3280,7 +3383,7 @@ siguiente muestra que hay una pequeña cantidad de espacio @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 @@ -3383,9 +3486,9 @@ Fragmentos de código: @translationof Fitting music onto fewer pages En ocasiones, podemos terminar con uno o dos pentagramas en una -segunda página (o tercera, o cuarta...). Es fastidioso, especialmente -cuando vemos que las páginas anteriores parecen tener espacio de -sobra. +segunda página (o tercera, o cuarta@dots{}). Es fastidioso, +especialmente cuando vemos que las páginas anteriores parecen tener +espacio de sobra. Al investigar los problemas de disposición, una herramienta de valor incalculable es @code{annotate-spacing}. Esta instrucción imprime los