Next: Filename extensions, Previous: Music fragment options, Up: LilyPond-book
lilypond-book produces a file with one of the following extensions: .tex, .texi, .html or .xml, depending on the output format. All of .tex, .texi and .xml files need further processing.
There are two ways of processing your LaTeX document for printing or publishing: getting a PDF file directly with PDFLaTeX, or getting a PostScript file with LaTeX via a DVI to PostScript translator like dvips. The first way is simpler and recommended1, and whichever way you use, you can easily convert between PostScript and PDF with tools, like ps2pdf and pdf2ps included in Ghostscript package.
To produce a PDF file through PDFLaTeX, use
lilypond-book --pdf yourfile.pdftex pdflatex yourfile.tex
To produce PDF output via LaTeX/dvips/ps2pdf, you should do
lilypond-book yourfile.lytex latex yourfile.tex dvips -Ppdf yourfile.dvi ps2pdf yourfile.ps
The .dvi file created by this process will not contain note heads. This is normal; if you follow the instructions, they will be included in the .ps and .pdf files.
Running dvips may produce some warnings about fonts; these
are harmless and may be ignored. If you are running latex in
twocolumn mode, remember to add -t landscape
to the
dvips options.
To produce a Texinfo document (in any output format), follow the normal procedures for Texinfo; this is, either call texi2pdf or texi2dvi or makeinfo, depending on the output format you want to create. See the documentation of Texinfo for further details.
lilypond-book accepts the following command line options:
-f
format--format=
formathtml
, latex
,
texi
(the default) or docbook
. If this option is missing,
lilypond-book tries to detect the format automatically, see
Filename extensions. Currently, texi
is the same as
texi-html
.
-F
filter--filter=
filterlilypond-book
will
not –filter and –process at the same time. For example,
lilypond-book --filter='convert-ly --from=2.0.0 -' my-book.tely
-h
--help
-I
dir--include=
dir-I
dir options.
-o
dir--output=
dirlilypond-book --output=out yourfile.lytex cd out ...
--skip-lily-check
--skip-png-check
--lily-output-dir=
dir--output
directory. Use this option to save building time for documents in
different directories which share a lot of identical snippets.
--info-images-dir=
dir--latex-program=
prog--left-padding=
amountThe width of a tightly clipped system can vary, due to notation
elements that stick into the left margin, such as bar numbers and
instrument names. This option will shorten each line and move each
line to the right by the same amount.
-P
command--process=
commandlilypond
. lilypond-book
will not --filter
and
--process
at the same time.
--pdf
-V
--verbose
-v
--version
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.
[1] Note that PDFLaTeX and LaTeX may not be both usable to compile any LaTeX document, that is why we explain the two ways.
Cette page documente LilyPond-2.11.58 (branche de développement).
Rapportez toute anomalie en français à lilypond-user-fr@gnu.org ou en anglais à http://post.gmane.org/post.php?group=gmane.comp.gnu.lilypond.bugs
Vos suggestions à propos de la documentation sont les bienvenues.