Documentation/cs/learning/tutorial.itely

   1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: cs -*-
   2
   3 @ignore
   4     Translation of GIT committish: 4f7427e7a314a71bde16559247885544256b8213
   5
   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..
   9 @end ignore
  10
  11 @include included/generating-output.itexi
  12
  13 @c \version "2.19.21"
  14 @c Translators: Pavel Fric
  15
  16 @node Cvičení
  17 @chapter Cvičení
  18 @translationof Tutorial
  19
  20 Tato kapitola čtenáři představuje základní práci s LilyPondem.
  21
  22 @menu
  23 * Přeložení zdrojového souboru::
  24 * Jak se píší vstupní soubory::
  25 * Vypořádání se s chybami::
  26 * Jak číst příručky::
  27 @end menu
  28
  29
  30 @node Přeložení zdrojového souboru
  31 @section Přeložení zdrojového souboru
  32 @translationof Compiling a file
  33
  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.
  37
  38 @menu
  39 * Zadání not::
  40 * MacOS X::
  41 * Windows::
  42 * Příkazový řádek::
  43 @end menu
  44
  45 @node Zadání not
  46 @subsection Zadání not
  47 @translationof Entering input
  48
  49 @cindex Sestavení
  50 @cindex První příklad
  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
  55 @cindex Velká písmena
  56 @cindex Malá písmena
  57
  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.
  64
  65 První příklad ukazuje, jak takový
  66 jednoduchý vstupní soubor může vypadat.
  67
  68 @example
  69 @{
  70   c' e' g' e'
  71 @}
  72 @end example
  73
  74 Obrazovým výstupem je:
  75
  76 @c  in this case we don't want verbatim
  77 @lilypond[quote]
  78 {
  79   c' e' g' e'
  80 }
  81 @end lilypond
  82
  83 @warning{V každém souboru LilyPond musejí být nastaveny
  84 @strong{@{ kulaté závorky @}} kolem not nebo
  85 písňového textu.
  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
  88 žádné nejasnosti.
  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}.}
  95
  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í.
  99
 100
 101 @smallspace
 102
 103 @subheading Pohled na výsledky
 104
 105 @cindex Soubor PDF
 106 @cindex Ukázat noty
 107 @cindex Ukázání not
 108 @cindex Pohled s notami
 109 @cindex Editory
 110 @cindex Textové editory
 111 @cindex LilyPond pod MacOS X
 112 @cindex MacOS X, spuštění LilyPondu
 113 @cindex Spuštění LilyPondu
 114
 115 Tvorba notového výstupu závisí na tom, jaký operační systém
 116 a které programy se používají.
 117
 118 @itemize
 119
 120 @item
 121 @ref{MacOS X, @sourceimage{logo-macosx,,,}}
 122 @ref{MacOS X, MacOS X} (obrazově)
 123
 124 @item
 125 @ref{Windows, @sourceimage{logo-windows,,,}}
 126 @ref{Windows, Microsoft Windows} (obrazově)
 127
 128 @item
 129 @ref{Příkazový řádek, @sourceimage{logo-linux,,,}
 130 @sourceimage{logo-freebsd,,,}
 131 @sourceimage{logo-macosx,,,}
 132 @sourceimage{logo-windows,,,}
 133 }
 134 @ref{Příkazový řádek, všechny operační systémy} (Příkazový řádek)
 135
 136 @end itemize
 137
 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}.
 141
 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.}
 145
 146
 147 @node MacOS X
 148 @subsection MacOS X
 149 @translationof MacOS X
 150
 151 @cindex Spuštění programu, MacOS X
 152 @cindex MacOS X, spuštění LilyPondu
 153
 154 @lilypadOSX
 155
 156
 157 @node Windows
 158 @subsection Windows
 159 @translationof Windows
 160
 161 @cindex Windows, spuštění LilyPondu
 162
 163 @lilypadWindows
 164
 165
 166 @node Příkazový řádek
 167 @subsection Příkazový řádek
 168 @translationof Command-line
 169
 170 @cindex Unix, spuštění LilyPondu
 171
 172 @lilypadCommandLine
 173
 174 @node Jak se píší vstupní soubory
 175 @section Jak se píší vstupní soubory
 176 @translationof How to write input files
 177
 178 Tento úryvek vysvětluje základní skladbu LilyPondu a pomáhá
 179 na začátku se zápisem vstupního souboru pro LilyPond.
 180
 181 @menu
 182 * Jednoduchý notový zápis::
 183 * Práce na vstupních souborech::
 184 @end menu
 185
 186
 187 @node Jednoduchý notový zápis
 188 @subsection Jednoduchý notový zápis
 189 @translationof Simple notation
 190
 191 @cindex jednoduchý notový zápis
 192 @cindex Notový zápis, jednoduchý
 193
 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).
 197
 198 @lilypond[verbatim,quote]
 199 {
 200   c' e' g' e'
 201 }
 202 @end lilypond
 203
 204 @noindent
 205 Tato nastavení je možné změnit, ale ve většině případů
 206 jsou automatické hodnoty v zásadě použitelné.
 207
 208
 209 @subheading Výšky tónů
 210
 211 @cindex Výšky tónů
 212 @cindex Vztažný režim
 213 @cindex Odsuvník (apostrof)
 214 @cindex Čárka
 215 @cindex Předznamenání a vztažný režim
 216 @cindex Vztažný režim a předznamenání
 217
 218 @funindex \relative
 219 @funindex '
 220 @funindex ,
 221
 222 Slovníček: @rglos{pitch}, @rglos{interval},
 223 @rglos{scale}, @rglos{middle C}, @rglos{octave},
 224 @rglos{accidental}.
 225
 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.
 236 @c end addition
 237
 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.
 246
 247 @c KEEP LY
 248 @lilypond[verbatim,quote]
 249 % Počáteční bod napsat na jednočárkovaném C
 250 \relative {
 251   c' d e f
 252   g a b c
 253 }
 254 @end lilypond
 255
 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
 262 intervaly:
 263
 264 @lilypond[verbatim,quote]
 265 \relative {
 266   d' f a g
 267   c b f d
 268 }
 269 @end lilypond
 270
 271 @noindent
 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.
 276
 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:
 280
 281 @c KEEP LY
 282 @lilypond[verbatim,quote]
 283 % dvoučárkované C
 284 \relative {
 285   e'' c a c
 286 }
 287 @end lilypond
 288
 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.
 296
 297 @c KEEP LY
 298 @lilypond[verbatim,quote]
 299 \relative {
 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
 306 }
 307 @end lilypond
 308
 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.
 314
 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íží.
 317
 318 @lilypond[verbatim,quote]
 319 \relative {
 320   a' a, c' f,
 321   g g'' a,, f'
 322 }
 323 @end lilypond
 324
 325 @noindent
 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)!
 330
 331
 332 @subheading Délky tónů (rytmy)
 333
 334 @cindex Délky not
 335 @cindex Délky
 336 @cindex Rytmus
 337 @cindex Celé noty
 338 @cindex Půlové noty
 339 @cindex Čtvrťové noty
 340 @cindex Tečkované noty
 341
 342 Slovníček: @rglos{beam}, @rglos{duration},
 343 @rglos{whole note}, @rglos{half note}, @rglos{quarter note},
 344 @rglos{dotted note}.
 345
 346 @notation{Délka} se označuje číslem, jež je zadáno
 347 přímo k názvu noty.
 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.
 352
 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.
 355
 356 @lilypond[verbatim,quote]
 357 \relative {
 358   a'1
 359   a2 a4 a8 a
 360   a16 a a a a32 a a a a64 a a a a a a a a2
 361 }
 362 @end lilypond
 363
 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ě
 367 čísla.
 368
 369 @lilypond[verbatim,quote]
 370 \relative {
 371   a'4 a a4. a8
 372   a8. a16 a a8. a8 a4.
 373 }
 374 @end lilypond
 375
 376
 377 @subheading Pomlky
 378
 379 @cindex Pomlky
 380 @cindex psaní pomlk
 381 @cindex notový zápis pomlk
 382
 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{}:
 385
 386 @lilypond[verbatim,quote]
 387 \relative {
 388   a'4 r r2
 389   r8 a r4 r4. r8
 390 }
 391 @end lilypond
 392
 393
 394 @subheading Taktové označení
 395
 396 @cindex Druh taktu
 397
 398 @funindex \time
 399
 400 Slovníček: @rglos{time signature}.
 401
 402 @notation{Druh taktu} lze určit příkazem
 403 @code{\time}:
 404
 405 @lilypond[verbatim,quote]
 406 \relative {
 407   \time 3/4
 408   a'4 a a
 409   \time 6/8
 410   a4. a
 411   \time 4/4
 412   a4 a a a
 413 }
 414 @end lilypond
 415
 416
 417 @subheading Vyznačení tempa
 418
 419 @cindex Vyznačení tempa
 420 @cindex Údaj metronomu
 421
 422 @funindex \tempo
 423
 424 Slovníček: @rglos{tempo indication}, @rglos{metronome}.
 425
 426 @notation{Vyznačení tempa} a @notation{údaj metronomu} lze
 427 zapsat příkazem @code{\tempo}:
 428
 429 @lilypond[verbatim,quote]
 430 \relative {
 431   \time 3/4
 432   \tempo "Andante"
 433   a'4 a a
 434   \time 6/8
 435   \tempo 4. = 96
 436   a4. a
 437   \time 4/4
 438   \tempo  "Presto" 4 = 120
 439   a4 a a a
 440 }
 441 @end lilypond
 442
 443
 444 @subheading Notový klíč
 445
 446 @cindex Klíč
 447 @cindex Alt
 448 @cindex Soprán
 449 @cindex Tenor
 450 @cindex Bas
 451
 452 @funindex \clef
 453
 454 Slovníček: @rglos{clef}.
 455
 456 @notation{Notový klíč} lze zapsat příkazem
 457 @code{\clef}:
 458
 459 @lilypond[verbatim,quote]
 460 \relative {
 461   \clef "treble"
 462   c'1
 463   \clef "alto"
 464   c1
 465   \clef "tenor"
 466   c1
 467   \clef "bass"
 468   c1
 469 }
 470 @end lilypond
 471
 472
 473 @subheading Vše dohromady
 474
 475 Zde je malý příklad, který obsahuje všechna tato vymezení:
 476
 477 @lilypond[verbatim,quote]
 478 \relative {
 479   \clef "bass"
 480   \time 3/4
 481   \tempo "Andante" 4 = 120
 482   c,2 e8 c'
 483   g'2.
 484   f4 e d
 485   c4 c, r4
 486 }
 487 @end lilypond
 488
 489
 490 @seealso
 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íč}.
 494
 495
 496 @node Práce na vstupních souborech
 497 @subsection Práce na vstupních souborech
 498 @translationof Working on input files
 499
 500 @cindex kulaté závorky
 501 @cindex Závorky, kulaté
 502 @cindex Poznámky
 503 @cindex Řádkové poznámky
 504 @cindex Blokové poznámky
 505 @cindex Psaní velkých a malých písmen
 506 @cindex Výrazy
 507 @cindex Velká písmena
 508 @cindex Malá písmena
 509
 510 @funindex { ... }
 511 @funindex %
 512 @funindex %@{ ... %@}
 513
 514
 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{} %@}}}.
 522
 523 Zdá-li se to nyní být nesrozumitelné, zde je vysvětlení:
 524
 525 @itemize
 526 @item
 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
 531 příkladu:
 532
 533 @example
 534 \version "@w{@version{}}"
 535 @end example
 536
 537 Obvykle je označení verze v souboru napsáno
 538 nahoře.
 539
 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í
 544 souboru.
 545
 546 Když označení verze v souboru chybí, vydá LilyPond
 547 během sestavování souboru varování.
 548
 549 @item
 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.
 556
 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
 562 @example
 563 @{ c4                        d
 564                      e @}
 565 @end example
 566
 567 @noindent
 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:
 570 @example
 571 @{
 572   c4 d e
 573 @}
 574 @end example
 575
 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.
 582
 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.
 591
 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.
 595
 596 @cindex Poznámky
 597 @cindex Řádkové poznámky
 598 @cindex Blokové poznámky
 599
 600 @item
 601 @strong{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.
 610
 611 @example
 612 a4 a a a
 613 % Tato poznámka se odvolává na H
 614 b2 b
 615 @end example
 616
 617
 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:
 626
 627 @example
 628 % Noty pro zajiskření zajiskření zde
 629   c4 c g' g a a g2
 630
 631 %@{
 632     Tyto řádky a noty dole jsou přehlíženy,
 633     protože se nacházejí v jedné blokové
 634     poznámce.
 635
 636     f4 f e e d d c2
 637 %@}
 638 @end example
 639
 640 @end itemize
 641
 642
 643 @node Vypořádání se s chybami
 644 @section Vypořádání se s chybami
 645 @translationof Dealing with errors
 646
 647 @cindex Řešení chyb
 648
 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.
 652
 653
 654 @menu
 655 * Obecné rady k řešení chyb::
 656 * Některé časté chyby::
 657 @end menu
 658
 659 @node Obecné rady k řešení chyb
 660 @subsection Obecné rady k řešení chyb
 661 @translationof General troubleshooting tips
 662
 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íží}.
 669
 670
 671 @node Některé časté chyby
 672 @subsection Některé časté chyby
 673 @translationof Some common errors
 674
 675 @cindex časté chyby
 676 @cindex Chyby, časté
 677
 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}.
 681
 682
 683
 684 @node Jak číst příručky
 685 @section Jak číst příručky
 686 @translationof How to read the manuals
 687
 688 Tato část ukazuje, jak lze dokumentaci číst účinně,
 689 a vysvětluje také některé užitečné vlastnosti internetové
 690 verze.
 691
 692 @menu
 693 * Vypuštěný materiál::
 694 * Klepnutelné příklady::
 695 * Přehled o příručkách::
 696 @end menu
 697
 698
 699 @node Vypuštěný materiál
 700 @subsection Vypuštěný materiál
 701 @translationof Omitted material
 702
 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
 708 @cindex Předlohy
 709 @cindex Předlohy
 710 @cindex Sestavit soubory, odkazy
 711 @cindex Sestavení souborů, odkazy
 712 @cindex Odkazy pro sestavení souborů
 713
 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:
 722
 723 @example
 724 \relative c'' @{
 725   @dots{}zde přijde příklad@dots{}
 726 @}
 727 @end example
 728
 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
 741 vynechán.
 742
 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.
 747
 748
 749 @node Klepnutelné příklady
 750 @subsection Klepnutelné příklady
 751 @translationof Clickable examples
 752
 753 @warning{Tato vlastnost je pouze v dokumentaci HTML.}
 754
 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
 759 vyobrazením:
 760
 761 @c no verbatim here
 762 @c KEEP LY
 763 @lilypond[quote]
 764 \relative {
 765   c''4-\markup { \bold \huge { Klepněte sem! } }
 766 }
 767 @end lilypond
 768
 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.
 775
 776
 777 @ignore
 778
 779 @n ode Navádění klávesnicí
 780 @s ubsection Navádění klávesnicí
 781 @t ranslationof Keyboard navigation
 782
 783 @warning{Tato funkce je pouze ve verzi HTML příručky.}
 784
 785 @c TODO: once this is figured out, insert it here.
 786
 787 V současnosti se na této funkci pracuje.
 788 @end ignore
 789
 790
 791 @node Přehled o příručkách
 792 @subsection Přehled o příručkách
 793 @translationof Overview of manuals
 794
 795
 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.
 799
 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.}
 803
 804 @itemize
 805
 806 @item
 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}.
 811
 812 @item
 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}.
 817
 818 @item
 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.
 821
 822 @item
 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.
 826
 827 @end itemize
 828