From: Francisco Vila Date: Wed, 5 Mar 2008 10:13:44 +0000 (+0100) Subject: Finish Spanish tutorial sectioning X-Git-Tag: release/2.11.43-1~55^2 X-Git-Url: https://git.donarmstrong.com/?a=commitdiff_plain;h=29ba16fa8fd1fc67d6fd40376a5222009ddff448;p=lilypond.git Finish Spanish tutorial sectioning --- diff --git a/Documentation/es/user/tutorial.itely b/Documentation/es/user/tutorial.itely index a235205448..04b32ada66 100644 --- a/Documentation/es/user/tutorial.itely +++ b/Documentation/es/user/tutorial.itely @@ -1,7 +1,7 @@ @c -*- coding: utf-8; mode: texinfo; -*- @c This file is part of lilypond.tely @ignore - Translation of GIT committish: e344dd780c20717963ed77658f3ce169822bc5cb + Translation of GIT committish: 8847716091a1785f02bdc92554610478ca1e7c6e When revising a translation, copy the HEAD committish of the version that you are working on. See TRANSLATION for details. @@ -54,7 +54,7 @@ Esta sección le ofrece una introducción básica al trabajo con LilyPond. * Compiling a file:: * Simple notation:: * Working on text files:: -* How to read the manual:: +* How to read the manual:: @end menu @@ -593,47 +593,15 @@ Esta sección es una introducción a la notación corriente que se utiliza para o un pentagrama. @menu -* Relative note names:: * Accidentals and key signatures:: * Ties and slurs:: * Articulation and dynamics:: +* Adding text:: * Automatic and manual beams:: * Advanced rhythmic commands:: @end menu -@node Relative note names -@subsection Relative note names - -Como hemos visto en @ruser{Simple notation}, LilyPond calcula la altura de -cada nota de forma relativa respecto de la nota anterior@footnote{Existe otra forma de -introducir las alturas, @ruser{Absolute note names}, pero en la práctica el modo -relativo es mucho más cómodo y seguro de utilizar.}. Si no se añade ninguna marca de octava -(@code{'} y @code{,}), se supone que cada altura se encuentra dentro de una -cuarta desde la nota anterior. - -LilyPond examina las alturas basándose en los nombres de las notas (dicho de otra forma: -una cuarta aumentada @emph{no} es lo mismo que una quinta disminuida. Si -empezamos en un Do, un Fa sostenido situado a continuación se colocará por encima del Do, mientras que -un Sol bemol se colocará por debajo de este mismo Do. - -@lilypond[quote,ragged-right,verbatim,fragment,relative=2] -c2 fis -c2 ges -@end lilypond - -@seealso -@quotation -@table @asis -@item Octavas relativas -ver @ruser{Relative octaves}. -@item Comprobación de octava -ver @ruser{Octave check}. -@end table -@end quotation - - - @node Accidentals and key signatures @subsection Accidentals and key signatures @@ -851,6 +819,30 @@ ver @ruser{Dynamics}. @end quotation +@node Adding text +@subsection Adding text + +Es posible añadir texto a la partitura: + +@lilypond[verbatim,quote,ragged-right,fragment,relative=2] +c1^"espr" a_"legato" +@end lilypond + +Se puede aplicar un formateo adicional mediante la instrucción @code{\markup}: + +@lilypond[verbatim,quote,ragged-right,fragment,relative=2] +c1^\markup{ \bold espr} +a1_\markup{ + \dynamic f \italic \small { 2nd } \hspace #0.1 \dynamic p +} +@end lilypond + + +@seealso + +Referencia de la notación: @ruser{Writing text}. + + @node Automatic and manual beams @subsection Automatic and manual beams @@ -956,7 +948,7 @@ una voz en el mismo pentagrama. @menu * Music expressions explained:: * Multiple staves:: -* Piano staves:: +* Staff groups:: * Combining notes into chords:: * Single staff polyphony:: @end menu @@ -987,6 +979,33 @@ es otra expresión musical: { { a4 g } f g } @end lilypond +@cindex expresión +@cindex expresión musical +@subheading Analogy: mathematical expressions + +Este mecanismo es semejante a las fórmulas +matemáticas: una fórmula grande se construye combinando fórmulas pequeñas. Dichas +fórmulas se llaman expresiones, y su definición es recursiva de tal forma que +se pueden construir expresiones de un tamaño y complejidad arbitrarios. Por ejemplo: + +@example +1 + +1 + 2 + +(1 + 2) * 3 + +((1 + 2) * 3) / (4 * 5) +@end example + +Ésta es una secuencia de expresiones donde cada expresión se encuentra contenida dentro +de la siguiente, más grande. Las expresiones más simples son números, y las mayores +se hacen combinando expresiones mediante operadores (como @samp{+}, +@samp{*} y @samp{/}) y paréntesis. Del mismo modo que las expresiones matemáticas, +las expresiones musicales se pueden anidar a una profundidad arbitraria, lo que se hace necesario +para músicas complejas como las partituras polifónicas. + + @subheading Simultaneous music expressions: multiple staves Esta técnica es muy útil para la música polifónica. Para introducir música @@ -1030,32 +1049,6 @@ expresión simultánea, hay más de un pentagrama. } @end lilypond -@cindex expresión -@cindex expresión musical -@subheading Analogy: mathematical expressions - -Este mecanismo es semejante a las fórmulas -matemáticas: una fórmula grande se construye combinando fórmulas pequeñas. Dichas -fórmulas se llaman expresiones, y su definición es recursiva de tal forma que -se pueden construir expresiones de un tamaño y complejidad arbitrarios. Por ejemplo: - -@example -1 - -1 + 2 - -(1 + 2) * 3 - -((1 + 2) * 3) / (4 * 5) -@end example - -Ésta es una secuencia de expresiones donde cada expresión se encuentra contenida dentro -de la siguiente, más grande. Las expresiones más simples son números, y las mayores -se hacen combinando expresiones mediante operadores (como @samp{+}, -@samp{*} y @samp{/}) y paréntesis. Del mismo modo que las expresiones matemáticas, -las expresiones musicales se pueden anidar a una profundidad arbitraria, lo que se hace necesario -para músicas complejas como las partituras polifónicas. - @node Multiple staves @subsection Multiple staves @@ -1110,16 +1103,20 @@ pentagramas. @end lilypond +@node Staff groups +@subsection Staff groups +@cindex piano staff +@cindex choir staff +@cindex grand staff -@node Piano staves -@subsection Piano staves +Glosario musical: @rglos{brace}. -@cindex salto de pentagrama, establecimiento manual -@cindex voz de pentagrama cruzado, establecimiento manual -La música para piano se compone tipográficamente en forma de dos pentagramas unidos mediante una llave. El aspecto impreso de -este sistema de pentagramas se parece al ejemplo polifónico que aparece en @ruser{Multiple staves}, -pero en esta ocasión la expresión completa se coloca dentro de un @code{PianoStaff}: +La música para piano se compone tipográficamente en forma de dos +pentagramas unidos mediante una @notation{llave}. El aspecto impreso de este +sistema de pentagramas se parece al ejemplo polifónico que aparece en +@ref{Multiple staves}, pero en esta ocasión la expresión completa se +coloca dentro de un @code{PianoStaff}: @example \new PianoStaff << @@ -1139,10 +1136,17 @@ He aquí un pequeño ejemplo: } @end lilypond +Otros grupos de pentagramas se declaran mediante @code{\new +GrandStaff,} que es apropiado para partituras orquestales, y +@code{\new ChoirStaff,} que es apropiado para partituras vocales. +Cada uno de estos grupos de pautas forma un tipo de contexto distinto, +que produce la llave a la izquierda y que también controla el alcance +de las líneas divisorias. + @seealso -@quotation -Ver @ruser{Piano music}. -@end quotation + +Referencia de la notación: @ruser{Piano music}, +@ruser{Displaying staves}. @node Combining notes into chords @subsection Combining notes into chords @@ -1226,25 +1230,32 @@ Ver @ruser{Basic polyphony}. @node Songs @section Songs -Esta sección es una introducción a la música vocal y a las partituras de canciones sencillas. +En esta sección presentamos cómo elaborar música vocal y hojas de +canción sencillas. @menu -* Printing lyrics:: -* A lead sheet:: +* Setting simple songs:: +* Aligning lyrics to a melody:: +* Lyrics to multiple staves:: @end menu -@node Printing lyrics -@subsection Printing lyrics +@node Setting simple songs +@subsection Setting simple songs -@cindex Letra -@cindex Canciones -Consideremos una melodía sencilla: +@cindex letra +@cindex canciones -@lilypond[quote,ragged-right,verbatim] +Glosario musical: @rglos{lyrics}. + +Presentamos a continuación el inicio de la melodía de una canción +infantil, @qq{Girls and boys come out to play}: + +@lilypond[verbatim,quote,ragged-right] \relative c'' { - a4 e c8 e r4 - b2 c4( d) + \key g \major + \time 6/8 + d4 b8 c4 a8 d4 b8 g4 } @end lilypond @@ -1252,132 +1263,317 @@ La letra se puede asignar a esas notas, combinando ambas con la palabra clave @code{\addlyrics}. La letra se escribe separando cada sílaba mediante un espacio. -@lilypond[quote,ragged-right,verbatim] +@lilypond[verbatim,quote,ragged-right] << \relative c'' { - a4 e c8 e r4 - b2 c4( d) + \key g \major + \time 6/8 + d4 b8 c4 a8 d4 b8 g4 + } + \addlyrics { + Girls and boys come out to play, } - \addlyrics { One day this shall be free } >> @end lilypond +Observe las llaves rodeando tanto la música como la letra, y los +ángulos dobles @code{<< ... >>} alrededor del fragmento entero para +expresar que la música y la letra han de suceder al mismo tiempo. + +@node Aligning lyrics to a melody +@subsection Aligning lyrics to a melody + +Glosario musical: @rglos{melisma}, @rglos{extender line}. + @cindex melisma -@cindex línea de extensión de sílabas -Esta melodía acaba en un @rglos{melisma}, una sílaba única (@q{suelta}) -que se canta sobre más de una nota. Esto se indica mediante una @emph{línea -de extensión}. Se escribe como dos guiones bajos @code{__}: +@cindex línea de extensión +@cindex guión +@cindex guión bajo -@lilypond[quote,ragged-right,verbatim] +La siguiente línea de la canción infantil es @q{The moon doth shine as +bright as day}. A continuación vamos a ampliarla: + +@lilypond[verbatim,quote,ragged-right] << \relative c'' { - a4 e c8 e r4 - b2 c4( d) + \key g \major + \time 6/8 + d4 b8 c4 a8 d4 b8 g4 + g8 a4 b8 c b a d4 b8 g4. + } + \addlyrics { + Girls and boys come out to play, + The moon doth shine as bright as day; } - \addlyrics { One day this shall be free __ } >> @end lilypond -De forma parecida, los guiones entre las palabras se pueden escribir como dos guiones, -dando como resultado unas líneas cortas entre cada dos sílabas: +Podemos observar que la letra adicional no se alinea correctamente con +las notas. La palabra @q{shine} se debe cantar sobre dos notas, no +una. Esto se conoce como @notation{melisma}, una sílaba única que se +canta sobre más de una nota. Existen varias formas de hacer que una +sílaba recaiga sobre varias notas, siendo la más sencilla escribir una +ligadura de expresión sobre ellas (véase @ref{Ties and slurs}): -@c aquí no se pone ragged-right porque los guiones se perderían. -@lilypond[quote,verbatim] +@lilypond[verbatim,quote,ragged-right] << - \relative c' { - \time 2/4 - f4 f c c + \relative c'' { + \key g \major + \time 6/8 + d4 b8 c4 a8 d4 b8 g4 + g8 a4 b8 c([ b)] a d4 b8 g4. } - \addlyrics { A -- le -- gri -- a } ->> + \addlyrics { + Girls and boys come out to play, + The moon doth shine as bright as day; + } +>> @end lilypond -@seealso -@quotation -Otras posibilidades como poner varios versos debajo de una melodía, se -discuten en @ruser{Vocal music}. -@end quotation - +Aquí hemos usado además el barrado manual (los corchetes rectos +@code{[ ]} ) para producir el barrado que corresponde a la letra por +convención (véase @ref{Automatic and manual beams}). -@node A lead sheet -@subsection A lead sheet +Como alternativa a la utilización de ligaduras de expresión, los +melismas se pueden indicar solamente en la letra utilizando un guión +bajo, @code{_}, para cada nota que queremos incluir dentro del +melisma: -@cindex Hojas guía de acordes -@cindex acordes -@cindex nombres de los acordes +@lilypond[verbatim,quote,ragged-right] +<< + \relative c'' { + \key g \major + \time 6/8 + d4 b8 c4 a8 d4 b8 g4 + g8 a4 b8 c[ b] a d4 b8 g4. + } + \addlyrics { + Girls and boys come out to play, + The moon doth shine _ as bright as day; + } +>> +@end lilypond -En la música pop es muy común denotar el acompañamiento con los nombres de los acordes. -Estos acordes se pueden escribir como notas: +Si una sílaba se extiende sobre varias notas o una sola nota muy +larga, normalmente se traza una @notation{línea extensora} desde la +sílaba que se extiende y por debajo de todas las notas que +corresponden a dicha sílaba. Se escribe como dos guiones bajos +@code{__}. He aquí un ejemplo extraído de los primeros tres compases +del Lamento de Dido, de Dido y Eneas de Purcell: -@lilypond[quote,ragged-right,verbatim] -\chordmode { c2 f4. g8 } +@lilypond[verbatim,quote,ragged-right] +<< + \relative c'' { + \key g \minor + \time 3/2 + g2 a bes bes( a) + b c4.( bes8 a4. g8 fis4.) g8 fis1 + } + \addlyrics { + When I am laid, + am laid __ in earth, + } +>> @end lilypond -Ahora, cada altura se lee como la fundamental de un acorde en vez de como una nota. -Este modo se activa con @code{\chordmode}. Otros acordes pueden -construirse añadiendo modificadores después de un signo de dos puntos. El -ejemplo que sigue muestra algunos modificadores comunes: +Hasta el momento, ninguno de los ejemplos implicaban palabras que +tuviesen más de una sílaba. Estas palabras se reparten por lo general +a razón de una nota por cada sílaba, con guiones cortos entre las +sílabas. Dichos guiones separadores se teclean como dos guiones, con +el resultado de un guión corto centrado entre las sílabas. +Presentamos a continuación un ejemplo que demuestra esto y todo lo que +hemos aprendido hasta el momento acerca de la alineación de la letra a +las notas. + +@c no ragged-right here because otherwise the hyphens get lost, +@c but the example is long enough to avoid looking strange. +@lilypond[verbatim,quote] +<< + \relative c' { + \key g \major + \time 3/4 + \partial 4 + d4 g4 g a8( b) g4 g4 + b8( c) d4 d e4 c2 + } + \addlyrics { + A -- way in a __ man -- ger, + no __ crib for a bed, __ + } +>> +@end lilypond -@lilypond[quote,verbatim,ragged-right] -\chordmode { c2 f4:m g4:maj7 gis1:dim7 } +Algunos textos (especialmente los que están en italiano o en español) +requieren lo contrario: colocar más de una sílaba a una única nota. +Esto se consigue enlazando las sílabas entre sí mediante un guión bajo +simple @code{_} (sin ningún espacio), o bien encerrándolas entre +corchetes. Aquí aparece un ejemplo procedente del @qq{Barbero de +Sevilla} de Rossini, donde la sílaba @q{al} se canta sobre la misma +nota que @q{go} de la palabra @q{Largo} en el aria de Fígaro @q{Largo +al factotum}: + +@c no ragged-right here because otherwise the hyphens get lost, +@c but the example is long enough to avoid looking strange. +@lilypond[verbatim,quote] +<< + \relative c' { + \clef bass + \key c \major + \time 6/8 + c4.~ c8 d b c([ d)] b c d b c + } + \addlyrics { + Lar -- go_al fac -- to -- tum del -- la cit -- tà + } +>> @end lilypond -Para canciones con acordes, éstos no se imprimen sobre pentagramas, sino como nombres en su -propia línea. Esto se consigue utilizando @code{\chords} en sustitución -de @code{\chordmode}. Utiliza la misma sintaxis que @code{\chordmode}, -pero pinta las notas dentro de un contexto de @code{ChordNames}, con el -siguiente resultado: -@lilypond[quote,verbatim,ragged-right] -\chords { c2 f4.:m g4.:maj7 gis8:dim7 } -@end lilypond +@seealso -@cindex hoja guía de acordes -Cuando se combinan, los nombres de acorde, la letra y la melodía forman -una hoja de canción con acordes (@q{lead sheet}): +Referencia de la notación: @ruser{Vocal music}. -@lilypond[quote,verbatim,ragged-right] + + +@node Lyrics to multiple staves +@subsection Lyrics to multiple staves + +La solución sencilla que utiliza @code{\addlyrics} se puede usar para +poner letra a más de un pentagrama. Aquí aparece un ejemplo sacado +del @qq{Judas Macabeo} de Haendel: + +@lilypond[verbatim,quote,ragged-right] << - \chords { c2 g:sus4 f e } + { + \time 6/8 + \partial 8 + } \relative c'' { - a4 e c8 e r4 - b2 c4( d) + \key f \major + c8 c([ bes)] a a([ g)] f f'4. b, c4.~ c4 + } + \addlyrics { + Let flee -- cy flocks the hills a -- dorn, __ + } + \relative c' { + \key f \major + r8 r4. r4 c8 a'([ g)] f f([ e)] d e([ d)] c bes'4 + } + \addlyrics { + Let flee -- cy flocks the hills a -- dorn, } - \addlyrics { One day this shall be free __ } >> @end lilypond +@noindent +pero cualquier partitura de una complejidad mayor que la de este +sencillo ejemplo se hace mejor separando la latra de la estructura de +pentagramas mediante variables (expresiones con nombre). Éstas se +tratan en @ref{Organizing pieces with variables}. @seealso -@quotation -Puede ver una lista completa de los modificadores y otras opciones de presentación -en @ruser{Chords}. -@end quotation +Referencia de la notación: @ruser{Vocal music}. @node Final touches @section Final touches -Éste es el último apartado del tutorial; muestra la forma de dar los toques finales -a piezas sencillas, y ofrece una introducción al resto +Éste es el último apartado del tutorial; muestra la forma de dar los +toques finales a piezas sencillas, y ofrece una introducción al resto del manual. @menu +* Organizing pieces with variables:: * Version number:: * Adding titles:: * Absolute note names:: -* Organizing pieces with identifiers:: * After the tutorial:: -* How to read the manual:: @end menu +@node Organizing pieces with variables +@subsection Organizing pieces with variables + +Cuando los elementos que hemos discutido anteriormente se combinan +para producir archivos mayores, las expresiones musicales se hacen +enormes. En música polifónica con muchos pentagramas, los archivos de +entrada pueden volverse muy propensos a la confusión. Podemos reducir +esta confusión utilizando las @emph{variables}. + +Con las variables (también conocidas como identificadores o macros), +podemos trocear las expresiones musicales complejas. Una variable se +asigna de la manera siguiente: + +@example +musicaConNombre = @{ @dots{} @} +@end example + +El contenido de la expresión musical @code{musicaConNombre} se puede usar +posteriormente colocando una barra invertida delante del nombre +(@code{\musicaConNombre}, igual que una orden normal de LilyPond). + +@lilypond[quote,verbatim,ragged-right] +violin = \new Staff { \relative c'' { + a4 b c b +}} +cello = \new Staff { \relative c { + \clef bass + e2 d +}} +{ + << + \violin + \cello + >> +} +@end lilypond + +@noindent +El nombre de una variable debe consistir enteramente en caracteres +alfabéticos, es decir sin números, guiones ni guiones bajos. + +Las variables se deben definir @emph{antes} de la expresión musical +principal, pero se pueden usar tantas veces como se quiera, en +cualquier lugar, una vez que han sido definidas. Incluso se pueden +usar dentro de la definición de otra variable, proporcionando una vía +para acortar el código si una sección musical se repite muchas veces. + +@lilypond[verbatim,quote,ragged-right] +tripletA = \times 2/3 { c,8 e g } +barA = { \tripletA \tripletA \tripletA \tripletA } + +\relative c'' { + \barA \barA +} +@end lilypond + +Las variabbles se pueden usar para otros muchos tipos de objetos +dentro del código de entrada. Por ejemplo, + +@example +width = 4.5\cm +name = "Wendy" +aFivePaper = \paper @{ paperheight = 21.0 \cm @} +@end example + +Dependiendo de su contenido, la variable se puede usar en distintos +lugares. El siguiente ejemplo utiliza las variables anteriores: + +@example +\paper @{ + \aFivePaper + line-width = \width +@} +@{ c4^\name @} +@end example + + @node Version number @subsection Version number @cindex indicación de la versión -La indicación @code{\version} deja registrado para qué versión de LilyPond se escribió -el archivo: +La indicación @code{\version} deja registrado para qué versión de +LilyPond se escribió el archivo: @example \version @w{"@version{}"} @@ -1386,19 +1582,20 @@ el archivo: @noindent por convenio se sitúa al principio del archivo de partitura de LilyPond. -Estas anotaciones hacen menos problemáticas las subsiguientes actualizaciones de LilyPond. -Los cambios en la sintaxis se tratan mediante un programa especial, -@file{convert-ly} (ver @rprogram{Updating files with convert-ly}), y utiliza -@code{\version} para determinar qué reglas hay que aplicar. +Estas anotaciones hacen menos problemáticas las subsiguientes +actualizaciones de LilyPond. Los cambios en la sintaxis se tratan +mediante un programa especial, @file{convert-ly}, y utiliza +@code{\version} para determinar qué reglas hay que aplicar. Para ver +más detalles, consulte @rprogram{Updating files with convert-ly}). @node Adding titles @subsection Adding titles -La información sobre el título, autor, número de Opus y similares se escriben -en el bloque @code{\header}. Éste se encuentra fuera de la expresión musical -principal; el bloque @code{\header} normalmente se sitúa por debajo del -@ruser{Version number}. +La información sobre el título, autor, número de Opus y similares se +escriben en el bloque @code{\header}. Éste se encuentra fuera de la +expresión musical principal; el bloque @code{\header} normalmente se +sitúa por debajo del @ruser{Version number}. @example \version @w{"@version{}"} @@ -1413,22 +1610,24 @@ principal; el bloque @code{\header} normalmente se sitúa por debajo del @} @end example -Cuando se procesa el archivo, el título y el autor se imprimen por encima -de la música. Puede obtener más información sobre los títulos en @ruser{Creating -titles}. +Cuando se procesa el archivo, el título y el autor se imprimen por +encima de la música. Puede obtener más información sobre los títulos +en @ruser{Creating titles}. @node Absolute note names @subsection Absolute note names -Hasta el momento siempre hemos utilizado @code{\relative} para definir las alturas. Ésta es la -forma más sencilla de escribir la mayor parte de la música, pero existe otra forma de definir -las alturas: el modo absoluto. +Hasta el momento siempre hemos utilizado @code{\relative} para definir +las alturas. Ésta es la forma más sencilla de escribir la mayor parte +de la música, pero existe otra forma de definir las alturas: el modo +absoluto. Si omite el @code{\relative}, LilyPond tratará todas las alturas como -valores absolutos. Una @code{c'} significará siembre un Do central, una @code{b} significará -siempre la nota inmediatamente por debajo del Do central, y una @code{g,} significará -siempre la nota que se coloca en la primera línea del pentagrama en clave de Fa. +valores absolutos. Una @code{c'} significará siembre un Do central, +una @code{b} significará siempre la nota inmediatamente por debajo del +Do central, y una @code{g,} significará siempre la nota que se coloca +en la primera línea del pentagrama en clave de Fa. @lilypond[quote,verbatim,ragged-right] { @@ -1455,8 +1654,9 @@ He aquí una escala que abarca cuatro octavas: } @end lilypond -Como puede ver, escribir una melodía en clave de Sol implica escribir gran cantidad de -apóstrofes ' . Consideremos este fragmento de Mozart: +Como puede ver, escribir una melodía en clave de Sol implica escribir +gran cantidad de apóstrofes @q{'} . Consideremos este fragmento de +Mozart: @lilypond[quote,verbatim,ragged-right] { @@ -1467,9 +1667,9 @@ apóstrofes ' . Consideremos este fragmento de Mozart: } @end lilypond -Todos estos apóstrofes hacen casi ilegible el código de entrada y será origen de numerosos -errores. Con @code{\relative}, el ejemplo anterior es mucho más fácil -de leer: +Todos estos apóstrofes hacen casi ilegible el código de entrada y será +origen de numerosos errores. Con @code{\relative}, el ejemplo +anterior es mucho más fácil de leer: @lilypond[quote,verbatim,ragged-right] \relative c'' { @@ -1480,86 +1680,27 @@ de leer: } @end lilypond -Si comete un error con una marca de octava (@code{'} o @code{,}) mientras -trabaja en el modo @code{\relative}, será muy obvio (muchas notas estarán -en la octava equivocada). Mientras trabaja en el modo absoluto, un solo fallo -no será tan visible, y tampoco será tan fácil de localizar. - -Sin embargo, el modo absoluto es útil para escribir música que contenga intervalos grandes, y -será extremadamente útil para hacer archivos de LilyPond generados por ordenador. - - -@node Organizing pieces with identifiers -@subsection Organizing pieces with identifiers - -Cuando los elementos que hemos discutido anteriormente se combinan para producir -archivos mayores, las expresiones musicales se hacen enormes. En música -polifónica con muchos pentagramas, los archivos de entrada pueden volverse muy propensos a la confusión. Podemos -reducir esta confusión utilizando los @emph{identificadores}. - -Con los identificadores (también conocidos como variables o macros), podemos trocear las -expresiones musicales complejas. Un identificador se asigna de la manera siguiente: - -@example -musicaConNombre = @{ @dots{} @} -@end example - -El contenido de la expresión musical @code{musicaConNombre} se puede usar -posteriormente colocando una barra invertida delante del nombre -(@code{\musicaConNombre}, igual que una orden normal de LilyPond). Los identificadores -se deben definir @emph{antes} de la expresión musical principal. - -@lilypond[quote,verbatim,ragged-right] -violin = \new Staff { \relative c'' { - a4 b c b -}} -cello = \new Staff { \relative c { - \clef bass - e2 d -}} -{ - << - \violin - \cello - >> -} -@end lilypond - -@noindent -El nombre de un identificador debe consistir enteramente en caracteres alfabéticos, es decir -sin números, guiones ni guiones bajos. - -Es posible utilizar variables para otras muchas clases de objetos en el código de -entrada. Por ejemplo: - -@example -width = 4.5\cm -name = "Wendy" -aFivePaper = \paper @{ paperheight = 21.0 \cm @} -@end example - -Dependiendo de su contenido, el identificador se puede usar en distintos -lugares. El siguiente ejemplo utiliza las variables anteriores: +Si comete un error con una marca de octava (@code{'} o @code{,}) +mientras trabaja en el modo @code{\relative}, será muy obvio (muchas +notas estarán en la octava equivocada). Mientras trabaja en el modo +absoluto, un solo fallo no será tan visible, y tampoco será tan fácil +de localizar. -@example -\paper @{ - \aFivePaper - line-width = \width -@} -@{ c4^\name @} -@end example +Sin embargo, el modo absoluto es útil para escribir música que +contenga intervalos grandes, y será extremadamente útil para hacer +archivos de LilyPond generados por ordenador. @node After the tutorial @subsection After the tutorial -Después de terminar el tutorial, quizá debería probar a escribir una o dos -piezas. Comience con una de las @ruser{Templates} y añada algunas +Después de terminar el tutorial, quizá debería probar a escribir una o +dos piezas. Comience con una de las @ref{Templates} y añada algunas notas. Si necesita un tipo de notación que no ha sido tratada en el tutorial, eche un vistazo a la Referencia de Notación, empezando por @ruser{Basic notation}. Si quiere escribir música para un conjunto -instrumental que no está cubierto por ninguna plantilla, -consulte @ruser{Extending the templates}. +instrumental que no está cubierto por ninguna plantilla, consulte +@ref{Extending the templates}. Una vez que ha escrito algunas piezas cortas, lea el resto del Manual de aprendizaje (capítulos 3 al 5). ¡Por supuesto, no pasa nada por @@ -1568,28 +1709,3 @@ de Aprendizaje da por sentado que está familiarizado con la entrada de LilyPond. Puede saltarse estos capítulos ahora y volver a ellos cuando haya adquirido más experiencia. - -@node How to read the manual -@subsection How to read the manual - -Como ya vimos en @ruser{How to read the tutorial}, muchos ejemplos del -tutorial omitían el @code{\relative c'' @{ ... @}} alrededor del ejemplo -mostrado. - -Durante el resto del manual seremos mucho menos estrictos respecto de los -ejemplos impresos: a veces pueden omitir el -@code{\relative c'' @{ ... @}}, pero otras veces se puede usar una nota inicial -diferente (como @code{c'} o @code{c,,}), y en ocasiones -¡todo el ejemplo estará en el modo de notas absoluto! Sin embargo, las ambigüedades de esta clase -existen solamente allí donde las alturas no son lo más importante. En aquellos ejemplos -en los que las alturas tienen importancia, hemos escrito explícitamente @code{\relative} -o bien el @code{@{ @}} en modo absoluto. - -Si aún tiene dudas respecto de la entrada de LilyPond exacta que se -ha utilizado en un ejemplo, lea la versión HTML (si no lo está haciendo ya) -y pulse con el ratón sobre la imagen de la música. De esta forma se mostrará la entrada -exacta que LilyPond usó para generar este manual. - -Para informarse sobre la estructura que tiene el resto del manual, consulte -@ruser{About this manual}. -