<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <!-- header_tag --> <html lang="en"> <head> <title>An example of a musicological document - GNU LilyPond program usage</title> <meta http-equiv="Content-Type" content="text/html; charset=utf-8"> <meta name="description" content="GNU LilyPond program usage"> <meta name="generator" content="makeinfo 4.11"> <link title="Top" rel="start" href="index.html#Top"> <link rel="up" href="LilyPond_002dbook.html#LilyPond_002dbook" title="LilyPond-book"> <link rel="next" href="Integrating-music-and-text.html#Integrating-music-and-text" title="Integrating music and text"> <link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage"> <!-- Copyright (C) 1999--2007 by the authors Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.1 or any later version published by the Free Software Foundation; with no Invariant Sections. A copy of the license is included in the section entitled ``GNU Free Documentation License''. --> <meta http-equiv="Content-Style-Type" content="text/css"> <style type="text/css"><!-- pre.display { font-family:inherit } pre.format { font-family:inherit } pre.smalldisplay { font-family:inherit; font-size:smaller } pre.smallformat { font-family:inherit; font-size:smaller } pre.smallexample { font-size:smaller } pre.smalllisp { font-size:smaller } span.sc { font-variant:small-caps } span.roman { font-family:serif; font-weight:normal; } span.sansserif { font-family:sans-serif; font-weight:normal; } hr { border:0; height:1; color: #000000; background-color: #000000; } /* hr { border: none; height: 1px; color: #666666; background-color: #666666; } body { border-left: 1px solid #666666; border-right: 1px solid #666666; color: #332d28; margin-right: auto; margin-left: auto; width: 60em; list-style-type: square; font-family: Arial,Helvetica,sans-serif; padding-right: 1em; padding-left: 1em; } a { border-bottom: 1px dashed #344242; text-decoration: none; color: #344242; } a:link { text-decoration: none; } a:visited { border-bottom: 1px dashed #666666; color: #666666; } a:active { border-bottom: 1px solid #00cccc; color: #00cccc; } a:hover { border-bottom: 1px solid #1d7b85; color: #1d7b85; } blockquote { border: 1px solid #cccccc; padding: 3px; width: 40em; } .node { border-left: 1px solid #666666; margin: -0.5em 0px 1em; padding: 2px 1px 0px; font-style: italic; } .node a { border: none; text-decoration: underline; font-style: normal; font-weight: bold; } .verbatim { font-family: "Courier New",Courier,monospace; } .unnumberedsubsubsec { font-size: large; color: #1d7b85; } .subsubheading { font-size: large; color: #3b220d; } .contents { border: 1px dashed #339999; margin: 3px 2em; list-style-type: square; padding-right: 1em; width: 40em; background-color: #fcfff9; } .contents a { border-bottom: 1px dashed #423d34; text-decoration: none; color: #423d34; } .contents a:visited { border-bottom: 1px dashed #666666; color: #666666; } .contents a:active { border-bottom: 1px solid #f0d86d; color: #f0d86d; } .contents a:hover { border-bottom: 1px solid #3b220d; color: #3b220d; } .menu { border-left: 1px dashed #339999; margin: 3px 2em 1em; list-style-type: square; padding-left: 1.4em; width: 40em; } .unnumbered { } h2 { font-size: x-large; color: #1d7b85; } */ --></style> </head> <BODY BGCOLOR=WHITE TEXT=BLACK> <div class="node"> <p> <a name="An-example-of-a-musicological-document"></a> Next: <a rel="next" accesskey="n" href="Integrating-music-and-text.html#Integrating-music-and-text">Integrating music and text</a>, Up: <a rel="up" accesskey="u" href="LilyPond_002dbook.html#LilyPond_002dbook">LilyPond-book</a> <hr> </div> <h3 class="section">4.1 An example of a musicological document</h3> <p><a name="index-musicology-50"></a>Some texts contain music examples. These texts are musicological treatises, songbooks, or manuals like this. Such texts can be made by hand, simply by importing a PostScript figure into the word processor. However, there is an automated procedure to reduce the amount of work involved in HTML, LaTeX, Texinfo and DocBook documents. <p>A script called <code>lilypond-book</code> will extract the music fragments, format them, and put back the resulting notation. Here we show a small example for use with LaTeX. The example also contains explanatory text, so we will not comment on it further. <h4 class="subheading">Input</h4> <blockquote> <pre class="verbatim"> \documentclass[a4paper]{article} \begin{document} Documents for \verb+lilypond-book+ may freely mix music and text. For example, \begin{lilypond} \relative c' { c2 g'2 \times 2/3 { f8 e d } c'2 g4 } \end{lilypond} Options are put in brackets. \begin[fragment,quote,staffsize=26,verbatim]{lilypond} c'4 f16 \end{lilypond} Larger examples can be put into a separate file, and introduced with \verb+\lilypondfile+. \lilypondfile[quote,noindent]{screech-boink.ly} (If needed, replace screech-boink.ly by any .ly file you put in the same directory as this file.) \end{document} </pre> </blockquote> <h4 class="subheading">Processing</h4> <p>Save the code above to a file called <samp><span class="file">lilybook.lytex</span></samp>, then in a terminal run <!-- keep space after @version{} so TeX doesn't choke --> <pre class="example"> lilypond-book --output=out --pdf lilybook.lytex <em>lilypond-book (GNU LilyPond) 2.11.57 </em> <em>Reading lilybook.lytex...</em> <em>..lots of stuff deleted..</em> <em>Compiling lilybook.tex...</em> cd out pdflatex lilybook <em>..lots of stuff deleted..</em> xpdf lilybook <em>(replace </em><samp><span class="command">xpdf</span></samp><em> by your favorite PDF viewer)</em> </pre> <p>Running <samp><span class="command">lilypond-book</span></samp> and <samp><span class="command">latex</span></samp> creates a lot of temporary files, which would clutter up the working directory. To remedy this, use the <code>--output=</code><var>dir</var> option. It will create the files in a separate subdirectory <samp><span class="file">dir</span></samp>. <p>Finally the result of the LaTeX example shown above.<a rel="footnote" href="#fn-1" name="fnd-1"><sup>1</sup></a> This finishes the tutorial section. <h4 class="subheading">Output</h4> <p>Documents for <samp><span class="command">lilypond-book</span></samp> may freely mix music and text. For example, <p class="noindent"><p> <a href="../3e/lily-9bbaa8c4.ly"> <img align="middle" border="0" src="../3e/lily-9bbaa8c4.png" alt="[image of music]"> </a> </p> <p>Options are put in brackets. <blockquote> <pre class="verbatim"> c'4 f16 </pre> <p> <a href="../d9/lily-9f16f5f9.ly"> <img align="middle" border="0" src="../d9/lily-9f16f5f9.png" alt="[image of music]"> </a> </p> </blockquote> <p>Larger examples can be put into a separate file, and introduced with <code>\lilypondfile</code>. <blockquote> <p> <a href="../34/lily-278653e5.ly"> <img align="middle" border="0" src="../34/lily-278653e5.png" alt="[image of music]"> </a> </p> </blockquote> <div class="footnote"> <hr> <h4>Footnotes</h4><p class="footnote"><small>[<a name="fn-1" href="#fnd-1">1</a>]</small> This tutorial is processed with Texinfo, so the example gives slightly different results in layout.</p> <hr></div> <!-- footer_tag --><div class="node"> <p> Next: <a rel="next" accesskey="n" href="Integrating-music-and-text.html#Integrating-music-and-text">Integrating music and text</a>, Up: <a rel="up" accesskey="u" href="LilyPond_002dbook.html#LilyPond_002dbook">LilyPond-book</a> </div> <div style="background-color: #e8ffe8; padding: 2; border: #c0ffc0 1px solid;"> <p> <font size="-1"> This page is for LilyPond-2.11.57 (development-branch). <br> <address> Report errors to <a href="http://post.gmane.org/post.php?group=gmane.comp.gnu.lilypond.bugs">http://post.gmane.org/post.php?group=gmane.comp.gnu.lilypond.bugs</a>. </address> <br> Your <a href="http://lilypond.org/web/devel/participating/documentation-adding">suggestions for the documentation</a> are welcome. </font> </p> </div> <P> Other languages: <a href="An-example-of-a-musicological-document.es.html">espaƱol</a>, <a href="An-example-of-a-musicological-document.de.html">deutsch</a>. <BR> </P> </BODY></html>