@c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
@ignore
- Translation of GIT committish: 08560a1b8076630c4fc6cb9b902614d8b74fd6fc
+ Translation of GIT committish: 73255e50558a62841500aa947ff7cad28636d144
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.15.25"
+@c \version "2.15.39"
@node Entrada y salida generales
@chapter Entrada y salida generales
@}
@end example
-
@funindex \bookpart
Se pueden agrupar distintas piezas de música en partes de un libro
@}
@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
@file{eightminiatures-2.pdf}.
@end itemize
+
@node Nombres de los archivos de salida
@subsection Nombres de los archivos de salida
@translationof Output file names
@file{Nocturne.pdf}.
@end itemize
+
@node Estructura del archivo
@subsection Estructura del archivo
@translationof File structure
Una definición de salida, como @code{\paper}, @code{\midi} y
@code{\layout}. Tal definición en el nivel más alto cambia los
ajustes predeterminados para todo el libro. Si se introduce más de
-una de estas definiciones del mismo tipo en el nivel más alto,
-cualquier definición en una expresión posterior tiene prioridad.
+una de estas definiciones del mismo tipo en el nivel más alto, las
+definiciones se combinan, pero en situaciones de conflicto las
+definiciones más tardías tienen preferencia. Para ver los detalles
+sobre cómo afecta al bloque @code{\layout}, consulte
+@ref{El bloque \layout}.
@item
Una expresión directa de Scheme, como
Manual de aprendizaje:
@rlearning{Cómo funcionan los archivos de entrada de LilyPond}.
+Referencia de la notación:
+@ref{El bloque \layout}.
@node Títulos y cabeceras
@section Títulos y cabeceras
Archivos de inicio:
@file{ly/titling-init.ly}.
+
@node Disposición predeterminada de las cabeceras y pies de página
@unnumberedsubsubsec Disposición predeterminada de las cabeceras y pies de página
@translationof Default layout of headers and footers
@item @code{evenFooterMarkup} (marcado de pie de página par)
@end itemize
+@cindex marcado condicional
+@cindex on-the-fly
+@funindex \on-the-fly
+
+La instrucción de marcado @code{\on-the-fly} se puede utilizar para
+añadir elementos de forma condicional al texto de encabezamiento y pie
+de página definido dentro del bloque @code{\paper}, usando la sintaxis
+siguiente:
+
+@example
+@code{variable} = @code{\markup} @{
+ ...
+ @code{\on-the-fly} #@var{procedimiento} @var{marcado}
+ ...
+@}
+@end example
+
+El @var{procedimiento} se llama cada vez que se evalúa la instrucción
+@code{\markup} en que ésta aparece. El @var{procedimiento} debería
+comprobar si se cumple una condición determinada e interpretar (es
+decir: imprimir) el argumento @var{marcado} si, y sólo si, la
+condición es verdadera.
+
+Se proveen un cierto número de procedimientos ya hechos para la
+comprobación de diversas condiciones:
+
+@quotation
+@multitable {print-page-number-check-first-----} {¿es el núm. de páginas en la parte de libro > 1?-----}
+
+@headitem Nombre del procedimiento @tab Condición que se comprueba
+
+@item print-page-number-check-first @tab ¿debería imprimirse esta página?
+@item create-page-number-stencil @tab ¿es 'print-page-numbers verdadero?
+@item print-all-headers @tab ¿es 'print-all-headers verdadero?
+@item first-page @tab ¿es la primera página del libro?
+@item (on-page nmbr) @tab ¿es el número de página = nmbr?
+@item last-page @tab ¿es la última página del libro?
+@item not-first-page @tab ¿no es la primera página del libro?
+@item part-first-page @tab ¿es la primera página de la parte de libro?
+@item part-last-page @tab ¿es la última página de la parte de libro?
+@item not-single-page @tab ¿es el núm. de páginas en la parte de libro > 1?
+
+@end multitable
+@end quotation
+
El ejemplo siguiente centra los números de página en la parte baja de
las páginas. En primer lugar, los ajustes predeterminados para
@code{oddHeaderMarkup} y @code{evenHeaderMarkup} se eliminan
}
@end lilypond
+Se pueden combinar varias condiciones de @code{\on-the-fly} con un
+operador @q{and}, por ejemplo:
+
+@example
+ @code{\on-the-fly #first-page}
+ @code{\on-the-fly #last-page}
+ @code{@{ \markup ... \fromproperty #'header: ... @}}
+@end example
+
+determina si la salida es una sola página.
+
@seealso
-Notation Reference:
+Referencia de la notación:
@ref{Explicación de los bloques de títulos},
@ref{Presentación predeterminada de los bloques de título del libro y la partitura}.
+Archivos instalados:
+@file{../ly/titling-init.ly}.
+
+
@node Crear notas al pie
@subsection Crear notas al pie
@translationof Creating footnotes
@unnumberedsubsubsec Panorámica de las notas al pie
@translationof Footnotes overview
-Las notas al pie automáticas crean indicadores numéricos
-incrementales; las notas al pie manuales, en cambio, permiten crear un
-indicador personalizado. Se pueden anotar todos los grobs (objetos
-gráficos), elementos @code{\markup} del nivel superior y las notas de
-los acordes.
+Las notas al pie automáticas crean indicadores numéricos crecientes;
+en cambio las notas al pie manuales permiten crear un indicador
+personalizado. Normalmente, las notas al pie se aplican como
+@code{\tweak}s y por ello se pueden colocar directamente sobre los
+grobs (objetos gráficos) creados por la mayor parte de los elementos y
+post-eventos musicales. En los casos en que esto no funciona así
+(como con las líneas divisorias y los cambios de compás, donde los
+grobs se producen como consecuencia de cambios en propiedades), las
+notas al pie se pueden también especificar como un evento musical
+independiente que afecta a todos los grobs de un tipo dado en un punto
+temporal concreto.
+
+La forma completa de una instrucción de nota al pie es
+
+@example
+\footnote @var{marca} @var{desplazamiento} @var{grob} @var{nota}
+@var{música}
+@end example
+
+Los elementos son como sigue:
+
+@table @var
+@item marca
+es un elemento de marcado o cadena que especifica la nmarca de nota al
+pie que se usa tanto para señalar el punto de referencia como la nota
+en sí en la parte inferior de la página. Se puede omitir (o, de forma
+equivalente, sustituirse con @code{\default}) en cuyo caso se genera
+un número en secuencia.
+@item desplazamiento
+es una pareja de números como @samp{#(2 . 1)} que especifica los
+desplazamientos X e Y a partir del punto de referencia en que se
+situará la marca.
+@item grob
+especifica, por su nombre, un tipo de objeto gráfico o grob que marcar
+(como @samp{#'Flag} para el corchete de una nota). Si se da, el grob
+respectivo se usa como punto de referencia incluso en el caso de que
+su @q{causa} no sea la propia @var{música} referenciada sino un grob
+creado a partir de ella. Se puede omitit (o sustituirse por
+@code{\default}), y entonces sólo se anotará un grob creado
+directamente.
+@item nota
+Esta cadena o elemento de marcado especifica el texto de la nota que
+utilizar en la parte inferior de la página.
+@item música
+Éste es el elemento, evento musical o componente de un acorde o
+post-evento, que se está anotando. Aunque no puede omitirse, @emph{sí
+puede} sustituirse por @code{\default} en cuyo caso la nota al pie no
+se adjunta a una expresión musical dada, sino a un momento de tiempo.
+Es obligatorio en este caso utilizar el argumento @var{grob} para
+seleccionar un tipo de grob afectado, como @samp{#'TimeSignature}
+(indicación de compás).
+@end table
+
+Como ocurre con @code{\tweak}, si nuestra @code{\footnote} se aplica a
+un post-evento o articulación, tendrá que ser ella misma precedida de
+@code{-} para que el analizador sintáctico adjunte el resultado a la
+nota o silencio precedente.
-El orden en que se dibuja cada grob determina el orden en que se crean
-los indicadores (y por tanto las notas al pie) durante la compilación.
@node Notas al pie automáticas
@unnumberedsubsubsec Notas al pie automáticas
@translationof Automatic footnotes
-De las dos instrucciones utilizadas para crear notas al pie
-automáticas, utilice @code{\footnoteGrob} para los grobs
-individuales (es decir: la cabeza de las notas, plicas, ligaduras de
-expresión, matices dinámicos y elementos de @code{\markup} si se
-utilizan @code{TextScripts}); y @code{\footnote} para anotar las
-notas de un acorde.
-
-Las dos instrucciones aceptan tres argumentos; el @var{Objeto de
-presentación} que anotar, la posición @var{(x . y)} del indicador y un
-elemento de @code{\markup} que aparecerá en la nota, en la parte
-inferior de la página.
-
-La instrucción @code{\footnoteGrob} debe ir @emph{antes} del grob
-al que se adjunta la nota al pie:
+Las notas al pie automáticas toman cuatro argumentos: la posición
+@samp{(x . y)} del indicador, el nombre opcional del @var{grob} que
+especifica el objeto de presentación que se anota, el elemento de
+marcado de la porpia @var{nota} que aparecerá en la parte inferior de
+la página, y por supuesto la @var{música} a que adjuntar la nota al
+pie.
@lilypond[verbatim,quote,ragged-right,papersize=a8]
\book {
\header { tagline = ##f }
\relative c' {
- \footnote #'(0.5 . -2) #'NoteHead
+ \footnote #'(0.5 . -2)
\markup { The first note }
a'4 b8
- \footnote #'(0.5 . 1) #'NoteHead
+ \footnote #'(0.5 . 1) #'Flag
\markup { The third note }
- e c4 d4
+ e\noBeam c4 d4
}
}
@end lilypond
-Para anotar las notas de un acorde, la instrucción
-@code{\footnote} debe ir @emph{después} de la nota a la que se
-quiere adjuntar la nota al pie como un @code{TextScript}:
+Las notas en acorde no ofrecen ninguna dificultad especial:
@lilypond[verbatim,quote,ragged-right,papersize=a8]
\book {
\header { tagline = ##f }
\relative c' {
<
- c-\footnote #'(1 . -1.25) "Here is a C"
- es-\footnote #'(2 . -0.25) \markup { \italic "An E-flat" }
- g-\footnote #'(2 . 3) \markup { \bold "This is a G" }
+ \footnote #'(1 . -1.25) "Here is a C" c
+ \footnote #'(2 . -0.25) \markup { \italic "An E-flat" } es
+ \footnote #'(2 . 3) \markup { \bold "This is a G" } g
>1
}
}
imprimen en orden de descendencia: cuando más alta es la nota al pie,
más arriba está en la lista.}
-He aquí unos ejemplos de grobs con notas al pie automáticas, que
+He aquí unos ejemplos más de grobs con notas al pie, que
muestran también la posición relativa de las notas respecto de la
línea informativa y la línea de copyright.
\book {
\header { copyright = \markup { "Copyright 1970" } }
\relative c' {
- \footnote #'(-3 . 0) #'DynamicText
- \markup { \bold Forte }
-
- \footnote #'(0 . 1.5) #'Slur
- \markup { A slur }
- a'4\f(
-
- \footnote #'(0 . -2) #'Beam
- \markup { Beam }
- b8)[ e]
-
+ a'4-\footnote #'(-3 . 0) \markup { \bold Forte } \f
+ -\footnote #'(0 . 1.5) \markup { A slur } (
+ b8)-\footnote #'(0 . -2) \markup { Beam } [ e]
\footnote #'(1 . -1) #'Stem
\markup { \teeny { This is a stem } }
c4
-
\footnote #'(0 . 0.5) #'AccidentalCautionary
\markup \italic { A cautionary accidental }
-
- \footnote #'(0.5 . -0.5) #'TextScript
- \markup \italic { Slow Down }
- dis?4_"rit."
+ \footnote #'(1 . 1) "The note itself"
+ dis?4-\footnote #'(0.5 . -0.5) \markup \italic { Slow Down }
+ _"rit."
}
}
@end lilypond
@unnumberedsubsubsec Notas al pie manuales
@translationof Manual footnotes
-@funindex \footnote
-@funindex \footnoteGrob
@cindex notas al pie manuales
-Existen dos instrucciones para crear notas al pie manuales;
-@code{\footnote} para elementos de @code{\markup} del nivel superior y
-notas de acordes; y @code{\footnoteGrob} para grobs individuales (y
-elementos de @code{\markup} cuando se usan @code{TextScripts}).
+Las notas al pie marcadas manualmente toman un primer argumento
+adicional de marcado, @var{marca} para construir la marca de
+referencia. A diferencia de las marcas de notas al pie generadas
+automáticamente, no aparecen antes del elemento de marcado @var{nota}
+en la parte inferior de la página: el establecimiento de la conexión
+visual se deja para el usuario. LilyPond sólo asegura que el marcado
+correspondiente aparece en la parte inferior de la misma página.
-Si se están anotando grobs, la instrucción @code{\footnote} toma
-cuatro argumentos; el @var{objeto de presentación} que se va a anotar,
-la posición @var{(x . y)} del indicador, y dos instrucciones
-@code{\markup}; la primera es el indicador adjunto a la nota o grob, y
-la segunda es la nota al pie, en la parte inferior de la página.
-
-La instrucción @code{\footnoteGrob} debe ir @emph{después} del grob
-que la nota al pie está anotando y adjuntada como un
-@code{TextScript}:
+Aparte de esto, su uso es idéntico al de las notas al pie numeradas
+automáticamente.
@lilypond[verbatim,quote,ragged-right,papersize=a8]
\book {
\header { tagline = ##f }
\relative c' {
- a'4-\footnote
- "1" #'(0.5 . -2) #'NoteHead \markup { \italic "1. The first note" }
+ \footnote
+ "1" #'(0.5 . -2)
+ \markup { \italic "1. The first note" }
+ a'4
b8
- e-\footnote
- \markup { \bold "2" } #'(0.5 . 1) #'NoteHead "2. The second note"
+ \footnote
+ \markup { \bold "2" } #'(0.5 . 1)
+ "2. The second note"
+ e
c4
- d\p-\footnote "3" #'(0.5 . -1) #'DynamicText "3. Piano"
+ d-\footnote "3" #'(0.5 . -1) "3. Piano" \p
}
}
@end lilypond
-Para anotar notas de acordes, la instrucción @code{\footnote} debe ir
-@emph{después} de la nota que se está anotando con una nota al pie, y
-adjuntarse como un @code{TextScript}:
+Para anotar notas de acordes con notas al pie manuales:
@lilypond[verbatim,quote,ragged-right,papersize=a8]
\book {
\header { tagline = ##f }
\relative c' {
<
- c-\footnote "1" #'(1 . -1.25) "1. C"
- es-\footnote
- \markup { \bold "b" } #'(2 . -0.25) "b. E-flat"
- g-\footnote "3" #'(2 . 3) \markup { \italic "iii. G" }
+ \footnote "1" #'(1 . -1.25) "1. C" c
+ \footnote
+ \markup { \bold "b" } #'(2 . -0.25) "b. E-flat" es
+ \footnote "3" #'(2 . 3) \markup { \italic "iii. G" } g
>1
}
}
\book {
\header { tagline = ##f }
\relative c' {
- \footnote
- \markup { \teeny 1 } #'(-3 . 0) #'DynamicText
- \markup { 1. \bold Forte }
-
- \footnote
- \markup { \teeny b } #'(0 . 1.5) #'Slur
- \markup { b. A slur }
- a'4\f(
-
- \footnote
- \markup { \teeny 3 } #'(0 . -2) #'Beam
- \markup { 3. Beam }
- b8)[ e]
-
+ a'4-\footnote
+ \markup { \teeny 1 } #'(-3 . 0)
+ \markup { 1. \bold Forte } \f
+ -\footnote
+ \markup { \teeny b } #'(0 . 1.5)
+ \markup { b. A slur } (
+ b8)-\footnote
+ \markup { \teeny 3 } #'(0 . -2)
+ \markup { 3. Beam } [
+ e]
\footnote
\markup { 4 } #'(1 . -1) #'Stem
\markup { \bold 4. { This is a stem } }
c4
-
\footnote
- \markup \concat \teeny { "sharp (v)" } #'(0 . 0.5) #'AccidentalCautionary
+ \markup \concat \teeny { "sharp (v)" }
+ #'(0 . 0.5) #'AccidentalCautionary
\markup \italic { v. A cautionary accidental }
-
- \footnote
- \markup \concat \teeny { "a" } #'(0.5 . -0.5) #'TextScript
- \markup \italic { a. Slow Down }
- dis?4_"rit."
-
- \breathe
+ dis?4-\footnote
+ \markup \concat \teeny { "a" } #'(0.5 . -0.5)
+ \markup \italic { a. Slow Down } _"rit."
\footnote
- \markup { \teeny \musicglyph #"rests.4" } #'(1.5 . -0.25) #'BreathingSign
- \markup { \null }
+ \markup { \teeny \musicglyph #"rests.4" }
+ #'(1.5 . -0.25)
+ \markup { \null } \breathe
}
}
@end lilypond
páginas, el medidor puede ser "00", es decir, un número de dos
dígitos.
-
@predefined
@funindex \label
@code{\label},
}
@end lilypond
-
@seealso
Archivos de inicio:
-@file{../ly/toc-init.ly}.
-
+@file{ly/toc-init.ly}.
@predefined
@funindex \table-of-contents
Pueden verse ejemplos sencillos sobre el uso de @code{\include} en
@rlearning{Partituras y particellas}.
-
@seealso
Manual de aprendizaje:
@rlearning{Otras fuentes de información},
de la estructura de la partitura hará que sea más fácil cambiar la
estructura dejando intacta la notación.
-
@menu
* Uso de las variables::
* Uso de etiquetas::
@ref{Combinación automática de las partes},
@ref{Inclusión de archivos de LilyPond}.
-
@ignore
@c This warning is more general than this placement implies.
@c Rests are not merged whether or not they come from tagged sections.
@c Should be deleted? -td
-
@knownissues
-
Multiple rests are not merged if you create a score with more
than one tagged section at the same place.
Referencia de la notación:
@ref{Inclusión de archivos de LilyPond}.
+
@node Caracteres especiales
@subsection Caracteres especiales
@translationof Special characters
carácter en el portal del Consorcio Unicode,
@uref{http://www.unicode.org/}.
-
Por ejemplo, tanto @code{\char ##x03BE} como @code{\char #958}
insertan el carácter Unicode U+03BE, que tiene el nombre Unicode
@qq{Letra griega Xi pequeña}.
@file{ly/text-replacements.ly}.
-
@node Controlar la salida
@section Controlar la salida
@translationof Controlling output
* Sustituir la tipografía de la notación::
@end menu
+
@node Extracción de fragmentos de música
@subsection Extracción de fragmentos de música
@translationof Extracting fragments of music
En música polifónica, @code{Score.skipTypesetting} afecta a todas las
voces y pentagramas, ahorrando más tiempo incluso.
+
@node Formatos de salida alternativos
@subsection Formatos de salida alternativos
@translationof Alternative output formats
formatos de salida Gráficos de vector escalables (SVG), PostScript
encapsulado (EPS) y Gráficos de red portátiles (PNG) también están
disponibles a través de opciones de la línea de órdenes, véase
-@rprogram{Opciones de la línea de órdenes para lilypond}.
+@rprogram{Opciones básicas de la línea de órdenes para LilyPond}.
@node Sustituir la tipografía de la notación
* El script Articulate::
@end menu
+
@node Crear archivos MIDI
@subsection Crear archivos MIDI
@translationof Creating MIDI files
\score @{
@var{...música...}
\midi @{
- \context @{
- \Score
- tempoWholesPerMinute = #(ly:make-moment 72 4)
- @}
+ \tempo 4 = 72
@}
@}
@end example
En este ejemplo, el tempo se establece a 72 pulsos de negra por
-minuto. Esta clase de especificación de tempo no puede tomar como
-argumento una figura con puntillo. Si necesitamos una figura con
-puntillo, dividimos la nota con puntillo en figuras más pequeñas. Por
-ejemplo, un tempo de 90 negras con puntillo por minuto se puede
-especificar como 270 corcheas por minuto:
-
-@example
-tempoWholesPerMinute = #(ly:make-moment 270 8)
-@end example
+minuto. @code{\tempo} is actually a music command for
+setting properties during the interpretation of music: in the
+context of output definitions like a @code{\midi} block, as a matter of
+courtesy those are reinterpreted as if they were context modifications.
@cindex MIDI, definiciones de contexto
@}
@end example
+
@node ¿Qué sale por el MIDI?
@subsection ¿Qué sale por el MIDI?
@translationof What goes into the MIDI output?
>>
\layout {}
\midi {
+ \tempo 2 = 72
\context {
\Score
- tempoWholesPerMinute = #(ly:make-moment 72 2)
midiMinimumVolume = #0.2
midiMaximumVolume = #0.5
}
>>
\layout {}
\midi {
- \context {
- \Score
- tempoWholesPerMinute = #(ly:make-moment 72 2)
- }
+ \tempo 2 = 72
}
}
@end lilypond
>>
\layout { }
\midi {
- \context {
- \Score
- tempoWholesPerMinute = #(ly:make-moment 72 2)
- }
+ \tempo 2 = 72
}
}
@end lilypond
(@emph{rim shots}), para este propósito se utiliza en su lugar el
golpe lateral de baqueta (@emph{sidestick}).
+
@node El script Articulate
@subsection El script Articulate
@translationof The Articulate script
* Guardar los eventos musicales en un archivo::
@end menu
+
@node Impresión del código de notación de LilyPond
@subsection Displaying LilyPond notation
@translationof Displaying LilyPond notation
investigadores que desean realizar un análisis musical o hacer
experimientos de reproducción con LilyPond.
-
@knownissues
-
No todos los eventos musicales de lilypond están contemplados por
@file{event-listener.ly}. Se pretende que sea una @qq{prueba de
concepto} bien realizada. Si algunos eventos que quiere ver no