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