]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/es/notation/input.itely
Revert "Merge branch 'footnote' into HEAD"
[lilypond.git] / Documentation / es / notation / input.itely
index fcffa2574e912196e7ea7a340dc3b0e7d72de3a9..4668d0a1407815a238c43d41172e2ebdef7c6ebd 100644 (file)
@@ -1,14 +1,14 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
 
 @ignore
-    Translation of GIT committish: a4784ac9714fb3ec737fc4afedd4ea7ef4ad4209
+    Translation of GIT committish: c610645cc9a77cba1a2798280965db142d649ac5
 
     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.15.32"
 
 @node Entrada y salida generales
 @chapter Entrada y salida generales
@@ -203,7 +203,6 @@ principio del archivo.
 @}
 @end example
 
-
 @funindex \bookpart
 
 Se pueden agrupar distintas piezas de música en partes de un libro
@@ -230,6 +229,7 @@ como el libro propiamente dicho, mediante la especificación del bloque
 @}
 @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
@@ -279,6 +279,7 @@ en el archivo fuente @file{eightminiatures.ly}, produce
 @file{eightminiatures-2.pdf}.
 @end itemize
 
+
 @node Nombres de los archivos de salida
 @subsection Nombres de los archivos de salida
 @translationof Output file names
@@ -350,6 +351,7 @@ El código anterior produce los siguientes archivos de salida:
 @file{Nocturne.pdf}.
 @end itemize
 
+
 @node Estructura del archivo
 @subsection Estructura del archivo
 @translationof File structure
@@ -540,6 +542,7 @@ compositor; ciertas piezas tienen mucha más información.
 @menu
 * Crear títulos cabeceras y pies de página::
 * Cabeceras pies y títulos personalizados::
+* Crear notas al pie::
 * Referencia a números de página::
 * Índice general::
 @end menu
@@ -740,6 +743,7 @@ Referencia de la notación:
 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
@@ -1055,11 +1059,270 @@ definiéndola como @code{\oddFooterMarkup}:
 @end lilypond
 
 @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}.
 
 
