]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/es/notation/input.itely
Merge branch 'lilypond/translation' into staging
[lilypond.git] / Documentation / es / notation / input.itely
index 44839f25315444ab4a9dbcab4ca14f84fa670e0f..d9af64c417f7afa714092d642cb0e33a56ecc926 100644 (file)
@@ -1,14 +1,14 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
 
 @ignore
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
 
 @ignore
-    Translation of GIT committish: 4ca01b6da8d60b0d8575be05ae974429c91becd5
+    Translation of GIT committish: 69618c55ab79b032a109ba9f347831ede1048abc
 
     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
 
 
     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.25"
 
 @node Entrada y salida generales
 @chapter Entrada y salida generales
 
 @node Entrada y salida generales
 @chapter Entrada y salida generales
@@ -434,9 +434,10 @@ contiene sólo la expresión musical anterior se traduce a
         @{ c'4 d' e'2 @}
       @}
     @}
         @{ c'4 d' e'2 @}
       @}
     @}
+    \layout @{ @}
   @}
   @}
-       \layout @{ @}
-       \header @{ @}
+  \paper @{ @}
+  \header @{ @}
 @}
 @end example
 
 @}
 @end example
 
@@ -539,6 +540,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::
 @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
 * Referencia a números de página::
 * Índice general::
 @end menu
