Minimális példák
Mik azok a „minimális példák”?
A minimális példa egy olyan LilyPond példaforrás, amelyből semmit nem lehet elvenni.
Miért kellenek a minimális példák?
- Minél egyszerűbb a példa, annál gyorsabban tudják mások megérteni és segíteni neked.
- A minimális példán látszik, hogy már te magad is tettel lépéseket a probléma megoldása felé. Ezt látván mások jobban motiváltak, hogy segítsenek.
- Egy minimális példa létrehozása kényszerít arra, hogy megértsd, mi is történik valójában. Számos téves hibajelentés elkerülhető, ha az ember megpróbál létrehozni egy minimális példát; ha egy hibát nem sikerül reprodukálni egy minimális példával, akkor a hiba valószínűleg nem a LilyPond helytelen működéséből, hanem a megértés hiányából fakad.
Milyen egy jó minimális példa?
- Tartalmazza a verziószámot (\version).
- Rövid. A legtöbb hiba egyetlenegy ütemmel reprodukálható. Az oldalak elrendezésével kapcsolatos hibák esetleg sok ütemet igényelhetnek, de ezek is elérhetőek rövid forráskóddal.
-
Ha nem vagy biztos abban, hogy egy rész szükséges-e, kommentezd ki
(a
%vagy%{ … %}jelek használatával). Ha a lényeg ezután sem változik, nyugodtan kitörölheted a kikommentezett részt. - Kerüld a bonyolult konstrukciók (akkordok, előjegyzés, ütemmutató stb.) használatát, hacsaknem ezekben van a hiba.
-
Ne használj finomhangolásokat (
\override,\set), hacsaknem ezek a hibásak.