1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: hu -*-
4 Translation of GIT committish: ef7ee24e2aee81dd97888b4533ab7eae038ce666
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..
15 @translationof Tutorial
17 Tankönyvünk első leckéje bemutatja a LilyPond nyelvét, és elmagyarázza,
18 hogyan kell nyomtatható kottát előállítani.
22 * Bemeneti fájlok írása::
23 * Hogyan olvassuk a dokumentációt?::
26 @node Fájlok fordítása
27 @section Fájlok fordítása
28 @translationof Compiling a file
38 @subsection Zene bevitele
39 @translationof Entering input
43 @cindex kis- és nagybetűk különbsége
45 A LilyPond bemeneti fájljai egyszerű szöveges állományok.
46 Egy kotta létrehozásához egy bemeneti fájlban (másnéven forrásfájlban) kell
47 azt szöveges formában leírni.
48 @qq{Fordítás} a neve annak a folyamatnak, melynek során egy LilyPond
49 formátumú forrásfájlból egy nyomtatható kotta és (szabadon választhatóan)
50 egy meghallgatható MIDI fájl áll elő.
52 Első példánk megmutatja, hogy néz ki egy egyszerű bemenet. A LilyPond
53 forrásfájlba ezt írva:
62 az alábbi eredményt kapjuk:
64 @c in this case we don't want verbatim
71 @warning{A LilyPondban a hangok és a dalszöveg köré mindig
72 @strong{@{ kapcsos zárójeleket @}} kell írni.
73 A kapcsos zárójeleket legtöbbször szóközzel vesszük körül, hacsak
74 a sor elején vagy végén nem állnak, hogy környezetükkel ne folyjanak
75 egybe, így kétértelműséget okozván. A tankönyv példáiban olykor a
76 rövidség kedvéért elhagyjuk a kapcsos zárójeleket, de a forrásfájlokban
77 nem szabad elfelejteni kitenni őket! A @ref{Hogyan olvassuk a dokumentációt?}
78 c. fejezetben olvasható több információ a tankönyv példáiról és megjelenítésük
81 Továbbá a LilyPond bemenete @strong{érzékeny a kis- és nagybetűk különbségére}:
82 @w{@code{@{ c d e @}}} érvényes bemenet; @w{@code{@{ C D E @}}} hibát
87 @subheading A kimenet megtekintése
91 @cindex szövegszerkesztők
92 @cindex Mac OS X, a LilyPond futtatása
93 @cindex Windows, a LilyPond futtatása
94 @cindex Linux, a LilyPond futtatása
95 @cindex Unix, a LilyPond futtatása
97 Ez a szakasz arról szól, hogy milyen parancsokat kell futtatni
98 a kotta előállításához és a kimenet megtekintéséhez a felhasználó operációs
101 Bizonyos szövegszerkesztőkbe beépíthető LilyPond támogatás, ami hatékonyabb
102 szerkesztést tesz lehetővé; erről a @rprogram{Text editor support} c.
105 @warning{Amikor a LilyPond első alkalommal fut, egy-két percig várni kell,
106 amíg megvizsgálja a rendszer betűtípusait. Ezután természetesen sokkal
107 gyorsabban fog futni!}
111 @translationof MacOS X
113 Ha elindítjuk a @command{LilyPond.app} alkalmazást, egy példaállományt látunk
114 megnyitva. Mentsük el (pl. @file{test.ly} néven az Asztalra), majd a
115 @w{@qq{Compile > Typeset File}} (@q{Fordítás > Kotta szedése}) menüpont segítségével fordítsuk le.
116 Ezután az eredményül kapott PDF fájl a képernyőn látható.
118 A következő parancsok, melyekre szükség lehet, a @qq{New} (@q{Új}) és az @qq{Open}
119 (@q{Megnyitás}) a @qq{File} (@q{Fájl}) menüben. A szerkesztés alatt levő fájlt a szedés előtt
120 mindig el kell menteni. Ha a feldolgozás során bármilyen hiba történt, a
121 naplóablakban láthatjuk a hibák leírását.
125 @translationof Windows
127 Windows alatt az Asztalon levő LilyPond ikonra duplán kattintva indíthatjuk el
128 a LilyPondot, mely először egy példafájlt nyit meg egy egyszerű
129 szövegszerkesztőben. Mentsük el (pl. @file{test.ly} néven az Asztalra),
130 majd kattintsunk rá duplán a lefordításához (az ikonja egy hangjegyre
131 hasonlít). Pár másodperc múlva létrejön egy @file{test.pdf} nevű fájl az
132 Asztalon. Ha erre duplán kattintunk, megtekinthetjük a nyomtatható kottát.
133 A @file{test.ly} fordításának másik módja, hogy egérrel ráhúzzuk a LilyPond
136 Egy létező @file{.ly} fájl szerkesztéséhez kattintsunk rá jobb gombbal, és
137 válasszuk az @qq{Edit source} (@q{Forrás szerkesztése}) menüpontot. Új kotta
138 írásához vagy a szerkesztőt futtassuk a fent leírt módon, majd válasszuk ki a
139 @qq{File > New} (@q{Fájl > Új}) parancsot, vagy jobb gombbal
140 kattintsunk az Asztalra, válasszuk az @q{Új > Szöveges dokumentum}
141 menüpontot, nevezzük át a fájlt a kívánt névre, és változtassuk meg a
142 kiterjesztését @file{.ly}-re. Ezután ugyanúgy szerkeszthetjük és
143 feldolgozhatjuk, ahogy eddig is tettük.
145 Ha duplán kattintunk egy @code{.ly} fájlra, nem csak egy PDF-et kapunk, hanem
146 egy @code{.log} kiterjesztésű naplófájlt is, amely a LilyPond futásáról
147 tartalmaz információkat. Hiba esetén ajánlatos megvizsgálni.
150 @subsection Parancssor
151 @translationof Command-line
153 Hozzunk létre egy fájlt @file{test.ly} néven, és írjuk bele a következőket:
161 A @file{test.ly} fájl feldolgozásához adjuk ki az alábbi parancsot:
168 Ekkor az alábbi kimenethez hasonlót láthatunk:
172 GNU LilyPond @version{}
175 Interpreting music...
176 Preprocessing graphical objects...
177 Finding the ideal number of pages...
178 Fitting music on 1 page...
180 Layout output to `test.ps'...
181 Converting to `test.pdf'...
184 @node Bemeneti fájlok írása
185 @section Bemeneti fájlok írása
186 @translationof How to write input files
189 * Egyszerű kottázás::
190 * A bemeneti fájlok jellemzői::
193 @node Egyszerű kottázás
194 @subsection Egyszerű kottázás
195 @translationof Simple notation
197 @cindex egyszerű lejegyzés
198 @cindex lejegyzés, egyszerű
200 A LilyPond bizonyos elemeket automatikusan hozzáad a kottához. A következő
201 példában csak négy hangmagasságot adunk meg, de a LilyPond kirakja a kulcsot
202 és az ütemmutatót, valamint a hangok hosszúságát alapértelmezetten negyednek
205 @lilypond[verbatim,quote]
212 Természetesen minden megváltoztatható, de a legtöbb esetben az alapbeállítás
215 @subheading Hangmagasság
221 @cindex módosítójelek és relatív mód
228 Fogalomtár: @rglos{pitch}, @rglos{interval},
229 @rglos{scale}, @rglos{middle C}, @rglos{octave},
232 A hangok beírásának legegyszerűbb módja a @code{\relative} mód.
233 Ebben a módban minden hang automatikusan abba az oktávba kerül,
234 melyben az előző hanghoz a legközelebb áll, vagyis legfeljebb
235 kvárt távolságra. Ennek szemléltetésére gépeljünk be egy zenei alapformulát,
236 egy @notation{skálát}, melyben minden hang szekund távolságra van az
237 előzőtől. (Figyelem: mivel angolul a h hang neve b, ezért a LilyPond forrásban
238 is mindig b-t kell írni h helyett!)
241 @lilypond[verbatim,quote]
242 % megadjuk, hogy az első viszonyítási hang egyvonalas c legyen
249 Itt a relatív mód első viszonyítási hangja az @notation{egyvonalas c}. Minden
250 hang az előzőhöz a lehető legközelebb helyezkedik el: az első @code{c} az
251 egyvonalas c-hez legközelebb eső c hangot jelenti, vagyis az egyvonalas c-t.
252 A második, d hang ehhez a hanghoz esik legközelebb, vagyis ugyanúgy az
253 egyvonalas oktávba kerül.
254 Legfeljebb kvárt nagyságú hangközöket tartalmazó dallamok tápláhatók be így a
257 @lilypond[verbatim,quote]
265 Természetesen nem szükséges, hogy a relatív mód első viszonyítási hangja
266 megegyezzen a tényleges első hanggal, ahogy az előző példában is láttuk, ahol
267 az első hang -- a @code{d} -- az egyvonalas c-hez legközelebb eső hang,
270 A @code{@w{\relative c' @{}} parancsban megadott első viszonyítási hanghoz
271 @code{'} vagy @code{,} karaktereket hozzáadva vagy elvéve
272 változtatható a kezdőoktáv:
275 @lilypond[verbatim,quote]
282 A relatív mód kezdetben bonyolultnak tűnhet, de valójában a legtöbb
283 dallamot így lehet legkönnyebben bevinni. Nézzük, hogyan néz ki a relatív
284 hangmagasság-számítás a gyakorlatban. A h hangról egy kvárton belül felfelé
285 a c, d és e hangok helyezkednek el, míg lefelé az a, g és f hangok. Tehát ha
286 egy h-t követő hang c, d vagy e, akkor a h fölé, míg ha a, g vagy f, akkor a
290 @lilypond[verbatim,quote]
292 b c % felfelé szekund, lefelé szeptim, így: felső c
293 b d % felfelé terc, lefelé szext, így: felső d
294 b e % felfelé kvárt, lefelé kvint, így: felső e
295 b a % felfelé szeptim, lefelé szekund, így: alsó a
296 b g % felfelé szext, lefelé terc, így: alsó g
297 b f % felfelé kvint, lefelé kvárt, így: alsó f
301 Pontosan ugyanez marad a működés, ha bármelyik hang előtt kereszt vagy bé áll.
302 A @notation{módosítójelek} a relatív magasságszámítás során @strong{egyáltalán
303 nem számítanak}. A számítás során csak a vonalrendszerben elfoglalt pozíciónak
304 (azaz a diatonikus magasságnak) van szerepe.
306 Kvártnál nagyobb hangközugrást úgy érhetünk el, hogy @code{'} vagy @code{,}
307 karaktereket helyezünk a hang után. Az @code{'} egy @notation{oktáv}nyi
308 emelkedést, a @code{,} egy oktávnyi süllyedést jelent.
310 @lilypond[verbatim,quote]
318 Amennyi karaktert használunk, annyi oktáv különbséget érhetünk el, pl.
319 @code{''} vagy @code{,,} két oktávnyi emelést, ill. süllyesztést jelent --
320 de vigyázzunk, soha ne használjunk idézőjelet (@code{"}) két aposztróf
321 (@code{''}) helyett! Ez ugyanaz a mechanizmus, amivel a relatív mód első
322 viszonyítási hangját módosíthatjuk.
325 @subheading Ritmusérték
327 @cindex hanghosszúság
335 Fogalomtár: @rglos{beam}, @rglos{duration},
336 @rglos{whole note}, @rglos{half note}, @rglos{quarter note},
339 A hangok @notation{ritmusértékét} a hangmagasság után írt számmal
340 határozhatjuk meg. @code{1} jelenti az egészkottát, @code{2} a
341 félkottát, @code{4} a negyedkottát és így tovább. A
342 @notation{gerendázást} automatikusan elvégzi a LilyPond.
344 Ha nincs megadva a hosszúság, az előző hang hossza marad érvényben.
345 Az első hang alapértelmezetten negyed hosszúságú.
347 @lilypond[verbatim,quote]
351 a16 a a a a32 a a a a64 a a a a a a a a2
355 A @notation{pontozott hangok} után annyi pontot (@code{.}) kell írni,
356 ahányszoros a pontozás. A pontozott hangok ritmusértékét mindig meg kell
359 @lilypond[verbatim,quote]
371 Fogalomtár: @rglos{rest}.
373 A @notation{szünetek} megadása hasonlóképpen történik, mint a hangoké,
374 csak a hangmagasság megjelölése helyett @code{r}@tie{} betűt kell írni:
376 @lilypond[verbatim,quote]
384 @subheading Ütemmutató
391 Fogalomtár: @rglos{time signature}.
393 Az @notation{ütemmutató} beállítására a @code{\time} parancs szolgál:
395 @lilypond[verbatim,quote]
418 Fogalomtár: @rglos{clef}.
420 A @notation{kulcs} beállítása a @code{\clef} paranccsal lehetséges:
422 @lilypond[verbatim,quote]
436 @subheading Mindez együtt
438 Alább látható egy rövid példa, mely az eddig tanult elemeket mutatja be:
440 @lilypond[verbatim,quote]
451 Referencia: @ruser{Writing pitches},
452 @ruser{Writing rhythms}, @ruser{Writing rests},
453 @ruser{Time signature}, @ruser{Clef}.
456 @node A bemeneti fájlok jellemzői
457 @subsection A bemeneti fájlok jellemzői
458 @translationof Working on input files
460 @cindex kapcsos zárójelek
462 @cindex egysoros megjegyzés
463 @cindex többsoros megjegyzés
464 @cindex kis- és nagybetűk különbsége
469 @funindex %@{ ... %@}
471 A LilyPond nyelve sok tekintetben hasonlít bizonyos programnyelvekhez.
472 Érzékeny a kis- és nagybetűk különbségére, az üres helyek (szóközök, újsorok,
473 tabulátorok stb.) pedig nem számítanak. Ún. kifejezéseket lehet alkotni
474 kapcsos zárójelek @{ @} segítségével, megjegyzéseket pedig @code{%} után
475 vagy @w{@code{%@{ ... %@}}} közé lehet írni.
477 Ha esetleg nem lennének világosak a fenti mondatok, sebaj! Magyarázatuk
478 részletesen a következő:
483 @strong{Érzékeny a kis- és nagybetűk különbségére}:
484 nem mindegy, hogy kisbetűket vagy nagybetűket használunk
485 (pl. @w{@code{a, b, s, t}} nem ugyanaz, mint @w{@code{A, B, S, T}}).
486 A hangneveket mindig kisbetűvel kell írni: @w{@code{@{ c d e @}}}
487 helyes, @w{@code{@{ C D E @}}} hibás bemenet.
490 @strong{Az üres helyek nem számítanak}:
491 mindegy, hogy hova hány szóköz, tabulátor vagy újsor kerül.
492 @w{@code{@{ c d e @}}} ugyanazt jelenti, mint
493 @w{@code{@{ c @tie{}} @tie{} @tie{} d e @}} vagy:
501 Természetesen ez így nehezen olvasható. Érdemes a blokkokat beljebb kezdeni
502 egy tabulátorral vagy két szóközzel:
511 @strong{Kifejezések}:
512 a LilyPond bemenete @strong{@{ kapcsos zárójelek @}} között álló @emph{zenei
513 kifejezésekből} épül fel (ezekről később lesz szó), akárcsak a zárójelek
514 @code{()} közé zárt matematikai kifejezések. A kapcsos zárójelek köré javasolt
515 szóközt tenni, hacsak nem a sor elején vagy végén szerepelnek.
517 Egy @code{\} karakterrel kezdődő LilyPond parancs az azt követő kapcsos
518 zárójelpár tartalmával együtt ugyancsak egy zenei kifejezésnek számít (mint
519 például a @w{@code{\relative @{ @}}}).
522 @cindex egysoros megjegyzés
523 @cindex többsoros megjegyzés
525 @strong{Megjegyzések}:
526 a megjegyzések az emberi olvasó számára írt útmutatók; a LilyPond ezeket
527 figyelmen kívül hagyja, így nem jelennek meg a kimenetben. Kétfajta megjegyzés
528 van. A százalékjel @code{%} egy olyan megjegyzést kezd, mely a sor végéig tart.
529 Egy egysoros megjegyzés mindig az @emph{utána levő} sorral kapcsolatos.
533 % most jön a két h hang
537 A többsoros megjegyzés (megjegyzésblokk) több sort is közrefoghat.
538 A @code{%@{} és @code{%@}} jelek között minden megjegyzésnek számít.
539 Figyelem, a megjegyzésblokkok nem ágyazhatóak egymásba! Ez azt
540 jelenti, hogy nem lehet egy megjegyzésblokkot egy másikon belülre tenni,
541 mert az első @code{%@}} jelnél véget ér @emph{mindkét} megjegyzésblokk.
542 A következő részlet a megjegyzések használatára mutat példát:
545 % Ez itt a "Hull a pelyhes fehér hó" dallama
549 Ez a sor és az alatta levők nem számítanak bele a kimenetbe,
550 mert megjegyzésblokkban szerepelnek.
559 @node Hogyan olvassuk a dokumentációt?
560 @section Hogyan olvassuk a dokumentációt?
561 @translationof How to read the manual
564 * Kapcsos zárójelek elhagyása::
565 * Kattintható példák::
566 * A dokumentáció áttekintése::
569 @node Kapcsos zárójelek elhagyása
570 @subsection Kapcsos zárójelek elhagyása
571 @translationof Omitting braces
573 @cindex hogyan olvassuk a kézikönyvet
579 A LilyPond bemenete vagy @{ @} jelek között, vagy pedig egy
580 @code{@w{\relative c'' @{ ... @}}} blokkban kell, hogy álljon, ahogy azt a
581 @ref{A bemeneti fájlok jellemzői} c. fejezetben láttuk.
582 A tankönyv további részében a legtöbb példában ezt elhagyjuk. A példák
583 kipróbálásához a kimenet kimásolható és beilleszthető, de mindig köré
584 @strong{kell} rakni a @code{@w{\relative c'' @{ @}}} blokkot, ha nem szerepel
589 ...a példa ide kerül...
593 Miért hagytuk el a kapcsos zárójeleket? A legtöbb példa a kézikönyvben
594 beszúrható más, hosszabb darabokba. Ezeknél a példáknál nem éri meg
595 külön megadni a @code{@w{\relative c'' @{ @}}} blokkot --
596 esetleg belekerülnének egy nagyobb @code{\relative} blokkba, ami nem javasolt!
597 Ha minden példa körül @code{@w{\relative c'' @{ @}}} szerepelne,
598 nem lenne egyszerű az ilyen példákat kimásolni és beilleszteni egy hosszabb
599 műbe. Mivel a legtöbb felhasználó a neki kellő kódrészleteket egyszerűen
600 kimásolja a kézikönyvből, úgy döntöttünk, hogy leegyszerűsítjük a példákat.
603 @node Kattintható példák
604 @subsection Kattintható példák
605 @translationof Clickable examples
607 A legtöbb ember úgy tanul bele egy program használatába, hogy a gyakorlatban
608 próbálgatja azt, és játszadozik vele. Ez a LilyPonddal is lehetséges.
609 A kézikönyv HTML változatában bármelyik képre kattintva megtekinthető a pontos
610 bemenet, amelyből a LilyPond a képet generálta. Ez az alábbi példán
617 c-\markup { \bold \huge { Ide kell kattintani! } }
621 A @qq{ly snippet} kezdetű szakasz kimásolásával és beillesztésével már
622 rendelkezésre áll egy kiindulópont a kísérletezéshez. A kép egy az egyben
623 előáll (ugyanakkora méretben), ha a @qq{Start cut-&-pastable section}
624 résztől kezdve a fájl végéig kimásoljuk a szöveget.
626 @node A dokumentáció áttekintése
627 @subsection A dokumentáció áttekintése
628 @translationof Overview of manuals
630 A LilyPondhoz nagyon sok dokumentáció áll rendelkezésre.
631 Az új felhasználóknak emiatt gyakran nem világos, hogy mely részeket
632 kell elolvasniuk, és olykor alapvető fontosságú részeket hagynak ki.
634 @warning{A dokumentáció fontos részeit erősen ajánlott elolvasni, különben
635 a későbbi részek megértése jóval nehezebb lesz.}
640 @strong{@emph{Legelőször is}}: a tankönyvből az @ref{Első lecke}, majd az
641 @ref{Elemi kottaírás} fejezeteket kell elolvasni. Amennyiben egy zenei
642 fogalom jelentése nem világos, a @rglosnamed{Top, Zenei fogalomtárban} lehet
646 @strong{Egy teljes darab írása előtt}: a tankönyv @ref{Alapfogalmak} c.
647 fejezetét javasolt elolvasni. Ezután a
648 @rusernamed{Top, Kottaírás kézikönyvében} lehet az előforduló kottaelemek
649 beviteli módját megnézni.
652 @strong{Az alapértelmezett kimenet megváltoztatása előtt}:
653 @ref{A kimenet finomhangolása} olvasandó el.
656 @strong{Egy nagy mű bevitele előtt}: a program használatának kézikönyvéből a
657 @rprogramnamed{Suggestions for writing files, Tanácsok LilyPond bemeneti fájlok írásához}
658 c. fejezetet érdemes elolvasni.