3.2.2 Texinfo

Texinfo is the standard format for documentation of the GNU project. An example of a Texinfo document is this manual. The HTML, PDF, and Info versions of the manual are made from the Texinfo document.

lilypond-book provides the following commands and environments to include music in Texinfo files:

• the @lilypond{…} command to directly enter short LilyPond code,
• the @lilypond…@end lilypond environment to directly enter longer LilyPond code,
• the @lilypondfile{…} command to insert a LilyPond file,
• the @musicxmlfile{…} command to insert a MusicXML file, which gets processed by musicxml2ly and lilypond.

In the input file, music is specified with any of the following commands

@lilypond[options,go,here]
  YOUR LILYPOND CODE
@end lilypond

@lilypond[options,go,here]{ YOUR LILYPOND CODE }

@lilypondfile[options,go,here]{filename}

@musicxmlfile[options,go,here]{filename}

Additionally, @lilypondversion displays the current version of LilyPond.

All of the above commands must start a line (possibly preceded by whitespace), even if used with the inline fragment option. There must be also no text after the closing brace (for @lilypond{...}) or @end lilypond.

When lilypond-book is run on it, this results in a Texinfo file (with extension .texi) containing @image tags for HTML, Info and printed output. lilypond-book generates images of the music in EPS and PDF formats for use in the printed output, and in PNG format for use in HTML and Info output.

We show some examples here. The lilypond environment

@lilypond[quote,fragment]
  c'4 d' e' f' g'2 g'
@end lilypond

produces

The short version

@lilypond[quote,fragment,staffsize=11]{<c' e' g'>}

produces

See also

There are specific lilypond-book command-line options and other details to know when processing Texinfo documents, see Invoking lilypond-book.