1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
2 @c This file is part of lilypond.tely
4 Translation of GIT committish: 9bf6dcaf6ca27f7141ec825bb3569de8a5090dbb
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
17 En este capítulo se presentan al lector LilyPond y su documentación.
21 * About the documentation::
27 Esta sección se ocupa de las metas principales y la arquitectura de
33 * Automated engraving::
34 * What symbols to engrave?::
35 * Music representation::
36 * Example applications::
41 @unnumberedsubsec Engraving
44 @cindex tipografía musical
45 @cindex musical, tipografía
46 @cindex plancha, grabado en
47 @cindex musical, grabado
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.
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.
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ä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
90 @multitable @columnfractions .125 .25 .25 .25 .125
94 @image{henle-flat-gray,,4cm}
97 @image{henle-flat-gray,,,png}
102 @image{baer-flat-gray,,4cm}
105 @image{baer-flat-gray,,,png}
110 @image{lily-flat-bw,,4cm}
113 @image{lily-flat-bw,,,png}
117 @image{lilypond/henle-flat-bw,,,,png} @image{lilypond/baer-flat-bw,,,,png}
118 @image{lilypond/lily-flat-bw,,,,png}
126 Tipografía Feta de LilyPond (2003)
131 @cindex símbolos musicales
136 @c introduce illustrating aspects of engraving, spacing...
137 Tratándose del espaciado, la distribución del espacio debe reflejar
138 las duraciones que hay entre las notas. Sin embargo muchas partituras
139 modernas se atañen a las duraciones con precisión matemática, lo que
140 lleva a unos resultados bastante pobres. En el siguiente ejemplo se
141 muestra un ejemplo dos veces: una utilizando espaciado matemáticamente
142 exacto, y otra con ciertas correcciones. ¿Puede adivinar cuál es
145 @cindex espaciado óptico
146 @c file spacing-optical.
147 @c need to include it here, because we want two images.
168 \override NoteSpacing #'stem-spacing-correction = #0.6
193 \override NoteSpacing #'stem-spacing-correction = #0.0
194 \override NoteSpacing #'same-direction-correction = #0.0
195 \override StaffSpacing #'stem-spacing-correction = #0.0
201 @cindex ritmos regulares
202 @cindex espaciado regular
203 @cindex regular, espaciado
205 Cada uno de los dos compases de este fragmento tiene solamente notas
206 de duración constante. El espaciado debería reflejarlo.
207 Desgraciadamente el ojo nos engaña un poco; no solamente percibe la
208 distancia entre las cabezas de las notas, sino que tiene también en
209 cuenta la distancia entre las plicas. Como resultado, las notas de
210 una combinación plica arriba/@/plica abajo se tendrían que separar
211 más, y las notas de una combinación plica abajo/@/plica arriba
212 deberían juntarse, todo ello dependiendo de las posiciones combinadas
213 de las notas. Los dos compases de arriba están impresos con esta
214 corrección y los de abajo sin ella, formando grupos de notas pegadas
215 con plica abajo/@/plica arriba.
217 Los músicos están normalmente más concentrados en tocar que en
218 estudiar el aspecto de una partitura, y por ello las pequeñeces sobre
219 los detalles tipográficos pueden parecer académicas. Pero no lo son.
220 En las partituras más largas con ritmos monótonos, las correcciones de
221 espaciado llevan a sutiles variaciones en la disposición de cada una
222 de las líneas dándoles una especie de firma visual distintiva. Sin
223 esta firma, todas las líneas parecerían iguales, y se convertirían en
224 un laberinto. Si un músico aparta la mirada o tiene un lapsus de
225 concentración, las líneas podrían perder su lugar sobre el papel.
227 De forma similar, la fuerza visual de unos símbolos pesados sobre
228 gruesas líneas de pentagrama se sostiene mejor cuando el lector se
229 aleja del papel, por ejemplo cuando está sobre un atril. Una
230 distribución cuidadosa del espacio blanco permite disponer la música
231 muy apretada sin que los símbolos se toquen unos a otros. El
232 resultado reduce a un mínimo las vueltas de página, lo que es una gran
235 Ésta es una característica normal del arte tipográfico. La
236 disposición de la página tiene que ser bonita, no sólo por sí misma,
237 sino sobre todo porque así ayuda al lector en su tarea. Para los
238 materiales destinados a la interpretación, como las partituras, esto
239 es de una importancia doble: los músicos tienen una capacidad de
240 concentración limitada. Cuanta menos atención necesiten para el acto
241 de leer, más se pueden dedicar al acto de tocar la música. Dicho de
242 otra forma: una mejor tipografía se traduce en una mejor
245 Estos ejemplos demuestran que la tipografía musical es un arte sutil y
246 complejo, y que su elaboración requiere una experiencia considerable,
247 que los músicos no suelen tener. LilyPond representa nuestro esfuerzo
248 para llevar la excelencia visual de la música grabada a mano a la era
249 de la informática, y ponerla a disposición de los músicos normales.
250 Hemos ido afinando nuestros algoritmos, diseños de tipografía y
251 preferencias del programa para producir una impresión cuya calidad se
252 equipara con la de las viejas ediciones que tanto nos gusta contemplar
253 y de las que tanto nos gusta tocar.
256 @node Automated engraving
257 @unnumberedsubsec Automated engraving
259 @cindex grabado automatizado
260 @cindex automático, grabado
262 ¿Cómo nos las arreglamos para implementar la tipografía? Si un
263 artesano necesita más de diez años para convertirse en un auténtico
264 maestro ¿cómo vamos a poder nosotros, simples «hackers», escribir un
265 programa que les quite el trabajo?
267 La respuesta es: no podemos. Puesto que la tipografía se fundamenta
268 en el juicio humano sobre la apariencia, nunca se puede sustituir
269 completamente a las personas. Sin embargo, se puede automatizar gran
270 parte del trabajo más duro y repetitivo. Si LilyPond resuelve la
271 mayoría de las situaciones comunes de forma correcta, esto ya será una
272 tremenda mejoría sobre los programas existentes. El resto de los
273 casos se podrán afinar a mano. Con el transcurso de los años, el
274 software se puede refinar para que haga un mayor número de cosas de
275 forma automática, de tal forma que los ajustes manuales tienden a ser
276 cada vez menos necesarios.
278 Cuando empezamos, escribimos el programa LilyPond completamente en el
279 lenguaje C++; la funcionalidad del programa quedaba como esculpida en
280 piedra por los desarrolladores. Este esquema resultó no ser muy
281 satisfactorio por una serie de motivos:
284 @item Cuando LilyPond comete fallos,
285 los usuarios tienen la necesidad de superar las decisiones de
286 formateo. Por ello el usuario debe tener acceso al motor de formateo.
287 De aquí que no podamos dejar establecidas las reglas y valores durante
288 la compilación, sino que los usuarios deben poder acceder a ellos
289 durante la ejecución del programa.
291 @item El grabado de música es cosa de juicio visual y por ello es cuestión de gustos.
292 A pesar de saber tanto como creemos saber, los usuarios pueden no
293 estar de acuerdo con nuestras decisiones personales. Por tanto la
294 definición del estilo tipográfico también debe estar al alcance del
297 @item Por último, estamos continuamente refinando los algoritmos de formateo y por
298 tanto necesitamos un enfoque flexible para las reglas. El lenguaje
299 C++ fuerza un cierto método para agrupar las reglas que no encaja bien
300 con la manera de funcionar de la notación musical.
304 @cindex Scheme, lenguaje de programación
306 Estos problemas se han solucionado integrando un intérprete del
307 lenguaje Scheme y reescribiendo parte del código de LilyPond en
308 Scheme. La actual arquitectura de formateo se construye alrededor del
309 concepto de objetos gráficos, descrita por variables y funciones de
310 Scheme. Esta arquitectura puede tratar al mismo tiempo con las reglas
311 de formateo, el estilo tipográfico y las decisiones de formateo
312 individuales. El usuario tiene acceso directo a la mayor parte de
315 Las variables de Scheme controlan las decisiones de formateo. Por
316 ejemplo, muchos objetos gráficos tienen una variable de dirección que
317 codifica la elección entre arriba y abajo (o izquierda y
318 derecha). Aquí puede ver dos acordes con acentos y signos de arpegio.
319 En el primer acorde los objetos gráficos tienen todas sus direcciones
320 hacia abajo (o hacia la izquierda). El segundo acorde tiene todas las
321 direcciones hacia arriba (o hacia la derecha).
323 @lilypond[quote,ragged-right]
325 \override SpacingSpanner #'spacing-increment = #3
326 \override TimeSignature #'transparent = ##t
328 \stemDown <e g b>4_>-\arpeggio
329 \override Arpeggio #'direction = #RIGHT
330 \stemUp <e g b>4^>-\arpeggio
334 @cindex partitura, dar formato a
335 @cindex formato, dar a una partitura
336 @cindex formateado, reglas de
339 El proceso de formatear una partitura consiste en leer y escribir las
340 variables de los objetos gráficos. Ciertas variables tienen un valor
341 predefinido. Por ejemplo, el grosor de muchas líneas (una
342 característica del estilo tipográfico) son variables con un valor
343 preestablecido. Podemos alterar este valor libremente dando así a
344 nuestra partitura una impresión tipográfica distinta.
346 @lilypond[quote,ragged-right]
349 c'4-~ c'16 as g f e16 g bes c' des'4
354 \override Beam #'thickness = #0.3
355 \override Stem #'thickness = #0.5
356 \override Bar #'thickness = #3.6
357 \override Tie #'thickness = #2.2
358 \override StaffSymbol #'thickness = #3.0
359 \override Tie #'extra-offset = #'(0 . 0.3)
365 Las reglas de formateo también son variables que están predefinidas:
366 cada objeto tiene unas variables que contienen procedimientos. Estos
367 procedimientos realizan el trabajo real de formateo y sustituyéndolos
368 por otros podemos alterar el aspecto de los objetos. En el siguiente
369 ejemplo, la regla que define cómo se dibuja la cabeza de una nota se
370 altera durante el transcurso del fragmento musical.
372 @lilypond[quote,ragged-right]
373 #(set-global-staff-size 30)
375 #(define (mc-squared grob orig current)
376 (let* ((interfaces (ly:grob-interfaces grob))
377 (pos (ly:grob-property grob 'staff-position)))
378 (if (memq 'note-head-interface interfaces)
380 (ly:grob-set-property! grob 'stencil
381 (grob-interpret-markup grob
382 (make-lower-markup 0.5
386 ((-2) (make-smaller-markup (make-bold-markup "2")))
389 \new Voice \relative c' {
391 \set autoBeaming = ##f
394 \once \override NoteHead #'stencil = #ly:note-head::brew-ez-stencil
395 \once \override NoteHead #'font-size = #-7
396 \once \override NoteHead #'font-family = #'sans
397 \once \override NoteHead #'font-series = #'bold
399 \once \override NoteHead #'style = #'cross
401 \applyOutput #'Voice #mc-squared
404 { d8[ es-( fis^^ g] fis2-) }
405 \repeat unfold 5 { \applyOutput #'Voice #mc-squared s8 }
412 @node What symbols to engrave?
413 @unnumberedsubsec What symbols to engrave?
419 @cindex complemento (plugin)
421 El proceso de formateo toma las decisiones sobre dónde colocar los
422 símbolos. Sin embargo esto sólo se puede hacer una vez que se ha
423 decidido @emph{qué} símbolos han de imprimirse, o dicho de otro modo:
424 qué notación utilizar.
426 La notación musical común es un sistema de registro de música que ha
427 venido evolucionando desde hace mil años. La forma que se usa en
428 nuestros días data de los primeros tiempos del Renacimiento. Aunque
429 la forma básica (es decir: puntos sobre una pauta de cinco líneas) no
430 ha cambiado, los detalles continúan evolucionando para expresar todas
431 las innovaciones de la notación contemporánea. Por tanto abarca unos
432 quinientos años de música. Sus aplicaciones se extienden sobre un
433 amplio rango que abarca desde melodías monofónicas hasta monstruosos
434 contrapuntos para gran orquesta.
436 ¿Cómo podemos tratar con una bestia de tantas cabezas, y obligarla a
437 que se encierre dentro de los límites de un programa de ordenador?
438 Nuestra solución es trocear el problema de la notación (por oposición
439 al grabado, esto es, a la tipografía) en fragmentos digeribles y más
440 fáciles de programar: cada tipo de símbolo se maneja por un módulo
441 separado que recibe el nombre de «plug-in». Cada «plug-in» es
442 completamente modular e independiente, de forma que puede
443 desarrollarse y mejorarse por separado. Estos «plug-ins» se llaman
444 @code{engraver}s (grabadores), por analogía con los artesanos que
445 traducen las ideas musicales a símbolos gráficos.
447 En el siguiente ejemplo vemos cómo comenzamos con un plug-in para las
448 cabezas de las notas, el @code{Note_heads_engraver}.
450 @lilypond[quote,ragged-right]
451 \include "engraver-example.ily"
458 \remove "Stem_engraver"
459 \remove "Phrasing_slur_engraver"
460 \remove "Slur_engraver"
461 \remove "Script_engraver"
462 \remove "Beam_engraver"
463 \remove "Auto_beam_engraver"
467 \remove "Accidental_engraver"
468 \remove "Key_engraver"
469 \remove "Clef_engraver"
470 \remove "Bar_engraver"
471 \remove "Time_signature_engraver"
472 \remove "Staff_symbol_engraver"
473 \consists "Pitch_squash_engraver"
480 A continuación un @code{Staff_symbol_engraver} (grabador del
481 pentagrama) añade la pauta.
483 @lilypond[quote,ragged-right]
484 \include "engraver-example.ily"
491 \remove "Stem_engraver"
492 \remove "Phrasing_slur_engraver"
493 \remove "Slur_engraver"
494 \remove "Script_engraver"
495 \remove "Beam_engraver"
496 \remove "Auto_beam_engraver"
500 \remove "Accidental_engraver"
501 \remove "Key_engraver"
502 \remove "Clef_engraver"
503 \remove "Bar_engraver"
504 \consists "Pitch_squash_engraver"
505 \remove "Time_signature_engraver"
512 El @code{Clef_engraver} (grabador de la clave) define un punto de
513 referencia para el pentagrama.
515 @lilypond[quote,ragged-right]
516 \include "engraver-example.ily"
523 \remove "Stem_engraver"
524 \remove "Phrasing_slur_engraver"
525 \remove "Slur_engraver"
526 \remove "Script_engraver"
527 \remove "Beam_engraver"
528 \remove "Auto_beam_engraver"
532 \remove "Accidental_engraver"
533 \remove "Key_engraver"
534 \remove "Bar_engraver"
535 \remove "Time_signature_engraver"
542 y el @code{Stem_engraver} (grabador de las plicas) añade las plicas.
544 @lilypond[quote,ragged-right]
545 \include "engraver-example.ily"
552 \remove "Phrasing_slur_engraver"
553 \remove "Slur_engraver"
554 \remove "Script_engraver"
555 \remove "Beam_engraver"
556 \remove "Auto_beam_engraver"
560 \remove "Accidental_engraver"
561 \remove "Key_engraver"
562 \remove "Bar_engraver"
563 \remove "Time_signature_engraver"
570 El @code{Stem_engraver} (grabador de plicas) recibe una notificación
571 cuando llega una cabeza. Cada vez que se ve una cabeza (o más, si es
572 un acorde), se crea un objeto plica y se conecta a la cabeza.
573 Añadiendo grabadores para las barras, ligaduras, acentos,
574 alteraciones, líneas divisorias, indicación de compás y armadura
575 conseguimos una notación completa.
577 @lilypond[quote,ragged-right]
578 \include "engraver-example.ily"
583 @cindex grabar varias voces
586 Este sistema funciona bien para la música monofónica, pero ¿y con la
587 polifonía? En notación polifónica muchas voces pueden compartir el
590 @lilypond[quote,ragged-right]
591 \include "engraver-example.ily"
592 \new Staff << \topVoice \\ \botVoice >>
595 En esta situación, las alteraciones y la pauta se comparten, pero las
596 plicas, ligaduras, barras, etc. son propias de cada voz. Por tanto
597 los grabadores han de agruparse. Los grabadores de cabezas, plicas,
598 ligaduras, etc. se unen en un grupo llamado @q{Contexto de voz},
599 mientras que los grabadores de la armadura, alteraciones, compás, etc.
600 van a un grupo que se llama @q{Contexto de la pauta}. En el caso de
601 la polifonía, un único Contexto de pauta contiene más de un Contexto
602 de voz. De forma semejante, varios Contextos de pauta pueden
603 agruparse en un único Contexto de partitura. El Contexto de partitura
604 es el contexto de notación de más alto nivel.
608 Referencia de funcionamiento interno:
609 @rinternals{Contexts}.
612 @lilypond[quote,ragged-right]
613 \include "engraver-example.ily"
616 \new Staff << \topVoice \\ \botVoice >>
617 \new Staff << \pah \\ \hoom >>
622 @node Music representation
623 @unnumberedsubsec Music representation
626 @cindex recursivas, estructuras
628 Idealmente el formato de entrada para cualquier sistema de formateo de
629 alto nivel es una descripción abstracta del contenido. En este caso,
630 eso constituiría la propia música, lo que plantea un tremendo
631 problema: ¿cómo podemos definir qué es realmente la música? En lugar
632 de intentar hallar una respuesta, le hemos dado la vuelta a la
633 pregunta. Escribimos un programa capaz de producir partituras y
634 ajustamos el formato para que sea tan escueto como sea posible.
635 Cuando el formato ya no puede reducirse más, por definición nos
636 habremos quedado con el contenido musical propiamente dicho. Nuestro
637 programa sirve como definición formal de un documento musical.
640 La sintaxis también es el interfaz de usuario de LilyPond, así que es
650 un Do4 (Do central) negra, y un Re4 (el Re por encima del Do central)
659 A una escala microscópica, dicha sintaxis es fácil de utilizar. A una
660 escala mayor, la sintaxis también requiere una estructura. ¿De qué
661 otra forma podríamos introducir piezas complejas como sinfonías u
662 óperas? La estructura se forma mediante el concepto de expresiones
663 musicales: al combinar pequeños fragmentos de música dentro de otros
664 mayores, se pueden expresar ideas musicales más complejas. Por
667 @lilypond[quote,verbatim,fragment,relative=1]
672 Los acordes se pueden construir encerrando las notas entre @code{<<} y
675 @c < > is not a music expression,
676 @c so we use <<>> iso. <> to drive home the point of
677 @c expressions. Don't change this back --hwn.
679 @c FIXME: change this. I can explain it better. -gp
684 @lilypond[quote,fragment,relative=1]
685 \new Voice { <<c4 d4 e>> }
689 Esta expresión se coloca en secuencia encerrándola dentro de llaves
690 @code{@{@tie{}@dots{}@tie{}@}}
693 @{ f4 <<c4 d4 e4>> @}
696 @lilypond[quote,relative=1,fragment]
701 Lo anterior, a su vez también es una expresión, y por ello se puede combinar
702 de nuevo con otra expresión simultánea (una blanca) usando <<,
706 << g2 \\ @{ f4 <<c4 d4 e4>> @} >>
709 @lilypond[quote,fragment,relative=2]
710 \new Voice { << g2 \\ { f4 <<c d e>> } >> }
713 Las mencionadas estructuras recursivas se pueden especificar de forma
714 nítida y formal dentro de una gramática independiente del contexto.
715 El código de análisis también se genera a partir de esta gramática.
716 En otras palabras, la sintaxis de LilyPond está definida de una forma
717 clara y sin ambigüedades.
719 Los interfaces de usuario y la sintaxis son lo que la persona ve y con
720 lo que trata principalmente. En parte, son fruto de preferencias
721 personales y como tales están sujetas a mucha discusión. Aunque las
722 discusiones sobre el gusto tienen su mérito, no son demasiado
723 productivas. Dentro de la escena global de LilyPond, la sintaxis de
724 la entrada tiene una importancia relativamente pequeña: inventarse una
725 sintaxis elegante es fácil, pero escribir un código de formateo
726 decente es mucho más difícil. Esto también queda ilustrado por la
727 cantidad de líneas de código de los componentes respectivos: el
728 análisis y la representación se llevan menos del 10% del código
732 @node Example applications
733 @unnumberedsubsec Example applications
735 @cindex sencillos, ejemplos
736 @cindex ejemplos sencillos
738 Escribimos LilyPond como un experimento de cómo condensar el arte del
739 grabado de música dentro de un programa de ordenador. Gracias a todo
740 este duro trabajo, el programa ahora se puede usar para hacer trabajos
741 útiles. La aplicación más sencilla es imprimir notas.
743 @lilypond[quote,relative=1]
751 Añadiendo los nombres de acordes y la letra, obtenemos una hoja guía
752 de acordes (lead sheet).
755 @lilypond[quote,ragged-right]
757 \chords { c2 c f2 c }
763 \addlyrics { cam -- pa -- ni -- ta del lu -- gar }
767 También se puede imprimir notación polifónica y música para piano.
768 El ejemplo siguiente combina algunas otras construcciones exóticas.
772 title = "Screech and boink"
773 subtitle = "Random complex notation"
774 composer = "Han-Wen Nienhuys"
778 \context PianoStaff <<
783 \revert Stem #'direction
785 \set subdivideBeams = ##t
797 \set followVoice = ##t
798 c'''32([ b''16 a''16 gis''16 g''32)]
800 s4 \times 2/3 { d'16[ f' g'] } as'32[ b''32 e'' d'']
802 s4 \autoBeamOff d''8.. f''32
808 \new Staff = "down" {
811 \set subdivideBeams = ##f
812 \override Stem #'french-beaming = ##t
813 \override Beam #'thickness = #0.3
814 \override Stem #'thickness = #4.0
821 \override Staff.Arpeggio #'arpeggio-direction =#down
822 <cis, e, gis, b, cis>4\arpeggio
829 tempoWholesPerMinute = #(ly:make-moment 60 8)
835 \consists Horizontal_bracket_engraver
841 Todos los fragmentos mostrados se han escrito a mano, pero esto no es
842 necesariamente así. Puesto que el motor de formateo es casi
843 completamente automático, puede servir como medio de salida para otros
844 programas que manipulan música. Por ejemplo, se puede usar también
845 para convertir bases de datos de fragmentos musicales en imágenes con
846 destino a páginas web y presentaciones multimedia.
848 Este manual también es un ejemplo de aplicación: el formato de entrada
849 es texto sencillo, y por ello se puede empotrar fácilmente dentro de
850 otros formatos basados en texto, como @LaTeX{}, HTML, o en el caso
851 concreto de este manual, Texinfo. A través de un programa especial,
852 los fragmentos de entrada se pueden sustituir por imágenes musicales
853 dentro de los archivos de salida PDF o HTML resultantes. Esto
854 convierte la tarea de mezclar música y texto dentro de los documentos,
855 en algo muy sencillo.
859 @node About the documentation
860 @section About the documentation
862 Esta sección explica la distintas partes de la documentación.
864 @cindex Manual de aprendizaje
865 @cindex Glosario musical
866 @cindex Referencia de la notación
867 @cindex Utilización del programa
868 @cindex Fragmentos de código
869 @cindex Referencia de funcionamiento interno
871 @c leave these lines wrapping around. It's some texinfo 4.12 thing. -gp
872 @c This is actually a limitation of texi2html. -jm
874 * About the Learning Manual:: Este manual es una introducción a LilyPond que proporciona explicaciones en profundidad sobre cómo crear notación.
875 * About the Music Glossary:: Este manual explica términos musicales y aporta traducciones de términos a otros idiomas.
876 * 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.
877 * About the Application Usage:: Trata sobre los programas concretos y los asuntos específicos de distintos sistemas operativos.
878 * About the Snippet List:: Es una colección de ejemplos breves de LilyPond.
879 * About the Internals Reference:: Este documento proporciona información sobre la programación interna de LilyPond, que es necesaria para construir los trucos.
880 * Other documentation:: Existen algunas otras porciones de la documentación, como las Noticias y los archivos históricos de las listas de correo.
884 @node About the Learning Manual
885 @unnumberedsubsec About the Learning Manual
887 @cindex Manual de aprendizaje
889 Este libro explica cómo empezar a aprender LilyPond, así como algunos
890 conceptos clave en términos sencillos. Se recomienda leer estos
891 capítulos de forma secuencial.
897 explica los antecedentes y las metas generales de LilyPond.
901 da una amable introducción a la tipografía musical. Los usuarios que
902 se acercan por primera vez deben comenzar por aquí.
905 @ref{Fundamental concepts}:
906 explica algunos conceptos generales sobre el formato de los archivos
907 de entrada de LilyPond. Si no está seguro de dónde colocar una
908 instrucción ¡lea este capítulo!
911 @ref{Tweaking output}:
912 muestra la manera de cambiar el grabado predeterminado que produce
916 @ref{Working on LilyPond projects}:
917 trata los usos prácticos de LilyPond y cómo evitar ciertos problemas
918 bastante comunes. ¡Léalo antes de emprender proyectos grandes!
923 El Manual de aprendizaje contiene también apéndices que no forman
924 parte de la lectura lineal recomendada. Pueden ser útiles para una
930 @ref{Templates}: muestra plantillas de piezas de LilyPond, listas para
931 usar. Tan sólo tiene que cortar y pegar una plantilla en un archivo,
932 escribir las notas, y ¡habrá terminado!
935 @ref{Scheme tutorial}: presenta una breve introducción a Scheme, el
936 lenguaje de programación que usan las funciones musicales. Se trata
937 de material para trucos avanzados; muchos usuarios jamás llegan
938 siquiera a tocar el Scheme.
943 @node About the Music Glossary
944 @unnumberedsubsec About the Music Glossary
946 @cindex Glosario musical
947 @cindex frase idiomática
950 @cindex idiomas extranjeros
953 @rglosnamed{Top,Glosario musical}: explica términos musicales e incluye
954 traducciones a varios idiomas. Si no está familiarizado con la
955 notación o la terminología musicales (especialmente si no es un
956 anglófono nativo), es muy recomendable que consulte el glosario.
959 @node About the Notation Reference
960 @unnumberedsubsec About the Notation Reference
962 @cindex Referencia de la notación
964 @cindex referencia, cuadros de
965 @cindex cuadros de referencia
967 Este libro explica todas las instrucciones de LilyPond que producen
968 notación impresa. Da por supuesto que el lector está familiarizado
969 con los conceptos del manual de aprendizaje.
974 @ruser{Musical notation}:
975 trata ciertos temas agrupados según las construcciones de notación.
976 Esta sección proporciona detalles sobre notación básica que
977 probablemente serán de utilidad en casi cualquier proyecto de
981 @ruser{Specialist notation}:
982 también trata los temas agrupados por construcciones de notación.
983 Esta sección proporciona detalles sobre notación especial que
984 solamente será útil para ciertos grupos de instrumentos (o voces).
987 @ruser{General input and output}:
988 trata de información general sobre los archivos de LilyPond y el
989 control sobre la salida.
992 @ruser{Spacing issues}:
993 trata asuntos que afectan a la salida global, como la elección del
994 tamaño del papel o la especificación de los saltos de página.
997 @ruser{Changing defaults}:
998 explica cómo hacer los ajustes que permitan a LilyPond producir
999 exactamente la notación que desee.
1002 @ruser{Interfaces for programmers}:
1003 explica cómo crear funciones musicales con Scheme.
1007 El manual de Referencia de la notación también contiene unos apéndices con útiles tablas de
1014 @ruser{Literature list}:
1015 contiene un conjunto de libros de referencia muy útiles para aquellas
1016 personas que desean saber más sobre notación y grabado.
1019 @ruser{Notation manual tables}:
1020 son un conjunto de tablas que relacionan los nombres de los acordes,
1021 instrumentos MIDI, nombres de los colores y la tipografía Feta.
1024 @ruser{Cheat sheet}:
1025 es una manejable referencia de las instrucciones de LilyPond más
1029 @ruser{LilyPond command index}:
1030 un índice de todas las @code{\instrucciones} de LilyPond.
1033 @ruser{LilyPond index}:
1038 @node About the Application Usage
1039 @unnumberedsubsec About the Application Usage
1041 @cindex Utilización del programa
1042 @cindex integrar LilyPond con otros programas
1044 Este libro explica la manera de ejecutar el programa y cómo integrar
1045 la notación de LilyPond con otros programas.
1051 explica cómo instalar LilyPond (incluyendo la compilación, si se
1056 describe cómo debe configurar el sistema para una utilización óptima
1057 de LilyPond, como por ejemplo el uso de entornos especiales para
1058 determinados editores de texto.
1061 @rprogram{Running LilyPond}:
1062 trata sobre cómo ejecutar LilyPond y sus programas de apoyo. Además,
1063 esta sección explica cómo actualizar las partituras a partir de
1064 versiones anteriores de LilyPond.
1067 @rprogram{LilyPond-book}:
1068 da los detalles que se encuentran detrás de la creación de documentos
1069 con ejemplos de música insertados, como este mismo manual.
1072 @rprogram{Converting from other formats}:
1073 explica cómo ejecutar los programas de conversión. Estos programas
1074 vienen incluidos en el mismo paquete que el propio LilyPond, y
1075 convierten una amplia variedad de formatos de música al formato
1080 @node About the Snippet List
1081 @unnumberedsubsec About the Snippet List
1083 @cindex snippets (fragmentos de código)
1084 @cindex fragmentos de código (snippets)
1086 @cindex LilyPond Snippet Repository
1088 @rlsrnamed{Top,Lista de fragmentos de código de LilyPond}: presenta un conjunto
1089 seleccionado de fragmentos de código de LilyPond procedentes del
1090 @uref{http://lsr@/.dsi@/.unimi@/.it,Repositorio de Fragmentos de
1091 Código} (LSR). Todos los fragmentos se encuentran en el dominio
1094 Observe que este documento no es un subconjunto exacto de LSR. El LSR
1095 ejecuta una versión estable de LilyPond, por lo que cualquier
1096 fragmento de código que muestre posibilidades nuevas de una versión de
1097 desarrollo se tiene que añadir por separado. Éstas se almacenan en
1098 @file{input/new/} dentro del árbol del código fuente de LilyPond.
1100 La lista de fragmentos de código para cada una de las subsecciones del
1101 Manual de Referencia de la Notación también se encuentran
1102 enlazados desde la parte @strong{Véase también}.
1105 @node About the Internals Reference
1106 @unnumberedsubsec About the Internals Reference
1108 @cindex Referencia de funcionamiento interno
1110 @rinternalsnamed{Top,Referencia de funcionamiento interno}:
1111 es un conjunto de páginas HTML con una tupida red de enlaces cruzados,
1112 que documentan al detalle el meollo de todas y cada una de las clases,
1113 objetos y funciones de LilyPond. Se produce directamente a partir de
1114 las definiciones de formateo que se utilizan.
1116 Casi toda la funcionalidad de formateo que se emplea internamente, se
1117 encuentra disponible para el usuario de forma directa. Por ejemplo,
1118 todas las variables que controlan los valores de grosor, distancias,
1119 etc., se pueden cambiar dentro de los archivos de entrada. Hay un
1120 enorme número de opciones de formateo, y todas ellas se describen en
1121 este documento. Cada sección del manual de notación tiene una
1122 subsección @b{Véase también}, que hace referencia a la documentación
1123 generada. En el documento HTML, estas subsecciones llevan enlaces que
1124 se pueden seguir, pulsando sobre ellos.
1127 @node Other documentation
1128 @unnumberedsubsec Other documentation
1130 Existen algunos otros lugares que pueden resultar muy valiosos como
1131 fuente de información.
1138 @uref{../topdocs/NEWS.html,News}:
1141 @uref{../../topdocs/NEWS.html,News}:
1147 es un resumen de los cambios importantes y las posibilidades nuevas de
1148 LilyPond desde la versión anterior.
1150 @item @uref{http://lists.gnu.org/archive/html/lilypond-user/, Los archivos de la
1151 lista de correo de usuarios lilypond-user}: es una recopilación de
1152 todos los mensajes de correo que se han enviado a la lista de
1153 usuarios. Hay muchas preguntas que se han formulado varias veces; muy
1154 probablemente, si tiene alguna pregunta, la respuesta puede
1155 encontrarse en estos archivos.
1157 @item @uref{http://lists.gnu.org/archive/html/lilypond-devel/, Los
1158 archivos de la lista de correo de desarrollo lilypond-devel}: es una
1159 recopilación de todos los mensajes de correo que se han enviado a la
1160 lista de los desarrolladores. Aquí la discusión tiene un carácter más
1161 técnico; si tiene una pregunta avanzada relacionada con el
1162 funcionamiento interno de lilypond, la respuesta puede estar en estos
1165 @item Fragmentos de música incrustados: en todos los documentos en HTML que
1166 tienen fragmentos de música incluidos, el código de entrada exacto de
1167 LilyPond que se utilizó para producir dicha imagen se puede ver
1168 pulsando sobre ella.
1170 @item Archivos de inicio: La localización exacta de los archivos de
1171 documentación que hemos mencionado puede variar de un sistema a otro.
1172 En ocasiones este manual hace referencia a archivos de inicialización
1173 y de ejemplo. A lo largo del manual, nos referimos a archivos de
1174 entrada por su ruta relativa respecto de directorio de nivel más alto
1175 de los archivos de código fuente. Por ejemplo,
1176 @file{input/@/lsr/@/carpeta/@/bla@/.ly} puede referirse al archivo
1177 @file{lilypond@/2.x.y/@/input/@/lsr/@/carpeta/@/bla@/.ly}. En los
1178 paquetes binarios para la plataforma UNIX, normalmente la
1179 documentación y los ejemplos se encuentran en algún lugar dentro de
1180 @file{/usr/@/share/@/doc/@/lilypond/}. Los archivos de inicialización,
1181 como por ejemplo @file{scm/@/lily@/.scm}, o
1182 @file{ly/@/engraver@/-init@/.ly}, se encuentran normalmente en el
1183 directorio @file{/usr/@/share/@/lilypond/}. Para ver más detalles,
1184 consulte @ref{Other sources of information}.