1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
2 @c This file is part of lilypond-program.tely
4 Translation of GIT committish: 1de1bd7dd269ff09fc7566c2e240555347f52b65
6 When revising a translation, copy the HEAD committish of the
7 version that you are working on. See TRANSLATION for details.
11 @c Note: keep this node named so that `info lilypond-book' brings you here.
13 @chapter @command{lilypond-book}: Integrating text and music
15 Si quiere añadir imágenes de música a un documento, puede hacerlo
16 simplemente de la forma en que lo haría con otros tipos de imágenes.
17 Las imágenes se crean por separado, dando como resultado una salida
18 PostScript o imágenes PNG, y luego se incluyen en un documento de
21 @command{lilypond-book} ofrece una manera de automatizar este proceso:
22 este programa extrae los fragmentos de música del documento, ejecuta
23 @command{lilypond} sobre cada uno de ellos, y devuelve como salida el
24 documento con la música sustituida por las imágenes. Las definiciones
25 de ancho de línea y tamaño de letra de la música se ajustan de forma
26 que coincidan con los ajustes de su documento.
28 Es un programa distinto a @command{lilypond} propiamente dicho, y se
29 ejecuta sobre la línea de órdenes; para ver más información, consulte
30 @ref{Command-line usage}.
32 Este procedimiento se puede aplicar a documentos de @LaTeX{}, HTML,
40 @cindex documentos, insertar música en
41 @cindex HTML, música dentro de
42 @cindex Texinfo, música dentro de
43 @cindex DocBook, música dentro de
44 @cindex @LaTeX{}, música dentro de
47 * An example of a musicological document::
48 * Integrating music and text::
49 * Music fragment options::
50 * Invoking lilypond-book::
51 * Filename extensions::
52 * Alternate methods of mixing text and music::
56 @node An example of a musicological document
57 @section An example of a musicological document
60 Ciertos textos contienen ejemplos musicales. Son tratados musicales,
61 cancioneros o manuales como este mismo. Estos textos se pueden hacer
62 a mano, importando simplemente una imagen en formato PostScript en el
63 editor de textos. Sin embargo, hay un procedimiento automático para
64 reducir la carga de trabajo que esto implica los documentos de HTML,
65 @LaTeX{}, Texinfo y DocBook.
67 Un guión ejecutable llamado @code{lilypond-book} extrae los fragmentos
68 de música, les da formato y vuelve a poner en su lugar la partitura
69 resultante. A continuación presentamos un pequeño ejemplo de su
70 utilización con @LaTeX{}. El ejemplo contiene también texto
71 explicativo, por lo que no vamos a comentarlo posteriormente.
77 \documentclass[a4paper]{article}
81 Los documentos para \verb+lilypond-book+ pueden mezclar libremente
82 música y texto. Por ejemplo:
86 c2 g'2 \times 2/3 { f8 e d } c'2 g4
90 Las opciones se escriben entre corchetes.
92 \begin[fragment,quote,staffsize=26,verbatim]{lilypond}
96 Los ejemplos grandes se pueden grabar en archivos separados e
97 introducirse con \verb+\lilypondfile+.
99 \lilypondfile[quote,noindent]{screech-boink.ly}
101 (Si es necesario, sustituya screech-boink.ly por cualquier archivo .ly
102 situado en el mismo directorio que este archivo.)
108 @subheading Processing
110 Guarde el código anterior como un archivo llamado
111 @file{lilybook.lytex}, y luego ejecute en un terminal:
113 @c keep space after @version{} so TeX doesn't choke
115 lilypond-book --output=out --pdf lilybook.lytex
116 @emph{lilypond-book (GNU LilyPond) @version{} }
117 @emph{Leyendo lilybook.lytex...}
118 @emph{..montañas de mensajes suprimidos..}
119 @emph{Compilando lilybook.tex...}
122 @emph{..montañas de mensajes suprimidos..}
124 @emph{(sustituya @command{xpdf} por su visor de PDF favorito)}
127 La ejecución de @command{lilypond-book} y @command{latex} crea un gran
128 número de archivos temporales, que podrían abarrotar el directorio de
129 trabajo. Para poner remedio a esto utilice la opción
130 @code{--output=@var{directorio}}. Creará los archivos en un subdirectorio
131 aparte @file{directorio}.
133 Finalmente el resultado del ejemplo de @LaTeX{} que acabamos de
134 mostrar@footnote{Este tutorial se procesa con Texinfo, por lo que el
135 ejemplo presenta un resultado en la disposición ligeramente
136 distinto.}. Así acaba la sección del tutorial.
142 Los documentos para @command{lilypond-book} pueden mezclar libremente
143 música y texto. Por ejemplo:
147 c2 g'2 \times 2/3 { f8 e d } c'2 g4
151 Las opciones se escriben entre corchetes.
153 @lilypond[fragment,quote,staffsize=26,verbatim]
157 Los ejemplos grandes se pueden grabar en archivos separados e
158 introducirse con @code{\lilypondfile}.
160 @lilypondfile[quote,noindent]{screech-boink.ly}
165 @node Integrating music and text
166 @section Integrating music and text
168 Aquí vamos a explicar cómo integrar LilyPond con algunos otros
181 @LaTeX{} es el estándar de facto para la publicación en el mundo de
182 las ciencias exactas. Está construido encima del motor de composición
183 tipográfica @TeX{}, proporcionando la tipografía de mejor calidad que
187 @uref{http://@/www@/.ctan@/.org/@/tex@/-archive/@/info/@/lshort/@/english/,
188 @emph{The Not So Short Introduction to @LaTeX{}}} (Introducción no tan
189 breve a @LaTeX{}) para ver una panorámica sobre cómo usar @LaTeX{}.
191 La música se introduce usando
194 \begin[las,opciones,van,aquí]@{lilypond@}
195 EL CÓDIGO DE LILYPOND
203 \lilypondfile[las,opciones,van,aquí]@{@var{archivo}@}
210 \lilypond@{ EL CÓDIGO DE LILYPOND @}
213 La ejecución de @command{lilypond-book} deja como resultado un archivo
214 que se puede procesar posteriormente con @LaTeX{}.
216 A continuación mostramos algunos ejemplos. El entorno @code{lilypond}
219 \begin[quote,fragment,staffsize=26]@{lilypond@}
227 @lilypond[quote,fragment,staffsize=26]
234 \lilypond[quote,fragment,staffsize=11]@{<c' e' g'>@}
240 @lilypond[quote,fragment,staffsize=11]{<c' e' g'>}
243 Por el momento no es posible incluir llaves @code{@{} o @code{@}}
244 dentro de @code{\lilypond@{@}}, así que esta instrucción solamente es
245 útil con la opción @code{fragment}.
247 El ancho predeterminado de las líneas de música se ajusta mediante el
248 examen de las instrucciones del preámbulo del documento, la parte del
249 documento que está antes de @code{\begin@{document@}}. La instrucción
250 @command{lilypond-book} los envía a @LaTeX{} para averiguar la anchura
251 del texto. El ancho de la línea para los fragmentos de música se
252 ajusta entonces al ancho del texto. Observe que este algoritmo
253 heurístico puede fácilmente fallar; en estos casos es necesario usar
254 la opción @code{line-width} del fragmento de música.
256 @cindex títulos y lilypond-book
257 @cindex \header dentro de documentos @LaTeX{}
259 Cada fragmento ejecutará los macros siguientes si han sido definidos
263 @item @code{\preLilyPondExample} que se llama antes de la música,
265 @item @code{\postLilyPondExample} que se llama después de la música,
267 @item @code{\betweenLilyPondSystem[1]} se llama entre los sistemas si
268 @code{lilypond-book} ha dividido el fragmento en varios archivos
269 PostScript. Se debe definir de forma que tome un parámetro y recibirá
270 el número de archivos ya incluidos dentro del fragmento actual. La
271 acción predeterminada es simplemente insertar un @code{\linebreak}.
277 @cindex Latex, feta symbols
280 To include feta symbols (such as flat, segno, etc) in a LaTeX
281 document, use @code{\input@{titledefs@}}
284 \documentclass[a4paper]@{article@}
295 The font symbol names are defined in the file feta20.tex; to find
296 the location of this file, use the command
306 A veces es útil mostrar elementos de música (como ligaduras) como si
307 continuasen más allá del final del fragmento. Esto se puede hacer
308 dividiendo el pentagrama y suprimiendo la inclusión del resto de la
311 En @LaTeX{}, defina @code{\betweenLilyPondSystem} de tal forma que la
312 la inclusión de otros sistemas se dé por terminada una vez que se ha
313 alcanzado el número deseado de sistemas requeridos. Puesto que
314 @code{\betweenLilypondSystem} se llama en primer lugar @emph{después}
315 del primer sistema, incluir solamente el primer sistema es algo
319 \def\betweenLilyPondSystem#1@{\endinput@}
321 \begin[fragment]@{lilypond@}
322 c'1\( e'( c'~ \break c' d) e f\)
326 Si se necesita un mayor número de sistemas, se tiene que usar un
327 condicional de @TeX{} antes del @code{\endinput}. En este ejemplo,
328 sustituya el @q{2} por el número de sistemas que quiere en la salida:
331 \def\betweenLilyPondSystem#1@{
332 \ifnum##1<2\else\endinput\fi
336 Recuerde que la definición de @code{\betweenLilyPondSystem} es
337 efectiva hasta que @TeX{} abandona el grupo actual (como el entorno
338 @LaTeX{}) o se sobreescribe por otra definición (lo que casi siempre
339 es por el resto del documento). Para reponer la definición, escriba
342 \let\betweenLilyPondSystem\undefined
346 dentro de la fuente de @LaTeX{}.
348 Se puede simplificar esto definiendo un macro de @TeX{}:
351 \def\onlyFirstNSystems#1@{
352 \def\betweenLilyPondSystem##1@{\ifnum##1<#1\else\endinput\fi@}
357 y luego diciendo solamente cuántos sistemas quiere antes de cada
361 \onlyFirstNSystems@{3@}
362 \begin@{lilypond@}...\end@{lilypond@}
363 \onlyFirstNSystems@{1@}
364 \begin@{lilypond@}...\end@{lilypond@}
368 Hay opciones de línea de órdenes específicas de
369 @command{lilypond-book} y otros detalles que conocer para procesar
370 documentos de@LaTeX{} véase @ref{Invoking lilypond-book}.
376 Texinfo es el formato estándar para la documentación del proyecto GNU.
377 Este mismo manual es un ejemplo de documento Texinfo. Las versiones
378 HTML, PDF e Info del manual se hacen a partir del documento Texinfo.
381 En el archivo de entrada, la música se especifica con
384 @@lilypond[las,opciones,van,aquí]
385 EL CÓDIGO DE LILYPOND
393 @@lilypond[las,opciones,van,aquí]@{ EL CÓDIGO DE LILYPOND @}
400 @@lilypondfile[las,opciones,van,aquí]@{@var{archivo}@}
403 Cuando se ejecuta @command{lilypond-book} sobre el archivo, se obtiene
404 como resultado un archivo Texinfo (con la extensión @file{.texi}) que
405 contiene etiquetas @code{@@image} para el HTML, Info y la salida
406 impresa. @command{lilypond-book} genera imágenes de la música en
407 formatos EPS y PDF para usarlos en la salida impresa, y en formato PNG
408 para usarlos en las salidas HTML e Info.
410 Aquí podemos ver dos ejemplos sencillos. Un entorno @code{lilypond}
428 @@lilypond[fragment,staffsize=11]@{<c' e' g'>@}
434 @lilypond[fragment,staffsize=11]{<c' e' g'>}
436 No como @LaTeX{}, @code{@@lilypond@{...@}} no genera una imagen en
437 línea. Siempre consiste en un párrafo para ella sola.
443 La música se introduce usando
446 <lilypond fragment relative=2>
447 \key c \minor c4 es g2
452 @command{lilypond-book} entonces produce un archivo HTML con las
453 etiquetas de imagen adecuadas para los fragmentos de música:
455 @lilypond[fragment,relative=2]
456 \key c \minor c4 es g2
459 Para imágenes en línea, utilice @code{<lilypond ... />}, donde las
460 opciones están separadas de la música por el símbolo de dos puntos,
464 Algo de música dentro de <lilypond relative=2: a b c/> una línea de texto.
467 Para incluir archivos externos, escriba
470 <lilypondfile @var{opción1} @var{opción2} ...>@var{archivo}</lilypondfile>
473 @cindex títulos en HTML
474 @cindex vista previa, imagen
480 Para insertad fragmentos de LilyPond es bueno tratar de mantener la
481 conformidad del documento de DocBook, permitiendo así el uso de
482 editores de DocBook, validación, etc. Así pues, no usamos etiquetas
483 personalizadas, sólo especificamos una convención basada en los
484 elementos estándar de DocBook.
486 @subheading Common conventions
488 Para insertar toda clase de fragmentos utilizamos los elementos
489 @code{mediaobject} y @code{inlinemediaobject}, de forma que nuestros
490 fragmentos puedan ser formateados en línea o no en línea. Las
491 opciones de formateo del fragmento se escriben siempre dentro de la
492 propiedad @code{role} del elemento más interno (véanse las secciones
493 siguientes). Las etiquetas se eligen de forma que permitan a los
494 editores de DocBook formatear el contenido satisfactoriamente. Los
495 archivos de DocBook que se van a procesar con @command{lilypond-book}
496 deben tener la extensión @file{.lyxml}.
498 @subheading Including a LilyPond file
500 Este es el caso más sencillo. Debemos usar la extensión @file{.ly}
501 para el archivo incluido, e insertarlo como un @code{imageobject}
502 estándar, con la estructura siguiente:
507 <imagedata fileref="music1.ly" role="printfilename" />
512 Observe que puede usar mediaobject o inlinemediaobject como el
513 elemento más externo, a elección suya.
515 @subheading Including LilyPond code
517 Se puede incluir código de LilyPond mediante la utilización de un
518 elemento @code{programlisting}, en que el lenguaje se establece como
519 @code{lilypond} con la estructura siguiente:
524 <programlisting language="lilypond" role="fragment verbatim staffsize=16 ragged-right relative=2">
525 \context Staff \with @{
526 \remove Time_signature_engraver
527 \remove Clef_engraver@}
534 Como puede ver, el elemento más externo es un @code{mediaobject} o un
535 @code{inlinemediaobject}, y hay un elemento @code{textobject} que
536 lleva el @code{programlisting} en su interior.
538 @subheading Processing the DocBook document
540 Al ejecutar @command{lilypond-book} sobre el archivo @file{.lyxml} se
541 creará un documento de DocBook válido que se puede procesar
542 posteriormente con la extensión @file{.xml}. Si usa
543 @uref{http://@/dblatex@/.sourceforge@/.net@/,dblatex}, creará un
544 archivo PDF a partir de este documento automáticamente. Para la
545 generación de HTML (HTML Help, JavaHelp, etc.) puede usar las hojas de
546 estilo oficiales XSL de DocBook, aunque es posible que tenga que
547 aplicarles algún tipo de personalización.
550 @node Music fragment options
551 @section Music fragment options
553 Durante los próximos párrafos, una @q{instrucción de LilyPond} se
554 refiere a cualquier instrucción descrita en las secciones anteriores
555 que se maneja por parte de @command{lilypond-book} para que produzca
556 un fragmento de música. Por simplicidad, las instrucciones de
557 LilyPond solamente se muestran en la sintaxis de @LaTeX{}.
559 Observe que la cadena de opciones se analiza de izquierda a derecha;
560 si una opción aparece varias veces, se toma la última solamente.
562 Están disponibles las siguientes opciones para las instrucciones de
566 @item staffsize=@var{altura}
567 Establecer la altura del pentagrama como @var{altura}, medida en
571 Producir líneas no justificadas por la derecha y con espaciado
572 natural, es decir, se añade @code{ragged-right = ##t} al fragmento de
573 LilyPond. Esta es la opción predeterminada para la instrucción
574 @code{\lilypond@{@}} si no está presente la opción @code{line-width}.
575 También es la opción predeterminada para el entorno @code{lilypond} si
576 está establecida la opción @code{fragment}, y no se especifica la
577 anchura de la línea explícitamente.
579 @c does this option still exist in lilypond? -jm
581 Producir líneas con el espaciado empaquetado, es decir, se añade
582 @code{packed = ##t} al fragmento de código de LilyPond.
585 @itemx line-width=@var{tamaño}\@var{unidades}
586 Establecer el ancho de línea como @var{tamaño}, utilizando
587 @var{unidades} como unidad. @var{unidades} es una de las siguientes
588 cadenas: @code{cm}, @code{mm}, @code{in} o @code{pt}. Esta opción
589 afecta a la salida de LilyPond (esto es, a la longitud del pentagrama
590 del fragmento musical), no al formato del texto.
592 Si se usa sin ningún argumento, se establece el ancho de la línea a un
593 valor predeterminado (calculado con un algoritmo heurístico).
595 Si no se da ninguna opción @code{line-width}, @command{lilypond-book}
596 trata de adivinar un valor predeterminado para los entornos
597 @code{lilypond} que no usan la opción @code{ragged-right}.
600 No imprimir la indicación de compás, y desactivar las indicaciones
601 temporales de la música (armadura y líneas divisorias).
604 Hacer que @command{lilypond-book} añada algunos códigos necesarios
605 para que podamos escribir simplemente, por ejemplo,
612 sin @code{\layout}, @code{\score}, etc.
615 No añadir escribir el código adicional que completa la sintaxis de
616 LilyPond en los fragmentos de música. Al ser la opción
617 predeterminada, @code{nofragment} normalmente es redundante.
619 @item indent=@var{tamaño}\@var{unidades}
620 Establecer el sangrado del primer sistema de pentagramas como
621 @var{tamaño}, utilizando @var{unidades} como unidad. @var{unidades} es
622 una de las siguientes cadenas: @code{cm}, @code{mm}, @code{in} o
623 @code{pt}. Esta opción afecta a LilyPond, no al formato del texto.
626 Establecer el sangrado del primer sistema de la música como cero.
627 Esta opción afecta a LilyPond, no al formato del texto. Puesto que el
628 valor predeterminado es que no haya ningún sangrado, @code{noindent}
629 normalmente es redundante.
632 Reducir la longitud de la línea de un fragmento musical en
633 @math{2*0.4}@dmn{in} (pulgadas) y colocar la salida dentro de un
634 bloque de cita (quotation). El valor de @q{0.4@dmn{in}} se puede
635 controlar con la opción @code{exampleindent}.
638 Establecer la longitud del sangrado que la opción @code{quote} aplica
639 al fragmento musical.
642 @itemx relative=@var{n}
643 Usar el modo de octava relativa. De forma predeterminada, las notas
644 se especifican con relación al Do@tie{}central. El argumento entero
645 opcional especifica la octava de la nota inicial, donde el valor
646 predeterminado @code{1} es el Do central.
649 LilyPond utiliza también @command{lilypond-book} para producir su
650 propia documentación. Para hacerlo, están a nuestra disposición
651 ciertas opciones algo esotéricas para los fragmentos musicales.
655 El argumento de una instrucción de LilyPond se copia al archivo de
656 salida y se incluye dentro de un bloque «verbatim» o preformateado,
657 seguido del texto que se escriba con la opción @code{intertext} (que
658 no funciona aún); después se imprime la música en sí. Esta opción no
659 funciona bien con @code{\lilypond@{@}} si forma parte de un párrafo.
661 Si se usa la opción @code{verbatim} dentro de una instrucción
662 @code{lilypondfile}, es posible incluir con estilo preformateado sólo
663 una parte del archivo fuente. Si el archivo de código fuente contiene
664 un comentario que contiene @samp{begin verbatim} (sin las comillas),
665 la cita del bloque de estilo preformateado empezará después de la
666 última vez que aparezca este comentario; de forma similar, la cita del
667 bloque preformateado se detendrá justo antes de la primera vez que
668 aparezca un comentario que contenga @samp{end verbatim}, si lo hay.
669 En el siguiente ejemplo de código fuente, la música se interpreta en
670 el modo relativo, pero la cita preformateada no presentará el bloque
671 @code{relative}, es decir
674 \relative c' @{ % begin verbatim
681 se imprimirá como un bloque preformateado como
689 (Sólo para la salida de Texinfo.) Anteponer la línea @code{\version
690 @@w@{"@@version@{@}"@}} a la salida de @code{verbatim}.
693 (Sólo para la salida de Texinfo.) Si se llama a @command{lilypond}
694 con la opción @option{--header=@/texidoc}, y el archivo que se procesa
695 se llama @file{fulanito@/.ly}, crea un archivo
696 @file{fulanito@/.texidoc} si existe un campo @code{texidoc} dentro del
697 bloque @code{\header} de cabecera. La opción @code{texidoc} hace que
698 @command{lilypond-book} incluya estos archivos, añadiendo su contenido
699 como un bloque de documentación inmediatamente antes del fragmento
702 Suponiendo que el archivo @file{fulanito@/.ly} contiene
706 texidoc = "Este archivo es un ejemplo de una sola nota."
712 y que tenemos lo siguiente en nuestro documento de Texinfo
713 @file{prueba.texinfo}
716 @@lilypondfile[texidoc]@{fulanito.ly@}
720 la siguiente orden da como salida el resultado esperado:
723 lilypond-book --process="lilypond --format=tex --tex \
724 --header=texidoc prueba.texinfo
727 La mayoría de los documentos de prueba de LilyPond (en el directorio
728 @file{input} de la distribución) son pequeños archivos @file{.ly} que
729 tienen exactamente este aspecto.
732 (Sólo para la salida de Texinfo.) Esta opción es similar a quote,
733 pero se pone dentro del bloque de cita solamente el fragmento de
734 música (y el bloque preformateado que se da en la opción
735 @code{verbatim}). Esta opción es útil si queremos citar
736 (@code{quote}) el fragmento musical pero no el bloque de documentación
740 Si un archivo de entrada de LilyPond se incluye con
741 @code{\lilypondfile}, imprimir el nombre del archivo inmediatamente
742 antes del fragmento musical. Para la salida HTML, esto es un enlace.
743 Sólo se imprime el nombre base del archivo, es decir, se elimina la
744 parte del directorio de la ruta del archivo.
747 Esta opción incluye las fuentes tipográficas en todos los archivos EPS
748 generados para este fragmento. Se debe usar si el fragmento usa
749 cualquier tipografía que LaTeX no es capaz de encontrar por sí solo.
754 @node Invoking lilypond-book
755 @section Invoking @command{lilypond-book}
757 @command{lilypond-book} produce un archivo con una de las siguientes
758 extensiones: @file{.tex}, @file{.texi}, @file{.html} o @file{.xml},
759 dependiendo del formato de salida. Todos los archivos @file{.tex},
760 @file{.texi} y @file{.xml} necesitan un procesado posterior.
762 @command{lilypond-book} también puede crear un archivo
763 @file{.psfonts}, que se requiere por parte de @command{dvips} para
764 producir archivos PostScript y PDF.
766 @subheading Format-specific instructions
768 @subsubheading @LaTeX{}
770 Hay dos formas de procesar el documento en @LaTeX{} para su impresión
771 o publicación: hacer un archivo PDF directamente con PDF@LaTeX{}, o
772 generar un archivo PostScript con @LaTeX{} a través de un traductor de
773 DVI a PostScript como @command{dvips}. la primera forma es más
774 sencilla y es la que se recomienda@footnote{Observe que PDF@LaTeX{} y
775 @LaTeX{} podrían no ser utilizables para compilar cualquier documento
776 @LaTeX{}, y es por lo que explicamos las dos formas.}, y cualquiera
777 que sea el método que utilice, podrá convertir fácilmente entre
778 PostScript y PDF con herramientas como @command{ps2pdf} y
779 @command{pdf2ps} que vienen incluidas con Ghostscript.
781 Para producir un archivo PDF por medio de PDF@LaTeX{}, utilice
784 lilypond-book --pdf miarchivo.pdftex
785 pdflatex miarchivo.tex
788 @cindex tipografías de outline
789 @cindex type1, tipografías
791 @cindex invocación de dvips
793 Para producir una salida PDF por medio de
794 @LaTeX{}/@command{dvips}/@command{ps2pdf}, debe hacer
797 lilypond-book --psfonts miarchivo.lytex
799 dvips -o -h miarchivo.psfonts -Ppdf miarchivo.dvi
804 El archivo @file{.dvi} creado por este proceso no contiene las cabezas
805 de las notas. Esto es normal; si sigue las instrucciones, las cabezas
806 aparecerán en los archivos @file{.ps} y @file{.pdf}.
808 La ejecución de @command{dvips} dará como resultado algunas
809 advertencias sobre las fuentes tipográficas; son inocuas y se pueden
810 ignorar. Si está ejecutando @command{latex} en modo de dos columnas,
811 recuerde añadir @code{-t landscape} a las opciones de @command{dvips}.
813 @subsubheading Texinfo
815 Para producir un documento de Texinfo (en cualquier formato de
816 salida), siga el procedimiento normal para Texinfo, esto es: o bien
817 llame a @command{texi2pdf} o a @command{texi2dvi} o a
818 @command{makeinfo}, según el formato de la salida que quiera crear.
820 @xref{Format with texi2dvi, , , texinfo, GNU Texinfo}, y @ref{Creating
821 an Info File, , , texinfo, GNU Texinfo}.
824 Consulte la documentación de Texinfo para ver más detalles.
828 @subheading Command line options
830 @command{lilypond-book} acepta las siguientes opciones de la línea de
834 @item -f @var{formato}
835 @itemx --format=@var{formato}
836 Especificar el tipo del documento que se va a procesar: @code{html},
837 @code{latex}, @code{texi} (predeterminado) o @code{docbook}. Si falta
838 esta opción, @command{lilypond-book} tratará de detectar el formato
839 automáticamente, véase @ref{Filename extensions}. Por el momento,
840 @code{texi} es lo mismo que @code{texi-html}.
842 @c This complicated detail is not implemented, comment it out -jm
844 The @code{texi} document type produces a Texinfo file with music
845 fragments in the printed output only. For getting images in the HTML
846 version, the format @code{texi-html} must be used instead.
849 @item -F @var{filtro}
850 @itemx --filter=@var{filtro}
851 Conducir los fragmentos a través de @var{filter} por medio de una
852 tubería. @code{lilypond-book} no obedecerá --filter y --process al
853 mismo tiempo. Por ejemplo,
856 lilypond-book --filter='convert-ly --from=2.0.0 -' mi-libro.tely
861 Imprimir un breve mensaje de ayuda.
863 @item -I @var{directorio}
864 @itemx --include=@var{directorio}
865 Añadir @var{directorio} a la ruta de inclusión.
866 @command{lilypond-book} busca también los fragmentos ya compilados en
867 la ruta de inclusión, y no los vuelve a escribir en el directorio de
868 salida, así que en ciertos casos es necesario invocar instrucciones de
869 procesado posteriores como @command{makeinfo} o @command{latex} con
870 las mismas opciones @code{-I @var{directorio}}.
872 @item -o @var{directorio}
873 @itemx --output=@var{directorio}
874 Colocar los archivos generados en el @var{directorio}. La ejecución
875 de @command{lilypond-book} genera montañas de pequeños archivos que
876 luego procesará LilyPond. Para evitar toda esta parafernalia en el
877 mismo directorio que la fuente, utilice la opción @option{--output}, y
878 cambie a este directorio antes de ejecutar @command{latex} o
882 lilypond-book --output=out miarchivo.lytex
887 @itemx --left-padding=@var{cantidad}
888 Rellenar las cajas EPS en esta medida, alrededor. @var{cantidad} se
889 mide en milímetros, y es 3.0 como valor predeterminado. Esta opción
890 se debe usar si las líneas de música están muy pegadas al margen
893 El ancho de los sistemas que están muy ajustados dentro de su
894 rectángulo puede variar, debido a los elementos de notación que están
895 pegados al margen izquierdo, como los números de compás y el nombre
896 del instrumento. Esta opción acorta todas las líneas y las mueve a la
897 derecha en la misma medida.
900 @item -P @var{proceso}
901 @itemx --process=@var{instrucción}
902 Procesar los fragmentos de LilyPond utilizando @var{instrucción}. La
903 instrucción predeterminada es @code{lilypond}. @code{lilypond-book} no
904 obedecerá a @code{--filter} y a @code{--process} al mismo tiempo.
907 Crear archivos PDF para su uso con PDFLaTeX.
910 Extraer todas las tipografías PostScript en
911 @file{@var{archivo}.psfonts} para dvips. Esto es necesario para
912 @command{dvips -h @var{archivo}.psfonts}.
920 Imprimir la información de la versión.
925 La instrucción de Texinfo @code{@@pagesizes} no se interpreta. De
926 forma similar, las instrucciones de @LaTeX{} que cambian los márgenes
927 y anchos de línea después del preámbulo se ignoran.
929 Sólo se procesa el primer @code{\score} de un bloque LilyPond.
932 @node Filename extensions
933 @section Filename extensions
935 Puede usar cualquier extensión para el nombre del archivo de entrada,
936 pero si no usa la extensión recomendada para un formato en particular
937 tendrá que especificar manualmente el formato de salida; para ver más
938 detalles, consulte @ref{Invoking lilypond-book}. En caso contrario,
939 @command{lilypond-book} selecciona automáticamente el formato de
940 salida basándose en la extensión del nombre del archivo de entrada.
943 @multitable @columnfractions .2 .5
944 @item @strong{extensión} @tab @strong{formato de salida}
946 @item @file{.html} @tab HTML
947 @item @file{.itely} @tab Texinfo
948 @item @file{.latex} @tab @LaTeX{}
949 @item @file{.lytex} @tab @LaTeX{}
950 @item @file{.lyxml} @tab DocBook
951 @item @file{.tely} @tab Texinfo
952 @item @file{.tex} @tab @LaTeX{}
953 @item @file{.texi} @tab Texinfo
954 @item @file{.texinfo} @tab Texinfo
955 @item @file{.xml} @tab HTML
959 Si usa la misma extensión para el archivo de entrada que la que usa
960 @command{lilypond-book} para el archivo de salida, y si el archivo de
961 entrada está en el mismo directorio que el directorio de trabajo de
962 @command{lilypond-book}, debe usar la opción @code{--output} para que
963 funcione @command{lilypond-book}, pues en caso contrario saldrá con un
964 mensaje de error como @qq{La salida sobreescribirá al archivo de
968 @node Alternate methods of mixing text and music
969 @section Alternative methods of mixing text and music
971 Esta sección presenta métodos para integrar texto y música distintos
972 del método automatizado con @command{lilypond-book}.
975 * Many quotes from a large score::
976 * Inserting LilyPond output into OpenOffice.org::
977 * Inserting LilyPond output into other programs::
980 @node Many quotes from a large score
981 @subsection Many quotes from a large score
983 Si tiene que citar muchos fragmentos extraídos de una partitura grade,
984 puede también usar la capacidad de recorte de sistemas, véase
985 @ruser{Extracting fragments of notation}.
988 @node Inserting LilyPond output into OpenOffice.org
989 @subsection Inserting LilyPond output into OpenOffice.org
991 @cindex OpenOffice.org
993 Se puede añadir notación de LilyPond a los documentos de
995 @uref{http://@/ooolilypond@/.sourceforge@/.net@/,OOoLilyPond}.
998 @node Inserting LilyPond output into other programs
999 @subsection Inserting LilyPond output into other programs
1001 Para insertar la salida de LilyPond dentro de otros programas, use
1002 @code{lilypond} en vez de @code{lilypond-book}. Cada ejemplo debe
1003 crearse individualmente y añadirse al documento; consulte la
1004 documentación del programa correspondiente. La mayoría de los
1005 programas podrán insertar la salida de LilyPond en los formatos
1006 @file{PNG}, @file{EPS} o @file{PDF}.
1008 Para reducir el espacio vacío alrededor de la partitura de LilyPond,
1009 utilice las siguientes opciones:
1017 bookTitleMarkup = ##f
1018 scoreTitleMarkup = ##f
1024 Para obtener un archivo EPS que sea útil, utilice
1027 lilypond -dbackend=eps -dno-gs-load-fonts -dinclude-eps-fonts miarchivo.ly