Příručka k učení se: 1.2.2 Práce na vstupních souborech

### 1.2.2 Práce na vstupních souborech

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 `{ }` a poznámky jsou značeny znakem procenta `%` nebo obklopeny `%{ … %}`.

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

- 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:

  >     \version "2.22.2"

  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í.

- Psaní velkých a malých písmen: Význam znaku se mění podle toho, zda je zapsáno velké (`A, B, S, T`) nebo malé (`a, b, s, t`). Noty se vždy musí zapisovat malými písmeny, ‘`{ c d e }`’ se chová vhodně, zatímco ‘`{ C D E }`’ vyrábí chybu.
- 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. ‘`{ c d e }`’ znamená totéž co ‘`{ c d e }`’ nebo

  >     { c4                        d
  >                          e }

  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:

  >     {
  >       c4 d e
  >     }

  Prázdné znaky jsou však nezbytné kvůli oddělení četných skladebných prvků od sebe. Prázdné znaky tedy mohou být přidány vždy, ale nesmějí být 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.

- Výrazy: I ten nejmenší úryvek kódu LilyPondu musí být uzavřen ve { složených závorkách }. 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 ‚()‘ 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 ‚`\relative c' { … }`‘) je též hodnocen jako jednotlivý hudební výraz.

- 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 ‚%‘ 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 nad kódem, ke kterému se vztahuje.

  >     a4 a a a
  >     % Tato poznámka se odvolává na H
  >     b2 b

  Bloková poznámka je celým úryvkem s poznámkou. Vše, co je obklopeno `%{` a `%}`, 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í `%}` obě blokové poznámky. Následující příklad ukazuje jedno možné použití poznámek:

  >     % 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
  >     %}

#### LilyPond – Learning Manual v2.22.2 (Stálá větev).