1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: cs -*-
4 Translation of GIT committish: 4f7427e7a314a71bde16559247885544256b8213
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
14 @c Translators: Pavel Fric
18 @translationof Tutorial
20 Tato kapitola čtenáři představuje základní práci s LilyPondem.
23 * Přeložení zdrojového souboru::
24 * Jak se píší vstupní soubory::
25 * Vypořádání se s chybami::
30 @node Přeložení zdrojového souboru
31 @section Přeložení zdrojového souboru
32 @translationof Compiling a file
34 Tento úryvek uvádí do @qq{sestavování} -- do procesu zpracování
35 LilyPondovských vstupních souborů (napsaných vámi), který popisuje,
36 aby byl vytvořen výstupní soubor.
46 @subsection Zadání not
47 @translationof Entering input
51 @cindex Příklad, první
52 @cindex Přeložení zdrojového souboru
53 @cindex Psaní velkých a malých písmen
54 @cindex Zdrojový text, překlad
58 @qq{Sestavení} je pojem, který se používá pro
59 přeměnu vstupního souboru pro Lilypond programem LilyPond do
60 notového výstupu. Výstupními soubory jsou v první řadě soubory
61 PDF (pro prohlížení a tisku), MIDI (pro přehrávání)
62 a PNG (pro používání na internetových stránkách). Vstupními soubory
63 pro LilyPond jsou prosté textové soubory.
65 První příklad ukazuje, jak takový
66 jednoduchý vstupní soubor může vypadat.
74 Obrazovým výstupem je:
76 @c in this case we don't want verbatim
83 @warning{V každém souboru LilyPond musejí být nastaveny
84 @strong{@{ kulaté závorky @}} kolem not nebo
86 Před a za závorkami mají být zadány prázdné znaky,
87 aby ve spojení s vlastními symboly not nevznikly
89 Na začátku a na konci řádku mohou být tyto prázdné znaky
90 vynechány také. Může se stát, že v této příručce
91 závorky v některých příkladech chybí, ale je třeba vždy
92 myslet na to, aby se ve vlastních souborech používaly!
93 Více informací ke znázornění příkladů v této příručce
94 podává úryvek @ref{Jak číst příručky}.}
96 Dodatečně LilyPond rozlišuje @strong{Psaní velkých a malých písmen}.
97 @w{@samp{ @{ c d e @}}} je přípustný kód,
98 @w{@samp{ @{ C D E @}}} naproti tomu vede k chybovému hlášení.
103 @subheading Pohled na výsledky
108 @cindex Pohled s notami
110 @cindex Textové editory
111 @cindex LilyPond pod MacOS X
112 @cindex MacOS X, spuštění LilyPondu
113 @cindex Spuštění LilyPondu
115 Tvorba notového výstupu závisí na tom, jaký operační systém
116 a které programy se používají.
121 @ref{MacOS X, @sourceimage{logo-macosx,,,}}
122 @ref{MacOS X, MacOS X} (obrazově)
125 @ref{Windows, @sourceimage{logo-windows,,,}}
126 @ref{Windows, Microsoft Windows} (obrazově)
129 @ref{Příkazový řádek, @sourceimage{logo-linux,,,}
130 @sourceimage{logo-freebsd,,,}
131 @sourceimage{logo-macosx,,,}
132 @sourceimage{logo-windows,,,}
134 @ref{Příkazový řádek, všechny operační systémy} (Příkazový řádek)
138 Vezměte na vědomí, že lepší výsledky jsou u textových editorů s
139 podporou pro LilyPond. Více k tomu v úryvku
140 @rweb{Snadnější úpravy}.
142 @warning{Poprvé, když použijete LilyPond, může spuštění trvat minutu
143 nebo i déle, protože program nejprve vyhledává všechna písma,
144 LilyPond běží o mnoho rychleji.}
149 @translationof MacOS X
151 @cindex Spuštění programu, MacOS X
152 @cindex MacOS X, spuštění LilyPondu
159 @translationof Windows
161 @cindex Windows, spuštění LilyPondu
166 @node Příkazový řádek
167 @subsection Příkazový řádek
168 @translationof Command-line
170 @cindex Unix, spuštění LilyPondu
174 @node Jak se píší vstupní soubory
175 @section Jak se píší vstupní soubory
176 @translationof How to write input files
178 Tento úryvek vysvětluje základní skladbu LilyPondu a pomáhá
179 na začátku se zápisem vstupního souboru pro LilyPond.
182 * Jednoduchý notový zápis::
183 * Práce na vstupních souborech::
187 @node Jednoduchý notový zápis
188 @subsection Jednoduchý notový zápis
189 @translationof Simple notation
191 @cindex jednoduchý notový zápis
192 @cindex Notový zápis, jednoduchý
194 LilyPond přidává některé části notového zápisu automaticky. V
195 následujícím příkladu jsou zadány jen čtyři výšky tónů, ale LilyPond přesto
196 zapíše klíč, taktové označení a rytmus (délky not).
198 @lilypond[verbatim,quote]
205 Tato nastavení je možné změnit, ale ve většině případů
206 jsou automatické hodnoty v zásadě použitelné.
209 @subheading Výšky tónů
212 @cindex Vztažný režim
213 @cindex Odsuvník (apostrof)
215 @cindex Předznamenání a vztažný režim
216 @cindex Vztažný režim a předznamenání
222 Slovníček: @rglos{pitch}, @rglos{interval},
223 @rglos{scale}, @rglos{middle C}, @rglos{octave},
226 @c Addition for czech users about pitch naming conventions
227 Výšky tónů se zadávají malými písmeny, která odpovídají názvu noty.
228 Je ale důležité znát, že LilyPond ve svém výchozím nastavení
229 používá anglické názvy not. Až na výjimku tyto odpovídají
230 českým, proto se přednastavení LilyPondu pro toto
231 cvičení ponechává. Touto @emph{výjimkou} je nota h -- v
232 LilyPondu se musí na místo toho napsat písmeno b! České bé je naproti
233 tomu zapsáno jako bes, his se proti tomu zapíše jako bis. Podívejte se také na
234 @ruser{Předznamenání} a @ruser{Názvy not v jiných řečích}. Zde se popisuje,
235 jak se používají české názvy not.
238 Nejjednoduššeji lze noty zadávat v režimu @code{\relative}.
239 V tomto režimu je oktáva noty vbrána automaticky s tím, že se
240 předpokládá, že následující nota je zapsána vždy tak blízko, jak
241 je to jen možné, ve vztahu k předchozí notě, což znamená, že je
242 zapsána nanejvýš o tři notové řádky výše nebo níže než předchozí
243 nota. Začneme naším prvním nejzákladnějším příkladem notového zápisu,
244 což je @notation{stupnice}, kde stojí další nota
245 vždy jen o jeden notový řádek nad předchozím.
248 @lilypond[verbatim,quote]
249 % Počáteční bod napsat na jednočárkovaném C
256 První notou je @notation{jednočárkované C}. Každá následující nota
257 se nachází tak blízko, jak je to jen možné za předchozí -- první
258 @q{C} se takto počítá jako C od
259 jednočárkovaného C. Nato následuje nejbližší možné
260 D ve vztahu k předcházející notě. S těmito pravidly lze v
261 režimu @code{\relative} zobrazit i melodie s většími
264 @lilypond[verbatim,quote]
272 Není nutné, aby první nota melodie začínala
273 notou, která udává první notovou výšku.
274 První nota (@q{D}) z předchozího příkladu je následujícím D,
275 počítáno od jednočárkovaného C.
277 Tím, že člověk přidává odsuvníky (apostrofy) @code{'}
278 (klávesa Shift+#) nebo čárky @code{,} k @w{@code{\relative c' @{}}, nebo
279 je odstraňuje, může být oktáva první výšky tónu změněna:
282 @lilypond[verbatim,quote]
289 Vztažný režim se může zpočátku jevit matoucí, ale je to ten
290 nejjednodušší způsob, jak zapsat většinu melodií. Podívejme se na to,
291 H (@code{b} ve skladbě LilyPondu), které se v houslovém klíči
292 nachází na prostřední lince, můžeme směrem vzhůru napsat C, D a E,
293 a A, G a F směrem dolů pod H. Když tedy notou, která následuje po
294 H, je C, D nebo E, napíše ji LilyPond nad
295 H, když je to A, G nebo F, je napsáno pod ním.
298 @lilypond[verbatim,quote]
300 b' c % c je 1 řádek nahoru, tedy c nad b
301 b d % d je 2 řádky nahoru, nebo 5 dolů, tedy d nad b
302 b e % e je 3 nahoru, nebo 4 dolů, tedy e pod b
303 b a % a je 6 nahoru, nebo 1 dolů, tedy a pod b
304 b g % g je 5 nahoru, nebo 2 dolů, tedy g pod b
305 b f % f je 4 nahoru, nebo 3 dolů, tedy f pod b
309 Stejný výpočet se provádí i tehdy, když je jedna z not zvýšena
310 nebo snížena. @notation{Předznamenání} jsou
311 při výpočtu @strong{zcela přehlížena}. Přesně ten samý
312 výpočet se obdobně provádí od každé následující výšky tónu po
313 další výšku tónu znovu.
315 Aby se zapsaly intervaly, které jsou větší než tři notové řádky, lze oktávy změnit. Odsuvníkem (apostrofem) @code{'} (klávesa Shift+#)
316 posazeným přímo za název noty se oktáva zvýší o jednu, čárkou @code{,} se oktáva o jednu sníží.
318 @lilypond[verbatim,quote]
326 Kvůli změně výšky noty o dvě (či více!) oktávy,
327 se používají postupné odsuvníky @code{''} nebo @code{,,} -- přitom se musí
328 jednat skutečně o dva odsuvníky a ne o uvozovky
329 @code{"}@tie{} (klávesa Shift+2)!
332 @subheading Délky tónů (rytmy)
339 @cindex Čtvrťové noty
340 @cindex Tečkované noty
342 Slovníček: @rglos{beam}, @rglos{duration},
343 @rglos{whole note}, @rglos{half note}, @rglos{quarter note},
346 @notation{Délka} se označuje číslem, jež je zadáno
348 @code{1} pro @notation{Celá nota}, @code{2} pro
349 @notation{Půlová nota}, @code{4} pro @notation{Čtvrťová nota}
350 a tak dále. @notation{Notové nožičky} a @notation{Trámce} jsou
351 přidávány automaticky.
353 Není-li označena žádná délka, používá se délka předcházející noty.
354 Pro první notu je jako výchozí určena čtvrťová nota.
356 @lilypond[verbatim,quote]
360 a16 a a a a32 a a a a64 a a a a a a a a2
364 Aby se vytvořila @notation{Tečkovaná nota}
365 napíše se tečka @code{.} za délkou noty. Délka
366 tečkované noty musí být udána výslovně, tudíž včetně
369 @lilypond[verbatim,quote]
381 @cindex notový zápis pomlk
383 @notation{Pomlka} se zadává tím samým způsobem, jakým se zadává nota; jejím
384 označením je @code{r}@tie{}:
386 @lilypond[verbatim,quote]
394 @subheading Taktové označení
400 Slovníček: @rglos{time signature}.
402 @notation{Druh taktu} lze určit příkazem
405 @lilypond[verbatim,quote]
417 @subheading Vyznačení tempa
419 @cindex Vyznačení tempa
420 @cindex Údaj metronomu
424 Slovníček: @rglos{tempo indication}, @rglos{metronome}.
426 @notation{Vyznačení tempa} a @notation{údaj metronomu} lze
427 zapsat příkazem @code{\tempo}:
429 @lilypond[verbatim,quote]
438 \tempo "Presto" 4 = 120
444 @subheading Notový klíč
454 Slovníček: @rglos{clef}.
456 @notation{Notový klíč} lze zapsat příkazem
459 @lilypond[verbatim,quote]
473 @subheading Vše dohromady
475 Zde je malý příklad, který obsahuje všechna tato vymezení:
477 @lilypond[verbatim,quote]
481 \tempo "Andante" 4 = 120
491 Doporučení pro notový zápis: @ruser{Nastavení výšek tónů},
492 @ruser{Zadání rytmu}, @ruser{Zadání pomlk},
493 @ruser{Udání taktu}, @ruser{Notový klíč}.
496 @node Práce na vstupních souborech
497 @subsection Práce na vstupních souborech
498 @translationof Working on input files
500 @cindex kulaté závorky
501 @cindex Závorky, kulaté
503 @cindex Řádkové poznámky
504 @cindex Blokové poznámky
505 @cindex Psaní velkých a malých písmen
507 @cindex Velká písmena
512 @funindex %@{ ... %@}
515 Zdrojové soubory LilyPondu jsou si podobné se soubory ve většině
516 programovacích jazyků: Obsahují označení verze,
517 je třeba dávat pozor na psaní velkých a malých písmen
518 a prázdné znaky jsou přehlíženy. Výrazy jsou uzavřeny
519 do složených závorek @w{@code{@{ @}}} a poznámky
520 jsou značeny znakem procenta @code{%}
521 nebo obklopeny @w{@code{%@{ @dots{} %@}}}.
523 Zdá-li se to nyní být nesrozumitelné, zde je vysvětlení:
527 @strong{Označení verze}:
528 Každý soubor LilyPondu musí obsahovat označení verze.
529 Označení verze je jeden řádek, který vyhlašuje tu verzi LilyPondu,
530 pro kterou byl onen soubor napsán, jak je to zřejmé na
534 \version "@w{@version{}}"
537 Obvykle je označení verze v souboru napsáno
540 Označení verze je velice důležité ze dvou důvodů: 1. s jeho pomocí
541 se lze pustit do automatické aktualizace vstupních souborů,
542 když je třeba změnit skladbu LilyPondu. 2. je zde zapsána
543 ta verze LilyPondu, která je nutná pro sestavení
546 Když označení verze v souboru chybí, vydá LilyPond
547 během sestavování souboru varování.
550 @strong{Psaní velkých a malých písmen:}
551 Význam znaku se mění podle toho, zda je zapsáno
552 velké (@w{@code{A, B, S, T}}) nebo malé
553 (@w{@code{a, b, s, t}}). Noty se vždy musí zapisovat
554 malými písmeny, @w{@samp{@{ c d e @}}} se chová vhodně,
555 zatímco @w{@samp{@{ C D E @}}} vyrábí chybu.
557 @item @strong{Prázdné znaky:}
558 Nehraje žádnou úlohu, kolik prázdných znaků nebo tabulátorů nebo
559 prázdných řádků se nachází mezi znaky zdrojového souboru.
560 @w{@samp{@{ c d e @}}} znamená totéž co
561 @w{@samp{@{ c @ @ @ @ @ d e @}}} nebo
568 Přirozeně se poslední příklad čte o něco hůře. Dobrým pravidlem je
569 odsazovat bloky kódu dvěma prázdnými znaky:
576 Prázdné znaky @emph{jsou} však nezbytné kvůli oddělení četných
577 skladebných prvků od sebe. Prázdné znaky tedy mohou být @emph{přidány}
578 vždy, ale nesmějí být @emph{odstraněny}. Jelikož chybějící
579 prázdné znaky mohou způsobit velmi podivná chybová hlášení.
580 Je záhodno přidat jeden prázdný znak vždy před a po skladebném
581 prvku, zhruba před a po složených závorkách.
583 @item @strong{Výrazy:}
584 I ten nejmenší úryvek kódu LilyPondu musí být uzavřen ve
585 @strong{@{@tie{}složených@tie{}závorkách@tie{}@}}. Tyto
586 závorky LilyPondu ukazují, že se jedná o hudební výraz patřící
587 k sobě, právě tak jako k sobě patří kulaté závorky @q{()} v matematice.
588 Závorky by měly být pokaždé obklopeny prázdným znakem, abychom se vyhnuli
589 dvojznačnostem. Má to pak ještě být tak, aby se nacházely
590 na začátku nebo na konci řádku.
592 Příkaz pro LilyPond následovaný jednoduchým výrazem
593 v závorkách (jako například @q{@w{@code{@bs{}relative c' @{ @dots{} @}}}})
594 je též hodnocen jako jednotlivý hudební výraz.
597 @cindex Řádkové poznámky
598 @cindex Blokové poznámky
602 Poznámka je připomínkou lidskému čtenáři zdrojového souboru.
603 Při zpracování souboru je programem přehlížena, takže na tiskový
604 výstup not nemá žádný účinek.
605 Jsou dva rozdílné druhy poznámek. Znak procenta
606 @q{%} předchází řádkové poznámce: vše po tomto znaku
607 je v tomto řádku přehlíženo.
608 Obvykle je řádková poznámka připsána @emph{nad} kódem,
609 ke kterému se vztahuje.
613 % Tato poznámka se odvolává na H
618 Bloková poznámka je celým úryvkem s poznámkou.
619 Vše, co je obklopeno @code{%@{}
620 a @code{%@}}, se přehlíží. Znamená to,
621 že jedna bloková poznámka se nemůže nacházet v jiné
622 blokové poznámce. Když byste to zkusili,
623 ukončí již první @code{%@}} @emph{obě}
624 blokové poznámky. Následující příklad ukazuje jedno
625 možné použití poznámek:
628 % Noty pro zajiskření zajiskření zde
632 Tyto řádky a noty dole jsou přehlíženy,
633 protože se nacházejí v jedné blokové
643 @node Vypořádání se s chybami
644 @section Vypořádání se s chybami
645 @translationof Dealing with errors
649 Někdy LilyPond nevytvoří notový obraz takový, jaký jste očekávali. Tento
650 úryvek poskytuje několik odkazů, aby vám pomohl při řešení
651 potíží, se kterými byste se mohli setkat.
655 * Obecné rady k řešení chyb::
656 * Některé časté chyby::
659 @node Obecné rady k řešení chyb
660 @subsection Obecné rady k řešení chyb
661 @translationof General troubleshooting tips
663 Řešení chyb při potížích s LilyPondem může pro člověka, který je
664 zvyklý na obrazové uživatelské rozhraní, představovat velkou výzvu, protože
665 neplatné vstupní soubory vytvořeny být mohou. Když se tak stane, je
666 logický postup pustit se do toho, potíže určit a řešit, tou nejlepší
667 cestou. Některé směrnice, jak se tyto potíže můžete naučit řešit,
668 se nacházejí v @rprogram{Řešení potíží}.
671 @node Některé časté chyby
672 @subsection Některé časté chyby
673 @translationof Some common errors
678 Jsou některé běžné chyby, které se dají vyřešit obtížně, když má člověk
679 jen hlášení chyb v souboru s chybami. Blíže budou osvětleny v
680 @rprogram{Časté chyby}.
684 @node Jak číst příručky
685 @section Jak číst příručky
686 @translationof How to read the manuals
688 Tato část ukazuje, jak lze dokumentaci číst účinně,
689 a vysvětluje také některé užitečné vlastnosti internetové
693 * Vypuštěný materiál::
694 * Klepnutelné příklady::
695 * Přehled o příručkách::
699 @node Vypuštěný materiál
700 @subsection Vypuštěný materiál
701 @translationof Omitted material
703 @cindex Příručka, čtení
704 @cindex Jak číst příručky
705 @cindex Čtení příručky
706 @cindex Příklady, klepnutelné
707 @cindex Klepnutelné příklady
710 @cindex Sestavit soubory, odkazy
711 @cindex Sestavení souborů, odkazy
712 @cindex Odkazy pro sestavení souborů
714 LilyPondovský kód musí být vždy obklopen znaky složených závorek @code{@{ @}} nebo
715 kódem @w{@code{@bs{}relative c'' @{ @dots{} @}}}, jak je to ukázáno
716 v části @ref{Práce na vstupních souborech,,práci na vstupních souborech}.
717 Ve zbytku této příručky se toho ovšem většina příkladů vzdá.
718 Abyste tyto příklady napodobil, můžete zkopírovat odpovídající zdrojový
719 kód a vložit jej do textového souboru, ale přitom
720 @strong{musíte} vložit
721 @w{@code{@bs{}relative c'' @{ @dots{} @}}}, jak je to ukázáno zde:
725 @dots{}zde přijde příklad@dots{}
729 Proč se zde většinou vynechávají závorky? Většina příkladů
730 může být nakopírována do delšího hudebního díla, a potom přirozeně
731 není smysluplné, když se k tomu nachomýtne
732 @w{@code{@bs{}relative c'' @{ @dots{} @}}}; @code{\relative} nesmí
733 být zapsán uvnitř jiného @code{\relative},
734 proto je zde vynechán, aby příklady pracovaly i v jiném
735 prostředí. Kdyby byla u každého příkladu zapsána
736 @w{@code{@bs{}relative c'' @{ @dots{} @}}},
737 nemohly by se malé příklady z dokumentace jednoduše přidat
738 do vašeho vlastního notového textu. Většina uživatelů chce noty
739 přidat do již jsoucího souboru někde vprostřed, a z toho důvodu
740 byl vztažný režim v příkladech v příručce
743 Myslete také na to, že každý soubor LilyPondu má mít označení verze
744 příkazem @code{\version}. Protože jsou příklady v příručkách úryvky
745 a nikoli úplnými soubory, chybí zde označení verze. Vždy byste je ale
746 do svých vlastních souborů měli vložit.
749 @node Klepnutelné příklady
750 @subsection Klepnutelné příklady
751 @translationof Clickable examples
753 @warning{Tato vlastnost je pouze v dokumentaci HTML.}
755 Mnoho lidí se učí programům tím, že se v nich jednoduše vrtají. Jde
756 to i s LilyPondem. Když ve verzi HTML této příručky klepnete na
757 nějaké vyobrazení, obdržíte přesný kód LilyPondu, jenž byl
758 použit pro sazbu obrázku. Vyzkoušejte to s tímto
765 c''4-\markup { \bold \huge { Klepněte sem! } }
769 Když zkopírujete jednoduše vše, co se nachází v úryvku
770 @qq{ly snippet}, a vložíte to do textového souboru,
771 máte již hotovou předlohu pro další pokusy.
772 Experimente. Abyste sám dosáhl téhož vzhledu, jaký je v příkladu,
773 musíte zkopírovat vše od řádku @qq{Start
774 cut-&-pastable section} až do konce souboru.
779 @n ode Navádění klávesnicí
780 @s ubsection Navádění klávesnicí
781 @t ranslationof Keyboard navigation
783 @warning{Tato funkce je pouze ve verzi HTML příručky.}
785 @c TODO: once this is figured out, insert it here.
787 V současnosti se na této funkci pracuje.
791 @node Přehled o příručkách
792 @subsection Přehled o příručkách
793 @translationof Overview of manuals
796 Pro LilyPond je hodně dokumentace. Noví uživatelé jsou často popleteni
797 tím, které části z ní mají číst, a tak se stává, že někdy nejsou
798 čteny její důležité části.
800 @warning{Nepřeskakujte, prosím, žádné důležité části
801 dokumentace. Jinak pro vás bude později o hodně těžší
802 rozumět pozdějším částem.}
807 @strong{Předtím než @emph{cokoli} vyzkoušíte}: Přečtěte si části
808 @ref{Cvičení} a @ref{Běžný notový zápis}. Když narazíte
809 na hudební odborné pojmy, které neznáte,
810 podívejte se na ně v části @rglosnamed{Top, Slovníček}.
813 @strong{Předtím než napíšete úplný kousek}: Přečtěte si část
814 @ref{Základní pojmy} v příručce k učení se.
815 Potom se můžete na pro váš projekt důležité části podívat
816 v @rusernamed{Top, Doporučení pro notový zápis}.
819 @strong{Předtím než se pokusíte měnit obvyklý notový zápis}:
820 Přečtěte si @ref{Ladění výstupu,,o ladění výstupu} v příručce k učení se.
823 @strong{Předtím než se pustíte do většího projektu}: Přečtěte si část
824 @rprogram{Návrhy, jak psát soubory}
825 v části věnované používání programu.