@c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
@ignore
- Translation of GIT committish: 4ca01b6da8d60b0d8575be05ae974429c91becd5
+ Translation of GIT committish: eba67a0bc70f38a7847de75c640d7ad19c6fd804
When revising a translation, copy the HEAD committish of the
version that you are working on. For details, see the Contributors'
Guide, node Updating translation committishes..
@end ignore
-@c \version "2.14.0"
+@c \version "2.19.21"
@c Note: keep this node named so that `info lilypond-book' brings you here.
@node lilypond-book
Es un programa distinto a @command{lilypond} propiamente dicho, y se
ejecuta sobre la línea de órdenes; para ver más información, consulte
-@ref{Utilización desde la línea de órdenes}. Si tiene MacOS 10.3 o
-10.4 y experimenta algún problema al ejecutar @code{lilypond-book},
-consulte @rweb{MacOS X}.
+@ref{Utilización desde la línea de órdenes}. Si experimenta algún
+problema al ejecutar @code{lilypond-book} sobre Windows o Mac OS X
+utilizando la línea de órdenes, consulte @rweb{Windows} o @rweb{MacOS X}.
Este procedimiento se puede aplicar a documentos de @LaTeX{}, HTML,
Texinfo o DocBook.
@cindex texinfo
-@cindex latex
+@cindex LaTex
@cindex texinfo
@cindex texi
-@cindex html
+@cindex HTML
@cindex docbook
@cindex documentos, insertar música en
-@cindex HTML, música dentro de
-@cindex Texinfo, música dentro de
-@cindex DocBook, música dentro de
-@cindex @LaTeX{}, música dentro de
+@cindex HTML, insertar música en
+@cindex Texinfo, insertar música en
+@cindex DocBook, insertar música en
+@cindex LaTeX, insertar música en
@menu
* Un ejemplo de documento musicológico::
música y texto. Por ejemplo:
\begin{lilypond}
-\relative c' {
- c2 e2 \times 2/3 { f8 a b } a2 e4
+\relative {
+ c'2 e2 \tuplet 3/2 { f8 a b } a2 e4
}
\end{lilypond}
Los ejemplos grandes se pueden grabar en archivos separados e
introducirse con \verb+\lilypondfile+.
-\lilypondfile[quote,noindent]{screech-boink.ly}
+\lilypondfile[quote,noindent]{screech-and-boink.ly}
-(Si es necesario, sustituya @file{screech-boink.ly}
+(Si es necesario, sustituya @file{screech-and-boink.ly}
por cualquier archivo @file{.ly}
situado en el mismo directorio que este archivo.)
lilypond-book --output=out --pdf lilybook.lytex
@emph{lilypond-book (GNU LilyPond) @version{} }
@emph{Leyendo lilybook.lytex...}
-@emph{..montañas de mensajes suprimidos..}
-@emph{Compilando lilybook.tex...}
+@emph{@dots{}montañas de mensajes suprimidos@dots{}}
+@emph{Compilando lilybook.tex@dots{}}
cd out
pdflatex lilybook
-@emph{..montañas de mensajes suprimidos..}
+@emph{@dots{}montañas de mensajes suprimidos@dots{}}
xpdf lilybook
@emph{(sustituya @command{xpdf} por su visor de PDF favorito)}
@end example
música y texto. Por ejemplo:
@lilypond
-\relative c' {
- c2 e2 \times 2/3 { f8 a b } a2 e4
+\relative {
+ c'2 e2 \tuplet 3/2 { f8 a b } a2 e4
}
@end lilypond
Los ejemplos grandes se pueden grabar en archivos separados e
introducirse con @code{\lilypondfile}.
-@lilypondfile[quote,noindent]{screech-boink.ly}
+@lilypondfile[quote,noindent]{screech-and-boink.ly}
Si se requiere un campo @code{tagline}, ya sea predeterminado o
personalizado, entonces el fragmento completo se debe incluir dentro
title = "Una escala en LilyPond"
}
- \relative c' {
- c d e f g a b c
+ \relative {
+ c' d e f g a b c
}
}
@end lilypond
@itemize
@item
-la instrucción @code{\lilypond@{...@}}, donde podemos escribir directamente fragmentos cortos de código de LilyPond
+la instrucción @code{\lilypond@{@dots{}@}}, donde podemos escribir directamente fragmentos cortos de código de LilyPond
@item
-el entorno @code{\begin@{lilypond@}...\end@{lilypond@}}, donde podemos
+el entorno @code{\begin@{lilypond@}@dots{}\end@{lilypond@}}, donde podemos
introducir directamente bloques más largos de código de LilyPond
@item
-la instrucción @code{\lilypondfile@{...@}} para insertar un archivo de LilyPond
+la instrucción @code{\lilypondfile@{@dots{}@}} para insertar un archivo de LilyPond
@item
-la instrucción @code{\musicxmlfile@{...@}} para insertar un archivo de
+la instrucción @code{\musicxmlfile@{@dots{}@}} para insertar un archivo de
MusicXML, que se procesa por parte de @code{musicxml2ly} y
@code{lilypond}.
@example
\onlyFirstNSystems@{3@}
-\begin@{lilypond@}...\end@{lilypond@}
+\begin@{lilypond@}@dots{}\end@{lilypond@}
\onlyFirstNSystems@{1@}
-\begin@{lilypond@}...\end@{lilypond@}
+\begin@{lilypond@}@dots{}\end@{lilypond@}
@end example
@itemize
@item
-la instrucción @code{@@lilypond@{...@}}, donde podemos introducir
+la instrucción @code{@@lilypond@{@dots{}@}}, donde podemos introducir
directamente fragmentos cortos de código de LilyPond
@item
-el entorno @code{@@lilypond...@@end lilypond}, donde podemos escribir
+el entorno @code{@@lilypond@dots{}@@end lilypond}, donde podemos escribir
directamente bloques más extensos de código de LilyPond
@item
-la instrucción @code{@@lilypondfile@{...@}} para insertar un archivo
+la instrucción @code{@@lilypondfile@{@dots{}@}} para insertar un archivo
de LilyPond
@item
-la instrucción @code{@@musicxmlfile@{...@}} para insertar un archivo
+la instrucción @code{@@musicxmlfile@{@dots{}@}} para insertar un archivo
de MusicXML, que se procesa después por parte de @code{musicxml2ly} y
de @code{lilypond}.
@lilypond[fragment,staffsize=11]{<c' e' g'>}
-A diferencia de @LaTeX{}, @code{@@lilypond@{...@}} no genera una imagen en
+A diferencia de @LaTeX{}, @code{@@lilypond@{@dots{}@}} no genera una imagen en
línea. Siempre consiste en un párrafo para ella sola.
@itemize
@item
-la instrucción @code{<lilypond .... />}, donde podemos introducir
+la instrucción @code{<lilypond @dots{} />}, donde podemos introducir
directamente fragmentos cortos de código de LilyPond
@item
-el entorno @code{<lilyond>...</lilypond>}, donde podemos escribir
+el entorno @code{<lilyond>@dots{}</lilypond>}, donde podemos escribir
directamente bloques más extensos de código de LilyPond
@item
-la instrucción @code{<lilypondfile>...</lilypondfile>} para insertar
+la instrucción @code{<lilypondfile>@dots{}</lilypondfile>} para insertar
un archivo de LilyPond
@item
-la instrucción @code{<musicxmlfile>...</musicxmlfile>} para insertar
+la instrucción @code{<musicxmlfile>@dots{}</musicxmlfile>} para insertar
un archivo de MusicXML, que se procesa después por parte de
@code{musicxml2ly} y de @code{lilypond}.
En el archivo de entrada, la música se especifica con cualquiera de
las instrucciones siguientes:
-
-\begin@{lilypond@}[las,opciones,van,aquí]
- EL CÓDIGO DE LILYPOND
-\end@{lilypond@}
-
-\lilypond[las,opciones,van,aquí]@{ EL CÓDIGO DE LILYPOND @}
-
-\lilypondfile[las,opciones,van,aquí]@{@var{archivo}@}
-
-\musicxmlfile[las,opciones,van,aquí]@{@var{archivo}@}
@example
<lilypond las opciones van aquí>
EL CÓDIGO DE LILYPOND
\key c \minor c4 es g2
@end lilypond
-Para imágenes en línea, utilice @code{<lilypond ... />}, donde las
+Para imágenes en línea, utilice @code{<lilypond @dots{} />}, donde las
opciones están separadas de la música por el símbolo de dos puntos,
por ejemplo
Para incluir archivos externos, escriba
@example
-<lilypondfile @var{opción1} @var{opción2} ...>@var{archivo}</lilypondfile>
+<lilypondfile @var{opción1} @var{opción2} @dots{}>@var{archivo}</lilypondfile>
@end example
@code{<musicxmlfile>} usa la misma sintaxis que @code{<lilypondfile>},
<textobject>
<programlisting language="lilypond" role="fragment verbatim staffsize=16 ragged-right relative=2">
\context Staff \with @{
- \remove Time_signature_engraver
- \remove Clef_engraver@}
+ \remove "Time_signature_engraver"
+ \remove "Clef_engraver"@}
@{ c4( fis) @}
</programlisting>
</textobject>
@code{relative}, es decir
@example
-\relative c' @{ % begin verbatim
- c4 e2 g4
+\relative @{ % begin verbatim
+ c'4 e2 g4
f2 e % end verbatim
@}
@end example
@noindent
-se imprimirá como un bloque preformateado como
+se imprime como un bloque preformateado como
@example
c4 e2 g4
@LaTeX{}, y es por lo que explicamos las dos formas.}, y cualquiera
que sea el método que utilice, podrá convertir fácilmente entre
PostScript y PDF con herramientas como @command{ps2pdf} y
-@command{pdf2ps} que vienen incluidas con GhostScript.
+@command{pdf2ps} que vienen incluidas con Ghostscript.
Para producir un archivo PDF por medio de PDF@LaTeX{}, utilice
ignorar. Si está ejecutando @command{latex} en modo de dos columnas,
recuerde añadir @option{-t landscape} a las opciones de @command{dvips}.
+@knownissues
+La instrucción @code{\pageBreak} no funciona dentro de un entorno
+@code{\begin@{lilypond@} @dots{} \end@{lilypond@}}.
+
+Muchas variables del bloque @code{\paper} tampoco funcionan dentro de
+un entorno @code{\begin@{lilypond@} @dots{} \end@{lilypond@}}. Use
+@code{\newcommand} con @code{\betweenLilyPondSystem} en el preámbulo:
+
+@example
+\newcommand@{\betweenLilyPondSystem@}[1]@{\vspace@{36mm@}\linebreak@}
+@end example
+
+
@subsubheading Texinfo
Para producir un documento de Texinfo (en cualquier formato de
procesado posteriores como @command{makeinfo} o @command{latex} con
las mismas opciones @option{-I @var{directorio}}.
+@item -l @var{nivel_de_registro}
+@itemx --loglevel=@var{nivel_de_registro}
+Fijar el nivel en que la salida es prolija, al valor
+@var{nivel_de_registro}. Los valores posibles son @code{NONE} (nada),
+@code{ERROR} (errores), @code{WARNING} (advertencias), @code{PROGRESS}
+(avance; predeterminado) y @code{DEBUG} (depuración). Si esta opción
+no se utiliza, y la variable de entorno @code{LILYPOND_BOOK_LOGLEVEL}
+está establecida, se usa su valor como el nivel de registro.
+
@item -o @var{directorio}
@itemx --output=@var{directorio}
Colocar los archivos generados en el @var{directorio}. La ejecución
@example
lilypond-book --output=out miarchivo.lytex
cd out
-...
+@dots{}
@end example
-@itemx --skip-lily-check
+@item --skip-lily-check
Evitar el fracaso si no se encuentra ninguna salida de lilypond. Se
usa para la documentación de LilyPond en formato Info sin imágenes.
-@itemx --skip-png-check
+@item --skip-png-check
Evitar el fracaso si no se encuentran las imágenes PNG de los archivos
EPS. Se usa para la documentación de LilyPond en formato Info sin
imágenes.
-@itemx --lily-output-dir=@var{directorio}
+@item --lily-output-dir=@var{directorio}
Escribir archivos lily-XXX en el directorio @var{directorio}, enlazar
en el directorio de @option{--output}. Use esta opción para ahorrar
tiempo de construcción para documentos de distintos directorios que
comparten muchos fragmentos idénticos de código.
-@itemx --info-images-dir=@var{directorio}
+@item --lily-loglevel=@var{nivel_de_registro}
+Fijar el nivel en que la salida es prolija para las llamadas de la
+instrucción invocada @command{lilypond}, al valor
+@var{nivel_de_registro}. Los valores posibles son @code{NONE} (nada),
+@code{ERROR} (errores), @code{WARNING} (advertencias),
+@code{BASIC_PROGRESS} (avance básico), @code{PROGRESS} (avance),
+@code{INFO} (información; predeterminado) y @code{DEBUG}
+(depuración). Si no se utiliza esta opción y la variable de entorno
+@code{LILYPOND_LOGLEVEL} está establecida, su valor se usa como nivel
+de registro.
+
+
+@item --info-images-dir=@var{directorio}
Dar formato a la salida de Texinfo de manera que Info busque las
imágenes de música en @var{directorio}.
-@itemx --latex-program=@var{prog}
+@item --latex-program=@var{prog}
Ejecutar el programa @command{prog} en vez de @command{latex}. Esto
es útil si nuestro documento se procesa con @command{xelatex}, por
ejemplo.
-@itemx --left-padding=@var{cantidad}
+@item --left-padding=@var{cantidad}
Rellenar las cajas EPS en esta medida, alrededor. @var{cantidad} se
mide en milímetros, y es 3.0 como valor predeterminado. Esta opción
se debe usar si las líneas de música están muy pegadas al margen
instrumento. Esta opción acorta todas las líneas y las mueve a la
derecha en la misma medida.
-
@item -P @var{instrucción}
@itemx --process=@var{instrucción}
Procesar los fragmentos de LilyPond utilizando @var{instrucción}. La
opción redirecciona toda la salida hacia archivos de registro situados
en el mismo directorio que los archivos fuente.
-@itemx --use-source-file-names
+@item --use-source-file-names
Escribir los archivos de salida de los fragmentos de música con el
mismo nombre de base que su archivo fuente. Esta opción sólo funciona
para fragmentos incluidos con @code{lilypondfile} y sólo si los
@item -V
@itemx --verbose
-Ser prolijo.
+Ser prolijo. Equivale a @code{--loglevel=DEBUG}.
@item -v
@itemx --version
Texto normal en LaTeX.
\begin@{lilypond@}
-\relative c'' @{
- a4 b c d
+\relative @{
+ a'4 b c d
@}
\end@{lilypond@}
Texto en Texinfo
@@lilypond
-\relative c' @{
+\relative @{
a4 b c d
@}
@@end lilypond
Los documentos para lilypond-book pueden mezclar música y texto libremente. Por
ejemplo,
<lilypond>
-\relative c'' @{
- a4 b c d
+\relative @{
+ a'4 b c d
<p>
Otro poco de lilypond, esta vez con opciones: