@c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
@ignore
- Translation of GIT committish: c588e39bb25b7c92bb83afc743c60f1a4cedfd00
+ Translation of GIT committish: 345522f312430725cdae0d61acfa716ce08622ca
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.12.0"
+@c \version "2.13.36"
@node Entrada y salida generales
@chapter Entrada y salida generales
@translationof Input structure
El formato principal de entrada para LilyPond son archivos de texto.
-Por convenio, el nombre de estos archivos termina en @code{.ly}.
+Por convenio, el nombre de estos archivos termina en @file{.ly}.
@menu
* Estructura de una partitura::
* Varias partituras en un libro::
+* Varios archivos de salida a partir de uno de entrada::
+* Nombres de los archivos de salida::
* Estructura del archivo::
@end menu
pueden escribir dentro o fuera del bloque @code{\score}, y dentro o
fuera de la expresión musical única dentro del bloque @code{\score}.
+Recuerde que incluso dentro de un archivo que contenga solamente un
+bloque @code{\score}, éste se encuentra incluido implícitamente dentro
+de un bloque @code{\book}. Un bloque @code{\book} dentro de un
+archivo fuente produce al menos un archivo de salida, y de forma
+predeterminada el nombre del archivo de salida que se produce está
+derivado del nombre del archivo de entrada, de forma que
+@file{fandangoforelephants.ly} da como resultado
+@file{fandangoforelephants.pdf}.
+
+(Para ver más detalles acerca de los bloques @code{\book}, consulte
+@ref{Varias partituras en un libro}, @ref{Varios archivos de salida a
+partir de uno de entrada} y @ref{Estructura del archivo}.)
@seealso
Manual de aprendizaje:
@funindex \book
Todos los movimientos y textos que aparecen en el mismo archivo
-@code{.ly} se tipografían normalmente en la forma de un solo archivo
+@file{.ly} se tipografían normalmente en la forma de un solo archivo
de salida.
@example
@}
@end example
-Sin embargo, si queremos varios archivos de salida a partir del mismo
-archivo @code{.ly}, podemos escribir varios bloques @code{\book},
-donde cada uno de estos bloques @code{\book} dará como resultado un
-archivo de salida distinto. Si no especificamos ningún bloque
-@code{\book} en el archivo,, LilyPond trata implícitamente todo el
-archivo como un solo bloque @code{\book}, véase @ref{Estructura del archivo}.
Una excepción importante se da dentro de los documentos de
lilypond-book, en los que tenemos que escribir explícitamente un
bloque @code{\book}, pues en caso contrario sólo aparecerá en la
@}
@end example
+@node Varios archivos de salida a partir de uno de entrada
+@subsection Varios archivos de salida a partir de uno de entrada
+@translationof Multiple output files from one input file
+
+Si queremos varios archivos de salida a partir del mismo archivo
+@file{.ly}, podemos escribir varios bloques @code{\book}, donde cada
+uno de estos bloques @code{\book} dará como resultado un archivo de
+salida distinto. Si no especificamos ningún bloque @code{\book} en el
+archivo, LilyPond trata implícitamente todo el archivo como un solo
+bloque @code{\book}, véase @ref{Estructura del archivo}.
+
+Al producir varios archivos a partir de un solo archivo fuente,
+Lilypond se asegura de que ninguno de los archivos de salida de ningún
+bloque @code{\book} sobreescribe el archivo de salida producido por un
+@code{\book} anterior del mismo archivo de entrada.
+
+Lo hace añadiendo un sufijo al nombre de la salida para cada libro
+@code{\book} que utiliza el nombre del archivo de salida
+predeterminado, derivado del archivo fuente de entrada.
+
+El comportamiento predeterminado es añadir un sufijo con el número de
+versión para cada nombre que pueda coincidir; así:
+
+@example
+\book @{
+ \score @{ @dots{} @}
+ \layout @{ @dots{} @}
+@}
+\book @{
+ \score @{ @dots{} @}
+ \layout @{ @dots{} @}
+@}
+\book @{
+ \score @{ @dots{} @}
+ \layout @{ @dots{} @}
+@}
+@end example
+
+en el archivo fuente @file{eightminiatures.ly}, produce
+
+@itemize
+@item
+@file{eightminiatures.pdf},
+@item
+@file{eightminiatures-1.pdf} y
+@item
+@file{eightminiatures-2.pdf}.
+@end itemize
+
+@node Nombres de los archivos de salida
+@subsection Nombres de los archivos de salida
+@translationof Output file names
+
+@funindex \bookOutputSuffix
+@funindex \bookOutputName
+
+Lilypond le ofrece unos mecanismos que le permiten controlar los
+nombres de archivo que se utilizan por parte de los diversos motores
+finales al producir los archivos de salida.
+
+En la sección anterior vimos cómo Lilypond evita las coincidencias de
+nombres al producir varias salidas a partir de un único archivo fuente
+de entrada. También podemos especificar nuestros propios sufijos para
+cada bloque @code{\book}, de manera que podemos producir, por ejemplo,
+archivos con los nombres @file{eightminiatures-Romanze.pdf},
+@file{eightminiatures-Menuetto.pdf} y
+@file{eightminiatures-Nocturne.pdf} añadiendo una declaración
+@code{\bookOutputSuffix} dentro de cada bloque @code{\book}.
+
+@example
+\book @{
+ \bookOutputSuffix "Romanze"
+ \score @{ @dots{} @}
+ \layout @{ @dots{} @}
+@}
+\book @{
+ \bookOutputSuffix "Menuetto"
+ \score @{ @dots{} @}
+ \layout @{ @dots{} @}
+@}
+\book @{
+ \bookOutputSuffix "Nocturne"
+ \score @{ @dots{} @}
+ \layout @{ @dots{} @}
+@}
+@end example
+
+También podemos especificar un nombre de archivo de salida diferente
+para cada bloque @code{book}, mediante la utilización de declaraciones
+@code{\bookOutputName}:
+
+@example
+\book @{
+ \bookOutputName "Romanze"
+ \score @{ @dots{} @}
+ \layout @{ @dots{} @}
+@}
+\book @{
+ \bookOutputName "Menuetto"
+ \score @{ @dots{} @}
+ \layout @{ @dots{} @}
+@}
+\book @{
+ \bookOutputName "Nocturne"
+ \score @{ @dots{} @}
+ \layout @{ @dots{} @}
+@}
+@end example
+
+El código anterior produce los siguientes archivos de salida:
+
+@itemize
+@item
+@file{Romanze.pdf},
+@item
+@file{Menuetto.pdf} y
+@item
+@file{Nocturne.pdf}.
+@end itemize
@node Estructura del archivo
@subsection Estructura del archivo
@funindex \book
@funindex \bookpart
-Un archivo @code{.ly} puede contener cualquier número de expresiones
+Un archivo @file{.ly} puede contener cualquier número de expresiones
del nivel superior, donde una expresión del nivel superior es una de
las siguientes posibilidades:
-@itemize @bullet
+@itemize
@item
Una definición de salida, como @code{\paper}, @code{\midi} y
@code{\layout}. Tal definición en el nivel más alto cambia los
(libro) único. Este comportamiento se puede cambiar estableciendo el
valor de la variable @code{toplevel-score-handler} en el nivel
superior. El @emph{handler} predeterminado se define en el archivo de
-inicio @file{../@/scm/@/lily@/.scm}.
+inicio @file{../scm/lily.scm}.
@item
Un bloque @code{\book} combina lógicamente varios movimientos (es
para cada bloque @code{\book}, en el que se concatenan todos los
movimientos correspondientes. La única razón para especificar
explícitamente bloques @code{\book} en un archivo de entrada
-@code{.ly} es si queremos crear varios archivos de salida a partir de
+@file{.ly} es si queremos crear varios archivos de salida a partir de
un único archivo de entrada. Una excepción se da dentro de los
documentos de lilypond-book, en los que tenemos que escribir
explícitamente un bloque @code{\book} si queremos tener más de una
ejemplo. Se puede cambiar este comportamiento estableciendo el valor
de la variable @code{toplevel-book-handler} en el nivel superior. El
@emph{handler} predeterminado se define en el archivo de inicio
-@file{../@/scm/@/lily@/.scm}.
+@file{../scm/lily.scm}.
@item
Un bloque @code{\bookpart}. Un libro puede dividirse en varias
Se puede cambiar este comportamiento estableciendo el valor de la
variable @code{toplevel-music-handler} en el nivel más alto. El
@emph{handler} predeterminado se define en el archivo de inicio
-@file{../@/scm/@/lily@/.scm}.
+@file{../scm/lily.scm}.
@item
Un texto de marcado, por ejemplo una estrofa
Una opción más avanzada es cambiar las definiciones de las variables
siguientes dentro del bloque @code{\paper}. El archivo de inicio
-@file{../@/ly/@/titling@/-init@/.ly} ofrece un listado de la
+@file{../ly/titling-init.ly} ofrece un listado de la
disposición predeterminada.
@table @code
@seealso
Archivos de inicio:
-@file{../@/ly/@/toc@/-init@/.ly}.
+@file{../ly/toc-init.ly}.
@predefined
MIDI. Observe que pasa por alto todos los eventos, incluidos el tempo
y los cambios de instrumento. Está usted advertido.
-@lilypond[quote,fragment,ragged-right,verbatim]
-\relative c'' {
- c8 d
- \set Score.skipTypesetting = ##t
- e8 e e e e e e e
- \set Score.skipTypesetting = ##f
- c8 d b bes a g c2
-}
+@lilypond[quote,relative=2,ragged-right,verbatim]
+c8 d
+\set Score.skipTypesetting = ##t
+e8 e e e e e e e
+\set Score.skipTypesetting = ##f
+c8 d b bes a g c2
@end lilypond
En música polifónica, @code{Score.skipTypesetting} afecta a todas las
Las definiciones de contexto siguen con precisión la misma sintaxis
que la de un bloque @code{\layout}. Los módulos de traducción para el
sonido reciben el nombre de ejecutantes. Los contextos para la salida
-MIDI se definen en @file{../@/ly/@/performer@/-init@/.ly}, véase
+MIDI se definen en @file{../ly/performer-init.ly}, véase
@rlearning{Otras fuentes de información}. Por ejemplo, para eliminar
el efecto de los matices de la salida MIDI, inserte las líneas
siguientes en el bloque @code{\midi@{ @}}.
La salida MIDI se crea sólo cuando se incluye un bloque @code{\midi}
dentro de un bloque de partitura definido con una instrucción
-@code{\score}. Si se sitúa dentro de un contexto de partitura
-instanciado explícitamente (es decir, dentro de un bloque @code{\new
-Score}) el archivo no funciona. Para resolverlo, encierre las
-instrucciones @code{\new Score} y @code{\midi} dentro de un bloque
@code{\score}.
@example
\score @{
- \new Score @{ @dots{}notas@dots{} @}
+ @{ @dots{}notas@dots{} @}
\midi @{ @}
@}
@end example
del rango de volumen MIDI disponible. Las fracciones predeterminadas
se extienden desde 0.25 para @notation{ppppp} hasta 0.95 para
@notation{fffff}. El conjunto de indicaciones dinámicas y las
-fracciones asociadas pueden verse en @file{../@/scm/@/midi.scm}, véase
+fracciones asociadas pueden verse en @file{../scm/midi.scm}, véase
@rlearning{Otras fuentes de información}. Este conjunto de fracciones
se puede cambiar o extender proporcionando una función que toma como
argumento una indicación dinámica y devuelve la fracción requerida, y
Como alternativa, si se necesitara redefinir la tabla completa de
fracciones, sería mejor usar el procedimiento
@notation{default-dynamic-absolute-volume} que aparece en
-@file{../@/scm/@/midi.scm} y la tabla asociada como modelo. El último
+@file{../scm/midi.scm} y la tabla asociada como modelo. El último
ejemplo de esta sección muestra cómo se puede hacer esto.
@unnumberedsubsubsec Volumen maestro MIDI
establecidas, de forma predeterminada LilyPond aplica un pequeño grado
de ecualización a algunos instrumentos. Los instrumentos y la
ecualización que se aplica se muestra en la tabla
-@notation{instrument-equalizer-alist} en @file{../@/scm/@/midi.scm}.
+@notation{instrument-equalizer-alist} en @file{../scm/midi.scm}.
El ecualizador básico predeterminado se puede sustituir estableciendo
@code{instrumentEqualizer} en el contexto @code{Score} a un
la fracción de volumen absoluto @code{dynamicAbsoluteVolumeFunction}
al comienzo de esta sección. El ecualizador predeterminado,
@notation{default-instrument-equalizer}, en
-@file{../@/scm/@/midi.scm}, muestra cómo se puede escribir tal
+@file{../scm/midi.scm}, muestra cómo se puede escribir tal
procedimiento.
El ejemplo siguiente establece los volúmenes relativos de la flauta y