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.82 
Reading lilybook.lytex...
…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

[image of music]

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

[image of music]

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

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

produces

[image of music]

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 }
}

[image of music]


Footnotes

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


LilyPond — Usage v2.23.82 (development-branch).