1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
2 @c This file is part of lilypond-program.tely
4 Translation of GIT committish: 41ef91786a08102d9b9a839f6a2f40cec263d723
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@}
376 Hay opciones de línea de órdenes específicas de
377 @command{lilypond-book} y otros detalles que conocer para procesar
378 documentos de@LaTeX{} véase @ref{Invoking lilypond-book}.
384 Texinfo es el formato estándar para la documentación del proyecto GNU.
385 Este mismo manual es un ejemplo de documento Texinfo. Las versiones
386 HTML, PDF e Info del manual se hacen a partir del documento Texinfo.
389 En el archivo de entrada, la música se especifica con
392 @@lilypond[las,opciones,van,aquí]
393 EL CÓDIGO DE LILYPOND
401 @@lilypond[las,opciones,van,aquí]@{ EL CÓDIGO DE LILYPOND @}
408 @@lilypondfile[las,opciones,van,aquí]@{@var{archivo}@}
411 De forma adicional, @code{@@lilypondversion} imprime la versión actual
414 Cuando se ejecuta @command{lilypond-book} sobre el archivo, se obtiene
415 como resultado un archivo Texinfo (con la extensión @file{.texi}) que
416 contiene etiquetas @code{@@image} para el HTML, Info y la salida
417 impresa. @command{lilypond-book} genera imágenes de la música en
418 formatos EPS y PDF para usarlos en la salida impresa, y en formato PNG
419 para usarlos en las salidas HTML e Info.
421 Aquí podemos ver dos ejemplos sencillos. Un entorno @code{lilypond}
439 @@lilypond[fragment,staffsize=11]@{<c' e' g'>@}
445 @lilypond[fragment,staffsize=11]{<c' e' g'>}
447 No como @LaTeX{}, @code{@@lilypond@{...@}} no genera una imagen en
448 línea. Siempre consiste en un párrafo para ella sola.
454 La música se introduce usando
457 <lilypond fragment relative=2>
458 \key c \minor c4 es g2
463 @command{lilypond-book} entonces produce un archivo HTML con las
464 etiquetas de imagen adecuadas para los fragmentos de música:
466 @lilypond[fragment,relative=2]
467 \key c \minor c4 es g2
470 Para imágenes en línea, utilice @code{<lilypond ... />}, donde las
471 opciones están separadas de la música por el símbolo de dos puntos,
475 Algo de música dentro de <lilypond relative=2: a b c/> una línea de texto.
478 Para incluir archivos externos, escriba
481 <lilypondfile @var{opción1} @var{opción2} ...>@var{archivo}</lilypondfile>
484 De forma adicional, @code{<lilypondversion/>} imprime la versión
487 @cindex títulos en HTML
488 @cindex vista previa, imagen
494 Para insertad fragmentos de LilyPond es bueno tratar de mantener la
495 conformidad del documento de DocBook, permitiendo así el uso de
496 editores de DocBook, validación, etc. Así pues, no usamos etiquetas
497 personalizadas, sólo especificamos una convención basada en los
498 elementos estándar de DocBook.
500 @subheading Common conventions
502 Para insertar toda clase de fragmentos utilizamos los elementos
503 @code{mediaobject} y @code{inlinemediaobject}, de forma que nuestros
504 fragmentos puedan ser formateados en línea o no en línea. Las
505 opciones de formateo del fragmento se escriben siempre dentro de la
506 propiedad @code{role} del elemento más interno (véanse las secciones
507 siguientes). Las etiquetas se eligen de forma que permitan a los
508 editores de DocBook formatear el contenido satisfactoriamente. Los
509 archivos de DocBook que se van a procesar con @command{lilypond-book}
510 deben tener la extensión @file{.lyxml}.
512 @subheading Including a LilyPond file
514 Este es el caso más sencillo. Debemos usar la extensión @file{.ly}
515 para el archivo incluido, e insertarlo como un @code{imageobject}
516 estándar, con la estructura siguiente:
521 <imagedata fileref="music1.ly" role="printfilename" />
526 Observe que puede usar mediaobject o inlinemediaobject como el
527 elemento más externo, a elección suya.
529 @subheading Including LilyPond code
531 Se puede incluir código de LilyPond mediante la utilización de un
532 elemento @code{programlisting}, en que el lenguaje se establece como
533 @code{lilypond} con la estructura siguiente:
538 <programlisting language="lilypond" role="fragment verbatim staffsize=16 ragged-right relative=2">
539 \context Staff \with @{
540 \remove Time_signature_engraver
541 \remove Clef_engraver@}
548 Como puede ver, el elemento más externo es un @code{mediaobject} o un
549 @code{inlinemediaobject}, y hay un elemento @code{textobject} que
550 lleva el @code{programlisting} en su interior.
552 @subheading Processing the DocBook document
554 Al ejecutar @command{lilypond-book} sobre el archivo @file{.lyxml} se
555 creará un documento de DocBook válido que se puede procesar
556 posteriormente con la extensión @file{.xml}. Si usa
557 @uref{http://@/dblatex@/.sourceforge@/.net@/,dblatex}, creará un
558 archivo PDF a partir de este documento automáticamente. Para la
559 generación de HTML (HTML Help, JavaHelp, etc.) puede usar las hojas de
560 estilo oficiales XSL de DocBook, aunque es posible que tenga que
561 aplicarles algún tipo de personalización.
564 @node Music fragment options
565 @section Music fragment options
567 Durante los próximos párrafos, una @q{instrucción de LilyPond} se
568 refiere a cualquier instrucción descrita en las secciones anteriores
569 que se maneja por parte de @command{lilypond-book} para que produzca
570 un fragmento de música. Por simplicidad, las instrucciones de
571 LilyPond solamente se muestran en la sintaxis de @LaTeX{}.
573 Observe que la cadena de opciones se analiza de izquierda a derecha;
574 si una opción aparece varias veces, se toma la última solamente.
576 Están disponibles las siguientes opciones para las instrucciones de
580 @item staffsize=@var{altura}
581 Establecer la altura del pentagrama como @var{altura}, medida en
585 Producir líneas no justificadas por la derecha y con espaciado
586 natural, es decir, se añade @code{ragged-right = ##t} al fragmento de
587 LilyPond. Esta es la opción predeterminada para la instrucción
588 @code{\lilypond@{@}} si no está presente la opción @code{line-width}.
589 También es la opción predeterminada para el entorno @code{lilypond} si
590 está establecida la opción @code{fragment}, y no se especifica la
591 anchura de la línea explícitamente.
594 Para fragmentos de una sola línea, permitir que la longitud del
595 pentagrama se amplíe hasta igualar la anchura de la línea, es decir,
596 se añade @code{ragged-right = ##f} al fragmento de LilyPond.
599 @itemx line-width=@var{tamaño}\@var{unidades}
600 Establecer el ancho de línea como @var{tamaño}, utilizando
601 @var{unidades} como unidad. @var{unidades} es una de las siguientes
602 cadenas: @code{cm}, @code{mm}, @code{in} o @code{pt}. Esta opción
603 afecta a la salida de LilyPond (esto es, a la longitud del pentagrama
604 del fragmento musical), no al formato del texto.
606 Si se usa sin ningún argumento, se establece el ancho de la línea a un
607 valor predeterminado (calculado con un algoritmo heurístico).
609 Si no se da ninguna opción @code{line-width}, @command{lilypond-book}
610 trata de adivinar un valor predeterminado para los entornos
611 @code{lilypond} que no usan la opción @code{ragged-right}.
614 No imprimir la indicación de compás, y desactivar las indicaciones
615 temporales de la música (indicación del compás y líneas divisorias).
618 Hacer que @command{lilypond-book} añada algunos códigos necesarios
619 para que podamos escribir simplemente, por ejemplo,
626 sin @code{\layout}, @code{\score}, etc.
629 No añadir escribir el código adicional que completa la sintaxis de
630 LilyPond en los fragmentos de música. Al ser la opción
631 predeterminada, @code{nofragment} normalmente es redundante.
633 @item indent=@var{tamaño}\@var{unidades}
634 Establecer el sangrado del primer sistema de pentagramas como
635 @var{tamaño}, utilizando @var{unidades} como unidad. @var{unidades} es
636 una de las siguientes cadenas: @code{cm}, @code{mm}, @code{in} o
637 @code{pt}. Esta opción afecta a LilyPond, no al formato del texto.
640 Establecer el sangrado del primer sistema de la música como cero.
641 Esta opción afecta a LilyPond, no al formato del texto. Puesto que el
642 valor predeterminado es que no haya ningún sangrado, @code{noindent}
643 normalmente es redundante.
646 Reducir la longitud de la línea de un fragmento musical en
647 @math{2*0.4}@dmn{in} (pulgadas) y colocar la salida dentro de un
648 bloque de cita (quotation). El valor de @q{0.4@dmn{in}} se puede
649 controlar con la opción @code{exampleindent}.
652 Establecer la longitud del sangrado que la opción @code{quote} aplica
653 al fragmento musical.
656 @itemx relative=@var{n}
657 Usar el modo de octava relativa. De forma predeterminada, las notas
658 se especifican con relación al Do@tie{}central. El argumento entero
659 opcional especifica la octava de la nota inicial, donde el valor
660 predeterminado @code{1} es el Do central. La opción @code{relative}
661 sólo funciona cuando está establecida la opción @code{fragment}, de
662 manera que @code{fragment} viene implicada automáticamente por
663 @code{relative}, independientemenre de la presencia de @code{fragment}
664 o de @code{nofragment} en la fuente.
668 LilyPond utiliza también @command{lilypond-book} para producir su
669 propia documentación. Para hacerlo, están a nuestra disposición
670 ciertas opciones algo esotéricas para los fragmentos musicales.
674 El argumento de una instrucción de LilyPond se copia al archivo de
675 salida y se incluye dentro de un bloque «verbatim» o preformateado,
676 seguido del texto que se escriba con la opción @code{intertext} (que
677 no funciona aún); después se imprime la música en sí. Esta opción no
678 funciona bien con @code{\lilypond@{@}} si forma parte de un párrafo.
680 Si se usa la opción @code{verbatim} dentro de una instrucción
681 @code{lilypondfile}, es posible incluir con estilo preformateado sólo
682 una parte del archivo fuente. Si el archivo de código fuente contiene
683 un comentario que contiene @samp{begin verbatim} (sin las comillas),
684 la cita del bloque de estilo preformateado empezará después de la
685 última vez que aparezca este comentario; de forma similar, la cita del
686 bloque preformateado se detendrá justo antes de la primera vez que
687 aparezca un comentario que contenga @samp{end verbatim}, si lo hay.
688 En el siguiente ejemplo de código fuente, la música se interpreta en
689 el modo relativo, pero la cita preformateada no presentará el bloque
690 @code{relative}, es decir
693 \relative c' @{ % begin verbatim
700 se imprimirá como un bloque preformateado como
708 Si queremos traducir los comentarios y los nombres de variable en la
709 salida literal pero no en el código fuente, podemos establecer el
710 valor de la variable de entorno @code{LYDOC_LOCALEDIR} a la ruta de un
711 directorio; este directorio debe contener un árbol de catálogos de
712 mensajes @file{.mo} con @code{lilypond-doc} como dominio.
715 (Sólo para la salida de Texinfo.) Anteponer la línea @code{\version
716 @@w@{"@@version@{@}"@}} a la salida de @code{verbatim}.
719 (Sólo para la salida de Texinfo.) Si se llama a @command{lilypond}
720 con la opción @option{--header=@/texidoc}, y el archivo que se procesa
721 se llama @file{fulanito@/.ly}, crea un archivo
722 @file{fulanito@/.texidoc} si existe un campo @code{texidoc} dentro del
723 bloque @code{\header} de cabecera. La opción @code{texidoc} hace que
724 @command{lilypond-book} incluya estos archivos, añadiendo su contenido
725 como un bloque de documentación inmediatamente antes del fragmento
728 Suponiendo que el archivo @file{fulanito@/.ly} contiene
732 texidoc = "Este archivo es un ejemplo de una sola nota."
738 y que tenemos lo siguiente en nuestro documento de Texinfo
739 @file{prueba.texinfo}
742 @@lilypondfile[texidoc]@{fulanito.ly@}
746 la siguiente orden da como salida el resultado esperado:
749 lilypond-book --pdf --process="lilypond \
750 -dbackend=eps --header=texidoc" test.texinfo
753 La mayoría de los documentos de prueba de LilyPond (en el directorio
754 @file{input} de la distribución) son pequeños archivos @file{.ly} que
755 tienen exactamente este aspecto.
757 Por motivos de localización de idioma, si el documento de Texinfo
758 contiene @code{@@documentlanguage @var{LANG}} y la cabecera de
759 @file{loquesea@/.ly} contiene un campo @code{texidoc@var{LANG}}, y
760 @command{lilypond} se ejecuta con
761 @option{--header=@/texidoc@var{LANG}}, entonces se incluirá
762 @file{loquesea@/.texidoc@var{LANG}} en lugar de
763 @file{loquesea@/.texidoc}.
766 (Sólo para la salida de Texinfo.) Esta opción es similar a quote,
767 pero se pone dentro del bloque de cita solamente el fragmento de
768 música (y el bloque preformateado que se da en la opción
769 @code{verbatim}). Esta opción es útil si queremos citar
770 (@code{quote}) el fragmento musical pero no el bloque de documentación
774 (Sólo para la salida de Texinfo.) Esta opción funciona de forma
775 parecida a la opción @code{texidoc}: si @command{lilypond} se llama
776 con la opción @option{--header=@/doctitle}, y el archivo que procesar
777 se llama @file{loquesea@/.ly} y contiene un campo @code{doctitle} en
778 el bloque @code{\header}, crea un archivo @file{loquesea@/.doctitle}.
779 Cuando se usa la opción @code{doctitle}, el contenido de
780 @file{loquesea@/.doctitle}, que debería ser una línea única de
781 @var{texto}, se inserta en el documento de Texinfo como
782 @code{@@lydoctitle @var{texto}}. @code{@@lydoctitle} debe ser un
783 macro definido en el documento de Texinfo. La misma indicación
784 referida al procesado de @code{texidoc} con idiomas localizados se
785 aplica a @code{doctitle}.
788 (Sólo para la salida de Texinfo.) No traducir los comentarios y
789 nombres de variable en el fragmento de código literal citado.
792 Si un archivo de entrada de LilyPond se incluye con
793 @code{\lilypondfile}, imprimir el nombre del archivo inmediatamente
794 antes del fragmento musical. Para la salida HTML, esto es un enlace.
795 Sólo se imprime el nombre base del archivo, es decir, se elimina la
796 parte del directorio de la ruta del archivo.
799 Esta opción incluye las fuentes tipográficas en todos los archivos EPS
800 generados para este fragmento. Se debe usar si el fragmento usa
801 cualquier tipografía que @LaTeX{} no es capaz de encontrar por sí
807 @node Invoking lilypond-book
808 @section Invoking @command{lilypond-book}
810 @command{lilypond-book} produce un archivo con una de las siguientes
811 extensiones: @file{.tex}, @file{.texi}, @file{.html} o @file{.xml},
812 dependiendo del formato de salida. Todos los archivos @file{.tex},
813 @file{.texi} y @file{.xml} necesitan un procesado posterior.
815 @subheading Format-specific instructions
817 @subsubheading @LaTeX{}
819 Hay dos formas de procesar el documento en @LaTeX{} para su impresión
820 o publicación: hacer un archivo PDF directamente con PDF@LaTeX{}, o
821 generar un archivo PostScript con @LaTeX{} a través de un traductor de
822 DVI a PostScript como @command{dvips}. la primera forma es más
823 sencilla y es la que se recomienda@footnote{Observe que PDF@LaTeX{} y
824 @LaTeX{} podrían no ser utilizables para compilar cualquier documento
825 @LaTeX{}, y es por lo que explicamos las dos formas.}, y cualquiera
826 que sea el método que utilice, podrá convertir fácilmente entre
827 PostScript y PDF con herramientas como @command{ps2pdf} y
828 @command{pdf2ps} que vienen incluidas con Ghostscript.
830 Para producir un archivo PDF por medio de PDF@LaTeX{}, utilice
833 lilypond-book --pdf miarchivo.pdftex
834 pdflatex miarchivo.tex
837 @cindex tipografías de outline
838 @cindex type1, tipografías
840 @cindex invocación de dvips
842 Para producir una salida PDF por medio de
843 @LaTeX{}/@command{dvips}/@command{ps2pdf}, debe hacer
846 lilypond-book miarchivo.lytex
848 dvips -Ppdf miarchivo.dvi
853 El archivo @file{.dvi} creado por este proceso no contiene las cabezas
854 de las notas. Esto es normal; si sigue las instrucciones, las cabezas
855 aparecerán en los archivos @file{.ps} y @file{.pdf}.
857 La ejecución de @command{dvips} puede dar como resultado algunas
858 advertencias sobre las fuentes tipográficas; son inocuas y se pueden
859 ignorar. Si está ejecutando @command{latex} en modo de dos columnas,
860 recuerde añadir @code{-t landscape} a las opciones de @command{dvips}.
862 @subsubheading Texinfo
864 Para producir un documento de Texinfo (en cualquier formato de
865 salida), siga el procedimiento normal para Texinfo, esto es: o bien
866 llame a @command{texi2pdf} o a @command{texi2dvi} o a
867 @command{makeinfo}, según el formato de la salida que quiera crear.
869 @xref{Format with texi2dvi, , , texinfo, GNU Texinfo}, y @ref{Creating
870 an Info File, , , texinfo, GNU Texinfo}.
873 Consulte la documentación de Texinfo para ver más detalles.
877 @subheading Command line options
879 @command{lilypond-book} acepta las siguientes opciones de la línea de
883 @item -f @var{formato}
884 @itemx --format=@var{formato}
885 Especificar el tipo del documento que se va a procesar: @code{html},
886 @code{latex}, @code{texi} (predeterminado) o @code{docbook}. Si falta
887 esta opción, @command{lilypond-book} tratará de detectar el formato
888 automáticamente, véase @ref{Filename extensions}. Por el momento,
889 @code{texi} es lo mismo que @code{texi-html}.
891 @c This complicated detail is not implemented, comment it out -jm
893 The @code{texi} document type produces a Texinfo file with music
894 fragments in the printed output only. For getting images in the HTML
895 version, the format @code{texi-html} must be used instead.
898 @item -F @var{filtro}
899 @itemx --filter=@var{filtro}
900 Conducir los fragmentos a través de @var{filter} por medio de una
901 tubería. @code{lilypond-book} no obedecerá --filter y --process al
902 mismo tiempo. Por ejemplo,
905 lilypond-book --filter='convert-ly --from=2.0.0 -' mi-libro.tely
910 Imprimir un breve mensaje de ayuda.
912 @item -I @var{directorio}
913 @itemx --include=@var{directorio}
914 Añadir @var{directorio} a la ruta de inclusión.
915 @command{lilypond-book} busca también los fragmentos ya compilados en
916 la ruta de inclusión, y no los vuelve a escribir en el directorio de
917 salida, así que en ciertos casos es necesario invocar instrucciones de
918 procesado posteriores como @command{makeinfo} o @command{latex} con
919 las mismas opciones @code{-I @var{directorio}}.
921 @item -o @var{directorio}
922 @itemx --output=@var{directorio}
923 Colocar los archivos generados en el @var{directorio}. La ejecución
924 de @command{lilypond-book} genera montañas de pequeños archivos que
925 luego procesará LilyPond. Para evitar toda esta parafernalia en el
926 mismo directorio que la fuente, utilice la opción @option{--output}, y
927 cambie a este directorio antes de ejecutar @command{latex} o
931 lilypond-book --output=out miarchivo.lytex
936 @itemx --skip-lily-check
937 Evitar el fracaso si no se encuentra ninguna salida de lilypond. Se
938 usa para la documentación de LilyPond en formato Info sin imágenes.
940 @itemx --skip-png-check
941 Evitar el fracaso si no se encuentran las imágenes PNG de los archivos
942 EPS. Se usa para la documentación de LilyPond en formato Info sin
945 @itemx --lily-output-dir=@var{directorio}
946 Escribir archivos lily-XXX en el directorio @var{directorio}, enlazar
947 en el directorio de @code{--output}. Use esta opción para ahorrar
948 tiempo de construcción para documentos de distintos directorios que
949 comparten muchos fragmentos idénticos de código.
951 @itemx --info-images-dir=@var{directorio}
952 Dar formato a la salida de Texinfo de manera que Info busque las
953 imágenes de música en @var{directorio}.
955 @itemx --latex-program=@var{prog}
956 Ejecutar el propgrama @command{prog} en vez de @command{latex}. Esto
957 es útil si nuestro documento se procesa con @command{xelatex}, por
960 @itemx --left-padding=@var{cantidad}
961 Rellenar las cajas EPS en esta medida, alrededor. @var{cantidad} se
962 mide en milímetros, y es 3.0 como valor predeterminado. Esta opción
963 se debe usar si las líneas de música están muy pegadas al margen
966 El ancho de un sistema que está muy ajustado dentro de su rectángulo
967 puede variar, debido a los elementos de notación que están pegados al
968 margen izquierdo, como los números de compás y el nombre del
969 instrumento. Esta opción acorta todas las líneas y las mueve a la
970 derecha en la misma medida.
973 @item -P @var{instrucción}
974 @itemx --process=@var{instrucción}
975 Procesar los fragmentos de LilyPond utilizando @var{instrucción}. La
976 instrucción predeterminada es @code{lilypond}. @code{lilypond-book} no
977 obedecerá a @code{--filter} y a @code{--process} al mismo tiempo.
980 Crear archivos PDF para su uso con PDF@LaTeX{}.
983 Extraer todas las tipografías PostScript en
984 @file{@var{archivo}.psfonts} para dvips. Esto es necesario para
985 @command{dvips -h @var{archivo}.psfonts}.
993 Imprimir la información de la versión.
998 La instrucción de Texinfo @code{@@pagesizes} no se interpreta. De
999 forma similar, las instrucciones de @LaTeX{} que cambian los márgenes
1000 y anchos de línea después del preámbulo se ignoran.
1002 Sólo se procesa el primer @code{\score} de un bloque LilyPond.
1005 @node Filename extensions
1006 @section Filename extensions
1008 Puede usar cualquier extensión para el nombre del archivo de entrada,
1009 pero si no usa la extensión recomendada para un formato en particular
1010 tendrá que especificar manualmente el formato de salida; para ver más
1011 detalles, consulte @ref{Invoking lilypond-book}. En caso contrario,
1012 @command{lilypond-book} selecciona automáticamente el formato de
1013 salida basándose en la extensión del nombre del archivo de entrada.
1016 @multitable @columnfractions .2 .5
1017 @item @strong{extensión} @tab @strong{formato de salida}
1019 @item @file{.html} @tab HTML
1020 @item @file{.itely} @tab Texinfo
1021 @item @file{.latex} @tab @LaTeX{}
1022 @item @file{.lytex} @tab @LaTeX{}
1023 @item @file{.lyxml} @tab DocBook
1024 @item @file{.tely} @tab Texinfo
1025 @item @file{.tex} @tab @LaTeX{}
1026 @item @file{.texi} @tab Texinfo
1027 @item @file{.texinfo} @tab Texinfo
1028 @item @file{.xml} @tab HTML
1032 Si usa la misma extensión para el archivo de entrada que la que usa
1033 @command{lilypond-book} para el archivo de salida, y si el archivo de
1034 entrada está en el mismo directorio que el directorio de trabajo de
1035 @command{lilypond-book}, debe usar la opción @code{--output} para que
1036 funcione @command{lilypond-book}, pues en caso contrario saldrá con un
1037 mensaje de error como @qq{La salida sobreescribirá al archivo de
1041 @node Alternate methods of mixing text and music
1042 @section Alternative methods of mixing text and music
1044 Esta sección presenta métodos para integrar texto y música distintos
1045 del método automatizado con @command{lilypond-book}.
1048 * Many quotes from a large score::
1049 * Inserting LilyPond output into OpenOffice.org::
1050 * Inserting LilyPond output into other programs::
1053 @node Many quotes from a large score
1054 @unnumberedsubsec Many quotes from a large score
1056 Si tiene que citar muchos fragmentos extraídos de una partitura grade,
1057 puede también usar la capacidad de recorte de sistemas, véase
1058 @ruser{Extracting fragments of music}.
1061 @node Inserting LilyPond output into OpenOffice.org
1062 @unnumberedsubsec Inserting LilyPond output into OpenOffice.org
1064 @cindex OpenOffice.org
1066 Se puede añadir notación de LilyPond a los documentos de
1068 @uref{http://@/ooolilypond@/.sourceforge@/.net@/,OOoLilyPond}.
1071 @node Inserting LilyPond output into other programs
1072 @unnumberedsubsec Inserting LilyPond output into other programs
1074 Para insertar la salida de LilyPond dentro de otros programas, use
1075 @code{lilypond} en vez de @code{lilypond-book}. Cada ejemplo debe
1076 crearse individualmente y añadirse al documento; consulte la
1077 documentación del programa correspondiente. La mayoría de los
1078 programas podrán insertar la salida de LilyPond en los formatos
1079 @file{PNG}, @file{EPS} o @file{PDF}.
1081 Para reducir el espacio vacío alrededor de la partitura de LilyPond,
1082 utilice las siguientes opciones:
1090 bookTitleMarkup = ##f
1091 scoreTitleMarkup = ##f
1097 Para obtener un archivo @file{EPS} que sea útil, utilice
1100 lilypond -dbackend=eps -dno-gs-load-fonts -dinclude-eps-fonts miarchivo.ly
1103 lilypond -dbackend=eps -dno-gs-load-fonts -dinclude-eps-fonts --png miarchivo.ly