@titlepage
@title mudela-book Manual
-@subtitle Integrating mudela with LateX and TeXinfo
+@subtitle Integrating mudela with La@TeX{} and TeXinfo
@author Tom Cato Amundsen and Han-Wen Nienhuys
- Copyright @copyright 1999 by the authors
+ Copyright @copyright{} 1999 by the authors
@vskip 0pt plus 1filll
[TODO: THIS MANUAL IS OUTDATED. FIXME.]
-Mudela-book is a script that process your \LaTeX file and with great
+Mudela-book is a script that process your La@TeX{} file and with great
help from GNU LilyPond it translates blocks of mudela code it finds
inside @code{mudela} environments to tex or eps graphics. It then
-creates a new file that can be sent through \LaTeX to create a
+creates a new file that can be sent through La@TeX{} to create a
@file{.dvi} file with lines of music integrated with text.
Mudela-book will do its best to try to align the music to the left and
right margins. Currently the most used papersizes and one- and
twocolumn mode is supported, but if you use the geometry-package from
-LaTeX or change the margins things will break.
+La@TeX{} or change the margins things will break.
This document assumes you have basic knowledge of GNU LilyPond and
-LaTeX.
+La@TeX{}.
So what does this look like? Well, here is an example:
@mudela[veryverbatim, intertext="produces this music:"]
}
@end mudela
If you are lucky, the above example show a nice feature of LilyPond
-and LaTeX. Since LilyPond can output the music as \TeX graphics,
-LaTeX can insert pagebreaks between the lines of music.
+and La@TeX{}. Since LilyPond can output the music as @TeX{} graphics,
+La@TeX{} can insert pagebreaks between the lines of music.
Notice that there is no @code{\paper} statement in the example
above. Mudela-book will insert some code for you that defines the
will make the music as short as possible but without breaking the
line. Here is a well know harmonic progression:
@mudela[veryverbatim, intertext="produce a well known harmonic progression:"]
- <c' e g> <b d g> <c2 e g>
+ \context Voice { <c' e g> <b d g> <c2 e g> }
@end mudela
If you want to place music examples in the text,
@mudela[eps]
- <c' e g> <b d g> <c2 e g>
+\context Voice { <c' e g> <b d g> <c2 e g>}
@end mudela
, you can use the @code{eps} option. This will create the music as
eps graphics and include it into the document with the
The code used look like this:
@example
-@mudela[eps]
- <c' e g> <b d g> <c2 e g>
-@end mudela
+@@mudela[eps]
+ \context Voice { <c' e g> <b d g> <c2 e g> }
+@@end mudela
@end example
You can also use the @code{eps} option if the block is a complete
@end mudela
was created with this code:
@example
-@mudela[eps]
-\score{
- \notes{s}
- \paper{ linewidth = 5.\cm;}
-}
-@end mudela
+@@mudela[eps]
+\score@{
+ \notes@{s@}
+ \paper@{ linewidth = 5.\cm;@}
+@}
+@@end mudela
@end example
-To avoid that LaTeX places the music on a line of its one, there should
+To avoid that La@TeX{} places the music on a line of its one, there should
be no empty lines between the normal text and the mudela
environment.
You can also use @code{mudelafile} (on a separate line, FIXME), to
-include another file. Files with name ending with @code{.sly}
+include another file.
@section Fontsize options You can use all lilypond fontsizes in
mudela-book. The default 16pt fontsize is probably to big to be
The code can look like this:
@example
-@mudela[13pt, eps]
+@@mudela[13pt, eps]
<c' e g>
-@end mudela
+@@end mudela
@end example
The following options set the fontsize:
This was all options to @code{\begin}. The rest of the mudela
document will show some ways you can use mudela in
-LaTeX documents. It will also act as a simple test-suite for
+La@TeX{} documents. It will also act as a simple test-suite for
mudela-book. You can place @code{eps} mudela in and marginspars just
as any other included eps graphics.
So the music will be adjusted to the new linewith:
Verbatim environments will also ignore the page margins. That is
-a feature of LaTeX. (But you usually put things inside a verbatim
-environment when you don't want LaTeX to do any linebreaking)
+a feature of La@TeX{}. (But you usually put things inside a verbatim
+environment when you don't want La@TeX{} to do any linebreaking)
@section Texinfo behavior
@section Invocation
@file{mudela-book} is a script that helps integrating mudela and
-LaTeX. mudela-book runs LilyPond on fragments of mudela in your
+La@TeX{}. mudela-book runs LilyPond on fragments of mudela in your
source file, and includes the results into document that can be
-processed with LaTeX. The result is a text document with formatted
+processed with La@TeX{}. The result is a text document with formatted
music integrated.
Lilypond will by default create all output files in directory @file{out}.
Force all mudela to use this fontsize, overriding options
given to \begin@{mudela@}
@item --outname=FILE
- The name of LaTeX file to output. If this option is not given,
+ The name of La@TeX{} file to output. If this option is not given,
the output name derived from the input name.
@item --out-www=DIRECTORY
The name of the directory to output lilypond output and input to.
@section Bugs
-The LaTeX \includeonly@{...@} command is ignored.
+The La@TeX{} \includeonly@{...@} command is ignored.
-Ignores almost all LaTeX commands that changes margins and linewidths.
+Ignores almost all La@TeX{} commands that changes margins and linewidths.
@section Authors
@bye
-
-
-
-
-