LilyPond(1)

NAME
mudela-book - integrate LaTeX and mudela

SYNOPSIS
mudela-book [options] inputfile

DESCRIPTION
mudela-book is a script that helps integrating mudela and LaTeX. 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 music integrated.

Lilypond will by default create all output files in directory out. The file to give to latex has ext .latex.

About the input

If the file contains the ``block''

        \begin{mudela}
        CONTENTS
        \end{mudela}

then LilyPond is run on CONTENTS. mudela-book puts the result back, surrounded by \preMudelaExample and \postMudelaExample commands. \preMudelaExample and posMudelaExample is defined to nothing by default, and the user can redefine them to whatever he wants.

\begin takes the following options:

eps the music is created as eps graphics that can be inserted in the middle of a text line, not only as a separate paragraph

verbatim
    CONTENTS is copied into the TeX source enclosed in a verbatim block.

11pt, 13pt, 16pt, 20pt, 26pt
    set the fontsize to use for the music

singleline
    linewidth = -1.

multiline
    linewidth = textwidth

fragment

nonfragment
    Override mudela-book autodetection of what type of code is in the mudela block, voice contents or complete code.

OPTIONS

--default-mudela-fontsize=??pt
    Set the fontsize to use for mudela if no fontsize is given as option.

--force-mudela-fontsize=??pt
    Force all mudela to use this fontsize, overriding options given to \begin{mudela}

--outname=FILE
    The name of file to output. If this option is not given, the output name derived from the input name.

--outdir=DIRECTORY
    The name of the directory to output lilypond output and input to. This must be a name; the subdirectory will be created in the cwd. [FIXME]

--help
    Print a short help message

--dependencies
    Write dependencies to outdir/filename.dep

--force-verbatim
    Make all mudela verbatim.

--initfile=FILE
    read command definitions from FILE

FILES
See Documentation/tex/out/mudela-book-doc.dvi for more info. You have to install LaTeX. mudela-book is written in python 1.5, so you have to install python.

BUGS

The LaTeX \includeonly{...} command is ignored.

You get trouble if you use the --force-verbatim option and have some music in \footnote{...} or \marginpar{...}.

Ignores almost all LaTeX commands that changes margins and linewidths.

AUTHOR

Han-Wen Nienhuys <hanwen@cs.uu.nl>, http://www.cs.uu.nl/people/hanwen

Tom Cato Amundsen <tomato@xoommail.com>