最小化例

“最小化例” とは?

最小化例は、削除可能なものをすべて 削除した例です。

なぜそれを作る必要があるの?

  • 例が簡単なほど、援助者は素早くそれを理解して手助けすることができます。
  • 最小化例は、あなたが自分自身で問題を解決する努力した証明になります。入力ファイルの大部分を送った場合、援助を期待していないかのように見られてしまいます。
  • 最小化例を作ることは、あなたは何が起きているかを理解する手助けにになります。多くの問題報告は最小化例を作る努力をすることで回避できるものです。最小化例の中で “バグ” を再現できないのであれば、それはバグではなく、LilyPond への理解不足である可能性が高いです!

どうやって作るの?

  • \version 番号を含めてください。
  • 小さくしてください!スペースやページ レイアウトについての例は多くの小節を必要とするかもしれませんが、多くの問題は 1 小節以下に作り直すことができます。
  • 例を作ろうとする時、ファイルの部分々々をコメント アウト (% や %{ … %}) してみてください。あなたの考えていることを残しながらコメント アウトできるものがあれば、それを削除してください!
  • バグと関係がないのであれば、複雑な音符、調、拍子を使わないで下さい。
  • バグと関係がないのであれば、\override\set コマンドを使わないでください。
  • 強制ではありませんが、得ようとしている出力を示す画像を添付してください。

最小化例はどのようなもの?

以下のコードは最小化例でしょうか?

\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''> ]
  }
}

これで大きすぎるわけではありませんが、本当の最小化例は以下のようになります:

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

最小化例のコードが 10 行を越えることはほとんどありません – ほとんどの場合、問題を示すのに 4 行で十分です!