4.6 Minimalbeispiele

Ein Minimalbeispiel ist eine Beispieldatei, die so klein wie möglich ist. Diese Beispiele sind sehr viel einfacher zu verstehen als die langen Originaldateien. Minimalbeispiele werden benutzt, um

• Fehlerberichte zu erstellen,
• eine Hilfeanfrage an die E-Mail-Liste zu schicken,
• Ein Beispiel zur LilyPond Schnipselsammlunghinzuzufügen.

Um ein Beispiel zu konstruieren, dass so klein wie möglich ist, gibt es eine einfache Regel: Alles nicht Notwendige entfernen. Wenn Sie unnötige Teile einer Datei entfernen, bietet es sich an, sie auszukommentieren und nicht gleich zu löschen. Auf diese Weise können Sie eine Zeile leicht wieder mit aufnehmen, sollten Sie sie doch brauchen, anstatt sie von Anfang an neu zu schreiben.

Es gibt zwei Ausnahmen dieser „So klein wie möglich“-Regel:

• Fügen Sie immer einen \versionBefehl ein.
• Wenn es möglich ist, benutzen Sie \paper{ ragged-right=##t } am Beginn des Beispiels.

Der Sinn der Minimalbeispiel ist, dass sie einfach lesbar sind:

• Vermeiden Sie es, komplizierte Noten, Schlüssel oder Taktangaben zu verwenden, es sei denn, Sie wollen genau an diesen Elementen etwas demonstrieren.
• Benutzen Sie keine \override-Befehle, wenn Sie nicht der Zweck des Beispieles sind.

Andere Sprachen: English, français, español.