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