]> git.donarmstrong.com Git - lilypond.git/blob - Documentation/es/learning/tutorial.itely
Merge branch 'lilypond/translation'
[lilypond.git] / Documentation / es / learning / tutorial.itely
1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
2
3 @ignore
4     Translation of GIT committish: 0a8cfef9d285775b5587218e57ffaa9bbf134359
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.12.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 * Escritura del código 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 snuestro
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
407 @subheading Clave
408
409 @cindex clave
410 @cindex sol, clave de
411 @cindex do en tercera, clave de
412 @cindex do en cuarta, clave de
413 @cindex fa, clave de
414 @cindex soprano
415 @cindex alto
416 @cindex tenor
417 @cindex bajo
418
419 @funindex \clef
420 @funindex clef
421
422 Glosario musical:
423 @rglos{clef}.
424
425 La @notation{clave} se puede establecer utilizando la orden
426 @code{\clef} :
427
428 @lilypond[verbatim,quote]
429 \relative c' {
430   \clef "treble"
431   c1
432   \clef "alto"
433   c1
434   \clef "tenor"
435   c1
436   \clef "bass"
437   c1
438 }
439 @end lilypond
440
441
442 @subheading Todo junto
443
444 He aquí un pequeño ejemplo que muestra todos los elementos anteriores
445 juntos:
446
447 @lilypond[verbatim,quote]
448 \relative c, {
449   \clef "bass"
450   \time 3/4
451   c2 e8 c'
452   g'2.
453   f4 e d
454   c4 c, r
455 }
456 @end lilypond
457
458
459 @seealso
460 Referencia de la notación:
461 @ruser{Escritura de notas},
462 @ruser{Escritura de las duraciones (valores rítmicos)},
463 @ruser{Escritura de silencios},
464 @ruser{Indicación de compás},
465 @ruser{Clave}.
466
467
468 @node Trabajar sobre los archivos de entrada
469 @subsection Trabajar sobre los archivos de entrada
470 @translationof Working on input files
471
472 @cindex llaves
473 @cindex comentarios
474 @cindex línea, comentario de
475 @cindex comentario de línea
476 @cindex bloque, comentario de
477 @cindex mayúsculas, sensible a
478 @cindex espacios, insensible a
479 @cindex expresiones
480 @cindex versiones
481 @cindex versión
482 @cindex número de versión
483
484
485 @funindex \version
486 @funindex { ... }
487 @funindex %
488 @funindex %@{ ... %@}
489
490 Los archivos de entrada de LilyPond son como los archivos fuente de
491 muchos lenguajes de programación corrientes.  Contienen un enunciado
492 de versión, son sensibles a las mayúsculas y generalmente los espacios
493 se ignoran.  Las expresiones se forman con llaves @w{@code{@{ @}}} y los
494 comentarios se denotan por un signo de porcentaje (@code{%}) o por
495 @w{@code{%@{ @dots{} %@}}}@tie{}.
496
497 Si la frase anterior no tiene sentido para usted ¡no se preocupe! A
498 continuación explicaremos el significado de todos estos términos:
499
500 @itemize
501
502 @item
503 @strong{Enunciado de la versión}: Todo archivo de LilyPond debe
504 contener un enunciado de versión.  Un enunciado de versión es una
505 línea que describe la versión de LilyPond para la que se escribió este
506 archivo, como en el ejemplo siguiente:
507
508 @example
509 \version "@w{@version{}}"
510 @end example
511
512 Por convenio, el enunciado de versión se coloca al principio del
513 archivo de LilyPond.
514
515 El enunciado de versión es importante por dos motivos como mínimo.  En
516 primer lugar, permite la actualización automática del código de
517 entrada conforme se va modificando la sintaxis de LilyPond.  En
518 segundo lugar, indica la versión de LilyPond que se necesita para
519 compilar el archivo.
520
521 Si no se escribe ningún enunciado de versión en el archivo de entrada,
522 LilyPond imprime una advertencia durante la compilación del mismo.
523
524 @item
525 @strong{Sensible a las mayúsculas}: tiene importancia el hecho de que
526 introduzca una letra en minúsculas (p.ej. @w{@code{a, b, s, t}}) o en
527 mayúsculas (p.ej.  @w{@code{A, B, S, T}}).  Las notas son minúsculas:
528 @w{@samp{@{ c d e @}}} es una entrada válida; @w{@samp{@{ C D E @}}}
529 produciría un mensaje de error.
530
531 @item
532 @strong{Insensible al número de espacios}: no importa cuántos espacios
533 (o saltos de línea o de tabulación) añada.
534 @w{@samp{@{ c4 d e @}}} significa lo mismo que
535 @w{@samp{@{ c4 @tie{} @tie{} @tie{} d e @}}} y que
536
537 @example
538 @{ c4                       d
539                    e   @}
540 @end example
541
542 @noindent
543 Por supuesto, el ejemplo anterior es difícil de leer.  Una regla
544 práctica es sangrar los bloques de código con un carácter de
545 tabulación, o bien con dos espacios:
546
547 @example
548 @{
549   c4 d e
550 @}
551 @end example
552
553 Sin embargo, @emph{sí} se necesitan espacios para separar muchos
554 elementos sintácticos unos de otros.  En otras palabras, los espacios
555 se pueden siempre @emph{añadir}, pero no siempre @emph{eliminar}.
556 Dado que la falta de espacios puede dar lugar a extraños errores,
557 recomendamos insertar espacios siempre antes y después de cualquier
558 elemento sintáctico, por ejemplo, antes y después de las llaves.
559
560 @item
561 @strong{Expresiones:} Todo fragmento de código de entrada para
562 LilyPond ha de llevar @strong{@{@tie{}llaves@tie{}@}} antes y después de la
563 entrada.  Estas llaves le dicen a LilyPond que la entrada es una
564 expresión musical unitaria, igual que los paréntesis @samp{()} de las
565 matemáticas.  Las llaves deben ir rodeadas de un espacio a no ser que
566 se encuentren al comienzo o al final de una línea, para evitar
567 cualquier ambigüedad.
568
569 Una instrucción de LilyPond seguida de una expresión simple entre
570 llaves (como por ejemplo @q{@w{@code{@bs{}relative c' @{ @dots{} @}}}}) también es una
571 expresión musical unitaria.
572
573 @cindex comentarios
574 @cindex comentario de línea
575 @cindex comentario de bloque
576 @item
577 @strong{Comentarios}: Un comentario es una nota para el lector humano
578 de la entrada musical; se ignora cuando esta entrada se analiza, de
579 manera que no tiene ningún efecto sobre la salida impresa.  Existen
580 dos tipos de comentarios.  El símbolo de porcentaje @samp{%} introduce
581 un comentario de línea; todo lo que se encuentra después de @samp{%}
582 en esa línea se ignora.  Por convenio, una línea de comentario se
583 coloca @emph{por encima} del código a que se refiere el comentario.
584
585 @example
586 a4 a a a
587 % este comentario se refiere a las notas Si
588 b2 b
589 @end example
590
591 Un comentario de bloque marca una sección entera de entrada musical
592 como comentario.  Todo lo que está encerrado dentro de @code{%@{} y
593 @code{%@}} se ignora (pero los comentarios no pueden anidarse, lo que
594 significa que un comentario de bloque no puede incluir otros
595 comentarios de bloque).  Si lo hiciera, el primer @code{%@}} daría por
596 terminado @emph{los dos} comentarios de bloque.  El siguiente
597 fragmento muestra algunos posibles usos para los comentarios:
598
599 @example
600 % a continuación van las notas de campanitas del lugar
601   c4 c g' g a a g2
602
603 %@{
604   Esta línea y las notas que aparecen más abajo
605   se ignoran, por estar dentro de un
606   comentario de bloque.
607
608   f4 f e e d d c2
609 %@}
610 @end example
611
612 @end itemize
613
614
615 @node Tratar con los errores
616 @section Tratar con los errores
617 @translationof Dealing with errors
618
619 @cindex depuración de errores
620
621 A veces, LilyPond no produce el resultado esperado.  Esta sección
622 aporta algunos enlaces para ayudarle a resolver los problemas que
623 pudiera encontrar.
624
625 @menu
626 * Consejos generales de solución de problemas::
627 * Algunos errores comunes::
628 @end menu
629
630 @node Consejos generales de solución de problemas
631 @subsection Consejos generales de solución de problemas
632 @translationof General troubleshooting tips
633
634 La solución de problemas en LilyPond puede ser un desafío para las
635 personas acostumbradas a los interfaces gráficos, porque es posible
636 crear archivos de entrada inválidos.  Cuando esto ocurre, la mejor
637 forma de identificar y resolver el problema es aplicar un enfoque
638 lógico.  Se dan algunas guías para ayudarle a aprender a hacerlo, en
639 @rprogram{Solución de problemas}.
640
641
642 @node Algunos errores comunes
643 @subsection Algunos errores comunes
644 @translationof Some common errors
645
646 @cindex comunes, errores
647 @cindex errores comunes
648
649 Existen algunos errores comunes que son difíciles de solucionar si nos
650 basamos solamente en los mensajes de error que se nos presentan.
651 Éstos se describen en @rprogram{Errores comunes}.
652
653
654 @node Cómo leer los manuales
655 @section Cómo leer los manuales
656 @translationof How to read the manuals
657
658 Esta sección muestra cómo leer la documentación de forma eficiente, y
659 presenta algunas interesantes funcionalidades interactivas de la
660 versión en línea.
661
662 @menu
663 * Material omitido::
664 * Ejemplos con enlace::
665 * Panorámica de los manuales::
666 @end menu
667
668
669 @node Material omitido
670 @subsection Material omitido
671 @translationof Omitted material
672
673
674 @cindex cómo leer el manual
675 @cindex manual, lectura del
676 @cindex leer el manual
677 @cindex ejemplos, pulsar
678 @cindex pulsar sobre los ejemplos
679 @cindex consejos para construir archivos
680 @cindex plantillas
681 @cindex construir archivos, consejos
682 @cindex archivos, consejos para construir
683
684 Como ya vimos en @ref{Trabajar sobre los archivos de entrada}, el
685 código de entrada de LilyPond debe estar rodeado de llaves @code{@{ @}} o de
686 @q{@w{@code{@bs{}relative c'' @{ @dots{} @}}}}.  Durante el resto del presente
687 manual, la mayor parte de los ejemplos omitirán las llaves.  Para
688 reproducir los ejemplos, deberá copiar y pegar la entrada que se
689 muestra, pero @strong{deberá} escribir el @q{@w{@code{@bs{}relative c'' @{ @dots{} @}}}},
690 de la siguiente forma:
691
692 @example
693 \relative c'' @{
694   @dots{}aquí va el ejemplo@dots{}
695 @}
696 @end example
697
698 ¿Por qué omitir las llaves? Casi todos los ejemplos del presente
699 manual se pueden insertar en medio de un fragmento mayor de música.
700 Para estos ejemplos no tiene ningún sentido añadir
701 @q{@w{@code{@bs{}relative c'' @{ @dots{} @}}}}
702 (¡no debería poner un @code{\relative} dentro de otro
703 @code{\relative}!); si hubiésemos incluido
704 @q{@w{@code{@bs{}relative c'' @{ @dots{} @}}}}
705 rodeando a cada uno de los ejemplos, usted no podría copiar un
706 ejemplo pequeño procedente de la documentación y pegarlo dentro de su
707 propia pieza.  La mayoría querrá insertar el código dentro de una
708 pieza más grande, por eso hemos formateado el manual de esta manera.
709
710 Asimismo, recuerde que todo archivo de LilyPond debe llevar un
711 enunciado @code{\version}.  Dado que los ejemplos de los manuales
712 son fragmentos de código y no archivos completos, el enunciado
713 @code{\version} se omite.  De todas formas, debemos acostumbrarnos
714 a incluirlo en nuestros documentos.
715
716 @node Ejemplos con enlace
717 @subsection Ejemplos con enlace
718 @translationof Clickable examples
719
720 @warning{Esta funcionalidad sólo está disponible en los manuales en
721 HTML.}
722
723 Muchas personas aprenden a utilizar programas probando y enredando con
724 ellos.  Esto también puede hacerse con LilyPond.  Si hace clic sobre
725 una imagen en la versión en HTML de este manual, podrá ver la entrada
726 exacta de LilyPond que se utilizó para generar esa imagen.  Pruébelo
727 sobre esta imagen:
728
729 @c no verbatim here
730 @c KEEP LY
731 @lilypond[quote]
732 \relative c'' {
733   c4-\markup { \bold \huge { Haga clic aquí. } }
734 }
735 @end lilypond
736
737 Cortando y pegando todo lo que se encuentra dentro de la sección
738 @qq{ly snippet} (fragmento de tipo ly), tendrá una plantilla inicial
739 para sus experimentos. Para poder ver exactamente el mismo resultado
740 (con igual anchura de línea y todo), copie todo lo que está desde
741 @qq{Start cut-&-pastable section} hasta el final del archivo.
742
743
744 @ignore
745 This is item 825
746
747 @n ode Navegación con el teclado
748 @s ubsection Navegación con el teclado
749 @translationof Keyboard navigation
750
751 @warning{Esta posibilidad sólo está disponible en los manuales en
752 HTML.}
753
754 @c TODO: once this is figured out, insert it here.
755
756 Estamos trabajando sobre esta funcionalidad.
757 @end ignore
758
759 @node Panorámica de los manuales
760 @subsection Panorámica de los manuales
761 @translationof Overview of manuals
762
763 Existe abundantísima documentación sobre LilyPond.  Con frecuencia,
764 los nuevos usuarios se encuentran desorientados respecto a qué parte o
765 partes deben leer, y ocasionalmente pasan por alto la lectura de
766 partes de importancia vital.
767
768 @warning{Por favor: no se salte las partes importantes de la
769 documentación.  Le resultará mucho más difícil comprender las
770 secciones subsiguientes.}
771
772 @itemize
773
774 @item
775 @strong{Antes de intentar hacer @emph{cualquier cosa}}: lea el
776 @ref{Tutorial} del manual de Aprendizaje, y la sección @ref{Notación
777 corriente}.  Si encuentra términos musicales que no reconoce,
778 búsquelos en el @rglosnamed{Top, Glosario}.
779
780 @item
781 @strong{Antes de tratar de escribir una pieza completa de música}: lea
782 la sección @ref{Conceptos fundamentales} del manual de Aprendizaje.
783 Después, le vendrá bien consultar las secciones correspondientes de la
784 @rusernamed{Top, Referencia de la notación}.
785
786 @item
787 @strong{Antes de tratar de modificar los resultados predeterminados}:
788 lea la sección @ref{Trucar la salida} del manual de Aprendizaje.
789
790 @item
791 @strong{Antes de afrontar un proyecto grande}: lea la sección
792 @rprogramnamed{Suggestions for writing files,Sugerencias para escribir
793 archivos de entrada de LilyPond} del manual de Utilización del
794 programa.
795
796 @end itemize