]> git.donarmstrong.com Git - lilypond.git/commitdiff
Doc-es: update Notation/Rhythms, Usage/LilyPond-Book.
authorFrancisco Vila <francisco.vila@hispalinux.es>
Wed, 21 Sep 2011 10:09:39 +0000 (12:09 +0200)
committerFrancisco Vila <francisco.vila@hispalinux.es>
Wed, 21 Sep 2011 11:21:22 +0000 (13:21 +0200)
Documentation/es/notation/rhythms.itely
Documentation/es/usage/lilypond-book.itely

index 33ecfddd0eca4b00f3df3cd5d363dd79a8cd210a..334c34a73460ad951e947282783b6767c5dbcd67 100644 (file)
@@ -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/5pues 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}.
 
index a97aba25c1c062789ef0d8ca4d8db5b2e6c072dd..ce3e368f48a244a86c3c5470e05d4a85242f1c89 100644 (file)
@@ -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]{<c' e' g'>}
 
-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{<lilypond .... />}, donde podemos introducir
+directamente fragmentos cortos de código de LilyPond
+
+@item
+el entorno @code{<lilyond>...</lilypond>}, donde podemos escribir
+directamente bloques más extensos de código de LilyPond
 
+@item
+la instrucción @code{<lilypondfile>...</lilypondfile>} para insertar
+un archivo de LilyPond
+
+@item
+la instrucción @code{<musicxmlfile>...</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 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
+<lilypond las opciones van aquí>
+  EL CÓDIGO DE LILYPOND
+</lilypond>
+
+<lilypond las opciones van aquí: EL CÓDIGO DE LILYPOND />
+
+<lilypondfile las opciones van aquí>@var{archivo}</lilypondfile>
+
+<musicxmlfile las opciones van aquí>@var{archivo}</musicxmlfile>
+@end example
+
+Por ejemplo, podemos escribr
 @example
 <lilypond fragment relative=2>
 \key c \minor c4 es g2
@@ -514,6 +596,10 @@ Para incluir archivos externos, escriba
 <lilypondfile @var{opción1} @var{opción2} ...>@var{archivo}</lilypondfile>
 @end example
 
+@code{<musicxmlfile>} usa la misma sintaxis que @code{<lilypondfile>},
+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