]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/tex/mudela-book-doc.doc
release: 1.1.43
[lilypond.git] / Documentation / tex / mudela-book-doc.doc
index 22f9d8f3b69014953e571d29ad23bda8d6ee06c3..b905979a1b98f331d37f458a0d5c9bf51f6789d2 100644 (file)
@@ -7,7 +7,7 @@
 \usepackage[rflt]{floatflt}
 %\usepackage{showframe}
 %\sloppy
-\def\postMudelaExample{\setlength{\parindent}{1em}}
+\def\postMudelaExample{\setlength{\parindent}{3.25ex}}
 \title{Mudela-book tutorial}
 \begin{document}
 \maketitle
@@ -88,12 +88,12 @@ will set the \verb|linewidth| variable to -1, so Lilypond
 will make the music as short as possible but without breaking the
 line. Here is a well know harmonic progression:
 \begin{mudela}[veryverbatim, intertext="produce a well known harmonic progression:"]
-\context Voice {  <c' e' g'> <b d' g'> <c'2 e' g'>}
+  <c' e g> <b d g> <c2 e g>
 \end{mudela}
 
 If you want to place music examples in the text,
 \begin{mudela}[eps]
-\context Voice {  <c' e' g'> <b d' g'> <c'2 e' g'>}
+  <c' e g> <b d g> <c2 e g>
 \end{mudela}
 , you can use the \verb|eps| option. This will create the music as
 eps graphics and include it into the document with the 
@@ -102,7 +102,7 @@ eps graphics and include it into the document with the
 The code used look like this:
 \begin{verbatim}
 \begin{mudela}[eps]
-\context Voice {  <c' e' g'> <b d' g'> <c'2 e' g'>}
+  <c' e g> <b d g> <c2 e g>
 \end{mudela}
 \end{verbatim}
 
@@ -129,18 +129,18 @@ be no empty lines between the normal text and the mudela
 environment. 
 
 You can also use \verb|mudelafile| (on a separate line, FIXME), to
-include another file.
+include another file. Files with name ending with \verb|.sly|
 
 \mudelafile{testje.fly}
 
 \section{Fontsize options}
 You can use all lilypond fontsizes in mudela-book. 
 % LONG line just to test multiple \mudela on one line
-The default 16pt fontsize, \mudela{<c' e' g'>}, is probably to big to be included in the middle of the text. 11pt, \mudela[11pt]{<c' e' g'>} or 13pt, \mudela[13pt]{<c' e' g'>} is probably better.
+The default 16pt fontsize, \mudela{<c' e g>}, is probably to big to be included in the middle of the text. 11pt, \mudela[11pt]{<c' e g>} or 13pt, \mudela[13pt]{<c' e g>} is probably better.
 The code can look like this:
 \begin{verbatim}
 \begin{mudela}[13pt, eps]
-<c' e' g'>
+<c' e g>
 \end{mudela}
 \end{verbatim}
 
@@ -185,8 +185,8 @@ The following options set the fontsize:
 
 \section{User defined commands}
 There is an even shorter way to write small musical fragments. This
-triad, \mudela{<c' e' g'>}, was created with this code:
-\verb|\mudela{<c' e' g'>}|
+triad, \mudela{<c' e g>}, was created with this code:
+\verb|\mudela{<c' e g>}|
 
 Mudela-book defines the \verb|\mudela| command, and let you define
 your own commands in a file specified by 
@@ -224,9 +224,17 @@ send fontsize options to the defined commands.
 }
 \end{mudela}
 
+\section{More options}
+\begin{itemize}
+\item The \verb|singleline| option set \verb|linewidth| to -1.0.
+\item The \verb|multiline| option set \verb|linewidth| to a value letting
+the music be aligned to the right margin. The music can span several
+lines. 
+\end{itemize}
+
 \section{Just in case...}
 The options \verb|fragment| and \verb|nonfragment| will override
-mudela-book when it scans the mudela code to see if it is staff
+mudela-book when it scans the mudela code to see if it is voice
 contents or complete code. This might be useful if mudela-book choose
 wrong. 
 
@@ -238,7 +246,8 @@ if you need this one of these options.
 This was all options to \verb|\begin{mudela}|. The rest of the
 document will show some ways you can use mudela in
 \LaTeX~documents. It will also act as a simple test-suite for
-mudela-book. You \marginpar{
+mudela-book. You 
+\marginpar{
 marginpar!
 \begin{mudela}[eps, 11pt]
  \relative c'' {\key c \minor; r4 [g8 g g] es2}
@@ -300,23 +309,23 @@ names of some triads:
 \hline
 
 dur &
-\begin{mudela}[eps]
-\context Voice {<c' e' g'>}
+\begin{mudela}[eps, fragment]
+<c' e g>
 \end{mudela} 
 \\
 \hline moll &
 \begin{mudela}[eps]
-\context Voice {<c' ees' g'>}
+<c' es g>
 \end{mudela}
 \\
 \hline forminsket &
 \begin{mudela}[eps]
-\context Voice {<c' es' ges'>}
+<c' es ges>
 \end{mudela}
 \\
 \hline forstørret &
 \begin{mudela}[eps]
-\context Voice {<c' e' gis'>}
+<c' e gis>
 \end{mudela}
 \\
 \hline 
@@ -330,7 +339,7 @@ into the preamble of your document. Then the line spacing will not be
 increased between the lines where you have music printed with the
 smallest font size.
 
-Since the version number is  low, you should be careful not to
+Since the version number is quite low, you should be careful not to
 mix braces that belongs to mudela-book and \LaTeX~on the same
 line. The following code will probably break:
 
@@ -353,6 +362,10 @@ a feature of \LaTeX. (But you usually put things inside a verbatim
 environment when you don't want \LaTeX~to do any linebreaking)
 
 
+\end{document}
+
+
+
+
 
 
-\end{document}