1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
4 Translation of GIT committish: 45945bd973aa9161b10e3f517902afb7ef4b4a56
6 When revising a translation, copy the HEAD committish of the
7 version that you are working on. For details, see the Contributors'
8 Guide, node Updating translation committishes..
13 @c Translation status: post-GDP
17 @translationof Introduction
19 En este capítulo se presentan al lector LilyPond y su documentación.
23 * Sobre la documentación::
28 @translationof Background
30 Esta sección se ocupa de las metas principales y la arquitectura de
36 * Grabado automático::
37 * ¿Qué símbolos grabar?::
38 * Representación musical::
39 * Aplicaciones de ejemplo::
44 @unnumberedsubsec Grabado
45 @translationof Engraving
48 @cindex tipografía musical
49 @cindex musical, tipografía
50 @cindex plancha, grabado en
51 @cindex musical, grabado
53 El arte de la tipografía musical se conoce como @emph{grabado (en
54 plancha)}. El término deriva del proceso tradicional de la impresión
55 musical. Hace sólo unas décadas, la música impresa se hacía
56 estampando la música sobre planchas de zinc o estaño de forma
57 invertida como en un espejo. Después la plancha se entintaba y las
58 depresiones causadas por los cortes y estampados retenían la tinta.
59 Al presionar una hoja de papel sobre la plancha, se formaba una
60 imagen. El estampado y cortado se hacía completamente a mano.
61 Cualquier corrección era muy fastidiosa de realizar, si es que era
62 posible hacerla siquiera, así que el grabado tenía que quedar perfecto
63 a la primera. El grabado era una habilidad altamente especializada;
64 un artesano necesitaba unos cinco años de preparación antes de poder
65 ostentar el título de maestro grabador, y se necesitaban otros cinco
66 años de experiencia para ser un auténtico experto.
68 Hoy en día, toda la música impresa nueva se produce con ordenadores.
69 Esto tiene unas ventajas evidentes: las copias son más baratas de
70 producir y el trabajo editorial se puede repartir por correo
71 electrónico. Desgraciadamente la penetrante utilización de
72 ordenadores también ha hecho disminuir la calidad gráfica de las
73 partituras. Las impresiones de ordenador tienen un aspecto insulso y
74 mecánico, lo que hace que sea desagradable tocar a partir de ellas.
76 @c introduce illustrating aspects of engraving, font...
77 Las imágenes siguientes ilustran la diferencia entre el grabado
78 tradicional y la salida típica de ordenador, y la tercera imagen
79 muestra cómo LilyPond imita el aspecto tradicional. La imagen de la
80 izquierda presenta el dibujo escaneado de un símbolo de bemol sacado
81 de una edición publicada en el año 2000. La del centro es un símbolo
82 procedente de una edición de Bärenreiter grabada a mano de la
83 misma música. La de la izquierda ilustra los típicos puntos débiles
84 de la impresión por ordenador: las líneas del pentagrama son muy
85 delgadas, el peso del símbolo del bemol es también demasiado ligero
86 como las líneas del pentagrama, y tiene una apariencia rectilínea con
87 esquinas afiladas. En contraste, el bemol de Bärenreiter tiene una
88 apariencia redonda, pesada, casi voluptuosa. Nuestro símbolo del
89 bemol se diseñó según éste, entre otros. Es de forma redondeada y su
90 peso está en armonía con el grosor de nuestras líneas de pentagrama,
91 que son asimismo mucho más gruesas que las de la edición por
94 @multitable @columnfractions .125 .25 .25 .25 .125
98 @image{pictures/henle-flat-gray,,4cm}
101 @image{pictures/henle-flat-gray,,,png}
106 @image{pictures/baer-flat-gray,,4cm}
109 @image{pictures/baer-flat-gray,,,png}
114 @image{pictures/lily-flat-bw,,4cm}
117 @image{pictures/lily-flat-bw,,,png}
121 @image{lilypond/pictures/henle-flat-bw,,,,png} @image{lilypond/pictures/baer-flat-bw,,,,png}
122 @image{lilypond/pictures/lily-flat-bw,,,,png}
130 Tipografía Feta de LilyPond (2003)
135 @cindex símbolos musicales
140 @c introduce illustrating aspects of engraving, spacing...
141 Tratándose del espaciado, la distribución del espacio debe reflejar
142 las duraciones que hay entre las notas. Sin embargo muchas partituras
143 modernas se atañen a las duraciones con precisión matemática, lo que
144 lleva a unos resultados bastante pobres. En el siguiente ejemplo se
145 muestra un ejemplo dos veces: una utilizando espaciado matemáticamente
146 exacto, y otra con ciertas correcciones. ¿Puede adivinar cuál es
149 @cindex espaciado óptico
150 @c file spacing-optical.
151 @c need to include it here, because we want two images.
172 \override NoteSpacing #'stem-spacing-correction = #0.6
197 \override NoteSpacing #'stem-spacing-correction = #0.0
198 \override NoteSpacing #'same-direction-correction = #0.0
199 \override StaffSpacing #'stem-spacing-correction = #0.0
205 @cindex ritmos regulares
206 @cindex espaciado regular
207 @cindex regular, espaciado
209 Cada uno de los dos compases de este fragmento tiene solamente notas
210 de duración constante. El espaciado debería reflejarlo.
211 Desgraciadamente el ojo nos engaña un poco; no solamente percibe la
212 distancia entre las cabezas de las notas, sino que tiene también en
213 cuenta la distancia entre las plicas. Como resultado, las notas de
214 una combinación plica arriba/@/plica abajo se tendrían que separar
215 más, y las notas de una combinación plica abajo/@/plica arriba
216 deberían juntarse, todo ello dependiendo de las posiciones combinadas
217 de las notas. Los dos compases de arriba están impresos con esta
218 corrección, sin embargo los de abajo forman grupos de notas pegadas
219 con plica abajo/@/plica arriba.
221 Los músicos están normalmente más concentrados en tocar que en
222 estudiar el aspecto de una partitura, y por ello las pequeñeces de los
223 detalles tipográficos pueden parecer académicas. Pero no lo son. En
224 las partituras más largas con ritmos monótonos, las correcciones de
225 espaciado llevan a sutiles variaciones en la disposición de cada una
226 de las líneas dándoles una especie de firma visual distintiva. Sin
227 esta firma, todas las líneas parecerían iguales, y se convertirían en
228 un laberinto. Una impronta visual algo distinta ayuda a evitar que
229 los músicos puedan perder el hilo al apartar la mirada o tener un
230 lapsus de concentración.
232 De forma similar, la fuerza visual de unos símbolos pesados sobre
233 gruesas líneas de pentagrama se sostiene mejor cuando el lector se
234 aleja del papel: por ejemplo, cuando está sobre un atril. Una
235 distribución cuidadosa del espacio blanco permite disponer la música
236 muy apretada sin que los símbolos se atosiguen unos a otros. El
237 resultado reduce a un mínimo las vueltas de página, lo que es una gran
240 Ésta es una característica normal del arte tipográfico. La
241 disposición de la página tiene que ser bonita, no sólo por sí misma,
242 sino sobre todo porque así ayuda al lector en su tarea. Para los
243 materiales destinados a la interpretación, como las partituras, esto
244 es de una importancia doble: los músicos tienen una capacidad de
245 concentración limitada. Cuanta menos atención necesiten para el acto
246 de leer, más se pueden dedicar al acto de tocar la música. Dicho de
247 otra forma: una mejor tipografía se traduce en una mejor
250 Estos ejemplos demuestran que la tipografía musical es un arte sutil y
251 complejo, y que su elaboración requiere una experiencia considerable,
252 que los músicos no suelen tener. LilyPond representa nuestro esfuerzo
253 para llevar la excelencia visual de la música grabada a mano a la era
254 de la informática, y ponerla a disposición de los músicos normales.
255 Hemos ido afinando nuestros algoritmos, diseños de tipografía y
256 preferencias del programa para producir una impresión cuya calidad se
257 equipara con la de las viejas ediciones que tanto nos gusta contemplar
258 y de las que tanto nos gusta tocar.
261 @node Grabado automático
262 @unnumberedsubsec Grabado automático
263 @translationof Automated engraving
265 @cindex grabado automatizado
266 @cindex automático, grabado
268 ¿Cómo nos las arreglamos para implementar la tipografía? Si un
269 artesano necesita más de diez años para convertirse en un auténtico
270 maestro ¿cómo vamos a poder nosotros, simples «hackers», escribir un
271 programa que les quite el trabajo?
273 La respuesta es: no podemos. Puesto que la tipografía se fundamenta
274 en el juicio humano sobre la apariencia, nunca se puede sustituir
275 completamente a las personas. Sin embargo, se puede automatizar gran
276 parte del trabajo más duro y repetitivo. Si LilyPond resuelve la
277 mayoría de las situaciones comunes de forma correcta, esto ya será una
278 tremenda mejoría sobre los programas existentes. El resto de los
279 casos se podrán afinar a mano. Con el transcurso de los años, el
280 software se puede refinar para que haga un mayor número de cosas de
281 forma automática, de tal forma que los ajustes manuales tienden a ser
282 cada vez menos necesarios.
284 Cuando empezamos, escribimos el programa LilyPond completamente en el
285 lenguaje C++; la funcionalidad del programa quedaba como esculpida en
286 piedra por los desarrolladores. Este esquema resultó no ser muy
287 satisfactorio por una serie de motivos:
290 @item Cuando LilyPond comete fallos,
291 los usuarios tienen la necesidad de superar las decisiones de
292 formateo. Por ello el usuario debe tener acceso al motor de formateo.
293 De aquí que no podamos dejar establecidas las reglas y valores durante
294 la compilación, sino que los usuarios deben poder acceder a ellos
295 durante la ejecución del programa.
297 @item El grabado de música es cosa de juicio visual y por ello es cuestión de gustos.
298 A pesar de saber tanto como creemos saber, los usuarios pueden no
299 estar de acuerdo con nuestras decisiones personales. Por tanto la
300 definición del estilo tipográfico también debe estar al alcance del
303 @item Por último, estamos continuamente refinando los algoritmos de formateo
304 y por tanto necesitamos un enfoque flexible para las reglas. El
305 lenguaje C++ fuerza un cierto método para agrupar las reglas que no se
306 puede aplicar fácilmente al formateo de la notación musical.
310 @cindex Scheme, lenguaje de programación
312 Estos problemas se han solucionado integrando un intérprete del
313 lenguaje Scheme y reescribiendo parte del código de LilyPond en
314 Scheme. La actual arquitectura de formateo se construye alrededor del
315 concepto de objetos gráficos, descrita por variables y funciones de
316 Scheme. Esta arquitectura puede tratar al mismo tiempo con las reglas
317 de formateo, el estilo tipográfico y las decisiones de formateo
318 individuales. El usuario tiene acceso directo a la mayor parte de
321 Las variables de Scheme controlan las decisiones de formateo. Por
322 ejemplo, muchos objetos gráficos tienen una variable de dirección que
323 codifica la elección entre arriba y abajo (o izquierda y
324 derecha). Aquí puede ver dos acordes con acentos y signos de arpegio.
325 En el primer acorde los objetos gráficos tienen todas sus direcciones
326 hacia abajo (o hacia la izquierda). El segundo acorde tiene todas las
327 direcciones hacia arriba (o hacia la derecha).
329 @lilypond[quote,ragged-right]
331 \override SpacingSpanner #'spacing-increment = #3
332 \override TimeSignature #'transparent = ##t
334 \stemDown <e g b>4_>-\arpeggio
335 \override Arpeggio #'direction = #RIGHT
336 \stemUp <e g b>4^>-\arpeggio
340 @cindex partitura, dar formato a
341 @cindex formato, dar a una partitura
342 @cindex formateado, reglas de
345 El proceso de formatear una partitura consiste en leer y escribir las
346 variables de los objetos gráficos. Ciertas variables tienen un valor
347 predefinido. Por ejemplo, el grosor de muchas líneas (una
348 característica del estilo tipográfico) son variables con un valor
349 preestablecido. Podemos alterar este valor libremente dando así a
350 nuestra partitura una impresión tipográfica distinta.
352 @lilypond[quote,ragged-right]
355 c'4-~ c'16 as g f e16 g bes c' des'4
360 \override Beam #'beam-thickness = #0.3
361 \override Stem #'thickness = #0.5
362 \override Bar #'thickness = #3.6
363 \override Tie #'thickness = #2.2
364 \override StaffSymbol #'thickness = #3.0
365 \override Tie #'extra-offset = #'(0 . 0.3)
371 Las reglas de formateo también son variables que están predefinidas:
372 cada objeto tiene unas variables que contienen procedimientos. Estos
373 procedimientos realizan el trabajo real de formateo y sustituyéndolos
374 por otros podemos alterar el aspecto de los objetos. En el siguiente
375 ejemplo, la regla que controla cómo se dibuja la cabeza de una nota se
376 altera durante el transcurso del fragmento musical.
378 @lilypond[quote,ragged-right]
379 #(set-global-staff-size 30)
381 #(define (mc-squared grob orig current)
382 (let* ((interfaces (ly:grob-interfaces grob))
383 (pos (ly:grob-property grob 'staff-position)))
384 (if (memq 'note-head-interface interfaces)
386 (ly:grob-set-property! grob 'stencil
387 (grob-interpret-markup grob
388 (make-lower-markup 0.5
392 ((-2) (make-smaller-markup (make-bold-markup "2")))
395 \new Voice \relative c' {
397 \set autoBeaming = ##f
400 \once \override NoteHead #'stencil = #note-head::brew-ez-stencil
401 \once \override NoteHead #'font-size = #-7
402 \once \override NoteHead #'font-family = #'sans
403 \once \override NoteHead #'font-series = #'bold
405 \once \override NoteHead #'style = #'cross
407 \applyOutput #'Voice #mc-squared
410 { d8[ es-( fis^^ g] fis2-) }
411 \repeat unfold 5 { \applyOutput #'Voice #mc-squared s8 }
418 @node ¿Qué símbolos grabar?
419 @unnumberedsubsec ¿Qué símbolos grabar?
420 @translationof What symbols to engrave?
426 @cindex complemento (plugin)
428 El proceso de formateo toma las decisiones sobre dónde colocar los
429 símbolos. Sin embargo esto sólo se puede hacer una vez que se ha
430 decidido @emph{qué} símbolos han de imprimirse, o dicho de otro modo:
431 qué notación utilizar.
433 La notación musical común es un sistema de registro de música que ha
434 venido evolucionando desde hace mil años. La forma que se usa en
435 nuestros días data de los primeros tiempos del Renacimiento. Aunque
436 la forma básica (es decir: puntos sobre una pauta de cinco líneas) no
437 ha cambiado, los detalles continúan evolucionando para expresar todas
438 las innovaciones de la notación contemporánea. Por tanto, la notación
439 musical común abarca unos quinientos años de música. Sus aplicaciones
440 se extienden sobre un amplio rango que abarca desde melodías
441 monofónicas hasta monstruosos contrapuntos para gran orquesta.
443 ¿Cómo podemos tratar con esta bestia de siete cabezas, y obligarla a
444 que se encierre dentro de los límites de un programa de ordenador?
445 Nuestra solución es trocear el problema de la notación (por oposición
446 al grabado, esto es, a la tipografía) en fragmentos digeribles y más
447 fáciles de programar: cada tipo de símbolo se maneja por un módulo
448 separado que recibe el nombre de «plug-in». Cada «plug-in» es
449 completamente modular e independiente, de forma que puede
450 desarrollarse y mejorarse por separado. Estos «plug-ins» se llaman
451 @code{engraver}s (grabadores), por analogía con los artesanos que
452 traducen las ideas musicales a símbolos gráficos.
454 En el siguiente ejemplo comenzamos con un plug-in para las cabezas de
455 las notas, el @code{Note_heads_engraver}.
457 @lilypond[quote,ragged-right]
458 \include "engraver-example.ily"
465 \remove "Stem_engraver"
466 \remove "Phrasing_slur_engraver"
467 \remove "Slur_engraver"
468 \remove "Script_engraver"
469 \remove "Beam_engraver"
470 \remove "Auto_beam_engraver"
474 \remove "Accidental_engraver"
475 \remove "Key_engraver"
476 \remove "Clef_engraver"
477 \remove "Bar_engraver"
478 \remove "Time_signature_engraver"
479 \remove "Staff_symbol_engraver"
480 \consists "Pitch_squash_engraver"
487 A continuación un @code{Staff_symbol_engraver} (grabador del
488 pentagrama) añade la pauta,
490 @lilypond[quote,ragged-right]
491 \include "engraver-example.ily"
498 \remove "Stem_engraver"
499 \remove "Phrasing_slur_engraver"
500 \remove "Slur_engraver"
501 \remove "Script_engraver"
502 \remove "Beam_engraver"
503 \remove "Auto_beam_engraver"
507 \remove "Accidental_engraver"
508 \remove "Key_engraver"
509 \remove "Clef_engraver"
510 \remove "Bar_engraver"
511 \consists "Pitch_squash_engraver"
512 \remove "Time_signature_engraver"
519 El @code{Clef_engraver} (grabador de la clave) define un punto de
520 referencia para el pentagrama,
522 @lilypond[quote,ragged-right]
523 \include "engraver-example.ily"
530 \remove "Stem_engraver"
531 \remove "Phrasing_slur_engraver"
532 \remove "Slur_engraver"
533 \remove "Script_engraver"
534 \remove "Beam_engraver"
535 \remove "Auto_beam_engraver"
539 \remove "Accidental_engraver"
540 \remove "Key_engraver"
541 \remove "Bar_engraver"
542 \remove "Time_signature_engraver"
549 y el @code{Stem_engraver} (grabador de las plicas) añade las plicas.
551 @lilypond[quote,ragged-right]
552 \include "engraver-example.ily"
559 \remove "Phrasing_slur_engraver"
560 \remove "Slur_engraver"
561 \remove "Script_engraver"
562 \remove "Beam_engraver"
563 \remove "Auto_beam_engraver"
567 \remove "Accidental_engraver"
568 \remove "Key_engraver"
569 \remove "Bar_engraver"
570 \remove "Time_signature_engraver"
577 El @code{Stem_engraver} (grabador de plicas) recibe una notificación
578 cuando llega una cabeza. Cada vez que se ve una cabeza (o más, si es
579 un acorde), se crea un objeto plica y se conecta a la cabeza.
580 Añadiendo grabadores para las barras, ligaduras, acentos,
581 alteraciones, líneas divisorias, indicación de compás y armadura
582 conseguimos una notación completa.
584 @lilypond[quote,ragged-right]
585 \include "engraver-example.ily"
590 @cindex grabar varias voces
593 Este sistema funciona bien para la música monofónica, pero ¿y con la
594 polifonía? En notación polifónica muchas voces pueden compartir el
597 @lilypond[quote,ragged-right]
598 \include "engraver-example.ily"
599 \new Staff << \topVoice \\ \botVoice >>
602 En esta situación, las alteraciones y la pauta se comparten, pero las
603 plicas, ligaduras, barras, etc. son propias de cada voz. Por tanto
604 los grabadores han de agruparse. Los grabadores de cabezas, plicas,
605 ligaduras, etc. se unen en un grupo llamado @q{Contexto de voz},
606 mientras que los grabadores de la armadura, alteraciones, compás, etc.
607 van a un grupo que se llama @q{Contexto de la pauta}. En el caso de
608 la polifonía, un único Contexto de pauta contiene más de un Contexto
609 de voz. De forma semejante, varios Contextos de pauta pueden
610 agruparse en un único Contexto de partitura. El Contexto de partitura
611 es el contexto de notación de más alto nivel.
615 Referencia de funcionamiento interno:
616 @rinternals{Contexts}.
619 @lilypond[quote,ragged-right]
620 \include "engraver-example.ily"
623 \new Staff << \topVoice \\ \botVoice >>
624 \new Staff << \pah \\ \hoom >>
629 @node Representación musical
630 @unnumberedsubsec Representación musical
631 @translationof Music representation
634 @cindex recursivas, estructuras
636 Idealmente el formato de entrada para cualquier sistema de formateo de
637 alto nivel es una descripción abstracta del contenido. En este caso,
638 eso constituiría la propia música, lo que plantea un tremendo
639 problema: ¿cómo podemos definir qué es realmente la música? En lugar
640 de intentar hallar una respuesta, le hemos dado la vuelta a la
641 pregunta. Escribimos un programa capaz de producir partituras y
642 ajustamos el formato para que sea tan escueto como sea posible.
643 Cuando el formato ya no puede reducirse más, por definición nos
644 habremos quedado con el contenido musical propiamente dicho. Nuestro
645 programa sirve como definición formal de un documento musical.
648 La sintaxis también es el interfaz de usuario de LilyPond, así que es
658 para crear un Do central (Do4) negra, y un Re por encima del Do
659 central (Re4) corchea.
667 A una escala microscópica, dicha sintaxis es fácil de utilizar. A una
668 escala mayor, la sintaxis también requiere una estructura. ¿De qué
669 otra forma podríamos introducir piezas complejas como sinfonías u
670 óperas? La estructura se forma mediante el concepto de expresiones
671 musicales: al combinar pequeños fragmentos de música dentro de otros
672 mayores, se pueden expresar ideas musicales más complejas. Por
675 @lilypond[quote,verbatim,fragment,relative=1]
680 Los acordes se pueden construir encerrando las notas entre @code{<<} y
683 @c < > is not a music expression,
684 @c so we use <<>> iso. <> to drive home the point of
685 @c expressions. Don't change this back --hwn.
687 @c FIXME: change this. I can explain it better. -gp
692 @lilypond[quote,fragment,relative=1]
693 \new Voice { <<c4 d4 e>> }
697 Esta expresión se coloca en secuencia encerrándola dentro de llaves
698 @code{@{@tie{}@dots{}@tie{}@}}
701 @{ f4 <<c4 d4 e4>> @}
704 @lilypond[quote,relative=1,fragment]
709 Lo anterior, a su vez también es una expresión, y por ello se puede combinar
710 de nuevo con otra expresión simultánea (una blanca) usando <<,
714 << g2 \\ @{ f4 <<c4 d4 e4>> @} >>
717 @lilypond[quote,fragment,relative=2]
718 \new Voice { << g2 \\ { f4 <<c d e>> } >> }
721 Las mencionadas estructuras recursivas se pueden especificar de forma
722 nítida y formal dentro de una gramática independiente del contexto.
723 El código de análisis también se genera a partir de esta gramática.
724 En otras palabras, la sintaxis de LilyPond está definida de una forma
725 clara y sin ambigüedades.
727 Los interfaces de usuario y la sintaxis son lo que la persona ve y con
728 lo que trata principalmente. En parte, son fruto de preferencias
729 personales y como tales están sujetas a mucha discusión. Aunque las
730 discusiones sobre el gusto tienen su mérito, no son demasiado
731 productivas. Dentro de la escena global de LilyPond, la sintaxis de
732 la entrada tiene una importancia relativamente pequeña: inventarse una
733 sintaxis elegante es fácil, pero escribir un código de formateo
734 decente es mucho más difícil. Esto también queda ilustrado por la
735 cantidad de líneas de código de los componentes respectivos: el
736 análisis y la representación se llevan menos del 10% del código
740 @node Aplicaciones de ejemplo
741 @unnumberedsubsec Aplicaciones de ejemplo
742 @translationof Example applications
744 @cindex sencillos, ejemplos
745 @cindex ejemplos sencillos
747 Escribimos LilyPond como un experimento de cómo condensar el arte del
748 grabado de música dentro de un programa de ordenador. Gracias a todo
749 este duro trabajo, el programa ahora se puede usar para hacer trabajos
750 útiles. La aplicación más sencilla es imprimir notas.
752 @lilypond[quote,relative=1]
760 Añadiendo los nombres de acordes y la letra, obtenemos una hoja guía
761 de acordes (lead sheet).
764 @lilypond[quote,ragged-right]
766 \chords { c2 c f2 c }
772 \addlyrics { cam -- pa -- ni -- ta del lu -- gar }
776 También se puede imprimir notación polifónica y música para piano.
777 El ejemplo siguiente combina algunas otras construcciones exóticas.
781 title = "Screech and boink"
782 subtitle = "Random complex notation"
783 composer = "Han-Wen Nienhuys"
787 \context PianoStaff <<
792 \revert Stem #'direction
794 \set subdivideBeams = ##t
806 \set followVoice = ##t
807 c'''32([ b''16 a''16 gis''16 g''32)]
809 s4 \times 2/3 { d'16[ f' g'] } as'32[ b''32 e'' d'']
811 s4 \autoBeamOff d''8.. f''32
817 \new Staff = "down" {
820 \set subdivideBeams = ##f
821 \override Stem #'french-beaming = ##t
822 \override Beam #'beam-thickness = #0.3
823 \override Stem #'thickness = #4.0
830 \override Staff.Arpeggio #'arpeggio-direction =#down
831 <cis, e, gis, b, cis>4\arpeggio
838 tempoWholesPerMinute = #(ly:make-moment 60 8)
844 \consists Horizontal_bracket_engraver
850 Todos los fragmentos mostrados se han escrito a mano, pero esto no es
851 necesariamente así. Puesto que el motor de formateo es casi
852 completamente automático, puede servir como medio de salida para otros
853 programas que manipulan música. Por ejemplo, se puede usar también
854 para convertir bases de datos de fragmentos musicales en imágenes con
855 destino a páginas web y presentaciones multimedia.
857 Este manual también es un ejemplo de aplicación: el formato de entrada
858 es texto sencillo, y por ello se puede empotrar fácilmente dentro de
859 otros formatos basados en texto, como @LaTeX{}, HTML, o en el caso
860 concreto de este manual, Texinfo. A través de un programa especial,
861 los fragmentos de entrada se pueden sustituir por imágenes musicales
862 dentro de los archivos de salida PDF o HTML resultantes. Esto
863 convierte la tarea de mezclar música y texto dentro de los documentos,
864 en algo muy sencillo.
868 @node Sobre la documentación
869 @section Sobre la documentación
870 @translationof About the documentation
872 Esta sección explica la distintas partes de la documentación.
874 @cindex Manual de aprendizaje
875 @cindex Glosario musical
876 @cindex Referencia de la notación
877 @cindex Utilización del programa
878 @cindex Fragmentos de código
879 @cindex Referencia de funcionamiento interno
881 @c leave these lines wrapping around. It's some texinfo 4.12 thing. -gp
882 @c This is actually a limitation of texi2html. -jm
884 * Sobre el Manual de aprendizaje:: Este manual es una introducción a LilyPond que proporciona explicaciones en profundidad sobre cómo crear notación.
885 * Sobre el Glosario Musical:: Este manual explica términos musicales y aporta traducciones de términos a otros idiomas.
886 * Sobre la Referencia de la notación:: 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.
887 * Sobre el manual de Utilización del programa:: Trata sobre los programas concretos y los asuntos específicos de distintos sistemas operativos.
888 * Sobre la lista de fragmentos de código:: Es una colección de ejemplos breves de LilyPond.
889 * Sobre el Manual de Referencia de Funcionamiento Interno:: Este documento proporciona información sobre la programación interna de LilyPond, que es necesaria para construir los trucos.
890 * Otros documentos:: Existen algunas otras porciones de la documentación, como las Noticias y los archivos históricos de las listas de correo.
894 @node Sobre el Manual de aprendizaje
895 @unnumberedsubsec Sobre el Manual de aprendizaje
896 @translationof About the Learning Manual
898 @cindex Manual de aprendizaje
900 Este libro explica cómo empezar a aprender LilyPond, así como algunos
901 conceptos clave en términos sencillos. Se recomienda leer estos
902 capítulos de forma secuencial.
908 explica los antecedentes y las metas generales de LilyPond.
912 da una amable introducción a la tipografía musical. Los usuarios que
913 se acercan por primera vez deben comenzar por aquí.
916 @ref{Conceptos fundamentales}:
917 explica algunos conceptos generales sobre el formato de los archivos
918 de entrada de LilyPond. Si no está seguro de dónde colocar una
919 instrucción ¡lea este capítulo!
922 @ref{Trucar la salida}:
923 muestra la manera de cambiar el grabado predeterminado que produce
927 @ref{Trabajar en proyectos de LilyPond}:
928 trata los usos prácticos de LilyPond y cómo evitar ciertos problemas
929 bastante comunes. ¡Léalo antes de emprender proyectos grandes!
934 El Manual de aprendizaje contiene también apéndices que no forman
935 parte de la lectura lineal recomendada. Pueden ser útiles para una
941 @ref{Plantillas}: muestra plantillas de piezas de LilyPond, listas para
942 usar. Tan sólo tiene que cortar y pegar una plantilla en un archivo,
943 escribir las notas, y ¡habrá terminado!
946 @ref{Tutorial de Scheme}: presenta una breve introducción a Scheme, el
947 lenguaje de programación que usan las funciones musicales. Se trata
948 de material para trucos avanzados; muchos usuarios jamás llegan
949 siquiera a tocar el Scheme.
954 @node Sobre el Glosario Musical
955 @unnumberedsubsec Sobre el Glosario Musical
956 @translationof About the Music Glossary
958 @cindex Glosario musical
959 @cindex frase idiomática
962 @cindex idiomas extranjeros
965 @rglosnamed{Top,Glosario musical}: explica términos musicales e incluye
966 traducciones a varios idiomas. Si no está familiarizado con la
967 notación o la terminología musicales (especialmente si no es un
968 anglófono nativo), es muy recomendable que consulte el glosario.
971 @node Sobre la Referencia de la notación
972 @unnumberedsubsec Sobre la Referencia de la notación
973 @translationof About the Notation Reference
975 @cindex Referencia de la notación
977 @cindex referencia, cuadros de
978 @cindex cuadros de referencia
980 Este libro explica todas las instrucciones de LilyPond que producen
981 notación impresa. Da por supuesto que el lector está familiarizado
982 con los conceptos del manual de aprendizaje.
987 @ruser{Notación musical}:
988 trata ciertos temas agrupados según las construcciones de notación.
989 Esta sección proporciona detalles sobre notación básica que
990 probablemente serán de utilidad en casi cualquier proyecto de
994 @ruser{Notación especializada}:
995 también trata los temas agrupados por construcciones de notación.
996 Esta sección proporciona detalles sobre notación especial que
997 solamente será útil para ciertos grupos de instrumentos (o voces).
1000 @ruser{Entrada y salida generales}:
1001 trata de información general sobre los archivos de LilyPond y el
1002 control sobre la salida.
1005 @ruser{Problemas de espaciado}:
1006 trata asuntos que afectan a la salida global, como la elección del
1007 tamaño del papel o la especificación de los saltos de página.
1010 @ruser{Cambiar los valores por omisión}:
1011 explica cómo hacer los ajustes que permitan a LilyPond producir
1012 exactamente la notación que desee.
1015 @ruser{Interfaces para programadores}:
1016 explica cómo crear funciones musicales con Scheme.
1020 El manual de Referencia de la notación también contiene unos apéndices con útiles tablas de
1027 @ruser{Lista bibliográfica}:
1028 contiene un conjunto de libros de referencia muy útiles para aquellas
1029 personas que desean saber más sobre notación y grabado.
1032 @ruser{Tablas del manual sobre notación}:
1033 son un conjunto de tablas que relacionan los nombres de los acordes,
1034 instrumentos MIDI, nombres de los colores y la tipografía Feta.
1037 @ruser{Hoja de referencia rápida}:
1038 es una manejable referencia de las instrucciones de LilyPond más
1042 @ruser{Índice de instrucciones de LilyPond}:
1043 un índice de todas las @code{\instrucciones} de LilyPond.
1046 @ruser{Índice de LilyPond}:
1051 @node Sobre el manual de Utilización del programa
1052 @unnumberedsubsec Sobre el manual de Utilización del programa
1053 @translationof About the Application Usage
1055 @cindex Utilización del programa
1056 @cindex integrar LilyPond con otros programas
1058 Este libro explica la manera de ejecutar el programa y cómo integrar
1059 la notación de LilyPond con otros programas.
1064 @rprogram{Instalación}:
1065 explica cómo instalar LilyPond (incluyendo la compilación, si se
1069 @rprogram{Configuración}:
1070 describe cómo debe configurar el sistema para una utilización óptima
1071 de LilyPond, como por ejemplo el uso de entornos especiales para
1072 determinados editores de texto.
1075 @rprogram{Ejecutar LilyPond}:
1076 trata sobre cómo ejecutar LilyPond y sus programas de apoyo. Además,
1077 esta sección explica cómo actualizar las partituras a partir de
1078 versiones anteriores de LilyPond.
1081 @rprogram{LilyPond-book}:
1082 da los detalles que se encuentran detrás de la creación de documentos
1083 con ejemplos de música insertados, como este mismo manual.
1086 @rprogram{Conversión desde otros formatos}:
1087 explica cómo ejecutar los programas de conversión. Estos programas
1088 vienen incluidos en el mismo paquete que el propio LilyPond, y
1089 convierten una amplia variedad de formatos de música al formato
1094 @node Sobre la lista de fragmentos de código
1095 @unnumberedsubsec Sobre la lista de fragmentos de código
1096 @translationof About the Snippet List
1098 @cindex snippets (fragmentos de código)
1099 @cindex fragmentos de código (snippets)
1101 @cindex LilyPond Snippet Repository
1103 @rlsrnamed{Top,Lista de fragmentos de código de LilyPond}: presenta un conjunto
1104 seleccionado de fragmentos de código de LilyPond procedentes del
1105 @uref{http://lsr@/.dsi@/.unimi@/.it,Repositorio de Fragmentos de
1106 Código} (LSR). Todos los fragmentos se encuentran en el dominio
1109 Observe que este documento no es un subconjunto exacto de LSR. El LSR
1110 ejecuta una versión estable de LilyPond, por lo que cualquier
1111 fragmento de código que muestre posibilidades nuevas de una versión de
1112 desarrollo se tiene que añadir por separado. Éstas se almacenan en
1113 @file{input/new/} dentro del árbol del código fuente de LilyPond.
1115 La lista de fragmentos de código para cada una de las subsecciones del
1116 Manual de Referencia de la Notación también se encuentran
1117 enlazados desde la parte @strong{Véase también}.
1120 @node Sobre el Manual de Referencia de Funcionamiento Interno
1121 @unnumberedsubsec Sobre el Manual de Referencia de Funcionamiento Interno
1122 @translationof About the Internals Reference
1124 @cindex Referencia de funcionamiento interno
1126 @rinternalsnamed{Top,Referencia de funcionamiento interno}:
1127 es un conjunto de páginas HTML con una tupida red de enlaces cruzados,
1128 que documentan al detalle el meollo de todas y cada una de las clases,
1129 objetos y funciones de LilyPond. Se produce directamente a partir de
1130 las definiciones de formateo que se utilizan.
1132 Casi toda la funcionalidad de formateo que se emplea internamente, se
1133 encuentra disponible para el usuario de forma directa. Por ejemplo,
1134 todas las variables que controlan los valores de grosor, distancias,
1135 etc., se pueden cambiar dentro de los archivos de entrada. Hay un
1136 enorme número de opciones de formateo, y todas ellas se describen en
1137 este documento. Cada sección del manual de notación tiene una
1138 subsección @b{Véase también}, que hace referencia a la documentación
1139 generada. En el documento HTML, estas subsecciones llevan enlaces que
1140 se pueden seguir, pulsando sobre ellos.
1143 @node Otros documentos
1144 @unnumberedsubsec Otros documentos
1145 @translationof Other documentation
1147 Existen algunos otros lugares que pueden resultar muy valiosos como
1148 fuente de información.
1155 @uref{../topdocs/NEWS.html,News}:
1158 @uref{../../topdocs/NEWS.html,News}:
1164 es un resumen de los cambios importantes y las posibilidades nuevas de
1165 LilyPond desde la versión anterior.
1167 @item @uref{http://lists.gnu.org/archive/html/lilypond-user/, Los archivos de la
1168 lista de correo de usuarios lilypond-user}: es una recopilación de
1169 todos los mensajes de correo que se han enviado a la lista de
1170 usuarios. Hay muchas preguntas que se han formulado varias veces; muy
1171 probablemente, si tiene alguna pregunta, la respuesta puede
1172 encontrarse en estos archivos.
1174 @item @uref{http://lists.gnu.org/archive/html/lilypond-devel/, Los
1175 archivos de la lista de correo de desarrollo lilypond-devel}: es una
1176 recopilación de todos los mensajes de correo que se han enviado a la
1177 lista de los desarrolladores. Aquí la discusión tiene un carácter más
1178 técnico; si tiene una pregunta avanzada relacionada con el
1179 funcionamiento interno de lilypond, la respuesta puede estar en estos
1182 @item Fragmentos de música incrustados: en todos los documentos en HTML que
1183 tienen fragmentos de música incluidos, el código de entrada exacto de
1184 LilyPond que se utilizó para producir dicha imagen se puede ver
1185 pulsando sobre ella.
1187 @item Archivos de inicio: La localización exacta de los archivos de
1188 documentación que hemos mencionado puede variar de un sistema a otro.
1189 En ocasiones este manual hace referencia a archivos de inicialización
1190 y de ejemplo. A lo largo del manual, nos referimos a archivos de
1191 entrada por su ruta relativa respecto de directorio de nivel más alto
1192 de los archivos de código fuente. Por ejemplo,
1193 @file{input/@/lsr/@/carpeta/@/bla@/.ly} puede referirse al archivo
1194 @file{lilypond@/2.x.y/@/input/@/lsr/@/carpeta/@/bla@/.ly}. En los
1195 paquetes binarios para la plataforma UNIX, normalmente la
1196 documentación y los ejemplos se encuentran en algún lugar dentro de
1197 @file{/usr/@/share/@/doc/@/lilypond/}. Los archivos de inicialización,
1198 como por ejemplo @file{scm/@/lily@/.scm}, o
1199 @file{ly/@/engraver@/-init@/.ly}, se encuentran normalmente en el
1200 directorio @file{/usr/@/share/@/lilypond/}. Para ver más detalles,
1201 consulte @ref{Otras fuentes de información}.