]> git.donarmstrong.com Git - lilypond.git/blob - Documentation/es/user/introduction.itely
Merge branch 'master' into accidentals2
[lilypond.git] / Documentation / es / user / introduction.itely
1 @c -*- coding: utf-8; mode: texinfo; -*-
2 @c This file is part of lilypond.tely
3 @ignore
4     Translation of GIT committish: 4f64fbb128ccedeaa5fdc9748d0bd408f095757c
5
6     When revising a translation, copy the HEAD committish of the
7     version that you are working on.  See TRANSLATION for details.
8 @end ignore
9
10 @c \version "2.11.51"
11
12 @c Translation status: post-GDP
13
14 @node Introduction
15 @chapter Introduction
16
17 En este capítulo se presentan al lector LilyPond y su documentación.
18
19 @menu
20 * Background::
21 * About the documentation::
22 @end menu
23
24 @node Background
25 @section Background
26
27 Esta sección se ocupa de las metas principales y la arquitectura de
28 LilyPond.
29
30
31 @menu
32 * Engraving::                   
33 * Automated engraving::         
34 * What symbols to engrave?::    
35 * Music representation::        
36 * Example applications::        
37 @end menu
38
39
40 @node Engraving
41 @unnumberedsubsec Engraving
42
43 El arte de la tipografía musical se conoce como @emph{grabado (en
44 plancha)}.  El término deriva del proceso tradicional de la impresión
45 musical.  Hace sólo unas décadas, la música impresa se hacía
46 estampando la música sobre planchas de zinc o estaño de forma
47 invertida como en un espejo.  Después la plancha se entintaba y las
48 depresiones causadas por los cortes y estampados retenían la tinta.
49 Al presionar una hoja de papel sobre la plancha, se formaba una
50 imagen.  El estampado y cortado se hacía completamente a mano.
51 Cualquier corrección era muy fastidiosa de realizar, si es que era
52 posible hacerla siquiera, así que el grabado tenía que quedar perfecto
53 a la primera.  El grabado era una habilidad altamente especializada;
54 un artesano necesitaba unos cinco años de preparación antes de poder
55 ostentar el título de maestro grabador, y se necesitaban otros cinco
56 años de experiencia para ser un auténtico experto.
57
58 Hoy en día, toda la música impresa nueva se produce con ordenadores.
59 Esto tiene unas ventajas evidentes: las copias son más baratas de
60 producir y el trabajo editorial se puede repartir por correo
61 electrónico.  Desgraciadamente la penetrante utilización de
62 ordenadores también ha hecho disminuir la calidad gráfica de las
63 partituras.  Las impresiones de ordenador tienen un aspecto insulso y
64 mecánico, lo que hace que sea desagradable tocar a partir de ellas.
65
66 @c introduce illustrating aspects of engraving, font...
67 Las imágenes siguientes ilustran la diferencia entre el grabado
68 tradicional y la salida típica de ordenador, y la tercera imagen
69 muestra cómo LilyPond imita el aspecto tradicional.  La imagen de la
70 izquierda presenta el dibujo escaneado de un símbolo de bemol sacado
71 de una edición publicada en el año 2000.  La del centro es un símbolo
72 procedente de una edición de B@"{a}renreiter grabada a mano de la
73 misma música.  La de la izquierda ilustra los típicos puntos débiles
74 de la impresión por ordenador: las líneas del pentagrama son muy
75 delgadas, el peso del símbolo del bemol es también demasiado ligero
76 como las líneas del pentagrama, y tiene una apariencia rectilínea con
77 esquinas afiladas.  En contraste, el bemol de Bärenreiter tiene una
78 apariencia redonda, pesada, casi voluptuosa.  Nuestro símbolo del
79 bemol se diseñó según éste, entre otros.  Es de forma redondeada y su
80 peso está en armonía con el grosor de nuestras líneas de pentagrama,
81 que son asimismo mucho más gruesas que las de la edición por
82 ordenador.
83
84 @multitable @columnfractions .125 .25 .25 .25 .125
85 @item @tab
86 @ifnotinfo
87 @iftex
88 @image{henle-flat-gray,,4cm}
89 @end iftex
90 @ifnottex
91 @image{henle-flat-gray,,,png}
92 @end ifnottex
93
94 @tab
95 @iftex
96 @image{baer-flat-gray,,4cm}
97 @end iftex
98 @ifnottex
99 @image{baer-flat-gray,,,png}
100 @end ifnottex
101
102 @tab
103 @iftex
104 @image{lily-flat-bw,,4cm}
105 @end iftex
106 @ifnottex
107 @image{lily-flat-bw,,,png}
108 @end ifnottex
109 @end ifnotinfo
110 @ifinfo
111 @c workaround for makeinfo-4.6: line breaks and multi-column cookies
112 @image{henle-flat-bw,,,png} @image{baer-flat-bw,,,png}
113 @image{lily-flat-bw,,,png}
114 @end ifinfo
115
116 @item @tab
117 Henle (2000)
118 @tab
119 B@"{a}renreiter (1950)
120 @tab
121 Tipografía Feta de LilyPond (2003)
122
123 @end multitable
124
125
126 @cindex símbolos musicales
127 @cindex tipografías
128 @cindex negrura
129 @cindex equilibrio
130
131 @c introduce illustrating aspects of engraving, spacing...
132 Tratándose del espaciado, la distribución del espacio debe reflejar
133 las duraciones que hay entre las notas.  Sin embargo muchas partituras
134 modernas se atañen a las duraciones con precisión matemática, lo que
135 lleva a unos resultados bastante pobres.  En el siguiente ejemplo se
136 muestra un ejemplo dos veces: una utilizando espaciado matemáticamente
137 exacto, y otra con ciertas correcciones.  ¿Puede adivinar cuál es
138 cuál?
139
140 @cindex espaciado óptico
141 @c file spacing-optical.
142 @c need to include it here,  because we want two images.
143 @lilypond
144 \paper {
145   ragged-right = ##t
146   indent = #0.0
147 }
148
149 music = {
150    c'4 e''4 e'4 b'4 |
151    \stemDown
152    b'8[ e'' a' e'']
153    \stemNeutral
154    e'8[ e'8 e'8 e'8]
155 }
156
157 \score
158 {
159   \music
160   \layout {
161     \context {
162       \Staff
163       \override NoteSpacing #'stem-spacing-correction = #0.6
164     }
165   }
166 }
167 @end lilypond
168
169 @lilypond
170 \paper {
171   ragged-right = ##t
172   indent = #0.0
173 }
174
175 music = {
176    c'4 e''4 e'4 b'4 |
177    \stemDown
178    b'8[ e'' a' e'']
179    \stemNeutral
180    e'8[ e'8 e'8 e'8]
181 }
182 \score
183 {
184   \music
185   \layout {
186     \context {
187       \Staff
188       \override NoteSpacing #'stem-spacing-correction = #0.0
189       \override NoteSpacing #'same-direction-correction = #0.0
190       \override StaffSpacing #'stem-spacing-correction = #0.0
191     }
192   }
193 }
194 @end lilypond
195
196 @cindex ritmos regulares
197 @cindex espaciado regular
198
199 Cada uno de los dos compases de este fragmento tiene solamente notas
200 de duración constante.  El espaciado debería reflejarlo.
201 Desgraciadamente el ojo nos engaña un poco; no solamente percibe la
202 distancia entre las cabezas de las notas, sino que tiene también en
203 cuenta la distancia entre las plicas.  Como resultado, las notas de
204 una combinación plica arriba/@/plica abajo se tendrían que separar
205 más, y las notas de una combinación plica abajo/@/plica arriba
206 deberían juntarse, todo ello dependiendo de las posiciones combinadas
207 de las notas.  Los dos compases de arriba están impresos con esta
208 corrección y los de abajo sin ella, formando grupos de notas pegadas
209 con plica abajo/@/plica arriba.
210
211 @cindex tipografía
212
213 Los músicos están normalmente más concentrados en tocar que en
214 estudiar el aspecto de una partitura, y por ello las pequeñeces sobre
215 los detalles tipográficos pueden parecer académicas.  Pero no lo son.
216 En las partituras más largas con ritmos monótonos, las correcciones de
217 espaciado llevan a sutiles variaciones en la disposición de cada una
218 de las líneas dándoles una especie de firma visual distintiva.  Sin
219 esta firma, todas las líneas parecerían iguales, y se convertirían en
220 un laberinto.  Si un músico aparta la mirada o tiene un lapsus de
221 concentración, las líneas podrían perder su lugar sobre el papel.
222
223 De forma similar, la fuerza visual de unos símbolos pesados sobre
224 gruesas líneas de pentagrama se sostiene mejor cuando el lector se
225 aleja del papel, por ejemplo cuando está sobre un atril.  Una
226 distribución cuidadosa del espacio blanco permite disponer la música
227 muy apretada sin que los símbolos se toquen unos a otros.  El
228 resultado reduce a un mínimo las vueltas de página, lo que es una gran
229 ventaja.
230
231 Ésta es una característica normal del arte tipográfico.  La
232 disposición de la página tiene que ser bonita, no sólo por sí misma,
233 sino sobre todo porque así ayuda al lector en su tarea.  Para los
234 materiales destinados a la interpretación, como las partituras, esto
235 es de una importancia doble: los músicos tienen una capacidad de
236 concentración limitada.  Cuanta menos atención necesiten para el acto
237 de leer, más se pueden dedicar al acto de tocar la música.  Dicho de
238 otra forma: una mejor tipografía se traduce en una mejor
239 interpretación.
240
241 Estos ejemplos demuestran que la tipografía musical es un arte sutil y
242 complejo, y que su elaboración requiere una experiencia considerable,
243 que los músicos no suelen tener.  LilyPond representa nuestro esfuerzo
244 para llevar la excelencia visual de la música grabada a mano a la era
245 de la informática, y ponerla a disposición de los músicos normales.
246 Hemos ido afinando nuestros algoritmos, diseños de tipografía y
247 preferencias del programa para producir una impresión cuya calidad se
248 equipara con la de las viejas ediciones que tanto nos gusta contemplar
249 y de las que tanto nos gusta tocar.
250
251
252 @node Automated engraving
253 @unnumberedsubsec Automated engraving
254
255 ¿Cómo nos las arreglamos para implementar la tipografía? Si un
256 artesano necesita más de diez años para convertirse en un auténtico
257 maestro ¿cómo vamos a poder nosotros, simples «hackers», escribir un
258 programa que les quite el trabajo?
259
260 La respuesta es: no podemos.  Puesto que la tipografía se fundamenta
261 en el juicio humano sobre la apariencia, nunca se puede sustituir
262 completamente a las personas.  Sin embargo, se puede automatizar gran
263 parte del trabajo más duro y repetitivo.  Si LilyPond resuelve la
264 mayoría de las situaciones comunes de forma correcta, esto ya será una
265 tremenda mejoría sobre los programas existentes.  El resto de los
266 casos se podrán afinar a mano.  Con el transcurso de los años, el
267 software se puede refinar para que haga un mayor número de cosas de
268 forma automática, de tal forma que los ajustes manuales tienden a ser
269 cada vez menos necesarios.
270
271 Cuando empezamos, escribimos el programa LilyPond completamente en el
272 lenguaje C++; la funcionalidad del programa quedaba como esculpida en
273 piedra por los desarrolladores.  Este esquema resultó no ser muy
274 satisfactorio por una serie de motivos:
275
276 @itemize
277 @item Cuando LilyPond comete fallos,
278 los usuarios tienen la necesidad de superar las decisiones de
279 formateo.  Por ello el usuario debe tener acceso al motor de formateo.
280 De aquí que no podamos dejar establecidas las reglas y valores durante
281 la compilación, sino que los usuarios deben poder acceder a ellos
282 durante la ejecución del programa.
283
284 @item El grabado de música es cosa de juicio visual y por ello es cuestión de gustos.
285 A pesar de saber tanto como creemos saber, los usuarios pueden no
286 estar de acuerdo con nuestras decisiones personales. Por tanto la
287 definición del estilo tipográfico también debe estar al alcance del
288 usuario.
289
290 @item Por último, estamos continuamente refinando los algoritmos de formateo y por
291 tanto necesitamos un enfoque flexible para las reglas.  El lenguaje
292 C++ fuerza un cierto método para agrupar las reglas que no encaja bien
293 con la manera de funcionar de la notación musical.
294 @end itemize
295
296 Estos problemas se han solucionado integrando un intérprete del
297 lenguaje Scheme y reescribiendo parte del código de LilyPond en
298 Scheme.  La actual arquitectura de formateo se construye alrededor del
299 concepto de objetos gráficos, descrita por variables y funciones de
300 Scheme.  Esta arquitectura puede tratar al mismo tiempo con las reglas
301 de formateo, el estilo tipográfico y las decisiones de formateo
302 individuales.  El usuario tiene acceso directo a la mayor parte de
303 estos controles.
304
305 Las variables de Scheme controlan las decisiones de formateo.  Por
306 ejemplo, muchos objetos gráficos tienen una variable de dirección que
307 codifica la elección entre arriba y abajo (o izquierda y
308 derecha). Aquí puede ver dos acordes con acentos y signos de arpegio.
309 En el primer acorde los objetos gráficos tienen todas sus direcciones
310 hacia abajo (o hacia la izquierda).  El segundo acorde tiene todas las
311 direcciones hacia arriba (o hacia la derecha).
312
313 @lilypond[quote,ragged-right]
314 \new Score \with {
315    \override SpacingSpanner #'spacing-increment = #3
316    \override TimeSignature #'transparent = ##t
317 } \relative {
318    \stemDown <e g b>4_>-\arpeggio
319    \override Arpeggio #'direction = #RIGHT
320    \stemUp <e g b>4^>-\arpeggio
321 }
322 @end lilypond
323
324 @noindent
325 El proceso de formatear una partitura consiste en leer y escribir las
326 variables de los objetos gráficos.  Ciertas variables tienen un valor
327 predefinido.  Por ejemplo, el grosor de muchas líneas (una
328 característica del estilo tipográfico) son variables con un valor
329 preestablecido.  Podemos alterar este valor libremente dando así a
330 nuestra partitura una impresión tipográfica distinta.
331
332 @lilypond[quote,ragged-right]
333 fragment = {
334    \clef bass f8 as8
335    c'4-~ c'16 as g f e16 g bes c' des'4
336 }
337 <<
338    \new Staff \fragment
339    \new Staff \with {
340       \override Beam #'thickness = #0.3
341       \override Stem #'thickness = #0.5
342       \override Bar #'thickness = #3.6
343       \override Tie #'thickness = #2.2
344       \override StaffSymbol #'thickness = #3.0
345       \override Tie #'extra-offset = #'(0 .  0.3)
346       }
347       \fragment
348 >>
349 @end lilypond
350
351 Las reglas de formateo también son variables que están predefinidas:
352 cada objeto tiene unas variables que contienen procedimientos.  Estos
353 procedimientos realizan el trabajo real de formateo y sustituyéndolos
354 por otros podemos alterar el aspecto de los objetos.  En el siguiente
355 ejemplo, la regla que define cómo se dibuja la cabeza de una nota se
356 altera durante el transcurso del fragmento musical.
357
358 @lilypond[quote,ragged-right]
359 #(set-global-staff-size 30)
360
361 #(define (mc-squared grob orig current)
362   (let* ((interfaces (ly:grob-interfaces grob))
363          (pos (ly:grob-property grob 'staff-position)))
364     (if (memq 'note-head-interface interfaces)
365         (begin
366           (ly:grob-set-property! grob 'stencil ly:text-interface::print)
367           (ly:grob-set-property! grob 'font-family 'roman)
368           (ly:grob-set-property! grob 'text
369             (make-raise-markup -0.5
370               (case pos
371                 ((-5) (make-simple-markup "m"))
372                 ((-3) (make-simple-markup "c "))
373                 ((-2) (make-smaller-markup (make-bold-markup "2")))
374                 (else (make-simple-markup "bla")))))))))
375
376 \new Voice \relative c' {
377    \stemUp
378    \set autoBeaming = ##f
379    \time 2/4
380    <d f g>4
381    \once \override NoteHead #'stencil = #ly:note-head::brew-ez-stencil
382    \once \override NoteHead #'font-size = #-7
383    \once \override NoteHead #'font-family = #'sans
384    \once \override NoteHead #'font-series = #'bold
385    <d f g>
386    \once \override NoteHead #'style = #'cross
387    <d f g>
388    \applyOutput #'Voice #mc-squared
389    <d f g>
390    <<
391       { d8[ es-( fis^^ g] fis2-) }
392       \repeat unfold 5 { \applyOutput #'Voice #mc-squared s8 }
393    >>
394 }
395 @end lilypond
396
397
398
399 @node What symbols to engrave?
400 @unnumberedsubsec What symbols to engrave?
401
402 @cindex grabado
403 @cindex tipografía
404
405 El proceso de formateo toma las decisiones sobre dónde colocar los
406 símbolos.  Sin embargo esto sólo se puede hacer una vez que se ha
407 decidido @emph{qué} símbolos han de imprimirse, o dicho de otro modo:
408 qué notación utilizar.
409
410 La notación musical común es un sistema de registro de música que ha
411 venido evolucionando desde hace mil años.  La forma que se usa en
412 nuestros días data de los primeros tiempos del Renacimiento.  Aunque
413 la forma básica (es decir: puntos sobre una pauta de cinco líneas) no
414 ha cambiado, los detalles continúan evolucionando para expresar todas
415 las innovaciones de la notación contemporánea.  Por tanto abarca unos
416 quinientos años de música.  Sus aplicaciones se extienden sobre un
417 amplio rango que abarca desde melodías monofónicas hasta monstruosos
418 contrapuntos para gran orquesta.
419
420 ¿Cómo podemos tratar con una bestia de tantas cabezas, y obligarla a
421 que se encierre dentro de los límites de un programa de ordenador?
422 Nuestra solución es trocear el problema de la notación (por oposición
423 al grabado, esto es, a la tipografía) en fragmentos digeribles y más
424 fáciles de programar: cada tipo de símbolo se maneja por un módulo
425 separado que recibe el nombre de «plug-in».  Cada «plug-in» es
426 completamente modular e independiente, de forma que puede
427 desarrollarse y mejorarse por separado.  Estos «plug-ins» se llaman
428 @code{engraver}s (grabadores), por analogía con los artesanos que
429 traducen las ideas musicales a símbolos gráficos.
430
431 En el siguiente ejemplo vemos cómo comenzamos con un plug-in para las
432 cabezas de las notas, el @code{Note_heads_engraver}.
433
434 @lilypond[quote,ragged-right]
435 \include "engraver-example.ily"
436
437 \score {
438    \topVoice
439    \layout {
440    \context {
441       \Voice
442       \remove "Stem_engraver"
443       \remove "Phrasing_slur_engraver"
444       \remove "Slur_engraver"
445       \remove "Script_engraver"
446       \remove "Beam_engraver"
447       \remove "Auto_beam_engraver"
448    }
449    \context {
450       \Staff
451       \remove "Accidental_engraver"
452       \remove "Key_engraver"
453       \remove "Clef_engraver"
454       \remove "Bar_engraver"
455       \remove "Time_signature_engraver"
456       \remove "Staff_symbol_engraver"
457       \consists "Pitch_squash_engraver"
458    }
459 }
460 }
461 @end lilypond
462
463 @noindent
464 A continuación un @code{Staff_symbol_engraver} (grabador del
465 pentagrama) añade la pauta.
466
467 @lilypond[quote,ragged-right]
468 \include "engraver-example.ily"
469
470 \score {
471   \topVoice
472   \layout {
473     \context {
474       \Voice
475       \remove "Stem_engraver"
476       \remove "Phrasing_slur_engraver"
477       \remove "Slur_engraver"
478       \remove "Script_engraver"
479       \remove "Beam_engraver"
480       \remove "Auto_beam_engraver"
481     }
482     \context {
483       \Staff
484       \remove "Accidental_engraver"
485       \remove "Key_engraver"
486       \remove "Clef_engraver"
487       \remove "Bar_engraver"
488       \consists "Pitch_squash_engraver"
489       \remove "Time_signature_engraver"
490     }
491   }
492 }
493 @end lilypond
494
495 @noindent
496 El @code{Clef_engraver} (grabador de la clave) define un punto de
497 referencia para el pentagrama.
498
499 @lilypond[quote,ragged-right]
500 \include "engraver-example.ily"
501
502 \score {
503   \topVoice
504   \layout {
505     \context {
506       \Voice
507       \remove "Stem_engraver"
508       \remove "Phrasing_slur_engraver"
509       \remove "Slur_engraver"
510       \remove "Script_engraver"
511       \remove "Beam_engraver"
512       \remove "Auto_beam_engraver"
513     }
514     \context {
515       \Staff
516       \remove "Accidental_engraver"
517       \remove "Key_engraver"
518       \remove "Bar_engraver"
519       \remove "Time_signature_engraver"
520     }
521   }
522 }
523 @end lilypond
524
525 @noindent
526 y el @code{Stem_engraver} (grabador de las plicas) añade las plicas.
527
528 @lilypond[quote,ragged-right]
529 \include "engraver-example.ily"
530
531 \score {
532   \topVoice
533   \layout {
534     \context {
535       \Voice
536       \remove "Phrasing_slur_engraver"
537       \remove "Slur_engraver"
538       \remove "Script_engraver"
539       \remove "Beam_engraver"
540       \remove "Auto_beam_engraver"
541     }
542     \context {
543       \Staff
544       \remove "Accidental_engraver"
545       \remove "Key_engraver"
546       \remove "Bar_engraver"
547       \remove "Time_signature_engraver"
548     }
549   }
550 }
551 @end lilypond
552
553 @noindent
554 El @code{Stem_engraver} (grabador de plicas) recibe una notificación
555 cuando llega una cabeza. Cada vez que se ve una cabeza (o más, si es
556 un acorde), se crea un objeto plica y se conecta a la cabeza.
557 Añadiendo grabadores para las barras, ligaduras, acentos,
558 alteraciones, líneas divisorias, indicación de compás y armadura
559 conseguimos una notación completa.
560
561 @lilypond[quote,ragged-right]
562 \include "engraver-example.ily"
563 \score { \topVoice }
564 @end lilypond
565
566 Este sistema funciona bien para la música monofónica, pero ¿y con la
567 polifonía?  En notación polifónica muchas voces pueden compartir el
568 mismo pentagrama.
569
570 @lilypond[quote,ragged-right]
571 \include "engraver-example.ily"
572 \new Staff << \topVoice \\ \botVoice >>
573 @end lilypond
574
575 En esta situación, las alteraciones y la pauta se comparten, pero las
576 plicas, ligaduras, barras, etc. son propias de cada voz.  Por tanto
577 los grabadores han de agruparse.  Los grabadores de cabezas, plicas,
578 ligaduras, etc.  se unen en un grupo llamado @q{Contexto de voz},
579 mientras que los grabadores de la armadura, alteraciones, compás, etc.
580 van a un grupo que se llama @q{Contexto de la pauta}.  En el caso de
581 la polifonía, un único Contexto de pauta contiene más de un Contexto
582 de voz.  De forma semejante, varios Contextos de pauta pueden
583 agruparse en un único Contexto de partitura.  El Contexto de partitura
584 es el contexto de notación de más alto nivel.
585
586 @seealso
587
588 Referencia de funcionamiento interno:
589 @rinternals{Contexts}.
590
591 @lilypond[quote,ragged-right]
592 \include "engraver-example.ily"
593 \score {
594    <<
595       \new Staff << \topVoice \\ \botVoice >>
596       \new Staff << \pah \\ \hoom >>
597    >>
598 }
599 @end lilypond
600
601 @node Music representation
602 @unnumberedsubsec Music representation
603
604 Idealmente el formato de entrada para cualquier sistema de formateo de
605 alto nivel es una descripción abstracta del contenido.  En este caso,
606 eso constituiría la propia música, lo que plantea un tremendo
607 problema: ¿cómo podemos definir qué es realmente la música?  En lugar
608 de intentar hallar una respuesta, le hemos dado la vuelta a la
609 pregunta.  Escribimos un programa capaz de producir partituras y
610 ajustamos el formato para que sea tan escueto como sea posible.
611 Cuando el formato ya no puede reducirse más, por definición nos
612 habremos quedado con el contenido musical propiamente dicho.  Nuestro
613 programa sirve como definición formal de un documento musical.
614
615
616 La sintaxis también es el interfaz de usuario de LilyPond, así que es
617 fácil teclear
618
619 @example
620 @{
621   c'4 d'8
622 @}
623 @end example
624
625 @noindent
626 un Do1 (Do central) negra, y un Re1 (el Re por encima del Do central)
627 corchea.
628
629 @lilypond[quote]
630 {
631   c'4 d'8
632 }
633 @end lilypond
634
635 A una escala microscópica, dicha sintaxis es fácil de utilizar.  A una
636 escala mayor, la sintaxis también requiere una estructura.  ¿De qué
637 otra forma podríamos introducir piezas complejas como sinfonías u
638 óperas?  La estructura se forma mediante el concepto de expresiones
639 musicales: al combinar pequeños fragmentos de música dentro de otros
640 mayores, se pueden expresar ideas musicales más complejas.  Por
641 ejemplo
642
643 @lilypond[quote,verbatim,fragment,relative=1]
644 c4
645 @end lilypond
646
647 @noindent
648 Los acordes se pueden construir encerrando las notas entre @code{<<} y
649 @code{>>}
650
651 @c < > is not a music expression,
652 @c so we use <<>> iso. <> to drive home the point of
653 @c expressions.  Don't change this back --hwn.
654
655 @c FIXME: change this.  I can explain it better.  -gp
656 @example
657 <<c4 d4 e4>>
658 @end example
659
660 @lilypond[quote,fragment,relative=1]
661 \new Voice { <<c4 d4 e>> }
662 @end lilypond
663
664 @noindent
665 Esta expresión se coloca en secuencia encerrándola dentro de llaves
666 @code{@{@tie{}@dots{}@tie{}@}}
667
668 @example
669 @{ f4 <<c4 d4 e4>> @}
670 @end example
671
672 @lilypond[quote,relative=1,fragment]
673 { f4 <<c d e4>> }
674 @end lilypond
675
676 @noindent
677 Lo anterior, a su vez también es una expresión, y por ello se puede combinar
678 de nuevo con otra expresión simultánea (una blanca) usando <<,
679 @code{\\}, y >>
680
681 @example
682 << g2 \\ @{ f4 <<c4 d4 e4>> @} >>
683 @end example
684
685 @lilypond[quote,fragment,relative=2]
686 \new Voice { << g2 \\ { f4 <<c d e>> } >> }
687 @end lilypond
688
689 Las mencionadas estructuras recursivas se pueden especificar de forma
690 nítida y formal dentro de una gramática independiente del contexto.
691 El código de análisis también se genera a partir de esta gramática.
692 En otras palabras, la sintaxis de LilyPond está definida de una forma
693 clara y sin ambigüedades.
694
695 Los interfaces de usuario y la sintaxis son lo que la persona ve y con
696 lo que trata principalmente.  En parte, son fruto de preferencias
697 personales y como tales están sujetas a mucha discusión.  Aunque las
698 discusiones sobre el gusto tienen su mérito, no son demasiado
699 productivas.  Dentro de la escena global de LilyPond, la sintaxis de
700 la entrada tiene una importancia relativamente pequeña: inventarse una
701 sintaxis elegante es fácil, pero escribir un código de formateo
702 decente es mucho más difícil.  Esto también queda ilustrado por la
703 cantidad de líneas de código de los componentes respectivos: el
704 análisis y la representación se llevan menos del 10% del código
705 fuente.
706
707
708 @node Example applications
709 @unnumberedsubsec Example applications
710
711 Escribimos LilyPond como un experimento de cómo condensar el arte del
712 grabado de música dentro de un programa de ordenador.  Gracias a todo
713 este duro trabajo, el programa ahora se puede usar para hacer trabajos
714 útiles.  La aplicación más sencilla es imprimir notas.
715
716 @lilypond[quote,relative=1,fragment]
717 \time 2/4 c4 c g'4 g a4 a g2
718 @end lilypond
719
720 @noindent
721 Añadiendo los nombres de acordes y la letra, obtenemos una hoja guía
722 de acordes (lead sheet).
723
724 @lilypond[quote,ragged-right]
725 <<
726    \chords { c2 c f2 c }
727    \new Staff \relative c' { \time 2/4 c4 c g'4 g a4 a g2 }
728    \new Lyrics \lyricmode { twin4 kle twin kle lit tle star2 }
729 >>
730 @end lilypond
731
732 También se pueden imprimir notación polifónica y música para piano.
733 El ejemplo siguiente combina algunas otras construcciones exóticas.
734
735 @lilypondfile[quote,ragged-right]{screech-boink.ly}
736
737 Todos los fragmentos mostrados se han escrito a mano, pero esto no es
738 necesariamente así.  Puesto que el motor de formateo es casi
739 completamente automático, puede servir como medio de salida para otros
740 programas que manipulan música.  Por ejemplo, se puede usar también
741 para convertir bases de datos de fragmentos musicales en imágenes con
742 destino a páginas web y presentaciones multimedia.
743
744 Este manual también es un ejemplo de aplicación: el formato de entrada
745 es texto sencillo, y por ello se puede empotrar fácilmente dentro de
746 otros formatos basados en texto, como @LaTeX{}, HTML, o en el caso
747 concreto de este manual, Texinfo.  A través de un programa especial,
748 los fragmentos de entrada se pueden sustituir por imágenes musicales
749 dentro de los archivos de salida PDF o HTML resultantes.  Esto
750 convierte la tarea de mezclar música y texto dentro de los documentos,
751 en algo muy sencillo.
752
753
754
755 @node About the documentation
756 @section About the documentation
757
758 Esta sección explica la distintas partes de la documentación.
759
760
761 @c leave these lines wrapping around.  It's some texinfo 4.12 thing. -gp
762 @menu
763 * About the Learning Manual::  este manual es una introducción a LilyPond que porporciona explicaciones en profundidad sobre cómo crear notación.
764 * About the Music Glossary::  este manual explica términos musicales y aporta traducciones de términos a otros idiomas.
765 * About the Notation Reference::  este manual es la porción más importante de la documentación.  Proporciona información detallada sobre la creación de notación.  Este libro da por supuesto que el lector ya conoce el material básico cubierto en el Manual de aprendizaje y que está familiarizado con los términos musicales ingleses presentados en el Glosario musical.
766 * About the Application Usage::  trata sobre los programas concretos y los asuntos específicos de distintos sistemas operativos.
767 * About the Snippet List::  es una colección de ejemplos breves de LilyPond.
768 * About the Internals Reference::  este documento proporciona información sobre la programación interna de LilyPond, que es necesaria para construir los trucos.
769 * Other documentation::         existen algunas otras porciones de la documentación, como las Noticias y los archivos históricos de las listas de correo.
770 @end menu
771
772
773 @node About the Learning Manual
774 @unnumberedsubsec About the Learning Manual
775
776 Este libro explica cómo empezar a aprender LilyPond, así como algunos
777 conceptos clave en términos sencillos.  Se recomienda leer estos
778 capítulos de forma secuencial.
779
780 @itemize
781
782 @item
783 @ref{Introduction}:
784 explica los antecedentes y las metas generales de LilyPond.
785
786 @item
787 @ref{Tutorial}:
788 da una amable introducción a la tipografía musical.  Los usuarios que
789 se acercan por primera vez deben comenzar por aquí.
790
791 @item
792 @ref{Fundamental concepts}:
793 explica algunos conceptos generales sobre el formato de los archivos
794 de entrada de LilyPond.  Si no está seguro de dónde colocar una
795 instrucción ¡lea este capítulo!
796
797 @item
798 @ref{Tweaking output}:
799 muestra la manera de cambiar el grabado predeterminado que produce
800 LilyPond.
801
802 @item
803 @ref{Working on LilyPond projects}:
804 trata los usos prácticos de LilyPond y cómo evitar ciertos problemas
805 bastante comunes.  ¡Léalo antes de emprender proyectos grandes!
806
807
808 @end itemize
809
810 El Manual de aprendizaje contiene también apéndices que no forman
811 parte de la lectura lineal recomendada.  Pueden ser útiles para una
812 mirada posterior:
813
814 @itemize
815
816 @item
817 @ref{Templates}: muestra plantillas de piezas de LilyPond, listas para
818 usar.  Tan sólo tiene que cortar y pegar una plantilla en uin archivo,
819 excribir las notas, y ¡habrá terminado!
820
821 @item
822 @ref{Scheme tutorial}: presenta una breve introducción a Scheme, el
823 lenguaje de programación que usan las funciones musicales.  Se trata
824 de material para trucos avanzados; muchos usuarios jamás llegan
825 siquiera a tocar el Scheme.
826
827 @end itemize
828
829
830 @node About the Music Glossary
831 @unnumberedsubsec About the Music Glossary
832
833 @cindex frase idiomática
834 @cindex jerga
835 @cindex terminología
836 @cindex idomas extranjeros
837 @cindex idiomas
838
839 @ref{Top,Music glossary,,music-glossary}: explica términos musicales e
840 incluye traducciones a varios idiomas.  Si no está familiarizado con
841 la notación o la terminología musicales (especialmente si no es un
842 anglófono nativo), es muy recomendable que consulte el glosario.
843
844
845 @node About the Notation Reference
846 @unnumberedsubsec About the Notation Reference
847
848 Este libro explica todas las instrucciones de LilyPond que producen
849 notación impresa.  Da por supuesto que el lector está familiarizado
850 con los conceptos del manual de aprendizaje.
851
852 @itemize
853
854 @item
855 @ruser{Musical notation}:
856 trata ciertos temas agrupados según las construcciones de notación.
857 Esta sección proporciona detalles sobre notación básica que
858 probablemente serán de utilidad en casi cualquier proyecto de
859 notación.
860
861 @item
862 @ruser{Specialist notation}:
863 también trata los temas agrupados por construcciones de notación.
864 Esta sección proporciona detalles sobre notación especial que
865 solamente será útil para ciertos grupos de instrumentos (o voces).
866
867 @item
868 @ruser{General input and output}:
869 trata de información general sobre los archivos de LilyPond y el
870 control sobre la salida.
871
872 @item
873 @ruser{Spacing issues}:
874 trata asuntos que afectan a la salida global, como la elección del
875 tamaño del papel o la especificación de los saltos de página.
876
877 @item
878 @ruser{Changing defaults}:
879 explica cómo hacer los ajustes que permitan a LilyPond producir
880 exactamente la notación que desee.
881
882 @item
883 @ruser{Interfaces for programmers}:
884 explica cómo crear funciones musicales con Scheme.
885
886 @end itemize
887
888 El manual de Referencia de la notación también contiene unos apéndices con útiles tablas de
889 referencia.
890
891
892 @itemize
893
894 @item
895 @ruser{Literature list}:
896 contiene un conjunto de libros de referencia muy útiles para aquellas
897 personas que desean saber más sobre notación y grabado.
898
899 @item
900 @ruser{Notation manual tables}:
901 son un conjunto de tablas que relacionan los nombres de los acordes,
902 instrumentos MIDI, nombres de los colores y la tipografía Feta.
903
904 @item
905 @ruser{Cheat sheet}:
906 es una manejable referencia de las instrucciones de LilyPond más
907 comunes.
908
909 @item
910 @ruser{LilyPond command index}:
911 un úndice de todas las @code{\instrucciones} de LilyPond.
912
913 @item
914 @ruser{LilyPond index}:
915 un índice completo.
916
917 @end itemize
918
919 @node About the Application Usage
920 @unnumberedsubsec About the Application Usage
921
922 Este libro explica la manera de ejecutar el programa y cómo integrar
923 la notación de LilyPond con otros programas.
924
925 @itemize
926
927 @item
928 @rprogram{Install}:
929 explica cómo instalar LilyPond (incluyendo la compilación, si se
930 desea).
931
932 @item
933 @rprogram{Setup}:
934 describe cómo debe configurar el sistema para una utilización óptima
935 de LilyPond, como por ejemplo el uso de entornos especiales para
936 determinados editores de texto.
937
938 @item
939 @rprogram{Running LilyPond}:
940 trata sobre cómo ejecutar LilyPond y sus programas de apoyo.  Además,
941 esta sección explica cómo actualizar las partituras a partir de
942 versiones anteriores de LilyPond.
943
944 @item
945 @rprogram{LilyPond-book}:
946 da los detalles que se encuentran detrás de la creación de documentos
947 con ejemplos de música insertados, como este mismo manual.
948
949 @item
950 @rprogram{Converting from other formats}:
951 explica cómo ejecutar los programas de conversión.  Estos programas
952 vienen incluidos en el mismo paquete que el propio LilyPond, y
953 convierten una amplia variedad de formatos de música al formato
954 @code{.ly}.
955
956 @end itemize
957
958 @node About the Snippet List
959 @unnumberedsubsec About the Snippet List
960
961 @cindex snippets (fragmentos de código)
962 @cindex LSR
963
964 @c FIXME: check on kainhofer.
965 @rlsrnamed{Top,LilyPond Snippet List}:
966 presenta un conjunto seleccionado de pfragmentos de código de LilyPond
967 procedentes del @uref{http://lsr@/.dsi@/.unimi@/.it,Repositorio de
968 Fragmentos de Código} (LSR).  Se encuentra en el dominio público.
969
970 Observe que este documento no es un subconjunto exacto de LSR.  El LSR
971 ejecuta una versión estable de LilyPond, por lo que cualquier
972 fragmento de código que muestre posibilidades nuevas de una versión de
973 desarrollo se tiene que añadir por separado.  Éstas se almacenan en
974 @file{input/new/} dentro del árbol del código fuente de LilyPond.
975
976 La lista de fragmentos de código para cada una de las subsecciones del
977 Manual de Referencia de la Notación también se encuentran
978 enlazados desde la parte @strong{Véase también}.
979
980
981 @node About the Internals Reference
982 @unnumberedsubsec About the Internals Reference
983
984 @c zzz
985
986 @itemize
987 @item
988 La
989 @iftex
990 Referencia de Funcionamiento Interno
991 @end iftex
992 @ifnottex
993 @ref{Top,Internals Reference,,lilypond-internals}
994 @end ifnottex
995 es un conjunto de páginas HTML con una tupida red de enlaces cruzados,
996 que documentan al detalle el meollo de todas y cada una de las clases,
997 objetos y funciones de LilyPond.  Se produce directamente a partir de
998 las definiciones de formateo que se utilizan.
999
1000 Casi toda la funcionalidad de formateo que se emplea internamente, se
1001 encuentra disponible para el usuario de forma directa.  Por ejemplo,
1002 todas las variables que controlan los valores de grosor, distancias,
1003 etc., se pueden cambiar dentro de los archivos de entrada.  Hay un
1004 enorme número de opciones de formateo, y todas ellas se describen en
1005 este documento.  Cada sección del manual de notación tiene una
1006 subsección @b{Véase también}, que hace referencia a la documentación
1007 generada.  En el documento HTML, estas subsecciones llevan enlaces que
1008 se pueden seguir, pulsando sobre ellos.
1009
1010 @end itemize
1011
1012 @node Other documentation
1013 @unnumberedsubsec Other documentation
1014
1015 Existen algunos otros lugares que pueden resultar muy valiosos.
1016
1017 Cuando ya sea un usuario con experiencia podrá usar el manual como
1018 referencia: hay un índice muy completo@footnote{Si está buscando algo
1019 y no lo encuentra en el manual, eso se considera un @emph{bug}
1020 (fallo).  En este caso le rogamos que envíe un informe de fallo.},
1021 pero el documento también está disponible en
1022 @iftex
1023 una sola página HTML,
1024 @end iftex
1025 @ifhtml
1026 @uref{source/Documentation/user/lilypond-big-page.html,una sola página enorme},
1027 @end ifhtml
1028 en la que es fácil buscar cualquier cosa utilizando la función de búsqueda de su
1029 navegador de web.
1030  
1031
1032 En todos los documentos HTML que tienen fragmentos de música
1033 incrustados, la entrada de LilyPond que se utilizó para producir dicha
1034 imagen se puede ver pulsando con el ratón sobre la imagen.
1035
1036 La localización exacta de los archivos de documentación que hemos
1037 mencionado puede variar de un sistema a otro.  En ocasiones este
1038 manual hace referencia a archivos de inicialización y de ejemplo.  A
1039 lo largo del manual, nos referimos a archivos de entrada por su ruta
1040 relativa respecto de directorio de nivel más alto de los archivos de
1041 código fuente.  Por ejemplo, @file{input/@/lsr/@/carpeta/@/bla@/.ly}
1042 puede referirse al archivo
1043 @file{lilypond@/2.x.y/@/input/@/lsr/@/carpeta/@/bla@/.ly}.  En los
1044 paquetes binarios para la plataforma Unix, normalmente la
1045 documentación y los ejemplos se encuentran en algún lugar dentro de
1046 @file{/usr/@/share/@/doc/@/lilypond/}. Los archivos de inicialización,
1047 como por ejemplo @file{scm/@/lily@/.scm}, o
1048 @file{ly/@/engraver@/-init@/.ly}, se encuentran normalmente en el
1049 directorio @file{/usr/@/share/@/lilypond/}.
1050
1051 @cindex ajustar la salida
1052 @cindex variables
1053 @cindex propiedades
1054 @cindex funcionamiento interno de lilypond
1055 @cindex documentación interna
1056 @cindex Scheme
1057 @cindex extender lilypond
1058 @cindex índice
1059
1060 Por último, este y el resto de los manuales están disponibles en línea
1061 tanto como archivos PDF como en HTML en el sitio web, que encontrará
1062 en @uref{http://@/www@/.lilypond@/.org/}.
1063