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