Exemplos minimalistas

O que são “Exemplos minimalistas”?

Um exemplo minimalista é um exemplo do qual nada pdoe ser removido.

Por que criá-los?

  • Quanto mais simples é o exemplo, mais rapidamente os ajudantes em potencial podem entendê-lo e lhe ajudar.
  • Um exemplo minimalista demonstra que você se esforçou para resolver o problema sozinho. Quando as pessoas enviam grandes quantidades de informações, parece que elas não se importam se as ajudamos ou não.
  • Criar um pequeno exemplo ajuda você a entender o que está acontecendo. Muitos relatórios de problemas falsos podem ser evitados ao tentar criar um exemplo minimalista; se você não pode replicar um “erro” em um exemplo minimalista, então o problema provavelmente foi uma compreensão insuficiente do LilyPond, não um erro real!

Como criá-los?

  • Inclua o número de versão com \version.
  • Deixe-o pequeno! Exemplos sobre espaçamento ou layout de página podem exigir muitos compassos de música, mas a maioria dos problemas pode ser reproduzida usando menos de um único compasso.
  • Ao tentar criar um exemplo, tente comentar as seções (% ou %{ … %}) do seu arquivo. Se você puder comentar algo enquanto ainda demonstra a ideia principal, remova o material comentado.
  • Evite usar notas, armaduras ou tempos complicados, a menos que o erro seja sobre o comportamento desses itens.
  • Não use os comandos \override ou \set a menos que o erro seja sobre esses comandos específicos.
  • Opcionalmente, anexe uma imagem mostrando a saída gráfica desejada.

Quão minúsculo eles devem ser?

O código abaixo é um exemplo minimalista?

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

Bom, não é muito grande, mas um exemplo verdadeiramente minimalista é esse:

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

Muito poucos exemplos minimalistas excedem 10 linhas de código - frequentemente 4 linhas é suficiente para demonstrar o problema!