@c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
@c This file is part of lilypond-learning.tely
@ignore
- Translation of GIT committish: 8e7d8cfcb162ae90efc1d24bd378de1868f98982
+ Translation of GIT committish: 85b54e04be6730bd0781f3135ee741010e099fd8
When revising a translation, copy the HEAD committish of the
version that you are working on. See TRANSLATION for details.
@end ignore
-@c \version "2.11.51"
+@c \version "2.11.61"
@node Fundamental concepts
igualmente bellas pero más complejas.
@menu
-* How LilyPond files work::
-* Voices contain music::
-* Contexts and engravers::
-* Extending the templates::
-@end menu
+* How LilyPond input files work::
+* Voices contain music::
+* Contexts and engravers::
+* Extending the templates::
+@end menu
-@node How LilyPond files work
-@section How LilyPond files work
+@node How LilyPond input files work
+@section How LilyPond input files work
El formato de entrada de LilyPond es bastante libre en su forma y
concede a los usuarios con experiencia mucha flexibilidad para
@menu
-* Introduction to the LilyPond file structure::
-* Score is a (single) compound musical expression::
-* Nesting music expressions::
-* On the un-nestedness of brackets and ties::
-@end menu
+* Introduction to the LilyPond file structure::
+* Score is a (single) compound musical expression::
+* Nesting music expressions::
+* On the un-nestedness of brackets and ties::
+@end menu
@node Introduction to the LilyPond file structure
@subsection Introduction to the LilyPond file structure
@example
\version @w{"@version{}"}
+\header @{ @}
\score @{
@var{...expresión musical compuesta...} % toda la música viene aquí
- \header @{ @}
\layout @{ @}
\midi @{ @}
@}
constituye un útil punto de partida.
@funindex \book
+@funindex book
@funindex \score
-@cindex book
-@cindex score
+@funindex score
+@cindex book (libro)
+@cindex score (partitura)
@cindex libro
@cindex partitura
acabamos de ver.
@cindex contextos implícitos
+@cindex implícitos, contextos
@strong{¡Advertencia!} Muchos de los ejemplos que aparecen en la
documentación de LilyPond omiten las instrucciones @code{\new Staff} y
@end example
@funindex \header
+@funindex header
@funindex \layout
+@funindex layout
@funindex \midi
+@funindex midi
@cindex header
@cindex layout
@cindex midi
expresión musical. Por tanto, se pueden situar dentro de un bloque
@code{\score} o fuera de él. De hecho, estas instrucciones se sitúan
por lo general fuera del bloque @code{\score} (por ejemplo,
-@code{\header} se suele colocar antes de la instrucción @code{\score}
-porque las cabeceras aparecen de forma natural al principio de la
-partitura. Es tan sólo otra abreviatura que LilyPond acepta.
+@code{\header} se suele colocar antes de la instrucción @code{\score},
+como muestra el ejemplo que aparece al principio de la sección.
Dos instrucciones más que no hemos visto aún son @code{\layout @{ @}}
y @code{\midi @{@}}. Si aparecen tal y como se muestran aquí, hacen
@ruser{Creating MIDI files}.
@cindex partituras, varias
+@cindex book, bloque implícito
+@cindex implícito, bloque book
+@funindex \book
+@funindex book
Podemos escribir varios bloques @code{\score}. Cada uno de ellos
recibirá el mismo tratamiento que una partitura independiente, pero se
Cada bloque @code{\score} es un trozo de música separado dentro de un
bloque @code{\book}.
+@cindex layout, efecto de la situación del bloque
+
Cada bloque @code{\layout} afecta al bloque @code{\score} o
@code{\book} dentro del cual aparece (es decir, un bloque
@code{\layout} dentro de un bloque @code{\score} afecta solamente a
@code{\book}, ya sea explícita o implícitamente) afecta a los bloques
@code{\score} que están dentro de ese @code{\book}.
-Cada bloque @code{\context} afecta al contexto con nombre (por
-ejemplo, @code{\StaffGroup}) a todo lo largo del bloque (@code{\score}
-o @code{\book}) en que aparece.
-
Para ver más detalles, consulte @ruser{Multiple scores in a book}.
@cindex variables
afectan a los nombres de variable se detallan en @ruser{File
structure}.
-
@seealso
Para ver una definición completa del formato del código de entrada,
@node Score is a (single) compound musical expression
@subsection Score is a (single) compound musical expression
-@cindex expresión musical compuesta
-@cindex música, expresión compuesta de
-@funindex \score
@cindex score
@cindex partitura
+@cindex contenido del bloque score
+@cindex score, contenido del bloque
+@cindex compuesta, expresión musical
+@cindex musical, expresión, compuesta
+@cindex expresión musical compuesta
+@funindex \score
+@funindex score
-En la sección anterior, @ref{How LilyPond files work} hemos podido
-ver la organización general de los archivos de entrada de LilyPond.
-Pero parece que nos saltamos la parte más importante: ¿cómo
-averiguamos qué escribir después de @code{\score}?
+En la sección anterior, @ref{Introduction to the LilyPond file
+structure}, hemos podido ver la organización general de los archivos
+de entrada de LilyPond. Pero parece que nos saltamos la parte más
+importante: ¿cómo averiguamos qué escribir después de @code{\score}?
No nos hemos saltado nada en absoluto. El gran misterio es, sencillamente,
que no hay @emph{ningún} misterio. La siguiente línea lo explica
todo:
@quotation
-@emph{Un bloque @code{\score} debe comenzar con una única expresión
-musical compuesta.}
+@emph{Un bloque @code{\score} debe comenzar con una expresión musical
+compuesta.}
@end quotation
@noindent
Para comprender lo que se entiende por expresión musical y expresión
-musical compuesta, quizá encuentre útil dar un repaso a @ref{Music
-expressions explained}. En esta sección, vimos cómo elaborar grandes
-expresiones musicales a partir de pequeñas piezas (comenzábamos con
-notas, luego acordes, etc.). Ahora partiremos de una gran expresión
-musical y recorreremos el camino inverso hacia abajo.
+musical compuesta, quizá encuentre útil dar un repaso al tutorial,
+@ref{Music expressions explained}. En esta sección, vimos cómo
+elaborar grandes expresiones musicales a partir de pequeñas piezas
+(comenzábamos con notas, luego acordes, etc.). Ahora partiremos de
+una gran expresión musical y recorreremos el camino inverso hacia
+abajo.
@example
\score @{
<<
\new Staff = "cantante" <<
>>
- \new PianoStaff = piano <<
+ \new PianoStaff = "piano" <<
>>
>>
\layout @{ @}
Recuerde que usamos @code{<<} y @code{>>} en vez de @code{@{ ... @}}
para presentar música simultánea. Y, por supuesto, queremos presentar
las partes vocal y del piano al mismo tiempo, ¡no una después de otra!
-Sin embargo, la construcción @code{<< ... >>} no es realmente
-necesaria para el pentagrama del cantante (pues contiene una sola
-expresión musical), pero los pentagramas (Staff) a menudo necesitan
-varias voces (Voice) en su interior, así es bueno adoptar el hábito de
-usar @code{<< ... >>} en lugar de llaves. Escribiremos algo de música
-real más tarde; por ahora limitémonos a poner algunas notas y letra de
-relleno.
+Observe que la construcción @code{<< ... >>} no es realmente necesaria
+para el pentagrama del cantante (pues contiene una sola expresión
+musical); sin embargo, el uso de @code{<< ... >>} en lugar de llaves
+sigue siendo necesario si la música que debe ir en el pentagrama está
+compuesta por dos expresiones simultáneas, por ejemplo dos voces
+simultáneas o una voz con letra. Escribiremos algo de música real más
+tarde; por ahora limitémonos a poner algunas notas y letra de relleno.
@lilypond[verbatim,quote,ragged-right]
\score {
superior (mano derecha) y un pentagrama inferior (mano izquierda).
En este momento podríamos comenzar a meter las notas. Dentro de las
-llaves que siguen a @code{\new Voice = vocal}, podríamos empezar
+llaves que siguen a @code{\new Voice = "vocal"}, podríamos empezar
escribiendo
@example
}
@end lilypond
-Tenga cuidado con la diferencia entre las notas, que se introducen con
-@code{\relative}, y la letra, que se introduce con @code{\lyricmode}.
-Estas instrucciones son esenciales para decirle a LilyPond que
-interprete el contenido que viene a continuación como música y texto,
-respectivamente.
+Tenga cuidado con la diferencia entre las notas, que van precedidas de
+@code{\relative} o insertadas directamente en la expresión musical, y
+la letra, que va precedida de @code{\lyricmode}. Estas instrucciones
+son esenciales para decirle a LilyPond que interprete el contenido que
+viene a continuación como música y texto, respectivamente.
Cuando escriba una sección @code{\score} o cuando la esté leyendo,
-hágalo despacio y con cuidado. Comience por la capa exterior y luego
-trabaje sobre cada una de las capas interiores. También ayuda ser
-estricto con los márgenes (asegúrese de que en su editor de texto cada
-elemento de la misma capa comienza en la misma posición horizontal).
+hágalo despacio y con cuidado. Comience por el nivel exterior y luego
+trabaje sobre cada uno de los niveles interiores. También es de gran
+ayuda ser muy estricto con los márgenes (asegúrese de que en su editor
+de texto cada elemento del mismo nivel comienza en la misma posición
+horizontal).
+
+@seealso
+
+Referencia de la notación:
+@ruser{Structure of a score}.
@node Nesting music expressions
@subsection Nesting music expressions
+@cindex pentagramas temporales
+@cindex temporales, pentagramas
+@cindex ossias
+
No es esencial declarar todos los pentagramas al comienzo; se pueden
crear temporalmente en cualquier momento. Esto es de especial
utilidad para crear secciones de ossia (véase @rglos{ossia}). A
\new Staff {
\relative g' {
r4 g8 g c4 c8 d |
- e4 r8
+ e4 r8
<<
{ f c c }
\new Staff {
siguiente:
@lilypond[verbatim,quote,ragged-right]
-\new Staff ="main" {
+\new Staff = "main" {
\relative g' {
r4 g8 g c4 c8 d |
e4 r8
colocar por encima del pentagrama llamado @qq{main} en vez de la
posición predeterminada que sería por debajo.
+@seealso
+
Los fragmentos de ossia se escriben a menudo sin clave y sin
indicación de compás, y generalmente en un tipo más pequeño. Esto
necesitaría más instrucciones que aún no se han visto. Véase
-@ref{Size of objects}
+@ref{Size of objects} y @ruser{Ossia staves}.
+
-
@node On the un-nestedness of brackets and ties
@subsection On the un-nestedness of brackets and ties
@cindex corchetes y paréntesis, anidado de
+@cindex corchetes y paréntesis, tipos de
+@cindex corchetes y paréntesis, encerrar frente a marcar
+@cindex paréntesis y corchetes, anidado de
+@cindex paréntesis y corchetes, tipos de
+@cindex paréntesis y corchetes, encerrar frente a marcar
En la escritura del archivo de entrada de LilyPond, hemos podido ver
algunos tipos de paréntesis, llaves o ángulos de distintos tipos.
@item @code{< .. >}
@tab Encierra las notas de un acorde
@item @code{<< .. >>}
- @tab Encierra secciones concurrentes o simultáneas
+ @tab Encierra expresiones musicales simultáneas
@item @code{( .. )}
@tab Marca el comienzo y el final de una ligadura de expresión
@item @code{\( .. \)}
fundamental de todos--.
@menu
-* I'm hearing Voices::
-* Explicitly instantiating voices::
-* Voices and vocals::
-@end menu
+* I'm hearing Voices::
+* Explicitly instantiating voices::
+* Voices and vocals::
+@end menu
@node I'm hearing Voices
@subsection I'm hearing Voices
@cindex polifonía
@cindex capas
+@cindex varias voces
+@cindex voces, varias
@cindex Voice (voz), contexto de
-@cindex contexto de voz
+@cindex contexto Voice (de voz)
@cindex simultánea, música
@cindex concurrente, música
+@cindex voces frente a acordes
+@cindex acordes frente a voces
De las capas más profundas de una partitura de LilyPond, las más bajas
y más fundamentales reciben el nombre de @q{Voice contexts}
distintas duraciones: la negra Re, y la corchea Fa sostenido. ¿Cómo se
codifica esto? No se pueden escribir como un acorde porque todas las
notas de un acorde deben tener la misma duración. Y no se pueden
-escribir como dos notas separadas porque tienen que empezar en el
+escribir como dos notas en secuencia porque tienen que empezar en el
mismo momento. Aquí es donde se necesitan dos voces.
Veamos cómo se hace esto dentro de la sintaxis de entrada de LilyPond.
} >>
@end lilypond
+@cindex voces, nombrado de
+@cindex voces que cruzan corchetes
+@cindex ligaduras que cruzan corchetes
Este ejemplo tiene sólo dos voces, pero la misma construcción se puede
usar para codificar tres o más voces mediante la adición de más
}
@end lilypond
-@funindex \voiceXXXStyle
+@funindex \voiceOneStyle
+@funindex \voiceTwoStyle
+@funindex \voiceThreeStyle
+@funindex \voiceFourStyle
+@funindex \voiceNeutralStyle
Las instrucciones @code{\voiceXXXStyle} están pensadas principalmente
para usarlas en documentos educativos como este mismo. Modifican el
de forma que las voces se puedan distinguir fácilmente. La voz uno
está establecida a rombos rojos, la voz dos a triángulos azules, la
voz tres a círculos verdes con aspas, y la voz cuatro (que no se
-utiliza aquí) a aspas color magenta. Veremos más adelante cómo el
-usuario puede crear instrucciones como éstas. Véase @ref{Visibility
-and color of objects} y @ref{Using variables for tweaks}.
+utiliza aquí) a aspas color magenta. @code{\voiceNeutralStyle} (que
+tampoco se usa aquí) devuelve todo al estilo predeterminado. Veremos
+más adelante cómo el usuario puede crear instrucciones como éstas.
+Véase @ref{Visibility and color of objects} y @ref{Using variables for
+tweaks}.
+@cindex polifonía y modo relativo
+@cindex relativo, modo, polifonía y
La polifonía no cambia la relación de las notas dentro de un bloque
@code{\relative @{ @}}. La altura de cada nota aún se calcula con
@code{notaB} es relativa a @code{notaA} @*
@code{notaC} es relativa a @code{notaB}, no a @code{notaA}; @*
@code{notaD} es relativa a @code{notaB}, no a @code{notaA} ni a
-@code{notaC}. @*
-@code{notaE} es relativa a @code{notaD}, no a @code{notaA}
+@code{notaC}; @*
+@code{notaE} es relativa a @code{notaD}, no a @code{notaA}.
Una forma alternativa, que podría ser más clara si las notas en las
voces están muy separadas, es colocar una instrucción @code{\relative}
<<
{ % Voice one
\voiceOneStyle
- c2 aes4. bes8
+ c2 aes4. bes8
}
\\ % Voice two
{ \voiceTwoStyle
- aes2 f4 fes
+ aes2 f4 fes
}
\\ % No Voice three (we want stems down)
\\ % Voice four
\once \override NoteColumn #'force-hshift = #0
<ees c>2
\once \override NoteColumn #'force-hshift = #0.5
- des2
+ des2
}
>> |
<c ees aes c>1 |
@end lilypond
@cindex plica abajo
+@cindex voces y dirección de las plicas
+@cindex plicas, voces y dirección de las
@cindex plica arriba
Las direcciones de las plicas se asignan automáticamente de forma que
maneras de ajustar la colocación horizontal de las notas. Aún no
estamos preparados para ver cómo corregir esto, así que dejaremos este
problema aparcado hasta una sección posterior (véase la propiedad
-force-hshift en @ref{Fixing overlapping notation} )
+@code{force-hshift} en @ref{Fixing overlapping notation}).
+
+@seealso
+
+Referencia de la notación:
+@ruser{Multiple voices}.
+
@node Explicitly instantiating voices
@subsection Explicitly instantiating voices
@funindex \voiceOne
+@funindex voiceOne
@funindex \voiceTwo
+@funindex voiceTwo
@funindex \voiceThree
+@funindex voiceThree
@funindex \voiceFour
+@funindex voiceFour
+@funindex \oneVoice
+@funindex oneVoice
@funindex \new Voice
@cindex contextos de voz, creación de
>>
@end lilypond
+@cindex voces, retorno a única
+@cindex retorno a voz única
+
Las instrucciones @code{\voiceXXX} establecen la dirección de las
plicas, ligaduras de expresión, ligaduras de prolongación,
articulaciones, anotaciones de texto, puntillos y digitaciones.
@cindex anidado de expresiones musicales
@cindex anidado de construcciones simultáneas
-
+@cindex anidado de voces
@cindex voces temporales
@cindex voces, anidado de
}
% Initiate second voice
\new Voice {
- % set stems, etc down
+ % Set stems, etc, down
\voiceTwo
s4 r8 e4 d c8 ~ | c8 b16 a b8 g ~ g2 |
}
% Initiate third voice
\new Voice {
- % set stems, etc up
+ % Set stems, etc, up
\voiceThree
s1 | s4 b4 c2 |
}
>>
@end lilypond
+@subsubheading Note columns
+
@cindex columna de notas
+@cindex colisiones de notas
+@cindex notas, colisiones de
@cindex desplazamiento, instrucciones de
@funindex \shiftOff
+@funindex shiftOff
@funindex \shiftOn
+@funindex shiftOn
@funindex \shiftOnn
+@funindex shiftOnn
@funindex \shiftOnnn
+@funindex shiftOnnn
Las notas cercanas de un acorde, o las notas que se producen al mismo
tiempo en distintas voces, se disponen en dos (y ocasionalmente más)
desplazamiento, se producirá el mensaje de error @qq{Chocan demasiadas
columnas de notas}.
+@seealso
+
+Referencia de la notación:
+@ruser{Multiple voices}.
+
+
@node Voices and vocals
@subsection Voices and vocals
@funindex \new Lyrics
@funindex \lyricsto
+@funindex lyricsto
+@funindex Lyrics
@cindex Lyrics, creación de un contexto
@cindex letra, creación de un contexto de
@cindex letra, enlazar con una voz
@cindex letra y barrado
@cindex barrado y letra
@funindex \autoBeamOff
+@funindex autoBeamOff
El barrado automático que LilyPond usa de forma predeterminada
funciona bien para la música instrumental, pero no tan bien para
para desactivar el barrado automático.
@funindex \new ChoirStaff
+@funindex ChoirStaff
@funindex \lyricmode
+@funindex lyricmode
@cindex vocal, estructura de una partitura
+@cindex coro, sistema de
Ahora vamos a reutilizar el ejemplo anterior de «Judas Macabeo» para
ilustrar esta técnica más flexible. Primero la reescribiremos para
cuando se hagan demasiado largos.
@cindex himno, estructura de
+@cindex SATB, estructura de
+@cindex vocal, partitura, varias estrofas
+@cindex varias estrofas vocales
+@cindex estrofas, varias, vocales
A continuación podemos ver un ejemplo final de la primera línea de un
himno con cuatro estrofas, para coro SATB. En este caso la letra de
@cindex libro
@cindex book, ejemplo de su uso
@funindex \book
+@funindex book
Sin embargo, y aunque esto es un interesante y útil ejercicio
destinado a ayudarle a comprender cómo funcionan los bloques
}
@end lilypond
+@seealso
+
+Referencia de la notación:
+@ruser{Vocal music}.
+
+
@node Contexts and engravers
@section Contexts and engravers
LilyPond.
@menu
-* Contexts explained::
-* Creating contexts::
-* Engravers explained::
-* Modifying context properties::
-* Adding and removing engravers::
+* Contexts explained::
+* Creating contexts::
+* Engravers explained::
+* Modifying context properties::
+* Adding and removing engravers::
@end menu
@node Contexts explained
sin guión ni barra baja, por ejemplo:
@code{GregorianTranscriptionStaff}.
+@seealso
+
+Referencia de la notación:
+@ruser{Contexts explained}.
+
@node Creating contexts
@subsection Creating contexts
@funindex \new
+@funindex new
@cindex nuevos contextos
@cindex creación de contextos
@cindex contextos, creación de
un ejemplo anotado de música real:
@lilypond[quote,verbatim,ragged-right]
-\score { % start single compound music expression
+\score { % start of single compound music expression
<< % start of simultaneous staves section
\time 2/4
\new Staff { % create RH staff
g8 <bes d> ees, <g c> |
g8 <bes d> ees, <g c> |
} % end of LH voice one notes
- } % end of first LH voice
+ } % end of LH voice one
\new Voice { % create LH voice two
\voiceTwo
\relative g { % start of LH voice two notes
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}.
+de letras inventada por el usuario. En el nombre identificativo
+también se pueden utilizar dígitos y espacios, pero en este caso aquél
+debe ir entre comillas p.ej. @code{\new Staff = "MiPentagrama 1"
+@var{expresión_musical}}. 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}.
+
+@seealso
+
+Referencia de la notación:
+@ruser{Creating contexts}.
+
@node Engravers explained
@subsection Engravers explained
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}.
+@code{Metronome_mark_engraver}, cuya acción y resultado se aplican 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.
+de pentagrama (@code{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
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
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
+@multitable @columnfractions .3 .7
@headitem Grabador
@tab Función
@item Accidental_engraver
@tab Graba las barras
@item Clef_engraver
@tab Graba las claves
-@item Dynamic_engraver
+@item Completion_heads_engraver
+ @tab Splits notes which cross bar lines
+@c The old Dynamic_engraver is deprecated. -jm
+@item New_dynamic_engraver
@tab Crea reguladores e indicaciones dinámicas textuales
+@item Forbid_line_break_engraver
+ @tab Prevents line breaks if a musical element is still active
@item Key_engraver
@tab Crea la armadura de la tonalidad
@item Metronome_mark_engraver
Más adelante veremos cómo la salida de LilyPond se puede cambiar
mediante la modificación del funcionamiento de los Grabadores.
-
+
+@seealso
+
+Referencia de funcionamiento interno:
+@rinternals{Engravers and Performers}.
+
@node Modifying context properties
@subsection Modifying context properties
@cindex contexto, propiedades de, modificación
@cindex modificar las propiedades de contexto
@funindex \set
+@funindex set
@funindex \unset
+@funindex unset
Los contextos se responsabilizan de mantener los valores de un cierto
número de @emph{properties} de contexto. Muchas de ellas se pueden
valor Booleano, hay que escribir dos signos de cuadradillo, por
ejemplo: @code{##t}.
+@cindex propiedades que funcionan en contextos
+@cindex establecer propiedades en contextos
+
Antes de poder establecer cualquiera de estas propiedades, tenemos que
saber en qué contexto operan. A veces es algo obvio, pero en
ocasiones puede ser algo enrevesado. Si especificamos un contexto
equivocado, no se produce ningún mensaje de error, pero el
funcionamiento esperado no tendrá lugar. Por ejemplo, la propiedad
@code{instrumentName} (nombre del instrumento) vive claramente dentro
-del contexto de Staff, puesto que es el pentagrama el que debe ser
-nombrado. En este ejemplo, el primer pentagrama resulta etiquetado,
-pero no el segundo, porque hemos omitido el nombre del contexto.
+del contexto de @code{Staff}, puesto que es el pentagrama el que debe
+ser nombrado. En este ejemplo, el primer pentagrama resulta
+etiquetado, pero no el segundo, porque hemos omitido el nombre del
+contexto.
@lilypond[quote,verbatim,ragged-right]
<<
}
\new Staff \relative c' {
\set instrumentName = #"Alto" % Wrong!
- d4 d
+ d4 d
}
>>
@end lilypond
-Recuerde que el nombre del contexto predeterminado es Voice, así que
-la segunda instrucción @code{\set} establece la propiedad
-@code{instrumentName} del contexto Voice a @qq{Alto}, pero como
+Recuerde que el nombre del contexto predeterminado es @code{Voice},
+así que la segunda instrucción @code{\set} establece la propiedad
+@code{instrumentName} del contexto @code{Voice} a @qq{Alto}, pero como
LilyPond no busca esta propiedad en el contexto @code{Voice}, no se
realiza ninguna acción. Esto no es un error, y no se registra ningún
mensaje en el archivo Log de registro de errores.
cualquier @q{property} (ficticia) usando cualquier nombre que queramos
en cualquier contexto que exista, mediante el uso de la instrucción
@code{\set}. Pero si el nombre no es conocido para LilyPond, no
-producirá ninguna acción. Esta es una de las razones por las que es
-muy recomendable usar un editor que sea sensible al contexto y con
-resaltado de la sintaxis para la edición de archivos de LilyPond, como
-por ejemplo Vim, Jedit, ConTEXT o Emacs, ya que los nombres de
-propiedades desconocidas se resaltarán de forma distinta.
+producirá ninguna acción. Algunos editores de texto que apoyan a los
+archivos de entrada de LilyPond de manera especial, documentan los
+nombres de propiedades con viñetas cuando psamos sobre ellos con el
+puntero del ratón, como JEdit con la extensión LilyPondTool, o
+resaltan los nombres de propiedades desconocidas de manera diferente,
+como ConTEXT. Si no se utiliza un editor con tales posibilidades, se
+recomienda comprobar la corrección del nombre de la propiedad en el
+manual de Referencia de funcionamiento interno: véase
+@rinternals{Tunable context properties} o @rinternals{Contexts}.
La propiedad @code{instrumentName} tendrá efecto solamente si se
establece dentro del contexto @code{Staff}, pero algunas propiedades
se pueden establecer en más de un contexto. Por ejemplo, la propiedad
-@code{extraNatural} está establecida por defecto al valor ##t
-(verdadero) para todos los pentagramas. Si se establece a ##f (falso)
-en un contexto de @code{Staff} determinado, se aplicará solamente a
-las alteraciones de ese pentagrama. Si se establece a falso en el
-contexto de la partitura, @code{Score}, se aplicará a todos los
-pentagramas.
+@code{extraNatural} está establecida por defecto al valor @code{##t}
+(verdadero) para todos los pentagramas. Si se establece a @code{##f}
+(falso) en un contexto de @code{Staff} determinado, se aplicará
+solamente a las alteraciones de ese pentagrama. Si se establece a
+falso en el contexto de la partitura, @code{Score}, se aplicará a
+todos los pentagramas.
Así, esto desactivará los becuadros adicionales en un pentagrama:
valor predeterminado, no el valor en curso.
@lilypond[quote,verbatim,ragged-right,relative=1,fragment]
-c4
+c4
% make note heads smaller
\set fontSize = #-4
d e
Hemos podido ver cómo establecer los valores de diversos tipos de
propiedad diferentes. Observe que los números enteros y reales van
siempre precedidos de un símbolo de cuadradillo, @code{#}, mientras
-que un valor booleano verdadero o falso se especifica mediante ##t y
-##f, con dos cuadradillos. Una propiedad de texto se debe encerrar
-entre comillas dobles, como antes, aunque veremos más adelante que el
-texto realmente se puede especificar de una forma mucho más general
-utilizando la potentísima instrucción @code{markup}.
+que un valor booleano verdadero o falso se especifica mediante
+@code{##t} y @code{##f}, con dos cuadradillos. Una propiedad de texto
+se debe encerrar entre comillas dobles, como antes, aunque veremos más
+adelante que el texto realmente se puede especificar de una forma
+mucho más general utilizando la potentísima instrucción @code{markup}.
+@unnumberedsubsubsec Setting context properties with @code{\with}
@funindex \with
+@funindex with
@cindex contexto, propiedades de, establecimiento con \with
Las propiedades de contexto también se pueden establecer en el momento
dinámicamente utilizando @code{\set} y ser devueltas a sus valores
predeterminados mediante @code{\unset}.
+@cindex fontSize (tamaño de la tipografía)
+@cindex fuente, tamaño de la
+@cindex tamaño de la fuente
+
La propiedad @code{fontSize} se trata de forma distinta. Si se ajusta
dentro de una cláusula @code{\with}, tiene el efecto de reiniciar el
valor predeterminado del tamaño de la fuente tipográfica. Si más
tarde se modifica con @code{\set}, este nuevo valor predeterminado
-puede restablecerse con la instrucción @code{\unset fontSize}.xs
+puede restablecerse con la instrucción @code{\unset fontSize}.
+
+@unnumberedsubsubsec Setting context properties with @code{\context}
+
+@cindex contextos, establecer propiedades de, con \context
+@funindex \context
+@funindex context
+
+Los valores de propiedad de los contextos se pueden establecer para
+@emph{todos} los contextos de un tipo determinado, como por ejemplo
+todos los contextos de @code{Staff}, con una única instrucción. El
+tipo de contexto se identifica mediante la utilización del nombre de
+su tipo, como @code{Staff}, precedido de una barra invertida:
+@code{\Staff}. El enunciado que establece el valor de la propiedad es
+el mismo que el que está en un bloque @code{\with}, presentado
+anteriormente. Se coloca en un bloque @code{\context} dentro de un
+bloque @code{\layout}. Cada bloque @code{\context} afecta a todos los
+contextos del tipo especificado a lo largo del bloque @code{\score} o
+@code{\book} en el que aparece el bloque @code{\layout}. A
+continuación presentamos un ejemplo que muestra el formato:
+
+@lilypond[verbatim,quote]
+\score {
+ \new Staff {
+ \relative c'' {
+ cis4 e d ces
+ }
+ }
+ \layout {
+ \context {
+ \Staff
+ extraNatural = ##t
+ }
+ }
+}
+@end lilypond
+
+@noindent
+Las propiedades de contexto establecidas de esta forma se pueden
+sobreescribir para ejemplares concretos de contextos mediante
+enunciados dentro de un bloque @code{\with}, y mediante instrucciones
+@code{\set} intercaladas dentro de enunciados musicales.
+
+@seealso
+
+Referencia de la notación:
+@ruser{Changing context default settings}.
+@c FIXME
+@c uncomment when backslash-node-name issue is resolved -pm
+@c @ruser{The set command}.
+
+Referencia de funcionamiento interno:
+@rinternals{Contexts},
+@rinternals{Tunable context properties}.
+
@node Adding and removing engravers
@subsection Adding and removing engravers
-@cindex Grabadores, adición
-@cindex Grabadores, eliminación
+@cindex grabadores, adición
+@cindex grabadores, eliminación
+@cindex adición de grabadores
+@cindex eliminación de grabadores
@funindex \consists
+@funindex consists
@funindex \remove
+@funindex remove
Hemos visto que cada uno de los contextos contiene varios grabadores,
cada uno de los cuales a su vez es responsable de la producción de una
Como ilustración, repitamos un ejemplo extraído de la sección anterior
con las líneas del pentagrama eliminadas. Recuerde que las líneas del
-pentagrama están dibujadas por el grabador Staff_symbol_engraver.
+pentagrama están dibujadas por el grabador
+@code{Staff_symbol_engraver}.
@lilypond[quote,verbatim,ragged-right]
\new Staff \with {
\remove Staff_symbol_engraver
}
\relative c' {
- c4
+ c4
\set fontSize = #-4 % make note heads smaller
d e
\set fontSize = #2.5 % make note heads larger
f g
- \unset fontSize % return to original size
+ \unset fontSize % return to default size
a b
}
@end lilypond
Los grabadores también se pueden añadir a los contextos individuales
La instrucción que lo hace es
-@code{\consists @emph{Nombre_del_grabador}},
+@code{\consists @var{Nombre_del_grabador}},
situada dentro de un bloque @code{\with}. Ciertas partituras vocales
-tienen una indicación de @rglos{ambitus} situada al principio del
-pentagrama para indicar el ámbito de notas en dicho pentagrama. El
-ambitus se produce por parte del grabador @code{Ambitus_engraver}, que
-normalmente no está incluido en ningún contexto. Si lo añadimos al
-contexto @code{Voice}, calcula el rango a partir de esa única voz:
+tienen una indicación de ámbito o tesitura situada al principio del
+pentagrama para indicar el ámbito de notas en dicho pentagrama, véase
+@rglos{ambitus}. El ambitus se produce por parte del grabador
+@code{Ambitus_engraver}, que normalmente no está incluido en ningún
+contexto. Si lo añadimos al contexto @code{Voice}, calcula el rango a
+partir de esa única voz:
@lilypond[quote,verbatim,ragged-right]
\new Staff <<
\new Voice \with {
\consists Ambitus_engraver
}
- \relative c'' {
+ \relative c'' {
\voiceOne
- c a b g
+ c a b g
}
\new Voice
\relative c' {
@end lilypond
@noindent
-pero si añadimos el grabador de Ambitus al contexto de @code{Staff},
-calcula el rango a partir de todas las notas en todas las voces de ese
+pero si añadimos el grabador de ámbito al contexto de @code{Staff},
+calcula el rango de todas las notas en todas las voces de ese
pentagrama:
@lilypond[quote,verbatim,ragged-right]
}
<<
\new Voice
- \relative c'' {
+ \relative c'' {
\voiceOne
- c a b g
+ c a b g
}
\new Voice
\relative c' {
@subsubheading Changing all contexts of the same type
+@funindex \layout
+@funindex layout
+
Los ejemplos anteriores muestran la manera de eliminar o añadir
grabadores a los contextos individuales. También es posible eliminar
o añadir grabadores a todos los contextos de un tipo específico,
particular incluyendo la instrucción @code{\set} dentro de un bloque
@code{\context} de la misma forma.
+@seealso
+
+Referencia de la notación:
+@ruser{Modifying context plug-ins},
+@ruser{Changing context default settings}.
+
+
@node Extending the templates
@section Extending the templates
@menu
-* Soprano and cello::
-* Four-part SATB vocal score::
-* Building a score from scratch::
+* Soprano and cello::
+* Four-part SATB vocal score::
+* Building a score from scratch::
@end menu
@node Soprano and cello
@subsection Soprano and cello
@cindex plantilla, modificar
+@cindex modificar plantillas
Para empezar, tome la plantilla que le parezca más parecida a aquello
que quiere conseguir. Digamos que quiere escribir algo para soprano y
justo debajo de todo lo de la soprano. También tenemos que poner
@code{<<} y @code{>>} antes y después de la música -- lo que indica a
LilyPond que hay más de una cosa (en este caso, @code{Staff})
-sucediendo al mismo tiempo -- . La @code{\score} se parecerá ahora a
-esto
+sucediendo al mismo tiempo --. La @code{\score} se parecerá ahora a
+esto:
@c Indentation in this example is deliberately poor
@example
}
@end lilypond
+@seealso
+
+Las plantillas de inicio se pueden encontrar en el apéndice
+@q{Templates}, véase @ref{Single staff}.
+
+
@node Four-part SATB vocal score
@subsection Four-part SATB vocal score
@c The following should appear as music without code
@lilypond[quote,ragged-right]
global = { \key d \major \time 4/4 }
-sopMusic = \relative c'' {
+sopranoMusic = \relative c'' {
\clef "treble"
r4 d2 a4 | d4. d8 a2 | cis4 d cis2 |
}
-sopWords = \lyricmode {
+sopranoWords = \lyricmode {
Wor -- thy is the lamb that was slain
}
altoMusic = \relative a' {
\clef "treble"
r4 a2 a4 | fis4. fis8 a2 | g4 fis e2 |
}
-altoWords = \sopWords
+altoWords = \sopranoWords
tenorMusic = \relative c' {
\clef "G_8"
r4 fis2 e4 | d4. d8 d2 | e4 a, cis2 |
}
-tenorWords = \sopWords
+tenorWords = \sopranoWords
bassMusic = \relative c' {
\clef "bass"
r4 d2 cis4 | b4. b8 fis2 | e4 d a'2 |
}
-bassWords = \sopWords
+bassWords = \sopranoWords
upper = \relative a' {
\clef "treble"
\global
\new ChoirStaff <<
\new Staff = "sopranos" <<
\set Staff.instrumentName = "Soprano"
- \new Voice = "sopranos" { \global \sopMusic }
+ \new Voice = "sopranos" { \global \sopranoMusic }
>>
- \new Lyrics \lyricsto "sopranos" { \sopWords }
+ \new Lyrics \lyricsto "sopranos" { \sopranoWords }
\new Staff = "altos" <<
\set Staff.instrumentName = "Alto"
\new Voice = "altos" { \global \altoMusic }
>> % end ChoirStaff
\new PianoStaff <<
- \set PianoStaff.instrumentName = "Piano "
+ \set PianoStaff.instrumentName = "Piano"
\new Staff = "upper" \upper
\new Staff = "lower" \lower
>>
Ninguna de las plantillas proporciona esta disposición con exactitud.
La más parecida es @q{partitura vocal SATB y reducción de piano
-automática}, pero necesitamos cambiar la disposición y añadir un
-acompañamiento de piano que no esté derviado automáticamente de las
-partes vocales. Las variables que contienen la música y la letra de
-las partes vocales es adecuada, pero tendremos que añadir variables
-para la reducción de piano.
+automática} (véase @ref{Vocal ensembles}), pero necesitamos cambiar la
+disposición y añadir un acompañamiento de piano que no esté derviado
+automáticamente de las partes vocales. Las variables que contienen la
+música y la letra de las partes vocales es adecuada, pero tendremos
+que añadir variables para la reducción de piano.
El orden en que aparecen los contextos en el ChoirStaff de la
plantilla no se corresponde con el orden de la partitura vocal que
\set Staff.instrumentName = "Tenor"
\new Voice = "tenores" @{ \global \musicaTenor @}
>>
- \new Lyrics \lyricsto "tenors" @{ \letraTenor @}
+ \new Lyrics \lyricsto "tenores" @{ \letraTenor @}
\new Staff = "bajos" <<
\set Staff.instrumentName = "Bass"
\new Voice = "bajos" @{ \global \musicaBajo @}
>>
- \new Lyrics \lyricsto "basses" @{ \letraBajo @}
+ \new Lyrics \lyricsto "bajos" @{ \letraBajo @}
>> % fin del ChoirStaff
@end example
@example
\new PianoStaff <<
- \set PianoStaff.instrumentName = "Piano "
+ \set PianoStaff.instrumentName = "Piano"
\new Staff = "superior" \superior
\new Staff = "inferior" \inferior
>>
\clef "bass"
\new Voice = "bajos" @{ \global \musicaBajo @}
>>
- \new Lyrics \lyricsto "bajos" @{ \letraBajo @}
+ \new Lyrics \lyricsto "bajos" @{ \letraBajo @}
>> % fin del ChoirStaff
\new PianoStaff <<
- \set PianoStaff.instrumentName = "Piano "
+ \set PianoStaff.instrumentName = "Piano"
\new Staff = "upper" \upper
\new Staff = "lower" \lower
>>
>> % end ChoirStaff
\new PianoStaff <<
- \set PianoStaff.instrumentName = "Piano "
+ \set PianoStaff.instrumentName = "Piano"
\new Staff = "upper" \upper
\new Staff = "lower" \lower
>>
>>
}
@end lilypond
-
+
@node Building a score from scratch
@subsection Building a score from scratch
@cindex plantilla, escribir su propia
+@cindex ejemplo de escritura de una partitura
+@cindex escribir una partitura, ejemplo
+@cindex partitura, ejemplo de escritura
Después de adquirir algo de soltura en la escritura del código de
LilyPond, se dará cuenta de que es más fácil construir completamente
>>
@end example
-No es estrictamente necesario utilizar la construcción simultánea
-@code{<< >>} para el pentagrama del manual dos y el pentagrama del
-órgano de pedal, ya que contienen una única expresión, pero no hace
-daño y es una buena costumbre utilizar siempre dobles ángulos después
-de @code{\new Staff} cuando hay varias voces. Lo opuesto es cierto
-para las voces: normalmente deben ir seguidas de llaves @code{@{
-.. @}} en caso de que tengamos música codificada como distintas
-variables que se deben situar consecutivamente.
+No es necesario utilizar la construcción simultánea @code{<< >>} para
+el pentagrama del manual dos y el pentagrama del órgano de pedal, ya
+que contienen una única expresión, pero no hace daño, y es una buena
+costumbre utilizar siempre dobles ángulos después de @code{\new Staff}
+cuando hay varias voces. Lo opuesto es cierto para las voces:
+normalmente deben ir seguidas de llaves @code{@{ .. @}} en caso de que
+tengamos música codificada como distintas variables que se deben
+situar consecutivamente.
Añadamos esta estructura al bloque de partitura, y ajustemos el
sangrado de los márgenes. También escribimos las claves
-correspondientes, nos aseguramos de que las plicas de la segunda voz
-apuntan hacia abajo mediante @code{\voiceTwo} y escribimos el compás y
-la tonalidad en cada uno de los pentagramas usando nuestra variable
-previamente definida @code{\TimeKey}.
+correspondientes, nos aseguramos de que las plicas y ligaduras de
+unión y de expresión en cada una de las voces del pentagrama superior
+apuntan en la dirección adecuada con @code{\voiceOne} y
+@code{\voiceTwo} y escribimos el compás y la tonalidad en cada uno de
+los pentagramas usando nuestra variable previamente definida
+@code{\TimeKey}.
@example
\score @{
\new Staff = "ManualUno" <<
\TimeKey % establecer compás y tonalidad
\clef "treble"
- \new Voice @{ \MusicaManualUnoVozUno @}
+ \new Voice @{ \voiceOne \MusicaManualUnoVozUno @}
\new Voice @{ \voiceTwo \MusicaManualUnoVozDos @}
>> % fin del contexto de Staff ManualUno
\new Staff = "ManualDos" <<
\new Staff = "ManualOne" <<
\TimeKey % set time signature and key
\clef "treble"
- \new Voice { \ManualOneVoiceOneMusic }
+ \new Voice { \voiceOne \ManualOneVoiceOneMusic }
\new Voice { \voiceTwo \ManualOneVoiceTwoMusic }
>> % end ManualOne Staff context
\new Staff = "ManualTwo" <<
\TimeKey
\clef "bass"
\new Voice { \PedalOrganMusic }
- >> % end PedalOrgan Staff
+ >> % end PedalOrgan Staff context
>>
} % end Score context
@end lilypond
projects / lilypond.git / blobdiff