<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!-- header_tag -->
<html lang="es">
<head>
<title>DocBook - 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="Integrating-music-and-text.es.html#Integrating-music-and-text" title="Integrar música y texto">
<link rel="prev" href="HTML.es.html#HTML" title="HTML">
<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="DocBook"></a>
Anterior: <a rel="previous" accesskey="p" href="HTML.es.html#HTML">HTML</a>,
Arriba: <a rel="up" accesskey="u" href="Integrating-music-and-text.es.html#Integrating-music-and-text">Integrar música y texto</a>
<hr>
</div>
<h4 class="subsection">4.2.4 DocBook</h4>
<p>Para insertad fragmentos de LilyPond es bueno tratar de mantener la
conformidad del documento de DocBook, permitiendo así el uso de
editores de DocBook, validación, etc. Así pues, no usamos etiquetas
personalizadas, sólo especificamos una convención basada en los
elementos estándar de DocBook.
<h4 class="subheading">Convenciones usuales</h4>
<p>Para insertar toda clase de fragmentos utilizamos los elementos
<code>mediaobject</code> y <code>inlinemediaobject</code>, de forma que nuestros
fragmentos puedan ser formateados en línea o no en línea. Las
opciones de formateo del fragmento se escriben siempre dentro de la
propiedad <code>role</code> del elemento más interno (véanse las secciones
siguientes). Las etiquetas se eligen de forma que permitan a los
editores de DocBook formatear el contenido satisfactoriamente. Los
archivos de DocBook que se van a procesar con <samp><span class="command">lilypond-book</span></samp>
deben tener la extensión <samp><span class="file">.lyxml</span></samp>.
<h4 class="subheading">Incluir un archivo de LilyPond</h4>
<p>Este es el caso más sencillo. Debemos usar la extensión <samp><span class="file">.ly</span></samp>
para el archivo incluido, e insertarlo como un <code>imageobject</code>
estándar, con la estructura siguiente:
<pre class="example"><mediaobject>
<imageobject>
<imagedata fileref="music1.ly" role="printfilename" />
</imageobject>
</mediaobject>
</pre>
<p>Observe que puede usar mediaobject o inlinemediaobject como el
elemento más externo, a elección suya.
<h4 class="subheading">Incluir código de LilyPond</h4>
<p>Se puede incluir código de LilyPond mediante la utilización de un
elemento <code>programlisting</code>, en que el lenguaje se establece como
<code>lilypond</code> con la estructura siguiente:
<pre class="example"><inlinemediaobject>
<textobject>
<programlisting language="lilypond" role="fragment verbatim staffsize=16 ragged-right relative=2">
\context Staff \with {
\remove Time_signature_engraver
\remove Clef_engraver}
{ c4( fis) }
</programlisting>
</textobject>
</inlinemediaobject>
</pre>
<p>Como puede ver, el elemento más externo es un <code>mediaobject</code> o un
<code>inlinemediaobject</code>, y hay un elemento <code>textobject</code> que
lleva el <code>programlisting</code> en su interior.
<h4 class="subheading">Procesar el documento de DocBook</h4>
<p>Al ejecutar <samp><span class="command">lilypond-book</span></samp> sobre el archivo <samp><span class="file">.lyxml</span></samp> se
creará un documento de DocBook válido que se puede procesar
posteriormente con la extensión <samp><span class="file">.xml</span></samp>. Si usa
<a href="http://dblatex.sourceforge.net">dblatex</a>, creará un
archivo PDF a partir de este documento automáticamente. Para la
generación de HTML (HTML Help, JavaHelp, etc.) puede usar las hojas de
estilo oficiales XSL de DocBook, aunque es posible que tenga que
aplicarles algún tipo de personalización.
<!-- footer_tag --><br><hr>
<div class="node">
<p>
Anterior: <a rel="previous" accesskey="p" href="HTML.es.html#HTML">HTML</a>,
Arriba: <a rel="up" accesskey="u" href="Integrating-music-and-text.es.html#Integrating-music-and-text">Integrar música y texto</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="DocBook.html">English</a>, <a href="DocBook.de.html">deutsch</a>.
<BR>
</P>
</BODY></html>
