From 7e68c7d74ec394bc83f79168a50b884b47938dd9 Mon Sep 17 00:00:00 2001 From: Francisco Vila Date: Fri, 2 Mar 2007 11:58:53 +0100 Subject: [PATCH] spanish introduction --- Documentation/es/user/introduction.itely | 934 ++++++++++++++++++++++- 1 file changed, 908 insertions(+), 26 deletions(-) diff --git a/Documentation/es/user/introduction.itely b/Documentation/es/user/introduction.itely index 24ad6ab2b4..d4f5b87094 100644 --- a/Documentation/es/user/introduction.itely +++ b/Documentation/es/user/introduction.itely @@ -1,61 +1,943 @@ +@c -*- coding: utf-8; mode: texinfo; -*- +@c This file is part of lilypond.tely +@ignore + Translation of GIT committish: f5a2aec5313027cb9b89a917b52230b2a7f31df7 + + When revising a translation, copy the HEAD committish of the + version that you are working on. See TRANSLATION for details. +@end ignore + @node Introduction @chapter Introduction -UNTRANSLATED NODE: IGNORE ME -@menu +@menu +* Engraving:: +* Automated engraving:: +* What symbols to engrave?:: +* Music representation:: +* Example applications:: +* About this manual:: +@end menu -UNTRANSLATED NODE: IGNORE ME -* Engraving:: -* Automated engraving:: -* What symbols to engrave?:: -* Music representation:: -* Example applications:: -* About this manual:: -@end menu @node Engraving @section Engraving -UNTRANSLATED NODE: IGNORE ME +El arte de la tipografía musical se conoce como @emph{grabado (en plancha)}. El +término deriva del proceso tradicional de la impresión musical. Hace sólo unas +décadas, la música impresa se hacía estampando la música +sobre planchas de zinc o estaño de forma invertida como en un espejo. Después la plancha se +entintaba y las depresiones causadas por los cortes y estampados retenían +la tinta. Al presionra una hoja de papel sobre la plancha se formaba una imagen. El +estampado y cortado se hacía completamente a mano. Cualquier corrección era +muy fastidiosa de realizar, si es que era posible hacerla siquiera, así que el grabado tenía que quedar +perfecto a la primera. El grabado era una habilidad altamente especializada; un artesano necesitaba +unos cinco años de preparación antes de poder ostentar el título de +maestro grabador, y se necesitaban otros cinco años de experiencia para +ser un auténtico experto. -@node Automated engraving +Hoy en día, toda la música impresa nueva se produce con ordenadores. Esto +tiene unas ventajas evidentes: las copias son más baratas de producir y el trabajo editorial +se puede repartir por correo elecrónico. Desgraciadamente la penetrante utilización de +ordenadores trambién ha hecho disminuir la calidad gráfica de las partituras. +Las impresiones de ordenador tienen un aspecto insulso y mecánico, lo que hace que sea desagradable tocar a partir de ellas. + +@c introduce illustrating aspects of engraving, font... +Las imágenes siguientes ilustran la diferencia entre el grabado +tradicional y la salida típica de ordenador, y la tercera imagen muestra cómo +LilyPond imita el aspecto tradicional. La imagen de la izquierda presenta el dibujo escaneado +de un símbolo de bemol sacado de una edición publicada en el año 2000. La del centro +es un símbolo procedente de una edición de B@"{a}renreiter grabada a mano de la +misma música. La de la izquierda ilustra los típicos puntos débiles de la impresión por +ordenador: las líneas del pentagrama son muy delgadas, el peso del símbolo del bemol es también demasiado ligero +como las líneas del pentagrama, y tiene una apariencia rectilínea con esquinas afiladas. En +contraste, el bemol de B@"{a}renreiter tiene una apariencia redonda, pesada, casi +voluptuosa. Nuestro símbolo del bemol se diseñó según éste, entre otros. +Es de forma redondeada y su peso está en armonía con el grosor de +nuestras líneas de pentagrama, que son asimismo mucho más gruesas que las de la +edición por ordenador. + +@multitable @columnfractions .125 .25 .25 .25 .125 +@item @tab +@ifnotinfo +@iftex +@image{henle-flat-gray,,4cm} +@end iftex +@ifnottex +@image{henle-flat-gray,,,png} +@end ifnottex + +@tab +@iftex +@image{baer-flat-gray,,4cm} +@end iftex +@ifnottex +@image{baer-flat-gray,,,png} +@end ifnottex + +@tab +@iftex +@image{lily-flat-bw,,4cm} +@end iftex +@ifnottex +@image{lily-flat-bw,,,png} +@end ifnottex +@end ifnotinfo +@ifinfo +@c workaround for makeinfo-4.6: line breaks and multi-column cookies +@image{henle-flat-bw,,,png} @image{baer-flat-bw,,,png} +@image{lily-flat-bw,,,png} +@end ifinfo + +@item @tab +Henle (2000) +@tab +B@"{a}renreiter (1950) +@tab +Tipografía Feta de LilyPond (2003) + +@end multitable + + +@cindex símbolos musicales +@cindex tipografías +@cindex negrura +@cindex equilibrio + +@c introduce illustrating aspects of engraving, spacing... +Tratándose del espaciado, la distribución del espacio debe reflejar las duraciones +que hay entre las notas. Sin embargo muchas partituras modernas se atañen a las duraciones +con precisión matemática, lo que lleva a unos resultados bastante pobres. En el siguiente +ejemplo se muestra un ejemplo dos veces: una utilizando espaciado matemáticamente +exacto, y otra con ciertas correcciones. ¿Puede adivinar cuál es cuál? + +@cindex espaciado óptico +@c file spacing-optical. +@c need to include it here, because we want two images. +@lilypond +\paper { + ragged-right = ##t + indent = #0.0 +} + +music = { + c'4 e''4 e'4 b'4 | + \stemDown + b'8[ e'' a' e''] + \stemNeutral + e'8[ e'8 e'8 e'8] +} + +\score +{ + \music + \layout { + \context { + \Staff + \override NoteSpacing #'stem-spacing-correction = #0.6 + } + } +} +@end lilypond + +@lilypond +\paper { + ragged-right = ##t + indent = #0.0 +} + +music = { + c'4 e''4 e'4 b'4 | + \stemDown + b'8[ e'' a' e''] + \stemNeutral + e'8[ e'8 e'8 e'8] +} +\score +{ + \music + \layout { + \context { + \Staff + \override NoteSpacing #'stem-spacing-correction = #0.0 + \override NoteSpacing #'same-direction-correction = #0.0 + \override StaffSpacing #'stem-spacing-correction = #0.0 + } + } +} +@end lilypond -UNTRANSLATED NODE: IGNORE ME +@cindex ritmos regulares +@cindex espaciado regular +Cada compás de este fragmento solamente utiliza notas que se tocan a ritmo +constante. El espaciado debería reflejarlo. Desgraciadamente el ojo +nos engaña un poco; no solamente percibe la distancia entre las +cabezas de las notas, sino que tiene también en cuenta la distancia entre +las plicas. Como resultado, las notas de una combinación plica arriba/@/plica abajo +se tendrían que separar más, y las notas de una combinación +plica abajo/@/plica arriba deberían juntarse, todo ello +dependiendo de las posiciones combinadas de las notas. Los dos +compases de arriba están impresos con esta corrección y los de abajo +sin ella, formando grupos de notas pegadas con plica abajo/@/plica arriba. + +@cindex tipografía + +Los músicos están normalmente más concentrados en tocar que en estudiar +el aspecto de una partitura, y por ello las pequeñeces sobre los detalles +tipográficos pueden parecer académicas. Pero no lo son. En las partituras más largas con +ritmos monótonos, las correcciones de espaciado llevan a sutiles variaciones en +la disposición de cada una de las líneas dándoles una especie de firma visual distintiva. +Sin esta firma, todas las líneas parecerían iguales, y se convertirían en +un laberinto. Si un músico aparta la mirada o tiene un lapsus de +concentración, las líneas podráin perder su lugar sobre el papel. + +De forma similar, la fuerza visual de unos símbolos pesados sobre gruesas líneas de pentagrama +se sostiene mejor cuando el lector se aleja del papel, por +ejemplo cuando está sobre un atril. Una distribución cuidadosa del espacio +blanco permite disponer la música muy apretada sin que los símbolos se toquen unos a otros. +El resultado reduce a un mínimo las vueltas de página, lo que es +una gran ventaja. + +Ésta es una característica normal del arte tipográfico. La disposición de la página tiene que ser +bonita, no sólo por sí misma, sino sobre todo porque así ayuda al lector en su tarea. +Para los materiales destinados a la interpretación, como las partituras, esto es +de una importancia doble: los músicos tienen una capacidad de concentración limitada. +Cuanta menos atención necesiten para el acto de leer, más se pueden dedicar +al acto de tocar la música. Dicho de otra forma: una mejor tipografía se traduce +en una mejor interpretación. + +Estos ejemplos demuestran que la tipografía musical es un arte +sutil y complejo, y que su elaboración requiere una experiencia considerable, +que los músicos no suelen tener. LilyPond representa nuestro +esfuerzo para llevar la excelencia visual de la música grabada a mano +a la era de la informática, y ponerla a disposición de los músicos normales. Hemos +ido afinando nuestros algoritmos, diseños de tipografía y preferencias del programa +para producir una impresión cuya calidad se equipara con la de las viejas ediciones +que tanto nos gusta contemplar y de las que tanto nos gusta tocar. + + +@node Automated engraving @section Automated engraving -UNTRANSLATED NODE: IGNORE ME +¿Cómo nos las arreglamos para implementar la tipografía? Si un artesano +necesita má de diez años para convertirse en un auténtico maestro ¿cómo vamos +a poder nosotros, simples hackers, escibir +un programa que les quite el trabajo? -@node What symbols to engrave? +La respuesta es: ¡no podemos! Puesto que la tipografía se fundamenta en el juicio humano +sobre la apariencia, las personas nunca se pueden sustituir completamente. +Sinm embargo, gran parte del trabajo más duro y repetitivo se peude automatizar. +Si LilyPond resuelve la mayoría de las situaciones comunes de forma correcta, +esto ya será una tremenda mejoría sobre los programas existentes. +El resto de los casos se podrán afinar a mano. Con el transcurso +de los años, el software se puede refinar para que haga un mayor número +de cosas de forma automática, de tal forma que los ajustes manuales tienden a ser +cada vez menos necesarios. + +Cuando empezamos, escibimos el programa LilyPond completamente en el lenguaje C++; +la funcionalidad del programa quedaba como esculpida en piedra por los desarrolladores. +Este esquema resultó no ser muy satisfactorio por una serie de motivos: + +@itemize @bullet +@item Cuando LilyPond comete fallos, +los usuarios tienen la necesidad de superar las decisiones de formateo. Por +ello el usuario debe tener acceso +al motor de formateo. De aquí que las reglas y valores establecidos no pueden +quedar fijados por nosotros durante la compilación sino que los usuarios deben poder +acceder a ellos durante la ejecución del programa. + +@item El grabado de música es cosa de juicio visual y por ello es cuestión de gustos. +A pesar de saber tanto como creemos saber, los usuarios pueden no estar de acuerdo +con nuestras decisiones personales. Por tanto la definición del estilo tipográfico +también debe estar al alcance del usuario. + +@item Por último, estamos continuamente refinando los algoritmos de formateo y por +tanto necesitamos un enfoque flexible para las reglas. El lenguaje C++ fuerza un +cierto método para agrupar las reglas que no encaja bien con la manera de funcionar +de la notación musical. +@end itemize + +Estos problemas se han solucionado integrando un intérprete del lenguaje +Scheme y reescibiendo parte del código de LilyPond en Scheme. +La actual arquitectura de formateo se construye alrededor del concepto de objetos +gráficos, descrita por variables y funciones de Scheme. Esta arquitectura puede +tratar al mismo tiempo con las reglas de formateo, el estilo tipográfico +y las decisiones de formateo individuales. El usuario tiene acceso directo a la +mayor parte de estos controles. + +Las variables de Scheme controlan las decisiones de formateo. Por ejemplo, muchos +objetos gráficos tienen una variable de dirección que codifica la elección entre +arriba y abajo (o izquierda y derecha). Aquí puede ver dos acordes con acentos y +signos de arpegio. En el primer acorde los objetos gráficos tienen todas sus +direcciones hacia abajo (o hacia la izquierda). El segundo acorde tiene todas las direcciones hacia arriba (o hacia la derecha). + +@lilypond[quote,ragged-right] +\new Score \with { + \override SpacingSpanner #'spacing-increment = #3 + \override TimeSignature #'transparent = ##t +} \relative { + \stemDown 4_>-\arpeggio + \override Arpeggio #'direction = #RIGHT + \stemUp 4^>-\arpeggio +} +@end lilypond -UNTRANSLATED NODE: IGNORE ME +@noindent +El proceso de formatear una partitura consiste en leer y escribir las variables +de los objetos gráficos. Ciertas variables tienen un valor predefinido. Por +ejemplo, el grosor de muchas líneas (una característica del estilo tipográfico) +son variables con un valor preestablecido. Podemos alterar este valor libremente +dando así a nuestra partitura una impresión tipográfica distinta. +@lilypond[quote,ragged-right] +fragment = { + \clef bass f8 as8 + c'4-~ c'16 as g f e16 g bes c' des'4 +} +<< + \new Staff \fragment + \new Staff \with { + \override Beam #'thickness = #0.3 + \override Stem #'thickness = #0.5 + \override Bar #'thickness = #3.6 + \override Tie #'thickness = #2.2 + \override StaffSymbol #'thickness = #3.0 + \override Tie #'extra-offset = #'(0 . 0.3) + } + \fragment +>> +@end lilypond + +Las reglas de formateo también son variables que están predefinidas: cada objeto tiene +unas variables que contienen procedimientos. Estos procedimientos realizan el trabajo +real de formateo y sustituyéndolos por otros podemos alterar el aspecto de los objetos. +En el siguiente ejemplo, la regla que define cómo se dibuja la cabeza de una nota +se altera durante el transcurso del fragmento musical. + +@lilypond[quote,ragged-right] +#(set-global-staff-size 30) + +#(define (mc-squared grob orig current) + (let* ((interfaces (ly:grob-interfaces grob)) + (pos (ly:grob-property grob 'staff-position))) + (if (memq 'note-head-interface interfaces) + (begin + (ly:grob-set-property! grob 'stencil ly:text-interface::print) + (ly:grob-set-property! grob 'font-family 'roman) + (ly:grob-set-property! grob 'text + (make-raise-markup -0.5 + (case pos + ((-5) (make-simple-markup "m")) + ((-3) (make-simple-markup "c ")) + ((-2) (make-smaller-markup (make-bold-markup "2"))) + (else (make-simple-markup "bla"))))))))) + +\new Voice \relative c' { + \stemUp + \set autoBeaming = ##f + \time 2/4 + 4 + \once \override NoteHead #'stencil = #ly:note-head::brew-ez-stencil + \once \override NoteHead #'font-size = #-7 + \once \override NoteHead #'font-family = #'sans + \once \override NoteHead #'font-series = #'bold + + \once \override NoteHead #'style = #'cross + + \applyOutput #'Voice #mc-squared + + << + { d8[ es-( fis^^ g] fis2-) } + \repeat unfold 5 { \applyOutput #'Voice #mc-squared s8 } + >> +} +@end lilypond + + + +@node What symbols to engrave? @section What symbols to engrave? -UNTRANSLATED NODE: IGNORE ME +@cindex grabado +@cindex tipografía -@node Music representation +El proceso de formateo toma las decisiones sobre dónde colocar los símbolos. +Sin embargo esto sólo se puede hacer una vez que se ha decidido @emph{qué} símbolos +han de imprimirse, o dicho de otro modo: qué notación utilizar. + +La notación musical común es un sistema de registro de música que ha venido +evolucionando desde hace 1000 años. La forma que se usa en nuestros días data de +los primeros tiempos del Renacimiento. Aunque la forma básica (es decir: puntos +sobre una pauta de cinco líneas) no ha cambiado, los detalles continúan evolucionando +para expresar todas las innovaciones de la notación contemporánea. +Por tanto abarca unos 500 años de música. Sus aplicaciones se extienden sobre un +amplio rango que abarca desde melodías monofónicas hasta monstruosos contrapuntos +para gran orquesta. + +¿Cómo podemos tratar con una bestia de tantas cabezas, y obligarla a que se encierre +dentro de los límites de un programa de ordenador? Nuestra solución es trocear el +problema de la notación (por oposición al grabado, esto es, a la tipografía) en +fragmentos digeribles y más fáciles de programar: cada tipo de símbolo se maneja por un +módulo separado que recibe el nombre de plug-in. Cada plug-in es completamente modular +e independiente, de forma que puede desarrollarse y mejorarse por separado. Estos +plug-ins se llaman @code{engraver}s (grabadores), por analogía con los artesanos que +traducen las ideas musicales a símbolos gráficos. + +En el siguiente ejemplo vemos cómo comenzamos con un plug-in para las cabezas +de las notas, el @code{Note_heads_engraver}. + +@lilypond[quote,ragged-right] +\include "engraver-example.ily" + +\score { + \topVoice + \layout { + \context { + \Voice + \remove "Stem_engraver" + \remove "Phrasing_slur_engraver" + \remove "Slur_engraver" + \remove "Script_engraver" + \remove "Beam_engraver" + \remove "Auto_beam_engraver" + } + \context { + \Staff + \remove "Accidental_engraver" + \remove "Key_engraver" + \remove "Clef_engraver" + \remove "Bar_engraver" + \remove "Time_signature_engraver" + \remove "Staff_symbol_engraver" + \consists "Pitch_squash_engraver" + } +} +} +@end lilypond + +@noindent +A continuación un @code{Staff_symbol_engraver} (grabador del pentagrama) añade las +líneas de la pauta. + +@lilypond[quote,ragged-right] +\include "engraver-example.ily" + +\score { + \topVoice + \layout { + \context { + \Voice + \remove "Stem_engraver" + \remove "Phrasing_slur_engraver" + \remove "Slur_engraver" + \remove "Script_engraver" + \remove "Beam_engraver" + \remove "Auto_beam_engraver" + } + \context { + \Staff + \remove "Accidental_engraver" + \remove "Key_engraver" + \remove "Clef_engraver" + \remove "Bar_engraver" + \consists "Pitch_squash_engraver" + \remove "Time_signature_engraver" + } + } +} +@end lilypond -UNTRANSLATED NODE: IGNORE ME +@noindent +El @code{Clef_engraver} (grabador de la clave) define un punto de referencia +para la altura de las notas en el pentagrama. +@lilypond[quote,ragged-right] +\include "engraver-example.ily" + +\score { + \topVoice + \layout { + \context { + \Voice + \remove "Stem_engraver" + \remove "Phrasing_slur_engraver" + \remove "Slur_engraver" + \remove "Script_engraver" + \remove "Beam_engraver" + \remove "Auto_beam_engraver" + } + \context { + \Staff + \remove "Accidental_engraver" + \remove "Key_engraver" + \remove "Bar_engraver" + \remove "Time_signature_engraver" + } + } +} +@end lilypond + +@noindent +y el @code{Stem_engraver} (grabador de las plicas) añade las plicas. + +@lilypond[quote,ragged-right] +\include "engraver-example.ily" + +\score { + \topVoice + \layout { + \context { + \Voice + \remove "Phrasing_slur_engraver" + \remove "Slur_engraver" + \remove "Script_engraver" + \remove "Beam_engraver" + \remove "Auto_beam_engraver" + } + \context { + \Staff + \remove "Accidental_engraver" + \remove "Key_engraver" + \remove "Bar_engraver" + \remove "Time_signature_engraver" + } + } +} +@end lilypond + +@noindent +El @code{Stem_engraver} (grabador de plicas) recibe una notificación cuando llega +una cabeza. Cada vez que se ve una cabeza (o más, si es un acorde), se crea un objeto +plica y se conecta a la cabeza. Añadiendo grabadores para las barras, ligaduras, +acentos, alteraciones, líneas divisorias, indicación de compás y armadura conseguimos +una notación completa. + +@lilypond[quote,ragged-right] +\include "engraver-example.ily" +\score { \topVoice } +@end lilypond + +Este sistema funciona bien para la música monofónica, pero ¿y con la polifonía? En +notación polifónica muchas voces pueden compartir el mismo pentagrama. + +@lilypond[quote,ragged-right] +\include "engraver-example.ily" +\new Staff << \topVoice \\ \botVoice >> +@end lilypond + +En esta situación, las alteraciones y la pauta se comparten, pero las +plicas, ligaduras, barras, etc. son propias de cada voz. Por tanto +los grabadores han de agruparse. Los grabadores de cabezas, plicas, +ligaduras, etc. se unen en un grupo llamado @q{Contexto de voz}, +mientras que los grabadores de la armadura, alteraciones, compás, etc. +van a un grupo que se llama @q{Contexto de la pauta}. En el caso de +la polifonía, un único Contexto de pauta contiene más de un Contexto +de voz. De forma semejante, varios Contextos de pauta pueden +agruparse en un único Contexto de partitura. El Contexto de partitura +es el contexto de notación de más alto nivel. + +@seealso + +Program reference: @internalsref{Contexts}. + +@lilypond[quote,ragged-right] +\include "engraver-example.ily" +\score { + << + \new Staff << \topVoice \\ \botVoice >> + \new Staff << \pah \\ \hoom >> + >> +} +@end lilypond + +@node Music representation @section Music representation -UNTRANSLATED NODE: IGNORE ME +Idealmente el formato de entrada para cualquier sistema de formateo de +alto nivel es una descripción abstracta del contenido. En este caso, +eso constituiría la propia música, lo que plantea un tremendo +problema: ¿cómo podemos definir qué es realmente la música? En lugar +de intentar hallar una respuesta, le hemos dado la vuelta a la +pregunta. Escribimos un programa capaz de producir partituras y +ajustamos el formato para que sea tan escueto como sea posible. +Cuando el formato ya no puede reducirse más, por definición nos +habremos quedado con el contenido musical propiamente dicho. Nuestro +programa sirve como definición formal de un documento musical. -@node Example applications -UNTRANSLATED NODE: IGNORE ME +La sintaxis también es el interfaz de usuario de LilyPond, así que es fácil teclear + +@example +c'4 d'8 +@end example +@noindent +un Do1 (Do central) negra, y un Re1 (el Re por encima del Do central) corchea. + +@lilypond[quote,fragment] +c'4 d'8 +@end lilypond + +A una escala microscópca, dicha sintaxis es fácil de utilizar. A una +escala mayor, la sintaxis también requiere una estructura. ¿De qué +otra forma podríamos introducir piezas complejas como sinfonías u +óperas? La estructura se forma mediante el concepto de expresiones +musicales: al combinar pequeños fragmentos de música dentro de otros +mayores, se pueden expresar ideas musicales más complejas. Por +ejemplo + +@lilypond[quote,verbatim,fragment,relative=1] +c4 +@end lilypond + +@noindent +Los acordes se pueden construir encerrando las notas entre @code{<<} y @code{>>} + +@c < > is not a music expression, +@c so we use <<>> iso. <> to drive home the point of +@c expressions. Don't change this back --hwn. +@example +<> +@end example + +@lilypond[quote,fragment,relative=1] +\new Voice { <> } +@end lilypond + +@noindent +Esta expresión se coloca en secuencia encerrándola dentro de llaves +@code{@{@tie{}@dots{}@tie{}@}} + +@example +@{ f4 <> @} +@end example + +@lilypond[quote,relative=1,fragment] +{ f4 <> } +@end lilypond + +@noindent +Lo anterior, a su vez también es una expresión, y por ello se puede combinar +de nuevo con otra expresión simultánea (una blanca) usando <<, +@code{\\}, y >> + +@example +<< g2 \\ @{ f4 <> @} >> +@end example + +@lilypond[quote,fragment,relative=2] +\new Voice { << g2 \\ { f4 <> } >> } +@end lilypond + +Las mencionadas estructuras recursivas se pueden especificar de forma nítida y formal dentro de una +gramática independiente del contexto. El código de análisis también se genera a partir de esta +gramática. En otras palabras, la sintaxis de LilyPond está definida +de una forma clara y sin ambigüedades. + +Los interfaces de usuario y la sintaxis son lo que la persona ve y con +lo que trata principalmente. En parte, son fruto de preferencias +personales y como tales están sujetas a mucha discusión. Aunque las +discusiones sobre el gusto tienen su mérito, no son demasiado +productivas. Dentro de la escena global de LilyPond, la sintaxis de +la entrada tiene una importancia relativamente pequeña: inventarse una +sintaxis elegante es fácil, pero escribir un código de formateo +decente es mucho más difícil. Esto también queda ilustrado por la +cantidad de líneas de código de los componentes respectivos: el +análisis y la representación se llevan menos del 10% del código +fuente. + + +@node Example applications @section Example applications -UNTRANSLATED NODE: IGNORE ME +Escribimos LilyPond como un experimento de cómo condensar el arte +del grabado de música dentro de un programa de ordenador. Gracias a todo este duro +trabajo, el programa ahora se puede usar para hacer trabajos útiles. La +aplicación más sencilla es imprimir notas. + +@lilypond[quote,relative=1,fragment] +\time 2/4 c4 c g'4 g a4 a g2 +@end lilypond + +@noindent +Añadiendo los nombres de acordes y la letra, obtenemos una hoja guía de canción. + +@lilypond[quote,ragged-right] +<< + \chords { c2 c f2 c } + \new Staff \relative c' { \time 2/4 c4 c g'4 g a4 a g2 } + \new Lyrics \lyricmode { twin4 kle twin kle lit tle star2 } +>> +@end lilypond + +También se pueden imprimir notación polifónica y música para piano. El ejemplo +siguiente combina varias otras construcciones exóticas. + +@lilypondfile[quote,ragged-right]{screech-boink.ly} + +Todos los fragmentos mostrados se han escrito a mano, pero esto no es +necesariamente así. Puesto que el motor de formateo es casi completamente automático, +puede servir como medio de salida para otros programas que manipulan +música. Por ejemplo, se puede usar también para convertir bases de datos de +fragmentos musicales en imágenes con destino a páginas web y presentaciones +multimedia. + +Este manual también es un ejemplo de aplicación: el formato de entrada es texto sencillo, y por ello +se puede empotrar fácilmente dentro de otros formatos basados en texto, como +@LaTeX{}, HTML, o en el caso concreto de este manual, Texinfo. A través de un +programa especial, los fragmentos de entrada se pueden sustituir por imágenes musicales +dentro de los archivos de salida PDF o HTML resutantes. Esto convierte la tarea de +mezclar música y texto dentro de los documentos, en algo muy sencillo. -@node About this manual -UNTRANSLATED NODE: IGNORE ME +@node About this manual @section About this manual -UNTRANSLATED NODE: IGNORE ME +El manual se divide en los siguientes capítulos: +@itemize @bullet + +@item +@ifhtml +El +@end ifhtml +@emph{@ref{Tutorial}} +da una amable introducción a la tipografía musical. Los usuarios que se acercan +por primera vez deben comenzar por aquí. + +@item +@emph{@ref{Putting it all together}} +explica algunos conceptos generales sobre el formato de los archivos de entrada de LilyPond. Si +no está seguro de dónde colocar un comando ¡lea este capítulo! + +@item +@emph{@ref{Working on LilyPond projects}} +trata los usos prácticos de LilyPond y cómo evitar ciertos problemas bastante +comunes. + +@item +@emph{@ref{Tweaking output}} +muestra la manera de cambiar el grabado por omisión que produce +LilyPond. + +@item +@emph{@ref{Basic notation}} +trata ciertos temas agrupados según las construcciones de notación. Esta sección proporciona +detalles sobre notación básica que probablemente serán de utilidad en casi cualquier +proyecto de notación. + +@item +@emph{@ref{Instrument-specific notation}} +también trata los temas agrupados por construcciones de notación. Esta sección proporciona +detalles sobre notación especial que solamente será útil para ciertos +grupos de instrumentos (o vocales). + +@item +@emph{@ref{Advanced notation}} +trata temas agrupados por construcciones de notación. Esta sección proporciona +detalles acerca de cierta notación complicada o poco usual. + +@item +@emph{@ref{Changing defaults}} +explica cómo hacer un ajuste fino de la presentación. + +@item +@emph{@ref{Non-musical notation}} +trata la salida no musical como los títulos, varios movimientos, +y sobre cómo elegir los instrumentos MIDI. + +@item +@emph{@ref{Spacing issues}} +trata asuntos que afectan a la salida global, como la elección del +tamaño del papel o la especificación de los saltos de página. + +@item +@emph{@ref{Interfaces for programmers}} +explains how to create music functions. + +@item +@emph{@ref{Running LilyPond}} +muestra la manera de ejecutar LilyPond y sus programas asistentes. +Además, esta sección explica cómo actualizar los archivos de entrada +de versiones de LilyPond anteriores. + +@item +@emph{@ref{LilyPond-book}} da los detalles que se encuentran detrás de la creación de +documentos con ejemplos de música insertados, como este manual. + +@item +@emph{@ref{Converting from other formats}} +explica cómo ejecutar los programas de conversión. Estos programas se proporcionan +con el paquete LilyPond, y convierten una amplia variedad de formatos de +música al formato @code{.ly}. + +@item +@ifhtml +La +@end ifhtml +@emph{@ref{Literature list}} +contiene un conjunto de libros de referencia muy útiles para aquellas personas que desean saber +más sobre notación y grabado. + +@item +El +@emph{@ref{Scheme tutorial}} +presenta una breve introducción a Scheme, el lenguaje de programación +que utilizan las funciones musicales. + +@item +@emph{@ref{Notation manual tables}} +son un conjunto de tablas que relacionan los nombres de los acordes, instrumentos MIDI, +nombres de los colores y la tipografía Feta. + +@item +@emph{@ref{Templates}} +de piezas de LilyPond. Sólo tiene que cortar y pegar una +plantilla en un archivo de texto, escibir las notas y ¡ha terminado! + +@item +La +@emph{@ref{Cheat sheet}} +es una referencia manejable de los comandos de LilyPond más comunes. + +@item +El +@emph{@ref{LilyPond command index}} +es un índice de todos los @code{\commands} de LilyPond. + +@item +El +@emph{@ref{LilyPond index}} +es un índice completo. + +@end itemize + + +Cuando ya sea un usuario con experiencia podrá usar el manual como referencia: +hay un índice muy completo@footnote{Si está buscando algo y +no lo encuentra en el manual, eso se considera un bug (fallo). En este +caso le rogamos que envíe un informe de fallo.}, pero el documento también +está disponible en +@iftex +una sola página HTML enorme, +@end iftex +@ifhtml +@uref{source/Documentation/user/lilypond.html, una sola página enorme}, +@end ifhtml +en la que es fácil buscar cualquier cosa utilizando la función de búsqueda de su +navegador de web. +@cindex buscar en el manual +@cindex usar el manual + +@c FIXME: +@c add/integrate glossary, put in list above +Si no está familiarizado con la notación o con la terminología musicales +(sobre todo si es un hablante de inglés no nativo), le recomendamos que +consulte también el glosario. +@iftex +El glosario explica los términos musicales, e incluye traducciones +a varios idiomas. Es un docuento aparte, disponible en HTML +y en PDF. +@end iftex +@ifnottex +El @ref{Top,Music glossary,,music-glossary} explica los términos musicales e +incluye traducciones a varios idiomas. También se encuentra disponible en +PDF. +@end ifnottex +@cindex frase idiomática +@cindex jerga +@cindex terminología +@cindex idiomas extranjeros +@cindex idioma + + +Este manual no estaría completo sin un cierto número de otros documentos. No +se encuentran disponibles en una forma lista para la impresión, pero deberían venir incluidos con el +paquete de documentación para su plataforma informática + +@itemize @bullet +@item +@iftex +Referencia del programa +@end iftex +@ifnottex +@ref{Top,Program reference,,lilypond-internals}. +@end ifnottex + +La referencia del programa es un conjunto de páginas HTML con una tupida red de enlaces cruzados, +que documentan al detalle el meollo de todas y cada una de las +clases, objetos y funciones de LilyPond. Se produce directamente a partir de las +definiciones de formateo que se utilizan. + +Casi toda la funcionalidad de formateo que se emplea internamente, se encuentra +disponible para el usuario de forma directa. Por ejemplo, todas las variables que controlan +los valores de grosor, distancias, etc., se pueden cambiar dentro de los archivos de entrada. +Hay un enorme número de opciones de formateo, y todas ellas +se describen en este documento. Cada sección del manual de notación +tiene una subsección @b{Véase también}, que hace referencia a la documentación +generada. En el documento HTML, estas subseciones llevan enlaces que se pueden plusar. + + +@cindex fragmentos de código +@item +@ifnothtml +Diversos ejemplos de entrada. +@end ifnothtml +@ifhtml +@c Works, but link name is not so nice; so write-out macro +@c @inputfileref{input/test,Various input examples}. +@uref{source/input/test/collated-files.html,Diversos ejemplos de entrada}. +@end ifhtml + +This collection of files shows various tips and tricks, and is +available as a big HTML document, with pictures and explanatory texts +included. + +@item +@ifnothtml +The regression tests. +@end ifnothtml +@ifhtml +@c Works, but link name is not so nice; so write-out macro +@c @inputfileref{input/regression,The regression tests}. +@uref{source/input/regression/collated-files.html,The regression tests}. +@end ifhtml + +Esta colección de archivos sirve para probar todas las funcionalidades de notación y grabado +de LilyPond en un único archivo. La colección está ahí en primer lugar para ayudarnos +a depurar los problemas, pero puede ser muy instructiva para ver cómo ponemos al programa a hacer ejercicio. +El formato es similar al del documento de consejos y trucos. +@end itemize + + +En todos los documentos HTML que tienen fragmentos de música +incrustados, la entrada de LilyPond que se utilizó para producir dicha +imagen se puede ver pulsando con el ratón sobre la imagen. + +La localización exacta de los archivos de documentación que hemos mencionado puede +variar de un sistema a otro. En ocasiones este manual hace referencia a +archivos de inicialización y de ejemplo. A lo largo del manual, nos referimos a +archivos de entrada por su ruta relativa respecto de directorio de nivel más alto de los archivos de código fuente. Por +ejemplo, @file{input/@/test/@/bla@/.ly} puede referirse al archivo +@file{lilypond@/2.x.y/@/input/@/test/@/bla@/.ly}. En los paquetes binarios para +la plataforma Unix, la documentación y los ejemplos se pueden encontrar normalmente +en algún lugar dentro de @file{/usr/@/share/@/doc/@/lilypond/}. +Los archivos de incialización, como por ejemplo @file{scm/@/lily@/.scm}, o +@file{ly/@/engraver@/-init@/.ly}, se encuentran normalmente en el directorio +@file{/usr/@/share/@/lilypond/}. + +@cindex ajustar la salida +@cindex variables +@cindex propiedades +@cindex interioridades de lilypond +@cindex documentación interna +@cindex Scheme +@cindex extender lilypond +@cindex índice + +Por último, este y el resto de los manuales, están disponibles en línea tanto como archivos +PDF como HTML en el sitio web, que encontrará en +@uref{http://@/www@/.lilypond@/.org/}. -- 2.39.5