]> git.donarmstrong.com Git - lilypond.git/blob - Documentation/es/learning/tutorial.itely
Run scripts/auxiliar/update-with-convert-ly.sh
[lilypond.git] / Documentation / es / learning / tutorial.itely
1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
2
3 @ignore
4     Translation of GIT committish: 2055f35c47a045a50a01ff4dba8524322cfc3b48
5
6     When revising a translation, copy the HEAD committish of the
7     version that you are working on.  For details, see the Contributors'
8     Guide, node Updating translation committishes..
9 @end ignore
10
11 @include included/generating-output.itexi
12
13 @c \version "2.16.0"
14
15 @node Tutorial
16 @chapter Tutorial
17 @translationof Tutorial
18
19 Este capítulo ofrece una introducción básica al trabajo con LilyPond.
20
21 @menu
22 * Compilación del archivo::
23 * Cómo escribir archivos de entrada::
24 * Tratar con los errores::
25 * Cómo leer los manuales::
26 @end menu
27
28 @node Compilación del archivo
29 @section Compilación del archivo
30 @translationof Compiling a file
31
32 Esta sección presenta el concepto de @qq{compilación}: el
33 procesamiento de los documentos de entrada de LilyPond (escritos por
34 uno mismo) para producir archivos de salida.
35
36 @menu
37 * Escritura del código de entrada::
38 * MacOS X::
39 * Windows::
40 * Línea de órdenes::
41 @end menu
42
43 @node Escritura del código de entrada
44 @subsection Escritura del código de entrada
45 @translationof Entering input
46
47 @cindex compilación
48 @cindex ejemplo inicial
49 @cindex inicial, ejemplo
50 @cindex mayúsculas, sensible a
51
52 @qq{Compilación} es una palabra que significa procesar un texto de
53 entrada en formato de LilyPond para producir un archivo que se puede
54 imprimir y (de manera opcional) un archivo MIDI que se puede
55 reproducir.  El primer ejemplo muestra el aspecto de un sencillo
56 archivo de texto de entrada.
57
58 Este ejemplo muestra un archivo de entrada sencillo:
59
60 @example
61 \version "@w{@version{}}"
62 @{
63   c' e' g' e'
64 @}
65 @end example
66
67 El resultado tiene este aspecto:
68
69 @c  in this case we don't want verbatim
70 @lilypond[quote]
71 {
72   c' e' g' e'
73 }
74 @end lilypond
75
76 @warning{la música y la letra escrita en el código de entrada de
77 LilyPond tiene que ir siempre entre @w{@strong{@{ llaves @}}}.  Las llaves
78 deberían también estar rodeadas por espacios a no ser que se
79 encuentren al principio o al final de una línea, para evitar
80 ambigüedades.  Es posible que se omitan en algunos ejemplos del
81 presente manual ¡pero no las omita en su propia música!  Para ver más
82 información sobre la presentación de los ejemplos del manual, consulte
83 @ref{Cómo leer los manuales}.}
84
85 Además, la entrada de LilyPond es @strong{sensible a las mayúsculas}.
86 @w{@samp{ @{ c d e @}}} es una entrada válida; @w{@samp{@{ C D E @}}} produce
87 un mensaje de error.
88
89 @smallspace
90
91 @subheading Generar el resultado
92
93 @cindex PDF, archivo
94 @cindex ver la música
95 @cindex editores de texto
96
97 El método para producir un resultado impreso depende de nuestro
98 sistema operativo y del programa o programas que utilicemos.
99
100
101 @itemize
102
103 @item
104 @ref{MacOS X, @sourceimage{logo-macosx,,,}}
105 @ref{MacOS X, MacOS X} (gráfico)
106
107 @item
108 @ref{Windows, @sourceimage{logo-windows,,,}}
109 @ref{Windows, Microsoft Windows} (gráfico)
110
111 @item
112 @ref{Línea de órdenes, @sourceimage{logo-linux,,,}
113 @sourceimage{logo-freebsd,,,}
114 @sourceimage{logo-macosx,,,}
115 @sourceimage{logo-windows,,,}
116 }
117 @ref{Línea de órdenes, Todos los sistemas operativos} (consola)
118
119 @end itemize
120
121 Existen varios otros editores de texto con un apoyo específico a la
122 edición de texto de LilyPond.  Para ver más información, consulte
123 @rweb{Entornos mejorados}.
124
125 @warning{La primera vez que ejecute LilyPond, tardará un minuto o dos
126 porque todas las tipografías del sistema han de ser analizadas
127 previamente.  ¡Después de esto, LilyPond será mucho más rápido!}
128
129
130 @node MacOS X
131 @subsection MacOS X
132
133 @cindex ejecución de LilyPond bajo MacOS X
134 @cindex MacOS X, ejecución de LilyPond
135
136 @lilypadOSX
137
138
139 @node Windows
140 @subsection Windows
141
142 @cindex ejecutar LilyPond bajo Windows
143 @cindex Windows, ejecutar LilyPond
144
145 @lilypadWindows
146
147
148 @node Línea de órdenes
149 @subsection Línea de órdenes
150 @translationof Command-line
151
152 @cindex ejecución de  LilyPond bajo Unix
153 @cindex Unix, ejecución de LilyPond
154
155 @lilypadCommandLine
156
157 @node Cómo escribir archivos de entrada
158 @section Cómo escribir archivos de entrada
159 @translationof How to write input files
160
161 Esta sección presenta una parte de la sintaxis básica de LilyPond como
162 ayuda para que se inicie en la escritura de archivos de entrada.
163
164 @menu
165 * Notación sencilla::
166 * Trabajar sobre los archivos de entrada::
167 @end menu
168
169
170 @node Notación sencilla
171 @subsection Notación sencilla
172 @translationof Simple notation
173
174 @cindex sencilla, notación
175 @cindex notación sencilla
176
177 LilyPond añadirá ciertos elementos de notación de manera automática.
178 En el siguiente ejemplo hemos especificado solamente cuatro alturas,
179 pero LilyPond ha añadido la clave, el compás y las duraciones.
180
181 @lilypond[verbatim,quote]
182 {
183   c' e' g' e'
184 }
185 @end lilypond
186
187 @noindent
188 Este comportamiento se puede modificar, pero en general estos valores
189 automáticos son adecuados.
190
191
192 @subheading Alturas
193
194 @cindex alturas
195 @cindex notas
196 @cindex relativo, modo
197 @cindex apóstrofo
198 @cindex comilla simple
199 @cindex coma
200 @cindex alteraciones y modo relativo
201 @cindex relativo, modo, alteraciones y
202
203 @funindex \relative
204 @funindex relative
205 @funindex '
206 @funindex ,
207
208 Glosario musical:
209 @rglos{pitch},
210 @rglos{interval},
211 @rglos{scale},
212 @rglos{middle C},
213 @rglos{octave},
214 @rglos{accidental}.
215
216 La manera más sencilla de introducir las notas es mediante la
217 utilización del modo @code{\relative} (relativo).  En este modo, se
218 elige la octava automáticamente bajo la suposición de que la siguiente
219 nota se colocará siempre lo más cerca de la nota actual, es decir, se
220 colocará en la octava comprendida dentro de hasta tres espacios de
221 pentagrama a partir de la nota anterior.  Comenzaremos por introducir
222 el fragmento musical más elemental: una @notation{escala}, donde cada
223 nota está comprendida dentro de tan sólo un espacio de pentagrama
224 desde la nota anterior.
225
226 @lilypond[verbatim,quote]
227 % set the starting point to middle C
228 \relative c' {
229   c d e f
230   g a b c
231 }
232 @end lilypond
233
234 La nota inicial es el @notation{Do central}.  Cada nota sucesiva se
235 coloca lo más cerca posible de la nota previa (en otras palabras: la
236 primera @samp{c} es el Do más cercano al Do central; a éste le sigue
237 el Re más cercano a la nota previa, y así sucesivamente).  Podemos
238 crear melodías con intervalos mayores, aún sin dejar de utilizar el
239 modo relativo:
240
241 @lilypond[verbatim,quote]
242 \relative c' {
243   d f a g
244   c b f d
245 }
246 @end lilypond
247
248 @noindent
249 No es necesario que la primera nota de la melodía comience exactamente
250 en aquella que especifica la altura de inicio.  En el ejemplo
251 anterior, la primera nota (@code{d}) es el Re más cercano al Do
252 central.
253
254 Añadiendo (o eliminando) comillas simples @code{'} o comas @code{,} a
255 la instrucción @q{@w{@code{@bs{}\relative c'}}}, podemos cambiar la octava
256 de inicio:
257
258 @c KEEP LY
259 @lilypond[verbatim,quote]
260 % una octava por encima del Do central
261 \relative c'' {
262   e c a c
263 }
264 @end lilypond
265
266 Al principio, el modo relativo puede resultar algo confuso, pero es la
267 forma más sencilla de introducir la mayor parte de las melodías.
268 Veamos cómo funciona en la práctica este cálculo relativo.  Comenzando
269 por Si, que está situado en la línea central en clave de Sol, podemos
270 alcanzar Do, Re y Mi dentro de los tres espacios de pentagrama hacia
271 arriba, y La, Sol y Fa dentro de los tres espacios hacia abajo.  Por
272 tanto, si la nota siguiente a Si es Do, Re o Mi se supondrá que está
273 por encima del Si, mientras que La, Sol o Fa se entenderán situados
274 por debajo.
275
276 @c KEEP LY
277 @lilypond[verbatim,quote]
278 \relative c'' {
279   b c  % el Do está un espacio por encima, es el Do de arriba
280   b d  % el Re está dos por encima ó 5 por debajo, es el Re de arriba
281   b e  % el Mi está 3 por encima ó 4 por debajo, es el Mi de arriba
282   b a  % el La está 6 por encima ó 1 por debajo, es el La de abajo
283   b g  % el Sol está 5 por encima ó 2 por debajo, es el Sol de abajo
284   b f  % el Fa está 4 por encima ó 3 por debajo, es el Fa de abajo
285 }
286 @end lilypond
287
288 Lo mismo exactamente ocurre cuando cualquiera de esas notas llevan un
289 sostenido o un bemol.  Las @notation{Alteraciones accidentales} se
290 @strong{ignoran totalmente} en el cálculo de la posición relativa.
291 Exactamente la misma cuenta de espacios de pentagrama se hace a partir
292 de una nota situada en cualquier otro lugar del mismo.
293
294 Para añadir intervalos mayores de tres espacios de pentagrama, podemos
295 elevar la @notation{octava} añadiendo una comilla simple @code{'} (o
296 apóstrofo) a continuación del nombre de la nota.  También podemos
297 bajar la octava escribiendo una coma @code{,} a continuación del
298 nombre de la nota.
299
300 @lilypond[verbatim,quote]
301 \relative c'' {
302   a a, c' f,
303   g g'' a,, f'
304 }
305 @end lilypond
306
307 @noindent
308 Para subir o bajar una nota en dos (¡o más!) octavas, utilizamos
309 varias @code{''} ó @code{,,} (pero tenga cuidado de utilizar dos
310 comillas simples @code{''} ¡y no una comilla doble @code{"}@tie{}!)
311 @c " - keeps quotes in order for context-sensitive editor -td
312
313 @subheading Duraciones (valores rítmicos)
314
315 @cindex duraciones de las notas
316 @cindex notas, duraciones de
317 @cindex ritmos
318 @cindex redonda
319 @cindex blanca
320 @cindex negra
321 @cindex figura con puntillo
322 @cindex puntillo
323 @cindex notación de las duraciones
324
325 Glosario musical:
326 @rglos{beam},
327 @rglos{duration},
328 @rglos{whole note},
329 @rglos{half note},
330 @rglos{quarter note},
331 @rglos{dotted note}.
332
333 La @notation{duración} de una nota se especifica mediante un número
334 después del nombre de la nota: @code{1} significa @notation{redonda},
335 @code{2} significa @notation{blanca}, @code{4} significa
336 @notation{negra} y así sucesivamente.  Las @notation{barras de
337 corchea} se añaden automáticamente.
338
339 Si no especifica una duración, se utiliza la duración previa para la
340 nota siguiente.  La figura por omisión de la primera nota es una
341 negra.
342
343 @lilypond[verbatim,quote]
344 \relative c'' {
345   a1
346   a2 a4 a8 a
347   a16 a a a a32 a a a a64 a a a a a a a a2
348 }
349 @end lilypond
350
351 Para crear @notation{notas con puntillo}, añada un punto @code{.} al
352 número de la duración.  La duración de una nota con puntillo se debe
353 especificar de forma explícita (es decir: mediante un número).
354
355 @lilypond[verbatim,quote]
356 \relative c'' {
357   a4 a a4. a8
358   a8. a16 a a8. a8 a4.
359 }
360 @end lilypond
361
362
363 @subheading Silencios
364
365 @cindex silencio
366 @cindex notación de los silencios
367
368 Glosario musical:
369 @rglos{rest}.
370
371 Un @notation{silencio} se introduce igual que si fuera una nota con el
372 nombre @code{r}@tie{}:
373
374 @lilypond[verbatim,quote]
375 \relative c'' {
376   a4 r r2
377   r8 a r4 r4. r8
378 }
379 @end lilypond
380
381
382 @subheading Indicación de compás
383
384 @cindex compás, indicación de
385
386 @funindex \time
387 @funindex time
388
389 Glosario musical:
390 @rglos{time signature}.
391
392 La @notation{indicación de compás} se puede establecer con la orden
393 @code{\time} :
394
395 @lilypond[verbatim,quote]
396 \relative c'' {
397   \time 3/4
398   a4 a a
399   \time 6/8
400   a4. a
401   \time 4/4
402   a4 a a a
403 }
404 @end lilypond
405
406 @subheading Indicaciones de tempo
407
408 @cindex tempo, indicaciones de
409 @cindex metronómicas, indicaciones
410
411 @funindex \tempo
412 @funindex tempo
413
414 Glosario musical:
415 @rglos{tempo indication},
416 @rglos{metronome}.
417
418 La @notation{indicación de tempo} y la @notation{indicación
419 metronómica} pueden establecerse con la instrucción @code{\tempo}:
420
421 @lilypond[verbatim,quote]
422 \relative c'' {
423   \time 3/4
424   \tempo "Andante"
425   a4 a a
426   \time 6/8
427   \tempo 4. = 96
428   a4. a
429   \time 4/4
430   \tempo  "Presto" 4 = 120
431   a4 a a a
432 }
433 @end lilypond
434
435
436 @subheading Clave
437
438 @cindex clave
439 @cindex sol, clave de
440 @cindex do en tercera, clave de
441 @cindex do en cuarta, clave de
442 @cindex fa, clave de
443 @cindex soprano
444 @cindex alto
445 @cindex tenor
446 @cindex bajo
447
448 @funindex \clef
449 @funindex clef
450
451 Glosario musical:
452 @rglos{clef}.
453
454 La @notation{clave} se puede establecer utilizando la orden
455 @code{\clef} :
456
457 @lilypond[verbatim,quote]
458 \relative c' {
459   \clef "treble"
460   c1
461   \clef "alto"
462   c1
463   \clef "tenor"
464   c1
465   \clef "bass"
466   c1
467 }
468 @end lilypond
469
470
471 @subheading Todo junto
472
473 He aquí un pequeño ejemplo que muestra todos los elementos anteriores
474 juntos:
475
476 @lilypond[verbatim,quote]
477 \relative c, {
478   \clef "bass"
479   \time 3/4
480   \tempo "Andante" 4 = 120
481   c2 e8 c'
482   g'2.
483   f4 e d
484   c4 c, r
485 }
486 @end lilypond
487
488
489 @seealso
490 Referencia de la notación:
491 @ruser{Escritura de notas},
492 @ruser{Escritura de las duraciones (valores rítmicos)},
493 @ruser{Escritura de silencios},
494 @ruser{Indicación de compás},
495 @ruser{Clave}.
496
497
498 @node Trabajar sobre los archivos de entrada
499 @subsection Trabajar sobre los archivos de entrada
500 @translationof Working on input files
501
502 @cindex llaves
503 @cindex comentarios
504 @cindex línea, comentario de
505 @cindex comentario de línea
506 @cindex bloque, comentario de
507 @cindex mayúsculas, sensible a
508 @cindex espacios, insensible a
509 @cindex expresiones
510 @cindex versiones
511 @cindex versión
512 @cindex número de versión
513
514
515 @funindex \version
516 @funindex { ... }
517 @funindex %
518 @funindex %@{ ... %@}
519
520 Los archivos de entrada de LilyPond son como los archivos fuente de
521 muchos lenguajes de programación corrientes.  Contienen un enunciado
522 de versión, son sensibles a las mayúsculas y generalmente los espacios
523 se ignoran.  Las expresiones se forman con llaves @w{@code{@{ @}}} y los
524 comentarios se denotan por un signo de porcentaje (@code{%}) o por
525 @w{@code{%@{ @dots{} %@}}}@tie{}.
526
527 Si la frase anterior no tiene sentido para usted ¡no se preocupe! A
528 continuación explicaremos el significado de todos estos términos:
529
530 @itemize
531
532 @item
533 @strong{Enunciado de la versión}: Todo archivo de LilyPond debe
534 contener un enunciado de versión.  Un enunciado de versión es una
535 línea que describe la versión de LilyPond para la que se escribió este
536 archivo, como en el ejemplo siguiente:
537
538 @example
539 \version "@w{@version{}}"
540 @end example
541
542 Por convenio, el enunciado de versión se coloca al principio del
543 archivo de LilyPond.
544
545 El enunciado de versión es importante por dos motivos como mínimo.  En
546 primer lugar, permite la actualización automática del código de
547 entrada conforme se va modificando la sintaxis de LilyPond.  En
548 segundo lugar, indica la versión de LilyPond que se necesita para
549 compilar el archivo.
550
551 Si no se escribe ningún enunciado de versión en el archivo de entrada,
552 LilyPond imprime una advertencia durante la compilación del mismo.
553
554 @item
555 @strong{Sensible a las mayúsculas}: tiene importancia el hecho de que
556 introduzca una letra en minúsculas (p.ej. @w{@code{a, b, s, t}}) o en
557 mayúsculas (p.ej.  @w{@code{A, B, S, T}}).  Las notas son minúsculas:
558 @w{@samp{@{ c d e @}}} es una entrada válida; @w{@samp{@{ C D E @}}}
559 produciría un mensaje de error.
560
561 @item
562 @strong{Insensible al número de espacios}: no importa cuántos espacios
563 (o saltos de línea o de tabulación) añada.
564 @w{@samp{@{ c4 d e @}}} significa lo mismo que
565 @w{@samp{@{ c4 @tie{} @tie{} @tie{} d e @}}} y que
566
567 @example
568 @{ c4                       d
569                    e   @}
570 @end example
571
572 @noindent
573 Por supuesto, el ejemplo anterior es difícil de leer.  Una regla
574 práctica es sangrar los bloques de código con un carácter de
575 tabulación, o bien con dos espacios:
576
577 @example
578 @{
579   c4 d e
580 @}
581 @end example
582
583 Sin embargo, @emph{sí} se necesitan espacios para separar muchos
584 elementos sintácticos unos de otros.  En otras palabras, los espacios
585 se pueden siempre @emph{añadir}, pero no siempre @emph{eliminar}.
586 Dado que la falta de espacios puede dar lugar a extraños errores,
587 recomendamos insertar espacios siempre antes y después de cualquier
588 elemento sintáctico, por ejemplo, antes y después de las llaves.
589
590 @item
591 @strong{Expresiones:} Todo fragmento de código de entrada para
592 LilyPond ha de llevar @strong{@{@tie{}llaves@tie{}@}} antes y después de la
593 entrada.  Estas llaves le dicen a LilyPond que la entrada es una
594 expresión musical unitaria, igual que los paréntesis @samp{()} de las
595 matemáticas.  Las llaves deben ir rodeadas de un espacio a no ser que
596 se encuentren al comienzo o al final de una línea, para evitar
597 cualquier ambigüedad.
598
599 Una instrucción de LilyPond seguida de una expresión simple entre
600 llaves (como por ejemplo @q{@w{@code{@bs{}relative c' @{ @dots{} @}}}}) también es una
601 expresión musical unitaria.
602
603 @cindex comentarios
604 @cindex comentario de línea
605 @cindex comentario de bloque
606 @item
607 @strong{Comentarios}: Un comentario es una nota para el lector humano
608 de la entrada musical; se ignora cuando esta entrada se analiza, de
609 manera que no tiene ningún efecto sobre la salida impresa.  Existen
610 dos tipos de comentarios.  El símbolo de porcentaje @samp{%} introduce
611 un comentario de línea; todo lo que se encuentra después de @samp{%}
612 en esa línea se ignora.  Por convenio, una línea de comentario se
613 coloca @emph{por encima} del código a que se refiere el comentario.
614
615 @example
616 a4 a a a
617 % este comentario se refiere a las notas Si
618 b2 b
619 @end example
620
621 Un comentario de bloque marca una sección entera de entrada musical
622 como comentario.  Todo lo que está encerrado dentro de @code{%@{} y
623 @code{%@}} se ignora (pero los comentarios no pueden anidarse, lo que
624 significa que un comentario de bloque no puede incluir otros
625 comentarios de bloque).  Si lo hiciera, el primer @code{%@}} daría por
626 terminado @emph{los dos} comentarios de bloque.  El siguiente
627 fragmento muestra algunos posibles usos para los comentarios:
628
629 @example
630 % a continuación van las notas de campanitas del lugar
631   c4 c g' g a a g2
632
633 %@{
634   Esta línea y las notas que aparecen más abajo
635   se ignoran, por estar dentro de un
636   comentario de bloque.
637
638   f4 f e e d d c2
639 %@}
640 @end example
641
642 @end itemize
643
644
645 @node Tratar con los errores
646 @section Tratar con los errores
647 @translationof Dealing with errors
648
649 @cindex depuración de errores
650
651 A veces, LilyPond no produce el resultado esperado.  Esta sección
652 aporta algunos enlaces para ayudarle a resolver los problemas que
653 pudiera encontrar.
654
655 @menu
656 * Consejos generales de solución de problemas::
657 * Algunos errores comunes::
658 @end menu
659
660 @node Consejos generales de solución de problemas
661 @subsection Consejos generales de solución de problemas
662 @translationof General troubleshooting tips
663
664 La solución de problemas en LilyPond puede ser un desafío para las
665 personas acostumbradas a los interfaces gráficos, porque es posible
666 crear archivos de entrada inválidos.  Cuando esto ocurre, la mejor
667 forma de identificar y resolver el problema es aplicar un enfoque
668 lógico.  Se dan algunas guías para ayudarle a aprender a hacerlo, en
669 @rprogram{Solución de problemas}.
670
671
672 @node Algunos errores comunes
673 @subsection Algunos errores comunes
674 @translationof Some common errors
675
676 @cindex comunes, errores
677 @cindex errores comunes
678
679 Existen algunos errores comunes que son difíciles de solucionar si nos
680 basamos solamente en los mensajes de error que se nos presentan.
681 Éstos se describen en @rprogram{Errores comunes}.
682
683
684 @node Cómo leer los manuales
685 @section Cómo leer los manuales
686 @translationof How to read the manuals
687
688 Esta sección muestra cómo leer la documentación de forma eficiente, y
689 presenta algunas interesantes funcionalidades interactivas de la
690 versión en línea.
691
692 @menu
693 * Material omitido::
694 * Ejemplos con enlace::
695 * Panorámica de los manuales::
696 @end menu
697
698
699 @node Material omitido
700 @subsection Material omitido
701 @translationof Omitted material
702
703
704 @cindex cómo leer el manual
705 @cindex manual, lectura del
706 @cindex leer el manual
707 @cindex ejemplos, pulsar
708 @cindex pulsar sobre los ejemplos
709 @cindex consejos para construir archivos
710 @cindex plantillas
711 @cindex construir archivos, consejos
712 @cindex archivos, consejos para construir
713
714 Como ya vimos en @ref{Trabajar sobre los archivos de entrada}, el
715 código de entrada de LilyPond debe estar rodeado de llaves @code{@{ @}} o de
716 @q{@w{@code{@bs{}relative c'' @{ @dots{} @}}}}.  Durante el resto del presente
717 manual, la mayor parte de los ejemplos omitirán las llaves.  Para
718 reproducir los ejemplos, deberá copiar y pegar la entrada que se
719 muestra, pero @strong{deberá} escribir el @q{@w{@code{@bs{}relative c'' @{ @dots{} @}}}},
720 de la siguiente forma:
721
722 @example
723 \relative c'' @{
724   @dots{}aquí va el ejemplo@dots{}
725 @}
726 @end example
727
728 ¿Por qué omitir las llaves? Casi todos los ejemplos del presente
729 manual se pueden insertar en medio de un fragmento mayor de música.
730 Para estos ejemplos no tiene ningún sentido añadir
731 @q{@w{@code{@bs{}relative c'' @{ @dots{} @}}}}
732 (¡no debería poner un @code{\relative} dentro de otro
733 @code{\relative}!); si hubiésemos incluido
734 @q{@w{@code{@bs{}relative c'' @{ @dots{} @}}}}
735 rodeando a cada uno de los ejemplos, usted no podría copiar un
736 ejemplo pequeño procedente de la documentación y pegarlo dentro de su
737 propia pieza.  La mayoría querrá insertar el código dentro de una
738 pieza más grande, por eso hemos formateado el manual de esta manera.
739
740 Asimismo, recuerde que todo archivo de LilyPond debe llevar un
741 enunciado @code{\version}.  Dado que los ejemplos de los manuales
742 son fragmentos de código y no archivos completos, el enunciado
743 @code{\version} se omite.  De todas formas, debemos acostumbrarnos
744 a incluirlo en nuestros documentos.
745
746 @node Ejemplos con enlace
747 @subsection Ejemplos con enlace
748 @translationof Clickable examples
749
750 @warning{Esta funcionalidad sólo está disponible en los manuales en
751 HTML.}
752
753 Muchas personas aprenden a utilizar programas probando y enredando con
754 ellos.  Esto también puede hacerse con LilyPond.  Si hace clic sobre
755 una imagen en la versión en HTML de este manual, podrá ver la entrada
756 exacta de LilyPond que se utilizó para generar esa imagen.  Pruébelo
757 sobre esta imagen:
758
759 @c no verbatim here
760 @c KEEP LY
761 @lilypond[quote]
762 \relative c'' {
763   c4-\markup { \bold \huge { Haga clic aquí. } }
764 }
765 @end lilypond
766
767 Cortando y pegando todo lo que se encuentra dentro de la sección
768 @qq{ly snippet} (fragmento de tipo ly), tendrá una plantilla inicial
769 para sus experimentos. Para poder ver exactamente el mismo resultado
770 (con igual anchura de línea y todo), copie todo lo que está desde
771 @qq{Start cut-&-pastable section} hasta el final del archivo.
772
773
774 @ignore
775 This is item 825
776
777 @n ode Navegación con el teclado
778 @s ubsection Navegación con el teclado
779 @t ranslationof Keyboard navigation
780
781 @warning{Esta posibilidad sólo está disponible en los manuales en
782 HTML.}
783
784 @c TODO: once this is figured out, insert it here.
785
786 Estamos trabajando sobre esta funcionalidad.
787 @end ignore
788
789 @node Panorámica de los manuales
790 @subsection Panorámica de los manuales
791 @translationof Overview of manuals
792
793 Existe abundantísima documentación sobre LilyPond.  Con frecuencia,
794 los nuevos usuarios se encuentran desorientados respecto a qué parte o
795 partes deben leer, y ocasionalmente pasan por alto la lectura de
796 partes de importancia vital.
797
798 @warning{Por favor: no se salte las partes importantes de la
799 documentación.  Le resultará mucho más difícil comprender las
800 secciones subsiguientes.}
801
802 @itemize
803
804 @item
805 @strong{Antes de intentar hacer @emph{cualquier cosa}}: lea el
806 @ref{Tutorial} del manual de Aprendizaje, y la sección @ref{Notación
807 corriente}.  Si encuentra términos musicales que no reconoce,
808 búsquelos en el @rglosnamed{Top, Glosario}.
809
810 @item
811 @strong{Antes de tratar de escribir una pieza completa de música}: lea
812 la sección @ref{Conceptos fundamentales} del manual de Aprendizaje.
813 Después, le vendrá bien consultar las secciones correspondientes de la
814 @rusernamed{Top, Referencia de la notación}.
815
816 @item
817 @strong{Antes de tratar de modificar los resultados predeterminados}:
818 lea la sección @ref{Trucar la salida} del manual de Aprendizaje.
819
820 @item
821 @strong{Antes de afrontar un proyecto grande}: lea la sección
822 @rprogramnamed{Suggestions for writing files,Sugerencias para escribir
823 archivos de entrada de LilyPond} del manual de Utilización del
824 programa.
825
826 @end itemize