1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
2 @c This file is part of lilypond.tely
4 Translation of GIT committish: 3e63320d65c86c823949f70ab9791eab96c98352
6 When revising a translation, copy the HEAD committish of the
7 version that you are working on. See TRANSLATION for details.
12 @node Working on LilyPond projects
13 @chapter Working on LilyPond projects
15 Esta sección explica cómo resolver o evitar ciertos problemas comunes.
16 Si tiene experiencia en programación muchos de estos
17 consejos pueden parecer obvios, pero aún así le recomendamos
18 que lea este capítulo.
22 * Suggestions for writing LilyPond files::
23 * When things don't work::
28 @node Suggestions for writing LilyPond files
29 @section Suggestions for writing LilyPond files
31 En este momento está preparado para comenzar a escribir archivos de
32 LilyPond más grandes -- no sólo los pequeños ejemplos que aparecen en
33 el tutorial, sino piezas completas --. Pero ¿cómo debe proceder para
36 En la medida en que LilyPond entienda sus archivos y produzca la
37 salida que usted pretendía, realmente no importa mucho qué aspecto
38 tengan sus archivos. Sin embargo existen algunas otras cosas a tener
39 en cuenta cuando se escriben archivos de LilyPond.
42 @item ¿Qué ocurre si comete un fallo? La estructura de un archivo
43 de LilyPond puede hacer que ciertos errores se hagan más fáciles (o
44 más difíciles) de encontrar.
46 @item ¿Qué ocurre si quiere compartir sus archivos con otras personas?
47 De hecho, ¿y si quiere alterar sus propios archivos después de algunos
48 años? Algunos archivos de LilyPond se comprenden a primera vista;
49 otros pueden tenerle rascándose la cabeza durante una hora.
51 @item ¿Qué ocurre si quiere actualizar su archivo de LilyPond para poderlo usar con
52 una versión más reciente del programa? La sintaxis de la entrada se
53 modifica de forma ocasional según LilyPond se va perfeccionando. Casi
54 todos los cambios se pueden hacer de forma automática con
55 @code{convert-ly}, pero algunos podrían necesitar de una ayuda manual.
56 Los archivos de LilyPond se pueden estructurar para que sean más
57 fáciles (o más difíciles) de actualizar.
62 * General suggestions::
63 * Typesetting existing music::
65 * Saving typing with variables and functions::
70 @node General suggestions
71 @subsection General suggestions
73 Presentamos algunas sugerencias que le pueden servir de ayuda para evitar
77 @item @strong{Incluya los números de @code{\version} en todos los archivos}. Dese cuenta de que todas las
78 plantillas contienen información sobre la @code{\version}. Le
79 recomendamos mucho que siempre incluya la @code{\version}, sin
80 importar cuán pequeño pueda ser su archivo. Desde la experiencia
81 personal podemos decirle que es bastante frustrante intentar recordar
82 el número de versión de LilyPond que estaba usando hace unos años.
83 @code{convert-ly} requiere que declare qué versión de LilyPond
86 @item @strong{Incluya comprobaciones}: @ruser{Bar and bar number checks},
87 @ruser{Octave checks}. Si incluye comprobaciones de vez en cuando, en
88 caso de que cometa un error podrá localizarlo mucho más rápidamente.
89 ¿Con qué frecuencia es @q{de vez en cuando}? Depende de la
90 complejidad de la música. Para una música muy sencilla, quizá tan
91 sólo una o dos veces. Para una música muy compleja, quizá a cada
94 @item @strong{Un compás por cada línea de texto}. Si hay algo muy complicado, ya sea
96 o en la salida que desea producir, a menudo conviene escribir un solo compás
97 por cada línea. El ahorro en espacio de pantalla que se obtiene al amontonar ocho compases por línea no merece la pena
98 si luego tiene que @q{depurar} los archivos.
100 @item @strong{Comente los archivos}. Utilice o números de compás (de vez en cuando)
102 referencias a temas musicales (@q{segundo tema de los violines,} @q{cuarta
103 variación,} etc.). Puede que no necesite comentarios cuando introduce una pieza por vez primera,
104 pero si quiere volver a ella o modificar algo al cabo de dos o tres años,
105 y también si le pasa la fuente a un amigo,
107 determinar sus intenciones o de qué manera estaba estructurado el archivo
108 si no le añadió los comentarios.
110 @item @strong{Aplique márgenes a las llaves}. Muchos problemas están causados por una
112 en el número de @code{@{} y @code{@}}.
114 @item @strong{Escriba las duraciones explícitamente} al comienzo de las secciones
115 e identificadores. Si especifica @code{c4 d e} al principio de una frase
116 (en lugar de sólo @code{c d e}) se puede ahorrar problemas
117 si reelabora la música más tarde.
119 @item @strong{Separe los trucos} de las definiciones musicales. Consulte
120 @ref{Saving typing with variables and functions} y
126 @node Typesetting existing music
127 @subsection Typesetting existing music
129 Si está introduciendo música a partir de una partitura existente (es decir, tipografiando una hoja
130 de música ya impresa),
134 @item Introduzca un sistema del manuscrito (la copia física) cada vez (pero mantenga
135 la práctica de escribir un compás por línea de texto), y compruebe
136 cada sistema cuando lo haya terminado. Puede usar las instrucciones
137 @code{showLastLength} o @code{showFirstLength} para acelerar el
138 proceso -- ver @ruser{Skipping corrected music} -- .
140 @item Defina @code{mBreak = @{ \break @}} e inserte @code{\mBreak}
141 dentro del archivo de entrada donde el manuscrito tenga un saldo de línea. De esta forma
142 le resultará mucho más fácil comparar la música de LilyPond con la original.
143 Cuando haya terminado de revisar su partitura podrá
144 definir @code{mBreak = @{ @}} para quitar todos esos saltos de línea. Así
145 permitirá a LilyPond colocar los saltos donde éste lo estime
148 @item Al escribir una parte para un instrumento transpositor dentro de una
149 variable, se recomienda que las notas estén envueltas dentro de
152 \transpose c altura-natural @{...@}
154 (donde @code{altura-natural} es la afinación natural del instrumento)
155 de forma que la música dentro de la variable esté realmente en Do
156 mayor. Después podemos volver a transportarlas en sentido inverso
157 cuando se utiliza la variable, si es necesario, pero quizá no queramos
158 hacerlo (p.ej., al imprimir una partitura en afinación de concierto,
159 al convertir una parte de trombón de clave de Sol a clave de Fa,
160 etc.). Es menos probable cometer errores en los transportes si toda
161 la música que está dentro de las variables se encuentra en un tono
164 Asimismo, haga los transportes exclusivamente hacia o desde Do mayor.
165 Esto significa que aparte de ésta, las únicas tonalidades que usaremos
166 serán los tonos de afinación de los instrumentos transpositores: bes
167 para una trompeta en Si bemol, aes para un clarinete en La bemol, etc.
173 @subsection Large projects
175 Al trabajar en proyecto grande se hace esencial tener una estructura clara
176 en los archivos de LilyPond
180 @item @strong{Utilice un identificador para cada voz}, con un mínimo de
181 estructura dentro de la definición. La estructura de la sección
182 @code{\score} es la que cambiará con mayor probabilidad; por contra, es
183 extremadamente improbable que cambie la definición de @code{violin} en
184 versiones nuevas de LilyPond.
187 violin = \relative c'' @{
200 @item @strong{Separe los trucos de las definiciones musicales}.
201 Ya se mencionó con anterioridad, pero para proyectos grandes es vital.
202 Quizá tengamos que cambiar la definición de @code{fluegop}, pero en ese
203 caso sólo lo tendremos que hacer una vez, y aún podremos evitar tocar
204 nada dentro de @code{violin}.
208 \dynamic f \italic \small @{ 2nd @} \hspace #0.1 \dynamic p @}
209 violin = \relative c'' @{
217 @node Saving typing with variables and functions
218 @subsection Saving typing with variables and functions
221 @cindex identificadores
223 Llegado a este punto, usted ha visto cosas de este tipo:
225 @lilypond[quote,verbatim,ragged-right]
226 hornNotes = \relative c'' { c4 b dis c }
234 Incluso se dará cuenta de que esto puede ser útil en música minimalista:
236 @lilypond[quote,verbatim,ragged-right]
237 fragmentA = \relative c'' { a4 a8. b16 }
238 fragmentB = \relative c'' { a8. gis16 ees4 }
239 violin = \new Staff { \fragmentA \fragmentA \fragmentB \fragmentA }
247 Sin embargo también puede usar estos identificadores (que también se conocen como
248 variables, macros o instrucciones definidas por el usuario) para hacer trucos:
250 @lilypond[quote,verbatim,ragged-right]
251 dolce = \markup{ \italic \bold dolce }
252 padText = { \once \override TextScript #'padding = #5.0 }
253 fthenp=_\markup{ \dynamic f \italic \small { 2nd } \hspace #0.1 \dynamic p }
254 violin = \relative c'' {
256 c4._\dolce b8 a8 g a b |
258 c4.^"hi there!" d8 e' f g d |
259 c,4.\fthenp b8 c4 c-. |
266 \layout{ragged-right=##t}
270 Obviamente estos identificadores son útiles para ahorrar tecleo.
271 Pero son dignos de tener en cuenta incluso si se van a utilizar una sola vez:
272 reducen la complejidad. Examinemos
273 el ejemplo anterior reescrito sin ningún identificador.
274 Encontrará que es mucho más difícil de leer, sobre todo
278 violin = \relative c'' @{
280 c4._\markup@{ \italic \bold dolce @} b8 a8 g a b |
281 \once \override TextScript #'padding = #5.0
282 c4.^"hi there!" d8 e' f g d |
283 c,4.\markup@{ \dynamic f \italic \small @{ 2nd @}
284 \hspace #0.1 \dynamic p @} b8 c4 c-. |
289 @c TODO Replace the following with a better example -td
290 @c Skylining handles this correctly without padText
292 Hasta ahora hemos contemplado la sustitución estática: cuando LilyPond
293 se encuentra con @code{\padText}, lo sustituye con aquello que
294 hemos definido que sea (es decir, todo lo que está a la derecha de
297 LilyPond también puede manejar sustituciones no estáticas (piense en ellas
300 @lilypond[quote,verbatim,ragged-right]
302 #(define-music-function (parser location padding) (number?)
304 \once \override TextScript #'padding = #$padding
312 c4^"piu mosso" fis a g
316 La utilización de identificadores también es una buena forma de reducir el trabajo si
317 la sintaxis de entrada de LilyPond cambia (véase @ref{Updating old files}). Si
318 tiene una sola definición (como p.ej. @code{\dolce}) para todos sus
319 archivos (ver @ref{Style sheets}), y después la sintaxis se modifica, sólo tendrá
320 que actualizar su definición @code{\dolce} única,
321 en lugar de tener que hacer cambios en cada uno de los archivos @code{.ly}.
325 @subsection Style sheets
327 La salida que produce LilyPond se puede modificar profundamente; consulte
328 @ref{Tweaking output} para leer detalles sobre este asunto. Pero ¿qué ocurre si tiene muchos
329 archivos a los que les quiere aplicar sus propios trucos? O ¿qué ocurre si, sencillamente,
330 quiere separar los trucos de la propia música? Todo esto
331 es bastante fácil de conseguir.
333 Veamos un ejemplo. No se preocupe si no entiende
334 las partes que tienen todos los @code{#()}. Esto se explicará en
335 @ref{Advanced tweaks with Scheme}.
337 @lilypond[quote,verbatim,ragged-right]
338 mpdolce = #(make-dynamic-script (markup #:hspace 1 #:translate (cons 5 0)
339 #:line(#:dynamic "mp" #:text #:italic "dolce" )))
340 tempoMark = #(define-music-function (parser location markp) (string?)
342 \once \override Score . RehearsalMark #'self-alignment-X = #left
343 \once \override Score . RehearsalMark #'extra-spacing-width = #'(+inf.0 . -inf.0)
344 \mark \markup { \bold $markp }
349 a4.\mpdolce d8 cis4--\glissando a | b4 bes a2
350 \tempoMark "Poco piu mosso"
351 cis4.\< d8 e4 fis | g8(\! fis)-. e( d)-. cis2
355 Existen varios problemas con la salida que se superpone; los arreglaremos utilizando
356 las técnicas descritas en @ref{Moving objects}. Pero también haremos algo respecto a
357 las definiciones @code{mpdolce} y @code{tempoMark}. Éstas producen la salida que
358 deseamos, pero quizá las querríamos utilizar en otra pieza.
359 Podríamos simplemente copiarlas y pegarlas al principio de cada archivo,
360 pero sería bastante molesto. También hace que se queden las definiciones
361 a la vista dentro de nuestros archivos de música, y yo personalmente encuentro
362 todos los @code{#()} bastante poco estéticos. Los vamos a esconder dentro de otro archivo:
365 %%% guardar esto en un archivo de nombre "definiciones.ly"
366 mpdolce = #(make-dynamic-script (markup #:hspace 1 #:translate (cons 5 0)
367 #:line(#:dynamic "mp" #:text #:italic "dolce" )))
368 tempoMark = #(define-music-function (parser location markp) (string?)
370 \once \override Score . RehearsalMark #'self-alignment-X = #left
371 \once \override Score . RehearsalMark #'extra-spacing-width = #'(+inf.0 . -inf.0)
372 \mark \markup @{ \bold $markp @}
376 Ahora modificaremos la música (guardemos este archivo como @file{"musica.ly"}).
378 @c We have to do this awkward example/lilypond-non-verbatim
379 @c because we can't do the \include stuff in the manual.
382 \include "definiciones.ly"
386 a4.\mpdolce d8 cis4--\glissando a | b4 bes a2
387 \once \override Score.RehearsalMark #'padding = #2.0
388 \tempoMark "Poco piu mosso"
389 cis4.\< d8 e4 fis | g8(\! fis)-. e( d)-. cis2
393 @lilypond[quote,ragged-right]
394 mpdolce = #(make-dynamic-script (markup #:hspace 1 #:translate (cons 5 0)
395 #:line(#:dynamic "mp" #:text #:italic "dolce" )))
396 tempoMark = #(define-music-function (parser location markp) (string?)
398 \once \override Score . RehearsalMark #'self-alignment-X = #left
399 \once \override Score . RehearsalMark #'extra-spacing-width = #'(+inf.0 . -inf.0)
400 \mark \markup { \bold $markp }
405 a4.\mpdolce d8 cis4--\glissando a | b4 bes a2
406 \once \override Score.RehearsalMark #'padding = #2.0
407 \tempoMark "Poco piu mosso"
408 cis4.\< d8 e4 fis | g8(\! fis)-. e( d)-. cis2
412 Eso tiene mejor aspecto, pero haremos algunos cambios más. El glissando es difícil
413 de ver, así que lo haremos más grueso y lo acercaremos a las cabezas de las notas. Pondremos
414 la indicación metronómica encima de la clave, en lugar de ir encima de la primera
415 nota. Y por último, mi profesor de composición odia las indicaciones de compás @q{C},
416 así que la convertiremos en @q{4/4}.
418 Sin embargo, no debe cambiar el archivo @file{musica.ly}. Sustituya nuestro archivo @file{definiciones.ly}
423 mpdolce = #(make-dynamic-script (markup #:hspace 1 #:translate (cons 5 0)
424 #:line( #:dynamic "mp" #:text #:italic "dolce" )))
425 tempoMark = #(define-music-function (parser location markp) (string?)
427 \once \override Score . RehearsalMark #'self-alignment-X = #left
428 \once \override Score . RehearsalMark #'extra-spacing-width = #'(+inf.0 . -inf.0)
429 \mark \markup @{ \bold $markp @}
434 \override MetronomeMark #'extra-offset = #'(-9 . 0)
435 \override MetronomeMark #'padding = #'3
438 \override TimeSignature #'style = #'numbered
441 \override Glissando #'thickness = #3
442 \override Glissando #'gap = #0.1
447 @lilypond[quote,ragged-right]
448 mpdolce = #(make-dynamic-script (markup #:hspace 1 #:translate (cons 5 0)
449 #:line( #:dynamic "mp" #:text #:italic "dolce" )))
450 tempoMark = #(define-music-function (parser location markp) (string?)
452 \once \override Score . RehearsalMark #'self-alignment-X = #left
453 \once \override Score . RehearsalMark #'extra-spacing-width = #'(+inf.0 . -inf.0)
454 \mark \markup { \bold $markp }
459 \override MetronomeMark #'extra-offset = #'(-9 . 0)
460 \override MetronomeMark #'padding = #'3
463 \override TimeSignature #'style = #'numbered
466 \override Glissando #'thickness = #3
467 \override Glissando #'gap = #0.1
473 a4.\mpdolce d8 cis4--\glissando a | b4 bes a2
474 \once \override Score.RehearsalMark #'padding = #2.0
475 \tempoMark "Poco piu mosso"
476 cis4.\< d8 e4 fis | g8(\! fis)-. e( d)-. cis2
480 ¡Eso tiene un aspecto mucho mejor! Ahora suponga que quiere publicar esta
481 pieza. A mi profesor de composición no le gustan las indicaciones de compás @q{C},
482 pero yo les tengo cierto cariño. Copiaremos el archivo
483 actual @file{definiciones.ly} a @file{publicar-web.ly} y modificaremos
484 éste. Como el propósito de esta música es producir un PDF que va a mostrarse
485 en la pantalla, también vamos a aumentar el
486 tamaño general de la salida.
490 mpdolce = #(make-dynamic-script (markup #:hspace 1 #:translate (cons 5 0)
491 #:line( #:dynamic "mp" #:text #:italic "dolce" )))
492 tempoMark = #(define-music-function (parser location markp) (string?)
494 \once \override Score . RehearsalMark #'self-alignment-X = #left
495 \once \override Score . RehearsalMark #'extra-spacing-width = #'(+inf.0 . -inf.0)
496 \mark \markup @{ \bold $markp @}
499 #(set-global-staff-size 23)
502 \override MetronomeMark #'extra-offset = #'(-9 . 0)
503 \override MetronomeMark #'padding = #'3
508 \override Glissando #'thickness = #3
509 \override Glissando #'gap = #0.1
514 @lilypond[quote,ragged-right]
515 mpdolce = #(make-dynamic-script (markup #:hspace 1 #:translate (cons 5 0)
516 #:line( #:dynamic "mp" #:text #:italic "dolce" )))
517 tempoMark = #(define-music-function (parser location markp) (string?)
519 \once \override Score . RehearsalMark #'self-alignment-X = #left
520 \once \override Score . RehearsalMark #'extra-spacing-width = #'(+inf.0 . -inf.0)
521 \mark \markup { \bold $markp }
524 #(set-global-staff-size 23)
527 \override MetronomeMark #'extra-offset = #'(-9 . 0)
528 \override MetronomeMark #'padding = #'3
531 \override Glissando #'thickness = #3
532 \override Glissando #'gap = #0.1
538 a4.\mpdolce d8 cis4--\glissando a | b4 bes a2
539 \once \override Score.RehearsalMark #'padding = #2.0
540 \tempoMark "Poco piu mosso"
541 cis4.\< d8 e4 fis | g8(\! fis)-. e( d)-. cis2
545 Ahora, en la música, simplemente sustituyo
546 @code{\include "definiciones.ly"} por
547 @code{\include "publicar-web.ly"}. Por supuesto, podríamos hacer esto aún más
548 práctico. Podríamos hacer un archivo @file{definiciones.ly} que contuviera
549 solamente las definiciones de @code{mpdolce} y @code{tempoMark}, un archivo
550 @file{web-publish.ly} que contuviera solamente la sección @code{\layout}
551 que se mostró en el ejemplo, y un archivo @file{universidad.ly} que contendría
552 solamente los trucos para producir la salida que le gusta a mi
553 profesor. La parte más alta de @file{musica.ly} tendría entonces este aspecto:
556 \include "definiciones.ly"
558 %%% ¡Quitar el comentario de una sola de estas líneas!
559 \include "publicar-web.ly"
560 %\include "universidad.ly"
563 Este enfoque puede ser útil incluso si va a producir sólo un conjunto de particellas.
564 Yo utilizo media docena de archivos de
565 @q{hojas de estilo} para mis proyectos. Comienzo todos los archivos de música con
566 @code{\include "../global.ly"}, que contiene
570 \version @w{"@version{}"}
571 #(ly:set-option 'point-and-click #f)
572 \include "../iniciar/iniciar-definiciones.ly"
573 \include "../iniciar/iniciar-disposicion.ly"
574 \include "../iniciar/iniciar-cabeceras.ly"
575 \include "../iniciar/iniciar-papel.ly"
579 @node When things don't work
580 @section When things don't work
583 * Updating old files::
584 * Troubleshooting (taking it all apart)::
588 @node Updating old files
589 @subsection Updating old files
591 La sintaxis de la entrada de LilyPond cambia de manera ocasional. A medida que el propio
592 LilyPond mejora, la sintaxis (el lenguaje de la entrada) se modifica en consonancia. A
593 veces estos cambios se hacen para conseguir que la entrada sea más fácil de leer y escribir, y
594 otras veces estos cambios son para dar cabida a nuevas funcionalidades de LilyPond.
596 LilyPond lleva incorporado un archivo que facilita esta actualización:
597 @code{convert-ly}. Para ver detalles sobre cómo ejecutar este programa, consulte
598 @rprogram{Updating files with convert-ly}.
600 Desgraciadamente @code{convert-ly} no puede tratar todos los cambios en la entrada.
601 Se ocupa de los cambios sencillos de búsqueda y sustitución (como @code{raggedright}
602 que se convierte en @code{ragged-right}), pero algunos cambios son demasiado
603 complicados. Los cambios de sintaxis que @code{convert-ly} es incapaz de manejar
604 se relacionan en @rprogram{Updating files with convert-ly}.
606 Por ejemplo, en la versión 2.4 y anteriores de LilyPond,
607 los acentos y las letras no inglesas se introducían utilizando
608 LaTeX: por ejemplo, @code{No\"el} (que significa @q{Navidad} en francés).
609 En LilyPond 2.6 y siguientes, el carácter especial @code{ë}
610 debe introducirse directamente en el archivo de LilyPond como un carácter UTF-8.
611 @code{convert-ly} no puede cambiar todos los caracteres especiales
612 de LaTeX a caracteres de UTF-8; tendrá que actualizar manualmente
613 sus archivos de LilyPond antiguos.
616 @node Troubleshooting (taking it all apart)
617 @subsection Troubleshooting (taking it all apart)
619 Antes o después escribirá un archivo que LilyPond no podrá compilar.
620 Los mensajes que LilyPond proporciona pueden ayudarle a encontrar el
621 error, pero en muchos casos tendrá que llevar a cabo algún tipo de
622 investigación para determinar el origen del problema.
624 Las herramientas más poderosas para este cometido son el
625 comentario de una sola línea (indicado por @code{%}) y el comentario de bloque
626 (indicado por @code{%@{ ... %@}}). Si no sabe dónde está
627 el problema, comience convirtiendo grandes secciones del
628 archivo de entrada en un comentario. Después de eliminar una
629 sección convirtiéndola en un comentario, pruebe a compilar el
630 archivo otra vez. Si funciona, entonces el problema debía estar
631 en la porción que había eliminado. Si no funciona, continúe eliminando material
632 (transformándolo en comentarios) hasta que tenga algo que funcione.
634 En un caso extremo podría terminar con sólo
648 (en otras palabras: un archivo sin música)
650 Si ocurre esto, no abandone. Descomente un trozo pequeño -- digamos
651 la parte del bajo -- y observe si funciona. Si no es así,
652 transforme en comentarios toda la música del bajo (pero deje el
653 @code{\bajo} de la sección @code{\score} no comentado.
656 bajo = \relative c' @{
664 Ahora empiece poco a poco descomentando cada vez más fracciones de la
665 parte del @code{bajo} hasta que encuentre la línea del problema.
667 Otra técnica de depuración muy útil es la construcción de
668 @ref{Minimal examples}.
671 @node Minimal examples
672 @subsection Minimal examples
674 Un ejemplo mínimo es un ejemplo tan pequeño como sea posible. Estos
675 ejemplos son mucho más fáciles de comprender que los ejemplos largos. Los ejemplos
676 mínimos se utilizan para
679 @item Informes de fallo
680 @item Solicitudes de ayuda a las listas de correo
681 @item Añadir ejemplos al @uref{http://lsr@/.dsi@/.unimi@/.it/,Repositorio de Fragmentos de Código de LilyPond}
685 Para construir un ejemplo que sea lo más pequeño posible, la regla es
686 bastante simple: quite todo lo que no sea necesario. Al tratar de
687 quitar partes innecesarias de un archivo, es una buena idea convertir líneas en
688 comentarios en vez de borrarlas. De esta forma, si descubre que en realidad
689 sí @emph{necesitaba} algunas de estas líneas, podrá descomentarlas y no tendrá que
690 teclearlas de nuevo partiendo de cero.
692 Existen dos excepciones a la regla del @qq{lo más pequeño posible}:
695 @item Incluya el número de @code{\version}.
696 @item Si puede, ponga @code{\paper@{ ragged-right=##t @}} al principio del ejemplo.
700 En resumen, el objetivo de un ejemplo mínimo es que sea fácil de leer:
703 @item Evite usar notas, tonalidades o compases demasiado complicados, a no ser que quiera
704 demostrar algo sobre el comportamiento de estos elementos precisamente.
705 @item No use instrucciones @code{\override} a no ser que ése sea el propósito
710 @node Scores and parts
711 @section Scores and parts
713 En música orquestal, todas las notas se imprimen dos veces. Una vez
714 en las particellas para los músicos, y otra para la partitura del director.
715 Los identificadores se pueden usar para evitar la duplicación del trabajo.
716 La música se escribe una vez y se almacena en una variable.
717 El contenido de dicha variable se usa después para generar tanto la particella como la partitura del director.
719 Es muy conveniente definir las notas en un archivo especial. Por
720 ejemplo, supongamos que el archivo @file{trompa.ly} contiene la
721 siguiente parte de un dúo para trompa y fagot:
724 notasTrompa = \relative c @{
731 Luego se hace una particella escribiendo en un archivo lo siguiente
736 instrument = "Trompa en Fa"
740 \transpose f c' \notasTrompa
751 sustituye el contenido de @file{trompa.ly} en esta posición dentro del
752 archivo, así que @code{notasTrompa} se define con posterioridad. La
753 instrucción @code{\transpose f@tie{}c'} indica que el argumento
754 constituido por @code{\notasTrompa} se debe transponer una quinta
755 hacia arriba. Lo que suena como @code{f} se escribe como @code{c'},
756 lo que corresponde con el tono de afinación de una trompa normal
757 en@tie{}Fa. La transposición se puede ver en la siguiente salida
759 @lilypond[quote,ragged-right]
760 \transpose f c' \relative c {
766 En piezas para conjunto, con frecuencia una de las voces no suena durante muchos compases.
767 Esto queda denotado por un silencio especial, el silencio multicompás.
768 Se introduce con una @code{R} mayúscula seguida de una duración
769 (@code{1}@tie{}en el caso de la redonda, @code{2}@tie{}en el caso de una blanca,
770 etc.). Multiplicando la duración se pueden construir
771 silencios más largos. Por ejemplo, este silencio ocupa
772 3@tie{}compases de 2/4
778 Cuando se imprime la particella tienen que comprimirse los silencios
779 multicompás. Esto se hace estableciendo una variable en tiempo de ejecución
782 \set Score.skipBars = ##t
786 Esta instrucción establece el valor de la propiedad @code{skipBars} en el
787 contexto de @code{Score} a verdadero (@code{##t}). Anteponiendo el silencio y
788 esta opción a la música anterior, llegamos al siguiente resultado
790 @lilypond[quote,ragged-right]
791 \transpose f c' \relative c {
793 \set Score.skipBars = ##t
800 Esta partitura se hace combinando toda la música junta. Suponiendo
801 que la otra voz se encuentra dentro de @code{notasFagot} en el archivo
802 @file{fagot.ly}, la partitura se hace con
809 \new Staff \notasTrompa
810 \new Staff \notasFagot
817 @lilypond[quote,ragged-right]
825 r4 d,8 f | gis4 c | b bes |
826 a8 e f4 | g d | gis f