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..
11 @include included/generating-output.itexi
17 @translationof Tutorial
19 Tankönyvünk első leckéje bemutatja a LilyPond nyelvét, és elmagyarázza,
20 hogyan kell nyomtatható kottát előállítani.
24 * Bemeneti fájlok írása::
26 * Hogyan olvassuk a dokumentációt?::
29 @node Fájlok fordítása
30 @section Fájlok fordítása
31 @translationof Compiling a file
42 @subsection Zene bevitele
43 @translationof Entering input
47 @cindex kis- és nagybetűk különbsége
50 * Kimenet előállítása::
53 A LilyPond bemeneti fájljai egyszerű szöveges állományok.
54 Egy kotta létrehozásához egy bemeneti fájlban (másnéven forrásfájlban) kell
55 azt szöveges formában leírni.
56 @qq{Fordítás} a neve annak a folyamatnak, melynek során egy LilyPond
57 formátumú forrásfájlból egy nyomtatható kotta és (szabadon választhatóan)
58 egy meghallgatható MIDI fájl áll elő.
60 Első példánk megmutatja, hogy néz ki egy egyszerű bemenet. A LilyPond
61 forrásfájlba ezt írva:
64 \version "@w{@version{}}"
71 az alábbi eredményt kapjuk:
73 @c in this case we don't want verbatim
80 @warning{A LilyPondban a hangok és a dalszöveg köré mindig
81 @strong{@{ kapcsos zárójeleket @}} kell írni.
82 A kapcsos zárójeleket legtöbbször szóközzel vesszük körül, hacsak
83 a sor elején vagy végén nem állnak, hogy környezetükkel ne folyjanak
84 egybe, így kétértelműséget okozván. A tankönyv példáiban olykor a
85 rövidség kedvéért elhagyjuk a kapcsos zárójeleket, de a forrásfájlokban
86 nem szabad elfelejteni kitenni őket! A @ref{Hogyan olvassuk a dokumentációt?}
87 c. fejezetben olvasható több információ a tankönyv példáiról és megjelenítésük
90 Továbbá a LilyPond bemenete @strong{érzékeny a kis- és nagybetűk különbségére}:
91 @w{@code{@{ c d e @}}} érvényes bemenet; @w{@code{@{ C D E @}}} hibát
96 @node Kimenet előállítása
97 @unnumberedsubsubsec Kimenet előállítása
98 @translationof Producing output
102 @cindex szövegszerkesztők
104 Ez a szakasz arról szól, hogy milyen parancsokat kell futtatni
105 a kotta előállításához és a kimenet megtekintéséhez a felhasználó operációs
106 rendszerétől függően.
112 @ref{MacOS X, @sourceimage{logo-macosx,,,}}
113 @ref{MacOS X, MacOS X} (graphical)
116 @ref{Windows, @sourceimage{logo-windows,,,}}
117 @ref{Windows, Microsoft Windows} (graphical)
120 @ref{Parancssor, @sourceimage{logo-linux,,,}
121 @sourceimage{logo-freebsd,,,}
122 @sourceimage{logo-macosx,,,}
123 @sourceimage{logo-windows,,,}
125 @ref{Parancssor, Minden operációs rendszr} (parancssor)
131 Bizonyos szövegszerkesztőkbe beépíthető LilyPond támogatás, ami hatékonyabb
132 szerkesztést tesz lehetővé; erről a @rprogram{Text editor support} c.
135 @warning{Amikor a LilyPond első alkalommal fut, egy-két percig várni kell,
136 amíg megvizsgálja a rendszer betűtípusait. Ezután természetesen sokkal
137 gyorsabban fog futni!}
141 @translationof MacOS X
143 @cindex LilyPond futtatása MacOS X-en
144 @cindex MacOS X, LilyPond futtatása
151 @cindex LilyPond futtatása Windows-on
152 @cindex Windows, LilyPond futtatása
158 @subsection Parancssor
159 @translationof Command-line
161 @cindex LilyPond futtatása Unixon
162 @cindex Unix, LilyPond futtatása
166 @node Bemeneti fájlok írása
167 @section Bemeneti fájlok írása
168 @translationof How to write input files
171 * Egyszerű kottázás::
172 * A bemeneti fájlok jellemzői::
175 @node Egyszerű kottázás
176 @subsection Egyszerű kottázás
177 @translationof Simple notation
179 @cindex egyszerű lejegyzés
180 @cindex lejegyzés, egyszerű
192 A LilyPond bizonyos elemeket automatikusan hozzáad a kottához. A következő
193 példában csak négy hangmagasságot adunk meg, de a LilyPond kirakja a kulcsot
194 és az ütemmutatót, valamint a hangok hosszúságát alapértelmezetten negyednek
197 @lilypond[verbatim,quote]
204 Természetesen minden megváltoztatható, de a legtöbb esetben az alapbeállítás
208 @unnumberedsubsubsec Hangmagasság
209 @translationof Pitches
215 @cindex módosítójelek és relatív mód
222 Fogalomtár: @rglos{pitch}, @rglos{interval},
223 @rglos{scale}, @rglos{middle C}, @rglos{octave},
226 A hangok beírásának legegyszerűbb módja a @code{\relative} mód.
227 Ebben a módban minden hang automatikusan abba az oktávba kerül,
228 melyben az előző hanghoz a legközelebb áll, vagyis legfeljebb
229 kvárt távolságra. Ennek szemléltetésére gépeljünk be egy zenei alapformulát,
230 egy @notation{skálát}, melyben minden hang szekund távolságra van az
231 előzőtől. (Figyelem: mivel angolul a h hang neve b, ezért a LilyPond forrásban
232 is alapesetben b-t kell írni h helyett!)
235 @lilypond[verbatim,quote]
236 % megadjuk, hogy az első viszonyítási hang az egyvonalas c legyen
243 Itt a relatív mód első viszonyítási hangja az @notation{egyvonalas c}. Minden
244 hang az előzőhöz a lehető legközelebb helyezkedik el: az első @code{c} az
245 egyvonalas c-hez legközelebb eső c hangot jelenti, vagyis az egyvonalas c-t.
246 A második, d hang ehhez a hanghoz esik legközelebb, vagyis ugyanúgy az
247 egyvonalas oktávba kerül.
248 Legfeljebb kvárt nagyságú hangközöket tartalmazó dallamok táplálhatók be így a
251 @lilypond[verbatim,quote]
259 Természetesen nem szükséges, hogy a relatív mód első viszonyítási hangja
260 megegyezzen a tényleges első hanggal, ahogy az előző példában is láttuk, ahol
261 az első hang -- a @code{d} -- az egyvonalas c-hez legközelebb eső hang,
264 A @code{@w{\relative c'}} parancsban megadott első viszonyítási hanghoz
265 @code{'} vagy @code{,} karaktereket hozzáadva vagy elvéve
266 változtatható a kezdőoktáv:
269 @lilypond[verbatim,quote]
276 A relatív mód kezdetben bonyolultnak tűnhet, de valójában a legtöbb
277 dallamot így lehet legkönnyebben bevinni. Nézzük, hogyan néz ki a relatív
278 hangmagasság-számítás a gyakorlatban. A h hangról egy kvárton belül felfelé
279 a c, d és e hangok helyezkednek el, míg lefelé az a, g és f hangok. Tehát ha
280 egy h-t követő hang c, d vagy e, akkor a h fölé, míg ha a, g vagy f, akkor a
283 @lilypond[verbatim,quote]
285 b' c % felfelé szekund, lefelé szeptim, így: felső c
286 b d % felfelé terc, lefelé szext, így: felső d
287 b e % felfelé kvárt, lefelé kvint, így: felső e
288 b a % felfelé szeptim, lefelé szekund, így: alsó a
289 b g % felfelé szext, lefelé terc, így: alsó g
290 b f % felfelé kvint, lefelé kvárt, így: alsó f
294 Pontosan ugyanez marad a működés, ha bármelyik hang előtt kereszt vagy bé áll.
295 A @notation{módosítójelek} a relatív magasságszámítás során @strong{egyáltalán
296 nem számítanak}. A számítás során csak a vonalrendszerben elfoglalt pozíciónak
297 (azaz a diatonikus magasságnak) van szerepe.
299 Kvártnál nagyobb hangközugrást úgy érhetünk el, hogy @code{'} vagy @code{,}
300 karaktereket helyezünk a hang után. Az @code{'} egy @notation{oktáv}nyi
301 emelkedést, a @code{,} egy oktávnyi süllyedést jelent.
303 @lilypond[verbatim,quote]
311 Amennyi karaktert használunk, annyi oktáv különbséget érhetünk el, pl.
312 @code{''} vagy @code{,,} két oktávnyi emelést, ill. süllyesztést jelent --
313 de vigyázzunk, soha ne használjunk idézőjelet (@code{"}) két aposztróf
314 (@code{''}) helyett! Ez ugyanaz a mechanizmus, amivel a relatív mód első
315 viszonyítási hangját módosíthatjuk.
319 @unnumberedsubsubsec Ritmusérték
320 @translationof Durations (rhythms)
322 @cindex hanghosszúság
329 @cindex hosszúság jelzése
331 Fogalomtár: @rglos{beam}, @rglos{duration},
332 @rglos{whole note}, @rglos{half note}, @rglos{quarter note},
335 A hangok @notation{ritmusértékét} a hangmagasság után írt számmal
336 határozhatjuk meg. @code{1} jelenti az egészkottát, @code{2} a
337 félkottát, @code{4} a negyedkottát és így tovább. A
338 @notation{gerendázást} automatikusan elvégzi a LilyPond.
340 Ha nincs megadva a hosszúság, az előző hang hossza marad érvényben.
341 Az első hang alapértelmezetten negyed hosszúságú.
343 @lilypond[verbatim,quote]
347 a16 a a a a32 a a a a64 a a a a a a a a2
351 A @notation{pontozott hangok} után annyi pontot (@code{.}) kell írni,
352 ahányszoros a pontozás. A pontozott hangok ritmusértékét mindig meg kell
355 @lilypond[verbatim,quote]
363 @unnumberedsubsubsec Szünetek
367 @cindex szünet jelzése
369 Fogalomtár: @rglos{rest}.
371 A @notation{szünetek} megadása hasonlóképpen történik, mint a hangoké,
372 csak a hangmagasság megjelölése helyett @code{r}@tie{} betűt kell írni:
374 @lilypond[verbatim,quote]
383 @unnumberedsubsubsec Ütemmutató
384 @translationof Time signature
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]
407 @unnumberedsubsubsec Tempójelzés
408 @translationof Tempo marks
411 @cindex metronómjelzés
416 Fogalomtár: @rglos{tempo indication}, @rglos{metronome}.
418 Az @notation{tempójelzés} és @notation{metronómjelzés}
419 a @code{\tempo} parancs segítségével álítható be:
421 @lilypond[verbatim,quote]
430 \tempo "Presto" 4 = 120
438 @unnumberedsubsubsec Kulcs
450 Fogalomtár: @rglos{clef}.
452 A @notation{kulcs} beállítása a @code{\clef} paranccsal lehetséges:
454 @lilypond[verbatim,quote]
469 @unnumberedsubsubsec Mindez együtt
470 @translationof All together
472 Alább látható egy rövid példa, mely az eddig tanult elemeket mutatja be:
474 @lilypond[verbatim,quote]
478 \tempo "Andante" 4 = 120
488 Referencia: @ruser{Writing pitches},
489 @ruser{Writing rhythms}, @ruser{Writing rests},
490 @ruser{Time signature}, @ruser{Clef}.
493 @node A bemeneti fájlok jellemzői
494 @subsection A bemeneti fájlok jellemzői
495 @translationof Working on input files
497 @cindex kapcsos zárójelek
499 @cindex egysoros megjegyzés
500 @cindex többsoros megjegyzés
501 @cindex kis- és nagybetűk különbsége
509 @funindex %@{ ... %@}
511 A LilyPond bemeneti fájljai sok tekintetben hasonlítanak a programkódokhoz.
512 Tartalmaznak verziószámot, érzékenyek a kis- és nagybetűk különbségére, az üres helyek (szóközök, újsorok,
513 tabulátorok stb.) pedig nem számítanak. Ún. kifejezéseket lehet alkotni
514 kapcsos zárójelek @{ @} segítségével, megjegyzéseket pedig @code{%} után
515 vagy @w{@code{%@{ ... %@}}} közé lehet írni.
517 Ha esetleg nem lennének világosak a fenti mondatok, sebaj! Magyarázatuk
518 részletesen a következő:
524 @strong{Verzió kezelés}:
525 Minden LilyPond fájlnak tartalmaznia kell egy verziószámot. Ez a verziószám
526 írja le azt, hogy az adott fájl a LilyPond melyik verziójával készült.
527 A verziószámot az alábbi módon adhatjuk meg:
530 \version "@w{@version{}}"
533 A verziószámot a LilyPond fájl elején szokás megadni.
535 A verzió megadásának két fontos oka van. Az első az, hogy lehetővé teszi, hogy
536 a bemeneti fájl automatikusan frissüljön, amikor a LilyPond szintakszisa (nyelve) változik.
537 Másodsorban a fájlból í]y kiderül, hogy milyen verziójú LilyPond szükséges a fordításához.
539 Ha a verziószám hiányzik a bemeneti fájlból, a LilyPond fordításkor figyelmeztető üzenetet ír ki.
542 @strong{Verzió kezelés}:
543 Minden LilyPond fájlnak tartalmaznia kell egy verziószámot. Ez a verziószám
544 írja le azt, hogy az adott fájl a LilyPond melyik verziójával készült.
545 A verziószámot az alábbi módon adhatjuk meg:
548 \version "@w{@version{}}"
551 A verziószámot a LilyPond fájl elején szokás megadni.
553 A verzió megadásának két fontos oka van. Az első az, hogy lehetővé teszi, hogy
554 a bemeneti fájl automatikusan frissüljön, amikor a LilyPond szintakszisa (nyelve) változik.
555 Másodsorban a fájlból így kiderül, hogy milyen verziójú LilyPond szükséges a fordításához.
557 Ha a verziószám hiányzik a bemeneti fájlból, a LilyPond fordításkor figyelmeztető üzenetet ír ki.
560 @strong{Érzékeny a kis- és nagybetűk különbségére}:
561 nem mindegy, hogy kisbetűket vagy nagybetűket használunk
562 (pl. @w{@code{a, b, s, t}} nem ugyanaz, mint @w{@code{A, B, S, T}}).
563 A hangneveket mindig kisbetűvel kell írni: @w{@code{@{ c d e @}}}
564 helyes, @w{@code{@{ C D E @}}} hibás bemenet.
567 @strong{Az üres helyek nem számítanak}:
568 mindegy, hogy hova hány szóköz, tabulátor vagy újsor kerül.
569 @w{@code{@{ c d e @}}} ugyanazt jelenti, mint
570 @w{@code{@{ c @tie{} @tie{} @tie{} d e @}}} vagy:
578 Természetesen ez így nehezen olvasható. Érdemes a blokkokat beljebb kezdeni
579 egy tabulátorral vagy két szóközzel:
587 Azonban az üres helyek @emph{szükségesek}, hogy a nyelv elemeit elkülönítsük.
588 Más szavakkal: üres helyeket @emph{adhatunk} hozzá, de nem mindig @emph{hagyhatunk el}.
589 Mivel hiányzó üres helyek furcsa hibákhoz vezethetnek, ajánlott minden nyelvi elem elé
590 és mögé beilleszteni egyet, például minden kapcsos zárójel elé és mögé.
593 @strong{Kifejezések}:
594 a LilyPond bemenete @strong{@{ kapcsos zárójelek @}} között álló @emph{zenei
595 kifejezésekből} épül fel (ezekről később lesz szó), akárcsak a zárójelek
596 @code{()} közé zárt matematikai kifejezések. A kapcsos zárójelek köré javasolt
597 szóközt tenni, hacsak nem a sor elején vagy végén szerepelnek.
599 Egy @code{\} karakterrel kezdődő LilyPond parancs az azt követő kapcsos
600 zárójelpár tartalmával együtt ugyancsak egy zenei kifejezésnek számít (mint
601 például a @q{@w{@code{@bs{}relative @{ @dots{} @}}}}).
604 @cindex egysoros megjegyzés
605 @cindex többsoros megjegyzés
607 @strong{Megjegyzések}:
608 a megjegyzések az emberi olvasó számára írt útmutatók; a LilyPond ezeket
609 figyelmen kívül hagyja, így nem jelennek meg a kimenetben. Kétfajta megjegyzés
610 van. A százalékjel @code{%} egy olyan megjegyzést kezd, mely a sor végéig tart.
611 Egy egysoros megjegyzés mindig az @emph{utána levő} sorral kapcsolatos.
615 % most jön a két h hang
619 A többsoros megjegyzés (megjegyzésblokk) több sort is közrefoghat.
620 A @code{%@{} és @code{%@}} jelek között minden megjegyzésnek számít.
621 Figyelem, a megjegyzésblokkok nem ágyazhatóak egymásba! Ez azt
622 jelenti, hogy nem lehet egy megjegyzésblokkot egy másikon belülre tenni,
623 mert az első @code{%@}} jelnél véget ér @emph{mindkét} megjegyzésblokk.
624 A következő részlet a megjegyzések használatára mutat példát:
627 % Ez itt a "Hull a pelyhes fehér hó" dallama
631 Ez a sor és az alatta levők nem számítanak bele a kimenetbe,
632 mert megjegyzésblokkban szerepelnek.
642 @section Hibák kezelése
643 @translationof Dealing with errors
645 @cindex troubleshooting
647 Sometimes LilyPond doesn't produce the output you expect. This
648 section provides some links to help you solve the problems you
653 * General troubleshooting tips::
654 * Some common errors::
657 @node General troubleshooting tips
658 @subsection General troubleshooting tips
660 Troubleshooting LilyPond problems can be challenging for
661 people who are used to a graphical interface, because invalid
662 input files can be created. When this happens, a logical approach
663 is the best way to identify and solve the problem. Some guidelines
664 to help you learn to do this are provided in @rprogram{Troubleshooting}.
667 @node Some common errors
668 @subsection Some common errors
670 @cindex common errors
671 @cindex errors, common
673 There are a few common errors that are difficult to troubleshoot
674 based simply on the error messages that are displayed. These are
675 described in @rprogram{Common errors}.
679 @node Hogyan olvassuk a dokumentációt?
680 @section Hogyan olvassuk a dokumentációt?
681 @translationof How to read the manuals
684 * Kapcsos zárójelek elhagyása::
685 * Kattintható példák::
686 * A dokumentáció áttekintése::
689 @node Kapcsos zárójelek elhagyása
690 @subsection Kapcsos zárójelek elhagyása
691 @translationof Omitted material
693 @cindex hogyan olvassuk a kézikönyvet
699 A LilyPond bemenete vagy @code{@{ @}} jelek között, vagy pedig egy
700 @q{@w{@code{@bs{}relative @{ @dots{} @}}}} blokkban kell, hogy álljon, ahogy azt a
701 @ref{A bemeneti fájlok jellemzői} c. fejezetben láttuk.
702 A tankönyv további részében a legtöbb példában ezt elhagyjuk. A példák
703 kipróbálásához a kimenet kimásolható és beilleszthető, de mindig köré
704 @strong{kell} rakni a @code{@{ @}} blokkot, ha nem szerepel benne:
708 @dots{}a példa ide kerül@dots{}
712 Emellett ne felejtsük el, hogy minden LilyPond fájlban fel kell tüntetni a @code{\version}számot is.
713 Mivel a kézikönyv példái csak kódrészletek, nem fájlok, nem tartalmazzák a @code{\version}számot,
714 de mi ne feledkezzünk el feltüntetni a fájlok elején.
716 @node Kattintható példák
717 @subsection Kattintható példák
718 @translationof Clickable examples
720 A legtöbb ember úgy tanul bele egy program használatába, hogy a gyakorlatban
721 próbálgatja azt, és játszadozik vele. Ez a LilyPonddal is lehetséges.
722 A kézikönyv HTML változatában bármelyik képre kattintva megtekinthető a pontos
723 bemenet, amelyből a LilyPond a képet generálta. Ez az alábbi példán
729 c''4-\markup { \bold \huge { Click here. } }
733 A @qq{ly snippet} kezdetű szakasz kimásolásával és beillesztésével már
734 rendelkezésre áll egy kiindulópont a kísérletezéshez. A kép egy az egyben
735 előáll (ugyanakkora méretben), ha a @qq{Start cut-&-pastable section}
736 résztől kezdve a fájl végéig kimásoljuk a szöveget.
743 @n ode Keyboard navigation
744 @s ubsection Keyboard navigation
746 @warning{Ez a lehetőség csak a HTML kézikönyvben elérhető,}
748 @c TODO: once this is figured out, insert it here.
750 We are currently working on this feature.
753 @node A dokumentáció áttekintése
754 @subsection A dokumentáció áttekintése
755 @translationof Overview of manuals
757 A LilyPondhoz nagyon sok dokumentáció áll rendelkezésre.
758 Az új felhasználóknak emiatt gyakran nem világos, hogy mely részeket
759 kell elolvasniuk, és olykor alapvető fontosságú részeket hagynak ki.
761 @warning{A dokumentáció fontos részeit erősen ajánlott elolvasni, különben
762 a későbbi részek megértése jóval nehezebb lesz.}
767 @strong{@emph{Legelőször is}}: a tankönyvből az @ref{Első lecke}, majd az
768 @ref{Elemi kottaírás} fejezeteket kell elolvasni. Amennyiben egy zenei
769 fogalom jelentése nem világos, a @rglosnamed{Top, Zenei fogalomtárban} lehet
773 @strong{Egy teljes darab írása előtt}: a tankönyv @ref{Alapfogalmak} c.
774 fejezetét javasolt elolvasni. Ezután a
775 @rusernamed{Top, Kottaírás kézikönyvében} lehet az előforduló kottaelemek
776 beviteli módját megnézni.
779 @strong{Az alapértelmezett kimenet megváltoztatása előtt}:
780 @ref{A kimenet finomhangolása} olvasandó el.
783 @strong{Egy nagy mű bevitele előtt}: a program használatának kézikönyvéből a
784 @rprogramnamed{Suggestions for writing files, Tanácsok LilyPond bemeneti fájlok írásához}
785 c. fejezetet érdemes elolvasni.