[ << Ejecución de lilypond-book ] | [Top][Contents][Index] | [ Programas externos >> ] |
[ < Opciones de fragmentos de música ] | [ Up : Ejecución de lilypond-book ] | [ Extensiones de nombres de archivo > ] |
3.4 Invocar 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.
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
recomienda4, 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
:
lilypond-book miarchivo.lytex latex miarchivo.tex dvips -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
puede 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
.
Entornos tales como:
\begin{lilypond} … \end{lilypond}
no se interpretan por parte de LaTeX. En su lugar, el programa
lilypond-book
extrae estos ‘entornos’ como archivos
independientes y ejecuta LilyPond sobre ellos. Después, toma las
imágenes resultantes y crea un archivo .tex en el que los
macros \begin{lilypond}
…\end{lilypond}
se
sustituyen por instrucciones de ‘inserción de gráficos’. A
continuación, se ejecuta LaTeX (aunque LaTeX se ha ejecutado
anteriormente, lo habrá sido sobre un archivo ‘vacío’ para
calcular cosas como el \linewidth
).
Advertencias y problemas conocidos
La instrucción \pageBreak
no funciona dentro de un entorno
\begin{lilypond} … \end{lilypond}
.
Muchas variables del bloque \paper
tampoco funcionan dentro
de un entorno \begin{lilypond} … \end{lilypond}
.
Use \newcommand
con \betweenLilyPondSystem
en el
preámbulo:
\newcommand{\betweenLilyPondSystem}[1]{\vspace{36mm}\linebreak}
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
texi2any
, 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) odocbook
. 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 quetexi-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 comotexi2any
olatex
con las mismas opciones -I directorio.-l nivel_de_registro
--loglevel=nivel_de_registro
Fijar el nivel en que la salida es prolija, al valor nivel_de_registro. Los valores posibles son
NONE
(nada),ERROR
(errores),WARN
(advertencias),PROGRESS
(avance; predeterminado) yDEBUG
(depuración). Si esta opción no se utiliza, y la variable de entornoLILYPOND_BOOK_LOGLEVEL
está establecida, se usa su valor como el nivel de registro.-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 ejecutarlatex
otexi2any
.lilypond-book --output=out miarchivo.lytex cd out …
--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.
--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.
--lily-output-dir=directorio
Escribir archivos lily-XXX en el directorio directorio, enlazar en el directorio de --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.
--lily-loglevel=nivel_de_registro
Fijar el nivel en que la salida es prolija para las llamadas de la instrucción invocada
lilypond
, al valor nivel_de_registro. Los valores posibles sonNONE
(nada),ERROR
(errores),WARN
(advertencias),BASIC
(avance básico),PROGRESS
(avance),INFO
(información; predeterminado) yDEBUG
(depuración). Si no se utiliza esta opción y la variable de entornoLILYPOND_LOGLEVEL
está establecida, su valor se usa como nivel de registro.--info-images-dir=directorio
Dar formato a la salida de Texinfo de manera que Info busque las imágenes de música en directorio.
--latex-program=prog
Ejecutar el programa
prog
en vez delatex
. Esto es útil si nuestro documento se procesa conxelatex
, por ejemplo.--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 un sistema que está muy ajustado 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 instrucción
--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.
--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.
--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
lilypondfile
y sólo si los directorios determinados por las opciones --output-dir y --lily-output-dir son distintos.-V
--verbose
Ser prolijo. Equivale a
--loglevel=DEBUG
.-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.
Footnotes
(4)
Observe que PDFLaTeX y LaTeX podrían no ser utilizables para compilar cualquier documento LaTeX, y es por lo que explicamos las dos formas.
[ << Ejecución de lilypond-book ] | [Top][Contents][Index] | [ Programas externos >> ] |
[ < Opciones de fragmentos de música ] | [ Up : Ejecución de lilypond-book ] | [ Extensiones de nombres de archivo > ] |