## 3.1 An example of a musicological document

Some texts contain music examples. These texts are musicological treatises, songbooks, or manuals like this. Such texts can be made by hand, simply by importing a PostScript figure into the word processor. However, there is an automated procedure to reduce the amount of work involved in HTML, LaTeX, Texinfo and DocBook documents.

A script called lilypond-book will extract the music fragments, format them, and put back the resulting notation. Here we show a small example for use with LaTeX. The example also contains explanatory text, so we will not comment on it further.

### Input

\documentclass[a4paper]{article}

\begin{document}

Documents for \verb+lilypond-book+ may freely mix music and text.
For example,

\begin{lilypond}
\relative {
c'2 e2 \tuplet 3/2 { f8 a b } a2 e4
}
\end{lilypond}

Options are put in brackets.

\begin{lilypond}[fragment,quote,staffsize=26,verbatim]
c'4 f16
\end{lilypond}

Larger examples can be put into a separate file, and introduced with
\verb+\lilypondfile+.

\lilypondfile[quote,noindent]{screech-and-boink.ly}

(If needed, replace @file{screech-and-boink.ly} by any @file{.ly} file
you put in the same directory as this file.)

\end{document}


### Processing

Save the code above to a file called ‘lilybook.lytex’, then in a terminal run

lilypond-book --output=out --pdf lilybook.lytex
lilypond-book (GNU LilyPond) 2.23.5
…lots of stuff deleted…
Compiling lilybook.tex...
cd out
pdflatex lilybook
…lots of stuff deleted…
xpdf lilybook
(replace xpdf by your favorite PDF viewer)


Running lilypond-book and latex creates a lot of temporary files, which would clutter up the working directory. To remedy this, use the ‘--output=dir’ option. It will create the files in a separate subdirectory ‘dir’.

Finally the result of the LaTeX example shown above.1 This finishes the tutorial section.

### Output

Documents for lilypond-book may freely mix music and text. Using Texinfo syntax, this example

@lilypond
\relative {
c'2 e2 \tuplet 3/2 { f8 a b } a2 e4
}
@end lilypond


produces

Options to control the appearance of snippets can be added, too. Using LaTeX syntax, this example

\begin{lilypond}[fragment, quote, staffsize=26]
c'4 f16
\end{lilypond}


produces

Larger music snippets can be put into separate files. Using HTML syntax, this example

<lilypondfile quote noindent>
snippets/screech-and-boink.ly
</lilypondfile>


produces

If a tagline is required, either default or custom, the entire snippet must be enclosed in a \book { } construct.

\book {
\header { title = "A scale in LilyPond" }

\relative { c' d e f g a b c }
}


### Footnotes

[1] This tutorial is processed with Texinfo, so the example gives slightly different results in layout.