bug-lilypond
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: Issue 1041 in lilypond: Output suffix for score should be documented


From: lilypond
Subject: Re: Issue 1041 in lilypond: Output suffix for score should be documented
Date: Sat, 14 Aug 2010 12:51:11 +0000


Comment #6 on issue 1041 by address@hidden: Output suffix for score should be documented
http://code.google.com/p/lilypond/issues/detail?id=1041


For James Lowe.
Hi James,
I've attached an updated Section 3,1 as an OpenOffice document which I've attached here.
The edited highlights are:
New para at the end of 3.1.1

"Remember that even in a file containing only a \score block, it is implicitly enclosed in a \book block. A \book block in a source file produces at least one output file, and by default the name of the outfile produced is derived from the name of the input file, so fandangoforelephants.ly will produce fandangoforelephants.pdf (or fandangoforelephants.png, depending on the the backend you specify when invoking Lilypond). However, if you wish to use lilypond-book to process your file, you must explicitly code a \book block. (For more details about \book blocks, see the next two sections and File structure.)"

Section 3.1.2 Multiple Scores from a book
Paragraph beginning "However, if you want multiple output files..." moved and extended to new section 3.1.3 Multiple output files from one input file.

Section 3,1,3 Multiple output files from one input file
"If you want multiple output files from the same .ly file, then you can add multiple \book blocks, where each such \book block will result in a separate output. If you do not specify any \book block in the file, LilyPond will implicitly treat the full file as a single \book block, see File structure. When producing multiple files from a single source, Lilypond ensures that none of the output from any \book overwrites the output from a preceding \book from the same file. It does this by adding a suffix to the output name for each \book which uses the default file name derived from the input source file. The default behaviour is to append a version-number suffix for each name which may clash, so"

New example section here
"\book {
  \score { … }
  \layout { … }
  …
}
\book {
  \score { … }
  \layout { … }
  …
}
\book {
  \score { … }
  \layout { … }
  …
} "
"in eightminiatures.ly will produce eightminiatures.pdf, eightminiatures-1.pdf and eightminiatures-2.pdf."

New section
"3.1.4 Output file names
Lilypond provides facilities to allow you control what file names are used by the various back-ends when producing output files. In the previous section, we saw how Lilypond prevents name-clashes when producing several outputs from a single source file. You also have the ability to specify your own suffixes for each \book block, so for example you can produce files called eightminiatures-Romanze.pdf, eightminiatures-Menuetto.pdf and eightminiatures-Nocturne.pdf by adding a \bookOutputSuffix declaration inside each \book block."
New example section
"\book {
  \bookOutputSuffix “Romanze”
  \score { … }
  \layout { … }
  …
}
\book {
  \bookOutputSuffix “Menuetto”
  \score { … }
  \layout { … }
  …
}
\book {
  \bookOutputSuffix “Nocturne”
  \score { … }
  \layout { … }
  …
}"
"You can also specify a different output filename for a \book block, by using \bookOutputName declarations. You could produce files called Romanze.pdf, Menuetto.pdf and Nocturne.pdf like this:"
New example
"\book {
  \bookOutputName “Romanze”
  \score { … }
  \layout { … }
  …
}
\book {
  \bookOutputName “Menuetto”
  \score { … }
  \layout { … }
  …
}
\book {
  \bookOutputName “Nocturne”
  \score { … }
  \layout { … }
  …
}"
3.1.5 File Structure
...

Attachments:
        UpdatedSection3.odt  20.8 KB


reply via email to

[Prev in Thread] Current Thread [Next in Thread]