Section “Troubleshooting” in Application Usage - LilyPond

Chapter 3: Running lilypond-book 29
doctitle (Only for Texinfo output.) This option works similarly to texidoc option: if
lilypond is called with the ‘--header=doctitle’ option, and the file to be processed
is called ‘foo.ly’ and contains a doctitle field in the \header, it creates a
file ‘foo.doctitle’. When doctitle option is used, the contents of ‘foo.doctitle’,
which should be a single line of text, is inserted in the Texinfo document as
@lydoctitle text. @lydoctitle should be a macro defined in the Texinfo document.
The same remark about texidoc processing with localized languages also
applies to doctitle.
nogettext
(Only for Texinfo output.) Do not translate comments and variable names in the
snippet quoted verbatim.
printfilename
If a LilyPond input file is included with \lilypondfile, print the file name right
before the music snippet. For HTML output, this is a link. Only the base name of
the file is printed, i.e. the directory part of the file path is stripped.
3.4 Invoking 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.
Format-specific instructions
L A TEX
There are two ways of processing your L A TEX document for printing or publishing: getting a PDF
file directly with PDFL A TEX, or getting a PostScript file with L A TEX via a DVI to PostScript
translator like dvips. The first way is simpler and recommended 1 , 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 PDFL A TEX, use
lilypond-book --pdf yourfile.lytex
pdflatex yourfile.tex
To produce PDF output via L A TEX/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.
Known issues and warnings
The \pageBreak command will not work within a \begin{lilypond} ... \end{lilypond}
environment.
1 Note that PDFLATEX and LATEX may not be both usable to compile any LATEX document, that is why we
explain the two ways.