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