@c -*- coding: utf-8; mode: texinfo; documentlanguage: cs -*-

@ignore
    Translation of GIT committish: 4f7427e7a314a71bde16559247885544256b8213

    When revising a translation, copy the HEAD committish of the
    version that you are working on.  For details, see the Contributors'
    Guide, node Updating translation committishes..
@end ignore



@c \version "2.19.21"
@c Translators: Pavel Fric

@node Cvičení
@chapter Cvičení
@translationof Tutorial

Tato kapitola čtenáři představuje základní práci s LilyPondem.

@menu
* Přeložení zdrojového souboru::
* Jak se píší vstupní soubory::
* Vypořádání se s chybami::
* Jak číst příručky::
@end menu

@node Přeložení zdrojového souboru
@section Přeložení zdrojového souboru
@translationof Compiling a file

@cindex Sestavení
@cindex První příklad
@cindex Příklad, první
@cindex Přeložení zdrojového souboru
@cindex Psaní velkých a malých písmen
@cindex Zdrojový text, překlad
@cindex Velká písmena
@cindex Malá písmena

@qq{Sestavení} je pojem, který se používá pro
přeměnu vstupního souboru pro LilyPond programem LilyPond do
notového výstupu.  Výstupními soubory jsou v první řadě soubory
PDF (pro prohlížení a tisku), MIDI (pro přehrávání)
a PNG (pro používání na internetových stránkách).  Vstupními soubory
pro LilyPond jsou prosté textové soubory.

První příklad ukazuje, jak takový
jednoduchý vstupní soubor může vypadat.

@example
@{
  c' e' g' e'
@}
@end example

Obrazovým výstupem je:

@c  in this case we don't want verbatim
@lilypond[quote]
{
  c' e' g' e'
}
@end lilypond

@warning{V každém souboru LilyPond musejí být nastaveny
@strong{@{ kulaté závorky @}} kolem not nebo
písňového textu.
Před a za závorkami mají být zadány prázdné znaky,
aby ve spojení s vlastními symboly not nevznikly
žádné nejasnosti.
Na začátku a na konci řádku mohou být tyto prázdné znaky
vynechány také. Může se stát, že v této příručce
závorky v některých příkladech chybí, ale je třeba vždy
myslet na to, aby se ve vlastních souborech používaly!
Více informací ke znázornění příkladů v této příručce
podává úryvek @ref{Jak číst příručky}.}

Dodatečně LilyPond rozlišuje @strong{Psaní velkých a malých písmen}.
@w{@samp{ @{ c d e @}}} je přípustný kód,
@w{@samp{ @{ C D E @}}} naproti tomu vede k chybovému hlášení.



@node Jak se píší vstupní soubory
@section Jak se píší vstupní soubory
@translationof How to write input files

Tento úryvek vysvětluje základní skladbu LilyPondu a pomáhá
na začátku se zápisem vstupního souboru pro LilyPond.

@menu
* Jednoduchý notový zápis::
* Práce na vstupních souborech::
@end menu


@node Jednoduchý notový zápis
@subsection Jednoduchý notový zápis
@translationof Simple notation

@cindex jednoduchý notový zápis
@cindex Notový zápis, jednoduchý

LilyPond přidává některé části notového zápisu automaticky. V
následujícím příkladu jsou zadány jen čtyři výšky tónů, ale LilyPond přesto
zapíše klíč, taktové označení a rytmus (délky not).

@lilypond[verbatim,quote]
{
  c' e' g' e'
}
@end lilypond

@noindent
Tato nastavení je možné změnit, ale ve většině případů
jsou automatické hodnoty v zásadě použitelné.


@subheading Výšky tónů

@cindex Výšky tónů
@cindex Vztažný režim
@cindex Odsuvník (apostrof)
@cindex Čárka
@cindex Předznamenání a vztažný režim
@cindex Vztažný režim a předznamenání

@funindex \relative
@funindex '
@funindex ,

Slovníček: @rglos{pitch}, @rglos{interval},
@rglos{scale}, @rglos{middle C}, @rglos{octave},
@rglos{accidental}.

