]> git.donarmstrong.com Git - lilypond.git/blob - Documentation/es/user/introduction.itely
Fix docs compilation programming errors and warnings.
[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
382             (grob-interpret-markup grob
383               (make-lower-markup 0.5
384                 (case pos
385                   ((-5) "m")
386                   ((-3) "c ")
387                   ((-2) (make-smaller-markup (make-bold-markup "2")))
388                   (else "bla")))))))))
389
390 \new Voice \relative c' {
391   \stemUp
392   \set autoBeaming = ##f
393   \time 2/4
394   <d f g>4
395   \once \override NoteHead #'stencil = #ly:note-head::brew-ez-stencil
396   \once \override NoteHead #'font-size = #-7
397   \once \override NoteHead #'font-family = #'sans
398   \once \override NoteHead #'font-series = #'bold
399   <d f g>4
400   \once \override NoteHead #'style = #'cross
401   <d f g>4
402   \applyOutput #'Voice #mc-squared
403   <d f g>4
404   <<
405     { d8[ es-( fis^^ g] fis2-) }
406     \repeat unfold 5 { \applyOutput #'Voice #mc-squared s8 }
407   >>
408 }
409 @end lilypond
410
411
412
413 @node What symbols to engrave?
414 @unnumberedsubsec What symbols to engrave?
415
416 @cindex grabado
417 @cindex tipografía
418 @cindex grabador
419 @cindex plug-in
420 @cindex complemento (plugin)
421
422 El proceso de formateo toma las decisiones sobre dónde colocar los
423 símbolos.  Sin embargo esto sólo se puede hacer una vez que se ha
424 decidido @emph{qué} símbolos han de imprimirse, o dicho de otro modo:
425 qué notación utilizar.
426
427 La notación musical común es un sistema de registro de música que ha
428 venido evolucionando desde hace mil años.  La forma que se usa en
429 nuestros días data de los primeros tiempos del Renacimiento.  Aunque
430 la forma básica (es decir: puntos sobre una pauta de cinco líneas) no
431 ha cambiado, los detalles continúan evolucionando para expresar todas
432 las innovaciones de la notación contemporánea.  Por tanto abarca unos
433 quinientos años de música.  Sus aplicaciones se extienden sobre un
434 amplio rango que abarca desde melodías monofónicas hasta monstruosos
435 contrapuntos para gran orquesta.
436
437 ¿Cómo podemos tratar con una bestia de tantas cabezas, y obligarla a
438 que se encierre dentro de los límites de un programa de ordenador?
439 Nuestra solución es trocear el problema de la notación (por oposición
440 al grabado, esto es, a la tipografía) en fragmentos digeribles y más
441 fáciles de programar: cada tipo de símbolo se maneja por un módulo
442 separado que recibe el nombre de «plug-in».  Cada «plug-in» es
443 completamente modular e independiente, de forma que puede
444 desarrollarse y mejorarse por separado.  Estos «plug-ins» se llaman
445 @code{engraver}s (grabadores), por analogía con los artesanos que
446 traducen las ideas musicales a símbolos gráficos.
447
448 En el siguiente ejemplo vemos cómo comenzamos con un plug-in para las
449 cabezas de las notas, el @code{Note_heads_engraver}.
450
451 @lilypond[quote,ragged-right]
452 \include "engraver-example.ily"
453
454 \score {
455   \topVoice
456   \layout {
457     \context {
458       \Voice
459       \remove "Stem_engraver"
460       \remove "Phrasing_slur_engraver"
461       \remove "Slur_engraver"
462       \remove "Script_engraver"
463       \remove "Beam_engraver"
464       \remove "Auto_beam_engraver"
465     }
466     \context {
467       \Staff
468       \remove "Accidental_engraver"
469       \remove "Key_engraver"
470       \remove "Clef_engraver"
471       \remove "Bar_engraver"
472       \remove "Time_signature_engraver"
473       \remove "Staff_symbol_engraver"
474       \consists "Pitch_squash_engraver"
475     }
476   }
477 }
478 @end lilypond
479
480 @noindent
481 A continuación un @code{Staff_symbol_engraver} (grabador del
482 pentagrama) añade la pauta.
483
484 @lilypond[quote,ragged-right]
485 \include "engraver-example.ily"
486
487 \score {
488   \topVoice
489   \layout {
490     \context {
491       \Voice
492       \remove "Stem_engraver"
493       \remove "Phrasing_slur_engraver"
494       \remove "Slur_engraver"
495       \remove "Script_engraver"
496       \remove "Beam_engraver"
497       \remove "Auto_beam_engraver"
498     }
499     \context {
500       \Staff
501       \remove "Accidental_engraver"
502       \remove "Key_engraver"
503       \remove "Clef_engraver"
504       \remove "Bar_engraver"
505       \consists "Pitch_squash_engraver"
506       \remove "Time_signature_engraver"
507     }
508   }
509 }
510 @end lilypond
511
512 @noindent
513 El @code{Clef_engraver} (grabador de la clave) define un punto de
514 referencia para el pentagrama.
515
516 @lilypond[quote,ragged-right]
517 \include "engraver-example.ily"
518
519 \score {
520   \topVoice
521   \layout {
522     \context {
523       \Voice
524       \remove "Stem_engraver"
525       \remove "Phrasing_slur_engraver"
526       \remove "Slur_engraver"
527       \remove "Script_engraver"
528       \remove "Beam_engraver"
529       \remove "Auto_beam_engraver"
530     }
531     \context {
532       \Staff
533       \remove "Accidental_engraver"
534       \remove "Key_engraver"
535       \remove "Bar_engraver"
536       \remove "Time_signature_engraver"
537     }
538   }
539 }
540 @end lilypond
541
542 @noindent
543 y el @code{Stem_engraver} (grabador de las plicas) añade las plicas.
544
545 @lilypond[quote,ragged-right]
546 \include "engraver-example.ily"
547
548 \score {
549   \topVoice
550   \layout {
551     \context {
552       \Voice
553       \remove "Phrasing_slur_engraver"
554       \remove "Slur_engraver"
555       \remove "Script_engraver"
556       \remove "Beam_engraver"
557       \remove "Auto_beam_engraver"
558     }
559     \context {
560       \Staff
561       \remove "Accidental_engraver"
562       \remove "Key_engraver"
563       \remove "Bar_engraver"
564       \remove "Time_signature_engraver"
565     }
566   }
567 }
568 @end lilypond
569
570 @noindent
571 El @code{Stem_engraver} (grabador de plicas) recibe una notificación
572 cuando llega una cabeza. Cada vez que se ve una cabeza (o más, si es
573 un acorde), se crea un objeto plica y se conecta a la cabeza.
574 Añadiendo grabadores para las barras, ligaduras, acentos,
575 alteraciones, líneas divisorias, indicación de compás y armadura
576 conseguimos una notación completa.
577
578 @lilypond[quote,ragged-right]
579 \include "engraver-example.ily"
580 \score { \topVoice }
581 @end lilypond
582
583 @cindex polifonía
584 @cindex grabar varias voces
585 @cindex contextos
586
587 Este sistema funciona bien para la música monofónica, pero ¿y con la
588 polifonía?  En notación polifónica muchas voces pueden compartir el
589 mismo pentagrama.
590
591 @lilypond[quote,ragged-right]
592 \include "engraver-example.ily"
593 \new Staff << \topVoice \\ \botVoice >>
594 @end lilypond
595
596 En esta situación, las alteraciones y la pauta se comparten, pero las
597 plicas, ligaduras, barras, etc. son propias de cada voz.  Por tanto
598 los grabadores han de agruparse.  Los grabadores de cabezas, plicas,
599 ligaduras, etc.  se unen en un grupo llamado @q{Contexto de voz},
600 mientras que los grabadores de la armadura, alteraciones, compás, etc.
601 van a un grupo que se llama @q{Contexto de la pauta}.  En el caso de
602 la polifonía, un único Contexto de pauta contiene más de un Contexto
603 de voz.  De forma semejante, varios Contextos de pauta pueden
604 agruparse en un único Contexto de partitura.  El Contexto de partitura
605 es el contexto de notación de más alto nivel.
606
607
608 @seealso
609 Referencia de funcionamiento interno:
610 @rinternals{Contexts}.
611
612
613 @lilypond[quote,ragged-right]
614 \include "engraver-example.ily"
615 \score {
616    <<
617       \new Staff << \topVoice \\ \botVoice >>
618       \new Staff << \pah \\ \hoom >>
619    >>
620 }
621 @end lilypond
622
623 @node Music representation
624 @unnumberedsubsec Music representation
625
626 @cindex sintaxis
627 @cindex recursivas, estructuras
628
629 Idealmente el formato de entrada para cualquier sistema de formateo de
630 alto nivel es una descripción abstracta del contenido.  En este caso,
631 eso constituiría la propia música, lo que plantea un tremendo
632 problema: ¿cómo podemos definir qué es realmente la música?  En lugar
633 de intentar hallar una respuesta, le hemos dado la vuelta a la
634 pregunta.  Escribimos un programa capaz de producir partituras y
635 ajustamos el formato para que sea tan escueto como sea posible.
636 Cuando el formato ya no puede reducirse más, por definición nos
637 habremos quedado con el contenido musical propiamente dicho.  Nuestro
638 programa sirve como definición formal de un documento musical.
639
640
641 La sintaxis también es el interfaz de usuario de LilyPond, así que es
642 fácil teclear
643
644 @example
645 @{
646   c'4 d'8
647 @}
648 @end example
649
650 @noindent
651 un Do4 (Do central) negra, y un Re4 (el Re por encima del Do central)
652 corchea.
653
654 @lilypond[quote]
655 {
656   c'4 d'8
657 }
658 @end lilypond
659
660 A una escala microscópica, dicha sintaxis es fácil de utilizar.  A una
661 escala mayor, la sintaxis también requiere una estructura.  ¿De qué
662 otra forma podríamos introducir piezas complejas como sinfonías u
663 óperas?  La estructura se forma mediante el concepto de expresiones
664 musicales: al combinar pequeños fragmentos de música dentro de otros
665 mayores, se pueden expresar ideas musicales más complejas.  Por
666 ejemplo
667
668 @lilypond[quote,verbatim,fragment,relative=1]
669 f4
670 @end lilypond
671
672 @noindent
673 Los acordes se pueden construir encerrando las notas entre @code{<<} y
674 @code{>>}
675
676 @c < > is not a music expression,
677 @c so we use <<>> iso. <> to drive home the point of
678 @c expressions.  Don't change this back --hwn.
679
680 @c FIXME: change this.  I can explain it better.  -gp
681 @example
682 <<c4 d4 e4>>
683 @end example
684
685 @lilypond[quote,fragment,relative=1]
686 \new Voice { <<c4 d4 e>> }
687 @end lilypond
688
689 @noindent
690 Esta expresión se coloca en secuencia encerrándola dentro de llaves
691 @code{@{@tie{}@dots{}@tie{}@}}
692
693 @example
694 @{ f4 <<c4 d4 e4>> @}
695 @end example
696
697 @lilypond[quote,relative=1,fragment]
698 { f4 <<c d e4>> }
699 @end lilypond
700
701 @noindent
702 Lo anterior, a su vez también es una expresión, y por ello se puede combinar
703 de nuevo con otra expresión simultánea (una blanca) usando <<,
704 @code{\\}, y >>
705
706 @example
707 << g2 \\ @{ f4 <<c4 d4 e4>> @} >>
708 @end example
709
710 @lilypond[quote,fragment,relative=2]
711 \new Voice { << g2 \\ { f4 <<c d e>> } >> }
712 @end lilypond
713
714 Las mencionadas estructuras recursivas se pueden especificar de forma
715 nítida y formal dentro de una gramática independiente del contexto.
716 El código de análisis también se genera a partir de esta gramática.
717 En otras palabras, la sintaxis de LilyPond está definida de una forma
718 clara y sin ambigüedades.
719
720 Los interfaces de usuario y la sintaxis son lo que la persona ve y con
721 lo que trata principalmente.  En parte, son fruto de preferencias
722 personales y como tales están sujetas a mucha discusión.  Aunque las
723 discusiones sobre el gusto tienen su mérito, no son demasiado
724 productivas.  Dentro de la escena global de LilyPond, la sintaxis de
725 la entrada tiene una importancia relativamente pequeña: inventarse una
726 sintaxis elegante es fácil, pero escribir un código de formateo
727 decente es mucho más difícil.  Esto también queda ilustrado por la
728 cantidad de líneas de código de los componentes respectivos: el
729 análisis y la representación se llevan menos del 10% del código
730 fuente.
731
732
733 @node Example applications
734 @unnumberedsubsec Example applications
735
736 @cindex sencillos, ejemplos
737 @cindex ejemplos sencillos
738
739 Escribimos LilyPond como un experimento de cómo condensar el arte del
740 grabado de música dentro de un programa de ordenador.  Gracias a todo
741 este duro trabajo, el programa ahora se puede usar para hacer trabajos
742 útiles.  La aplicación más sencilla es imprimir notas.
743
744 @lilypond[quote,relative=1]
745 {
746   \time 2/4
747   c4 c g'4 g a4 a g2
748 }
749 @end lilypond
750
751 @noindent
752 Añadiendo los nombres de acordes y la letra, obtenemos una hoja guía
753 de acordes (lead sheet).
754
755 @c KEEP LY
756 @lilypond[quote,ragged-right]
757 <<
758    \chords { c2 c f2 c }
759    \new Staff
760    \relative c' {
761      \time 2/4
762      c4 c g' g a a g2
763    }
764    \addlyrics { cam -- pa -- ni -- ta del lu -- gar }
765 >>
766 @end lilypond
767
768 También se puede imprimir notación polifónica y música para piano.
769 El ejemplo siguiente combina algunas otras construcciones exóticas.
770
771 @lilypond[quote]
772 \header {
773   title = "Screech and boink"
774   subtitle = "Random complex notation"
775   composer = "Han-Wen Nienhuys"
776 }
777
778 \score {
779   \context PianoStaff <<
780     \new Staff = "up" {
781       \time 4/8
782       \key c \minor
783       << {
784         \revert Stem #'direction
785         \change Staff = down
786         \set subdivideBeams = ##t
787         g16.[
788           \change Staff = up
789           c'''32
790           \change Staff = down
791           g32
792           \change Staff = up
793           c'''32
794           \change Staff = down
795           g16]
796         \change Staff = up
797         \stemUp
798         \set followVoice = ##t
799         c'''32([ b''16 a''16 gis''16 g''32)]
800       } \\ {
801         s4 \times 2/3 { d'16[ f' g'] } as'32[ b''32 e'' d'']
802       } \\ {
803         s4 \autoBeamOff d''8.. f''32
804       } \\ {
805         s4 es''4
806       } >>
807     }
808
809     \new Staff = "down" {
810       \clef bass
811       \key c \minor
812       \set subdivideBeams = ##f
813       \override Stem  #'french-beaming = ##t
814       \override Beam  #'thickness = #0.3
815       \override Stem  #'thickness = #4.0
816       g'16[ b16 fis16 g16]
817       << \makeClusters {
818         as16 <as b>
819         <g b>
820         <g cis>
821       } \\ {
822         \override Staff.Arpeggio  #'arpeggio-direction =#down
823         <cis, e, gis, b, cis>4\arpeggio
824       }
825     >> }
826   >>
827   \midi {
828     \context {
829       \Score
830       tempoWholesPerMinute = #(ly:make-moment 60 8)
831     }
832   }
833   \layout {
834     \context {
835       \Staff
836       \consists Horizontal_bracket_engraver
837     }
838   }
839 }
840 @end lilypond
841
842 Todos los fragmentos mostrados se han escrito a mano, pero esto no es
843 necesariamente así.  Puesto que el motor de formateo es casi
844 completamente automático, puede servir como medio de salida para otros
845 programas que manipulan música.  Por ejemplo, se puede usar también
846 para convertir bases de datos de fragmentos musicales en imágenes con
847 destino a páginas web y presentaciones multimedia.
848
849 Este manual también es un ejemplo de aplicación: el formato de entrada
850 es texto sencillo, y por ello se puede empotrar fácilmente dentro de
851 otros formatos basados en texto, como @LaTeX{}, HTML, o en el caso
852 concreto de este manual, Texinfo.  A través de un programa especial,
853 los fragmentos de entrada se pueden sustituir por imágenes musicales
854 dentro de los archivos de salida PDF o HTML resultantes.  Esto
855 convierte la tarea de mezclar música y texto dentro de los documentos,
856 en algo muy sencillo.
857
858
859
860 @node About the documentation
861 @section About the documentation
862
863 Esta sección explica la distintas partes de la documentación.
864
865 @cindex Manual de aprendizaje
866 @cindex Glosario musical
867 @cindex Referencia de la notación
868 @cindex Utilización del programa
869 @cindex Fragmentos de código
870 @cindex Referencia de funcionamiento interno
871
872 @c leave these lines wrapping around.  It's some texinfo 4.12 thing. -gp
873 @c This is actually a limitation of texi2html. -jm
874 @menu
875 * About the Learning Manual::   Este manual es una introducción a LilyPond que porporciona explicaciones en profundidad sobre cómo crear notación.
876 * About the Music Glossary::    Este manual explica términos musicales y aporta traducciones de términos a otros idiomas.
877 * 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.
878 * About the Application Usage::  Trata sobre los programas concretos y los asuntos específicos de distintos sistemas operativos.
879 * About the Snippet List::      Es una colección de ejemplos breves de LilyPond.
880 * About the Internals Reference::  Este documento proporciona información sobre la programación interna de LilyPond, que es necesaria para construir los trucos.
881 * Other documentation::         Existen algunas otras porciones de la documentación, como las Noticias y los archivos históricos de las listas de correo.
882 @end menu
883
884
885 @node About the Learning Manual
886 @unnumberedsubsec About the Learning Manual
887
888 @cindex Manual de aprendizaje
889
890 Este libro explica cómo empezar a aprender LilyPond, así como algunos
891 conceptos clave en términos sencillos.  Se recomienda leer estos
892 capítulos de forma secuencial.
893
894 @itemize
895
896 @item
897 @ref{Introduction}:
898 explica los antecedentes y las metas generales de LilyPond.
899
900 @item
901 @ref{Tutorial}:
902 da una amable introducción a la tipografía musical.  Los usuarios que
903 se acercan por primera vez deben comenzar por aquí.
904
905 @item
906 @ref{Fundamental concepts}:
907 explica algunos conceptos generales sobre el formato de los archivos
908 de entrada de LilyPond.  Si no está seguro de dónde colocar una
909 instrucción ¡lea este capítulo!
910
911 @item
912 @ref{Tweaking output}:
913 muestra la manera de cambiar el grabado predeterminado que produce
914 LilyPond.
915
916 @item
917 @ref{Working on LilyPond projects}:
918 trata los usos prácticos de LilyPond y cómo evitar ciertos problemas
919 bastante comunes.  ¡Léalo antes de emprender proyectos grandes!
920
921
922 @end itemize
923
924 El Manual de aprendizaje contiene también apéndices que no forman
925 parte de la lectura lineal recomendada.  Pueden ser útiles para una
926 mirada posterior:
927
928 @itemize
929
930 @item
931 @ref{Templates}: muestra plantillas de piezas de LilyPond, listas para
932 usar.  Tan sólo tiene que cortar y pegar una plantilla en un archivo,
933 escribir las notas, y ¡habrá terminado!
934
935 @item
936 @ref{Scheme tutorial}: presenta una breve introducción a Scheme, el
937 lenguaje de programación que usan las funciones musicales.  Se trata
938 de material para trucos avanzados; muchos usuarios jamás llegan
939 siquiera a tocar el Scheme.
940
941 @end itemize
942
943
944 @node About the Music Glossary
945 @unnumberedsubsec About the Music Glossary
946
947 @cindex Glosario musical
948 @cindex frase idiomática
949 @cindex jerga
950 @cindex terminología
951 @cindex idomas extranjeros
952 @cindex idiomas
953
954 @rglosnamed{Top,Glosario musical}: explica términos musicales e incluye
955 traducciones a varios idiomas.  Si no está familiarizado con la
956 notación o la terminología musicales (especialmente si no es un
957 anglófono nativo), es muy recomendable que consulte el glosario.
958
959
960 @node About the Notation Reference
961 @unnumberedsubsec About the Notation Reference
962
963 @cindex Referencia de la notación
964 @cindex apéndices
965 @cindex referencia, cuadros de
966 @cindex cuadros de referencia
967
968 Este libro explica todas las instrucciones de LilyPond que producen
969 notación impresa.  Da por supuesto que el lector está familiarizado
970 con los conceptos del manual de aprendizaje.
971
972 @itemize
973
974 @item
975 @ruser{Musical notation}:
976 trata ciertos temas agrupados según las construcciones de notación.
977 Esta sección proporciona detalles sobre notación básica que
978 probablemente serán de utilidad en casi cualquier proyecto de
979 notación.
980
981 @item
982 @ruser{Specialist notation}:
983 también trata los temas agrupados por construcciones de notación.
984 Esta sección proporciona detalles sobre notación especial que
985 solamente será útil para ciertos grupos de instrumentos (o voces).
986
987 @item
988 @ruser{General input and output}:
989 trata de información general sobre los archivos de LilyPond y el
990 control sobre la salida.
991
992 @item
993 @ruser{Spacing issues}:
994 trata asuntos que afectan a la salida global, como la elección del
995 tamaño del papel o la especificación de los saltos de página.
996
997 @item
998 @ruser{Changing defaults}:
999 explica cómo hacer los ajustes que permitan a LilyPond producir
1000 exactamente la notación que desee.
1001
1002 @item
1003 @ruser{Interfaces for programmers}:
1004 explica cómo crear funciones musicales con Scheme.
1005
1006 @end itemize
1007
1008 El manual de Referencia de la notación también contiene unos apéndices con útiles tablas de
1009 referencia.
1010
1011
1012 @itemize
1013
1014 @item
1015 @ruser{Literature list}:
1016 contiene un conjunto de libros de referencia muy útiles para aquellas
1017 personas que desean saber más sobre notación y grabado.
1018
1019 @item
1020 @ruser{Notation manual tables}:
1021 son un conjunto de tablas que relacionan los nombres de los acordes,
1022 instrumentos MIDI, nombres de los colores y la tipografía Feta.
1023
1024 @item
1025 @ruser{Cheat sheet}:
1026 es una manejable referencia de las instrucciones de LilyPond más
1027 comunes.
1028
1029 @item
1030 @ruser{LilyPond command index}:
1031 un úndice de todas las @code{\instrucciones} de LilyPond.
1032
1033 @item
1034 @ruser{LilyPond index}:
1035 un índice completo.
1036
1037 @end itemize
1038
1039 @node About the Application Usage
1040 @unnumberedsubsec About the Application Usage
1041
1042 @cindex Utilización del programa
1043 @cindex integrar LilyPond con otros programas
1044
1045 Este libro explica la manera de ejecutar el programa y cómo integrar
1046 la notación de LilyPond con otros programas.
1047
1048 @itemize
1049
1050 @item
1051 @rprogram{Install}:
1052 explica cómo instalar LilyPond (incluyendo la compilación, si se
1053 desea).
1054
1055 @item
1056 @rprogram{Setup}:
1057 describe cómo debe configurar el sistema para una utilización óptima
1058 de LilyPond, como por ejemplo el uso de entornos especiales para
1059 determinados editores de texto.
1060
1061 @item
1062 @rprogram{Running LilyPond}:
1063 trata sobre cómo ejecutar LilyPond y sus programas de apoyo.  Además,
1064 esta sección explica cómo actualizar las partituras a partir de
1065 versiones anteriores de LilyPond.
1066
1067 @item
1068 @rprogram{LilyPond-book}:
1069 da los detalles que se encuentran detrás de la creación de documentos
1070 con ejemplos de música insertados, como este mismo manual.
1071
1072 @item
1073 @rprogram{Converting from other formats}:
1074 explica cómo ejecutar los programas de conversión.  Estos programas
1075 vienen incluidos en el mismo paquete que el propio LilyPond, y
1076 convierten una amplia variedad de formatos de música al formato
1077 @code{.ly}.
1078
1079 @end itemize
1080
1081 @node About the Snippet List
1082 @unnumberedsubsec About the Snippet List
1083
1084 @cindex snippets (fragmentos de código)
1085 @cindex fragmentos de código (snippets)
1086 @cindex LSR
1087 @cindex LilyPond Snippet Repository
1088
1089 @rlsrnamed{Top,Lista de fragmentos de código de LilyPond}: presenta un conjunto
1090 seleccionado de fragmentos de código de LilyPond procedentes del
1091 @uref{http://lsr@/.dsi@/.unimi@/.it,Repositorio de Fragmentos de
1092 Código} (LSR).  Todos los fragmentos se encuentran en el dominio
1093 público.
1094
1095 Observe que este documento no es un subconjunto exacto de LSR.  El LSR
1096 ejecuta una versión estable de LilyPond, por lo que cualquier
1097 fragmento de código que muestre posibilidades nuevas de una versión de
1098 desarrollo se tiene que añadir por separado.  Éstas se almacenan en
1099 @file{input/new/} dentro del árbol del código fuente de LilyPond.
1100
1101 La lista de fragmentos de código para cada una de las subsecciones del
1102 Manual de Referencia de la Notación también se encuentran
1103 enlazados desde la parte @strong{Véase también}.
1104
1105
1106 @node About the Internals Reference
1107 @unnumberedsubsec About the Internals Reference
1108
1109 @cindex Referencia de funcionamiento interno
1110
1111 @rinternalsnamed{Top,Referencia de funcionamiento interno}:
1112 es un conjunto de páginas HTML con una tupida red de enlaces cruzados,
1113 que documentan al detalle el meollo de todas y cada una de las clases,
1114 objetos y funciones de LilyPond.  Se produce directamente a partir de
1115 las definiciones de formateo que se utilizan.
1116
1117 Casi toda la funcionalidad de formateo que se emplea internamente, se
1118 encuentra disponible para el usuario de forma directa.  Por ejemplo,
1119 todas las variables que controlan los valores de grosor, distancias,
1120 etc., se pueden cambiar dentro de los archivos de entrada.  Hay un
1121 enorme número de opciones de formateo, y todas ellas se describen en
1122 este documento.  Cada sección del manual de notación tiene una
1123 subsección @b{Véase también}, que hace referencia a la documentación
1124 generada.  En el documento HTML, estas subsecciones llevan enlaces que
1125 se pueden seguir, pulsando sobre ellos.
1126
1127
1128 @node Other documentation
1129 @unnumberedsubsec Other documentation
1130
1131 Existen algunos otros lugares que pueden resultar muy valiosos como
1132 fuente de información.
1133
1134 @itemize
1135
1136 @item
1137 @ifhtml
1138 @ifset bigpage
1139 @uref{../topdocs/NEWS.html,News}:
1140 @end ifset
1141 @ifclear bigpage
1142 @uref{../../topdocs/NEWS.html,News}:
1143 @end ifclear
1144 @end ifhtml
1145 @ifnothtml
1146 Noticias:
1147 @end ifnothtml
1148 es un resumen de los cambios importantes y las posibilidades nuevas de
1149 LilyPond desde la versión anterior.
1150
1151 @item @uref{http://lists.gnu.org/archive/html/lilypond-user/, Los archivos de la
1152 lista de correo de usuarios lilypond-user}: es una recopilación de
1153 todos los mensajes de correo que se han enviado a la lista de
1154 usuarios.  Hay muchas preguntas que se han formulado varias veces; muy
1155 probablemente, si tiene alguna pregunta, la respuesta puede
1156 encontrarse en estos archivos.
1157
1158 @item @uref{http://lists.gnu.org/archive/html/lilypond-devel/, Los
1159 archivos de la lista de correo de desarrollo lilypond-devel}: es una
1160 recopilación de todos los mensajes de correo que se han enviado a la
1161 lista de los desarrolladores.  Aquí la discusión tiene un carácter más
1162 técnico; si tiene una pregunta avanzada relacionada con el
1163 funcionamiento interno de lilypond, la respuesta puede estar en estos
1164 archivos.
1165
1166 @item Fragmentos de música incrustados: en todos los documentos en HTML que
1167 tienen fragmentos de música incluidos, el código de entrada exacto de
1168 LilyPond que se utilizó para producir dicha imagen se puede ver
1169 pulsando sobre ella.
1170
1171 @item Archivos de inicio: La localización exacta de los archivos de
1172 documentación que hemos mencionado puede variar de un sistema a otro.
1173 En ocasiones este manual hace referencia a archivos de inicialización
1174 y de ejemplo.  A lo largo del manual, nos referimos a archivos de
1175 entrada por su ruta relativa respecto de directorio de nivel más alto
1176 de los archivos de código fuente.  Por ejemplo,
1177 @file{input/@/lsr/@/carpeta/@/bla@/.ly} puede referirse al archivo
1178 @file{lilypond@/2.x.y/@/input/@/lsr/@/carpeta/@/bla@/.ly}.  En los
1179 paquetes binarios para la plataforma UNIX, normalmente la
1180 documentación y los ejemplos se encuentran en algún lugar dentro de
1181 @file{/usr/@/share/@/doc/@/lilypond/}. Los archivos de inicialización,
1182 como por ejemplo @file{scm/@/lily@/.scm}, o
1183 @file{ly/@/engraver@/-init@/.ly}, se encuentran normalmente en el
1184 directorio @file{/usr/@/share/@/lilypond/}. Para ver más detalles,
1185 consulte @ref{Other sources of information}.
1186
1187 @end itemize