8.4 Music fragment options

The commands for lilypond-book have room to specify one or more of the following options:

verbatim

CONTENTS is copied into the source enclosed in a verbatim block, followed by any text given with the intertext option, then the actual music is displayed. This option does not work with the short version of the music blocks:

@lilypond{ CONTENTS } and \lilypond{ CONTENTS }

smallverbatim

works like verbatim, but in a smaller font.

intertext="text"

is used in conjunction with verbatim option: This puts text between the code and the music (without indentation).

filename="filename"

saves the LilyPond code to filename. By default, a hash value of the code is used.

11pt

13pt

16pt

20pt

26pt

raggedright

produces naturally spaced lines (i.e., raggedright = ##t); this works well for small music fragments.

multiline

is the opposite of singleline: it justifies and breaks lines.

linewidth=sizeunit

sets linewidth to size, where unit = cm, mm, in, or pt. This option affects LilyPond output, not the text layout.

notime

prevents printing time signature.

fragment

nofragment

overrides lilypond-book auto detection of what type of code is in the LilyPond block, voice contents or complete code.

indent=sizeunit

sets indentation of the first music system to size, where unit = cm, mm, in, or pt. This option affects LilyPond, not the text layout. For single-line fragments the default is to use no indentation.

For example

            \begin[indent=5cm,raggedright]{lilypond}
            ...
            \end{lilypond}
     

noindent

sets indentation of the first music system to zero. This option affects LilyPond, not the text layout.

notexidoc

prevents including texidoc. This is only for Texinfo output.

In Texinfo, the music fragment is normally preceded by the texidoc field from the \header. The LilyPond test documents are composed from small .ly files in this way:

            \header {
              texidoc = "this file demonstrates a single note"
            }
            \score { \notes { c'4 } }
     

quote

instructs lilypond-book to put LaTeX and Texinfo output into a quotation block.

printfilename

prints the file name before the music example. Useful in conjunction with \lilypondfile.

relative, relative N

uses relative octave mode. By default, notes are specified relative central C. The optional integer argument specifies the octave of the starting note, where the default 1 is central C.

This page is for LilyPond-2.0.3 (stable-branch). Report errors to <bug-lilypond@gnu.org>.