<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!-- header_tag -->
<html lang="en">
<head>
<title>LaTeX - 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.fr.html#Top">
<link rel="up" href="Integrating-music-and-text.fr.html#Integrating-music-and-text" title="Integrating music and text">
<link rel="next" href="Texinfo.fr.html#Texinfo" title="Texinfo">
<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="LaTeX"></a>
Next: <a rel="next" accesskey="n" href="Texinfo.fr.html#Texinfo">Texinfo</a>,
Up: <a rel="up" accesskey="u" href="Integrating-music-and-text.fr.html#Integrating-music-and-text">Integrating music and text</a>
<hr>
</div>
<h4 class="subsection">4.2.1 LaTeX</h4>
<p>LaTeX is the de-facto standard for publishing layouts in the exact
sciences. It is built on top of the TeX typesetting engine,
providing the best typography available anywhere.
<p>See
<a href="http://www.ctan.org/tex-archive/info/lshort/english/"><em>The Not So Short Introduction to LaTeX</em></a> for an overview on how
to use LaTeX.
<p>Music is entered using
<pre class="example">\begin[options,go,here]{lilypond}
YOUR LILYPOND CODE
\end{lilypond}
</pre>
<p class="noindent">or
<pre class="example">\lilypondfile[options,go,here]{<var>filename</var>}
</pre>
<p class="noindent">or
<pre class="example">\lilypond{ YOUR LILYPOND CODE }
</pre>
<p>Running <samp><span class="command">lilypond-book</span></samp> yields a file that can be further
processed with LaTeX.
<p>We show some examples here. The <code>lilypond</code> environment
<pre class="example">\begin[quote,fragment,staffsize=26]{lilypond}
c' d' e' f' g'2 g'2
\end{lilypond}
</pre>
<p class="noindent">produces
<blockquote>
<p>
<a href="../d3/lily-b1f75a08.ly">
<img align="middle"
border="0" src="../d3/lily-b1f75a08.png" alt="[image of music]">
</a>
</p>
</blockquote>
<p>The short version
<pre class="example">\lilypond[quote,fragment,staffsize=11]{<c' e' g'>}
</pre>
<p class="noindent">produces
<blockquote>
<p>
<a href="../ac/lily-6d07893b.ly">
<img align="middle"
border="0" src="../ac/lily-6d07893b.png" alt="[image of music]">
</a>
</p>
</blockquote>
<p class="noindent">Currently, you cannot include <code>{</code> or <code>}</code> within
<code>\lilypond{}</code>, so this command is only useful with the
<code>fragment</code> option.
<p>The default line width of the music will be adjusted by examining the
commands in the document preamble, the part of the document before
<code>\begin{document}</code>. The <samp><span class="command">lilypond-book</span></samp> command sends
these to LaTeX to find out how wide the text is. The line width for
the music fragments is then adjusted to the text width. Note that this
heuristic algorithm can fail easily; in such cases it is necessary to
use the <code>line-width</code> music fragment option.
<p><a name="index-titling-and-lilypond_002dbook-51"></a><a name="index-g_t_005cheader-in-_0040LaTeX_007b_007d-documents-52"></a>
Each snippet will call the following macros if they have been defined by
the user:
<ul>
<li><code>\preLilyPondExample</code> called before the music,
<li><code>\postLilyPondExample</code> called after the music,
<li><code>\betweenLilyPondSystem[1]</code> is called between systems if
<code>lilypond-book</code> has split the snippet into several PostScript
files. It must be defined as taking one parameter and will be
passed the number of files already included in this snippet.
The default is to simply insert a <code>\linebreak</code>.
</ul>
<p class="noindent">
<h5 class="subsubheading">Selected Snippets</h5>
<p>Sometimes it is useful to display music elements (such as ties and slurs)
as if they continued after the end of the fragment. This can be done by
breaking the staff and suppressing inclusion of the rest of the LilyPond
output.
<p>In LaTeX, define <code>\betweenLilyPondSystem</code> in such a way that
inclusion of other systems is terminated once the required number of
systems are included. Since <code>\betweenLilypondSystem</code> is first
called <em>after</em> the first system, including only the first system
is trivial.
<pre class="example">\def\betweenLilyPondSystem#1{\endinput}
\begin[fragment]{lilypond}
c'1\( e'( c'~ \break c' d) e f\)
\end{lilypond}
</pre>
<p>If a greater number of systems is requested, a TeX conditional must
be used before the <code>\endinput</code>. In this example, replace ‘2’ by
the number of systems you want in the output,
<pre class="example">\def\betweenLilyPondSystem#1{
\ifnum##1<2\else\endinput\fi
}
</pre>
<p>Remember that the definition of <code>\betweenLilyPondSystem</code> is
effective until TeX quits the current group (such as the LaTeX
environment) or is overridden by another definition (which is, in
most cases, for the rest of the document). To reset your
definition, write
<pre class="example">\let\betweenLilyPondSystem\undefined
</pre>
<p class="noindent">in your LaTeX source.
<p>This may be simplified by defining a TeX macro
<pre class="example">\def\onlyFirstNSystems#1{
\def\betweenLilyPondSystem##1{\ifnum##1<#1\else\endinput\fi}
}
</pre>
<p class="noindent">and then saying only how many systems you want before each fragment,
<pre class="example">\onlyFirstNSystems{3}
\begin{lilypond}...\end{lilypond}
\onlyFirstNSystems{1}
\begin{lilypond}...\end{lilypond}
</pre>
<p class="noindent">
<h5 class="subsubheading">See also</h5>
<p class="indent">
There are specific <samp><span class="command">lilypond-book</span></samp> command line options and
other details to know when processing LaTeX documents, see
<a href="Invoking-lilypond_002dbook.fr.html#Invoking-lilypond_002dbook">Invoking lilypond-book</a>.
<!-- footer_tag --><br><hr>
<div class="node">
<p>
Next: <a rel="next" accesskey="n" href="Texinfo.fr.html#Texinfo">Texinfo</a>,
Up: <a rel="up" accesskey="u" href="Integrating-music-and-text.fr.html#Integrating-music-and-text">Integrating music and text</a>
</div>
<div style="background-color: #e8ffe8; padding: 2; border: #c0ffc0 1px solid;">
<p>
<font size="-1">
Cette page documente LilyPond-2.11.57 (branche de développement).
<br>
<address>
Rapportez toute anomalie en français à <a href="mailto:lilypond-user-fr@gnu.org">lilypond-user-fr@gnu.org</a> ou en anglais à <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>
Vos <a href="http://lilypond.org/web/devel/participating/documentation-adding">suggestions à propos de la documentation</a> sont les bienvenues.
</font>
</p>
</div>
<P>
Autres langues : <a href="LaTeX.es.html">español</a>, <a href="LaTeX.de.html">deutsch</a>.
<BR>
</P>
</BODY></html>
