SYNOPSIS

lilypond-book [OPTION]... FILE

DESCRIPTION

Process LilyPond snippets in hybrid HTML, LaTeX, texinfo or DocBook document.

OPTIONS

-F, --filter=FILTER

pipe snippets through FILTER [default: `convert-ly -n -']

-f, --format=FORMAT

use output format FORMAT (texi [default], texi-html, latex, html, docbook)

-h, --help

show this help and exit

-I, --include=DIR

add DIR to include path

--info-images-dir=DIR

format Texinfo output so that Info will look for images of music in DIR

--left-padding=PAD

pad left side of music to align music inspite of uneven bar numbers (in mm)

--lily-loglevel=LOGLEVEL

Print lilypond log messages according to LOGLEVEL

--lily-output-dir=DIR

write lily-XXX files to DIR, link into --output dir

--load-custom-package=PACKAGE

Load the additional python PACKAGE (containing e.g. a custom output format)

-l, --loglevel=LOGLEVEL

Print log messages according to LOGLEVEL (NONE, ERROR, WARNING, PROGRESS (default), DEBUG)

-o, --output=DIR

write output to DIR

-P, --process=COMMAND

process ly_files using COMMAND FILE...

--redirect-lilypond-output

Redirect the lilypond output

-s, --safe

Compile snippets in safe mode

--skip-lily-check

do not fail if no lilypond output is found

--skip-png-check

do not fail if no PNG images are found for EPS files

--use-source-file-names

write snippet output files with the same base name as their source file

-V, --verbose

be verbose

--version

show version number and exit

-w, --warranty

show warranty and copyright

Options only for the latex and texinfo backends:

--latex-program=PROG

run executable PROG instead of latex, or in case --pdf option is set instead of pdflatex

--texinfo-program=PROG

run executable PROG instead of texi2pdf

--pdf

create PDF files for use with PDFTeX

EXAMPLES

  • $ lilypond-book --filter="tr '[a-z]' '[A-Z]'" BOOK

    $ lilypond-book -F "convert-ly --no-version --from=2.0.0 -" BOOK

    $ lilypond-book --process='lilypond -I include' BOOK

REPORTING BUGS

Report bugs via http://post.gmane.org/post.php?group=gmane.comp.gnu.lilypond.bugs

RELATED TO lilypond-book…

The full documentation for lilypond-book is maintained as a Texinfo manual. If the info and lilypond-book programs are properly installed at your site, the command

  • info lilypond-book

should give you access to the complete manual.