X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Fes%2Flearning%2Ftweaks.itely;h=f0bea441fcbeb92c395a451e1fb7db200a388adc;hb=7b103ac5af05f78d6bb732611719e5be0b7c39d3;hp=c731d3a78ae433697d20c939398ba53880973672;hpb=7eb9c626943a47141ec2cc5fad7723f69e04bbd2;p=lilypond.git diff --git a/Documentation/es/learning/tweaks.itely b/Documentation/es/learning/tweaks.itely index c731d3a78a..f0bea441fc 100644 --- a/Documentation/es/learning/tweaks.itely +++ b/Documentation/es/learning/tweaks.itely @@ -1,7 +1,7 @@ @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*- @ignore - Translation of GIT committish: 10bd5cc93870ac4b884b8cb938cfc6a19c768097 + Translation of GIT committish: 7130696ee590df198a4dc039423dcc1d36512fd9 When revising a translation, copy the HEAD committish of the version that you are working on. For details, see the Contributors' @@ -192,7 +192,8 @@ propiedad. Ya hemos visto las instrucciones @code{\set} y @code{\with}, que se usan para cambiar las propiedades de los @strong{contextos} y para -quitar y poner @strong{grabadores}, en @ref{Modificar las propiedades de los contextos} y @ref{Añadir y eliminar grabadores}. Ahora debemos +quitar y poner @strong{grabadores}, en @ref{Modificar las propiedades de los contextos} +y @ref{Añadir y eliminar grabadores}. Ahora debemos examinar algunas otras instrucciones importantes. La instrucción que cambia las propiedades de los @strong{objetos de @@ -1044,18 +1045,18 @@ describe dicho grob, y esas propiedades se pueden ver mirando dichos interfaces. Hemos explicado cómo encontrar información sobre los grobs en -@ref{Propiedades de los objetos de presentación}. Usando el mismo enfoque, vamos al -RFI para buscar el objeto de presentación que imprime las líneas -divisorias. A través del enlace @emph{Backend} y @emph{All layout -objects} encontramos que hay un objeto de presentación llamado -@code{BarLine}. Entre sus propiedades se encuentran dos que controlan -la visibilidad: @code{break-visibility} y @code{stencil}. Las líneas -divisorias también contemplan un número de interfaces, entre ellos el -@code{grob-interface}, donde podemos encontrar las propiedades -@code{transparent} y @code{color}. Todas ellas pueden afectar la -visibilidad de las barras de compás (y, por supuesto, por extensión, -también la de muchos otros objetos de presentación). Vamos a -considerar cada uno de ellos por orden. +@ref{Propiedades de los objetos de presentación}. Usando el mismo +enfoque, vamos al RFI para buscar el objeto de presentación que +imprime las líneas divisorias. A través del enlace @emph{Backend} y +@emph{All layout objects} encontramos que hay un objeto de +presentación llamado @code{BarLine}. Entre sus propiedades se +encuentran dos que controlan la visibilidad: @code{break-visibility} y +@code{stencil}. Las líneas divisorias también contemplan un número de +interfaces, entre ellos el @code{grob-interface}, donde podemos +encontrar las propiedades @code{transparent} y @code{color}. Todas +ellas pueden afectar la visibilidad de las barras de compás (y, por +supuesto, por extensión, también la de muchos otros objetos de +presentación). Vamos a considerar cada uno de ellos por orden. @subheading stencil (sello) @@ -1267,7 +1268,8 @@ una de las otras funciones de la lista. @funindex x11-color La segunda forma de cambiar el color es utilizar la lista de nombres -de colores de X11 que aparecen en la segunda lista de @ruser{Lista de colores}. Sin embargo, éstos deben ir precedidos de otra función, que +de colores de X11 que aparecen en la segunda lista de @ruser{Lista de +colores}. Sin embargo, éstos deben ir precedidos de otra función, que convierte los nombres de colores de X11 en la lista de valores internos, @code{x11-color}, de la siguiente manera: @@ -2021,8 +2023,7 @@ predeterminada se establece a @code{#f} para todos los objetos dentro-del-pentagrama, y a un valor numérico adecuado a cada objeto fuera-del-pentagrama cuando se crea el objeto. La tabla siguiente presenta los valores numéricos predeterminados para algunos de los -objetos fuera-del-pentagrama que están inicialmente dentro de los -contextos @code{Staff} o @code{Voice}. +objetos fuera-del-pentagrama más comunes. @cindex objetos de extensión @@ -2035,7 +2036,7 @@ tiene ningún efecto. Por ejemplo, cambiar la @code{outside-staff-priority} del objeto de regulador @code{Hairpin} no tiene efecto sobre la posición vertical de los reguladores: en lugar de eso, tenemos que cambar la @code{outside-staff-priority} del -objeto asociado @code{DynamicLineSpanner}. Esta sobreeascritura se +objeto asociado @code{DynamicLineSpanner}. Esta sobreescritura se debe escribir al comienzo del objeto de extensión, que podría incluir varios reguladores o matices dinámicos encadenados. @@ -2043,12 +2044,21 @@ varios reguladores o matices dinámicos encadenados. @headitem Objeto de presentación @tab Prioridad @tab Controla la posición de: +@item @code{RehearsalMark} + @tab @code{1500} + @tab Letras de ensayo +@item @code{MetronomeMark} + @tab @code{1000} + @tab Indicaciones metronómicas +@item @code{VoltaBracketSpanner} + @tab @code{600} + @tab Cajetines de primera y segunda vez +@item @code{TextScript} + @tab @code{450} + @tab Texto en elementos de marcado @item @code{MultiMeasureRestText} @tab @code{450} @tab Texto sobre silencios de compás completo -@item @code{TextScript} - @tab @code{450} - @tab Elementos de marcado de texto @item @code{OttavaBracket} @tab @code{400} @tab Corchetes de octava alta y baja @@ -2060,7 +2070,7 @@ varios reguladores o matices dinámicos encadenados. @tab Todas las indicaciones dinámicas @item @code{VoltaBracketSpanner} @tab @code{100} - @tab Corchetes de primera y segunda vez + @tab Números de compás @item @code{TrillSpanner} @tab @code{50} @tab Trinos mantenidos @@ -2118,27 +2128,6 @@ También muestra la manera de crear corchetes de octava alta y baja. @cindex trucar la situación de las letras de ensayo @cindex ensayo, letras, trucar la colocación -Observe que los números de compás, las indicaciones metronómicas y las -mercas de ensayo no se muestran. De forma predeterminada, se crean -dentro del contexto @code{Score} y su prioridad -@code{outside-staff-priority} se ignora con relación a los objetos de -presentación que se crean dentro del contexto @code{Staff}. Si quiere -colocar los números de compás, indicaciones metronómicas o llamadas de -ensayo en concordancia con el valor de su -@code{outside-staff-priority}, los grabadores -@code{Bar_number_engraver}, @code{Metronome_mark_engraver} o -@code{Mark_engraver} respectivamente se deben eliminar del contexto -@code{Score} y colocarlos en el contexto @code{Staff} del nivel -superior. Si se hace así, estas marcas obtendrán los siguientes -valores predeterminados de @code{outside-staff-priority}: - -@multitable @columnfractions .3 .3 -@headitem Objeto de presentación @tab Prioridad -@item @code{RehearsalMark} @tab @code{1500} -@item @code{MetronomeMark} @tab @code{1000} -@item @code{BarNumber} @tab @code{ 100} -@end multitable - Si los valores predeterminados de @code{outside-staff-priority} no le ofrecen las colocaciones deseadas se puede sobreescribir la prioridad de cualquiera de los objetos. Suponga que quisiéramos que el corchete @@ -2177,6 +2166,12 @@ c4\ff c \stopTextSpan | c,4 c c c | @end lilypond +Observe que algunos de estos objetos, concretamente los números de +compás, las indicaciones metronómicas y las letras de ensayo, se +alojan de forma predeterminada dentro del contexto @code{Score}; así +pues, debe asegurarse de que utiliza el contexto adecuado cuando se +sobreescriben sus propiedades. + @cindex ligaduras y outside-staff-priority @cindex ligaduras y articulaciones @cindex articulaciones y ligaduras @@ -2449,11 +2444,12 @@ orden: @item La @strong{dirección} de uno de los objetos que se superponen se puede cambiar usando las instrucciones predefinidas que están relacionadas -arriba para los objetos dentro-del-pentagrama (véase @ref{Objetos interiores al pentagrama}). Se pueden recolocar fácilmente las plicas, ligaduras de -expresión y de unión, barras de corchea, indicaciones dinámicas, texto -y grupos de valoración especial de esta forma. La limitación es que -sólo tiene la posibilidad de elegir entre dos posiciones, y podría ser -que ninguna de ellas sea la adecuada. +arriba para los objetos dentro-del-pentagrama (véase @ref{Objetos interiores al pentagrama}). +Se pueden recolocar fácilmente las +plicas, ligaduras de expresión y de unión, barras de corchea, +indicaciones dinámicas, texto y grupos de valoración especial de esta +forma. La limitación es que sólo tiene la posibilidad de elegir entre +dos posiciones, y podría ser que ninguna de ellas sea la adecuada. @item Las @strong{propiedades del objeto}, que LilyPond usa cuando está @@ -3566,7 +3562,6 @@ lhMusic = \relative c' { * Uso de variables para los trucos:: * Hojas de estilo:: * Otras fuentes de información:: -* Evitar los trucos con un proceso ralentizado:: * Trucos avanzados con Scheme:: @end menu @@ -3850,14 +3845,15 @@ inst = @end lilypond Existen varios problemas con la salida que se superpone; los -arreglaremos utilizando las técnicas descritas en @ref{Mover objetos}. Pero también haremos algo respecto a las definiciones -@code{mpdolce} e @code{inst}. Éstas producen la salida que deseamos, -pero quizá las querríamos utilizar en otra pieza. Podríamos -simplemente copiarlas y pegarlas al principio de cada archivo, pero -sería bastante molesto. También hace que se queden las definiciones a -la vista dentro de nuestros archivos de música, y yo personalmente -encuentro todos los @code{#()} bastante poco estéticos. Los vamos a -esconder dentro de otro archivo: +arreglaremos utilizando las técnicas descritas en @ref{Mover objetos}. +Pero también haremos algo respecto a las definiciones @code{mpdolce} e +@code{inst}. Éstas producen la salida que deseamos, pero quizá las +querríamos utilizar en otra pieza. Podríamos simplemente copiarlas y +pegarlas al principio de cada archivo, pero sería bastante molesto. +También hace que se queden las definiciones a la vista dentro de +nuestros archivos de música, y yo personalmente encuentro todos los +@code{#()} bastante poco estéticos. Los vamos a esconder dentro de +otro archivo: @example %%% guardar esto en un archivo de nombre "definiciones.ily" @@ -3883,7 +3879,7 @@ Haremos referencia a este archivo utilizando la instrucción @code{.ily} se utiliza para distinguir este archivo de inclusión --que se supone que no debe ser procesado de forma independiente-- del archivo principal). Ahora modificaremos la música (guardemos este -archivo como @file{musica@/.ly}). +archivo como @file{musica.ly}). @c We have to do this awkward example/lilypond-non-verbatim @c because we can't do the \include stuff in the manual. @@ -3928,14 +3924,15 @@ inst = } @end lilypond -Eso tiene mejor aspecto, pero haremos algunos cambios más. El glissando es difícil -de ver, así que lo haremos más grueso y lo acercaremos a las cabezas de las notas. Pondremos -la indicación metronómica encima de la clave, en lugar de ir encima de la primera -nota. Y por último, mi profesor de composición odia las indicaciones de compás @q{C}, -así que la convertiremos en @q{4/4}. +Eso tiene mejor aspecto, pero haremos algunos cambios más. El +glissando es difícil de ver, así que lo haremos más grueso y lo +acercaremos a las cabezas de las notas. Pondremos la indicación +metronómica encima de la clave, en lugar de ir encima de la primera +nota. Y por último, mi profesor de composición odia las indicaciones +de compás @q{C}, así que la convertiremos en @q{4/4}. -Sin embargo, no debemos cambiar el archivo @file{musica@/.ly}. -Sustituyamos nuestro archivo @file{definiciones@/.ily} con éste: +Sin embargo, no debemos cambiar el archivo @file{musica.ly}. +Sustituyamos nuestro archivo @file{definiciones.ily} con éste: @example %%% definiciones.ily @@ -4017,13 +4014,13 @@ inst = } @end lilypond -¡Eso tiene un aspecto mucho mejor! Ahora suponga que quiere publicar esta -pieza. A mi profesor de composición no le gustan las indicaciones de compás @q{C}, -pero yo les tengo cierto cariño. Copiaremos el archivo -actual @file{definiciones@/.ily} a @file{publicar@/-web@/.ily} y modificaremos -éste. Como el propósito de esta música es producir un PDF que va a mostrarse -en la pantalla, también vamos a aumentar el -tamaño general de la salida. +¡Eso tiene un aspecto mucho mejor! Ahora suponga que quiere publicar +esta pieza. A mi profesor de composición no le gustan las +indicaciones de compás @q{C}, pero yo les tengo cierto cariño. +Copiaremos el archivo actual @file{definiciones.ily} a +@file{publicar-web.ily} y modificaremos éste. Como el propósito de +esta música es producir un PDF que va a mostrarse en la pantalla, +también vamos a aumentar el tamaño general de la salida. @example %%% definiciones.ily @@ -4105,13 +4102,13 @@ inst = Ahora, en la música, simplemente sustituyo @code{\include "definiciones.ily"} por @code{\include "publicar-web.ily"}. Por supuesto, podríamos hacer esto aún más práctico. Podríamos hacer un -archivo @file{definiciones@/.ily} que contuviera solamente las +archivo @file{definiciones.ily} que contuviera solamente las definiciones de @code{mpdolce} y de @code{inst}, un archivo -@file{publicar-web@/.ily} que contuviera solamente la sección +@file{publicar-web.ily} que contuviera solamente la sección @code{\layout} que se mostró en el ejemplo, y un archivo -@file{universidad@/.ily} que contendría solamente los trucos para +@file{universidad.ily} que contendría solamente los trucos para producir la salida que le gusta a mi profesor. El comienzo de -@file{musica@/.ly} tendría entonces este aspecto: +@file{musica.ly} tendría entonces este aspecto: @example \include "definiciones.ily" @@ -4161,12 +4158,12 @@ qué sistema operativo está utilizando: @item Linux Diríjase a -@file{@var{CARPETA_DE_INSTALACIÓN}/lilypond/usr/share/lilypond/current/} +@file{@var{CARPETA_DE_INSTALACIÓN}/lilypond/usr/@/share/lilypond/current/} @item MacOS X Diríjase a -@file{@var{CARPETA_DE_INSTALACIÓN}/LilyPond.app/Contents/Resources/share/lilypond/current/} +@file{@var{CARPETA_DE_INSTALACIÓN}/LilyPond.app/Contents/@/Resources/share/lilypond/current/} bien haciendo @code{cd} hacia este directorio desde el Terminal, o bien manteniendo pulsada la tecla de Control y haciendo click sobre la aplicación de LilyPond, y allí eligiendo @q{Mostrar el contenido del @@ -4175,7 +4172,7 @@ paquete}. @item Windows Mediante el Explorador de Windows, diríjase a -@file{@var{CARPETA_DE_INSTALACIÓN}/LilyPond/usr/share/lilypond/current/} +@file{@var{CARPETA_DE_INSTALACIÓN}/LilyPond/usr/@/share/lilypond/current/} @end itemize @@ -4192,13 +4189,13 @@ LilyPond. Dentro de esta carpeta, las dos subcarpetas interesantes son @itemize -@item @file{ly/@/} - contiene archivos en formato LilyPond -@item @file{scm/@/} - contiene archivos en formato Scheme +@item @file{ly/} - contiene archivos en formato LilyPond +@item @file{scm/} - contiene archivos en formato Scheme @end itemize -Vamos a comenzar observando algunos archivos que están en @file{ly/@/}. -Abra @file{ly/@/property@/-init@/.ly} con un editor de textos. El mismo que -usaría normalmente para los archivos @file{@/.ly} servirá perfectamente. +Vamos a comenzar observando algunos archivos que están en @file{ly/}. +Abra @file{ly/property-init.ly} con un editor de textos. El mismo que +usaría normalmente para los archivos @file{.ly} servirá perfectamente. Este archivo contiene las definiciones de todas las instrucciones estándar predefinidas de LilyPond, como por ejemplo @code{\stemUp} y @code{\slurDotted}. Podrá ver que no son nada más que definiciones de @@ -4218,25 +4215,25 @@ predefinidas se pueden redefinir con facilidad como cualquier otra variable, al principio de su archivo de código de entrada. Los siguientes son los archivos más útiles que se encuentran en -@file{ly/@/}: +@file{ly/}: @multitable @columnfractions .4 .6 @headitem Archivo @tab Contenido -@item @file{ly/@/engraver@/-init@/.ly} +@item @file{ly/engraver-init.ly} @tab Definiciones de Contextos de grabadores -@item @file{ly/@/paper@/-defaults@/-init@/.ly} +@item @file{ly/paper-defaults-init.ly} @tab especificaciones de valores predeterminados relacionados con el papel -@item @file{ly/@/performer@/-init@/.ly} +@item @file{ly/performer-init.ly} @tab Definiciones de Contextos de interpretación -@item @file{ly/@/property@/-init@/.ly} +@item @file{ly/property-init.ly} @tab Definiciones de todas las instrucciones predefinidas que son comunes -@item @file{ly/@/spanner@/-init@/.ly} +@item @file{ly/spanner-init.ly} @tab Definiciones de las instrucciones predefinidas relacionadas con los objetos de extensión @end multitable Otros ajustes (como las definiciones de las instrucciones de marcado) -se almacenan como archivos @file{@/.scm} (de Scheme). El lenguaje de +se almacenan como archivos @file{.scm} (de Scheme). El lenguaje de programación Scheme se utiliza para proporcionar un interfaz programable en el funcionamiento interno de LilyPond. Cualquier explicación adicional sobre estos archivos se encuentra por el momento @@ -4251,62 +4248,23 @@ interesarle son: @multitable @columnfractions .4 .6 @headitem Archivo @tab Contenido -@item @file{scm/@/auto@/-beam@/.scm} +@item @file{scm/auto-beam.scm} @tab Valores predeterminados de sub-barrado -@item @file{scm/@/define@/-grobs@/.scm} +@item @file{scm/define-grobs.scm} @tab valores predeterminados de las propiedades de grobs -@item @file{scm/@/define@/-markup@/-commands@/.scm} +@item @file{scm/define-markup-commands.scm} @tab Especificar todas las instrucciones de marcado -@item @file{scm/@/midi@/.scm} +@item @file{scm/midi.scm} @tab Ajustes predeterminados para la salida MIDI -@item @file{scm/@/output@/-lib@/.scm} +@item @file{scm/output-lib.scm} @tab Ajustes que afectan al aspecto de los trastes, colores, alteraciones, lineas divisorias, etc. -@item @file{scm/@/parser@/-clef@/.scm} +@item @file{scm/parser-clef.scm} @tab Definiciones de las claves contempladas -@item @file{scm/@/script@/.scm} +@item @file{scm/script.scm} @tab Ajustes predeterminados para las articulaciones @end multitable - -@node Evitar los trucos con un proceso ralentizado -@subsection Evitar los trucos con un proceso ralentizado -@translationof Avoiding tweaks with slower processing - -LilyPond puede llevar a cabo comprobaciones adicionales al tiempo que -procesa los archivos. Estas instrucciones consumen tiempo, pero el -resultado puede necesitar menos trucos manuales para obtener un -resultado aceptable. Si una inscripción de texto o parte de la letra -se sale de los márgenes, estas comprobaciones comprimirán dicha línea -en la medida justa como para que encaje dentro de los márgenes. - -Para que sean efectivos bajo cualquier circunstancia, estas -comprobaciones deben habilitarse colocando las instrucciones de -sobreescritura con @code{\context} dentro del bloque @code{\layout}, y no -en línea con la música, de la forma siguiente: - - -@example -\score @{ - @{ @dots{}notes@dots{} @} - \layout @{ - \context @{ - \Score - % asegura que las marcas de texto y letras de las canciones se encuentran dentro de los márgenes de la página - \override PaperColumn #'keep-inside-line = ##t - \override NonMusicalPaperColumn #'keep-inside-line = ##t - @} - @} -@} -@end example - -Sin embargo, @code{keep-inside-line} es costoso en términos de -computación y la recomendación es no activarlo, para permitir un -procesado más rápido, hasta el momento de crear una versión -definitiva. De esta forma, no tiene que añadir instrucciones -@code{\break} manualmente para evitar que el texto se salga por la -parte derecha de la página. - @node Trucos avanzados con Scheme @subsection Trucos avanzados con Scheme @translationof Advanced tweaks with Scheme