<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!-- header_tag -->
<html lang="es">
<head>
<title>Opciones de fragmentos de música - 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.es.html#Top">
<link rel="up" href="LilyPond_002dbook.es.html#LilyPond_002dbook" title="LilyPond-book">
<link rel="prev" href="Integrating-music-and-text.es.html#Integrating-music-and-text" title="Integrar música y texto">
<link rel="next" href="Invoking-lilypond_002dbook.es.html#Invoking-lilypond_002dbook" title="Invocar lilypond-book">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
<!--
Copyright (C) 1999--2007 por los autores
_The translation of the following copyright notice is provided
for courtesy to non-English speakers, but only the notice in English
legally counts._
_La traducción de la siguiente nota de copyright se ofrece como
cortesía para las personas de habla no inglesa, pero únicamente la
nota en inglés tiene validez legal._
Se otorga permiso para copiar, distribuir y/o modificar este
documento bajo los términos de la Licencia de Documentación
Libre de GNU, versión 1.1 o cualquier versión posterior
publicada por la Free Software Foundation; sin ninguna de las
secciones invariantes. Se incluye una copia de esta licencia
dentro de la sección titulada ``Licencia de Documentación Libre
de GNU''.
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="Music-fragment-options"></a>
Siguiente: <a rel="next" accesskey="n" href="Invoking-lilypond_002dbook.es.html#Invoking-lilypond_002dbook">Invocar lilypond-book</a>,
Anterior: <a rel="previous" accesskey="p" href="Integrating-music-and-text.es.html#Integrating-music-and-text">Integrar música y texto</a>,
Arriba: <a rel="up" accesskey="u" href="LilyPond_002dbook.es.html#LilyPond_002dbook">LilyPond-book</a>
<hr>
</div>
<h3 class="section">4.3 Opciones de fragmentos de música</h3>
<p>Durante los próximos párrafos, una ‘instrucción de LilyPond’ se
refiere a cualquier instrucción descrita en las secciones anteriores
que se maneja por parte de <samp><span class="command">lilypond-book</span></samp> para que produzca
un fragmento de música. Por simplicidad, las instrucciones de
LilyPond solamente se muestran en la sintaxis de LaTeX.
<p>Observe que la cadena de opciones se analiza de izquierda a derecha;
si una opción aparece varias veces, se toma la última solamente.
<p>Están disponibles las siguientes opciones para las instrucciones de
LilyPond:
<dl>
<dt><code>staffsize=</code><var>altura</var><dd>Establecer la altura del pentagrama como <var>altura</var>, medida en
puntos.
<br><dt><code>ragged-right</code><dd>Producir líneas no justificadas por la derecha y con espaciado
natural, es decir, se añade <code>ragged-right = ##t</code> al fragmento de
LilyPond. Esta es la opción predeterminada para la instrucción
<code>\lilypond{}</code> si no está presente la opción <code>line-width</code>.
También es la opción predeterminada para el entorno <code>lilypond</code> si
está establecida la opción <code>fragment</code>, y no se especifica la
anchura de la línea explícitamente.
<!-- does this option still exist in lilypond? -jm -->
<br><dt><code>packed</code><dd>Producir líneas con el espaciado empaquetado, es decir, se añade
<code>packed = ##t</code> al fragmento de código de LilyPond.
<br><dt><code>line-width</code><dt><code>line-width=</code><var>tamaño</var><code>\</code><var>unidades</var><dd>Establecer el ancho de línea como <var>tamaño</var>, utilizando
<var>unidades</var> como unidad. <var>unidades</var> es una de las siguientes
cadenas: <code>cm</code>, <code>mm</code>, <code>in</code> o <code>pt</code>. Esta opción
afecta a la salida de LilyPond (esto es, a la longitud del pentagrama
del fragmento musical), no al formato del texto.
<p>Si se usa sin ningún argumento, se establece el ancho de la línea a un
valor predeterminado (calculado con un algoritmo heurístico).
<p>Si no se da ninguna opción <code>line-width</code>, <samp><span class="command">lilypond-book</span></samp>
trata de adivinar un valor predeterminado para los entornos
<code>lilypond</code> que no usan la opción <code>ragged-right</code>.
<br><dt><code>notime</code><dd>No imprimir la indicación de compás, y desactivar las indicaciones
temporales de la música (armadura y líneas divisorias).
<br><dt><code>fragment</code><dd>Hacer que <samp><span class="command">lilypond-book</span></samp> añada algunos códigos necesarios
para que podamos escribir simplemente, por ejemplo,
<pre class="example"> c'4
</pre>
<p class="noindent">sin <code>\layout</code>, <code>\score</code>, etc.
<br><dt><code>nofragment</code><dd>No añadir escribir el código adicional que completa la sintaxis de
LilyPond en los fragmentos de música. Al ser la opción
predeterminada, <code>nofragment</code> normalmente es redundante.
<br><dt><code>indent=</code><var>tamaño</var><code>\</code><var>unidades</var><dd>Establecer el sangrado del primer sistema de pentagramas como
<var>tamaño</var>, utilizando <var>unidades</var> como unidad. <var>unidades</var> es
una de las siguientes cadenas: <code>cm</code>, <code>mm</code>, <code>in</code> o
<code>pt</code>. Esta opción afecta a LilyPond, no al formato del texto.
<br><dt><code>noindent</code><dd>Establecer el sangrado del primer sistema de la música como cero.
Esta opción afecta a LilyPond, no al formato del texto. Puesto que el
valor predeterminado es que no haya ningún sangrado, <code>noindent</code>
normalmente es redundante.
<br><dt><code>quote</code><dd>Reducir la longitud de la línea de un fragmento musical en
2*0.4<span class="dmn">in</span> (pulgadas) y colocar la salida dentro de un
bloque de cita (quotation). El valor de ‘0.4<span class="dmn">in</span>’ se puede
controlar con la opción <code>exampleindent</code>.
<br><dt><code>exampleindent</code><dd>Establecer la longitud del sangrado que la opción <code>quote</code> aplica
al fragmento musical.
<br><dt><code>relative</code><dt><code>relative=</code><var>n</var><dd>Usar el modo de octava relativa. De forma predeterminada, las notas
se especifican con relación al Do central. El argumento entero
opcional especifica la octava de la nota inicial, donde el valor
predeterminado <code>1</code> es el Do central.
</dl>
<p>LilyPond utiliza también <samp><span class="command">lilypond-book</span></samp> para producir su
propia documentación. Para hacerlo, están a nuestra disposición
ciertas opciones algo esotéricas para los fragmentos musicales.
<dl>
<dt><code>verbatim</code><dd>El argumento de una instrucción de LilyPond se copia al archivo de
salida y se incluye dentro de un bloque «verbatim» o preformateado,
seguido del texto que se escriba con la opción <code>intertext</code> (que
no funciona aún); después se imprime la música en sí. Esta opción no
funciona bien con <code>\lilypond{}</code> si forma parte de un párrafo.
<p>Si se usa la opción <code>verbatim</code> dentro de una instrucción
<code>lilypondfile</code>, es posible incluir con estilo preformateado sólo
una parte del archivo fuente. Si el archivo de código fuente contiene
un comentario que contiene ‘<samp><span class="samp">begin verbatim</span></samp>’ (sin las comillas),
la cita del bloque de estilo preformateado empezará después de la
última vez que aparezca este comentario; de forma similar, la cita del
bloque preformateado se detendrá justo antes de la primera vez que
aparezca un comentario que contenga ‘<samp><span class="samp">end verbatim</span></samp>’, si lo hay.
En el siguiente ejemplo de código fuente, la música se interpreta en
el modo relativo, pero la cita preformateada no presentará el bloque
<code>relative</code>, es decir
<pre class="example"> \relative c' { % begin verbatim
c4 e2 g4
f2 e % end verbatim
}
</pre>
<p class="noindent">se imprimirá como un bloque preformateado como
<pre class="example"> c4 e2 g4
f2 e
</pre>
<br><dt><code>addversion</code><dd>(Sólo para la salida de Texinfo.) Anteponer la línea <code>\version
@w{"@version{}"}</code> a la salida de <code>verbatim</code>.
<br><dt><code>texidoc</code><dd>(Sólo para la salida de Texinfo.) Si se llama a <samp><span class="command">lilypond</span></samp>
con la opción <samp><span class="option">--header=texidoc</span></samp>, y el archivo que se procesa
se llama <samp><span class="file">fulanito.ly</span></samp>, crea un archivo
<samp><span class="file">fulanito.texidoc</span></samp> si existe un campo <code>texidoc</code> dentro del
bloque <code>\header</code> de cabecera. La opción <code>texidoc</code> hace que
<samp><span class="command">lilypond-book</span></samp> incluya estos archivos, añadiendo su contenido
como un bloque de documentación inmediatamente antes del fragmento
musical.
<p>Suponiendo que el archivo <samp><span class="file">fulanito.ly</span></samp> contiene
<pre class="example"> \header {
texidoc = "Este archivo es un ejemplo de una sola nota."
}
{ c'4 }
</pre>
<p class="noindent">y que tenemos lo siguiente en nuestro documento de Texinfo
<samp><span class="file">prueba.texinfo</span></samp>
<pre class="example"> @lilypondfile[texidoc]{fulanito.ly}
</pre>
<p class="noindent">la siguiente orden da como salida el resultado esperado:
<pre class="example"> lilypond-book --process="lilypond --format=tex --tex \
--header=texidoc prueba.texinfo
</pre>
<p>La mayoría de los documentos de prueba de LilyPond (en el directorio
<samp><span class="file">input</span></samp> de la distribución) son pequeños archivos <samp><span class="file">.ly</span></samp> que
tienen exactamente este aspecto.
<br><dt><code>lilyquote</code><dd>(Sólo para la salida de Texinfo.) Esta opción es similar a quote,
pero se pone dentro del bloque de cita solamente el fragmento de
música (y el bloque preformateado que se da en la opción
<code>verbatim</code>). Esta opción es útil si queremos citar
(<code>quote</code>) el fragmento musical pero no el bloque de documentación
<code>texidoc</code>.
<br><dt><code>printfilename</code><dd>Si un archivo de entrada de LilyPond se incluye con
<code>\lilypondfile</code>, imprimir el nombre del archivo inmediatamente
antes del fragmento musical. Para la salida HTML, esto es un enlace.
Sólo se imprime el nombre base del archivo, es decir, se elimina la
parte del directorio de la ruta del archivo.
<br><dt><code>fontload</code><dd>Esta opción incluye las fuentes tipográficas en todos los archivos EPS
generados para este fragmento. Se debe usar si el fragmento usa
cualquier tipografía que LaTeX no es capaz de encontrar por sí solo.
</dl>
<!-- footer_tag --><br><hr>
<div class="node">
<p>
Siguiente: <a rel="next" accesskey="n" href="Invoking-lilypond_002dbook.es.html#Invoking-lilypond_002dbook">Invocar lilypond-book</a>,
Anterior: <a rel="previous" accesskey="p" href="Integrating-music-and-text.es.html#Integrating-music-and-text">Integrar música y texto</a>,
Arriba: <a rel="up" accesskey="u" href="LilyPond_002dbook.es.html#LilyPond_002dbook">LilyPond-book</a>
</div>
<div style="background-color: #e8ffe8; padding: 2; border: #c0ffc0 1px solid;">
<p>
<font size="-1">
Esta página corresponde a LilyPond-2.11.57 (rama de desarrollo).
<br>
<address>
Informe de los fallos a través de la lista en español <a href="http://es.groups.yahoo.com/group/lilypond-es/">lilypond-es</a>, o en inglés a través de <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>
Se agradecen las <a href="http://lilypond.org/web/devel/participating/documentation-adding">sugerencias para la documentación</a>.
</font>
</p>
</div>
<P>
Otros idiomas: <a href="Music-fragment-options.html">English</a>.
<BR>
</P>
</BODY></html>
