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
15 @c Translation checkers:
19 @translationof Tutorial
21 Tato kapitola čtenáři představuje základní práci s LilyPondem.
24 * Přeložení zdrojového souboru::
25 * Práce na vstupních souborech::
26 * Vypořádání se s chybami::
27 * Jak se má příručka číst::
31 @node Přeložení zdrojového souboru
32 @subsection Přeložení zdrojového souboru
33 @translationof Compiling a file
35 Tento úryvek uvádí do @qq{Sestavení} -- do
36 procesu zpracování vstupních souborů LilyPondu (který popisuje),
37 aby byl vytvořen výstupní soubor.
47 @subsection Zadání not
48 @translationof Entering input
52 @cindex Příklad, první
53 @cindex Přeložení zdrojového souboru
54 @cindex Psaní velkých a malých písmen
55 @cindex Zdrojový text, překlad
59 @qq{Sestavení} je pojem, který se používá pro
60 přeměnu vstupního souboru pro Lilypond programem LilyPond do
61 notového výstupu. Výstupními soubory jsou v první řadě soubory
62 PDF (pro prohlížení a tisku), MIDI (pro přehrávání)
63 a PNG (pro používání na internetových stránkách). Vstupními soubory
64 pro LilyPond jsou prosté textové soubory.
66 První příklad ukazuje, jak takový
67 jednoduchý vstupní soubor může vypadat.
75 Obrazovým výstupem je:
77 @c in this case we don't want verbatim
84 @warning{V každém souboru LilyPond musejí být nastaveny
85 @strong{@{ kulaté závorky @}} kolem not nebo
87 Před a za závorkami mají být zadány prázdné znaky,
88 aby ve spojení s vlastními symboly not nevznikly
90 Na začátku a na konci řádku mohou být tyto prázdné znaky
91 vynechány také. Může se stát, že v této příručce
92 závorky v některých příkladech chybí, ale je třeba vždy
93 myslet na to, aby se ve vlastních souborech používaly!
94 Více informací ke znázornění příkladů v této příručce
95 podává úryvek @ref{Jak se má příručka číst}.}
97 Dodatečně LilyPond rozlišuje @strong{Psaní velkých a malých písmen}.
98 @w{@samp{ @{ c d e @}}} je přípustný kód,
99 @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 trvat minutu
143 nebo i déle, protože program nejprve vyhledává všechna písma,
144 LilyPond běží o mnoho rychleji.}
152 @translationof MacOS X
154 @cindex Spuštění programu, MacOS X
155 @cindex MacOS X, spuštění LilyPondu
162 @translationof Windows
164 @cindex Windows, spuštění LilyPondu
169 @node Příkazový řádek
170 @subsection Příkazový řádek
171 @translationof Command-line
173 @cindex Unix, spuštění LilyPondu
179 @node Jak se píší vstupní soubory
180 @section Wie werden Eingabe-Dateien geschrieben
181 @translationof How to write input files
183 Tento úryvek vysvětluje základní skladbu LilyPondu a pomáhá
184 na začátku se zápisem vstupního souboru pro LilyPond-Eingabedatei.
187 * Jednoduchý notový zápis::
188 * Práce na vstupních souborech::
193 @node Jednoduchý notový zápis
194 @subsection Jednoduchý notový zápis
195 @translationof Simple notation
197 @cindex jednoduchý notový zápis
198 @cindex Notový zápis, jednoduchý
200 LilyPond automaticky přidává některé součásti notového obrazu. V
201 následujícím příkladu jsou zadány jen čtyři výšky tónů, ale LilyPond přesto
202 zapíše klíč, údaj o taktu a délky not.
204 @lilypond[verbatim,quote]
211 Tato nastavení je možné změnit, ale ve většině případů
212 jsou automatické hodnoty v zásadě použitelné.
214 @subheading Výšky tónů
217 @cindex relativní režim
218 @cindex Odsuvník (apostrof)
220 @cindex Předznamenání a relativní režim
221 @cindex relativní režim a předznamenání
229 Slovníček: @rglos{pitch}, @rglos{interval},
230 @rglos{scale}, @rglos{middle C}, @rglos{octave},
233 @c Addition for czech users about pitch naming conventions
234 Výšky tónů se zadávají malými písmeny, která odpovídají názvu noty.
235 Je ale důležité znát, že LilyPond ve svém výchozím nastavení
236 používá anglické názvy not. Až na výjimku tyto odpovídají
237 českým, proto se přednastavení LilyPondu pro toto
238 cvičení ponechává. Touto @emph{výjimkou} je nota h -- v
239 LilyPondu se musí na místo toho napsat písmeno b! České b je naproti
240 tomu zapsáno jako bes, his se proti tomu zapíše jako bis. Podívejte se také na
241 @ruser{Předznamenání} a @ruser{Názvy not v jiných řečích}. Zde se popisuje,
242 jak se používají české názvy not.
245 Nejjednoduššeji lze noty zadávat v režimu @code{\relative}.
246 V tomto režimu je oktáva noty vbrána automaticky s tím, že se
247 předpokládá, že následující nota je zapsána vždy tak blízko, jak
248 je to jen možné, ve vztahu k předchozí notě, což znamená, že je
249 zapsána nanejvýš o tři notové řádky výše nebo níže než předchozí
250 nota. Začněme naším prvním příkladem notového zápisu,
251 se @notation{Stupnice,,stupnicí}, kde stojí další nota
252 vždy jen o jeden notový řádek nad předchozím.
255 @lilypond[verbatim,quote]
256 % Počáteční bod napsat na jednočárkovaném C
263 První notou je @notation{jednočárkované C}. Každá následující nota
264 se nachází tak blízko, jak je to jen možné za předchozí -- první
265 @q{C} se takto počítá jako C od
266 jednočárkovaného C. Nato následuje nejbližší možné
267 D ve vztahu k předcházející notě. S těmito pravidly lze v
268 režimu @code{\relative} zobrazit i melodie s většími
271 @lilypond[verbatim,quote]
279 Není nutné, aby první nota melodie začínala
280 notou, která udává první notovou výšku.
281 První nota (das @q{D}) z předchozího příkladu je následujícím D,
282 počítáno od jednočárkovaného C.
284 Tím, že člověk přidává odsuvníky (apostrofy) @code{'}
285 (klávesa Shift+#) nebo čárky @code{,} k @w{@code{\relative c' @{}}, nebo
286 je odstraňuje, může být oktáva první výšky tónu změněna:
289 @lilypond[verbatim,quote]
296 Relativní režim se může zpočátku jevit matoucí, ale je to ten
297 nejjednodušší způsob, jak zapsat většinu melodií. Podívejme se na to,
298 H (@code{b} ve skladbě LilyPondu), které se v houslovém klíči
299 nachází na prostřední lince, můžeme směrem vzhůru napsat C, D a E,
300 a A, G a F směrem dolů pod H. Když tedy notou, která následuje po
301 H, je C, D nebo E, napíše ji LilyPond nad
302 H, když je to A, G nebo F, je napsáno pod ním.
305 @lilypond[verbatim,quote]
307 b c % c je 1 řádek nahoru, tedy c nad b
308 b d % d je 2 řádky nahoru, nebo 5 dolů, tedy d nad b
309 b e % e je 3 nahoru, nebo 4 dolů, tedy e pod b
310 b a % a je 6 nahoru, nebo 1 dolů, tedy a pod b
311 b g % g je 5 nahoru, nebo 2 dolů, tedy g pod b
312 b f % f je 4 nahoru, nebo 3 dolů, tedy f pod b
316 Stejný výpočet se provádí i tehdy, když je jedna z not zvýšena
317 nebo snížena. @notation{Předznamenání,,předznamenání} jsou
318 při výpočtu @strong{zcela přehlížena}. Přesně ten samý
319 výpočet se obdobně provádí od každé následující výšky tónu po
320 další výšku tónu znovu.
322 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+#)
323 posazeným přímo za název noty se oktáva zvýší o jednu, čárkou @code{,} se oktáva o jednu sníží.
325 @lilypond[verbatim,quote]
333 Kvůli změně výšky noty o dvě (či více!) oktávy,
334 se používají postupné odsuvníky @code{''} nebo @code{,,} -- přitom se musí
335 jednat skutečně o dva odsuvníky a ne o uvozovky
336 @code{"}@tie{} (klávesa Shift+2)!
339 @subheading Délky tónů (rytmy)
346 @cindex Čtvrťové noty
347 @cindex Tečkované noty
349 Slovníček: @rglos{beam}, @rglos{duration},
350 @rglos{whole note}, @rglos{half note}, @rglos{quarter note},
353 @notation{Délka} se označuje číslem, jež je zadáno
355 @code{1} pro @notation{Celá nota,,celou notu}, @code{2} pro
356 @notation{Půlová nota,,půlovou notu}, @code{4} pro @notation{Čtvrťová nota,,čtvrťovou notu}
357 a tak dále. @notation{Notové nožičky} a @notation{Trámce,,trámce} jsou
358 přidávány automaticky.
360 Není-li označena žádná délka, používá se délka předcházející noty.
361 Pro první notu je jako výchozí určena čtvrťová nota.
363 @lilypond[verbatim,quote]
367 a16 a a a a32 a a a a64 a a a a a a a a2
371 Kvůli vytvoření @notation{Tečkovaná nota,,tečkované noty}
372 je jednoduše za délkou noty napsána tečka @code{.}. Délka
373 tečkované noty musí být udána výslovně, tudíž včetně
376 @lilypond[verbatim,quote]
388 @cindex notový zápis pomlk
390 @notation{Pomlka} se zadává tím samým způsobem, jakým se zadává nota; jejím
391 označením je @code{r}@tie{}:
393 @lilypond[verbatim,quote]
401 @subheading Udání taktu
408 Slovníček: @rglos{time signature}.
410 @notation{Druh taktu} lze určit příkazem
413 @lilypond[verbatim,quote]
425 @subheading Vyznačení tempa
427 @cindex Vyznačení tempa
428 @cindex Údaj metronomu
433 Slovníček: @rglos{tempo indication}, @rglos{metronome}.
435 @notation{Vyznačení tempa} a @notation{údaj metronomu} lze
436 zapsat příkazem @code{\tempo}:
438 @lilypond[verbatim,quote]
447 \tempo "Presto" 4 = 120
453 @subheading Notový klíč
464 Slovníček: @rglos{clef}.
466 @notation{Notový klíč} lze zapsat příkazem
469 @lilypond[verbatim,quote]
483 @subheading Vše dohromady
485 Zde je malý příklad, který obsahuje všechna tato vymezení:
487 @lilypond[verbatim,quote]
491 \tempo "Andante" 4 = 120
501 Doporučení pro notový zápis: @ruser{Nastavení výšek tónů},
502 @ruser{Zadání rytmu}, @ruser{Zadání pomlk},
503 @ruser{Udání taktu}, @ruser{Notový klíč}.
506 @node Práce na vstupních souborech
507 @subsection Práce na vstupních souborech
508 @translationof Working on input files
510 @cindex kulaté závorky
511 @cindex Závorky, kulaté
513 @cindex Řádkové poznámky
514 @cindex Blokové poznámky
515 @cindex Psaní velkých a malých písmen
517 @cindex Velká písmena
522 @funindex %@{ ... %@}
525 Zdrojové soubory LilyPondu jsou si podobné se soubory ve většině
526 programovacích jazyků: Obsahují označení verze,
527 je třeba dávat pozor na psaní velkých a malých písmen
528 a prázdné znaky jsou přehlíženy. Výrazy jsou uzavřeny
529 do kulatých závorek @w{@code{@{ @}}} a poznámky
530 jsou opatřeny poznámkou znaku procenta @code{%}
531 nebo obklopeny @w{@code{%@{ @dots{} %@}}}.
533 Zdá-li se to nyní být nesrozumitelné, zde je vysvětlení:
537 @strong{Označení verze}:
538 Každý soubor LilyPondu musí obsahovat označení verze.
539 Označení verze je jeden řádek, který vyhlašuje tu verzi LilyPondu,
540 pro kterou byl onen soubor napsán, jak je to zřejmé na
544 \version "@w{@version{}}"
547 Obvykle je označení verze v souboru napsáno
550 Označení verze je velice důležité ze dvou důvodů: 1. s jeho pomocí
551 se lze pustit do automatické aktualizace vstupních souborů,
552 když je třeba změnit skladbu LilyPond-. 2. je zde zapsána
553 ta verze LilyPondu, která je nutná pro sestavení
556 Když označení verze v souboru chybí, vydá LilyPond
557 během sestavování souboru varování.
560 @strong{Psaní velkých a malých písmen:}
561 Význam znaku se mění podle toho, zda je zapsáno
562 velké (@w{@code{A, B, S, T}}) nebo malé
563 (@w{@code{a, b, s, t}}). Noty se vždy musí zapisovat
564 malými písmeny, @w{@samp{@{ c d e @}}} se chová vhodně,
565 zatímco @w{@samp{@{ C D E @}}} vyrábí chybu.
567 @item @strong{Prázdné znaky:}
568 Nehraje žádnou úlohu, kolik prázdných znaků nebo tabulátorů nebo
569 prázdných řádků se nachází mezi znaky zdrojového souboru.
570 @w{@samp{@{ c d e @}}} znamená totéž co
571 @w{@samp{@{ c @ @ @ @ @ d e @}}} nebo
578 Přirozeně se poslední příklad čte o něco hůře. Dobrým pravidlem je
579 odsazovat bloky kódu dvěma prázdnými znaky:
586 Prázdné znaky @emph{jsou} však nezbytné kvůli oddělení četných
587 skladebných prvků od sebe. Prázdné znaky tedy mohou být @emph{přidány}
588 vždy, ale nesmějí být @emph{odstraněny}. Jelikož chybějící
589 prázdné znaky mohou způsobit velmi podivná chybová hlášení,
590 naznačuje se, přidat jeden prázdný znak vždy před a po skladebném
591 prvku, zhruba před a po kulatých závorkách.
593 @item @strong{Výrazy:}
594 I ten nejmenší úryvek kódu LilyPondu musí být uzavřen v
595 @strong{@{@tie{}kulatých@tie{}závorkách@tie{}@}}. Tyto
596 závorky LilyPondu ukazují, že se jedná o hudební výraz patřící
597 k sobě, právě tak jako k sobě patří závorky @q{()} v matematice.
598 Závorky by měly být pokaždé obklopeny prázdným znakem, abychom se vyhnuli
599 dvojznačnostem. Má to pak ještě být tak, aby se nacházely
600 na začátku nebo na konci řádku.
602 Příkaz pro LilyPond následovaný jednoduchým výrazem
603 v závorkách (jako například @q{@w{@code{@bs{}relative c' @{ @dots{} @}}}})
604 je též hodnocen jako jednotlivý hudební výraz.
607 @cindex Řádkové poznámky
608 @cindex Blokové poznámky
612 Poznámka je připomínkou lidskému čtenáři zdrojového souboru.
613 Při zpracování souboru je programem přehlížena, takže na tiskový
614 výstup not nemá žádný účinek.
615 Jsou dva rozdílné druhy poznámek. Znak procenta
616 @q{%} předchází řádkové poznámce: Vše po tomto znaku
617 je v tomto řádku přehlíženo.
618 Obvykle je ke kódu připsána poznámka @emph{über},
619 ke které se tento vztahuje.
623 % Tato poznámka se odvolává na H
628 Bloková poznámka je celým úryvkem s poznámkou.
629 Vše, co je obklopeno @code{%@{}
630 a @code{%@}}, se přehlíží. Znamená to,
631 že jedna bloková poznámka se nemůže nacházet v jiné
632 blokové poznámce. Když byste to měli zkusit,
633 ukončí již první @code{%@}} @emph{obě}
634 blokové poznámky. Následující příklad ukazuje jedno
635 možné použití poznámek:
638 % Noty pro zajiskření zajiskření zde
642 Tyto řádky a noty dole jsou přehlíženy,
643 protože se nacházejí v jedné blokové
653 @node Vypořádání se s chybami
654 @section Vypořádání se s chybami
655 @translationof Dealing with errors
659 Někdy LilyPond nevytvoří notový obraz takový, jaký jste očekávali. Tento
660 úryvek poskytuje několik odkazů, aby vám pomohl při řešení
665 * Obecné rady k řešení chyb::
666 * Některé časté chyby::
669 @node Obecné rady k řešení chyb
670 @subsection Obecné rady k řešení chyb
671 @translationof General troubleshooting tips
673 Řešení chyb při potížích s LilyPondem může pro člověka, který je
674 zvyklý na obrazové uživatelské rozhraní, představovat velkou výzvu, protože
675 neplatné vstupní soubory vytvořeny být mohou. Když se tak stane, je
676 logický postup pustit se do toho, potíže určit a řešit, nejlepší
677 cestou. Některé směrnice, jak se tyto potíže můžete naučit řešit,
678 se nacházejí v @rprogram{Troubleshooting}.
681 @node Některé časté chyby
682 @subsection Některé časté chyby
683 @translationof Some common errors
688 Jsou některé běžné chyby, které se dají vyřešit obtížně, když má člověk
689 jen hlášení chyb v souboru s chybami. Blíže budou osvětleny v
690 @rprogram{Common errors}.
694 @node Jak se mají příručky číst
695 @section Jak se mají příručky číst
696 @translationof How to read the manuals
698 Tato část ukazuje, jak lze dokumentaci číst účinně a
699 a vysvětluje také některé užitečné vlastnosti internetové
703 * Vypuštěný materiál::
704 * Klepnutelné příklady::
705 * Přehled o příručkách::
709 @node Vypuštěný materiál
710 @subsection Vypuštěný materiál
711 @translationof Omitted material
713 @cindex Příručka, čtení
714 @cindex Jak se má příručka číst
715 @cindex Čtení příručky
716 @cindex Příklady, klepnutelné
717 @cindex Klepnutelné příklady
720 @cindex Sestavit soubory, odkazy
721 @cindex Sestavení souborů, odkazy
722 @cindex Odkazy pro sestavení souborů
724 LilyPond-Code musí být vždy obklopen znakem @code{@{ @}} nebo
725 @w{@code{@bs{}relative c'' @{ @dots{} @}}}, jak je to ukázáno
726 v @ref{Práce na vstupních souborech}.
727 Ve zbytku této příručky se toho ovšem většina příkladů vzdá.
728 Abyste je napodobil, můžete zkopírovat odpovídající zdrojový
729 kód a vložit jej do textového souboru, ale přitom
730 @strong{musíte} vložit
731 @w{@code{@bs{}relative c'' @{ @dots{} @}}}, jak je to ukázáno zde:
735 @dots{}zde jeden příklad@dots{}
739 Proč se zde většinou vynechávají závorky? Většina příkladů
740 může být nakopírována do delšího hudebního díla, a potom přirozeně
741 není smysluplné, když se k tomu nachomýtne
742 @w{@code{@bs{}relative c'' @{ @dots{} @}}}; @code{\relative} nesmí
743 být zapsán uvnitř jiného @code{\relative},
744 proto je zde vynechán, aby příklady pracovaly i v jiné
745 souvislosti. Kdyby byla u každého příkladu zapsána
746 @w{@code{@bs{}relative c'' @{ @dots{} @}}},
747 nemohl byste malé příklady z dokumentace jednoduše přidat
748 do svého vlastního notového textu. Většina uživatelů chce noty
749 přidat do již jsoucího souboru někde vprostřed, a z toho důvodu
750 byl relativní režim v příkladech v příručce
753 Myslete také na to, že každý soubor LilyPondu má mít označení verze
754 příkazem @code{\version}. Protože jsou příklady v příručkách úryvky
755 a nikoli úplnými soubory, chybí zde označení verze. Vždy byste je ale
756 do svých vlastních souborů měl vložit.
759 @node Klepnutelné příklady
760 @subsection Klepnutelné příklady
761 @translationof Clickable examples
763 @warning{Tato vlastnost je pouze v dokumentaci HTML.}
765 Mnoho lidí se učí programům tím, že se v nich jednoduše vrtají. Jde
766 to i s LilyPondem. Když ve verzi HTML této příručky klepnete na
767 nějaké vyobrazení, obdržíte přesný kód LilyPondu, jenž byl
768 použit pro sazbu obrázku. Vyzkoušejte to s tímto
775 c4-\markup { \bold \huge { Klepněte sem! } }
779 Když zkopírujete jednoduše vše, co se nachází v úryvku
780 @qq{ly snippet}, a vložíte to do textového souboru,
781 máte již hotovou předlohu pro další pokusy.
782 Experimente. Abyste sám dosáhl téhož vzhledu, jaký je v příkladu,
783 musíte zkopírovat vše od řádku @qq{Start
784 cut-&-pastable section} až do konce souboru.
789 @n ode Navádění klávesnicí
790 @s ubsection Navádění klávesnicí
791 @translationof Keyboard navigation
793 @warning{Tato funkce je pouze ve verzi HTML příručky.}
795 @c TODO: once this is figured out, insert it here.
797 V současnosti se na této funkci pracuje.
801 @node Přehled o příručkách
802 @subsection Přehled o příručkách
803 @translationof Overview of manuals
806 Pro LilyPond je hodně dokumentace. Noví uživatelé jsou často popleteni
807 tím, které části z ní mají číst, a tak se stává, že někdy nejsou
808 čteny její důležité části.
810 @warning{Nepřeskakujte, prosím, žádné důležité části
811 dokumentace. Jinak pro vás bude později o hodně těžší
812 rozumět pozdějším částem.}
817 @strong{Předtím než @emph{cokoli} vyzkoušíte}: Přečtěte si části
818 @ref{Cvičení} a @ref{Běžný notový zápis}. Když narazíte
819 hudební odborné pojmy, které neznáte,
820 podívejte se na ně v @rglosnamed{Top, Slovníček}.
823 @strong{Předtím než napíšete úplný kousek}: Přečtěte si část
824 @ref{Základní pojmy} v příručce k učení se.
825 Potom se můžete na pro váš projekt důležité části podívat
826 v @rusernamed{Top, Doporučení pro notový zápis}.
829 @strong{Předtím než se pokusíte měnit obvyklý notový zápis}:
830 Přečtěte si @ref{Změna výstupu,,o změně výstupu} v příručce k učení se.
833 @strong{Předtím než se pustíte do většího projektu}: Přečtěte si část
834 @rprogram{Návrhy, jak psát soubory}
835 v části věnované používání programu.