@c Addition for czech users about pitch naming conventions
Výšky tónů se zadávají malými písmeny, která odpovídají názvu noty.
Je ale důležité znát, že LilyPond ve svém výchozím nastavení
používá anglické názvy not. Až na výjimku tyto odpovídají
českým, proto se přednastavení LilyPondu pro toto
cvičení ponechává. Touto @emph{výjimkou} je nota h -- v
LilyPondu se musí na místo toho napsat písmeno b! České bé je naproti
tomu zapsáno jako bes, his se proti tomu zapíše jako bis. Podívejte se také na
@ruser{Předznamenání} a @ruser{Názvy not v jiných řečích}. Zde se popisuje,
jak se používají české názvy not.
@c end addition

Nejjednoduššeji lze noty zadávat v režimu @code{\relative}.
V tomto režimu je oktáva noty vbrána automaticky s tím, že se
předpokládá, že následující nota je zapsána vždy tak blízko, jak
je to jen možné, ve vztahu k předchozí notě, což znamená, že je
zapsána nanejvýš o tři notové řádky výše nebo níže než předchozí
nota. Začneme naším prvním nejzákladnějším příkladem notového zápisu,
což je @notation{stupnice}, kde stojí další nota
vždy jen o jeden notový řádek nad předchozím.

@c KEEP LY
@lilypond[verbatim,quote]
% Počáteční bod napsat na jednočárkovaném C
\relative {
  c' d e f
  g a b c
}
@end lilypond

První notou je @notation{jednočárkované C}. Každá následující nota
se nachází tak blízko, jak je to jen možné za předchozí -- první
@q{C} se takto počítá jako C od
jednočárkovaného C. Nato následuje nejbližší možné
D ve vztahu k předcházející notě. S těmito pravidly lze v
režimu @code{\relative} zobrazit i melodie s většími
intervaly:

@lilypond[verbatim,quote]
\relative {
  d' f a g
  c b f d
}
@end lilypond

@noindent
Není nutné, aby první nota melodie začínala
notou, která udává první notovou výšku.
První nota (@q{D}) z předchozího příkladu je následujícím D,
počítáno od jednočárkovaného C.

