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
221 Fogalomtár: @rglos{pitch}, @rglos{interval},
222 @rglos{scale}, @rglos{middle C}, @rglos{octave},
225 A hangok beírásának legegyszerűbb módja a @code{\relative} mód.
226 Ebben a módban minden hang automatikusan abba az oktávba kerül,
227 melyben az előző hanghoz a legközelebb áll, vagyis legfeljebb
228 kvárt távolságra. Ennek szemléltetésére gépeljünk be egy zenei alapformulát,
229 egy @notation{skálát}, melyben minden hang szekund távolságra van az
230 előzőtől. (Figyelem: mivel angolul a h hang neve b, ezért a LilyPond forrásban
231 is alapesetben b-t kell írni h helyett!)
234 @lilypond[verbatim,quote]
235 % megadjuk, hogy az első viszonyítási hang az egyvonalas c legyen
242 Itt a relatív mód első viszonyítási hangja az @notation{egyvonalas c}. Minden
243 hang az előzőhöz a lehető legközelebb helyezkedik el: az első @code{c} az
244 egyvonalas c-hez legközelebb eső c hangot jelenti, vagyis az egyvonalas c-t.
245 A második, d hang ehhez a hanghoz esik legközelebb, vagyis ugyanúgy az
246 egyvonalas oktávba kerül.
247 Legfeljebb kvárt nagyságú hangközöket tartalmazó dallamok táplálhatók be így a
250 @lilypond[verbatim,quote]
258 Természetesen nem szükséges, hogy a relatív mód első viszonyítási hangja
259 megegyezzen a tényleges első hanggal, ahogy az előző példában is láttuk, ahol
260 az első hang -- a @code{d} -- az egyvonalas c-hez legközelebb eső hang,
263 A @code{@w{\relative c'}} parancsban megadott első viszonyítási hanghoz
264 @code{'} vagy @code{,} karaktereket hozzáadva vagy elvéve
265 változtatható a kezdőoktáv:
268 @lilypond[verbatim,quote]
275 A relatív mód kezdetben bonyolultnak tűnhet, de valójában a legtöbb
276 dallamot így lehet legkönnyebben bevinni. Nézzük, hogyan néz ki a relatív
277 hangmagasság-számítás a gyakorlatban. A h hangról egy kvárton belül felfelé
278 a c, d és e hangok helyezkednek el, míg lefelé az a, g és f hangok. Tehát ha
279 egy h-t követő hang c, d vagy e, akkor a h fölé, míg ha a, g vagy f, akkor a
282 @lilypond[verbatim,quote]
284 b' c % felfelé szekund, lefelé szeptim, így: felső c
285 b d % felfelé terc, lefelé szext, így: felső d
286 b e % felfelé kvárt, lefelé kvint, így: felső e
287 b a % felfelé szeptim, lefelé szekund, így: alsó a
288 b g % felfelé szext, lefelé terc, így: alsó g
289 b f % felfelé kvint, lefelé kvárt, így: alsó f
293 Pontosan ugyanez marad a működés, ha bármelyik hang előtt kereszt vagy bé áll.
294 A @notation{módosítójelek} a relatív magasságszámítás során @strong{egyáltalán
295 nem számítanak}. A számítás során csak a vonalrendszerben elfoglalt pozíciónak
296 (azaz a diatonikus magasságnak) van szerepe.
298 Kvártnál nagyobb hangközugrást úgy érhetünk el, hogy @code{'} vagy @code{,}
299 karaktereket helyezünk a hang után. Az @code{'} egy @notation{oktáv}nyi
300 emelkedést, a @code{,} egy oktávnyi süllyedést jelent.
302 @lilypond[verbatim,quote]
310 Amennyi karaktert használunk, annyi oktáv különbséget érhetünk el, pl.
311 @code{''} vagy @code{,,} két oktávnyi emelést, ill. süllyesztést jelent --
312 de vigyázzunk, soha ne használjunk idézőjelet (@code{"}) két aposztróf
313 (@code{''}) helyett! Ez ugyanaz a mechanizmus, amivel a relatív mód első
314 viszonyítási hangját módosíthatjuk.
318 @unnumberedsubsubsec Ritmusérték
319 @translationof Durations (rhythms)
321 @cindex hanghosszúság
328 @cindex hosszúság jelzése
330 Fogalomtár: @rglos{beam}, @rglos{duration},
331 @rglos{whole note}, @rglos{half note}, @rglos{quarter note},
334 A hangok @notation{ritmusértékét} a hangmagasság után írt számmal
335 határozhatjuk meg. @code{1} jelenti az egészkottát, @code{2} a
336 félkottát, @code{4} a negyedkottát és így tovább. A
337 @notation{gerendázást} automatikusan elvégzi a LilyPond.
339 Ha nincs megadva a hosszúság, az előző hang hossza marad érvényben.
340 Az első hang alapértelmezetten negyed hosszúságú.
342 @lilypond[verbatim,quote]
346 a16 a a a a32 a a a a64 a a a a a a a a2
350 A @notation{pontozott hangok} után annyi pontot (@code{.}) kell írni,
351 ahányszoros a pontozás. A pontozott hangok ritmusértékét mindig meg kell
354 @lilypond[verbatim,quote]
362 @unnumberedsubsubsec Szünetek
366 @cindex szünet jelzése
368 Fogalomtár: @rglos{rest}.
370 A @notation{szünetek} megadása hasonlóképpen történik, mint a hangoké,
371 csak a hangmagasság megjelölése helyett @code{r}@tie{} betűt kell írni:
373 @lilypond[verbatim,quote]
382 @unnumberedsubsubsec Ütemmutató
383 @translationof Time signature
389 Fogalomtár: @rglos{time signature}.
391 Az @notation{ütemmutató} beállítására a @code{\time} parancs szolgál:
393 @lilypond[verbatim,quote]
405 @unnumberedsubsubsec Tempójelzés
406 @translationof Tempo marks
409 @cindex metronómjelzés
413 Fogalomtár: @rglos{tempo indication}, @rglos{metronome}.
415 Az @notation{tempójelzés} és @notation{metronómjelzés}
416 a @code{\tempo} parancs segítségével álítható be:
418 @lilypond[verbatim,quote]
427 \tempo "Presto" 4 = 120
435 @unnumberedsubsubsec Kulcs
446 Fogalomtár: @rglos{clef}.
448 A @notation{kulcs} beállítása a @code{\clef} paranccsal lehetséges:
450 @lilypond[verbatim,quote]
465 @unnumberedsubsubsec Mindez együtt
466 @translationof All together
468 Alább látható egy rövid példa, mely az eddig tanult elemeket mutatja be:
470 @lilypond[verbatim,quote]
474 \tempo "Andante" 4 = 120
484 Referencia: @ruser{Writing pitches},
485 @ruser{Writing rhythms}, @ruser{Writing rests},
486 @ruser{Time signature}, @ruser{Clef}.
489 @node A bemeneti fájlok jellemzői
490 @subsection A bemeneti fájlok jellemzői
491 @translationof Working on input files
493 @cindex kapcsos zárójelek
495 @cindex egysoros megjegyzés
496 @cindex többsoros megjegyzés
497 @cindex kis- és nagybetűk különbsége
505 @funindex %@{ ... %@}
507 A LilyPond bemeneti fájljai sok tekintetben hasonlítanak a programkódokhoz.
508 Tartalmaznak verziószámot, érzékenyek a kis- és nagybetűk különbségére, az üres helyek (szóközök, újsorok,
509 tabulátorok stb.) pedig nem számítanak. Ún. kifejezéseket lehet alkotni
510 kapcsos zárójelek @{ @} segítségével, megjegyzéseket pedig @code{%} után
511 vagy @w{@code{%@{ ... %@}}} közé lehet írni.
513 Ha esetleg nem lennének világosak a fenti mondatok, sebaj! Magyarázatuk
514 részletesen a következő:
520 @strong{Verzió kezelés}:
521 Minden LilyPond fájlnak tartalmaznia kell egy verziószámot. Ez a verziószám
522 írja le azt, hogy az adott fájl a LilyPond melyik verziójával készült.
523 A verziószámot az alábbi módon adhatjuk meg:
526 \version "@w{@version{}}"
529 A verziószámot a LilyPond fájl elején szokás megadni.
531 A verzió megadásának két fontos oka van. Az első az, hogy lehetővé teszi, hogy
532 a bemeneti fájl automatikusan frissüljön, amikor a LilyPond szintakszisa (nyelve) változik.
533 Másodsorban a fájlból í]y kiderül, hogy milyen verziójú LilyPond szükséges a fordításához.
535 Ha a verziószám hiányzik a bemeneti fájlból, a LilyPond fordításkor figyelmeztető üzenetet ír ki.
538 @strong{Verzió kezelés}:
539 Minden LilyPond fájlnak tartalmaznia kell egy verziószámot. Ez a verziószám
540 írja le azt, hogy az adott fájl a LilyPond melyik verziójával készült.
541 A verziószámot az alábbi módon adhatjuk meg:
544 \version "@w{@version{}}"
547 A verziószámot a LilyPond fájl elején szokás megadni.
549 A verzió megadásának két fontos oka van. Az első az, hogy lehetővé teszi, hogy
550 a bemeneti fájl automatikusan frissüljön, amikor a LilyPond szintakszisa (nyelve) változik.
551 Másodsorban a fájlból így kiderül, hogy milyen verziójú LilyPond szükséges a fordításához.
553 Ha a verziószám hiányzik a bemeneti fájlból, a LilyPond fordításkor figyelmeztető üzenetet ír ki.
556 @strong{Érzékeny a kis- és nagybetűk különbségére}:
557 nem mindegy, hogy kisbetűket vagy nagybetűket használunk
558 (pl. @w{@code{a, b, s, t}} nem ugyanaz, mint @w{@code{A, B, S, T}}).
559 A hangneveket mindig kisbetűvel kell írni: @w{@code{@{ c d e @}}}
560 helyes, @w{@code{@{ C D E @}}} hibás bemenet.
563 @strong{Az üres helyek nem számítanak}:
564 mindegy, hogy hova hány szóköz, tabulátor vagy újsor kerül.
565 @w{@code{@{ c d e @}}} ugyanazt jelenti, mint
566 @w{@code{@{ c @tie{} @tie{} @tie{} d e @}}} vagy:
574 Természetesen ez így nehezen olvasható. Érdemes a blokkokat beljebb kezdeni
575 egy tabulátorral vagy két szóközzel:
583 Azonban az üres helyek @emph{szükségesek}, hogy a nyelv elemeit elkülönítsük.
584 Más szavakkal: üres helyeket @emph{adhatunk} hozzá, de nem mindig @emph{hagyhatunk el}.
585 Mivel hiányzó üres helyek furcsa hibákhoz vezethetnek, ajánlott minden nyelvi elem elé
586 és mögé beilleszteni egyet, például minden kapcsos zárójel elé és mögé.
589 @strong{Kifejezések}:
590 a LilyPond bemenete @strong{@{ kapcsos zárójelek @}} között álló @emph{zenei
591 kifejezésekből} épül fel (ezekről később lesz szó), akárcsak a zárójelek
592 @code{()} közé zárt matematikai kifejezések. A kapcsos zárójelek köré javasolt
593 szóközt tenni, hacsak nem a sor elején vagy végén szerepelnek.
595 Egy @code{\} karakterrel kezdődő LilyPond parancs az azt követő kapcsos
596 zárójelpár tartalmával együtt ugyancsak egy zenei kifejezésnek számít (mint
597 például a @q{@w{@code{@bs{}relative @{ @dots{} @}}}}).
600 @cindex egysoros megjegyzés
601 @cindex többsoros megjegyzés
603 @strong{Megjegyzések}:
604 a megjegyzések az emberi olvasó számára írt útmutatók; a LilyPond ezeket
605 figyelmen kívül hagyja, így nem jelennek meg a kimenetben. Kétfajta megjegyzés
606 van. A százalékjel @code{%} egy olyan megjegyzést kezd, mely a sor végéig tart.
607 Egy egysoros megjegyzés mindig az @emph{utána levő} sorral kapcsolatos.
611 % most jön a két h hang
615 A többsoros megjegyzés (megjegyzésblokk) több sort is közrefoghat.
616 A @code{%@{} és @code{%@}} jelek között minden megjegyzésnek számít.
617 Figyelem, a megjegyzésblokkok nem ágyazhatóak egymásba! Ez azt
618 jelenti, hogy nem lehet egy megjegyzésblokkot egy másikon belülre tenni,
619 mert az első @code{%@}} jelnél véget ér @emph{mindkét} megjegyzésblokk.
620 A következő részlet a megjegyzések használatára mutat példát:
623 % Ez itt a "Hull a pelyhes fehér hó" dallama
627 Ez a sor és az alatta levők nem számítanak bele a kimenetbe,
628 mert megjegyzésblokkban szerepelnek.
638 @section Hibák kezelése
639 @translationof Dealing with errors
641 @cindex troubleshooting
643 Sometimes LilyPond doesn't produce the output you expect. This
644 section provides some links to help you solve the problems you
649 * General troubleshooting tips::
650 * Some common errors::
653 @node General troubleshooting tips
654 @subsection General troubleshooting tips
656 Troubleshooting LilyPond problems can be challenging for
657 people who are used to a graphical interface, because invalid
658 input files can be created. When this happens, a logical approach
659 is the best way to identify and solve the problem. Some guidelines
660 to help you learn to do this are provided in @rprogram{Troubleshooting}.
663 @node Some common errors
664 @subsection Some common errors
666 @cindex common errors
667 @cindex errors, common
669 There are a few common errors that are difficult to troubleshoot
670 based simply on the error messages that are displayed. These are
671 described in @rprogram{Common errors}.
675 @node Hogyan olvassuk a dokumentációt?
676 @section Hogyan olvassuk a dokumentációt?
677 @translationof How to read the manuals
680 * Kapcsos zárójelek elhagyása::
681 * Kattintható példák::
682 * A dokumentáció áttekintése::
685 @node Kapcsos zárójelek elhagyása
686 @subsection Kapcsos zárójelek elhagyása
687 @translationof Omitted material
689 @cindex hogyan olvassuk a kézikönyvet
695 A LilyPond bemenete vagy @code{@{ @}} jelek között, vagy pedig egy
696 @q{@w{@code{@bs{}relative @{ @dots{} @}}}} blokkban kell, hogy álljon, ahogy azt a
697 @ref{A bemeneti fájlok jellemzői} c. fejezetben láttuk.
698 A tankönyv további részében a legtöbb példában ezt elhagyjuk. A példák
699 kipróbálásához a kimenet kimásolható és beilleszthető, de mindig köré
700 @strong{kell} rakni a @code{@{ @}} blokkot, ha nem szerepel benne:
704 @dots{}a példa ide kerül@dots{}
708 Emellett ne felejtsük el, hogy minden LilyPond fájlban fel kell tüntetni a @code{\version}számot is.
709 Mivel a kézikönyv példái csak kódrészletek, nem fájlok, nem tartalmazzák a @code{\version}számot,
710 de mi ne feledkezzünk el feltüntetni a fájlok elején.
712 @node Kattintható példák
713 @subsection Kattintható példák
714 @translationof Clickable examples
716 A legtöbb ember úgy tanul bele egy program használatába, hogy a gyakorlatban
717 próbálgatja azt, és játszadozik vele. Ez a LilyPonddal is lehetséges.
718 A kézikönyv HTML változatában bármelyik képre kattintva megtekinthető a pontos
719 bemenet, amelyből a LilyPond a képet generálta. Ez az alábbi példán
725 c''4-\markup { \bold \huge { Click here. } }
729 A @qq{ly snippet} kezdetű szakasz kimásolásával és beillesztésével már
730 rendelkezésre áll egy kiindulópont a kísérletezéshez. A kép egy az egyben
731 előáll (ugyanakkora méretben), ha a @qq{Start cut-&-pastable section}
732 résztől kezdve a fájl végéig kimásoljuk a szöveget.
739 @n ode Keyboard navigation
740 @s ubsection Keyboard navigation
742 @warning{Ez a lehetőség csak a HTML kézikönyvben elérhető,}
744 @c TODO: once this is figured out, insert it here.
746 We are currently working on this feature.
749 @node A dokumentáció áttekintése
750 @subsection A dokumentáció áttekintése
751 @translationof Overview of manuals
753 A LilyPondhoz nagyon sok dokumentáció áll rendelkezésre.
754 Az új felhasználóknak emiatt gyakran nem világos, hogy mely részeket
755 kell elolvasniuk, és olykor alapvető fontosságú részeket hagynak ki.
757 @warning{A dokumentáció fontos részeit erősen ajánlott elolvasni, különben
758 a későbbi részek megértése jóval nehezebb lesz.}
763 @strong{@emph{Legelőször is}}: a tankönyvből az @ref{Első lecke}, majd az
764 @ref{Elemi kottaírás} fejezeteket kell elolvasni. Amennyiben egy zenei
765 fogalom jelentése nem világos, a @rglosnamed{Top, Zenei fogalomtárban} lehet
769 @strong{Egy teljes darab írása előtt}: a tankönyv @ref{Alapfogalmak} c.
770 fejezetét javasolt elolvasni. Ezután a
771 @rusernamed{Top, Kottaírás kézikönyvében} lehet az előforduló kottaelemek
772 beviteli módját megnézni.
775 @strong{Az alapértelmezett kimenet megváltoztatása előtt}:
776 @ref{A kimenet finomhangolása} olvasandó el.
779 @strong{Egy nagy mű bevitele előtt}: a program használatának kézikönyvéből a
780 @rprogramnamed{Suggestions for writing files, Tanácsok LilyPond bemeneti fájlok írásához}
781 c. fejezetet érdemes elolvasni.