+@node Crear notas al pie
+@subsection Crear notas al pie
+@translationof Creating footnotes
+
+Se pueden crear dos tipos de notas al pie: automáticas y manuales.
+
+@menu
+* Panorámica de las notas al pie::
+* Notas al pie automáticas::
+* 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.
+
+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
+
+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:
+
+@lilypond[verbatim,quote,ragged-right,papersize=a8]
+\book {
+  \header { tagline = ##f }
+  \relative c' {
+    \footnote #'(0.5 . -2) #'NoteHead
+      \markup { The first note }
+    a'4 b8
+    \footnote #'(0.5 . 1) #'NoteHead
+      \markup { The third note }
+    e 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}:
+
+@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" }
+    >1
+  }
+}
+@end lilypond
+
+@warning{Cuando las notas al pie tienen la misma posición vertical, se
+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 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.
+
+@lilypond[verbatim,quote,ragged-right,papersize=a8]
+\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]
+
+    \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."
+  }
+}
+@end lilypond
+
+Para los elementos @code{\markup} del nivel superior, se requiere el
+uso de la instrucción @code{\auto-footnote}:
+
+@lilypond[verbatim,quote,ragged-right,papersize=a8]
+\book {
+  \header { tagline = ##f }
+  \markup { \auto-footnote "A simple tune" \italic "By me" }
+  \relative c' {
+    a'4 b8 e c4 d
+  }
+}
+@end lilypond
+
+
+@node Notas al pie manuales
+@unnumberedsubsubsec Notas al pie manuales
+@translationof Manual footnotes
+
+@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.
+
+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}:
+
+@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" }
+    b8
+    e-\footnote
+          \markup { \bold "2" } #'(0.5 . 1) #'NoteHead "2. The second note"
+    c4
+    d\p-\footnote "3" #'(0.5 . -1) #'DynamicText "3. Piano"
+  }
+}
+@end lilypond
+
+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" }
+    >1
+  }
+}
+@end lilypond
+
+@warning {Cuando las notas al pie tienen la misma posición vertical, las
+anotaciones se imprimen en orden de descendencia; cuanto más alta es
+la nota al pie, más arriba está en la lista.}
+
+He aquí algunos ejemplos de grobs anotados manualmente, mostrando
+también la posición relativa de las notas al pie respecto a la línea
+informativa a la de copyright:
+
+@lilypond[verbatim,quote,ragged-right,papersize=a8]
+\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]
+
+    \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 \italic { v. A cautionary accidental }
+
+    \footnote
+      \markup \concat \teeny { "a" } #'(0.5 . -0.5) #'TextScript
+      \markup \italic { a. Slow Down }
+    dis?4_"rit."
+
+    \breathe
+    \footnote
+      \markup { \teeny \musicglyph #"rests.4" }
+          #'(1.5 . -0.25) #'BreathingSign
+      \markup { \null }
+  }
+}
+@end lilypond
+
+Para anotar manualmente un elemento @code{\markup} del nivel superior:
+
+@lilypond[verbatim,quote,ragged-right,papersize=a8]
+\book {
+  \header { tagline = ##f }
+  \markup { "A simple tune" \footnote "*" \italic "* By me" }
+  \relative c' {
+    a'4 b8 e c4 d4
+  }
+}
+@end lilypond
+
+@seealso
+Manual de aprendizaje:
+@rlearning{Objetos e interfaces}.
+
+Referencia de la notación:
+@ref{Globos de ayuda},
+@ref{Disposición de la página},
+@ref{Indicaciones de texto},
+@ref{Guiones de texto},
+@ref{Títulos y cabeceras}.
+
+Referencia de funcionamiento interno:
+@rinternals{FootnoteEvent},
+@rinternals{FootnoteItem},
+@rinternals{FootnoteSpanner},
+@rinternals{Footnote_engraver}.
+
+@knownissues
+Varias notas al pie en la misma página solo pueden ir apiladas unas
+sobre otras, y no se pueden imprimir en la misma línea.  Las notas al
+pie no se pueden adjuntar a elementos de silencio multicompás
+@code{MultiMeasureRests}, y pueden colisionar con el objeto
+@code{Staff}, objetos de @code{\markup} y otras anotaciones
+@code{footnote}.  Cuando use una cualquiera de las instrucciones
+@code{footnote} se requiere un bloque @code{\paper} que contenga
+@code{footnote-auto-number = ##f}.
+
+
 @node Referencia a números de página
 @subsection Referencia a números de página
 @translationof Reference to page numbers
@@ -1104,7 +1367,6 @@ para decidir estas dimensiones.  Si el libro tiene entre 10 y 99
 páginas, el medidor puede ser "00", es decir, un número de dos
 dígitos.
 
-
 @predefined
 @funindex \label
 @code{\label},
@@ -1118,13 +1380,13 @@ dígitos.
 @translationof Table of contents
 
 Se puede insertar un índice general o tabla de contenidos utilizando
-la instrucción @code{\markuplines \table-of-contents}.  Los elementos
+la instrucción @code{\markuplist \table-of-contents}.  Los elementos
 que deben aparecer en la tabla de contenidos se introducen con la
 instrucción @code{\tocItem}, que se puede usar en el nivel más alto de
 la jerarquía del código, o dentro de una expresión musical.
 
 @verbatim
-\markuplines \table-of-contents
+\markuplist \table-of-contents
 \pageBreak
 
 \tocItem \markup "Primera partitura"
@@ -1209,7 +1471,7 @@ tocAct =
    (add-toc-item! 'tocActMarkup text))
 
 \book {
-  \markuplines \table-of-contents
+  \markuplist \table-of-contents
   \tocAct \markup { Atto Primo }
   \tocItem \markup { Coro. Viva il nostro Alcide }
   \tocItem \markup { Cesare. Presti omai l'Egizzia terra }
@@ -1229,18 +1491,16 @@ Se pueden añadir puntos de relleno entre un elemento y su número de página:
 }
 
 \book {
-  \markuplines \table-of-contents
+  \markuplist \table-of-contents
   \tocItem \markup { Allegro }
   \tocItem \markup { Largo }
   \markup \null
 }
 @end lilypond
 
-
 @seealso
 Archivos de inicio:
-@file{../ly/toc-init.ly}.
-
+@file{ly/toc-init.ly}.
 
 @predefined
 @funindex \table-of-contents
@@ -1368,7 +1628,6 @@ instalar una nueva versión de LilyPond.
 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},
@@ -1396,7 +1655,6 @@ Cualquiera que sea el método utilizado, la separación de la notació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::
@@ -1640,15 +1898,12 @@ Referencia de la notación:
 @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.
 
@@ -1683,6 +1938,7 @@ Manual de aprendizaje:
 Referencia de la notación:
 @ref{Inclusión de archivos de LilyPond}.
 
+
 @node Caracteres especiales
 @subsection Caracteres especiales
 @translationof Special characters
@@ -1789,7 +2045,6 @@ caracteres que da el punto de código en hexadecimal para cualquier
 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}.
@@ -1813,7 +2068,7 @@ partitura:
   }
   \addlyrics { O \markup { \concat { Ph \char ##x0153 be! } } }
 }
-\markup { "Copyright 2008--2011" \char ##x00A9 }
+\markup { "Copyright 2008--2012" \char ##x00A9 }
 @end lilypond
 
 @cindex copyright, símbolo de
@@ -1881,7 +2136,6 @@ Archivos instalados:
 @file{ly/text-replacements.ly}.
 
 
-
 @node Controlar la salida
 @section Controlar la salida
 @translationof Controlling output
@@ -1893,6 +2147,7 @@ Archivos instalados:
 * 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
@@ -1981,6 +2236,7 @@ c8 d b bes a g c2
 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
@@ -1996,7 +2252,7 @@ el formato de documento portátil (PDF) y PostScript (PS).  Los
 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
@@ -2068,11 +2324,10 @@ La salida estándar de MIDI es un poco primitiva; de forma opcional, se
 encuentra disponible una salida MIDI mejorada y mucho más realista,
 por medio de @ref{El script Articulate}.
 
-@c TODO Check this
-La salida MIDI reserva un canal por cada pentagrama, y otro para los
-ajustes globales.  Por ello, el archivo MIDI no debe tener más de 15
-pautas (o 14 si no se usa la percusión).  Otros pentagramas permanecen
-en silencio.
+La salida MIDI reserva un canal por cada pentagrama, y reserva
+el canal 10 para la percusión.  Sólo hay 16 canales MIDI por cada
+dispositivo, por lo que si la partitura tiene más de 15 pautas, los
+canales MIDI se reutilizarán.
 
 @menu
 * Crear archivos MIDI::
@@ -2084,6 +2339,7 @@ en silencio.
 * El script Articulate::
 @end menu
 
+
 @node Crear archivos MIDI
 @subsection Crear archivos MIDI
 @translationof Creating MIDI files
@@ -2233,24 +2489,16 @@ indicación de tempo:
 \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
 
@@ -2283,6 +2531,7 @@ dentro de un bloque de partitura definido con una instrucción
 @}
 @end example
 
+
 @node ¿Qué sale por el MIDI?
 @subsection ¿Qué sale por el MIDI?
 @translationof What goes into the MIDI output?
@@ -2504,9 +2753,9 @@ general MIDI está limitado al intervalo desde 0.2 hasta 0.5.
   >>
   \layout {}
   \midi {
+    \tempo 2 = 72
     \context {
       \Score
-      tempoWholesPerMinute = #(ly:make-moment 72 2)
       midiMinimumVolume = #0.2
       midiMaximumVolume = #0.5
     }
@@ -2555,10 +2804,7 @@ cada instrumento para que esto funcione correctamente.
   >>
   \layout {}
   \midi {
-    \context {
-      \Score
-      tempoWholesPerMinute = #(ly:make-moment 72 2)
-    }
+    \tempo 2 = 72
   }
 }
 @end lilypond
@@ -2626,10 +2872,7 @@ del clarinete a los mismos valores que el ejemplo anterior.
   >>
   \layout { }
   \midi {
-    \context {
-      \Score
-      tempoWholesPerMinute = #(ly:make-moment 72 2)
-    }
+    \tempo 2 = 72
   }
 }
 @end lilypond
@@ -2699,6 +2942,7 @@ Debido a que el estándar General MIDI no contiene golpes de aro
 (@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
@@ -2755,13 +2999,15 @@ musical en forma de texto.
 * 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
 
 @funindex \displayLilyMusic
 La impresión textual de una expresión musical en notación de LilyPond
-puede hacerse con la función musical @code{\displayLilyMusic} pero solamente
+puede hacerse con la función musical @code{\displayLilyMusic}.
+Para ver el resultado, lo más usual es llamar a LilyPond
 mediante la línea de órdenes.  Por ejemplo,
 
 @example
@@ -2770,7 +3016,7 @@ mediante la línea de órdenes.  Por ejemplo,
 @}
 @end example
 
-imprimirá
+imprime lo siguiente:
 
 @example
 @{ a,4 cis e fis g @}
@@ -2835,9 +3081,7 @@ como guiones de Python, y pueden ser muy útiles para aquellos
 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