@@ -1058,6 +1060,262 @@ Notation Reference:
 @ref{Explicación de los bloques de títulos},
 @ref{Presentación predeterminada de los bloques de título del libro y la partitura}.
 
 @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 @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{\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 @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.
+
+Como las notas al pie automáticas, las instrucciones
+@code{\footnote} manuales deben ir @emph{después} 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
 
 @node Referencia a números de página
 @subsection Referencia a números de página
@@ -1117,13 +1375,13 @@ dígitos.
 @translationof Table of contents
 
 Se puede insertar un índice general o tabla de contenidos utilizando
 @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
 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"
 \pageBreak
 
 \tocItem \markup "Primera partitura"
@@ -1208,7 +1466,7 @@ tocAct =
    (add-toc-item! 'tocActMarkup text))
 
 \book {
    (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 }
   \tocAct \markup { Atto Primo }
   \tocItem \markup { Coro. Viva il nostro Alcide }
   \tocItem \markup { Cesare. Presti omai l'Egizzia terra }
@@ -1228,7 +1486,7 @@ Se pueden añadir puntos de relleno entre un elemento y su número de página:
 }
 
 \book {
 }
 
 \book {
-  \markuplines \table-of-contents
+  \markuplist \table-of-contents
   \tocItem \markup { Allegro }
   \tocItem \markup { Largo }
   \markup \null
   \tocItem \markup { Allegro }
   \tocItem \markup { Largo }
   \markup \null
@@ -1256,7 +1514,7 @@ Archivos de inicio:
 @menu
 * Inclusión de archivos de LilyPond::
 * Distintas ediciones a partir de una misma fuente::
 @menu
 * Inclusión de archivos de LilyPond::
 * Distintas ediciones a partir de una misma fuente::
-* Codificación del texto::
+* Caracteres especiales::
 @end menu
 
 
 @end menu
 
 
@@ -1373,9 +1631,7 @@ Manual de aprendizaje:
 @rlearning{Otras fuentes de información},
 @rlearning{Partituras y particellas}.
 
 @rlearning{Otras fuentes de información},
 @rlearning{Partituras y particellas}.
 
-
 @knownissues
 @knownissues
-
 Si un archivo incluido recibe un nombre igual al de uno de los
 archivos de instalación de LilyPond, el archivo que tiene prioridad es
 el de los archivos de instalación de LilyPond.
 Si un archivo incluido recibe un nombre igual al de uno de los
 archivos de instalación de LilyPond, el archivo que tiene prioridad es
 el de los archivos de instalación de LilyPond.
@@ -1385,15 +1641,18 @@ el de los archivos de instalación de LilyPond.
 @subsection Distintas ediciones a partir de una misma fuente
 @translationof Different editions from one source
 
 @subsection Distintas ediciones a partir de una misma fuente
 @translationof Different editions from one source
 
-Se encuentran disponibles varios mecanismos para facilitar la
-producción de distintas versiones de una partitura a partir de la
-misma fuente musical.  Las variables son quizá más útiles para
-combinar secciones extensas de música y/o anotaciones de diversas
-formas, mientras que las etiquetas son más útiles para seleccionar una
-de entra varias secciones de música más cortas.  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.
+Se pueden usar varios métodos para generar la producción de distintas
+versiones de una partitura a partir de la misma fuente musical.  Las
+variables son quizá el más útil para combinar secciones extensas de
+música y/o anotaciones.  Las etiquetas son más útiles para seleccionar
+una sección de entre varias secciones de música alternativas, más
+cortas, y se pueden usar también para dividir piezas de música en
+distintos trozos.
+
+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::
 
 @menu
 * Uso de las variables::
@@ -1470,9 +1729,12 @@ en archivos separados que se incluyen más tarde, véase @ref{Inclusión de arch
 @funindex \tag
 @funindex \keepWithTag
 @funindex \removeWithTag
 @funindex \tag
 @funindex \keepWithTag
 @funindex \removeWithTag
+@funindex \pushToTag
+@funindex \appendToTag
 @cindex etiqueta
 @cindex mantener música etiquetada
 @cindex quitar música etiquetada
 @cindex etiqueta
 @cindex mantener música etiquetada
 @cindex quitar música etiquetada
+@cindex división en música etiquetada
 
 La instrucción @code{\tag #'@var{parteA}} marca una expresión musical
 con el nombre @var{parteA}.  Las expresiones etiquetadas de esta
 
 La instrucción @code{\tag #'@var{parteA}} marca una expresión musical
 con el nombre @var{parteA}.  Las expresiones etiquetadas de esta
@@ -1602,6 +1864,30 @@ etiquetadas, porque el primer filtro quita todas las secciones
 etiquetadas excepto la que se nombra, y el segundo filtro elimina
 incluso esa sección etiquetada.
 
 etiquetadas excepto la que se nombra, y el segundo filtro elimina
 incluso esa sección etiquetada.
 
+A vecespodemos desear dividir la música en un determinado lugar dentro
+de una expresión musical existente.  Podemos usar @code{\pushToTag} y
+@code{\appendToTag} para añadir material delante o al final de los
+@code{elements} de una construcción musical existente.  No toda
+construcción musical tiene la parte @code{elements}, pero las músicas
+secuenciaes y simultáneas son dos apuestas seguras:
+
+@lilypond[verbatim,quote]
+test = { \tag #'here { \tag #'here <<c''>> } }
+
+{
+  \pushToTag #'here c'
+  \pushToTag #'here e'
+  \pushToTag #'here g' \test
+  \appendToTag #'here c'
+  \appendToTag #'here e'
+  \appendToTag #'here g' \test
+}
+@end lilypond
+
+Las dos instrucciones admiten una etiqueta, el material que dividir en
+cada ocurrencia de la etiqueta, y la expresión etiquetada.  Las
+instrucciones aseguran que se copia todo lo que cambian, de forma que
+el código original @code{\test} retiene su significado.
 
 @seealso
 Manual de aprendizaje:
 
 @seealso
 Manual de aprendizaje:
@@ -1654,13 +1940,25 @@ Manual de aprendizaje:
 Referencia de la notación:
 @ref{Inclusión de archivos de LilyPond}.
 
 Referencia de la notación:
 @ref{Inclusión de archivos de LilyPond}.
 
+@node Caracteres especiales
+@subsection Caracteres especiales
+@translationof Special characters
+
+@cindex caracteres especiales
+@cindex caracteres no ASCII
+
+@menu
+* Codificación del texto::
+* Unicode::
+* Alias de ASCII::
+@end menu
+
+
 @node Codificación del texto
 @node Codificación del texto
-@subsection Codificación del texto
+@unnumberedsubsubsec Codificación del texto
 @translationof Text encoding
 
 @translationof Text encoding
 
-@cindex Unicode
 @cindex UTF-8
 @cindex UTF-8
-@cindex caracteres no ASCII
 
 LilyPond usa el conjunto de caracteres definido por el consorcio
 Unicode y la norma ISO/IEC 10646.  Define un nombre único y un código
 
 LilyPond usa el conjunto de caracteres definido por el consorcio
 Unicode y la norma ISO/IEC 10646.  Define un nombre único y un código
@@ -1727,6 +2025,12 @@ portuguese = \lyricmode {
 \addlyrics { \portuguese }
 @end lilypond
 
 \addlyrics { \portuguese }
 @end lilypond
 
+
+@node Unicode
+@unnumberedsubsubsec Unicode
+
+@cindex Unicode
+
 Para introducir un carácter aislado para el que se conoce el punto de
 código Unicode pero no está disponible en el editor que se está
 usando, use @code{\char ##xhhhh} o bien @code{\char #dddd} dentro de
 Para introducir un carácter aislado para el que se conoce el punto de
 código Unicode pero no está disponible en el editor que se está
 usando, use @code{\char ##xhhhh} o bien @code{\char #dddd} dentro de
@@ -1766,7 +2070,7 @@ partitura:
   }
   \addlyrics { O \markup { \concat { Ph \char ##x0153 be! } } }
 }
   }
   \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
 @end lilypond
 
 @cindex copyright, símbolo de
@@ -1780,6 +2084,58 @@ Para escribir el símbolo de copyright en la nota de créditos, utilice:
 @end example
 
 
 @end example
 
 
+@node Alias de ASCII
+@unnumberedsubsubsec Alias de ASCII
+@translationof ASCII aliases
+
+Se puede incluir una lista de alias de ASCII para caracteres
+especiales:
+
+@lilypond[quote,verbatim]
+\paper {
+  #(include-special-characters)
+}
+
+\markup "&flqq; &ndash; &OE;uvre incomplète&hellip; &frqq;"
+
+\score {
+  \new Staff { \repeat unfold 9 a'4 }
+  \addlyrics {
+    This is al -- so wor -- kin'~in ly -- rics: &ndash;_&OE;&hellip;
+  }
+}
+
+\markup \column {
+  "The replacement can be disabled:"
+  "&ndash; &OE; &hellip;"
+  \override #'(replacement-alist . ()) "&ndash; &OE; &hellip;"
+}
+@end lilypond
+
+También podemos hacer nuestros propios alias, ya sea de forma global:
+
+@lilypond[quote,verbatim]
+\paper {
+  #(add-text-replacements!
+    '(("100" . "hundred")
+      ("dpi" . "dots per inch")))
+}
+\markup "A 100 dpi."
+@end lilypond
+
+o local:
+
+@lilypond[quote,verbatim]
+\markup \replace #'(("100" . "hundred")
+                    ("dpi" . "dots per inch")) "A 100 dpi."
+@end lilypond
+
+@seealso
+Referencia de la notación:
+@ref{Lista de caracteres especiales}.
+
+Archivos instalados:
+@file{ly/text-replacements.ly}.
 
 
 
 
 
 
@@ -1969,11 +2325,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}.
 
 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::
 
 @menu
 * Crear archivos MIDI::
@@ -2662,7 +3017,8 @@ musical en forma de texto.
 
 @funindex \displayLilyMusic
 La impresión textual de una expresión musical en notación de LilyPond
 
 @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
 mediante la línea de órdenes.  Por ejemplo,
 
 @example
@@ -2671,7 +3027,7 @@ mediante la línea de órdenes.  Por ejemplo,
 @}
 @end example
 
 @}
 @end example
 
-imprimirá
+imprime lo siguiente:
 
 @example
 @{ a,4 cis e fis g @}
 
 @example
 @{ a,4 cis e fis g @}