X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Fes%2Fusage%2Flilypond-book.itely;h=69ceb89e0823ad3f3b0641df70a55e773252208e;hb=26a079ca2393d053315ef8dbef626c897dc9645a;hp=7497eb312fee0130ec5a45474ad36815c608e033;hpb=a96f9fb96e5a3dd0cdb0e421b78c6c94200b234a;p=lilypond.git diff --git a/Documentation/es/usage/lilypond-book.itely b/Documentation/es/usage/lilypond-book.itely index 7497eb312f..69ceb89e08 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: f78131595ebafac25a416671e5a4b9c8b14e79b5 + Translation of GIT committish: f71ede90de06fdc16dad9ed75f38558efe819080 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.13.36" +@c \version "2.16.0" @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:: @@ -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.) @@ -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 @@ -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 @@ -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 -En el archivo de entrada, la música se especifica con +@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 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,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{...}, 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: + +@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 +586,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 +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 @@ -745,7 +819,7 @@ el modo relativo, pero la cita preformateada no presentará el bloque @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} @@ -987,10 +1075,22 @@ 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. +@itemx --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. + + @itemx --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}. @@ -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{}. +@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 -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