X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Fuser%2Flilypond-book.itely;h=d4e93f9081a9cd170ce7b8d794ade7598d7ef596;hb=9f3572d98bb948c9689cd1f75401a029451fa001;hp=89a7af3af0efb93b3bc72ee3eee764a9f9e06f37;hpb=04265f11d1f21416ccebd2dcaa1d903dc781b36e;p=lilypond.git diff --git a/Documentation/user/lilypond-book.itely b/Documentation/user/lilypond-book.itely index 89a7af3af0..d4e93f9081 100644 --- a/Documentation/user/lilypond-book.itely +++ b/Documentation/user/lilypond-book.itely @@ -38,7 +38,6 @@ This procedure may be applied to La@TeX{}, HTML or Texinfo documents. * Music fragment options:: * Invoking lilypond-book:: * Filename extensions:: -* Inserting LilyPond output into other programs:: @end menu @@ -152,7 +151,7 @@ Larger examples can be put into a separate file, and introduced with @cindex texinfo @cindex latex @cindex texinfo -@funindex texi +@findex texi @cindex html @cindex documents, adding music to @@ -234,7 +233,7 @@ heuristic algorithm can fail easily; in such cases it is necessary to use the @code{line-width} music fragment option. @cindex titling and lilypond-book -@funindex \header in La@TeX{} documents +@findex \header in La@TeX{} documents Each snippet will call the following macros if they have been defined by the user: @@ -304,66 +303,6 @@ be ignored. @cindex international characters @cindex latin1 -Sometimes it is useful to display music elements (such as ties and slurs) -as if they continued after the end of the fragment. This can be done by -breaking the staff and suppressing inclusion of the rest of the lilypond -output. - -In La@TeX{}, define @code{\betweenLilyPondSystem} in such a way that -inclusion of other systems is terminated once the required number of -systems are included. Since @code{\betweenLilypondSystem} is first -called @b{after} the first system, including only the first system -is trivial. - -@example -\def\betweenLilyPondSystem#1@{\endinput@} - -\begin[fragment]@{lilypond@} - c'1\( e'( c'~ \break c' d) e f\) -\end@{lilypond@} -@end example - -If a greater number of systems is requested, a TeX conditional must be -used before the @code{\endinput}. In this example, replace "2" by -the numer of systems you want in the output, - -@example -\def\betweenLilyPondSystem#1@{ - \ifnum##1<2\else\endinput\fi -@} -@end example - -Remember that the definition of @code{\betweenLilyPondSystem} is -effective until @TeX{} quits the current group (such as the La@TeX{} -environment) or is overridden by another definition (which is, in -most cases, for the rest of the document). To reset your -definition, write - -@example -\let\betweenLilyPondSystem\undefined -@end example - -@noindent -in your LaTeX source. - -This may be simplified by defining a @TeX{} macro - -@example -\def\onlyFirstNSystems#1@{ - \def\betweenLilyPondSystem##1@{\ifnum##1<#1\else\endinput\fi@} -@} -@end example - -@noindent -and then saying only how many systems you want before each fragment, - -@example -\onlyFirstNSystems@{3@} -\begin@{lilypond@}...\end@{lilypond@} -\onlyFirstNSystems@{1@} -\begin@{lilypond@}...\end@{lilypond@} -@end example - @node Integrating Texinfo and music @section Integrating Texinfo and music @@ -627,10 +566,12 @@ output format. Both @file{.tex} and @file{.texi} files need further processing. @command{lilypond-book} can also create a PSFONTS file, which is required -by @command{dvips} to produce Postscript and PDF files. +by @command{dvips} to produce Postscript and PDF files. You can call +this file whatever you want as long as you refer to the same file when +you call @command{dvips}. To produce PDF output from the lilypond-book file (here called -@code{yourfile.lytex}) via LaTeX, you should do +@code{yourfile.lytex}), you should do @example lilypond-book --psfonts yourfile.lytex @@ -643,14 +584,6 @@ The @file{.dvi} file created by this process will not contain noteheads. This is normal; if you follow the instructions, they will be included in the @file{.ps} and @file{.pdf} files. -To produce a PDF file through PDF(La)TeX, use - -@example -lilypond-book --pdf yourfile.pdftex -pdflatex yourfile.tex -@end example - - To produce a Texinfo document (in any output format), follow the normal procedures for Texinfo (this is, either call @command{texi2dvi} or @command{makeinfo}, depending on the output format you want to @@ -763,37 +696,3 @@ output format based on the input filename's extension. @item @file{.xml} @tab HTML @end multitable @end quotation - - -@node Inserting LilyPond output into other programs -@section Inserting LilyPond output into other programs - -To insert LilyPond output in other programs, use @code{lilypond} -instead of @code{lilypond-book}. Each example must be created -individually and added to the document; consult the -documentation for that program. Most programs will be able -to insert lilypond output in @file{PNG}, @file{EPS}, or @file{PDF} -formats. - -To reduce the white space around your lilypond score, use -the following options - -@example -\paper@{ - indent=0\mm - line-width=120\mm - oddFooterMarkup=##f - oddHeaderMarkup=##f - bookTitleMarkup = ##f - scoreTitleMarkup = ##f -@} - -@{ c1 @} -@end example - -To produce a useful @file{eps} file, use - -@example -lilypond -b eps -dno-gs-load-fonts -dinclude-eps-fonts myfile.ly -@end example -