Next: Invoking lilypond-book, Previous: Integrating music and text, Up: LilyPond-book
In the following, a ‘LilyPond command’ refers to any command described in the previous sections which is handled by lilypond-book to produce a music snippet. For simplicity, LilyPond commands are only shown in LaTeX syntax.
Note that the option string is parsed from left to right; if an option occurs multiple times, the last one is taken.
The following options are available for LilyPond commands:
staffsize=
htragged-right
ragged-right = ##t
is added to the LilyPond snippet. This is the
default for the \lilypond{}
command if no line-width
option is present. It is also the default for the lilypond
environment if the fragment
option is set, and no line width is
explicitly specified.
packed
packed = ##t
is added
to the LilyPond snippet.
line-width
line-width=
size\
unitcm
, mm
, in
, or
pt
. This option affects LilyPond output (this is, the staff
length of the music snippet), not the text layout.
If used without an argument, set line width to a default value (as computed with a heuristic algorithm).
If no line-width
option is given, lilypond-book tries to
guess a default for lilypond
environments which don't use the
ragged-right
option.
notime
fragment
c'4
without \layout
, \score
, etc.
nofragment
nofragment
is redundant normally.
indent=
size\
unitcm
, mm
, in
, or pt
. This option affects
LilyPond, not the text layout.
noindent
noindent
is redundant normally.
quote
exampleindent
option.
exampleindent
quote
option indents a music snippet.
relative
relative=
n1
is middle C.
LilyPond also uses lilypond-book to produce its own documentation. To do that, some more obscure music fragment options are available.
verbatim
intertext
option (not implemented yet); then the actual music is
displayed. This option does not work well with \lilypond{}
if
it is part of a paragraph.
If verbatim
is used in a lilypondfile
command, it is
possible to enclose verbatim only a part of the source file. If the
source file contain a comment containing ‘begin verbatim’ (without
quotes), quoting the source in the verbatim block will start after the
last occurence of such a comment; similarly, quoting the source verbatim
will stop just before the first occurence of a comment containing
‘end verbatim’, it there is any. In the following source file
example, the music will be interpreted in relative mode, but the
verbatim quote will not show the relative
block, i.e.
\relative c' { % begin verbatim c4 e2 g4 f2 e % end verbatim }
will be printed with a verbatim block like
c4 e2 g4 f2 e
texidoc
texidoc
field in the \header
. The texidoc
option makes lilypond-book include such files, adding its
contents as a documentation block right before the music snippet.
Assuming the file foo.ly contains
\header { texidoc = "This file demonstrates a single note." } { c'4 }
and we have this in our Texinfo document test.texinfo
@lilypondfile[texidoc]{foo.ly}
the following command line gives the expected result
lilypond-book --process="lilypond --format=tex --tex \ --header=texidoc test.texinfo
Most LilyPond test documents (in the input directory of the
distribution) are small .ly files which look exactly like this.
lilyquote
verbatim
option) is put into a quotation block. This option is
useful if you want to quote
the music snippet but not the
texidoc
documentation block.
printfilename
\lilypondfile
, print
the file name right before the music snippet. For HTML output, this is
a link.
fontload
Next: Invoking lilypond-book, Previous: Integrating music and text, Up: LilyPond-book
Cette page documente LilyPond-2.11.40 (branche de développement).
Rapportez toute anomalie en français à lilypond-user-fr@gnu.org ou en anglais à http://post.gmane.org/post.php?group=gmane.comp.gnu.lilypond.bugs
Vos suggestions à propos de la documentation sont les bienvenues.