]> git.donarmstrong.com Git - lilypond.git/blob - Documentation/nl/learning/tutorial.itely
Doc: convert-ly all docs.
[lilypond.git] / Documentation / nl / learning / tutorial.itely
1 @c -*- coding: utf-8; mode: texinfo; fill-column: 60 -*-
2 @ignore
3     Translation of GIT committish: 66dd932f6519b7913400a838c5efbc5407e06cd8
4
5     When revising a translation, copy the HEAD committish of the
6     version that you are working on.  For details, see the Contributors'
7     Guide, node Updating translation committishes..
8 @end ignore
9
10 @c Translator: Jan Nieuwenhuizen
11 @c Translation checker:
12 @c Translation checker committish:
13
14 @include included/generating-output.itexi
15
16 @c \version "2.13.36"
17
18 @node Leerboek
19 @translationof Tutorial
20 @chapter Leerboek
21
22 Dit hoofdstuk is de basisinleiding voor het werken met
23 LilyPond.
24
25 @menu
26 * Het compileren van een bestand::
27 * Het schrijven van invoerbestanden::
28 * Omgaan met foutmeldingen::
29 * Het lezen van de handleidingen::
30 @end menu
31
32 @node Het compileren van een bestand
33 @translationof Compiling a file
34 @section Het compileren van een bestand
35
36 Deze paragraaf introduceert het @qq{compileren}---het
37 verwerken van LilyPond-invoerbestanden (geschreven door
38 jouzelf) voor het produceren van uitvoerbestanden.
39
40 @menu
41 * Invoer schrijven::
42 * MacOS X::
43 * Windows::
44 * Commandoregel::
45 @end menu
46
47 @node Invoer schrijven
48 @translationof Entering input
49 @subsection Invoer schrijven
50
51 @cindex compileren
52 @cindex eerste voorbeeld
53 @cindex voorbeeld, eerste
54 @cindex hoofdlettergevoelig
55
56 @qq{Compileren} is de term die gebruikt wordt voor het
57 verwerken van een invoerbestand in LilyPond-formaat voor het
58 produceren van één of meer uitvoerbestanden.
59 Uitvoerbestanden zijn gewoonlijk PDF (om te printen of te
60 bekijken), MIDI (om af te spelen), en PNG (for online
61 gebruik).  LilyPond-invoerbestanden zijn gewone
62 tekstbestanden.
63
64 Dit is een voorbeeld van een eenvoudig invoerbestand:
65
66 @example
67 \version "@w{@version{}}"
68 @{
69   c' e' g' e'
70 @}
71 @end example
72
73 De grafische uitvoer is:
74
75 @c  in this case we don't want verbatim
76 @lilypond[quote]
77 {
78   c' e' g' e'
79 }
80 @end lilypond
81
82 @warning{Noten en liedteksten in LilyPond invoer moeten
83 altijd binnen @w{@strong{@{ accolades @}}} staan.  Om
84 ambiguïteit te voorkomen moeten deze accolades altijd los
85 staan, d.w.z. omgeven zijn door witruimte, of aan het begin
86 of einde van een regel staan.  In sommige voorbeelden in
87 deze handleiding zijn ze weggelaten, maar vergeet ze niet te
88 gebruiken in je eigen muziek!  Voor meer informatie over hoe
89 voorbeelden worden afgebeeld in deze handleiding, zie
90 @ref{Het lezen van de handleidingen}.}
91
92 LilyPond-invoer is @strong{hoofdlettergevoelig}.
93 @w{@samp{@{ c d e @}}} is geldige invoer; @w{@samp{@{ C D E
94 @}}} zal een foutmelding geven.
95
96
97 @smallspace
98
99 @subheading Het produceren van uitvoer
100
101 @cindex PDF-bestand
102 @cindex muziek weergeven
103 @cindex tekst-editors
104
105 Hoe je uitvoer produceert, is afhankelijk van je operating
106 systeem en van de programma's die je gebruikt.
107
108 @itemize
109
110 @item
111 @ref{MacOS X, @sourceimage{logo-macosx,,,}}
112 @ref{MacOS X, MacOS X} (grafisch)
113
114 @item
115 @ref{Windows, @sourceimage{logo-windows,,,}}
116 @ref{Windows, Microsoft Windows} (grafisch)
117
118 @item
119 @ref{Commandoregel, @sourceimage{logo-linux,,,}
120 @sourceimage{logo-freebsd,,,}
121 @sourceimage{logo-macosx,,,}
122 @sourceimage{logo-windows,,,}
123 }
124 @ref{Commandoregel, Alle operating systemens} (commandoregel)
125
126 @end itemize
127
128 Er zijn verscheidene andere tekst-editors beschikbaar met
129 specifieke LilyPond-ondersteuning.  Voor meer informatie,
130 zie @rweb{Eenvoudiger bewerken}.
131
132 @warning{Als je LilyPond voor de allereerste keer draait,
133 kan dat een minuut of twee duren omdat alle systeemfonts
134 eerst moeten worden geanalyseerd.  De volgende keer draait
135 LilyPond veel sneller!}
136
137
138 @node MacOS X
139 @subsection MacOS X
140
141 @cindex draaien van LilyPond onder MacOS X
142 @cindex MacOS X, draaien van LilyPond
143
144 @lilypadOSX
145
146
147 @node Windows
148 @subsection Windows
149
150 @cindex draaien van LilyPond onder Windows
151 @cindex Windows, draaien van LilyPond
152
153 @lilypadWindows
154
155
156 @node Commandoregel
157 @translationof Command-line
158 @subsection Commandoregel
159
160 @cindex draaien van LilyPond onder Unix
161 @cindex Unix, draaien van LilyPond
162
163 @lilypadCommandLine
164
165 @node Het schrijven van invoerbestanden
166 @translationof How to write input files
167 @section Het schrijven van invoerbestanden
168
169 Deze paragraaf introduceert de LilyPond basissyntax om je op
170 weg te helpen bij het schrijven van invoerbestanden.
171
172 @menu
173 * Eenvoudige notatie::
174 * Werken met invoerbestanden::
175 @end menu
176
177
178 @node Eenvoudige notatie
179 @translationof Simple notation
180 @subsection Eenvoudige notatie
181
182 @cindex eenvoudige notatie
183 @cindex notatie, eenvoudig
184
185 LilyPond kan bepaalde notatie-elementen automatisch
186 toevoegen.  In het volgende voorbeeld hebben we slechts vier
187 toonhoogten ingevoerd, maar LilyPond heeft een
188 muzieksleutel, een maatsoort, en nootlengtes toegevoegd.
189
190 @lilypond[verbatim,quote]
191 {
192   c' e' g' e'
193 }
194 @end lilypond
195
196 @noindent
197 Dit gedrag kan worden veranderd, maar in de meeste gevallen
198 zijn deze automatische waarden heel handig.
199
200
201 @subheading Toonhoogten
202
203 @cindex toonhoogten
204 @cindex relatieve modus
205 @cindex apostrof, enkel aanhalingsteken
206 @cindex komma
207 @cindex toevallige tekens en relatieve modus
208 @cindex relatieve modus, en toevallige tekens
209
210 @funindex \relative
211 @funindex relative
212 @funindex '
213 @funindex ,
214
215 Terminologie: @rglos{pitch}, @rglos{interval},
216 @rglos{scale}, @rglos{middle C}, @rglos{octave},
217 @rglos{accidental}.
218
219 De meest eenvoudige manier voor het invoeren van noten is de
220 @code{\relative} modus.  In deze modus wordt het octaaf
221 automatisch gekozen door de aanname dat een opvolgende noot
222 altijd zo dicht mogelijk bij de vorige noot geplaatst moet
223 worden, d.w.z., hij wordt geplaatst in het octaaf dat binnen
224 drie notenbalk-ruimtes ten opzichte van de vorige noot valt.
225 We beginnen met het invoeren van het meest elementaire stuk
226 muziek, een @notation{toonladder}, waarin elke noot precies
227 één notenbalk-ruimte hoger is dan de vorige noot.
228
229 @lilypond[verbatim,quote]
230 % zet het beginpunt op de centrale C
231 \relative c' {
232   c d e f
233   g a b c
234 }
235 @end lilypond
236
237 De eerste noot is de @notation{centrale C}.  Elke volgende
238 noot wordt zo dicht mogelijk geplaatst ten op zichte van de
239 vorige noot -- of anders gezegd, de eerste @code{c} is de C
240 het dichtst bij de centrale C.  Die wordt gevolgd door
241 dichtstbijzijnde D ten opzichte van de vorige noot.  We
242 kunnen melodieën maken die grotere intervallen hebben, nog
243 steeds uitsluitend gebruikmakend van de {\relative} modus:
244
245 @lilypond[verbatim,quote]
246 \relative c' {
247   d f a g
248   c b f d
249 }
250 @end lilypond
251
252 @noindent
253 De eerste noot van de melodie hoeft niet te beginnen met de
254 noot die de begintoonhoogte aangeeft.  In bovenstaand
255 voorbeeld is de eerste noot -- de @code{d} -- de
256 dichtstbijzijnde D bij de centrale C.
257
258 Door het toevoegen (of weghalen) van apostrofs @code{'} of
259 komma's @code{,} van het @q{@w{@code{@bs{}\relative
260 c'}}}-commando, kunnen we het beginoctaaf veranderen:
261
262 @lilypond[verbatim,quote]
263 % één octaaf boven de centrale C
264 \relative c'' {
265   e c a c
266 }
267 @end lilypond
268
269 Relatieve modus kan aanvankelijk wat verwarrend zijn, maar
270 het is de eenvoudigste manier om melodieën in te voeren.
271 Laten we eens kijken hoe het uitrekenen van relatieve
272 afstanden in de praktijk werkt.  Beginnend met een B, die in
273 de vioolsleutel op de middelste lijn staat, kan je een C, D
274 en E bereiken binnen 3 notenbalk-ruimten omhoog, een een A,
275 G en F binnen 3 notenbalk-ruimten omlaag.  Dus als de noot
276 na een B een C, D of E is, wordt aangenomen dat die hoger is
277 dan de B, en van een A, G of F wordt aangenomen dat hij
278 lager is.
279
280 @lilypond[verbatim,quote]
281 \relative c'' {
282   b c  % c is 1 notenbalk-ruimte omhoog, dus de c hoger
283   b d  % d is 2 omhoog of 5 omlaag, dus de d hoger
284   b e  % e is 3 omhoog of 4 omlaag, dus de e hoger
285   b a  % a is 6 omhoog of 1 omlaag, dus de a lager
286   b g  % g is 5 omhoog of 2 omlaag, dus de g lager
287   b f  % f is 4 omhoog of 3 omlaag, dus de f lager
288 }
289 @end lilypond
290
291 Precies hetzelfde gebeurt als een van deze noten verhoogd of
292 verlaagd is met een kruis of mol.  @notation{Toevallige
293 tekens} worden @strong{volledig genegeerd} in de berekening
294 van de relatieve positie.  Exact dezelfde
295 notenbalkruimte-telling wordt gedaan voor een noot op
296 willekeurig welke andere plaats op de notenbalk.
297
298 Om intervallen te gebruiken die groter zijn dan drie
299 notenbalk-ruimten, kunnen we het @notation{octaaf} verhogen
300 door een apostrof @code{'} (of enkel aanhalingsteken) aan de
301 notenaam toe te voegen.  We kunnen het octaaf verlagen door
302 een komma @code{,} aan de notenaam toe toe voegen.
303
304 @lilypond[verbatim,quote]
305 \relative c'' {
306   a a, c' f,
307   g g'' a,, f'
308 }
309 @end lilypond
310
311 @noindent
312 Voor het veranderen van een noot met twee (of meer!) octaven
313 gebruiken we meerdere @code{''} of @code{,,} -- maar let op
314 dat je twee enkele apostrofs of aanhalingstekens gebruikt
315 @code{''} en niet één dubbel aanhalingsteken @code{"}@tie{}!
316 @c " - keeps quotes in order for context-sensitive editor -td
317
318 @subheading Nootlengten (ritmen)
319
320 @cindex nootlengten
321 @cindex lengten
322 @cindex ritmen
323 @cindex hele noot
324 @cindex halve noot
325 @cindex kwartnoot
326 @cindex gepuncteerde noot
327 @cindex lengten noteren
328
329 Terminologie: @rglos{beam}, @rglos{duration},
330 @rglos{whole note}, @rglos{half note}, @rglos{quarter note},
331 @rglos{dotted note}.
332
333 De @notation{lengte} van een noot wordt aangegeven door een
334 getal na de notenaam: @code{1} voor een @notation{hele
335 noot}, @code{2} voor een @notation{halve noot}, @code{4}
336 voor een @notation{kwartnoot} enzovoorts.
337 @notation{Waardestrepen} worden automatisch toegevoegd.
338
339 Als je geen lengte aangeeft, word te vorige lengte ook
340 gebruikt voor de volgende noot.  De lengte van de eerste
341 noot is standaard een kwartnoot.
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 Voor het maken van @notation{gepuncteerde noten} voeg je een
352 punt @code{.} toe aan het lengte-getal.  De lengte van een
353 gepuncteerde noot moet expliciet worden aangegeven (d.w.z.,
354 altijd ook met een getal).
355
356 @lilypond[verbatim,quote]
357 \relative c'' {
358   a4 a a4. a8
359   a8. a16 a a8. a8 a4.
360 }
361 @end lilypond
362
363
364 @subheading Rusten
365
366 @cindex rust
367 @cindex rusten noteren
368
369 Terminologie: @rglos{rest}.
370
371 Een @notation{rust} voer je in net zoals een noot met de
372 naam @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 Maatsoort
383
384 @cindex maatsoort
385
386 @funindex \time
387 @funindex time
388
389 Terminologie: @rglos{time signature}.
390
391 De @notation{maatsoort} kun je aangeven met het @code{\time}
392 commando:
393
394 @lilypond[verbatim,quote]
395 \relative c'' {
396   \time 3/4
397   a4 a a
398   \time 6/8
399   a4. a
400   \time 4/4
401   a4 a a a
402 }
403 @end lilypond
404
405
406 @subheading Sleutel
407
408 @cindex sleutel
409 @cindex viool
410 @cindex sopraan
411 @cindex alt
412 @cindex tenor
413 @cindex bas
414
415 @funindex \clef
416 @funindex clef
417
418 Terminologie: @rglos{clef}.
419
420 De @notation{sleutel} kun je aangeven met het @code{\clef}
421 commando:
422
423 @lilypond[verbatim,quote]
424 \relative c' {
425   \clef "treble"
426   c1
427   \clef "alto"
428   c1
429   \clef "tenor"
430   c1
431   \clef "bass"
432   c1
433 }
434 @end lilypond
435
436
437 @subheading Alles samen
438
439 Hier is een klein voorbeeld dat al deze onderdelen samen
440 toont:
441
442 @lilypond[verbatim,quote]
443 \relative c, {
444   \clef "bass"
445   \time 3/4
446   \clef "bass"
447   c2 e8 c'
448   g'2.
449   f4 e d
450   c4 c, r
451 }
452 @end lilypond
453
454
455 @seealso
456 Notatiehandleiding: @ruser{Writing pitches},
457 @ruser{Writing rhythms}, @ruser{Writing rests},
458 @ruser{Time signature}, @ruser{Clef}.
459
460
461 @node Werken met invoerbestanden
462 @translationof Working on input files
463 @subsection Werken met invoerbestanden
464
465 @cindex accolades
466 @cindex haakjes, gekruld
467 @cindex commentaar
468 @cindex regelcommentaar
469 @cindex commentaar, regel
470 @cindex blokcommentaar
471 @cindex commentaar, blok
472 @cindex hoofdlettergevoelig
473 @cindex witruimteongevoelig
474 @cindex expressies
475 @cindex versie aangeven
476 @cindex versie
477 @cindex versienummer
478
479 @funindex \version
480 @funindex { ... }
481 @funindex %
482 @funindex %@{ ... %@}
483
484 LilyPond-invoerbestanden lijken op broncodebestanden van de
485 meest gebruikte programmeertalen.  Ze bevatten een
486 versie-uitdrukking, zijn hoofdlettergevoelig, en witruimte
487 wordt grotendeels genegeerd.  Expressies worden gevormd met
488 accolades @w{@code{@{ @}}}, en commentaren worden aangegeven met
489 @code{%} of @w{@code{%@{ @dots{} %@}}}@tie{}.
490
491 Als de vorige alinea totale onzin lijkt, geen probleem!  We
492 leggen hieronder uit wat al deze termen betekenen:
493
494 @itemize
495
496 @item
497 @strong{Versie-uitdrukking}:
498 Elk LilyPond-bestand zou een versie-uitdrukking moeten
499 hebben.  Een versie-uitdrukking is een regel die aangeeft
500 voor welke versie van LilyPond het bestand is geschreven,
501 zoals in onderstaand voorbeeld:
502
503 @example
504 \version "@w{@version{}}"
505 @end example
506
507 De versie-uitdrukking wordt altijd helemaal bovenin het
508 LilyPond-bestand gezet.
509
510 Er zijn twee redenen waarom de versie-uitdrukking belangrijk
511 is.  Ten eerste maakt het een automatische update van het
512 invoerbestand mogelijk voor wanneer de syntax van een
513 nieuwere LilyPond-versie verandert.  Ten tweede geeft het de
514 LilyPond-versie aan die nodig is om het bestand te
515 compileren.
516
517 Als de versie-uitdrukking wordt weggelaten uit een
518 invoerbestand, zal LilyPond een waarschuwing geven tijdens
519 het compileren van het bestand.
520
521 @item
522 @strong{Hoofdlettergevoelig}:
523 het maakt uit of je een letter als kleine letter typt (bijv.
524 @w{@code{a, b, s, t}}) of als hoofdletter (bijv. @w{@code{A,
525 B, S, T}}).  Noten zijn met een kleine letter: @w{@samp{@{ c
526 d e @}}} is geldige invoer; @w{@samp{@{ C D E @}}} geeft een
527 foutmelding.
528
529 @item
530 @strong{Witeruimteongevoelig}:
531 het maakt niet uit hoeveel spaties (of tabs of nieuwe
532 regels) je invoegt.  @w{@samp{@{ c d e @}}} betekent
533 hetzelfde als @w{@samp{@{ c @tie{}} @tie{} @tie{} d e @}} en
534 als:
535
536 @example
537 @{ c4                       d
538                    e   @}
539 @end example
540
541 @noindent
542 Het laatste voorbeeld leest natuurlijk erg lastig.  Een
543 goede vuistregel is om blokken code in te springen met twee
544 spaties:
545
546 @example
547 @{
548   c4 d e
549 @}
550 @end example
551
552 Echter, vele syntactische elementen @emph{moeten} van elkaar
553 gescheiden worden door witruimte.  Anders gezegd, witruimte
554 kan altijd worden @emph{ingevoegd}, maar niet altijd worden
555 @emph{weggehaald}.  Omdat ontbrekende witruimte voor vreemde
556 foutmeldingen kan zorgen, is het verstandig altijd witruimte
557 te gebruiken voor en na elk syntactisch element,
558 bijvoorbeeld, voor en na elke accolade.
559
560 @item
561 @strong{Uitdrukkingen}:
562 om elk stuk LilyPond-invoer moeten @strong{@{@tie{}accolades@tie{}@}}
563 heen staan.  Deze haakjes vertellen LilyPond dat de invoer
564 een enkele muziekuitdrukking is, net als de haakjes
565 @code{()} bij wiskunde.  De accolades moeten altijd los
566 staan, d.w.z. omgeven zijn door witruimte, of aan het begin
567 of einde van een regel staan om ambiguïteiten te voorkomen.
568
569 Een LilyPond-commando gevolgd door een enkele uitdrukking
570 tussen accolades (zoals @q{@w{@code{@bs{}relative c' @{
571 @dots{} @}}}}) telt ook als een enkele muziekuitdrukking.
572
573 @cindex commentaren
574 @cindex regercommentaar
575 @cindex blokcommentaar
576 @item
577 @strong{Commentaren}:
578 een commentaar is een opmerking voor de lezer van de
579 muziekinvoer; het wordt genegeerd tijdens het verwerken, dus
580 het heeft geen effect op de geprinte uitvoer.  Er zijn twee
581 soorten commentaar.  Het procentteken @code{%} markeert het
582 begin van een regelcommentaar; alles na een @code{%} op die
583 regel wordt genegeerd.  Een regelcommentaar wordt altijd
584 @emph{boven} de regel geplaatst waar hij bij hoort.
585
586 @example
587 a4 a a a
588 % dit commentaar slaat op de B's
589 b2 b
590 @end example
591
592 Een blokcommentaar markeert een heel stuk van de
593 muziekinvoer als commentaar.  Alles wat tussen @code{%@{} en
594 @code{%@}} staat, wordt genegeerd.  Echter, blockcommentaren
595 kunnen niet worden ge@q{nest}.  Dat betekent dat je een
596 blokcommentaar niet binnen een ander blokcommentaar kunt
597 zetten.  Als je dat toch probeert, zal de eerste @code{%@}}
598 @emph{beide} blokcommentaren sluiten.  Het volgende fragment
599 toont het gebruik van commentaren:
600
601 @example
602 % noten voor twinkle twinkle volgen
603   c4 c g' g a a g2
604
605 %@{
606   Deze regel, en de noten hieronder worden genegeerd,
607   omdat ze in een blokcommentaar staan.
608
609   f4 f e e d d c2
610 %@}
611 @end example
612
613 @end itemize
614
615 @node Omgaan met foutmeldingen
616 @section Omgaan met foutmeldingen
617 @translationof Dealing with errors
618
619 @cindex problemen oplossen
620 @cindex oplossen van problemen
621
622 Soms produceert LilyPond niet de uitvoer die je verwachtte.
623 Deze paragraaf geeft enkele verwijzingen om je te helpen met
624 het oplossen van problemen die je tegen zou kunnen komen.
625
626 @menu
627 * Algemene tips voor het oplossen van problemen::
628 * Enkele algemene fouten::
629 @end menu
630
631 @node Algemene tips voor het oplossen van problemen
632 @subsection Algemene tips voor het oplossen van problemen
633 @node General troubleshooting tips
634
635 Het oplossen van LilyPond-problemen kan een uitdaging als je
636 gewend bent aan een grafische gebruikers interface, omdat
637 ongeldige invoerbestanden kunnen worden gemaakt.  Zodra dit
638 gebeurt, is een logische aanpak de beste manier om het
639 probleem te identificeren en op te lossen.  Enkele
640 richtlijnen om je te helpen dit te leren, worden gegeven in
641 @rprogram{Troubleshooting}.
642
643 @node Enkele algemene fouten
644 @subsection Enkele algemene fouten
645 @translationof Some common errors
646
647 @cindex algemene fouten
648 @cindex fouten, algemene
649
650 Er zijn een paar algemene fouten die moeilijk op te lossen
651 zijn als je alleen afgaat op de foutmelding die wordt
652 getoond.  Deze fouten worden beschreven in @rprogram{Common
653 errors}.
654
655
656 @node Het lezen van de handleidingen
657 @translationof How to read the manuals
658 @section Het lezen van de handleidingen
659
660 Deze paragraaf laat zien hoe je de documentatie efficient
661 kunt lezen, en introduceert enkele nuttige interactieve
662 functies die beschikbaar zijn in de online-versie.
663
664 @menu
665 * Weggelaten materiaal::
666 * Klikbare voorbeelden::
667 * Overzicht van handleidingen::
668 @end menu
669
670
671 @node Weggelaten materiaal
672 @translationof Omitted material
673 @subsection Weggelaten materiaal
674
675
676 @cindex hoe de handleidingen te lezen
677 @cindex handleiding, lezen
678 @cindex het lezen van de handleiding
679 @cindex voorbeelden, aanklikbaar
680 @cindex klikbare voorbeelden
681 @cindex tips voor het bouwen van bestanden
682 @cindex sjablonen
683 @cindex bouwen van bestanden, tips
684 @cindex bestanden, tips om te maken
685
686 LilyPond-invoer moet tussen @code{@{ @}}-tekens of
687 @q{@w{@code{@bs{}relative c'' @{ @dots{} @}}}} staan, zoals
688 we gezien hebben in @ref{Werken met invoerbestanden}.  Vanaf
689 nu zullen we dit weglaten uit de meeste voorbeelden in de
690 handleiding.  Als je die voorbeelden wilt gebruiken, kun je
691 you de getoonde invoer kopiëren en plakken, maar je
692 @strong{moet} zelf wel @q{@w{@code{@bs{}relative c'' @{ @dots{} @}}}}
693 toevoegen, dus:
694
695 @example
696 \relative c'' @{
697   @dots{}plak hier het voorbeeld@dots{}
698 @}
699 @end example
700
701 Waarom laten we die accolades weg?  De meeste voorbeelden in
702 deze handleiding kunnen midden in een langer stuk muziek
703 worden ingevoegd.  Bij zulke voorbeelden is het onzinnig om
704 @q{@w{@code{@bs{}relative c'' @{ @dots{} @}}}} toe te voegen
705 -- je moet een @code{\relative} niet binnen een ander
706 @code{\relative} zetten!  Als we @q{@w{@code{@bs{}relative
707 c'' @{ @dots{} @}}}} om elk voorbeeld heen zouden zetten,
708 zou je een klein documentatievoorbeeld niet zomaar kunnen
709 kopiëren en in een langer stuk kunnen plakken.  De meeste
710 mensen willen materiaal toevoegen aan een bestaand stuk, dus
711 zorgen we dat de handleiding daarvoor het meest geschikt is.
712
713 Verder moet elk LilyPond-bestand eigenlijk ook een
714 @code{\version}-uitdrukking hebben.  Omdat de voorbeelden in
715 de handleidingen fragmenten zijn, en geen volledige
716 bestanden, wordt de @code{\version}-uitdrukking weggelaten.
717 Maar je zou er een gewoonte van moeten maken ze in je
718 bestanden op te nemen.
719
720 @node Klikbare voorbeelden
721 @translationof Clickable examples
722 @subsection Klikbare voorbeelden
723
724 @warning{Deze functie is uitsluitend beschikbaar in de
725 HTML-handleidingen.}
726
727 Veel mensen leren programma's door te proberen en er wat mee
728 te prutsen.  Dat kan ook goed met LilyPond.  Als je op een
729 afbeelding in de HTML-versie van deze handleiding klikt, zie
730 je de exacte LilyPond-invoer die gebruikt is om die
731 afbeelding te genereren.  Probeer het maar met deze
732 afbeelding:
733
734 @c no verbatim here
735 @lilypond[quote]
736 \relative c'' {
737   c4-\markup { \bold \huge { Klik hier. } }
738 }
739 @end lilypond
740
741 Door het knippen en plakken van het gehele @qq{ly
742 snippet}-gedeelte, heb je een sjabloon om je experiment mee
743 te beginnen.  Om precies dezelde uitvoer te krijgen
744 (inclusief regelbreedte en alles), kopiëer alles vanaf
745 @qq{Start cut-&-pastable section} tot aan het einde van het
746 bestand.
747
748
749 @ignore
750 This is item 825
751
752 @n ode Keyboard navigation
753 @s ubsection Keyboard navigation
754
755 @warning{This features is only available in the HTML manuals.}
756
757 @c TODO: once this is figured out, insert it here.
758
759 We are currently working on this feature.
760 @end ignore
761
762 @node Overzicht van handleidingen
763 @translationof Overview of manuals
764 @subsection Overzicht van handleidingen
765
766 Er is veel documentatie voor LilyPond.  Nieuwe gebruikers
767 weten soms niet helemaal wat ze nu wel en niet zouden moeten
768 lezen, en soms slaan ze essentiële delen over.
769
770 @warning{Sla liever geen belangrjke delen van de
771 documentatie over.  Dat maakt het veel lastiger vinden om
772 het vervolg te begrijpen.}
773
774 @itemize
775
776 @item
777 @strong{Voordat je ook maar @emph{iets}} probeert: lees uit
778 de Beginnershandleiding het @ref{Leerboek}, en @ref{Algemene
779 muzieknotatie}.  Als je muziektermen tegenkomt die je niet
780 herkent, zoek ze dan op in de @rglosnamed{Top,
781 Terminologie}.
782
783 @item
784 @strong{Voordat je een heel muziekstuk probeert te
785 schrijven}: lees uit de Beginnershandleiding de
786 @ref{Fundamentele concepten}.  Daarna wil je wellicht de
787 relevante delen van de @rusernamed{Top, Notatiehandleiding}
788 bekijken.
789
790 @item
791 @strong{Voordat je de standaarduitvoer probeert te
792 veranderen}: lees uit de Beginnershandleiding over
793 @ref{Tweaking output}.
794
795 @item
796 @strong{Voordat je een groot project begint}: lees uit de
797 Gebruikershandleiding @rprogram{Suggestions for writing
798 files}.
799
800 @end itemize