From: Francisco Vila Date: Wed, 21 Sep 2011 10:09:39 +0000 (+0200) Subject: Doc-es: update Notation/Rhythms, Usage/LilyPond-Book. X-Git-Tag: release/2.15.13-1~46 X-Git-Url: https://git.donarmstrong.com/?a=commitdiff_plain;h=7c6fe26bf7b7f7ba568e2e86bf47c8bbeaf6148b;p=lilypond.git Doc-es: update Notation/Rhythms, Usage/LilyPond-Book. --- diff --git a/Documentation/es/notation/rhythms.itely b/Documentation/es/notation/rhythms.itely index 33ecfddd0e..334c34a734 100644 --- a/Documentation/es/notation/rhythms.itely +++ b/Documentation/es/notation/rhythms.itely @@ -1,6 +1,6 @@ @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*- @ignore - Translation of GIT committish: 4ca01b6da8d60b0d8575be05ae974429c91becd5 + Translation of GIT committish: e1fb62a6d5f6aaeadafdef10550e38e25704394e When revising a translation, copy the HEAD committish of the version that you are working on. For details, see the Contributors' @@ -1246,9 +1246,6 @@ moviendo el @code{Timing_translator} y el @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle] {changing-the-time-signature-without-affecting-the-beaming.ly} -@cindex compuesto, indicaciones de compás -@cindex compás compuesto, indicaciones de - @lilypondfile[verbatim,quote,texidoc,doctitle] {time-signature-printing-only-the-numerator-as-a-number-instead-of-the-fraction.ly} @@ -1589,29 +1586,24 @@ ocurrir algunos errores extraños. @funindex times Está contemplada la notación polimétrica, ya sea explícitamente o -mediante la modificación de la indicación visible del compás y el +mediante la modificación manual de la indicación visible del compás y/o el escalado de la duración de las notas. -@strong{Pentagramas con distintas indicaciones de compás, compases de -igual longitud} +@subsubheading Pentagramas con distintas indicaciones de compás y compases de igual longitud -Se puede crear esta notación estableciendo una indicación de compás -común para cada pentagrama pero sustituyendo el símbolo manualmente -mediante el establecimiento de @code{timeSignatureFraction} a la -fracción deseada y escalando las duraciones impresas en cada -pentagrama a la indicación de compás común; véase @ref{Indicación de -compás}. El escalado se hace con @code{\scaleDurations}, que se usa -de una forma similar a @code{\times}, pero no crea un corchete de -grupo especial, véase @ref{Escalar las duraciones}. +Establezca una indicación de compás común para cada pentagrama, y fije +@code{timeSignatureFraction} a la fracción deseada. Luego use la función +@code{\scaleDurations} para escalar las duraciones de las notas en cada +pauta a la indicación de compás común. @cindex barras en música polimétrica @cindex polimétrico, metro, barras en -En este ejemplo, se usa en paralelo música con compases de 3/4, 9/8 y +En el siguiente ejemplo, se usa en paralelo música con compases de 3/4, 9/8 y 10/8. En el segundo pentagrama, las duraciones mostradas se -multiplican por 2/3, pues 2/3 * 9/8 = 3/4, y en el tercer pentagrama, -las duraciones que se muestran están multiplicadas por 3/5, pues 3/5 * -10/8 = 3/4. Con frecuencia se hace necesario insertar las barras de +multiplican por 2/3 (pues 2/3 * 9/8 = 3/4), y en el tercer pentagrama, +las duraciones que se muestran están multiplicadas por 3/5 (pues 3/5 * +10/8 = 3/4). Con frecuencia habrá que insertar las barras de forma manual, pues el escalado de las duraciones afecta a las reglas de barrado automático. @@ -1620,7 +1612,7 @@ de barrado automático. \new Staff { \time 3/4 c4 c c | - c c c | + c4 c c | } \new Staff { \time 3/4 @@ -1634,14 +1626,13 @@ de barrado automático. \scaleDurations #'(3 . 5) { \repeat unfold 2 { c8[ c c] } \repeat unfold 2 { c8[ c] } | - c4. c4. \times 2/3 { c8[ c c] } c4 + c4. c \times 2/3 { c8[ c c] } c4 } } >> @end lilypond -@strong{@i{Pentagramas con distintas indicaciones de compás y -longitudes de compás distintas}} +@subsubheading Pentagramas con distintas indicaciones de compás y longitudes de compás distintas Se puede dar a cada pentagrama su propia indicación de compás independiente trasladando los grabadores @code{Timing_translator} y @@ -1685,6 +1676,45 @@ independiente trasladando los grabadores @code{Timing_translator} y >> @end lilypond +@funindex \compoundMeter +@cindex compuesto, indicaciones de compás +@cindex compás compuesto, indicación de + +@subsubheading Indicaciones de compás compuesto + +Se crean usando la función @code{\compoundMeter}. La sintaxis es: + +@example +\compoundMeter #'@code{(lista de listas)} +@end example + +La construcción más simple es una lista única, en la que el +@emph{último} número indica el denominador de la indicación de compás +y los anteriores son los numeradores. + +@lilypond[quote,verbatim] +\relative c' { + \compoundMeter #'((2 2 2 8)) + \repeat unfold 6 c8 \repeat unfold 12 c16 +} +@end lilypond + +Se pueden construir compases más complejos utilizando listas +adicionales. Asimismo, los ajustes de barrado se ajustarán +dependiendo de los valores. + +@lilypond[quote,verbatim] +\relative c' { + \compoundMeter #'((1 4) (3 8)) + \repeat unfold 5 c8 \repeat unfold 10 c16 +} + +\relative c' { + \compoundMeter #'((1 2 3 8) (3 4)) + \repeat unfold 12 c8 +} +@end lilypond + @seealso Glosario musical: @rglos{polymetric}, @@ -1692,6 +1722,8 @@ Glosario musical: @rglos{meter}. Referencia de la notación: +@ref{Barras automáticas}, +@ref{Barras manuales}, @ref{Indicación de compás}, @ref{Escalar las duraciones}. diff --git a/Documentation/es/usage/lilypond-book.itely b/Documentation/es/usage/lilypond-book.itely index a97aba25c1..ce3e368f48 100644 --- a/Documentation/es/usage/lilypond-book.itely +++ b/Documentation/es/usage/lilypond-book.itely @@ -1,7 +1,7 @@ @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*- @ignore - Translation of GIT committish: 2055f35c47a045a50a01ff4dba8524322cfc3b48 + Translation of GIT committish: 4ca01b6da8d60b0d8575be05ae974429c91becd5 When revising a translation, copy the HEAD committish of the version that you are working on. For details, see the Contributors' @@ -137,7 +137,7 @@ xpdf lilybook La ejecución de @command{lilypond-book} y @command{latex} crea un gran número de archivos temporales, que podrían abarrotar el directorio de trabajo. Para poner remedio a esto utilice la opción -@code{--output=@var{directorio}}. Creará los archivos en un +@option{--output=@var{directorio}}. Creará los archivos en un subdirectorio aparte @file{directorio}. Finalmente el resultado del ejemplo de @LaTeX{} que acabamos de @@ -216,27 +216,45 @@ Consulte @emph{The Not So Short Introduction to @LaTeX{}}} (Introducción no tan breve a @LaTeX{}) para ver una panorámica sobre cómo usar @LaTeX{}. -La música se introduce usando +@code{lilypond-book} aporta las instrucciones y entornos siguientes +para incluir música dentro de archivos de @LaTeX{}: + +@itemize + +@item +la instrucción @code{\lilypond@{...@}}, donde podemos escribir directamente fragmentos cortos de código de LilyPond + +@item +el entorno @code{\begin@{lilypond@}...\end@{lilypond@}}, donde podemos +introducir directamente bloques más largos de código de LilyPond + +@item +la instrucción @code{\lilypondfile@{...@}} para insertar un archivo de LilyPond + +@item +la instrucción @code{\musicxmlfile@{...@}} para insertar un archivo de +MusicXML, que se procesa por parte de @code{musicxml2ly} y +@code{lilypond}. + +@end itemize + +En el archivo de entrada, se especifica la música con cualquiera de +las instrucciones siguientes: @example \begin@{lilypond@}[las,opciones,van,aquí] EL CÓDIGO DE LILYPOND \end@{lilypond@} -@end example -@noindent -o bien +\lilypond[las,opciones,van,aquí]@{ EL CÓDIGO DE LILYPOND @} -@example \lilypondfile[las,opciones,van,aquí]@{@var{archivo}@} + +\musicxmlfile[las,opciones,van,aquí]@{@var{archivo}@} @end example -@noindent -o bien -@example -\lilypond[las,opciones,van,aquí]@{ EL CÓDIGO DE LILYPOND @} -@end example +@noindent De forma adicional, @code{\lilypondversion} imprime la versión actual de lilypond. @@ -417,27 +435,43 @@ Texinfo es el formato estándar para la documentación del proyecto GNU. Este mismo manual es un ejemplo de documento Texinfo. Las versiones HTML, PDF e Info del manual se hacen a partir del documento Texinfo. +@code{lilypond-book} aporta las siguientes instrucciones y entornos +para incluir música dentro de archivos de Texinfo: + +@itemize + +@item +la instrucción @code{@@lilypond@{...@}}, donde podemos introducir +directamente fragmentos cortos de código de LilyPond + +@item +el entorno @code{@@lilypond...@@end lilypond}, donde podemos escribir +directamente bloques más extensos de código de LilyPond + +@item +la instrucción @code{@@lilypondfile@{...@}} para insertar un archivo +de LilyPond + +@item +la instrucción @code{@@musicxmlfile@{...@}} para insertar un archivo +de MusicXML, que se procesa después por parte de @code{musicxml2ly} y +de @code{lilypond}. + +@end itemize -En el archivo de entrada, la música se especifica con +En el archivo de entrada, la música se especifica con cualquiera de +las instrucciones siguientes: @example @@lilypond[las,opciones,van,aquí] EL CÓDIGO DE LILYPOND @@end lilypond -@end example - -@noindent -o bien -@example @@lilypond[las,opciones,van,aquí]@{ EL CÓDIGO DE LILYPOND @} -@end example - -@noindent -o bien -@example @@lilypondfile[las,opciones,van,aquí]@{@var{archivo}@} + +@@musicxmlfile[las,opciones,van,aquí]@{@var{archivo}@} @end example De forma adicional, @code{@@lilypondversion} imprime la versión actual @@ -476,7 +510,7 @@ produce @lilypond[fragment,staffsize=11]{} -No como @LaTeX{}, @code{@@lilypond@{...@}} no genera una imagen en +A diferencia de @LaTeX{}, @code{@@lilypond@{...@}} no genera una imagen en línea. Siempre consiste en un párrafo para ella sola. @@ -484,8 +518,56 @@ línea. Siempre consiste en un párrafo para ella sola. @subsection HTML @translationof HTML -La música se introduce usando +@code{lilypond-book} aporta las siguientes instrucciones y entornos +para incluir música dentro de archivos HTML: + +@itemize + +@item +la instrucción @code{}, donde podemos introducir +directamente fragmentos cortos de código de LilyPond + +@item +el entorno @code{...}, donde podemos escribir +directamente bloques más extensos de código de LilyPond +@item +la instrucción @code{...} para insertar +un archivo de LilyPond + +@item +la instrucción @code{...} para insertar +un archivo de MusicXML, que se procesa después por parte de +@code{musicxml2ly} y de @code{lilypond}. + +@end itemize + +En el archivo de entrada, la música se especifica con cualquiera de +las instrucciones siguientes: + + +\begin@{lilypond@}[las,opciones,van,aquí] + EL CÓDIGO DE LILYPOND +\end@{lilypond@} + +\lilypond[las,opciones,van,aquí]@{ EL CÓDIGO DE LILYPOND @} + +\lilypondfile[las,opciones,van,aquí]@{@var{archivo}@} + +\musicxmlfile[las,opciones,van,aquí]@{@var{archivo}@} +@example + + EL CÓDIGO DE LILYPOND + + + + +@var{archivo} + +@var{archivo} +@end example + +Por ejemplo, podemos escribr @example \key c \minor c4 es g2 @@ -514,6 +596,10 @@ Para incluir archivos externos, escriba @var{archivo} @end example +@code{} usa la misma sintaxis que @code{}, +pero sencillamente referencia un archivo de MusicXML en lugar de un +archivo de LilyPond. + Para ver una lista de las opciones que utilizar con las etiquetas @code{lilypond} o @code{lilypondfile}, véase @ref{Opciones de fragmentos de música}. @@ -623,11 +709,9 @@ puntos. @item ragged-right Producir líneas no justificadas por la derecha y con espaciado natural, es decir, se añade @code{ragged-right = ##t} al fragmento de -LilyPond. Esta es la opción predeterminada para la instrucción -@code{\lilypond@{@}} si no está presente la opción @code{line-width}. -También es la opción predeterminada para el entorno @code{lilypond} si -está establecida la opción @code{fragment}, y no se especifica la -anchura de la línea explícitamente. +LilyPond. Los fragmentos de una sola línea siempre se tipografían de +forma predeterminada sin justificación por la derecha, a no ser que se +use explícitamente la opción @code{noragged-right}. @item noragged-right Para fragmentos de una sola línea, permitir que la longitud del @@ -766,12 +850,12 @@ mensajes @file{.mo} con @code{lilypond-doc} como dominio. @item texidoc (Sólo para la salida de Texinfo.) Si se llama a @command{lilypond} con la opción @option{--header=@/texidoc}, y el archivo que se procesa -se llama @file{fulanito.ly}, crea un archivo -@file{fulanito.texidoc} si existe un campo @code{texidoc} dentro del -bloque @code{\header} de cabecera. La opción @code{texidoc} hace que -@command{lilypond-book} incluya estos archivos, añadiendo su contenido -como un bloque de documentación inmediatamente antes del fragmento -musical. +se llama @file{fulanito.ly}, crea un archivo @file{fulanito.texidoc} +si existe un campo @code{texidoc} dentro del bloque @code{\header} de +cabecera. La opción @code{texidoc} hace que @command{lilypond-book} +incluya estos archivos, añadiendo su contenido como un bloque de +documentación inmediatamente antes del fragmento musical (pero fuera +del entorno @code{example} generado por la opción @code{quote}). Suponiendo que el archivo @file{fulanito.ly} contiene @@ -892,7 +976,7 @@ aparecerán en los archivos @file{.ps} y @file{.pdf}. La ejecución de @command{dvips} puede dar como resultado algunas advertencias sobre las fuentes tipográficas; son inocuas y se pueden ignorar. Si está ejecutando @command{latex} en modo de dos columnas, -recuerde añadir @code{-t landscape} a las opciones de @command{dvips}. +recuerde añadir @option{-t landscape} a las opciones de @command{dvips}. @subsubheading Texinfo @@ -951,7 +1035,7 @@ Añadir @var{directorio} a la ruta de inclusión. la ruta de inclusión, y no los vuelve a escribir en el directorio de salida, así que en ciertos casos es necesario invocar instrucciones de procesado posteriores como @command{makeinfo} o @command{latex} con -las mismas opciones @code{-I @var{directorio}}. +las mismas opciones @option{-I @var{directorio}}. @item -o @var{directorio} @itemx --output=@var{directorio} @@ -979,7 +1063,7 @@ imágenes. @itemx --lily-output-dir=@var{directorio} Escribir archivos lily-XXX en el directorio @var{directorio}, enlazar -en el directorio de @code{--output}. Use esta opción para ahorrar +en el directorio de @option{--output}. Use esta opción para ahorrar tiempo de construcción para documentos de distintos directorios que comparten muchos fragmentos idénticos de código. @@ -1009,17 +1093,22 @@ derecha en la misma medida. @itemx --process=@var{instrucción} Procesar los fragmentos de LilyPond utilizando @var{instrucción}. La instrucción predeterminada es @code{lilypond}. @code{lilypond-book} -no obedecerá a @code{--filter} y a @code{--process} al mismo tiempo. +no obedecerá a @option{--filter} y a @option{--process} al mismo tiempo. @item --pdf Crear archivos PDF para su uso con PDF@LaTeX{}. +@item --redirect-lilypond-output +De forma predeterminada, la salida se imprime por la consola. Esta +opción redirecciona toda la salida hacia archivos de registro situados +en el mismo directorio que los archivos fuente. + @itemx --use-source-file-names Escribir los archivos de salida de los fragmentos de música con el mismo nombre de base que su archivo fuente. Esta opción sólo funciona para fragmentos incluidos con @code{lilypondfile} y sólo si los -directorios determinados por las opciones @code{--output-dir} y -@code{--lily-output-dir} son distintos. +directorios determinados por las opciones @option{--output-dir} y +@option{--lily-output-dir} son distintos. @item -V @itemx --verbose @@ -1071,11 +1160,12 @@ salida basándose en la extensión del nombre del archivo de entrada. Si usa la misma extensión para el archivo de entrada que la que usa @command{lilypond-book} para el archivo de salida, y si el archivo de entrada está en el mismo directorio que el directorio de trabajo de -@command{lilypond-book}, debe usar la opción @code{--output} para que +@command{lilypond-book}, debe usar la opción @option{--output} para que funcione @command{lilypond-book}, pues en caso contrario saldrá con un mensaje de error como @qq{La salida sobreescribirá al archivo de entrada}. + @node Plantillas de lilypond-book @section Plantillas de lilypond-book @translationof lilypond-book templates