From: Graham Percival Date: Sat, 26 Sep 2009 12:04:16 +0000 (+0100) Subject: Doc: move lilypond-book templates into Usage. X-Git-Tag: release/2.13.5-0~41 X-Git-Url: https://git.donarmstrong.com/?a=commitdiff_plain;h=704db68adf4e4bdb11d820e3c79f603e3e310324;p=lilypond.git Doc: move lilypond-book templates into Usage. --- diff --git a/Documentation/application/lilypond-book.itely b/Documentation/application/lilypond-book.itely index 19649e2c39..f17c6cd870 100644 --- a/Documentation/application/lilypond-book.itely +++ b/Documentation/application/lilypond-book.itely @@ -50,6 +50,7 @@ documents. * Music fragment options:: * Invoking lilypond-book:: * Filename extensions:: +* lilypond-book templates:: * Alternate methods of mixing text and music:: @end menu @@ -984,6 +985,120 @@ directory, you must use @code{--output} option to make message like @qq{Output would overwrite input file}. +@node lilypond-book templates +@appendixsec lilypond-book templates + +These templates are for use with @code{lilypond-book}. If you're not familiar +with this program, please refer to +@rprogram{lilypond-book}. + +@appendixsubsec LaTeX + +You can include LilyPond fragments in a LaTeX document. + +@example +\documentclass[]@{article@} + +\begin@{document@} + +Normal LaTeX text. + +\begin@{lilypond@} +\relative c'' @{ +a4 b c d +@} +\end@{lilypond@} + +More LaTeX text. + +\begin@{lilypond@} +\relative c'' @{ +d4 c b a +@} +\end@{lilypond@} +\end@{document@} +@end example + +@appendixsubsec Texinfo + +You can include LilyPond fragments in Texinfo; in fact, this entire manual +is written in Texinfo. + +@example +\input texinfo +@@node Top + +Texinfo text + +@@lilypond[verbatim,fragment,ragged-right] +a4 b c d +@@end lilypond + +More Texinfo text + +@@lilypond[verbatim,fragment,ragged-right] +d4 c b a +@@end lilypond + +@@bye +@end example + + +@appendixsubsec xelatex + +@verbatim +\documentclass{article} +\usepackage{ifxetex} +\ifxetex +%xetex specific stuff +\usepackage{xunicode,fontspec,xltxtra} +\setmainfont[Numbers=OldStyle]{Times New Roman} +\setsansfont{Arial} +\else +%This can be empty if you are not going to use pdftex +\usepackage[T1]{fontenc} +\usepackage[utf8]{inputenc} +\usepackage{mathptmx}%Times +\usepackage{helvet}%Helvetica +\fi +%Here you can insert all packages that pdftex also understands +\usepackage[ngerman,finnish,english]{babel} +\usepackage{graphicx} + +\begin{document} +\title{A short document with LilyPond and xelatex} +\maketitle + +Normal \textbf{font} commands inside the \emph{text} work, +because they \textsf{are supported by \LaTeX{} and XeteX.} +If you want to use specific commands like \verb+\XeTeX+, you +should include them again in a \verb+\ifxetex+ environment. +You can use this to print the \ifxetex \XeTeX{} command \else +XeTeX command \fi which is not known to normal \LaTeX . + +In normal text you can easily use LilyPond commands, like this: + +\begin{lilypond} +{a2 b c'8 c' c' c'} +\end{lilypond} + +\noindent +and so on. + +The fonts of snippets set with LilyPond will have to be set from +inside +of the snippet. For this you should read the AU on how to use +lilypond-book. + +\selectlanguage{ngerman} +Auch Umlaute funktionieren ohne die \LaTeX -Befehle, wie auch alle +anderen +seltsamen Zeichen: __ ______, wenn sie von der Schriftart +unterst__tzt werden. +\end{document} +@end verbatim + + @node Alternate methods of mixing text and music @section Alternative methods of mixing text and music diff --git a/Documentation/learning/templates.itely b/Documentation/learning/templates.itely index c0dcae46aa..16022f4bc9 100644 --- a/Documentation/learning/templates.itely +++ b/Documentation/learning/templates.itely @@ -25,7 +25,6 @@ beautiful printed scores! * Orchestral templates:: * Ancient notation templates:: * Jazz combo:: -* lilypond-book templates:: @end menu @@ -210,117 +209,4 @@ violin concerto as TchaikovskyPI, whereas perhaps you wish to print @end ignore -@node lilypond-book templates -@appendixsec lilypond-book templates - -These templates are for use with @code{lilypond-book}. If you're not familiar -with this program, please refer to -@rprogram{lilypond-book}. - -@appendixsubsec LaTeX - -You can include LilyPond fragments in a LaTeX document. - -@example -\documentclass[]@{article@} - -\begin@{document@} - -Normal LaTeX text. - -\begin@{lilypond@} -\relative c'' @{ -a4 b c d -@} -\end@{lilypond@} - -More LaTeX text. - -\begin@{lilypond@} -\relative c'' @{ -d4 c b a -@} -\end@{lilypond@} -\end@{document@} -@end example - -@appendixsubsec Texinfo - -You can include LilyPond fragments in Texinfo; in fact, this entire manual -is written in Texinfo. - -@example -\input texinfo -@@node Top - -Texinfo text - -@@lilypond[verbatim,fragment,ragged-right] -a4 b c d -@@end lilypond - -More Texinfo text - -@@lilypond[verbatim,fragment,ragged-right] -d4 c b a -@@end lilypond - -@@bye -@end example - - -@appendixsubsec xelatex - -@verbatim -\documentclass{article} -\usepackage{ifxetex} -\ifxetex -%xetex specific stuff -\usepackage{xunicode,fontspec,xltxtra} -\setmainfont[Numbers=OldStyle]{Times New Roman} -\setsansfont{Arial} -\else -%This can be empty if you are not going to use pdftex -\usepackage[T1]{fontenc} -\usepackage[utf8]{inputenc} -\usepackage{mathptmx}%Times -\usepackage{helvet}%Helvetica -\fi -%Here you can insert all packages that pdftex also understands -\usepackage[ngerman,finnish,english]{babel} -\usepackage{graphicx} - -\begin{document} -\title{A short document with LilyPond and xelatex} -\maketitle - -Normal \textbf{font} commands inside the \emph{text} work, -because they \textsf{are supported by \LaTeX{} and XeteX.} -If you want to use specific commands like \verb+\XeTeX+, you -should include them again in a \verb+\ifxetex+ environment. -You can use this to print the \ifxetex \XeTeX{} command \else -XeTeX command \fi which is not known to normal \LaTeX . - -In normal text you can easily use LilyPond commands, like this: - -\begin{lilypond} -{a2 b c'8 c' c' c'} -\end{lilypond} - -\noindent -and so on. - -The fonts of snippets set with LilyPond will have to be set from -inside -of the snippet. For this you should read the AU on how to use -lilypond-book. - -\selectlanguage{ngerman} -Auch Umlaute funktionieren ohne die \LaTeX -Befehle, wie auch alle -anderen -seltsamen Zeichen: __ ______, wenn sie von der Schriftart -unterst__tzt werden. -\end{document} -@end verbatim -