<!-- header_tag -->
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html401/loose.dtd">
<html>
<!-- Copyright C 1999-2009 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".
-->
<!-- Created on December 15, 2009 by texi2html 1.82
texi2html was written by:
Lionel Cons <Lionel.Cons@cern.ch> (original author)
Karl Berry <karl@freefriends.org>
Olaf Bachmann <obachman@mathematik.uni-kl.de>
and many others.
Maintained by: Many creative people.
Send bugs and suggestions to <texi2html-bug@nongnu.org>
-->
<head>
<title>GNU LilyPond program usage: 4.1 An example of a musicological document</title>
<meta name="description" content="GNU LilyPond program usage: 4.1 An example of a musicological document">
<meta name="keywords" content="GNU LilyPond program usage: 4.1 An example of a musicological document">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="texi2html 1.82">
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<link href="index.ja.html#Top" rel="start" title="GNU LilyPond — Application Usage">
<link href="LilyPond-index.ja.html#LilyPond-index" rel="index" title="B. LilyPond index">
<link href="index_toc.ja.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="index_abt.ja.html#SEC_About" rel="help" title="About This Document">
<link href="LilyPond_002dbook.ja.html#LilyPond_002dbook" rel="up" title="4. lilypond-book: Integrating text and music">
<link href="LilyPond-index.ja.html#LilyPond-index" rel="next" title="B. LilyPond index">
<link href="LilyPond_002dbook.ja.html#LilyPond_002dbook" rel="previous" title="4. lilypond-book: Integrating text and music">
<link rel="stylesheet" type="text/css" title="Patrick McCarty's design" href="lilypond-mccarty.css">
<link rel="alternate stylesheet" type="text/css" href="lilypond.css" title="Andrew Hawryluk's design">
<link rel="alternate stylesheet" type="text/css" href="lilypond-blue.css" title="Kurt Kroon's blue design">
<!--[if lte IE 7]>
<link href="lilypond-ie-fixes.css" rel="stylesheet" type="text/css">
<![endif]-->
</head>
<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
<div id="main">
<a name="An-example-of-a-musicological-document"></a>
<table class="nav_table">
<tr><td valign="middle" align="left" colspan="1">[<a href="LilyPond_002dbook.ja.html#LilyPond_002dbook" title="Beginning of this chapter or previous chapter"> << LilyPond-book </a>]</td><td valign="middle" align="center" colspan="3">[<a href="index.ja.html#Top" title="Cover (top) of document" rel="start">Top</a>][<a href="index_toc.ja.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="LilyPond-index.ja.html#LilyPond-index" title="Index" rel="index">Index</a>][<a href="index_abt.ja.html#SEC_About" title="About (help)" rel="help"> ? </a>]</td><td valign="middle" align="right" colspan="1">[<a href="Converting-from-other-formats.ja.html#Converting-from-other-formats" title="Next chapter"> Converting from other formats >> </a>]</td></tr><tr><td valign="middle" align="left" colspan="2">[<a href="LilyPond_002dbook.ja.html#LilyPond_002dbook" title="Previous section in reading order" accesskey="p" rel="previous"> < LilyPond-book </a>]</td><td valign="middle" align="center" colspan="1">[<a href="LilyPond_002dbook.ja.html#LilyPond_002dbook" title="Up section" accesskey="u" rel="up"> Up : LilyPond-book </a>]</td><td valign="middle" align="right" colspan="2">[<a href="Integrating-music-and-text.ja.html#Integrating-music-and-text" title="Next section in reading order" accesskey="n" rel="next"> Integrating music and text > </a>]</td></tr></table>
<a name="An-example-of-a-musicological-document"></a>
<h2 class="section">4.1 An example of a musicological document</h2>
<a name="index-musicology"></a>
<p>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>
<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.
</p>
<a name="Input"></a>
<h3 class="subheading">Input</h3>
<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>
<a name="Processing"></a>
<h3 class="subheading">Processing</h3>
<p>Save the code above to a file called ‘<tt>lilybook.lytex</tt>’, then in a
terminal run
</p>
<blockquote><pre class="example">lilypond-book --output=out --pdf lilybook.lytex
<em>lilypond-book (GNU LilyPond) 2.12.3 </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 <code>xpdf</code> by your favorite PDF viewer)</em>
</pre></blockquote>
<p>Running <code>lilypond-book</code> and <code>latex</code> creates a lot of
temporary files, which would clutter up the working directory. To
remedy this, use the <code>--output=<var>dir</var></code> option. It will create
the files in a separate subdirectory ‘<tt>dir</tt>’.
</p>
<p>Finally the result of the LaTeX example shown above.<sup><a name="DOCF3" href="#FOOT3">1</a></sup> This finishes the tutorial section.
</p>
<a name="Output"></a>
<h3 class="subheading">Output</h3>
<p>Documents for <code>lilypond-book</code> may freely mix music and text.
For example,
</p>
<p>
<a href="../33/lily-4d2f8df5.ly">
<img align="middle"
border="0"
src="../33/lily-4d2f8df5.png"
alt="[image of music]">
</a>
</p>
<p>Options are put in brackets.
</p>
<blockquote><pre class="verbatim">c'4 f16
</pre><p>
<a href="../7d/lily-7135a16b.ly">
<img align="middle"
border="0"
src="../7d/lily-7135a16b.png"
alt="[image of music]">
</a>
</p>
</blockquote>
<p>Larger examples can be put into a separate file, and introduced with
<code>\lilypondfile</code>.
</p>
<blockquote><p>
<a href="../07/lily-b160e1fa.ly">
<img align="middle"
border="0"
src="../07/lily-b160e1fa.png"
alt="[image of music]">
</a>
</p>
</blockquote>
<div class="footnote">
<hr>
<h3>Footnotes</h3>
<p class="footnote"><small>[<a name="FOOT3" href="#DOCF3">1</a>]</small> This
tutorial is processed with Texinfo, so the example gives slightly
different results in layout.
</p></div>
<hr size="6">
<table class="nav_table">
<tr><td valign="middle" align="left" colspan="1">[<a href="LilyPond_002dbook.ja.html#LilyPond_002dbook" title="Beginning of this chapter or previous chapter"> << LilyPond-book </a>]</td><td valign="middle" align="center" colspan="3">[<a href="index.ja.html#Top" title="Cover (top) of document" rel="start">Top</a>][<a href="index_toc.ja.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="LilyPond-index.ja.html#LilyPond-index" title="Index" rel="index">Index</a>][<a href="index_abt.ja.html#SEC_About" title="About (help)" rel="help"> ? </a>]</td><td valign="middle" align="right" colspan="1">[<a href="Converting-from-other-formats.ja.html#Converting-from-other-formats" title="Next chapter"> Converting from other formats >> </a>]</td></tr><tr><td valign="middle" align="left" colspan="2">[<a href="LilyPond_002dbook.ja.html#LilyPond_002dbook" title="Previous section in reading order" accesskey="p" rel="previous"> < LilyPond-book </a>]</td><td valign="middle" align="center" colspan="1">[<a href="LilyPond_002dbook.ja.html#LilyPond_002dbook" title="Up section" accesskey="u" rel="up"> Up : LilyPond-book </a>]</td><td valign="middle" align="right" colspan="2">[<a href="Integrating-music-and-text.ja.html#Integrating-music-and-text" title="Next section in reading order" accesskey="n" rel="next"> Integrating music and text > </a>]</td></tr></table>
<!-- footer_tag -->
<div class="footer">
<p class="footer_version">
This page is for LilyPond-2.12.3 (stable-branch).
</p>
<p class="footer_report">
Your <a href="http://lilypond.org/web/devel/participating/documentation-adding">suggestions for the documentation</a> are welcome, please report errors to our <a href="http://post.gmane.org/post.php?group=gmane.comp.gnu.lilypond.bugs">bug list</a>.
</p>
</div>
<p id="languages">
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>
<!-- FOOTER -->
<!-- end div#main here -->
</div>
<div id="tocframe">
<p class="toc_uplink"><a href="../index.ja.html"
title="Documentation Index"><< Back to Documentation Index</a></p>
<h4 class="toc_header"> <a href="index.ja.html#Top" title="Start of the manual">Application Usage</a></h4>
<div class="contents">
<ul class="toc">
<li><a name="toc-Install-1" href="Install.ja.html#Install">1. Install</a>
<ul class="toc">
<li><a name="toc-Precompiled-binaries-1" href="Precompiled-binaries.ja.html#Precompiled-binaries">1.1 Precompiled binaries</a> </li>
<li><a name="toc-Compiling-from-source-1" href="Compiling-from-source.ja.html#Compiling-from-source">1.2 Compiling from source</a> </li>
</ul>
</li>
<li><a name="toc-Setup-1" href="Setup.ja.html#Setup">2. Setup</a>
<ul class="toc">
<li><a name="toc-Setup-for-specific-Operating-Systems-1" href="Setup-for-specific-Operating-Systems.ja.html#Setup-for-specific-Operating-Systems">2.1 Setup for specific Operating Systems</a> </li>
<li><a name="toc-Text-editor-support-1" href="Text-editor-support.ja.html#Text-editor-support">2.2 Text editor support</a> </li>
<li><a name="toc-Point-and-click-1" href="Point-and-click.ja.html#Point-and-click">2.3 Point and click</a> </li>
</ul>
</li>
<li><a name="toc-Running-LilyPond-1" href="Running-LilyPond.ja.html#Running-LilyPond">3. Running LilyPond</a>
<ul class="toc">
<li><a name="toc-Normal-usage-1" href="Normal-usage.ja.html#Normal-usage">3.1 Normal usage</a> </li>
<li><a name="toc-Command_002dline-usage-1" href="Command_002dline-usage.ja.html#Command_002dline-usage">3.2 Command-line usage</a> </li>
<li><a name="toc-Error-messages-1" href="Error-messages.ja.html#Error-messages">3.3 Error messages</a> </li>
<li><a name="toc-Updating-files-with-convert_002dly-1" href="Updating-files-with-convert_002dly.ja.html#Updating-files-with-convert_002dly">3.4 Updating files with <code>convert-ly</code></a> </li>
<li><a name="toc-Reporting-bugs-1" href="Reporting-bugs.ja.html#Reporting-bugs">3.5 Reporting bugs</a> </li>
</ul>
</li>
<li class="toc_current"><a name="toc-lilypond_002dbook_003a-Integrating-text-and-music" href="LilyPond_002dbook.ja.html#LilyPond_002dbook">4. <code>lilypond-book</code>: Integrating text and music</a>
<ul class="toc">
<li class="toc_current"><a name="toc-An-example-of-a-musicological-document-1" href="An-example-of-a-musicological-document.ja.html#An-example-of-a-musicological-document">4.1 An example of a musicological document</a> </li>
<li><a name="toc-Integrating-music-and-text-1" href="Integrating-music-and-text.ja.html#Integrating-music-and-text">4.2 Integrating music and text</a> </li>
<li><a name="toc-Music-fragment-options-1" href="Music-fragment-options.ja.html#Music-fragment-options">4.3 Music fragment options</a> </li>
<li><a name="toc-Invoking-lilypond_002dbook-1" href="Invoking-lilypond_002dbook.ja.html#Invoking-lilypond_002dbook">4.4 Invoking <code>lilypond-book</code></a> </li>
<li><a name="toc-Filename-extensions-1" href="Filename-extensions.ja.html#Filename-extensions">4.5 Filename extensions</a> </li>
<li><a name="toc-Alternative-methods-of-mixing-text-and-music" href="Alternate-methods-of-mixing-text-and-music.ja.html#Alternate-methods-of-mixing-text-and-music">4.6 Alternative methods of mixing text and music</a> </li>
</ul>
</li>
<li><a name="toc-Converting-from-other-formats-1" href="Converting-from-other-formats.ja.html#Converting-from-other-formats">5. Converting from other formats</a>
<ul class="toc">
<li><a name="toc-Invoking-midi2ly-1" href="Invoking-midi2ly.ja.html#Invoking-midi2ly">5.1 Invoking <code>midi2ly</code></a> </li>
<li><a name="toc-Invoking-musicxml2ly-1" href="Invoking-musicxml2ly.ja.html#Invoking-musicxml2ly">5.2 Invoking <code>musicxml2ly</code></a> </li>
<li><a name="toc-Invoking-abc2ly-1" href="Invoking-abc2ly.ja.html#Invoking-abc2ly">5.3 Invoking <code>abc2ly</code></a> </li>
<li><a name="toc-Invoking-etf2ly-1" href="Invoking-etf2ly.ja.html#Invoking-etf2ly">5.4 Invoking <code>etf2ly</code></a> </li>
<li><a name="toc-Generating-LilyPond-files-1" href="Generating-LilyPond-files.ja.html#Generating-LilyPond-files">5.5 Generating LilyPond files</a> </li>
</ul>
</li>
<li><a name="toc-GNU-Free-Documentation-License-1" href="GNU-Free-Documentation-License.ja.html#GNU-Free-Documentation-License">A. GNU Free Documentation License</a> </li>
<li><a name="toc-LilyPond-index-1" href="LilyPond-index.ja.html#LilyPond-index">B. LilyPond index</a> </li>
</ul>
</div>
</div>
</body>
</html>
