( LilyPond

LilyPond

The LilyPond package

1998

NAME

Ly2dvi - convert mudela to DVI

DESCRIPTION

ly2dvi is a shell script which creates input file for LaTeX, based on information from the output files from lilypond. The script handles multiple files. If a mudela file name is specified lilypond is run to make an output (TeX) file.

One or more LaTeX files are created, based on information found in the output (TeX) files, and latex is finally run to create one or more DVI files.

SYNOPSIS

ly2dvi [options] inputfile[.ly] [....]

OPTIONS

-D,--debug
Set debug mode. There are two levels - in level one some debug info is written, in level two the command set -x is run, which echoes every command in the ly2dvi script.

-F,--headers=
Name of additional LaTeX headers file. This is included in the tex file at the end of the headers, last line before \begin{document}

-H,--Heigth=
Set paper heigth (points). Used together with width and LaTeX name of papersize in case of papersize unknown to ly2dvi.

-F,--headers=
Name of additional LaTeX headers file. This is included in the tex file at the end of the headers, last line before \begin{document}

-K,--keeplilypond
Keep LilyPond output after the run.

-L,--landscape
Set landscape orientation - portrait is the default. (-L produces \usepackage[landscape]{article})

-N,--nonumber
Switch off page numbering.

-O,--orientation=
Set orientation landscape - obsolete, use -L instead.

-W,--Width=
Set paper width (points). Used together with heigth and LaTeX name of papersize in case of papersize unknown to ly2dvi.

-d,--dependencies
Tell lilypond to make dependencies file.

-h,--help
Print help.

-k,--keeply2dvi
Keep the LaTeX file after the run.

-l,--language=
Specify LaTeX language. (-l norsk produces \usepackage[norsk]{babel}).

-o,--output=
Set output directory.

-p,--papersize=
Specify papersize. (-p a4 produces \usepackage[a4paper]{article})

-s,--separate
Normally all output files are included into one LaTeX file. With this switch all files are run separately, to produce one DVI file for each.

Features

ly2dvi responds to several parameters specified in the mudela file. They are overridden by corresponding command line options.

language="";
Specify LaTeX language

latexheaders="";
Specify additional LaTeX headers file

orientation="";
Set orientation.

paperlinewidth="";
Specify the width (pt, mm or cm) of the printed lines.

papersize="";
Specify name of papersize.

Environment

LILYINCLUDE
Additional directories for input files.

TMP
Temporary directory name. Default is /tmp

Files

titledefs.tex is inspected for definitions used to extract additional text definitions from the mudela file. In the current version the following are defined:

title
The title of the music. Centered on top of the first page.

subtitle
Subtitle, centered below the title.

composer
Name of the composer, rightflushed below the subtitle.

arranger
Name of the arranger, rightflushed below the composer.

instrument
Name of the instrument, leftflushed at same level as the composer.

/usr/local/share/lilyrc /etc/lilyrc $HOME/.lilyrc ./.lilyrc are files to set up default running conditions/variables, Bourne shell syntax. All files are parsed, in the shown sequence. The variables are overridden by variables in the mudela file, and by command line options. In the current version the following are allowed:

LANGUAGE=
Specify LaTeX language.

LATEXHF=
Specify additional LaTeX headers file

LILYINCLUDE=
Additional directories for input files.

ORIENTATION=
Set orientation - portrait is the default.

OUTPUTDIR=
Set output directory.

PAPERSIZE=
Specify name of papersize.

PHEIGTH=
Specify paperheight (points - an inch is 72.27, a cm is 28.453 points).

TMP=
Temporary directory name.

PWIDTH=
Specify paperwidth (points - an inch is 72.27, a cm is 28.453 points).

See Also

lilypond(1), tex(1), latex(1)

Bugs

If you have found a bug, you should send a bugreport.

  • Send a copy of the input which causes the error.
  • Send a description of the platform you use.
  • Send a description of the LilyPond and ly2dvi version you use.
  • Send a description of the bug itself.
  • Send it to bug-gnu-music@gnu.org (you don't have to subscribe to this mailinglist).
  • Remarks

    Many papersizes are now supported. Information on other sizes (LaTeX names, horizontal and vertical sizes) should be mailed to the author or to the mailing list.

    Supported papersizes are:

    a0, a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, archA, archB, archC, archD, archE, b0, b1, b2, b3, b4, b5, flsa, flse, halfletter, ledger, legal, letter, note

    AUTHOR

    Jan Arne Fagertun, http://www.termo.unit.no/mtf/people/janaf/


    Please take me back to the index of LilyPond
    This page was built from lilypond-1.0.0 by


    <janneke@gnu.org>