]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/es/notation/input.itely
Doc-es: update included/Helpus, Ancient, Changing, Input, Pitches.
[lilypond.git] / Documentation / es / notation / input.itely
index 08ee2799d08a75610d2ec4f5dd960fc2432372b6..70df6d34d333ae934f7402b7329e63033fb32295 100644 (file)
@@ -1,7 +1,7 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
 
 @ignore
-    Translation of GIT committish: c610645cc9a77cba1a2798280965db142d649ac5
+    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'
@@ -373,8 +373,11 @@ las siguientes posibilidades:
 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
@@ -531,6 +534,8 @@ de la instrucción completa.
 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
@@ -1029,6 +1034,51 @@ texto, use una o más de las siguientes variables de @code{\paper}:
 @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
@@ -1058,11 +1108,25 @@ definiéndola como @code{\oddFooterMarkup}:
 }
 @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
 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
@@ -1076,59 +1140,104 @@ Se pueden crear dos tipos de notas al pie: automáticas y manuales.
 * Notas al pie manuales::
 @end menu
 
-
 @node Panorámica de las notas al pie
 @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.
 
-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.
+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.
 
 
 @node Notas al pie automáticas
 @unnumberedsubsubsec Notas al pie automáticas
 @translationof Automatic footnotes
 
-Las notas al pie automáticas aceptan tres argumentos; el @var{Objeto de
-presentación} que anotar, la posición @samp{(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{\footnote} 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
-      \markup { The first note } \default
+    \footnote #'(0.5 . -2)
+      \markup { The first note }
     a'4 b8
-    \footnote #'(0.5 . 1) #'NoteHead
-      \markup { The third note } \default
-    e c4 d4
+    \footnote #'(0.5 . 1) #'Flag
+      \markup { The third note }
+    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" \default
-    es-\footnote #'(2 . -0.25) \markup { \italic "An E-flat" } \default
-    g-\footnote #'(2 . 3) \markup { \bold "This is a G" } \default
+    \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
   }
 }
@@ -1146,27 +1255,17 @@ línea informativa y la línea de copyright.
 \book {
   \header { copyright = \markup { "Copyright 1970" } }
   \relative c' {
-    \footnote #'(-3 . 0) #'DynamicText
-      \markup { \bold Forte } \default
-
-    \footnote #'(0 . 1.5) #'Slur
-      \markup { A slur } \default
-    a'4\f(
-
-    \footnote #'(0 . -2) #'Beam
-      \markup { Beam } \default
-    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 } } \default
+      \markup  { \teeny { This is a stem } }
     c4
-
     \footnote #'(0 . 0.5) #'AccidentalCautionary
-      \markup \italic { A cautionary accidental } \default
-
-    \footnote #'(0.5 . -0.5) #'TextScript
-      \markup \italic { Slow Down } \default
-    dis?4_"rit."
+      \markup \italic { A cautionary accidental }
+    \footnote #'(1 . 1) "The note itself"
+    dis?4-\footnote #'(0.5 . -0.5) \markup \italic { Slow Down }
+         _"rit."
   }
 }
 @end lilypond
@@ -1191,28 +1290,32 @@ uso de la instrucción @code{\auto-footnote}:
 
 @cindex notas al pie manuales
 
-Las notas al pie manuales toman cuatro argumentos;
-el @var{objeto de presentación} que se va a anotar,
-la posición @samp{(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.
+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.
 
-Como las notas al pie automáticas, las instrucciones
-@code{\footnote} manuales deben ir @emph{antes} 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" } \default
+    \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" \default
+    \footnote
+          \markup { \bold "2" } #'(0.5 . 1)
+          "2. The second note"
+    e
     c4
-    d\p-\footnote "3" #'(0.5 . -1) #'DynamicText "3. Piano" \default
+    d-\footnote "3" #'(0.5 . -1) "3. Piano" \p
   }
 }
 @end lilypond
@@ -1224,10 +1327,10 @@ Para anotar notas de acordes con notas al pie manuales:
   \header { tagline = ##f }
   \relative c' {
     <
-    c-\footnote "1" #'(1 . -1.25) "1. C" \default
-    es-\footnote
-       \markup { \bold "b" } #'(2 . -0.25) "b. E-flat" \default
-    g-\footnote "3" #'(2 . 3) \markup { \italic "iii. G" } \default
+    \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
   }
 }
@@ -1245,40 +1348,31 @@ informativa a la de copyright:
 \book {
   \header { tagline = ##f }
   \relative c' {
-    \footnote
-      \markup { \teeny 1 } #'(-3 . 0) #'DynamicText
-      \markup { 1. \bold Forte } \default
-
-    \footnote
-      \markup { \teeny b } #'(0 . 1.5) #'Slur
-      \markup { b. A slur } \default
-    a'4\f(
-
-    \footnote
-      \markup { \teeny 3 } #'(0 . -2) #'Beam
-      \markup { 3. Beam } \default
-    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 } } \default
+      \markup  { \bold 4. { This is a stem } }
     c4
-
     \footnote
       \markup \concat \teeny { "sharp (v)" }
           #'(0 . 0.5) #'AccidentalCautionary
-      \markup \italic { v. A cautionary accidental } \default
-
-    \footnote
-      \markup \concat \teeny { "a" } #'(0.5 . -0.5) #'TextScript
-      \markup \italic { a. Slow Down } \default
-    dis?4_"rit."
-
-    \breathe
+      \markup \italic { v. A cautionary accidental }
+    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 } \default
+          #'(1.5 . -0.25)
+      \markup { \null } \breathe
   }
 }
 @end lilypond