Siguiente: , Anterior: Opciones de fragmentos de música, Arriba: LilyPond-book


4.4 Invoking lilypond-book

lilypond-book produce un archivo con una de las siguientes extensiones: .tex, .texi, .html o .xml, dependiendo del formato de salida. Todos los archivos .tex, .texi y .xml necesitan un procesado posterior.

lilypond-book también puede crear un archivo .psfonts, que se requiere por parte de dvips para producir archivos PostScript y PDF.

Instrucciones específicas de formato

LaTeX

Hay dos formas de procesar el documento en LaTeX para su impresión o publicación: hacer un archivo PDF directamente con PDFLaTeX, o generar un archivo PostScript con LaTeX a través de un traductor de DVI a PostScript como dvips. la primera forma es más sencilla y es la que se recomienda1, y cualquiera que sea el método que utilice, podrá convertir fácilmente entre PostScript y PDF con herramientas como ps2pdf y pdf2ps que vienen incluidas con Ghostscript.

Para producir un archivo PDF por medio de PDFLaTeX, utilice

lilypond-book --pdf miarchivo.pdftex
pdflatex miarchivo.tex

Para producir una salida PDF por medio de LaTeX/dvips/ps2pdf, debe hacer

lilypond-book --psfonts miarchivo.lytex
latex miarchivo.tex
dvips -o -h miarchivo.psfonts -Ppdf miarchivo.dvi
ps2pdf miarchivo.ps

El archivo .dvi creado por este proceso no contiene las cabezas de las notas. Esto es normal; si sigue las instrucciones, las cabezas aparecerán en los archivos .ps y .pdf.

La ejecución de dvips dará como resultado algunas advertencias sobre las fuentes tipográficas; son inocuas y se pueden ignorar. Si está ejecutando latex en modo de dos columnas, recuerde añadir -t landscape a las opciones de dvips.

Texinfo

Para producir un documento de Texinfo (en cualquier formato de salida), siga el procedimiento normal para Texinfo, esto es: o bien llame a texi2pdf o a texi2dvi o a makeinfo, según el formato de la salida que quiera crear. Consulte la documentación de Texinfo para ver más detalles.

Opciones de la línea de órdenes

lilypond-book acepta las siguientes opciones de la línea de órdenes:

-f formato
--format=formato
Especificar el tipo del documento que se va a procesar: html, latex, texi (predeterminado) o docbook. Si falta esta opción, lilypond-book tratará de detectar el formato automáticamente, véase Extensiones de nombres de archivo. Por el momento, texi es lo mismo que texi-html.
-F filtro
--filter=filtro
Conducir los fragmentos a través de filter por medio de una tubería. lilypond-book no obedecerá –filter y –process al mismo tiempo. Por ejemplo,
     lilypond-book --filter='convert-ly --from=2.0.0 -' mi-libro.tely

-h
--help
Imprimir un breve mensaje de ayuda.
-I directorio
--include=directorio
Añadir directorio a la ruta de inclusión. lilypond-book busca también los fragmentos ya compilados en 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 makeinfo o latex con las mismas opciones -I directorio.
-o directorio
--output=directorio
Colocar los archivos generados en el directorio. La ejecución de lilypond-book genera montañas de pequeños archivos que luego procesará LilyPond. Para evitar toda esta parafernalia en el mismo directorio que la fuente, utilice la opción --output, y cambie a este directorio antes de ejecutar latex o makeinfo.
     lilypond-book --output=out miarchivo.lytex
     cd out
     ...
--left-padding=cantidad
Rellenar las cajas EPS en esta medida, alrededor. 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 derecho.

El ancho de los sistemas que están muy ajustados dentro de su rectángulo puede variar, debido a los elementos de notación que están pegados al 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.

-P proceso
--process=instrucción
Procesar los fragmentos de LilyPond utilizando instrucción. La instrucción predeterminada es lilypond. lilypond-book no obedecerá a --filter y a --process al mismo tiempo.
--pdf
Crear archivos PDF para su uso con PDFLaTeX.
--psfonts
Extraer todas las tipografías PostScript en archivo.psfonts para dvips. Esto es necesario para dvips -h archivo.psfonts.
-V
--verbose
Ser prolijo.
-v
--version
Imprimir la información de la versión.

Advertencias y problemas conocidos

La instrucción de Texinfo @pagesizes no se interpreta. De forma similar, las instrucciones de LaTeX que cambian los márgenes y anchos de línea después del preámbulo se ignoran.

Sólo se procesa el primer \score de un bloque LilyPond.


Notas al pie

[1] Observe que PDFLaTeX y LaTeX podrían no ser utilizables para compilar cualquier documento LaTeX, y es por lo que explicamos las dos formas.


Esta página corresponde a LilyPond-2.11.58 (rama de desarrollo).

Informe de los fallos a través de la lista en español lilypond-es, o en inglés a través de http://post.gmane.org/post.php?group=gmane.comp.gnu.lilypond.bugs.

Se agradecen las sugerencias para la documentación.

Otros idiomas: English, deutsch.