X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Fes%2Fusage%2Flilypond-book.itely;h=4542667022034a7930bd19a91571670c0da19f86;hb=d36171e34d236d890f5dc511b895037188c6c7cb;hp=0b3d270bdce4499e2ffceddbf1dc529920568519;hpb=c45475097af52320b55f684ab33a96afecfaf56a;p=lilypond.git diff --git a/Documentation/es/usage/lilypond-book.itely b/Documentation/es/usage/lilypond-book.itely index 0b3d270bdc..4542667022 100644 --- a/Documentation/es/usage/lilypond-book.itely +++ b/Documentation/es/usage/lilypond-book.itely @@ -1,14 +1,14 @@ @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*- @ignore - Translation of GIT committish: 2055f35c47a045a50a01ff4dba8524322cfc3b48 + Translation of GIT committish: eba67a0bc70f38a7847de75c640d7ad19c6fd804 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.14.0" +@c \version "2.19.21" @c Note: keep this node named so that `info lilypond-book' brings you here. @node lilypond-book @@ -30,24 +30,24 @@ que coincidan con los ajustes de su documento. Es un programa distinto a @command{lilypond} propiamente dicho, y se ejecuta sobre la línea de órdenes; para ver más información, consulte -@ref{Utilización desde la línea de órdenes}. Si tiene MacOS 10.3 o -10.4 y experimenta algún problema al ejecutar @code{lilypond-book}, -consulte @rweb{MacOS X}. +@ref{Utilización desde la línea de órdenes}. Si experimenta algún +problema al ejecutar @code{lilypond-book} sobre Windows o Mac OS X +utilizando la línea de órdenes, consulte @rweb{Windows} o @rweb{MacOS X}. Este procedimiento se puede aplicar a documentos de @LaTeX{}, HTML, Texinfo o DocBook. @cindex texinfo -@cindex latex +@cindex LaTex @cindex texinfo @cindex texi -@cindex html +@cindex HTML @cindex docbook @cindex documentos, insertar música en -@cindex HTML, música dentro de -@cindex Texinfo, música dentro de -@cindex DocBook, música dentro de -@cindex @LaTeX{}, música dentro de +@cindex HTML, insertar música en +@cindex Texinfo, insertar música en +@cindex DocBook, insertar música en +@cindex LaTeX, insertar música en @menu * Un ejemplo de documento musicológico:: @@ -91,8 +91,8 @@ Los documentos para \verb+lilypond-book+ pueden mezclar libremente música y texto. Por ejemplo: \begin{lilypond} -\relative c' { - c2 e2 \times 2/3 { f8 a b } a2 e4 +\relative { + c'2 e2 \tuplet 3/2 { f8 a b } a2 e4 } \end{lilypond} @@ -105,9 +105,9 @@ Las opciones se escriben entre corchetes. Los ejemplos grandes se pueden grabar en archivos separados e introducirse con \verb+\lilypondfile+. -\lilypondfile[quote,noindent]{screech-boink.ly} +\lilypondfile[quote,noindent]{screech-and-boink.ly} -(Si es necesario, sustituya @file{screech-boink.ly} +(Si es necesario, sustituya @file{screech-and-boink.ly} por cualquier archivo @file{.ly} situado en el mismo directorio que este archivo.) @@ -125,11 +125,11 @@ Guarde el código anterior como un archivo llamado lilypond-book --output=out --pdf lilybook.lytex @emph{lilypond-book (GNU LilyPond) @version{} } @emph{Leyendo lilybook.lytex...} -@emph{..montañas de mensajes suprimidos..} -@emph{Compilando lilybook.tex...} +@emph{@dots{}montañas de mensajes suprimidos@dots{}} +@emph{Compilando lilybook.tex@dots{}} cd out pdflatex lilybook -@emph{..montañas de mensajes suprimidos..} +@emph{@dots{}montañas de mensajes suprimidos@dots{}} xpdf lilybook @emph{(sustituya @command{xpdf} por su visor de PDF favorito)} @end example @@ -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 @@ -153,8 +153,8 @@ Los documentos para @command{lilypond-book} pueden mezclar libremente música y texto. Por ejemplo: @lilypond -\relative c' { - c2 e2 \times 2/3 { f8 a b } a2 e4 +\relative { + c'2 e2 \tuplet 3/2 { f8 a b } a2 e4 } @end lilypond @@ -167,7 +167,7 @@ c'4 f16 Los ejemplos grandes se pueden grabar en archivos separados e introducirse con @code{\lilypondfile}. -@lilypondfile[quote,noindent]{screech-boink.ly} +@lilypondfile[quote,noindent]{screech-and-boink.ly} Si se requiere un campo @code{tagline}, ya sea predeterminado o personalizado, entonces el fragmento completo se debe incluir dentro @@ -180,8 +180,8 @@ de una construcción @code{\book @{ @}}. title = "Una escala en LilyPond" } - \relative c' { - c d e f g a b c + \relative { + c' d e f g a b c } } @end lilypond @@ -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@{@dots{}@}}, donde podemos escribir directamente fragmentos cortos de código de LilyPond + +@item +el entorno @code{\begin@{lilypond@}@dots{}\end@{lilypond@}}, donde podemos +introducir directamente bloques más largos de código de LilyPond + +@item +la instrucción @code{\lilypondfile@{@dots{}@}} para insertar un archivo de LilyPond + +@item +la instrucción @code{\musicxmlfile@{@dots{}@}} 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. @@ -397,9 +415,9 @@ fragmento: @example \onlyFirstNSystems@{3@} -\begin@{lilypond@}...\end@{lilypond@} +\begin@{lilypond@}@dots{}\end@{lilypond@} \onlyFirstNSystems@{1@} -\begin@{lilypond@}...\end@{lilypond@} +\begin@{lilypond@}@dots{}\end@{lilypond@} @end example @@ -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@{@dots{}@}}, donde podemos introducir +directamente fragmentos cortos de código de LilyPond + +@item +el entorno @code{@@lilypond@dots{}@@end lilypond}, donde podemos escribir +directamente bloques más extensos de código de LilyPond + +@item +la instrucción @code{@@lilypondfile@{@dots{}@}} para insertar un archivo +de LilyPond + +@item +la instrucción @code{@@musicxmlfile@{@dots{}@}} 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@{@dots{}@}} no genera una imagen en línea. Siempre consiste en un párrafo para ella sola. @@ -484,8 +518,46 @@ 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{@dots{}}, donde podemos escribir +directamente bloques más extensos de código de LilyPond + +@item +la instrucción @code{@dots{}} para insertar +un archivo de LilyPond + +@item +la instrucción @code{@dots{}} 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: + +@example + + EL CÓDIGO DE LILYPOND + + + + +@var{archivo} +@var{archivo} +@end example + +Por ejemplo, podemos escribr @example \key c \minor c4 es g2 @@ -500,7 +572,7 @@ etiquetas de imagen adecuadas para los fragmentos de música: \key c \minor c4 es g2 @end lilypond -Para imágenes en línea, utilice @code{}, donde las +Para imágenes en línea, utilice @code{}, donde las opciones están separadas de la música por el símbolo de dos puntos, por ejemplo @@ -511,9 +583,13 @@ Algo de música dentro de una línea de texto. Para incluir archivos externos, escriba @example -@var{archivo} +@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}. @@ -575,8 +651,8 @@ elemento @code{programlisting}, en que el lenguaje se establece como \context Staff \with @{ - \remove Time_signature_engraver - \remove Clef_engraver@} + \remove "Time_signature_engraver" + \remove "Clef_engraver"@} @{ c4( fis) @} @@ -623,11 +699,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 @@ -738,14 +812,14 @@ el modo relativo, pero la cita preformateada no presentará el bloque @code{relative}, es decir @example -\relative c' @{ % begin verbatim - c4 e2 g4 +\relative @{ % begin verbatim + c'4 e2 g4 f2 e % end verbatim @} @end example @noindent -se imprimirá como un bloque preformateado como +se imprime como un bloque preformateado como @example c4 e2 g4 @@ -766,12 +840,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 @@ -810,14 +884,6 @@ contiene @code{@@documentlanguage @var{LANG}} y la cabecera de @file{loquesea.texidoc@var{LANG}} en lugar de @file{loquesea.texidoc}. -@item lilyquote -(Sólo para la salida de Texinfo.) Esta opción es similar a quote, -pero se pone dentro del bloque de cita solamente el fragmento de -música (y el bloque preformateado que se da en la opción -@code{verbatim}). Esta opción es útil si queremos citar -(@code{quote}) el fragmento musical pero no el bloque de documentación -@code{texidoc}. - @item doctitle (Sólo para la salida de Texinfo.) Esta opción funciona de forma parecida a la opción @code{texidoc}: si @command{lilypond} se llama @@ -868,7 +934,7 @@ sencilla y es la que se recomienda@footnote{Observe que PDF@LaTeX{} y @LaTeX{}, y es por lo que explicamos las dos formas.}, y cualquiera que sea el método que utilice, podrá convertir fácilmente entre PostScript y PDF con herramientas como @command{ps2pdf} y -@command{pdf2ps} que vienen incluidas con GhostScript. +@command{pdf2ps} que vienen incluidas con Ghostscript. Para producir un archivo PDF por medio de PDF@LaTeX{}, utilice @@ -900,7 +966,20 @@ 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}. + +@knownissues +La instrucción @code{\pageBreak} no funciona dentro de un entorno +@code{\begin@{lilypond@} @dots{} \end@{lilypond@}}. + +Muchas variables del bloque @code{\paper} tampoco funcionan dentro de +un entorno @code{\begin@{lilypond@} @dots{} \end@{lilypond@}}. Use +@code{\newcommand} con @code{\betweenLilyPondSystem} en el preámbulo: + +@example +\newcommand@{\betweenLilyPondSystem@}[1]@{\vspace@{36mm@}\linebreak@} +@end example + @subsubheading Texinfo @@ -959,7 +1038,16 @@ 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 -l @var{nivel_de_registro} +@itemx --loglevel=@var{nivel_de_registro} +Fijar el nivel en que la salida es prolija, al valor +@var{nivel_de_registro}. Los valores posibles son @code{NONE} (nada), +@code{ERROR} (errores), @code{WARNING} (advertencias), @code{PROGRESS} +(avance; predeterminado) y @code{DEBUG} (depuración). Si esta opción +no se utiliza, y la variable de entorno @code{LILYPOND_BOOK_LOGLEVEL} +está establecida, se usa su valor como el nivel de registro. @item -o @var{directorio} @itemx --output=@var{directorio} @@ -973,34 +1061,46 @@ cambie a este directorio antes de ejecutar @command{latex} o @example lilypond-book --output=out miarchivo.lytex cd out -... +@dots{} @end example -@itemx --skip-lily-check +@item --skip-lily-check Evitar el fracaso si no se encuentra ninguna salida de lilypond. Se usa para la documentación de LilyPond en formato Info sin imágenes. -@itemx --skip-png-check +@item --skip-png-check Evitar el fracaso si no se encuentran las imágenes PNG de los archivos EPS. Se usa para la documentación de LilyPond en formato Info sin imágenes. -@itemx --lily-output-dir=@var{directorio} +@item --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. -@itemx --info-images-dir=@var{directorio} +@item --lily-loglevel=@var{nivel_de_registro} +Fijar el nivel en que la salida es prolija para las llamadas de la +instrucción invocada @command{lilypond}, al valor +@var{nivel_de_registro}. Los valores posibles son @code{NONE} (nada), +@code{ERROR} (errores), @code{WARNING} (advertencias), +@code{BASIC_PROGRESS} (avance básico), @code{PROGRESS} (avance), +@code{INFO} (información; predeterminado) y @code{DEBUG} +(depuración). Si no se utiliza esta opción y la variable de entorno +@code{LILYPOND_LOGLEVEL} está establecida, su valor se usa como nivel +de registro. + + +@item --info-images-dir=@var{directorio} Dar formato a la salida de Texinfo de manera que Info busque las imágenes de música en @var{directorio}. -@itemx --latex-program=@var{prog} +@item --latex-program=@var{prog} Ejecutar el programa @command{prog} en vez de @command{latex}. Esto es útil si nuestro documento se procesa con @command{xelatex}, por ejemplo. -@itemx --left-padding=@var{cantidad} +@item --left-padding=@var{cantidad} Rellenar las cajas EPS en esta medida, alrededor. @var{cantidad} se mide en milímetros, y es 3.0 como valor predeterminado. Esta opción se debe usar si las líneas de música están muy pegadas al margen @@ -1012,26 +1112,30 @@ margen izquierdo, como los números de compás y el nombre del instrumento. Esta opción acorta todas las líneas y las mueve a la derecha en la misma medida. - @item -P @var{instrucción} @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{}. -@itemx --use-source-file-names +@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. + +@item --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 -Ser prolijo. +Ser prolijo. Equivale a @code{--loglevel=DEBUG}. @item -v @itemx --version @@ -1079,11 +1183,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 @@ -1104,8 +1209,8 @@ LaTeX. Texto normal en LaTeX. \begin@{lilypond@} -\relative c'' @{ - a4 b c d +\relative @{ + a'4 b c d @} \end@{lilypond@} @@ -1130,7 +1235,7 @@ todo el presente manual está escrito en Texinfo. Texto en Texinfo @@lilypond -\relative c' @{ +\relative @{ a4 b c d @} @@end lilypond @@ -1157,8 +1262,8 @@ d4 c b a Los documentos para lilypond-book pueden mezclar música y texto libremente. Por ejemplo, -\relative c'' @{ - a4 b c d +\relative @{ + a'4 b c d

Otro poco de lilypond, esta vez con opciones: