| Capítulo 28. Organizando o código | ||
|---|---|---|
 |
 |
|
| Capítulo 28. Organizando o código | ||
|---|---|---|
| |
|
|
Índice
É preciso ter consciência de que a organização do código-fonte, embora não influencie no resultado gerado, é extremamente importante para futuras manutenções. Cada um tem sua maneira de organizar o código e não há regras para isso, mas observe os dois exemplos a seguir:
Exemplo 28.1.
\version "2.10.20"
\relative ees'' {
\time 3/4 \key ees \major \clef treble
r8 g \mf (f ees d ees) f (c) f2 (f8) ees (d c d ees)
ees (ces) ees2 (\break ees8 (bes c! bes aes g)c (e,)
f2 (f8) ees! (f ees d c) ces (f) bes,2
}
\version "2.10.20"
\relative ees'' {
\time 3/4
\key ees \major
\clef treble
| r8 g \mf (f ees d ees)
| f (c) f2 (
| f8) ees (d c d ees)
| ees (ces) ees2 ( \break
| ees8 (bes c! bes aes g)
| c (e,) f2 (
| f8) ees! (f ees d c)
| ces (f) bes,2
}
O lilypond ignora espaços, tabulações e quebras de linha no meio do código; esses caracteres são chamados genericamente de espaço em branco (whitespace). Ou seja, os dois acima são equivalentes.
No entanto não há como negar que é muito mais fácil de ler um estilo de código mais parecido com o segundo exemplo, onde cada compasso foi escrito em uma linha separada. Além disso foi introduzido um elemento novo que não havia sido usado até o momento: o caractere |, a barra vertical. A barra vertical é usada para ajudar na organização do código. Seu uso não é obrigatório e ela não precisa ser usada necessariamente no início do compasso:
Exemplo 28.2.
\version "2.10.20"
\relative ees'' {
\time 3/4
\key ees \major
\clef treble
r8 g \mf ( f ees d ees) |
f ( c) f2 ( |
f8) ees (d c d ees) |
ees ( ces) ees2 ( \break |
ees8 ( bes c! bes aes g) |
c ( e,) f2 ( |
f8) ees! ( f ees d c) |
ces ( f) bes,2 ( |
Podemos inserir comentários no código usando o caractere %. Tudo que for escrito na mesma linha após o % será ignorado pelo lilypond. Podemos usar comentários para lembrar o tipo de codificação de caracteres que foi usado para escrever o arquivo, indicar o número da pauta, etc.
Exemplo 28.3.
% Tchaikovsky - Melodia
% este arquivo foi escrito usando UTF-8
\version "2.10.20"
\relative ees'' {
\time 3/4
\key ees \major
\clef treble
%1
| r8 g \mf (f ees d ees)
| f (c) f2 (
| f8) ees (d c d ees)
| ees (ces) ees2 ( \break
%2
| ees8 (bes c! bes aes g)
| c (e,) f2 (
| f8) ees! (f ees d c)
| ces (f) bes,2
}
| |
|
|
| Capítulo 27. Adicionando letra à música |
|
Capítulo 29. A seção \header - cabeçalho da partitura |