3 ly2dvi - convert mudela to DVI
7 ly2dvi [options] inputfile[.ly] [....]
11 ly2dvi is a shell script which creates input file for LaTeX,
12 based on information from the output files from lilypond.
13 The script handles multiple files. If a mudela file name is
14 specified lilypond is run to make an output (TeX) file.
16 One or more LaTeX files are created, based on information found
17 in the output (TeX) files, and latex is finally run to create
18 one or more DVI files.
26 Set debug mode. There are two levels - in level one some debug
27 info is written, in level two the command C<set -x> is run, which
28 echoes every command in the ly2dvi script.
30 =item B<-H,--headers=>
32 Name of additional LaTeX headers file. This is included in the
33 tex file at the end of the headers, last line before \begin{document}
35 =item B<-K,--keeplilypond>
37 Keep LilyPond output after the run.
39 =item B<-L,--landscape>
41 Set landscape orientation - portrait is the default.
42 (C<-L> produces C<\usepackage[landscape]{article}>)
44 =item B<-N,--nonumber>
46 Switch off page numbering.
48 =item B<-O,--orientation=>
50 Set orientation - portrait is the default.
51 (C<-O> landscape produces C<\usepackage[landscape]{article}>)
57 =item B<-k,--keeply2dvi>
59 Keep the LaTeX file after the run.
61 =item B<-l,--language=>
63 Specify LaTeX language.
64 (C<-l norsk> produces C<\usepackage[norsk]{babel}>).
70 =item B<-p,--papersize=>
73 (C<-p a4paper> produces C<\usepackage[a4paper]{article}>)
75 =item B<-s,--separate>
77 Normally all output files are included into one LaTeX file.
78 With this switch all files are run separately, to produce one
85 ly2dvi responds to several parameters specified in the mudela
86 file. They are overridden by corresponding command line options.
92 Specify LaTeX language
94 =item B<latexheaders="";>
96 Specify additional LaTeX headers file
98 =item B<orientation="";>
102 =item B<paperlinewidth="";>
104 Specify the width (pt, mm or cm) of the printed lines.
106 =item B<papersize="";>
118 Additional directories for input files.
122 Temporary directory name. Default is /tmp
128 F<titledefs.tex> is inspected for definitions used to extract
129 additional text definitions from the mudela file. In the current
130 version the following are defined:
136 The title of the music. Centered on top of the first page.
140 Subtitle, centered below the title.
144 Name of the composer, rightflushed below the subtitle.
148 Name of the arranger, rightflushed below the composer.
152 Name of the instrument, leftflushed at same level as the composer.
156 F</usr/local/share/lilyrc /etc/lilyrc $HOME/.lilyrc ./.lilyrc>
157 are files to set up default running conditions/variables, Bourne shell
158 syntax. All files are parsed, in the shown sequence. The variables are
159 overridden by variables in the mudela file, and by command line options.
160 In the current version the following are allowed:
166 Specify LaTeX language.
170 Specify additional LaTeX headers file
172 =item B<LILYINCLUDE=>
174 Additional directories for input files.
176 =item B<ORIENTATION=>
178 Set orientation - portrait is the default.
182 Set output directory.
190 Temporary directory name.
196 lilypond(1), tex(1), latex(1)
200 Jan Arne Fagertun <Jan.A.Fagertun@energy.sintef.no>,
201 http://www.termo.unit.no/mtf/people/janaf/
205 If you have found a bug, you should send a bugreport.
210 Send a copy of the input which causes the error.
213 Send a description of the platform you use.
216 Send a description of the LilyPond and ly2dvi version you use.
219 Send a description of the bug itself.
222 Send it to bug-gnu-music@gnu.org (you don't have to subscribe
223 to this mailinglist).
229 Only one papersize is supported, A4. Information on other sizes
230 (LaTeX names, horizontal and vertical sizes) should be mailed to
231 the author or to the mailing list.