Minimalbeispiele

Was sind „Minimalbeispiele“?

Ein Minimalbeispiel ist ein Beispiel, von dem nichts mehr entfernt werden kann.

Warum sollte ich so etwas tun?

  • Je einfacher ein Beispiel ist, um so schneller können mögliche Hilfeleistende es verstehen und Ihnen helfen.
  • Ein kleines Beispiel zeigt, dass Sie sich zuerst Mühe gegeben haben, das Problem selber zu lösen. Wenn Leute große Abschnitte an Code einschicken, sieht es so aus, dass sie sich auch nicht interessieren, ob ihnen geholfen wird oder nicht.
  • Ein Minimalbeispiel zu erstellen hilft Ihnen zu verstehen, was vorgeht. Viele falsche Problemberichte können vermieden werden, wenn man versucht, erst einmal ein Minimalbeispiel zu erstellen. Wenn Sie einen „Bug“ in Ihrem Minimalbeispiel nicht reproduzieren können, was das Problem wohl eher zu geringes Verständnis von LilyPond, nicht jedoch ein Fehler.

Wie werden sie erstellt?

  • Immer die \version-Nummer einfügen.
  • Machen Sie es klein! Beispiele zur Platzverteilung oder dem Seitenlayout können viele Notentakte erfordern, aber die meisten Probleme können in weniger als einem einzigen Takt gezeigt werden.
  • Wenn Sie versuchen, ein Beispiel zu erstellen, versuchen Sie zuerst, Abschnitt Ihrer Datei auszukommentieren (% oder %{ … %}). Wenn Sie etwas auskommentieren können, und das Problem immer noch gezeigt wird, entfernen Sie die auskommentierten Abschnitte.
  • Vermeiden Sie komplizierte Noten, Tonarten, Schlüssel oder Taktarten, es sei denn Ihr Problem hat mit ihnen etwas zu tun.
  • Benutzen Sie nicht \override oder \set, es sei denn, der Fehler zeigt sich im Zusammenhang mit diesen Befehlen.
  • Sie können auch zusätzlich ein Bild anhängen, welches die gewünschte graphische Darstellung zeigt.

Wie klein sollten sie sein?

Ist der Code unten ein Minimalbeispiel?

\version "2.14.1"
\include "english.ly"

\score {
  \new Staff {
    \key d \major
    \numericTimeSignature
    \time 2/4
    <cs' d'' b''>16 <cs' d'' b''>8.
    %% Here: the tie on the D's looks funny
    %% Too tall? Left-hand endpoint is not aligned with the B tie?
    ~
    <cs' d'' b''>8 [ <b d'' a''> ]
  }
}

Das ist zwar kein langer Code, aber ein wirkliches Minimalbeispiel ist folgendes:

\version "2.14.1"
{
  % middle tie looks funny here:
  <c' d'' b''>8. ~ <c' d'' b''>8
}

Wenige Minimalbeispiele brauchen mehr als 10 Zeilen, meistens kann das Problem mit vier Zeilen gezeigt werden!


Andere Sprachen: English, česky, español, français, magyar, italiano, 日本語, nederlands, 中文.
About automatic language selection.

Validation

Thanks to webdev.nl for hosting lilypond.org. Valid HTML 4.01 Transitional