Malé příklady

Co jsou to „malé příklady“?

Malý příklad je příkladem, z něhož už nejde nic víc odstranit.

Proč bych je měl vytvářet?

  • Čím je příklad jednodušší, tím rychleji mu mohou případní pomocníci porozumět a vám pomoci.
  • Jednoduchý příklad ukazuje, že jste se nejdříve sami namáhali s řešením potíží. Když lidé posílají velké úryvky kódu, vypadá to tak, že je ani nezajímá, jestli se jim pomůže, nebo nepomůže.
  • Vytváření malého příkladu vás nutí k porozumění tomu, oč jde. Mnoha chybných hlášení potíží by se šlo vyvarovat, kdyby se člověk nejprve pokusil o vytvoření malého příkladu. Když ve svém malém příkladu nemůžete „chybu“ napodobit, půjde nejspíš o malé porozumění LilyPondu, nikoli o chybu.

Jak jej mám vytvořit?

  • Vždy vložit číslo \version.
  • Dělejte jej malý! Příklady na rozdělení místa nebo na rozvržení strany mohou vyžadovat mnoho taktů not, ale většinu potíží je možné ukázat na jednom taktu.
  • Když se pokoušíte o vytvoření příkladu, pokuste se nejprve úryvek svého souboru odkomentovat (% nebo %{ … %}). Když něco můžete odkomentovat, a potíže přetrvávají, odstraňte odkomentované úryvky.
  • Vyvarujte se složitých not, tónin, klíčů nebo druhů taktů, je to pak vaše starost navíc.
  • Nepoužívejte \override nebo \set, pak se totiž chyba ukazuje v souvislosti s těmito příkazy.