<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!-- header_tag -->
<html lang="en">
<head>
<title>LilyPond-book - 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="prev" href="Running-LilyPond.html#Running-LilyPond" title="Running LilyPond">
<link rel="next" href="Converting-from-other-formats.html#Converting-from-other-formats" title="Converting from other formats">
<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="LilyPond-book"></a>
<a name="LilyPond_002dbook"></a>
Next: <a rel="next" accesskey="n" href="Converting-from-other-formats.html#Converting-from-other-formats">Converting from other formats</a>,
Previous: <a rel="previous" accesskey="p" href="Running-LilyPond.html#Running-LilyPond">Running LilyPond</a>,
Up: <a rel="up" accesskey="u" href="index.html#Top">Top</a>
<hr>
</div>
<h2 class="chapter">4 <samp><span class="command">lilypond-book</span></samp>: Integrating text and music</h2>
<p>If you want to add pictures of music to a document, you can simply do it
the way you would do with other types of pictures. The pictures are
created separately, yielding PostScript output or PNG images, and those
are included into a LaTeX or HTML document.
<p><samp><span class="command">lilypond-book</span></samp> provides a way to automate this process: This
program extracts snippets of music from your document, runs
<samp><span class="command">lilypond</span></samp> on them, and outputs the document with pictures
substituted for the music. The line width and font size definitions for
the music are adjusted to match the layout of your document.
<p>This is a separate program from <samp><span class="command">lilypond</span></samp> itself, and is run on
the command-line; for more information, see <a href="Command_002dline-usage.html#Command_002dline-usage">Command-line usage</a>.
<p>This procedure may be applied to LaTeX, HTML, Texinfo or DocBook documents.
<p><a name="index-texinfo-39"></a><a name="index-latex-40"></a><a name="index-texinfo-41"></a><a name="index-texi-42"></a><a name="index-html-43"></a><a name="index-docbook-44"></a><a name="index-documents_002c-adding-music-to-45"></a><a name="index-HTML_002c-music-in-46"></a><a name="index-Texinfo_002c-music-in-47"></a><a name="index-DocBook_002c-music-in-48"></a><a name="index-g_t_0040LaTeX_007b_007d_002c-music-in-49"></a>
<ul class="menu">
<li><a accesskey="1" href="An-example-of-a-musicological-document.html#An-example-of-a-musicological-document">An example of a musicological document</a>
<li><a accesskey="2" href="Integrating-music-and-text.html#Integrating-music-and-text">Integrating music and text</a>
<li><a accesskey="3" href="Music-fragment-options.html#Music-fragment-options">Music fragment options</a>
<li><a accesskey="4" href="Invoking-lilypond_002dbook.html#Invoking-lilypond_002dbook">Invoking lilypond-book</a>
<li><a accesskey="5" href="Filename-extensions.html#Filename-extensions">Filename extensions</a>
<li><a accesskey="6" href="Alternate-methods-of-mixing-text-and-music.html#Alternate-methods-of-mixing-text-and-music">Alternate methods of mixing text and music</a>
</ul>
<!-- footer_tag --><br><hr>
<div class="node">
<p>
<a name="LilyPond_002dbook"></a>
Next: <a rel="next" accesskey="n" href="Converting-from-other-formats.html#Converting-from-other-formats">Converting from other formats</a>,
Previous: <a rel="previous" accesskey="p" href="Running-LilyPond.html#Running-LilyPond">Running LilyPond</a>,
Up: <a rel="up" accesskey="u" href="index.html#Top">Top</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="LilyPond_002dbook.es.html">español</a>, <a href="LilyPond_002dbook.de.html">deutsch</a>.
<BR>
</P>
</BODY></html>
