Next: , Previous: Music fragment options, Up: LilyPond-book



9.6 Invoking lilypond-book

lilypond-book produces a file with one of the following extensions: .tex, .texi, or .html, depending on the output format. Both .tex and .texi files need further processing.

To produce PDF output from the .tex file, you should do

latex yourfile.tex
dvips -Ppdf -u+ec-mftrace.map -u+lilypond.map yourfile.dvi
ps2pdf yourfile.ps

To produce a Texinfo document (in any output format), follow the normal procedures for Texinfo (this is, either call texi2dvi or makeinfo, depending on the output format you want to create). See Format with texi2dvi (GNU Texinfo), and Creating an Info File (GNU Texinfo).

lilypond-book accepts the following command line options:

-f format
--format=format
Specify the document type to process: html, latex, or texi (the default). If this option is missing, lilypond-book tries to detect the format automatically.

The texi document type produces a Texinfo file with music fragments in the DVI output only. For getting images in the HTML version, the format texi-html must be used instead.

[Note: Currently, texi is the same as texi-html.]

-F filter
--filter=filter
Pipe snippets through filter.

Example:

     lilypond-book --filter='convert-ly --from=2.0.0' my-book.tely

-h
--help
Print a short help message.
-I dir
--include=dir
Add dir to the include path.
-o dir
--output=dir
Place generated files in directory dir. Running lilypond-book generates lots of small files that LilyPond will process. To avoid all that garbage in the source directory use the --output command line option, and change to that directory before running latex or makeinfo:
     lilypond-book --output=out yourfile.lytex
     cd out
     ...

-P process
--process=command
Process LilyPond snippets using command. The default command is lilypond.
-V
--verbose
Be verbose.
-v
--version
Print version information.

Bugs

The Texinfo command @pagesizes is not interpreted. Similarly, LaTeX commands that change margins and line widths after the preamble are ignored.

Only the first \score of a LilyPond block is processed.

The size of a music block is limited to 1.5 KB, due to technical problems with the Python regular expression engine. For longer files, use \lilypondfile.

Read comments on this page, or add one.

This page is for LilyPond-2.5.11 (development-branch).

Report errors to <bug-lilypond@gnu.org>.

Other languages: English.
Using automatic language selection.