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
\overrideou\seta 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!