From bf1900d44f4937fe8e69e0e04e188a0c3daf5172 Mon Sep 17 00:00:00 2001 From: Francisco Vila Date: Thu, 31 May 2012 11:18:26 +0200 Subject: [PATCH] Doc-es: update CHANGES, Learning/Tweaks, Notation/Changing. --- Documentation/es/changes.tely | 35 ++++++--- Documentation/es/learning/tweaks.itely | 61 ++++++++++----- .../es/notation/changing-defaults.itely | 76 ++++++++++--------- 3 files changed, 106 insertions(+), 66 deletions(-) diff --git a/Documentation/es/changes.tely b/Documentation/es/changes.tely index 551f459e6f..6229a03491 100644 --- a/Documentation/es/changes.tely +++ b/Documentation/es/changes.tely @@ -1,6 +1,6 @@ \input texinfo @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*- @ignore - Translation of GIT committish: 15ca7b18a32b243c7bcacfba773b3da843a6dd36 + Translation of GIT committish: ce1c0fabb3d5ac18e61fb8fcc91a3990714553c2 When revising a translation, copy the HEAD committish of the version that you are working on. For details, see the Contributors' @@ -157,6 +157,19 @@ operativo el código tradicional. Los tres siguientes elementos de la lista son consecuencia de este cambio. +@item +Se ha reimplementado la abreviatura de ayuda para intruducción +repetitiva de acordes, @code{q}. Ahora los acordes repetidos se +sustituyen justo antes de la interpretación de la expresión musical. +En caso de que el usuario quiera retener ciertos eventos del acorde +original, puede ejecutar manualmente la función @code{\chordRepeats} +de sustitución de acordes de repetición. + +@item +Los números de cuerdas y digitaciones de la mano derecha sobre notas +individuales aparecen ahora sin tener que escribirlas dentro de +corchetes de acorde. + @item Ahora las funciones musicales funcionan igual cuando se usan dentro o fuera de los acordes, incluidas todas las posibilidades de la @@ -175,17 +188,15 @@ instrucciones y letra de canciones, pero aún no es probable que ofrezca resultados. @item -Se ha reimplementado la abreviatura de ayuda para intruducción -repetitiva de acordes, @code{q}. Ahora los acordes repetidos se -sustituyen justo antes de la interpretación de la expresión musical. -En caso de que el usuario quiera retener ciertos eventos del acorde -original, puede ejecutar manualmente la función @code{\chordRepeats} -de sustitución de acordes de repetición. - -@item -Los números de cuerdas y digitaciones de la mano derecha sobre notas -individuales aparecen ahora sin tener que escribirlas dentro de -corchetes de acorde. +@code{\tweak} now takes an optional layout object specification. It can +be used for tweaking layout objects that are only indirectly caused by +the tweaked event, like accidentals, stems, and flags: + +@lilypond[verbatim,quote,ragged-right,relative=2] +<\tweak Accidental #'color #red cis4 + \tweak Accidental #'color #green es + g> +@end lilypond @item Las expresiones de Scheme dentro de fragmentos de código de LilyPond diff --git a/Documentation/es/learning/tweaks.itely b/Documentation/es/learning/tweaks.itely index 13edd43cfb..0aeb1a2ebe 100644 --- a/Documentation/es/learning/tweaks.itely +++ b/Documentation/es/learning/tweaks.itely @@ -1,14 +1,14 @@ @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*- @ignore - Translation of GIT committish: faf3ecd73ed2b708b4a1bc8c1150767359a73bdf + Translation of GIT committish: ce1c0fabb3d5ac18e61fb8fcc91a3990714553c2 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.10" +@c \version "2.15.39" @node Trucar la salida @chapter Trucar la salida @@ -363,11 +363,11 @@ presentación del tipo especificado que ocurren en el mismo momento musical que la propia instrucción de sobreescritura @code{\override}. La instrucción @code{\tweak} opera de una forma distinta. Actúa sobre -el elemento inmediatamente siguiente dentro del flujo de entrada. Sin -embargo, es efectivo solamente sobre objetos que se crean directamente -a partir del flujo de entrada, en esencia las cabezas y las -articulaciones; los objetos como las plicas y las alteraciones se -crean con posterioridad y no se pueden trucar de esta forma. +el elemento inmediatamente siguiente dentro del flujo de entrada. +En su forma más sencilla es efectivo solamente sobre objetos +que se crean directamente +a partir del elemento siguiente, en esencia las cabezas y las +articulaciones. Así pues, volviendo a nuestro ejemplo, el tamaño de la nota intermedia se cambiaría de la siguiente forma: @@ -381,11 +381,12 @@ se cambiaría de la siguiente forma: @end lilypond Observe que la sintaxis de @code{\tweak} no es igual que la de -@code{\override}. Ni el contexto ni el objeto de presentación se -deben especificar; de hecho, generaría un error hacerlo. Los dos +@code{\override}. El contexto no se +debe especificar; de hecho, generaría un error hacerlo. +Tanto el contexto como el objeto de presentación están implícitos por el siguiente elemento del flujo de entrada. Observe también que no debe haber un signo igual. Así que la sintaxis -genérica de la instrucción @code{\tweak} es, simplemente, +de la instrucción @code{\tweak} en su forma sencilla es: @example \tweak #'@var{propiedad-de-presentación} #@var{valor} @@ -410,6 +411,28 @@ como una articulación. En el caso de más de una sobreescritura de dirección (@code{^} o @code{_}), gana la sobreescritura situada más a la izquierda porque se aplica en último lugar. +@cindex @code{\tweak}, Accidental +@cindex @code{\tweak}, specific layout object + +Los objetos tales como plicas y alteraciones accidentales se crean más +tarde, y no directamente a partir del evento que viene a continuación. +Aún es posible utilizar @code{\tweak} sobre tales objetos creados +indirectamente mediante el nombrado explícito del objeto de +presentación, siempre y cuando LilyPond pueda rastrear su origen hasta +el evento original: + +@lilypond[quote,fragment,ragged-right,verbatim,relative=2] +<\tweak Accidental #'color #red cis4 + \tweak Accidental #'color #green es + g> +@end lilypond + +Esta forma extensa de la instrucción @code{\tweak} se puede describir +como +@example +\tweak @var{layout-object} #'@var{layout-property} @var{value} +@end example + @cindex grupos especiales anidados @cindex tresillos anidados @cindex corchete del grupo especial @@ -3096,8 +3119,8 @@ rhMusic = \relative c'' { % Stem on the d2 must be down to permit merging \stemDown % Stem on the d2 should be invisible - \once \override Stem #'transparent = ##t - \once \override Flag #'transparent = ##t + \tweak Stem #'transparent ##t + \tweak Flag #'transparent ##t d2 } \new Voice { @@ -3540,8 +3563,8 @@ rhMusic = \relative c'' { % Stem on the d2 must be down to permit merging \stemDown % Stem on the d2 should be invisible - \once \override Stem #'transparent = ##t - \once \override Flag #'transparent = ##t + \tweak Stem #'transparent ##t + \tweak Flag #'transparent ##t d2 } \new Voice { @@ -3625,8 +3648,8 @@ de que la ligadura se cruza entre las voces: @lilypond[quote,fragment,relative=2,verbatim] << { - \once \override Stem #'transparent = ##t - \once \override Flag #'transparent = ##t + \tweak Stem #'transparent ##t + \tweak Flag #'transparent ##t b8~ b\noBeam } \\ @@ -3641,9 +3664,9 @@ valor de longitud @code{length} a @code{8}, @lilypond[quote,fragment,relative=2,verbatim] << { - \once \override Stem #'transparent = ##t - \once \override Flag #'transparent = ##t - \once \override Stem #'length = #8 + \tweak Stem #'transparent ##t + \tweak Flag #'transparent ##t + \tweak Stem #'length #8 b8~ b\noBeam } \\ diff --git a/Documentation/es/notation/changing-defaults.itely b/Documentation/es/notation/changing-defaults.itely index cb0fd7b035..995ed8b735 100644 --- a/Documentation/es/notation/changing-defaults.itely +++ b/Documentation/es/notation/changing-defaults.itely @@ -1,14 +1,14 @@ @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*- @ignore -Translation of GIT committish: b63f205feabebfd5ed39fdaa57308c4b08eb70b3 +Translation of GIT committish: ce1c0fabb3d5ac18e61fb8fcc91a3990714553c2 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.15.39" @node Cambiar los valores por omisión @chapter Cambiar los valores por omisión @@ -1799,11 +1799,12 @@ a todos los grobs del contexto afectado. Esto se consigue con la instrucción @code{\tweak}, que tiene la sintaxis siguiente: @example -\tweak #'@code{propiedad-del-grob} #@code{valor} +\tweak @var{objeto-de-presentación} #'@var{propiedad-del-grob} @var{valor} @end example -La instrucción @code{\tweak} se aplica al objeto que viene -inmediatamente después de @code{valor} dentro del flujo musical. +Es opcional especificar el @var{objeto-de-presentación}. La +instrucción @code{\tweak} se aplica al objeto musical que viene +inmediatamente después de @var{valor} dentro del flujo musical. @ignore En ocasiones es posible tomar un atajo para realizar el ajuste fino de @@ -1903,32 +1904,46 @@ c-\tweak #'thickness #5 ( d e f) Para que funcione la instrucción @code{\tweak}, debe permanecer adyacente al objeto al que se ha de aplicar después de que el código -de entrada se ha convertido a un flujo musical. A veces, LilyPond -puede insertar elementos adicionales dentro del flujo de música -durante el proceso de análisis sintáctico. Por ejemplo, cuando una -nota que no es parte explícita de un acorde se coloca dentro de un -acorde por parte de LilyPond de manera que las notas que se pretenden -modificar con @code{\tweak} se deben poner dentro de una construcción -de acorde: +de entrada se ha convertido a un flujo musical. El trucaje de un +acorde completo no hace nada porque su evento musical actúa solamente +como un contenedor, y todos los objetos de presentación se crean a +partir de eventos dentro del @code{EventChord}: @lilypond[relative=2,verbatim,quote] \tweak #'color #red c4 -<\tweak #'color #red c>4 +\tweak #'color #red 4 +<\tweak #'color #red c e>4 @end lilypond -La instrucción @code{\tweak} no se puede usar para modificar ningún -elemento que no aparezca explícitamente en el código de entrada. -Concretamente, no se puede usar para modificar plicas, barras o -alteraciones directamente, porque éstos se generan posteriormente por -parte de las cabezas de las notas, más que por elementos musicales del +La instrucción @code{\tweak} sencilla no se puede usar para modificar +ningún objeto que no se haya creado directamente a partir de la entrada. +Concretamente, no afecta a las plicas, barras automáticas ni +alteraciones, porque éstos se generan posteriormente por +parte de objetos de presentación @code{NoteHead} +más que por elementos musicales del flujo de entrada. Tampoco se puede usar @code{\tweak} para modificar las claves ni las indicaciones de compás, porque se separarán de cualquier instrucción @code{\tweak} que aparezca en el flujo de entrada debido a la inserción automática de los elementos adicionales que se requieren para especificar el contexto. -También se pueden escribir varias instrucciones @code{\tweak} antes de -un elemento notacional, y todas ellas le afectan: +Tales objetos de presencaión creados indirectamente se pueden trucar +usando la forma explícita de la instrucción @code{\tweak}: + +@lilypond[relative=2,verbatim,quote] +\tweak Stem #'color #red +\tweak Beam #'color #green c8 e +4 +@end lilypond + +No se puede usar @code{\tweak} para modificar las claves o las +indicaciones de compás, porque éstos se separan de cualquier +instrucción @code{\tweak} precedente dentro del flujo de entrada +merced a la inserción automática de elementos adicionales que se +requieren para especificar el contexto. + +Se pueden colocar varias instrucciones @code{\tweak} antes de un +elemento de notación; todos le afectan: @lilypond[verbatim,quote,relative=1] c @@ -1954,12 +1969,6 @@ Manual de extensión: @rextend{Presentación de las expresiones musicales}. @knownissues -@cindex trucos en una variable -La instrucción @code{\tweak} no se puede usar dentro de una variable. - -@cindex trucos en la letra -Las instrucciones @code{\tweak} no se pueden usar dentro del modo -@code{\lyricmode}. @cindex trucar puntos de control @cindex control, trucar puntos de @@ -4021,19 +4030,16 @@ padText = Además de números, podemos usar expresiones musicales, como notas, para los argumentos de las funciones musicales: -@c TODO: use a better example (the music argument is redundant). - @lilypond[quote,verbatim,ragged-right] custosNote = #(define-music-function (parser location note) (ly:music?) #{ - \once \override Voice.NoteHead #'stencil = - #ly:text-interface::print - \once \override Voice.NoteHead #'text = - \markup \musicglyph #"custodes.mensural.u0" - \once \override Voice.Stem #'stencil = ##f + \tweak NoteHead #'stencil #ly:text-interface::print + \tweak NoteHead #'text + \markup \musicglyph #"custodes.mensural.u0" + \tweak Stem #'stencil ##f $note #}) @@ -4046,7 +4052,7 @@ Se pueden definir funciones de sustitución con más de un argumento: tempoPadded = #(define-music-function (parser location padding tempotext) - (number? string?) + (number? markup?) #{ \once \override Score.MetronomeMark #'padding = #padding \tempo \markup { \bold #tempotext } @@ -4055,7 +4061,7 @@ tempoPadded = \relative c'' { \tempo \markup { "Low tempo" } c4 d e f g1 - \tempoPadded #4.0 #"High tempo" + \tempoPadded #4.0 "High tempo" g4 f e d c1 } @end lilypond -- 2.39.2