1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
2 @c This file is part of lilypond-program.tely
4 Translation of GIT committish: 83b79ca13f14bdc7a16cc406b3929ade6b618a78
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}.
34 Este procedimiento se puede aplicar a documentos de @LaTeX{}, HTML,
42 @cindex documentos, insertar música en
43 @cindex HTML, música dentro de
44 @cindex Texinfo, música dentro de
45 @cindex DocBook, música dentro de
46 @cindex @LaTeX{}, música dentro de
49 * An example of a musicological document::
50 * Integrating music and text::
51 * Music fragment options::
52 * Invoking lilypond-book::
53 * Filename extensions::
54 * Alternate methods of mixing text and music::
58 @node An example of a musicological document
59 @section An example of a musicological document
62 Ciertos textos contienen ejemplos musicales. Son tratados musicales,
63 cancioneros o manuales como este mismo. Estos textos se pueden hacer
64 a mano, importando simplemente una imagen en formato PostScript en el
65 editor de textos. Sin embargo, hay un procedimiento automático para
66 reducir la carga de trabajo que esto implica los documentos de HTML,
67 @LaTeX{}, Texinfo y DocBook.
69 Un guión ejecutable llamado @code{lilypond-book} extrae los fragmentos
70 de música, les da formato y vuelve a poner en su lugar la partitura
71 resultante. A continuación presentamos un pequeño ejemplo de su
72 utilización con @LaTeX{}. El ejemplo contiene también texto
73 explicativo, por lo que no vamos a comentarlo posteriormente.
79 \documentclass[a4paper]{article}
83 Los documentos para \verb+lilypond-book+ pueden mezclar libremente
84 música y texto. Por ejemplo:
88 c2 g'2 \times 2/3 { f8 e d } c'2 g4
92 Las opciones se escriben entre corchetes.
94 \begin[fragment,quote,staffsize=26,verbatim]{lilypond}
98 Los ejemplos grandes se pueden grabar en archivos separados e
99 introducirse con \verb+\lilypondfile+.
101 \lilypondfile[quote,noindent]{screech-boink.ly}
103 (Si es necesario, sustituya screech-boink.ly por cualquier archivo .ly
104 situado en el mismo directorio que este archivo.)
110 @subheading Processing
112 Guarde el código anterior como un archivo llamado
113 @file{lilybook.lytex}, y luego ejecute en un terminal:
115 @c keep space after @version{} so TeX doesn't choke
117 lilypond-book --output=out --pdf lilybook.lytex
118 @emph{lilypond-book (GNU LilyPond) @version{} }
119 @emph{Leyendo lilybook.lytex...}
120 @emph{..montañas de mensajes suprimidos..}
121 @emph{Compilando lilybook.tex...}
124 @emph{..montañas de mensajes suprimidos..}
126 @emph{(sustituya @command{xpdf} por su visor de PDF favorito)}
129 La ejecución de @command{lilypond-book} y @command{latex} crea un gran
130 número de archivos temporales, que podrían abarrotar el directorio de
131 trabajo. Para poner remedio a esto utilice la opción
132 @code{--output=@var{directorio}}. Creará los archivos en un subdirectorio
133 aparte @file{directorio}.
135 Finalmente el resultado del ejemplo de @LaTeX{} que acabamos de
136 mostrar@footnote{Este tutorial se procesa con Texinfo, por lo que el
137 ejemplo presenta un resultado en la disposición ligeramente
138 distinto.}. Así acaba la sección del tutorial.
144 Los documentos para @command{lilypond-book} pueden mezclar libremente
145 música y texto. Por ejemplo:
149 c2 g'2 \times 2/3 { f8 e d } c'2 g4
153 Las opciones se escriben entre corchetes.
155 @lilypond[fragment,quote,staffsize=26,verbatim]
159 Los ejemplos grandes se pueden grabar en archivos separados e
160 introducirse con @code{\lilypondfile}.
162 @lilypondfile[quote,noindent]{screech-boink.ly}
167 @node Integrating music and text
168 @section Integrating music and text
170 Aquí vamos a explicar cómo integrar LilyPond con algunos otros
183 @LaTeX{} es el estándar de facto para la publicación en el mundo de
184 las ciencias exactas. Está construido encima del motor de composición
185 tipográfica @TeX{}, proporcionando la tipografía de mejor calidad que
189 @uref{http://@/www@/.ctan@/.org/@/tex@/-archive/@/info/@/lshort/@/english/,
190 @emph{The Not So Short Introduction to @LaTeX{}}} (Introducción no tan
191 breve a @LaTeX{}) para ver una panorámica sobre cómo usar @LaTeX{}.
193 La música se introduce usando
196 \begin[las,opciones,van,aquí]@{lilypond@}
197 EL CÓDIGO DE LILYPOND
205 \lilypondfile[las,opciones,van,aquí]@{@var{archivo}@}
212 \lilypond@{ EL CÓDIGO DE LILYPOND @}
215 La ejecución de @command{lilypond-book} deja como resultado un archivo
216 que se puede procesar posteriormente con @LaTeX{}.
218 A continuación mostramos algunos ejemplos. El entorno @code{lilypond}
221 \begin[quote,fragment,staffsize=26]@{lilypond@}
229 @lilypond[quote,fragment,staffsize=26]
236 \lilypond[quote,fragment,staffsize=11]@{<c' e' g'>@}
242 @lilypond[quote,fragment,staffsize=11]{<c' e' g'>}
245 Por el momento no es posible incluir llaves @code{@{} o @code{@}}
246 dentro de @code{\lilypond@{@}}, así que esta instrucción solamente es
247 útil con la opción @code{fragment}.
249 El ancho predeterminado de las líneas de música se ajusta mediante el
250 examen de las instrucciones del preámbulo del documento, la parte del
251 documento que está antes de @code{\begin@{document@}}. La instrucción
252 @command{lilypond-book} los envía a @LaTeX{} para averiguar la anchura
253 del texto. El ancho de la línea para los fragmentos de música se
254 ajusta entonces al ancho del texto. Observe que este algoritmo
255 heurístico puede fácilmente fallar; en estos casos es necesario usar
256 la opción @code{line-width} del fragmento de música.
258 @cindex títulos y lilypond-book
259 @cindex \header dentro de documentos @LaTeX{}
261 Cada fragmento ejecutará los macros siguientes si han sido definidos
265 @item @code{\preLilyPondExample} que se llama antes de la música,
267 @item @code{\postLilyPondExample} que se llama después de la música,
269 @item @code{\betweenLilyPondSystem[1]} se llama entre los sistemas si
270 @code{lilypond-book} ha dividido el fragmento en varios archivos
271 PostScript. Se debe definir de forma que tome un parámetro y recibirá
272 el número de archivos ya incluidos dentro del fragmento actual. La
273 acción predeterminada es simplemente insertar un @code{\linebreak}.
279 @cindex Latex, feta symbols
282 To include feta symbols (such as flat, segno, etc) in a LaTeX
283 document, use @code{\input@{titledefs@}}
286 \documentclass[a4paper]@{article@}
297 The font symbol names are defined in the file feta20.tex; to find
298 the location of this file, use the command
308 A veces es útil mostrar elementos de música (como ligaduras) como si
309 continuasen más allá del final del fragmento. Esto se puede hacer
310 dividiendo el pentagrama y suprimiendo la inclusión del resto de la
313 En @LaTeX{}, defina @code{\betweenLilyPondSystem} de tal forma que la
314 la inclusión de otros sistemas se dé por terminada una vez que se ha
315 alcanzado el número deseado de sistemas requeridos. Puesto que
316 @code{\betweenLilypondSystem} se llama en primer lugar @emph{después}
317 del primer sistema, incluir solamente el primer sistema es algo
321 \def\betweenLilyPondSystem#1@{\endinput@}
323 \begin[fragment]@{lilypond@}
324 c'1\( e'( c'~ \break c' d) e f\)
328 Si se necesita un mayor número de sistemas, se tiene que usar un
329 condicional de @TeX{} antes del @code{\endinput}. En este ejemplo,
330 sustituya el @q{2} por el número de sistemas que quiere en la salida:
333 \def\betweenLilyPondSystem#1@{
334 \ifnum##1<2\else\endinput\fi
338 Recuerde que la definición de @code{\betweenLilyPondSystem} es
339 efectiva hasta que @TeX{} abandona el grupo actual (como el entorno
340 @LaTeX{}) o se sobreescribe por otra definición (lo que casi siempre
341 es por el resto del documento). Para reponer la definición, escriba
344 \let\betweenLilyPondSystem\undefined
348 dentro de la fuente de @LaTeX{}.
350 Se puede simplificar esto definiendo un macro de @TeX{}:
353 \def\onlyFirstNSystems#1@{
354 \def\betweenLilyPondSystem##1@{\ifnum##1<#1\else\endinput\fi@}
359 y luego diciendo solamente cuántos sistemas quiere antes de cada
363 \onlyFirstNSystems@{3@}
364 \begin@{lilypond@}...\end@{lilypond@}
365 \onlyFirstNSystems@{1@}
366 \begin@{lilypond@}...\end@{lilypond@}
370 Hay opciones de línea de órdenes específicas de
371 @command{lilypond-book} y otros detalles que conocer para procesar
372 documentos de@LaTeX{} véase @ref{Invoking lilypond-book}.
378 Texinfo es el formato estándar para la documentación del proyecto GNU.
379 Este mismo manual es un ejemplo de documento Texinfo. Las versiones
380 HTML, PDF e Info del manual se hacen a partir del documento Texinfo.
383 En el archivo de entrada, la música se especifica con
386 @@lilypond[las,opciones,van,aquí]
387 EL CÓDIGO DE LILYPOND
395 @@lilypond[las,opciones,van,aquí]@{ EL CÓDIGO DE LILYPOND @}
402 @@lilypondfile[las,opciones,van,aquí]@{@var{archivo}@}
405 Cuando se ejecuta @command{lilypond-book} sobre el archivo, se obtiene
406 como resultado un archivo Texinfo (con la extensión @file{.texi}) que
407 contiene etiquetas @code{@@image} para el HTML, Info y la salida
408 impresa. @command{lilypond-book} genera imágenes de la música en
409 formatos EPS y PDF para usarlos en la salida impresa, y en formato PNG
410 para usarlos en las salidas HTML e Info.
412 Aquí podemos ver dos ejemplos sencillos. Un entorno @code{lilypond}
430 @@lilypond[fragment,staffsize=11]@{<c' e' g'>@}
436 @lilypond[fragment,staffsize=11]{<c' e' g'>}
438 No como @LaTeX{}, @code{@@lilypond@{...@}} no genera una imagen en
439 línea. Siempre consiste en un párrafo para ella sola.
445 La música se introduce usando
448 <lilypond fragment relative=2>
449 \key c \minor c4 es g2
454 @command{lilypond-book} entonces produce un archivo HTML con las
455 etiquetas de imagen adecuadas para los fragmentos de música:
457 @lilypond[fragment,relative=2]
458 \key c \minor c4 es g2
461 Para imágenes en línea, utilice @code{<lilypond ... />}, donde las
462 opciones están separadas de la música por el símbolo de dos puntos,
466 Algo de música dentro de <lilypond relative=2: a b c/> una línea de texto.
469 Para incluir archivos externos, escriba
472 <lilypondfile @var{opción1} @var{opción2} ...>@var{archivo}</lilypondfile>
475 @cindex títulos en HTML
476 @cindex vista previa, imagen
482 Para insertad fragmentos de LilyPond es bueno tratar de mantener la
483 conformidad del documento de DocBook, permitiendo así el uso de
484 editores de DocBook, validación, etc. Así pues, no usamos etiquetas
485 personalizadas, sólo especificamos una convención basada en los
486 elementos estándar de DocBook.
488 @subheading Common conventions
490 Para insertar toda clase de fragmentos utilizamos los elementos
491 @code{mediaobject} y @code{inlinemediaobject}, de forma que nuestros
492 fragmentos puedan ser formateados en línea o no en línea. Las
493 opciones de formateo del fragmento se escriben siempre dentro de la
494 propiedad @code{role} del elemento más interno (véanse las secciones
495 siguientes). Las etiquetas se eligen de forma que permitan a los
496 editores de DocBook formatear el contenido satisfactoriamente. Los
497 archivos de DocBook que se van a procesar con @command{lilypond-book}
498 deben tener la extensión @file{.lyxml}.
500 @subheading Including a LilyPond file
502 Este es el caso más sencillo. Debemos usar la extensión @file{.ly}
503 para el archivo incluido, e insertarlo como un @code{imageobject}
504 estándar, con la estructura siguiente:
509 <imagedata fileref="music1.ly" role="printfilename" />
514 Observe que puede usar mediaobject o inlinemediaobject como el
515 elemento más externo, a elección suya.
517 @subheading Including LilyPond code
519 Se puede incluir código de LilyPond mediante la utilización de un
520 elemento @code{programlisting}, en que el lenguaje se establece como
521 @code{lilypond} con la estructura siguiente:
526 <programlisting language="lilypond" role="fragment verbatim staffsize=16 ragged-right relative=2">
527 \context Staff \with @{
528 \remove Time_signature_engraver
529 \remove Clef_engraver@}
536 Como puede ver, el elemento más externo es un @code{mediaobject} o un
537 @code{inlinemediaobject}, y hay un elemento @code{textobject} que
538 lleva el @code{programlisting} en su interior.
540 @subheading Processing the DocBook document
542 Al ejecutar @command{lilypond-book} sobre el archivo @file{.lyxml} se
543 creará un documento de DocBook válido que se puede procesar
544 posteriormente con la extensión @file{.xml}. Si usa
545 @uref{http://@/dblatex@/.sourceforge@/.net@/,dblatex}, creará un
546 archivo PDF a partir de este documento automáticamente. Para la
547 generación de HTML (HTML Help, JavaHelp, etc.) puede usar las hojas de
548 estilo oficiales XSL de DocBook, aunque es posible que tenga que
549 aplicarles algún tipo de personalización.
552 @node Music fragment options
553 @section Music fragment options
555 Durante los próximos párrafos, una @q{instrucción de LilyPond} se
556 refiere a cualquier instrucción descrita en las secciones anteriores
557 que se maneja por parte de @command{lilypond-book} para que produzca
558 un fragmento de música. Por simplicidad, las instrucciones de
559 LilyPond solamente se muestran en la sintaxis de @LaTeX{}.
561 Observe que la cadena de opciones se analiza de izquierda a derecha;
562 si una opción aparece varias veces, se toma la última solamente.
564 Están disponibles las siguientes opciones para las instrucciones de
568 @item staffsize=@var{altura}
569 Establecer la altura del pentagrama como @var{altura}, medida en
573 Producir líneas no justificadas por la derecha y con espaciado
574 natural, es decir, se añade @code{ragged-right = ##t} al fragmento de
575 LilyPond. Esta es la opción predeterminada para la instrucción
576 @code{\lilypond@{@}} si no está presente la opción @code{line-width}.
577 También es la opción predeterminada para el entorno @code{lilypond} si
578 está establecida la opción @code{fragment}, y no se especifica la
579 anchura de la línea explícitamente.
582 Para fragmentos de una sola línea, permitir que la longitud del
583 pentagrama se amplíe hasta igualar la anchura de la línea, es decir,
584 se añade @code{ragged-right = ##f} al fragmento de LilyPond.
586 @c does this option still exist in lilypond? -jm
588 Producir líneas con el espaciado empaquetado, es decir, se añade
589 @code{packed = ##t} al fragmento de código de LilyPond.
592 @itemx line-width=@var{tamaño}\@var{unidades}
593 Establecer el ancho de línea como @var{tamaño}, utilizando
594 @var{unidades} como unidad. @var{unidades} es una de las siguientes
595 cadenas: @code{cm}, @code{mm}, @code{in} o @code{pt}. Esta opción
596 afecta a la salida de LilyPond (esto es, a la longitud del pentagrama
597 del fragmento musical), no al formato del texto.
599 Si se usa sin ningún argumento, se establece el ancho de la línea a un
600 valor predeterminado (calculado con un algoritmo heurístico).
602 Si no se da ninguna opción @code{line-width}, @command{lilypond-book}
603 trata de adivinar un valor predeterminado para los entornos
604 @code{lilypond} que no usan la opción @code{ragged-right}.
607 No imprimir la indicación de compás, y desactivar las indicaciones
608 temporales de la música (indicación del compás y líneas divisorias).
611 Hacer que @command{lilypond-book} añada algunos códigos necesarios
612 para que podamos escribir simplemente, por ejemplo,
619 sin @code{\layout}, @code{\score}, etc.
622 No añadir escribir el código adicional que completa la sintaxis de
623 LilyPond en los fragmentos de música. Al ser la opción
624 predeterminada, @code{nofragment} normalmente es redundante.
626 @item indent=@var{tamaño}\@var{unidades}
627 Establecer el sangrado del primer sistema de pentagramas como
628 @var{tamaño}, utilizando @var{unidades} como unidad. @var{unidades} es
629 una de las siguientes cadenas: @code{cm}, @code{mm}, @code{in} o
630 @code{pt}. Esta opción afecta a LilyPond, no al formato del texto.
633 Establecer el sangrado del primer sistema de la música como cero.
634 Esta opción afecta a LilyPond, no al formato del texto. Puesto que el
635 valor predeterminado es que no haya ningún sangrado, @code{noindent}
636 normalmente es redundante.
639 Reducir la longitud de la línea de un fragmento musical en
640 @math{2*0.4}@dmn{in} (pulgadas) y colocar la salida dentro de un
641 bloque de cita (quotation). El valor de @q{0.4@dmn{in}} se puede
642 controlar con la opción @code{exampleindent}.
645 Establecer la longitud del sangrado que la opción @code{quote} aplica
646 al fragmento musical.
649 @itemx relative=@var{n}
650 Usar el modo de octava relativa. De forma predeterminada, las notas
651 se especifican con relación al Do@tie{}central. El argumento entero
652 opcional especifica la octava de la nota inicial, donde el valor
653 predeterminado @code{1} es el Do central. La opción @code{relative}
654 sólo funciona cuando está establecida la opción @code{fragment}, de
655 manera que @code{fragment} viene implicada automáticamente por
656 @code{relative}, independientemenre de la presencia de @code{fragment}
657 o de @code{nofragment} en la fuente.
661 LilyPond utiliza también @command{lilypond-book} para producir su
662 propia documentación. Para hacerlo, están a nuestra disposición
663 ciertas opciones algo esotéricas para los fragmentos musicales.
667 El argumento de una instrucción de LilyPond se copia al archivo de
668 salida y se incluye dentro de un bloque «verbatim» o preformateado,
669 seguido del texto que se escriba con la opción @code{intertext} (que
670 no funciona aún); después se imprime la música en sí. Esta opción no
671 funciona bien con @code{\lilypond@{@}} si forma parte de un párrafo.
673 Si se usa la opción @code{verbatim} dentro de una instrucción
674 @code{lilypondfile}, es posible incluir con estilo preformateado sólo
675 una parte del archivo fuente. Si el archivo de código fuente contiene
676 un comentario que contiene @samp{begin verbatim} (sin las comillas),
677 la cita del bloque de estilo preformateado empezará después de la
678 última vez que aparezca este comentario; de forma similar, la cita del
679 bloque preformateado se detendrá justo antes de la primera vez que
680 aparezca un comentario que contenga @samp{end verbatim}, si lo hay.
681 En el siguiente ejemplo de código fuente, la música se interpreta en
682 el modo relativo, pero la cita preformateada no presentará el bloque
683 @code{relative}, es decir
686 \relative c' @{ % begin verbatim
693 se imprimirá como un bloque preformateado como
701 (Sólo para la salida de Texinfo.) Anteponer la línea @code{\version
702 @@w@{"@@version@{@}"@}} a la salida de @code{verbatim}.
705 (Sólo para la salida de Texinfo.) Si se llama a @command{lilypond}
706 con la opción @option{--header=@/texidoc}, y el archivo que se procesa
707 se llama @file{fulanito@/.ly}, crea un archivo
708 @file{fulanito@/.texidoc} si existe un campo @code{texidoc} dentro del
709 bloque @code{\header} de cabecera. La opción @code{texidoc} hace que
710 @command{lilypond-book} incluya estos archivos, añadiendo su contenido
711 como un bloque de documentación inmediatamente antes del fragmento
714 Suponiendo que el archivo @file{fulanito@/.ly} contiene
718 texidoc = "Este archivo es un ejemplo de una sola nota."
724 y que tenemos lo siguiente en nuestro documento de Texinfo
725 @file{prueba.texinfo}
728 @@lilypondfile[texidoc]@{fulanito.ly@}
732 la siguiente orden da como salida el resultado esperado:
735 lilypond-book --process="lilypond --format=tex --tex \
736 --header=texidoc prueba.texinfo
739 La mayoría de los documentos de prueba de LilyPond (en el directorio
740 @file{input} de la distribución) son pequeños archivos @file{.ly} que
741 tienen exactamente este aspecto.
743 Por motivos de localización de idioma, si el documento de Texinfo
744 contiene @code{@@documentlanguage @var{LANG}} y la cabecera de
745 @file{loquesea@/.ly} contiene un campo @code{texidoc@var{LANG}}, y
746 @command{lilypond} se ejecuta con
747 @option{--header=@/texidoc@var{LANG}}, entonces se incluirá
748 @file{loquesea@/.texidoc@var{LANG}} en lugar de
749 @file{loquesea@/.texidoc}.
752 (Sólo para la salida de Texinfo.) Esta opción es similar a quote,
753 pero se pone dentro del bloque de cita solamente el fragmento de
754 música (y el bloque preformateado que se da en la opción
755 @code{verbatim}). Esta opción es útil si queremos citar
756 (@code{quote}) el fragmento musical pero no el bloque de documentación
760 (Sólo para la salida de Texinfo.) Esta opción funciona de forma
761 parecida a la opción @code{texidoc}: si @command{lilypond} se llama
762 con la opción @option{--header=@/doctitle}, y el archivo que procesar
763 se llama @file{loquesea@/.ly} y contiene un campo @code{doctitle} en
764 el bloque @code{\header}, crea un archivo @file{loquesea@/.doctitle}.
765 Cuando se usa la opción @code{doctitle}, el contenido de
766 @file{loquesea@/.doctitle}, que debería ser una línea única de
767 @var{texto}, se inserta en el documento de Texinfo como
768 @code{@@lydoctitle @var{texto}}. @code{@@lydoctitle} debe ser un
769 macro definido en el documento de Texinfo. La misma indicación
770 referida al procesado de @code{texidoc} con idiomas localizados se
771 aplica a @code{doctitle}.
774 Si un archivo de entrada de LilyPond se incluye con
775 @code{\lilypondfile}, imprimir el nombre del archivo inmediatamente
776 antes del fragmento musical. Para la salida HTML, esto es un enlace.
777 Sólo se imprime el nombre base del archivo, es decir, se elimina la
778 parte del directorio de la ruta del archivo.
781 Esta opción incluye las fuentes tipográficas en todos los archivos EPS
782 generados para este fragmento. Se debe usar si el fragmento usa
783 cualquier tipografía que @LaTeX{} no es capaz de encontrar por sí
789 @node Invoking lilypond-book
790 @section Invoking @command{lilypond-book}
792 @command{lilypond-book} produce un archivo con una de las siguientes
793 extensiones: @file{.tex}, @file{.texi}, @file{.html} o @file{.xml},
794 dependiendo del formato de salida. Todos los archivos @file{.tex},
795 @file{.texi} y @file{.xml} necesitan un procesado posterior.
797 @subheading Format-specific instructions
799 @subsubheading @LaTeX{}
801 Hay dos formas de procesar el documento en @LaTeX{} para su impresión
802 o publicación: hacer un archivo PDF directamente con PDF@LaTeX{}, o
803 generar un archivo PostScript con @LaTeX{} a través de un traductor de
804 DVI a PostScript como @command{dvips}. la primera forma es más
805 sencilla y es la que se recomienda@footnote{Observe que PDF@LaTeX{} y
806 @LaTeX{} podrían no ser utilizables para compilar cualquier documento
807 @LaTeX{}, y es por lo que explicamos las dos formas.}, y cualquiera
808 que sea el método que utilice, podrá convertir fácilmente entre
809 PostScript y PDF con herramientas como @command{ps2pdf} y
810 @command{pdf2ps} que vienen incluidas con Ghostscript.
812 Para producir un archivo PDF por medio de PDF@LaTeX{}, utilice
815 lilypond-book --pdf miarchivo.pdftex
816 pdflatex miarchivo.tex
819 @cindex tipografías de outline
820 @cindex type1, tipografías
822 @cindex invocación de dvips
824 Para producir una salida PDF por medio de
825 @LaTeX{}/@command{dvips}/@command{ps2pdf}, debe hacer
828 lilypond-book miarchivo.lytex
830 dvips -Ppdf miarchivo.dvi
835 El archivo @file{.dvi} creado por este proceso no contiene las cabezas
836 de las notas. Esto es normal; si sigue las instrucciones, las cabezas
837 aparecerán en los archivos @file{.ps} y @file{.pdf}.
839 La ejecución de @command{dvips} puede dar como resultado algunas
840 advertencias sobre las fuentes tipográficas; son inocuas y se pueden
841 ignorar. Si está ejecutando @command{latex} en modo de dos columnas,
842 recuerde añadir @code{-t landscape} a las opciones de @command{dvips}.
844 @subsubheading Texinfo
846 Para producir un documento de Texinfo (en cualquier formato de
847 salida), siga el procedimiento normal para Texinfo, esto es: o bien
848 llame a @command{texi2pdf} o a @command{texi2dvi} o a
849 @command{makeinfo}, según el formato de la salida que quiera crear.
851 @xref{Format with texi2dvi, , , texinfo, GNU Texinfo}, y @ref{Creating
852 an Info File, , , texinfo, GNU Texinfo}.
855 Consulte la documentación de Texinfo para ver más detalles.
859 @subheading Command line options
861 @command{lilypond-book} acepta las siguientes opciones de la línea de
865 @item -f @var{formato}
866 @itemx --format=@var{formato}
867 Especificar el tipo del documento que se va a procesar: @code{html},
868 @code{latex}, @code{texi} (predeterminado) o @code{docbook}. Si falta
869 esta opción, @command{lilypond-book} tratará de detectar el formato
870 automáticamente, véase @ref{Filename extensions}. Por el momento,
871 @code{texi} es lo mismo que @code{texi-html}.
873 @c This complicated detail is not implemented, comment it out -jm
875 The @code{texi} document type produces a Texinfo file with music
876 fragments in the printed output only. For getting images in the HTML
877 version, the format @code{texi-html} must be used instead.
880 @item -F @var{filtro}
881 @itemx --filter=@var{filtro}
882 Conducir los fragmentos a través de @var{filter} por medio de una
883 tubería. @code{lilypond-book} no obedecerá --filter y --process al
884 mismo tiempo. Por ejemplo,
887 lilypond-book --filter='convert-ly --from=2.0.0 -' mi-libro.tely
892 Imprimir un breve mensaje de ayuda.
894 @item -I @var{directorio}
895 @itemx --include=@var{directorio}
896 Añadir @var{directorio} a la ruta de inclusión.
897 @command{lilypond-book} busca también los fragmentos ya compilados en
898 la ruta de inclusión, y no los vuelve a escribir en el directorio de
899 salida, así que en ciertos casos es necesario invocar instrucciones de
900 procesado posteriores como @command{makeinfo} o @command{latex} con
901 las mismas opciones @code{-I @var{directorio}}.
903 @item -o @var{directorio}
904 @itemx --output=@var{directorio}
905 Colocar los archivos generados en el @var{directorio}. La ejecución
906 de @command{lilypond-book} genera montañas de pequeños archivos que
907 luego procesará LilyPond. Para evitar toda esta parafernalia en el
908 mismo directorio que la fuente, utilice la opción @option{--output}, y
909 cambie a este directorio antes de ejecutar @command{latex} o
913 lilypond-book --output=out miarchivo.lytex
918 @itemx --skip-lily-check
919 Evitar el fracaso si no se encuentra ninguna salida de lilypond. Se
920 usa para la documentación de LilyPond en formato Info sin imágenes.
922 @itemx --skip-png-check
923 Evitar el fracaso si no se encuentran las imágenes PNG de los archivos
924 EPS. Se usa para la documentación de LilyPond en formato Info sin
927 @itemx --lily-output-dir=@var{directorio}
928 Escribir archivos lily-XXX en el directorio @var{directorio}, enlazar
929 en el directorio de @code{--output}. Use esta opción para ahorrar
930 tiempo de construcción para documentos de distintos directorios que
931 comparten muchos fragmentos idénticos de código.
933 @itemx --info-images-dir=@var{directorio}
934 Dar formato a la salida de Texinfo de manera que Info busque las
935 imágenes de música en @var{directorio}.
937 @itemx --latex-program=@var{prog}
938 Ejecutar el propgrama @command{prog} en vez de @command{latex}. Esto
939 es útil si nuestro documento se procesa con @command{xelatex}, por
942 @itemx --left-padding=@var{cantidad}
943 Rellenar las cajas EPS en esta medida, alrededor. @var{cantidad} se
944 mide en milímetros, y es 3.0 como valor predeterminado. Esta opción
945 se debe usar si las líneas de música están muy pegadas al margen
948 El ancho de un sistema que está muy ajustado dentro de su rectángulo
949 puede variar, debido a los elementos de notación que están pegados al
950 margen izquierdo, como los números de compás y el nombre del
951 instrumento. Esta opción acorta todas las líneas y las mueve a la
952 derecha en la misma medida.
955 @item -P @var{instrucción}
956 @itemx --process=@var{instrucción}
957 Procesar los fragmentos de LilyPond utilizando @var{instrucción}. La
958 instrucción predeterminada es @code{lilypond}. @code{lilypond-book} no
959 obedecerá a @code{--filter} y a @code{--process} al mismo tiempo.
962 Crear archivos PDF para su uso con PDF@LaTeX{}.
965 Extraer todas las tipografías PostScript en
966 @file{@var{archivo}.psfonts} para dvips. Esto es necesario para
967 @command{dvips -h @var{archivo}.psfonts}.
975 Imprimir la información de la versión.
980 La instrucción de Texinfo @code{@@pagesizes} no se interpreta. De
981 forma similar, las instrucciones de @LaTeX{} que cambian los márgenes
982 y anchos de línea después del preámbulo se ignoran.
984 Sólo se procesa el primer @code{\score} de un bloque LilyPond.
987 @node Filename extensions
988 @section Filename extensions
990 Puede usar cualquier extensión para el nombre del archivo de entrada,
991 pero si no usa la extensión recomendada para un formato en particular
992 tendrá que especificar manualmente el formato de salida; para ver más
993 detalles, consulte @ref{Invoking lilypond-book}. En caso contrario,
994 @command{lilypond-book} selecciona automáticamente el formato de
995 salida basándose en la extensión del nombre del archivo de entrada.
998 @multitable @columnfractions .2 .5
999 @item @strong{extensión} @tab @strong{formato de salida}
1001 @item @file{.html} @tab HTML
1002 @item @file{.itely} @tab Texinfo
1003 @item @file{.latex} @tab @LaTeX{}
1004 @item @file{.lytex} @tab @LaTeX{}
1005 @item @file{.lyxml} @tab DocBook
1006 @item @file{.tely} @tab Texinfo
1007 @item @file{.tex} @tab @LaTeX{}
1008 @item @file{.texi} @tab Texinfo
1009 @item @file{.texinfo} @tab Texinfo
1010 @item @file{.xml} @tab HTML
1014 Si usa la misma extensión para el archivo de entrada que la que usa
1015 @command{lilypond-book} para el archivo de salida, y si el archivo de
1016 entrada está en el mismo directorio que el directorio de trabajo de
1017 @command{lilypond-book}, debe usar la opción @code{--output} para que
1018 funcione @command{lilypond-book}, pues en caso contrario saldrá con un
1019 mensaje de error como @qq{La salida sobreescribirá al archivo de
1023 @node Alternate methods of mixing text and music
1024 @section Alternative methods of mixing text and music
1026 Esta sección presenta métodos para integrar texto y música distintos
1027 del método automatizado con @command{lilypond-book}.
1030 * Many quotes from a large score::
1031 * Inserting LilyPond output into OpenOffice.org::
1032 * Inserting LilyPond output into other programs::
1035 @node Many quotes from a large score
1036 @unnumberedsubsec Many quotes from a large score
1038 Si tiene que citar muchos fragmentos extraídos de una partitura grade,
1039 puede también usar la capacidad de recorte de sistemas, véase
1040 @ruser{Extracting fragments of music}.
1043 @node Inserting LilyPond output into OpenOffice.org
1044 @unnumberedsubsec Inserting LilyPond output into OpenOffice.org
1046 @cindex OpenOffice.org
1048 Se puede añadir notación de LilyPond a los documentos de
1050 @uref{http://@/ooolilypond@/.sourceforge@/.net@/,OOoLilyPond}.
1053 @node Inserting LilyPond output into other programs
1054 @unnumberedsubsec Inserting LilyPond output into other programs
1056 Para insertar la salida de LilyPond dentro de otros programas, use
1057 @code{lilypond} en vez de @code{lilypond-book}. Cada ejemplo debe
1058 crearse individualmente y añadirse al documento; consulte la
1059 documentación del programa correspondiente. La mayoría de los
1060 programas podrán insertar la salida de LilyPond en los formatos
1061 @file{PNG}, @file{EPS} o @file{PDF}.
1063 Para reducir el espacio vacío alrededor de la partitura de LilyPond,
1064 utilice las siguientes opciones:
1072 bookTitleMarkup = ##f
1073 scoreTitleMarkup = ##f
1079 Para obtener un archivo @file{EPS} que sea útil, utilice
1082 lilypond -dbackend=eps -dno-gs-load-fonts -dinclude-eps-fonts miarchivo.ly
1085 lilypond -dbackend=eps -dno-gs-load-fonts -dinclude-eps-fonts --png miarchivo.ly