@c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
@c This file is part of lilypond-learning.tely
@ignore
- Translation of GIT committish: 2990c6fb0d9c8db236c77de82c18479a0a9aa444
+ Translation of GIT committish: bea70d053e3e279c3fbb18cbce52d995ce04fec7
When revising a translation, copy the HEAD committish of the
version that you are working on. See TRANSLATION for details.
@node On the un-nestedness of brackets and ties
@subsection On the un-nestedness of brackets and ties
-UNTRANSLATED NODE: IGNORE ME
+
+En la escritura del archivo de entrada de LilyPond, hemos podido ver
+algunos tipos de paréntesis, llaves o ángulos de distintos tipos.
+Éstos obedecen a distintas reglas que al principio pueden resultar
+confusas. Antes de explicar estas reglas, demos un repaso a las
+distintas clases de corchetes, llaves y paréntesis.
+
+@c attempt to force this onto a new page
+@need 50
+@multitable @columnfractions .3 .7
+@headitem Tipo de paréntesis
+ @tab Función
+@item @code{@{ .. @}}
+ @tab Encierra un fragmento secuencial de música
+@item @code{< .. >}
+ @tab Encierra las notas de un acorde
+@item @code{<< .. >>}
+ @tab Encierra secciones concurrentes o simultáneas
+@item @code{( .. )}
+ @tab Marca el comienzo y el final de una ligadura de expresión
+@item @code{\( .. \)}
+ @tab Marca el comienzo y el final de una ligadura de fraseo
+@item @code{[ .. ]}
+ @tab Marca el comienzo y el final de un barrado manual
+@end multitable
+
+A las anteriores, debemos añadir otras construcciones que generan
+líneas entre o a través de las notas: las ligaduras de unión (marcadas
+con una tilde curva, @code{~}), los grupos especiales que se escriben
+como @code{\times x/y @{..@}}, y las notas de adorno, que se escriben
+como @code{\grace@{..@}}.
+
+Fuera de LilyPond, el uso convencional de los paréntesis y otros
+corchetes requiere que los distintos tipos se encuentren anidados
+correctamente, como en: @code{<< [ @{ ( .. ) @} ] >>}, de manera que
+los paréntesis que se cierran deben encontrarse en el orden
+exactamente opuesto al de los paréntesis que se abren. Esto
+@strong{es} un requisito para los tres tipos de paréntesis que se
+describen mediante la parabla @q{Encierra} en la tabla anterior: se
+deben anidar correctamente. Sin embargo, el resto de las llaves y
+corchetes, que se encuentran descritos por la palabra @q{Marca} en la
+misma tabla anterior, @strong{no} tienen por qué anidarse
+estrictamente con ninguno de los otros paréntesis. De hecho, éstos no
+son paréntesis en el sentido de que encierran algo: simplemente son
+marcadores que indican dónde empieza o finaliza algo.
+
+Asíi pues, por ejemplo, una ligadura de fraseo puede dar comienzo
+antes de una barra insertada manualmente, y acabar antes de que acabe
+la barra (algo que quizá no sea muy musical, pero es posible):
+
+@lilypond[quote,verbatim,fragment,ragged-right,relative=2]
+ { g8\( a b[ c b\) a] }
+@end lilypond
+
+En general, los distintos tipos de corchete, y los implicados en
+grupos especiiales, ligaduras de unión y notas de adorno, se pueden
+mezclar con total libertad. Este ejemplo muestra una barra que se
+extiende hacia el interior de un grupo de valoración especial (línea
+1), una ligadura de expresión que se prolonga hasta el interior de un
+grupo especial (línea 2), una barra y una ligadura de expresión que se
+prolongan hasta el interior de un grupo especial, una ligadura de
+unión que atraviesa dos grupos especiales, y una ligadura de fraseo
+que sale del interior de un grupo especial (líneas 3 y 4).
+
+@lilypond[quote,verbatim,fragment,ragged-right]
+{
+ r16[ g16 \times 2/3 {r16 e'8] }
+ g16( a \times 2/3 {b d) e' }
+ g8[( a \times 2/3 {b d') e'~]}
+ \times 4/5 {e'32\( a b d' e'} a'4.\)
+}
+@end lilypond
+
@node Voices contain music
@section Voices contain music
* Explicitly instantiating voices::
* Voices and vocals::
@end menu
+
@node I'm hearing Voices
@subsection I'm hearing Voices
@node Creating contexts
@subsection Creating contexts
-Para partituras que sólo tienen una voz y un pentagrama, los contextos se
-crean automáticamente. Para partituras más complejas, es necesario crearlos
-a mano. Existen tres instrucciones que hacen esto.
-
-@itemize
+Sólo puede haber un contexto en el nivel más alto: el contexto de
+partitura @code{Score}. Se crea con la instrucción @code{\score} o,
+en partituras sencillas, se crea automáticamente.
-@item
-La instrucción más fácil es @code{\new}, y es también la más rápida de escribir.
-Se antepone a una expresión musical, por ejemplo
+Para partituras que solamente tienen una voz y un pentagrama, podemos
+dejar que los contextos @code{Voice} y @code{Staff} se creen
+automáticamente, pero para partituras más complejas es necesario
+crearlos a mano. La instrucción más simple que hace esto es
+@code{\new}. Se antepone a una expresión musical, por ejemplo
@funindex \new
-@cindex nuevos, contextos
-@cindex Contexto, creación de
+@cindex contextos nuevos
+@cindex nuevo, contexto
@example
\new @var{tipo} @var{expresión_musical}
@noindent
donde @var{tipo} es el nombre de un contexto (como @code{Staff} o
-@code{Voice}). Esta instrucción crea un contexto nuevo, y empieza a
-interpretar la @var{expresión_musical} con él.
-
-Una aplicación práctica de @code{\new} es una partitura con muchos pentagramas.
-Cada parte que debe ir en su propio pentagrama, va precedida de
-@code{\new Staff}.
-
-@lilypond[quote,verbatim,relative=2,ragged-right,fragment]
-<<
- \new Staff { c4 c }
- \new Staff { d4 d }
->>
-@end lilypond
-
-La instrucción @code{\new} puede también dar nombre al contexto,
-
-@example
-\new @var{tipo} = @var{identificador} @var{música}
-@end example
-Sin embargo, este nombre especificado por el usuario sólo se utiliza si no hay ya otro contexto
-anterior con el mismo nombre.
-
-
-@funindex \context
-
-@item
-Como @code{\new}, la instrucción @code{\context} también dirige una expresión musical
-a un objeto de contexto, pero da al contexto un nombre explícito. La sintaxis
-es
-
-@example
-\context @var{tipo} = @var{identificador} @var{música}
-@end example
-
-En esta forma, la instrucción buscará un contexto existente del @var{tipo} especificado
-que tenga el nombre @var{identificador}. Si ese contexto aún no existe, se crea
-un contexto nuevo con el nombre especificado. Esto es útil si nos vamos a referir
-más tarde al contexto. Por ejemplo, cuando
-se escribe la letra, la melodía está dentro de un contexto con nombre
-
-@example
-\context Voice = "@b{tenor}" @var{música}
-@end example
-
-@noindent
-de forma que los textos se puedan alienar correctamente con sus notas,
+@code{Voice}). Esta instrucción crea un contexto nuevo, y comienza a
+interpretar la @var{expresión_musical} que está dentro de ese
+contexto.
-@example
-\new Lyrics \lyricsto "@b{tenor}" @var{letra}
-@end example
-
-@noindent
-
-Otro uso posible de los contextos con nombre es la fusión de dos expresiones musicales
-distintas en un solo contexto. En el siguiente ejemplo,
-se introducen por separado las articulaciones y las notas,
-
-@example
-musica = @{ c4 c4 @}
-decoracion = @{ s4-. s4-> @}
-@end example
-
-se combinan enviando los dos al mismo contexto @code{Voice},
-
-@example
-<<
- \new Staff \context Voice = "A" \musica
- \context Voice = "A" \decoracion
->>
-@end example
-@lilypond[quote,ragged-right]
-music = { c4 c4 }
-arts = { s4-. s4-> }
-\relative c'' <<
- \new Staff \context Voice = "A" \music
- \context Voice = "A" \arts
->>
-@end lilypond
+Observe que no hay ninguna instrucción @code{\new Score}; el contexto
+@code{Score} único en el nivel más alto se introduce con
+@code{\score}.
-Con este mecanismo, es posible definir un Urtext (una edición
-original), con la posibilidad de poner articulaciones distintas sobre las
-mismas notas.
+La instrucción @code{\new} también puede otorgar un nombre
+identificativo al contexto para distinguirlo de otros contextos del
+mismo tipo:
-@cindex crear contextos
-
-@item
-La tercera instrucción para crear contextos es
@example
-\context @var{tipo} @var{música}
+\new @var{tipo} = @var{identificador} @var{expresión_musical}
@end example
-
-@noindent
-Esto es similar a @code{\context} con @code{= @var{identificador}}, pero se corresponde con
-cualquier contexto del tipo @var{tipo}, sin importar qué nombre se le ha dado.
-
-Esta variante se usa con expresiones musicales que se pueden interpretar en
-varios niveles. Por ejemplo, la instrucción @code{\applyOutput} (véase
-@ref{Running a function on all layout objects}). Sin una instrucción
-@code{\context} explícita, normalmente se aplicaría a @code{Voice}
-
-@example
-\applyOutput #'@var{contexto} #@var{función} % aplicar al contexto Voice
-@end example
-
-Para que se interprete dentro de los niveles de @code{Score} o @code{Staff}, utilice las siguientes
-formas:
-
-@example
-\applyOutput #'Score #@var{función}
-\applyOutput #'Staff #@var{función}
-@end example
-
-@end itemize
+Observe la distinción entre el nombre del tipo de contexto,
+@code{Staff}, @code{Voice}, etc., y el nombre identificativo de una
+instancia en particular de ese tipo, que puede ser cualquier secuencia
+de letras inventada por el usuario. El nombre identificativo se
+utiliza para referirnos más tarde a esa instancia en particular de un
+contexto. Hemos visto esto en la sección acerca de la letra, en
+@ref{Voices and vocals}.
@node Engravers explained
@subsection Engravers explained
-UNTRANSLATED NODE: IGNORE ME
+@cindex grabadores
+
+Todas y cada una de las marcas de la salida impresa de una partitura
+hecha con LiilyPond está producida por un @code{Engraver} (grabador).
+Así, tenemos un grabador para imprimir pentagramas, otro para imprimir
+las cabezas de las notas, otro para las plicas, otro para las barras,
+etc, etc. ¡En total hay más de 120 grabadores! Afortunadamente, para
+la mayor parte de las partituras no es necesario conocer más que
+algunos, y para partituras sencillas no tenemos que saber nada de
+ninguno de ellos.
+
+Los grabadores residen y operan dentro de Contextos. Los grabadores
+como el grabador de la indicación metronómica,
+@code{Metronome_mark_engraver}, cuya acción y resultado se aplica a la
+partitura como un todo, operan en el contexto del nivel más alto: el
+contexto de partitura @code{Score}.
+
+El grabador de la clave @code{Clef_engraver} y el de la armadura
+@code{Key_engraver} se encuentran probablemente en todos los contextos
+de pentagrama (Staff), pues los distintos pentagramas podrían requerir
+diferentes claves y armaduras.
+
+El grabador de las cabezas de nota @code{Note_heads_engraver} y el de
+las plicas @code{Stem_engraver} viven en cada uno de los contextos de
+voz @code{Voice}, el contexto de nivel más bajo de todos.
+
+Cada grabador procesa los objetos particulares asociados con su
+función, y mantiene las propiedades que están relacionadas con dicha
+función. Estas propiedades, como las que están asociadas con los
+contextos, se pueden modificar para cambiar el funcionamiento del
+grabador o el aspecto de esos elementos en la partitura impresa.
+
+Todos los grabadores tienen nombres compuestos de varias palabras que
+describen su función. Sólo está en mayúsculas la inicial de la
+primera palabra, y el resto se le une mediante guiones bajos. Así, el
+grabador @code{Staff_symbol_engraver} es responsable de la creación de
+las líneas del pentagrama, y el @code{Clef_engraver} determina y
+establece la altura o el punto de referencia sobre el pentagrama
+dibujando un símbolo de clave.
+
+A continuación presentamos algunos de los grabadores más comunes,
+junto a su función. Podrá comprobar que es fácil adivinar la función
+a partir del nombre (en inglés), y viceversa.
+
+@multitable @columnfractions .3 .7
+@headitem Grabador
+ @tab Función
+@item Accidental_engraver
+ @tab Hace las alteraciones accidentales, de precaución y de sugerencia.
+@item Beam_engraver
+ @tab Graba las barras
+@item Clef_engraver
+ @tab Graba las claves
+@item Dynamic_engraver
+ @tab Crea reguladores e indicaciones dinámicas textuales
+@item Key_engraver
+ @tab Crea la armadura de la tonalidad
+@item Metronome_mark_engraver
+ @tab Graba la indicación metronómica
+@item Note_heads_engraver
+ @tab Graba la cabeza de las notas
+@item Rest_engraver
+ @tab Graba los silencios
+@item Staff_symbol_engraver
+ @tab Graba las cinco líneas (de forma predeterminada) del pentagrama
+@item Stem_engraver
+ @tab Crea las plicas y los trémolos de una sola plica
+@item Time_signature_engraver
+ @tab Crea las indicaciones de compás
+@end multitable
+
+@smallspace
+
+Más adelante veremos cómo la salida de LilyPond se puede cambiar
+mediante la modificación del funcionamiento de los Grabadores.
+
@node Modifying context properties
@subsection Modifying context properties
projects / lilypond.git / blobdiff