Tím, že člověk přidává odsuvníky (apostrofy) @code{'}
(klávesa Shift+#) nebo čárky @code{,} k @w{@code{\relative c' @{}}, nebo
je odstraňuje, může být oktáva první výšky tónu změněna:

@c KEEP LY
@lilypond[verbatim,quote]
% dvoučárkované C
\relative {
  e'' c a c
}
@end lilypond

Vztažný režim se může zpočátku jevit matoucí, ale je to ten
nejjednodušší způsob, jak zapsat většinu melodií. Podívejme se na to,
H (@code{b} ve skladbě LilyPondu), které se v houslovém klíči
nachází na prostřední lince, můžeme směrem vzhůru napsat C, D a E,
a A, G a F směrem dolů pod H. Když tedy notou, která následuje po
H, je C, D nebo E, napíše ji LilyPond nad
H, když je to A, G nebo F, je napsáno pod ním.

@c KEEP LY
@lilypond[verbatim,quote]
\relative {
  b' c  % c je 1 řádek nahoru, tedy c nad b
  b d  % d je 2 řádky nahoru, nebo 5 dolů, tedy d nad b
  b e  % e je 3 nahoru, nebo 4 dolů, tedy e pod b
  b a  % a je 6 nahoru, nebo 1 dolů, tedy a pod b
  b g  % g je 5 nahoru, nebo 2 dolů, tedy g pod b
  b f  % f je 4 nahoru, nebo 3 dolů, tedy f pod b
}
@end lilypond

Stejný výpočet se provádí i tehdy, když je jedna z not zvýšena
nebo snížena. @notation{Předznamenání} jsou
při výpočtu @strong{zcela přehlížena}. Přesně ten samý
výpočet se obdobně provádí od každé následující výšky tónu po
další výšku tónu znovu.

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+#)
posazeným přímo za název noty se oktáva zvýší o jednu, čárkou @code{,} se oktáva o jednu sníží.

@lilypond[verbatim,quote]
\relative {
  a' a, c' f,
  g g'' a,, f'
}
@end lilypond

@noindent
Kvůli změně výšky noty o dvě (či více!) oktávy,
se používají postupné odsuvníky @code{''} nebo @code{,,} -- přitom se musí
jednat skutečně o dva odsuvníky a ne o uvozovky
@code{"}@tie{} (klávesa Shift+2)!


@subheading Délky tónů (rytmy)

@cindex Délky not
@cindex Délky
@cindex Rytmus
@cindex Celé noty
@cindex Půlové noty
@cindex Čtvrťové noty
@cindex Tečkované noty

Slovníček: @rglos{beam}, @rglos{duration},
@rglos{whole note}, @rglos{half note}, @rglos{quarter note},
@rglos{dotted note}.

@notation{Délka} se označuje číslem, jež je zadáno
přímo k názvu noty.
@code{1} pro @notation{Celá nota}, @code{2} pro
@notation{Půlová nota}, @code{4} pro @notation{Čtvrťová nota}
a tak dále. @notation{Notové nožičky} a @notation{Trámce} jsou
přidávány automaticky.

Není-li označena žádná délka, používá se délka předcházející noty.
Pro první notu je jako výchozí určena čtvrťová nota.

@lilypond[verbatim,quote]
\relative {
  a'1
  a2 a4 a8 a
  a16 a a a a32 a a a a64 a a a a a a a a2
}
@end lilypond

Aby se vytvořila @notation{Tečkovaná nota}
napíše se tečka @code{.} za délkou noty. Délka
tečkované noty musí být udána výslovně, tudíž včetně
čísla.

@lilypond[verbatim,quote]
\relative {
  a'4 a a4. a8
  a8. a16 a a8. a8 a4.
}
@end lilypond


@subheading Pomlky

@cindex Pomlky
@cindex psaní pomlk
@cindex notový zápis pomlk

@notation{Pomlka} se zadává tím samým způsobem, jakým se zadává nota; jejím
označením je @code{r}@tie{}:

@lilypond[verbatim,quote]
\relative {
  a'4 r r2
  r8 a r4 r4. r8
}
@end lilypond


@subheading Taktové označení

@cindex Druh taktu

@funindex \time

Slovníček: @rglos{time signature}.

@notation{Druh taktu} lze určit příkazem
@code{\time}:

@lilypond[verbatim,quote]
\relative {
  \time 3/4
  a'4 a a
  \time 6/8
  a4. a
  \time 4/4
  a4 a a a
}
@end lilypond


@subheading Vyznačení tempa

@cindex Vyznačení tempa
@cindex Údaj metronomu

@funindex \tempo

Slovníček: @rglos{tempo indication}, @rglos{metronome}.

@notation{Vyznačení tempa} a @notation{údaj metronomu} lze
zapsat příkazem @code{\tempo}:

@lilypond[verbatim,quote]
\relative {
  \time 3/4
  \tempo "Andante"
  a'4 a a
  \time 6/8
  \tempo 4. = 96
  a4. a
  \time 4/4
  \tempo  "Presto" 4 = 120
  a4 a a a
}
@end lilypond


@subheading Notový klíč

@cindex Klíč
@cindex Alt
@cindex Soprán
@cindex Tenor
@cindex Bas

@funindex \clef

Slovníček: @rglos{clef}.

@notation{Notový klíč} lze zapsat příkazem
@code{\clef}:

@lilypond[verbatim,quote]
\relative {
  \clef "treble"
  c'1
  \clef "alto"
  c1
  \clef "tenor"
  c1
  \clef "bass"
  c1
}
@end lilypond


@subheading Vše dohromady

Zde je malý příklad, který obsahuje všechna tato vymezení:

@lilypond[verbatim,quote]
\relative {
  \clef "bass"
  \time 3/4
  \tempo "Andante" 4 = 120
  c,2 e8 c'
  g'2.
  f4 e d
  c4 c, r4
}
@end lilypond


@morerefs
Doporučení pro notový zápis: @ruser{Nastavení výšek tónů},
@ruser{Zadání rytmu}, @ruser{Zadání pomlk},
@ruser{Udání taktu}, @ruser{Notový klíč}.


@node Práce na vstupních souborech
@subsection Práce na vstupních souborech
@translationof Working on input files

@cindex kulaté závorky
@cindex Závorky, kulaté
@cindex Poznámky
@cindex Řádkové poznámky
@cindex Blokové poznámky
@cindex Psaní velkých a malých písmen
@cindex Výrazy
@cindex Velká písmena
@cindex Malá písmena

@funindex { ... }
@funindex %
@funindex %@{ ... %@}


Zdrojové soubory LilyPondu jsou si podobné se soubory ve většině
programovacích jazyků: Obsahují označení verze,
je třeba dávat pozor na psaní velkých a malých písmen
a prázdné znaky jsou přehlíženy. Výrazy jsou uzavřeny
do složených závorek @w{@code{@{ @}}} a poznámky
jsou značeny znakem procenta @code{%}
nebo obklopeny @w{@code{%@{ @dots{} %@}}}.

Zdá-li se to nyní být nesrozumitelné, zde je vysvětlení:

@itemize
@item
@strong{Označení verze}:
Každý soubor LilyPondu musí obsahovat označení verze.
Označení verze je jeden řádek, který vyhlašuje tu verzi LilyPondu,
pro kterou byl onen soubor napsán, jak je to zřejmé na
příkladu:

@example
\version "@w{@version{}}"
@end example

Obvykle je označení verze v souboru napsáno
nahoře.

Označení verze je velice důležité ze dvou důvodů: 1. s jeho pomocí
se lze pustit do automatické aktualizace vstupních souborů,
když je třeba změnit skladbu LilyPondu. 2. je zde zapsána
ta verze LilyPondu, která je nutná pro sestavení
souboru.

Když označení verze v souboru chybí, vydá LilyPond
během sestavování souboru varování.

@item
@strong{Psaní velkých a malých písmen:}
Význam znaku se mění podle toho, zda je zapsáno
velké (@w{@code{A, B, S, T}}) nebo malé
 (@w{@code{a, b, s, t}}). Noty se vždy musí zapisovat
malými písmeny,  @w{@samp{@{ c d e @}}} se chová vhodně,
zatímco @w{@samp{@{ C D E @}}} vyrábí chybu.

@item @strong{Prázdné znaky:}
Nehraje žádnou úlohu, kolik prázdných znaků nebo tabulátorů nebo
prázdných řádků se nachází mezi znaky zdrojového souboru.
@w{@samp{@{ c d e @}}} znamená totéž co
@w{@samp{@{ c @ @ @ @ @  d e @}}} nebo
@example
@{ c4                        d
                     e @}
@end example

@noindent
Přirozeně se poslední příklad čte o něco hůře. Dobrým pravidlem je
odsazovat bloky kódu dvěma prázdnými znaky:
@example
@{
  c4 d e
@}
@end example

Prázdné znaky @emph{jsou} však nezbytné kvůli oddělení četných
skladebných prvků od sebe.  Prázdné znaky tedy mohou být @emph{přidány}
vždy, ale nesmějí být @emph{odstraněny}.  Jelikož chybějící
prázdné znaky mohou způsobit velmi podivná chybová hlášení.
Je záhodno přidat jeden prázdný znak vždy před a po skladebném
prvku, zhruba před a po složených závorkách.

@item @strong{Výrazy:}
I ten nejmenší úryvek kódu LilyPondu musí být uzavřen ve
@strong{@{@tie{}složených@tie{}závorkách@tie{}@}}. Tyto
závorky LilyPondu ukazují, že se jedná o hudební výraz patřící
k sobě, právě tak jako k sobě patří kulaté závorky @q{()} v matematice.
Závorky by měly být pokaždé obklopeny prázdným znakem, abychom se vyhnuli
dvojznačnostem. Má to pak ještě být tak, aby se nacházely
na začátku nebo na konci řádku.

Příkaz pro LilyPond následovaný jednoduchým výrazem
v závorkách (jako například @q{@w{@code{\relative c' @{ @dots{} @}}}})
je též hodnocen jako jednotlivý hudební výraz.

@cindex Poznámky
@cindex Řádkové poznámky
@cindex Blokové poznámky

@item
@strong{Poznámky:}
Poznámka je připomínkou lidskému čtenáři zdrojového souboru.
Při zpracování souboru je programem přehlížena, takže na tiskový
výstup not nemá žádný účinek.
Jsou dva rozdílné druhy poznámek. Znak procenta
@q{%} předchází řádkové poznámce: vše po tomto znaku
je v tomto řádku přehlíženo.
Obvykle je řádková poznámka připsána @emph{nad} kódem,
ke kterému se vztahuje.

@example
a4 a a a
% Tato poznámka se odvolává na H
b2 b
@end example


Bloková poznámka je celým úryvkem s poznámkou.
Vše, co je obklopeno @code{%@{}
a @code{%@}}, se přehlíží. Znamená to,
že jedna bloková poznámka se nemůže nacházet v jiné
blokové poznámce. Když byste to zkusili,
ukončí již první @code{%@}} @emph{obě}
blokové poznámky. Následující příklad ukazuje jedno
možné použití poznámek:

@example
% Noty pro zajiskření zajiskření zde
  c4 c g' g a a g2

%@{
    Tyto řádky a noty dole jsou přehlíženy,
    protože se nacházejí v jedné blokové
    poznámce.

    f4 f e e d d c2
%@}
@end example

@end itemize


@node Vypořádání se s chybami
@section Vypořádání se s chybami
@translationof Dealing with errors

@cindex Řešení chyb

Někdy LilyPond nevytvoří notový obraz takový, jaký jste očekávali.  Tento
úryvek poskytuje několik odkazů, aby vám pomohl při řešení
potíží, se kterými byste se mohli setkat.


@menu
* Obecné rady k řešení chyb::
* Některé časté chyby::
@end menu

@node Obecné rady k řešení chyb
@subsection Obecné rady k řešení chyb
@translationof General troubleshooting tips

Řešení chyb při potížích s LilyPondem může pro člověka, který je
zvyklý na obrazové uživatelské rozhraní, představovat velkou výzvu, protože
neplatné vstupní soubory vytvořeny být mohou.  Když se tak stane, je
logický postup pustit se do toho, potíže určit a řešit, tou nejlepší
cestou.  Některé směrnice, jak se tyto potíže můžete naučit řešit,
se nacházejí v @rprogram{Řešení potíží}.


@node Některé časté chyby
@subsection Některé časté chyby
@translationof Some common errors

@cindex časté chyby
@cindex Chyby, časté

Jsou některé běžné chyby, které se dají vyřešit obtížně, když má člověk
jen hlášení chyb v souboru s chybami.  Blíže budou osvětleny v
@rprogram{Časté chyby}.



@node Jak číst příručky
@section Jak číst příručky
@translationof How to read the manuals

Tato část ukazuje, jak lze dokumentaci číst účinně,
a vysvětluje také některé užitečné vlastnosti internetové
verze.

@menu
* Vypuštěný materiál::
* Klepnutelné příklady::
* Přehled o příručkách::
@end menu


@node Vypuštěný materiál
@subsection Vypuštěný materiál
@translationof Omitted material

@cindex Příručka, čtení
@cindex Jak číst příručky
@cindex Čtení příručky
@cindex Příklady, klepnutelné
@cindex Klepnutelné příklady
@cindex Předlohy
@cindex Předlohy
@cindex Sestavit soubory, odkazy
@cindex Sestavení souborů, odkazy
@cindex Odkazy pro sestavení souborů

LilyPondovský kód musí být vždy obklopen znaky složených závorek @code{@{ @}} nebo
kódem @w{@code{\relative c'' @{ @dots{} @}}}, jak je to ukázáno
v části @ref{Práce na vstupních souborech,,práci na vstupních souborech}.
Ve zbytku této příručky se toho ovšem většina příkladů vzdá.
Abyste tyto příklady napodobil, můžete zkopírovat odpovídající zdrojový
kód a vložit jej do textového souboru, ale přitom
@strong{musíte} vložit
@w{@code{\relative c'' @{ @dots{} @}}}, jak je to ukázáno zde:

@example
\relative c'' @{
  @dots{}zde přijde příklad@dots{}
@}
@end example

Proč se zde většinou vynechávají závorky?  Většina příkladů
může být nakopírována do delšího hudebního díla, a potom přirozeně
není smysluplné, když se k tomu nachomýtne
@w{@code{\relative c'' @{ @dots{} @}}}; @code{\relative} nesmí
být zapsán uvnitř jiného @code{\relative},
proto je zde vynechán, aby příklady pracovaly i v jiném
prostředí.  Kdyby byla u každého příkladu zapsána
@w{@code{\relative c'' @{ @dots{} @}}},
nemohly by se malé příklady z dokumentace jednoduše přidat
do vašeho vlastního notového textu. Většina uživatelů chce noty
přidat do již jsoucího souboru někde vprostřed, a z toho důvodu
byl vztažný režim v příkladech v příručce
vynechán.

Myslete také na to, že každý soubor LilyPondu má mít označení verze
příkazem @code{\version}.  Protože jsou příklady v příručkách úryvky
a nikoli úplnými soubory, chybí zde označení verze. Vždy byste je ale
do svých vlastních souborů měli vložit.


@node Klepnutelné příklady
@subsection Klepnutelné příklady
@translationof Clickable examples

@warning{Tato vlastnost je pouze v dokumentaci HTML.}

Mnoho lidí se učí programům tím, že se v nich jednoduše vrtají. Jde
to i s LilyPondem. Když ve verzi HTML této příručky klepnete na
nějaké vyobrazení, obdržíte přesný kód LilyPondu, jenž byl
použit pro sazbu obrázku. Vyzkoušejte to s tímto
vyobrazením:

@c no verbatim here
@c KEEP LY
@lilypond[quote]
\relative {
  c''4-\markup { \bold \huge { Klepněte sem! } }
}
@end lilypond

Když zkopírujete jednoduše vše, co se nachází v úryvku
 @qq{ly snippet}, a vložíte to do textového souboru,
máte již hotovou předlohu pro další pokusy.
Experimente. Abyste sám dosáhl téhož vzhledu, jaký je v příkladu,
musíte zkopírovat vše od řádku @qq{Start
cut-&-pastable section} až do konce souboru.


@ignore

@n ode Navádění klávesnicí
@s ubsection Navádění klávesnicí
@t ranslationof Keyboard navigation

@warning{Tato funkce je pouze ve verzi HTML příručky.}

@c TODO: once this is figured out, insert it here.

V současnosti se na této funkci pracuje.
@end ignore


@node Přehled o příručkách
@subsection Přehled o příručkách
@translationof Overview of manuals


Pro LilyPond je hodně dokumentace. Noví uživatelé jsou často popleteni
tím, které části z ní mají číst, a tak se stává, že někdy nejsou
čteny její důležité části.

@warning{Nepřeskakujte, prosím, žádné důležité části
dokumentace.  Jinak pro vás bude později o hodně těžší
rozumět pozdějším částem.}

@itemize

@item
@strong{Předtím než @emph{cokoli} vyzkoušíte}: Přečtěte si části
@ref{Cvičení} a @ref{Běžný notový zápis}.  Když narazíte
na hudební odborné pojmy, které neznáte,
podívejte se na ně v části @rglosnamed{Top, Slovníček}.

@item
@strong{Předtím než napíšete úplný kousek}:  Přečtěte si část
@ref{Základní pojmy} v příručce k učení se.
Potom se můžete na pro váš projekt důležité části podívat
v @rusernamed{Top, Doporučení pro notový zápis}.

@item
@strong{Předtím než se pokusíte měnit obvyklý notový zápis}:
Přečtěte si @ref{Ladění výstupu,,o ladění výstupu} v příručce k učení se.

@item
@strong{Předtím než se pustíte do většího projektu}: Přečtěte si část
@rprogram{Návrhy, jak psát soubory}
v části věnované používání programu.

@end itemize
