[ << lilypond-book ] | [Top][Contents][Index] | [ External programs >> ] |
[ < lilypond-book ] | [ Up : lilypond-book ] | [ Integrating music and text > ] |
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 (replacexpdf
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.
[ << lilypond-book ] | [Top][Contents][Index] | [ External programs >> ] |
[ < lilypond-book ] | [ Up : lilypond-book ] | [ Integrating music and text > ] |