1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
2 @c This file is part of lilypond-program.tely
4 Translation of GIT committish: f24b56a3274da3642348d075502ced7a2a84ecb5
6 When revising a translation, copy the HEAD committish of the
7 version that you are working on. See TRANSLATION for details.
13 @c Note: keep this node named so that `info lilypond-book' brings you here.
15 @chapter @command{lilypond-book}: Integrating text and music
17 Si quiere añadir imágenes de música a un documento, puede hacerlo
18 simplemente de la forma en que lo haría con otros tipos de imágenes.
19 Las imágenes se crean por separado, dando como resultado una salida
20 PostScript o imágenes PNG, y luego se incluyen en un documento de
23 @command{lilypond-book} ofrece una manera de automatizar este proceso:
24 este programa extrae los fragmentos de música del documento, ejecuta
25 @command{lilypond} sobre cada uno de ellos, y devuelve como salida el
26 documento con la música sustituida por las imágenes. Las definiciones
27 de ancho de línea y tamaño de letra de la música se ajustan de forma
28 que coincidan con los ajustes de su documento.
30 Es un programa distinto a @command{lilypond} propiamente dicho, y se
31 ejecuta sobre la línea de órdenes; para ver más información, consulte
32 @ref{Command-line usage}. Si tiene MacOS 10.3 o 10.4 y experimenta
33 algún problema al ajecutar @code{lilypond-book}, consulte @ref{Setup
36 Este procedimiento se puede aplicar a documentos de @LaTeX{}, HTML,
44 @cindex documentos, insertar música en
45 @cindex HTML, música dentro de
46 @cindex Texinfo, música dentro de
47 @cindex DocBook, música dentro de
48 @cindex @LaTeX{}, música dentro de
51 * An example of a musicological document::
52 * Integrating music and text::
53 * Music fragment options::
54 * Invoking lilypond-book::
55 * Filename extensions::
56 * Alternate methods of mixing text and music::
60 @node An example of a musicological document
61 @section An example of a musicological document
64 Ciertos textos contienen ejemplos musicales. Son tratados musicales,
65 cancioneros o manuales como este mismo. Estos textos se pueden hacer
66 a mano, importando simplemente una imagen en formato PostScript en el
67 editor de textos. Sin embargo, hay un procedimiento automático para
68 reducir la carga de trabajo que esto implica los documentos de HTML,
69 @LaTeX{}, Texinfo y DocBook.
71 Un guión ejecutable llamado @code{lilypond-book} extrae los fragmentos
72 de música, les da formato y vuelve a poner en su lugar la partitura
73 resultante. A continuación presentamos un pequeño ejemplo de su
74 utilización con @LaTeX{}. El ejemplo contiene también texto
75 explicativo, por lo que no vamos a comentarlo posteriormente.
81 \documentclass[a4paper]{article}
85 Los documentos para \verb+lilypond-book+ pueden mezclar libremente
86 música y texto. Por ejemplo:
90 c2 g'2 \times 2/3 { f8 e d } c'2 g4
94 Las opciones se escriben entre corchetes.
96 \begin[fragment,quote,staffsize=26,verbatim]{lilypond}
100 Los ejemplos grandes se pueden grabar en archivos separados e
101 introducirse con \verb+\lilypondfile+.
103 \lilypondfile[quote,noindent]{screech-boink.ly}
105 (Si es necesario, sustituya screech-boink.ly por cualquier archivo .ly
106 situado en el mismo directorio que este archivo.)
112 @subheading Processing
114 Guarde el código anterior como un archivo llamado
115 @file{lilybook.lytex}, y luego ejecute en un terminal:
117 @c keep space after @version{} so TeX doesn't choke
119 lilypond-book --output=out --pdf lilybook.lytex
120 @emph{lilypond-book (GNU LilyPond) @version{} }
121 @emph{Leyendo lilybook.lytex...}
122 @emph{..montañas de mensajes suprimidos..}
123 @emph{Compilando lilybook.tex...}
126 @emph{..montañas de mensajes suprimidos..}
128 @emph{(sustituya @command{xpdf} por su visor de PDF favorito)}
131 La ejecución de @command{lilypond-book} y @command{latex} crea un gran
132 número de archivos temporales, que podrían abarrotar el directorio de
133 trabajo. Para poner remedio a esto utilice la opción
134 @code{--output=@var{directorio}}. Creará los archivos en un subdirectorio
135 aparte @file{directorio}.
137 Finalmente el resultado del ejemplo de @LaTeX{} que acabamos de
138 mostrar@footnote{Este tutorial se procesa con Texinfo, por lo que el
139 ejemplo presenta un resultado en la disposición ligeramente
140 distinto.}. Así acaba la sección del tutorial.
146 Los documentos para @command{lilypond-book} pueden mezclar libremente
147 música y texto. Por ejemplo:
151 c2 g'2 \times 2/3 { f8 e d } c'2 g4
155 Las opciones se escriben entre corchetes.
157 @lilypond[fragment,quote,staffsize=26,verbatim]
161 Los ejemplos grandes se pueden grabar en archivos separados e
162 introducirse con @code{\lilypondfile}.
164 @lilypondfile[quote,noindent]{screech-boink.ly}
169 @node Integrating music and text
170 @section Integrating music and text
172 Aquí vamos a explicar cómo integrar LilyPond con algunos otros
185 @LaTeX{} es el estándar de facto para la publicación en el mundo de
186 las ciencias exactas. Está construido encima del motor de composición
187 tipográfica @TeX{}, proporcionando la tipografía de mejor calidad que
191 @uref{http://@/www@/.ctan@/.org/@/tex@/-archive/@/info/@/lshort/@/english/,
192 @emph{The Not So Short Introduction to @LaTeX{}}} (Introducción no tan
193 breve a @LaTeX{}) para ver una panorámica sobre cómo usar @LaTeX{}.
195 La música se introduce usando
198 \begin[las,opciones,van,aquí]@{lilypond@}
199 EL CÓDIGO DE LILYPOND
207 \lilypondfile[las,opciones,van,aquí]@{@var{archivo}@}
214 \lilypond@{ EL CÓDIGO DE LILYPOND @}
217 De forma adicional, @code{\lilypondversion} imprime la versión actual
220 La ejecución de @command{lilypond-book} deja como resultado un archivo
221 que se puede procesar posteriormente con @LaTeX{}.
223 A continuación mostramos algunos ejemplos. El entorno @code{lilypond}
226 \begin[quote,fragment,staffsize=26]@{lilypond@}
234 @lilypond[quote,fragment,staffsize=26]
241 \lilypond[quote,fragment,staffsize=11]@{<c' e' g'>@}
247 @lilypond[quote,fragment,staffsize=11]{<c' e' g'>}
250 Por el momento no es posible incluir llaves @code{@{} o @code{@}}
251 dentro de @code{\lilypond@{@}}, así que esta instrucción solamente es
252 útil con la opción @code{fragment}.
254 El ancho predeterminado de las líneas de música se ajusta mediante el
255 examen de las instrucciones del preámbulo del documento, la parte del
256 documento que está antes de @code{\begin@{document@}}. La instrucción
257 @command{lilypond-book} los envía a @LaTeX{} para averiguar la anchura
258 del texto. El ancho de la línea para los fragmentos de música se
259 ajusta entonces al ancho del texto. Observe que este algoritmo
260 heurístico puede fácilmente fallar; en estos casos es necesario usar
261 la opción @code{line-width} del fragmento de música.
263 @cindex títulos y lilypond-book
264 @cindex \header dentro de documentos @LaTeX{}
266 Cada fragmento ejecutará los macros siguientes si han sido definidos
270 @item @code{\preLilyPondExample} que se llama antes de la música,
272 @item @code{\postLilyPondExample} que se llama después de la música,
274 @item @code{\betweenLilyPondSystem[1]} se llama entre los sistemas si
275 @code{lilypond-book} ha dividido el fragmento en varios archivos
276 PostScript. Se debe definir de forma que tome un parámetro y recibirá
277 el número de archivos ya incluidos dentro del fragmento actual. La
278 acción predeterminada es simplemente insertar un @code{\linebreak}.
284 @cindex Latex, feta symbols
287 To include feta symbols (such as flat, segno, etc) in a LaTeX
288 document, use @code{\input@{titledefs@}}
291 \documentclass[a4paper]@{article@}
302 The font symbol names are defined in the file feta20.tex; to find
303 the location of this file, use the command
313 A veces es útil mostrar elementos de música (como ligaduras) como si
314 continuasen más allá del final del fragmento. Esto se puede hacer
315 dividiendo el pentagrama y suprimiendo la inclusión del resto de la
318 En @LaTeX{}, defina @code{\betweenLilyPondSystem} de tal forma que la
319 la inclusión de otros sistemas se dé por terminada una vez que se ha
320 alcanzado el número deseado de sistemas requeridos. Puesto que
321 @code{\betweenLilypondSystem} se llama en primer lugar @emph{después}
322 del primer sistema, incluir solamente el primer sistema es algo
326 \def\betweenLilyPondSystem#1@{\endinput@}
328 \begin[fragment]@{lilypond@}
329 c'1\( e'( c'~ \break c' d) e f\)
333 Si se necesita un mayor número de sistemas, se tiene que usar un
334 condicional de @TeX{} antes del @code{\endinput}. En este ejemplo,
335 sustituya el @q{2} por el número de sistemas que quiere en la salida:
338 \def\betweenLilyPondSystem#1@{
339 \ifnum##1<2\else\endinput\fi
343 Recuerde que la definición de @code{\betweenLilyPondSystem} es
344 efectiva hasta que @TeX{} abandona el grupo actual (como el entorno
345 @LaTeX{}) o se sobreescribe por otra definición (lo que casi siempre
346 es por el resto del documento). Para reponer la definición, escriba
349 \let\betweenLilyPondSystem\undefined
353 dentro de la fuente de @LaTeX{}.
355 Se puede simplificar esto definiendo un macro de @TeX{}:
358 \def\onlyFirstNSystems#1@{
359 \def\betweenLilyPondSystem##1@{\ifnum##1<#1\else\endinput\fi@}
364 y luego diciendo solamente cuántos sistemas quiere antes de cada
368 \onlyFirstNSystems@{3@}
369 \begin@{lilypond@}...\end@{lilypond@}
370 \onlyFirstNSystems@{1@}
371 \begin@{lilypond@}...\end@{lilypond@}
375 Hay opciones de línea de órdenes específicas de
376 @command{lilypond-book} y otros detalles que conocer para procesar
377 documentos de@LaTeX{} véase @ref{Invoking lilypond-book}.
383 Texinfo es el formato estándar para la documentación del proyecto GNU.
384 Este mismo manual es un ejemplo de documento Texinfo. Las versiones
385 HTML, PDF e Info del manual se hacen a partir del documento Texinfo.
388 En el archivo de entrada, la música se especifica con
391 @@lilypond[las,opciones,van,aquí]
392 EL CÓDIGO DE LILYPOND
400 @@lilypond[las,opciones,van,aquí]@{ EL CÓDIGO DE LILYPOND @}
407 @@lilypondfile[las,opciones,van,aquí]@{@var{archivo}@}
410 De forma adicional, @code{@@lilypondversion} imprime la versión actual
413 Cuando se ejecuta @command{lilypond-book} sobre el archivo, se obtiene
414 como resultado un archivo Texinfo (con la extensión @file{.texi}) que
415 contiene etiquetas @code{@@image} para el HTML, Info y la salida
416 impresa. @command{lilypond-book} genera imágenes de la música en
417 formatos EPS y PDF para usarlos en la salida impresa, y en formato PNG
418 para usarlos en las salidas HTML e Info.
420 Aquí podemos ver dos ejemplos sencillos. Un entorno @code{lilypond}
438 @@lilypond[fragment,staffsize=11]@{<c' e' g'>@}
444 @lilypond[fragment,staffsize=11]{<c' e' g'>}
446 No como @LaTeX{}, @code{@@lilypond@{...@}} no genera una imagen en
447 línea. Siempre consiste en un párrafo para ella sola.
453 La música se introduce usando
456 <lilypond fragment relative=2>
457 \key c \minor c4 es g2
462 @command{lilypond-book} entonces produce un archivo HTML con las
463 etiquetas de imagen adecuadas para los fragmentos de música:
465 @lilypond[fragment,relative=2]
466 \key c \minor c4 es g2
469 Para imágenes en línea, utilice @code{<lilypond ... />}, donde las
470 opciones están separadas de la música por el símbolo de dos puntos,
474 Algo de música dentro de <lilypond relative=2: a b c/> una línea de texto.
477 Para incluir archivos externos, escriba
480 <lilypondfile @var{opción1} @var{opción2} ...>@var{archivo}</lilypondfile>
483 De forma adicional, @code{<lilypondversion/>} imprime la versión
486 @cindex títulos en HTML
487 @cindex vista previa, imagen
493 Para insertad fragmentos de LilyPond es bueno tratar de mantener la
494 conformidad del documento de DocBook, permitiendo así el uso de
495 editores de DocBook, validación, etc. Así pues, no usamos etiquetas
496 personalizadas, sólo especificamos una convención basada en los
497 elementos estándar de DocBook.
499 @subheading Common conventions
501 Para insertar toda clase de fragmentos utilizamos los elementos
502 @code{mediaobject} y @code{inlinemediaobject}, de forma que nuestros
503 fragmentos puedan ser formateados en línea o no en línea. Las
504 opciones de formateo del fragmento se escriben siempre dentro de la
505 propiedad @code{role} del elemento más interno (véanse las secciones
506 siguientes). Las etiquetas se eligen de forma que permitan a los
507 editores de DocBook formatear el contenido satisfactoriamente. Los
508 archivos de DocBook que se van a procesar con @command{lilypond-book}
509 deben tener la extensión @file{.lyxml}.
511 @subheading Including a LilyPond file
513 Este es el caso más sencillo. Debemos usar la extensión @file{.ly}
514 para el archivo incluido, e insertarlo como un @code{imageobject}
515 estándar, con la estructura siguiente:
520 <imagedata fileref="music1.ly" role="printfilename" />
525 Observe que puede usar mediaobject o inlinemediaobject como el
526 elemento más externo, a elección suya.
528 @subheading Including LilyPond code
530 Se puede incluir código de LilyPond mediante la utilización de un
531 elemento @code{programlisting}, en que el lenguaje se establece como
532 @code{lilypond} con la estructura siguiente:
537 <programlisting language="lilypond" role="fragment verbatim staffsize=16 ragged-right relative=2">
538 \context Staff \with @{
539 \remove Time_signature_engraver
540 \remove Clef_engraver@}
547 Como puede ver, el elemento más externo es un @code{mediaobject} o un
548 @code{inlinemediaobject}, y hay un elemento @code{textobject} que
549 lleva el @code{programlisting} en su interior.
551 @subheading Processing the DocBook document
553 Al ejecutar @command{lilypond-book} sobre el archivo @file{.lyxml} se
554 creará un documento de DocBook válido que se puede procesar
555 posteriormente con la extensión @file{.xml}. Si usa
556 @uref{http://@/dblatex@/.sourceforge@/.net@/,dblatex}, creará un
557 archivo PDF a partir de este documento automáticamente. Para la
558 generación de HTML (HTML Help, JavaHelp, etc.) puede usar las hojas de
559 estilo oficiales XSL de DocBook, aunque es posible que tenga que
560 aplicarles algún tipo de personalización.
563 @node Music fragment options
564 @section Music fragment options
566 Durante los próximos párrafos, una @q{instrucción de LilyPond} se
567 refiere a cualquier instrucción descrita en las secciones anteriores
568 que se maneja por parte de @command{lilypond-book} para que produzca
569 un fragmento de música. Por simplicidad, las instrucciones de
570 LilyPond solamente se muestran en la sintaxis de @LaTeX{}.
572 Observe que la cadena de opciones se analiza de izquierda a derecha;
573 si una opción aparece varias veces, se toma la última solamente.
575 Están disponibles las siguientes opciones para las instrucciones de
579 @item staffsize=@var{altura}
580 Establecer la altura del pentagrama como @var{altura}, medida en
584 Producir líneas no justificadas por la derecha y con espaciado
585 natural, es decir, se añade @code{ragged-right = ##t} al fragmento de
586 LilyPond. Esta es la opción predeterminada para la instrucción
587 @code{\lilypond@{@}} si no está presente la opción @code{line-width}.
588 También es la opción predeterminada para el entorno @code{lilypond} si
589 está establecida la opción @code{fragment}, y no se especifica la
590 anchura de la línea explícitamente.
593 Para fragmentos de una sola línea, permitir que la longitud del
594 pentagrama se amplíe hasta igualar la anchura de la línea, es decir,
595 se añade @code{ragged-right = ##f} al fragmento de LilyPond.
597 @c does this option still exist in lilypond? -jm
599 Producir líneas con el espaciado empaquetado, es decir, se añade
600 @code{packed = ##t} al fragmento de código de LilyPond.
603 @itemx line-width=@var{tamaño}\@var{unidades}
604 Establecer el ancho de línea como @var{tamaño}, utilizando
605 @var{unidades} como unidad. @var{unidades} es una de las siguientes
606 cadenas: @code{cm}, @code{mm}, @code{in} o @code{pt}. Esta opción
607 afecta a la salida de LilyPond (esto es, a la longitud del pentagrama
608 del fragmento musical), no al formato del texto.
610 Si se usa sin ningún argumento, se establece el ancho de la línea a un
611 valor predeterminado (calculado con un algoritmo heurístico).
613 Si no se da ninguna opción @code{line-width}, @command{lilypond-book}
614 trata de adivinar un valor predeterminado para los entornos
615 @code{lilypond} que no usan la opción @code{ragged-right}.
618 No imprimir la indicación de compás, y desactivar las indicaciones
619 temporales de la música (indicación del compás y líneas divisorias).
622 Hacer que @command{lilypond-book} añada algunos códigos necesarios
623 para que podamos escribir simplemente, por ejemplo,
630 sin @code{\layout}, @code{\score}, etc.
633 No añadir escribir el código adicional que completa la sintaxis de
634 LilyPond en los fragmentos de música. Al ser la opción
635 predeterminada, @code{nofragment} normalmente es redundante.
637 @item indent=@var{tamaño}\@var{unidades}
638 Establecer el sangrado del primer sistema de pentagramas como
639 @var{tamaño}, utilizando @var{unidades} como unidad. @var{unidades} es
640 una de las siguientes cadenas: @code{cm}, @code{mm}, @code{in} o
641 @code{pt}. Esta opción afecta a LilyPond, no al formato del texto.
644 Establecer el sangrado del primer sistema de la música como cero.
645 Esta opción afecta a LilyPond, no al formato del texto. Puesto que el
646 valor predeterminado es que no haya ningún sangrado, @code{noindent}
647 normalmente es redundante.
650 Reducir la longitud de la línea de un fragmento musical en
651 @math{2*0.4}@dmn{in} (pulgadas) y colocar la salida dentro de un
652 bloque de cita (quotation). El valor de @q{0.4@dmn{in}} se puede
653 controlar con la opción @code{exampleindent}.
656 Establecer la longitud del sangrado que la opción @code{quote} aplica
657 al fragmento musical.
660 @itemx relative=@var{n}
661 Usar el modo de octava relativa. De forma predeterminada, las notas
662 se especifican con relación al Do@tie{}central. El argumento entero
663 opcional especifica la octava de la nota inicial, donde el valor
664 predeterminado @code{1} es el Do central. La opción @code{relative}
665 sólo funciona cuando está establecida la opción @code{fragment}, de
666 manera que @code{fragment} viene implicada automáticamente por
667 @code{relative}, independientemenre de la presencia de @code{fragment}
668 o de @code{nofragment} en la fuente.
672 LilyPond utiliza también @command{lilypond-book} para producir su
673 propia documentación. Para hacerlo, están a nuestra disposición
674 ciertas opciones algo esotéricas para los fragmentos musicales.
678 El argumento de una instrucción de LilyPond se copia al archivo de
679 salida y se incluye dentro de un bloque «verbatim» o preformateado,
680 seguido del texto que se escriba con la opción @code{intertext} (que
681 no funciona aún); después se imprime la música en sí. Esta opción no
682 funciona bien con @code{\lilypond@{@}} si forma parte de un párrafo.
684 Si se usa la opción @code{verbatim} dentro de una instrucción
685 @code{lilypondfile}, es posible incluir con estilo preformateado sólo
686 una parte del archivo fuente. Si el archivo de código fuente contiene
687 un comentario que contiene @samp{begin verbatim} (sin las comillas),
688 la cita del bloque de estilo preformateado empezará después de la
689 última vez que aparezca este comentario; de forma similar, la cita del
690 bloque preformateado se detendrá justo antes de la primera vez que
691 aparezca un comentario que contenga @samp{end verbatim}, si lo hay.
692 En el siguiente ejemplo de código fuente, la música se interpreta en
693 el modo relativo, pero la cita preformateada no presentará el bloque
694 @code{relative}, es decir
697 \relative c' @{ % begin verbatim
704 se imprimirá como un bloque preformateado como
712 (Sólo para la salida de Texinfo.) Anteponer la línea @code{\version
713 @@w@{"@@version@{@}"@}} a la salida de @code{verbatim}.
716 (Sólo para la salida de Texinfo.) Si se llama a @command{lilypond}
717 con la opción @option{--header=@/texidoc}, y el archivo que se procesa
718 se llama @file{fulanito@/.ly}, crea un archivo
719 @file{fulanito@/.texidoc} si existe un campo @code{texidoc} dentro del
720 bloque @code{\header} de cabecera. La opción @code{texidoc} hace que
721 @command{lilypond-book} incluya estos archivos, añadiendo su contenido
722 como un bloque de documentación inmediatamente antes del fragmento
725 Suponiendo que el archivo @file{fulanito@/.ly} contiene
729 texidoc = "Este archivo es un ejemplo de una sola nota."
735 y que tenemos lo siguiente en nuestro documento de Texinfo
736 @file{prueba.texinfo}
739 @@lilypondfile[texidoc]@{fulanito.ly@}
743 la siguiente orden da como salida el resultado esperado:
746 lilypond-book --process="lilypond --format=tex --tex \
747 --header=texidoc prueba.texinfo
750 La mayoría de los documentos de prueba de LilyPond (en el directorio
751 @file{input} de la distribución) son pequeños archivos @file{.ly} que
752 tienen exactamente este aspecto.
754 Por motivos de localización de idioma, si el documento de Texinfo
755 contiene @code{@@documentlanguage @var{LANG}} y la cabecera de
756 @file{loquesea@/.ly} contiene un campo @code{texidoc@var{LANG}}, y
757 @command{lilypond} se ejecuta con
758 @option{--header=@/texidoc@var{LANG}}, entonces se incluirá
759 @file{loquesea@/.texidoc@var{LANG}} en lugar de
760 @file{loquesea@/.texidoc}.
763 (Sólo para la salida de Texinfo.) Esta opción es similar a quote,
764 pero se pone dentro del bloque de cita solamente el fragmento de
765 música (y el bloque preformateado que se da en la opción
766 @code{verbatim}). Esta opción es útil si queremos citar
767 (@code{quote}) el fragmento musical pero no el bloque de documentación
771 (Sólo para la salida de Texinfo.) Esta opción funciona de forma
772 parecida a la opción @code{texidoc}: si @command{lilypond} se llama
773 con la opción @option{--header=@/doctitle}, y el archivo que procesar
774 se llama @file{loquesea@/.ly} y contiene un campo @code{doctitle} en
775 el bloque @code{\header}, crea un archivo @file{loquesea@/.doctitle}.
776 Cuando se usa la opción @code{doctitle}, el contenido de
777 @file{loquesea@/.doctitle}, que debería ser una línea única de
778 @var{texto}, se inserta en el documento de Texinfo como
779 @code{@@lydoctitle @var{texto}}. @code{@@lydoctitle} debe ser un
780 macro definido en el documento de Texinfo. La misma indicación
781 referida al procesado de @code{texidoc} con idiomas localizados se
782 aplica a @code{doctitle}.
785 Si un archivo de entrada de LilyPond se incluye con
786 @code{\lilypondfile}, imprimir el nombre del archivo inmediatamente
787 antes del fragmento musical. Para la salida HTML, esto es un enlace.
788 Sólo se imprime el nombre base del archivo, es decir, se elimina la
789 parte del directorio de la ruta del archivo.
792 Esta opción incluye las fuentes tipográficas en todos los archivos EPS
793 generados para este fragmento. Se debe usar si el fragmento usa
794 cualquier tipografía que @LaTeX{} no es capaz de encontrar por sí
800 @node Invoking lilypond-book
801 @section Invoking @command{lilypond-book}
803 @command{lilypond-book} produce un archivo con una de las siguientes
804 extensiones: @file{.tex}, @file{.texi}, @file{.html} o @file{.xml},
805 dependiendo del formato de salida. Todos los archivos @file{.tex},
806 @file{.texi} y @file{.xml} necesitan un procesado posterior.
808 @subheading Format-specific instructions
810 @subsubheading @LaTeX{}
812 Hay dos formas de procesar el documento en @LaTeX{} para su impresión
813 o publicación: hacer un archivo PDF directamente con PDF@LaTeX{}, o
814 generar un archivo PostScript con @LaTeX{} a través de un traductor de
815 DVI a PostScript como @command{dvips}. la primera forma es más
816 sencilla y es la que se recomienda@footnote{Observe que PDF@LaTeX{} y
817 @LaTeX{} podrían no ser utilizables para compilar cualquier documento
818 @LaTeX{}, y es por lo que explicamos las dos formas.}, y cualquiera
819 que sea el método que utilice, podrá convertir fácilmente entre
820 PostScript y PDF con herramientas como @command{ps2pdf} y
821 @command{pdf2ps} que vienen incluidas con Ghostscript.
823 Para producir un archivo PDF por medio de PDF@LaTeX{}, utilice
826 lilypond-book --pdf miarchivo.pdftex
827 pdflatex miarchivo.tex
830 @cindex tipografías de outline
831 @cindex type1, tipografías
833 @cindex invocación de dvips
835 Para producir una salida PDF por medio de
836 @LaTeX{}/@command{dvips}/@command{ps2pdf}, debe hacer
839 lilypond-book miarchivo.lytex
841 dvips -Ppdf miarchivo.dvi
846 El archivo @file{.dvi} creado por este proceso no contiene las cabezas
847 de las notas. Esto es normal; si sigue las instrucciones, las cabezas
848 aparecerán en los archivos @file{.ps} y @file{.pdf}.
850 La ejecución de @command{dvips} puede dar como resultado algunas
851 advertencias sobre las fuentes tipográficas; son inocuas y se pueden
852 ignorar. Si está ejecutando @command{latex} en modo de dos columnas,
853 recuerde añadir @code{-t landscape} a las opciones de @command{dvips}.
855 @subsubheading Texinfo
857 Para producir un documento de Texinfo (en cualquier formato de
858 salida), siga el procedimiento normal para Texinfo, esto es: o bien
859 llame a @command{texi2pdf} o a @command{texi2dvi} o a
860 @command{makeinfo}, según el formato de la salida que quiera crear.
862 @xref{Format with texi2dvi, , , texinfo, GNU Texinfo}, y @ref{Creating
863 an Info File, , , texinfo, GNU Texinfo}.
866 Consulte la documentación de Texinfo para ver más detalles.
870 @subheading Command line options
872 @command{lilypond-book} acepta las siguientes opciones de la línea de
876 @item -f @var{formato}
877 @itemx --format=@var{formato}
878 Especificar el tipo del documento que se va a procesar: @code{html},
879 @code{latex}, @code{texi} (predeterminado) o @code{docbook}. Si falta
880 esta opción, @command{lilypond-book} tratará de detectar el formato
881 automáticamente, véase @ref{Filename extensions}. Por el momento,
882 @code{texi} es lo mismo que @code{texi-html}.
884 @c This complicated detail is not implemented, comment it out -jm
886 The @code{texi} document type produces a Texinfo file with music
887 fragments in the printed output only. For getting images in the HTML
888 version, the format @code{texi-html} must be used instead.
891 @item -F @var{filtro}
892 @itemx --filter=@var{filtro}
893 Conducir los fragmentos a través de @var{filter} por medio de una
894 tubería. @code{lilypond-book} no obedecerá --filter y --process al
895 mismo tiempo. Por ejemplo,
898 lilypond-book --filter='convert-ly --from=2.0.0 -' mi-libro.tely
903 Imprimir un breve mensaje de ayuda.
905 @item -I @var{directorio}
906 @itemx --include=@var{directorio}
907 Añadir @var{directorio} a la ruta de inclusión.
908 @command{lilypond-book} busca también los fragmentos ya compilados en
909 la ruta de inclusión, y no los vuelve a escribir en el directorio de
910 salida, así que en ciertos casos es necesario invocar instrucciones de
911 procesado posteriores como @command{makeinfo} o @command{latex} con
912 las mismas opciones @code{-I @var{directorio}}.
914 @item -o @var{directorio}
915 @itemx --output=@var{directorio}
916 Colocar los archivos generados en el @var{directorio}. La ejecución
917 de @command{lilypond-book} genera montañas de pequeños archivos que
918 luego procesará LilyPond. Para evitar toda esta parafernalia en el
919 mismo directorio que la fuente, utilice la opción @option{--output}, y
920 cambie a este directorio antes de ejecutar @command{latex} o
924 lilypond-book --output=out miarchivo.lytex
929 @itemx --skip-lily-check
930 Evitar el fracaso si no se encuentra ninguna salida de lilypond. Se
931 usa para la documentación de LilyPond en formato Info sin imágenes.
933 @itemx --skip-png-check
934 Evitar el fracaso si no se encuentran las imágenes PNG de los archivos
935 EPS. Se usa para la documentación de LilyPond en formato Info sin
938 @itemx --lily-output-dir=@var{directorio}
939 Escribir archivos lily-XXX en el directorio @var{directorio}, enlazar
940 en el directorio de @code{--output}. Use esta opción para ahorrar
941 tiempo de construcción para documentos de distintos directorios que
942 comparten muchos fragmentos idénticos de código.
944 @itemx --info-images-dir=@var{directorio}
945 Dar formato a la salida de Texinfo de manera que Info busque las
946 imágenes de música en @var{directorio}.
948 @itemx --latex-program=@var{prog}
949 Ejecutar el propgrama @command{prog} en vez de @command{latex}. Esto
950 es útil si nuestro documento se procesa con @command{xelatex}, por
953 @itemx --left-padding=@var{cantidad}
954 Rellenar las cajas EPS en esta medida, alrededor. @var{cantidad} se
955 mide en milímetros, y es 3.0 como valor predeterminado. Esta opción
956 se debe usar si las líneas de música están muy pegadas al margen
959 El ancho de un sistema que está muy ajustado dentro de su rectángulo
960 puede variar, debido a los elementos de notación que están pegados al
961 margen izquierdo, como los números de compás y el nombre del
962 instrumento. Esta opción acorta todas las líneas y las mueve a la
963 derecha en la misma medida.
966 @item -P @var{instrucción}
967 @itemx --process=@var{instrucción}
968 Procesar los fragmentos de LilyPond utilizando @var{instrucción}. La
969 instrucción predeterminada es @code{lilypond}. @code{lilypond-book} no
970 obedecerá a @code{--filter} y a @code{--process} al mismo tiempo.
973 Crear archivos PDF para su uso con PDF@LaTeX{}.
976 Extraer todas las tipografías PostScript en
977 @file{@var{archivo}.psfonts} para dvips. Esto es necesario para
978 @command{dvips -h @var{archivo}.psfonts}.
986 Imprimir la información de la versión.
991 La instrucción de Texinfo @code{@@pagesizes} no se interpreta. De
992 forma similar, las instrucciones de @LaTeX{} que cambian los márgenes
993 y anchos de línea después del preámbulo se ignoran.
995 Sólo se procesa el primer @code{\score} de un bloque LilyPond.
998 @node Filename extensions
999 @section Filename extensions
1001 Puede usar cualquier extensión para el nombre del archivo de entrada,
1002 pero si no usa la extensión recomendada para un formato en particular
1003 tendrá que especificar manualmente el formato de salida; para ver más
1004 detalles, consulte @ref{Invoking lilypond-book}. En caso contrario,
1005 @command{lilypond-book} selecciona automáticamente el formato de
1006 salida basándose en la extensión del nombre del archivo de entrada.
1009 @multitable @columnfractions .2 .5
1010 @item @strong{extensión} @tab @strong{formato de salida}
1012 @item @file{.html} @tab HTML
1013 @item @file{.itely} @tab Texinfo
1014 @item @file{.latex} @tab @LaTeX{}
1015 @item @file{.lytex} @tab @LaTeX{}
1016 @item @file{.lyxml} @tab DocBook
1017 @item @file{.tely} @tab Texinfo
1018 @item @file{.tex} @tab @LaTeX{}
1019 @item @file{.texi} @tab Texinfo
1020 @item @file{.texinfo} @tab Texinfo
1021 @item @file{.xml} @tab HTML
1025 Si usa la misma extensión para el archivo de entrada que la que usa
1026 @command{lilypond-book} para el archivo de salida, y si el archivo de
1027 entrada está en el mismo directorio que el directorio de trabajo de
1028 @command{lilypond-book}, debe usar la opción @code{--output} para que
1029 funcione @command{lilypond-book}, pues en caso contrario saldrá con un
1030 mensaje de error como @qq{La salida sobreescribirá al archivo de
1034 @node Alternate methods of mixing text and music
1035 @section Alternative methods of mixing text and music
1037 Esta sección presenta métodos para integrar texto y música distintos
1038 del método automatizado con @command{lilypond-book}.
1041 * Many quotes from a large score::
1042 * Inserting LilyPond output into OpenOffice.org::
1043 * Inserting LilyPond output into other programs::
1046 @node Many quotes from a large score
1047 @unnumberedsubsec Many quotes from a large score
1049 Si tiene que citar muchos fragmentos extraídos de una partitura grade,
1050 puede también usar la capacidad de recorte de sistemas, véase
1051 @ruser{Extracting fragments of music}.
1054 @node Inserting LilyPond output into OpenOffice.org
1055 @unnumberedsubsec Inserting LilyPond output into OpenOffice.org
1057 @cindex OpenOffice.org
1059 Se puede añadir notación de LilyPond a los documentos de
1061 @uref{http://@/ooolilypond@/.sourceforge@/.net@/,OOoLilyPond}.
1064 @node Inserting LilyPond output into other programs
1065 @unnumberedsubsec Inserting LilyPond output into other programs
1067 Para insertar la salida de LilyPond dentro de otros programas, use
1068 @code{lilypond} en vez de @code{lilypond-book}. Cada ejemplo debe
1069 crearse individualmente y añadirse al documento; consulte la
1070 documentación del programa correspondiente. La mayoría de los
1071 programas podrán insertar la salida de LilyPond en los formatos
1072 @file{PNG}, @file{EPS} o @file{PDF}.
1074 Para reducir el espacio vacío alrededor de la partitura de LilyPond,
1075 utilice las siguientes opciones:
1083 bookTitleMarkup = ##f
1084 scoreTitleMarkup = ##f
1090 Para obtener un archivo @file{EPS} que sea útil, utilice
1093 lilypond -dbackend=eps -dno-gs-load-fonts -dinclude-eps-fonts miarchivo.ly
1096 lilypond -dbackend=eps -dno-gs-load-fonts -dinclude-eps-fonts --png miarchivo.ly