Manual d'aprenentatge del GNU LilyPond: 1.2.2 Treball sobre els fitxers d'entrada

[ << Tutorial ]	[Part superior][Continguts][Índex][ ? ]			[ Notació corrent >> ]
[ < Tot a l'hora ]		[ Amunt : Com escriure fitxers d'entrada ]	[ Gestió dels errors > ]

1.2.2 Treball sobre els fitxers d’entrada

Els fitxers d’entrada del LilyPond són com els fitxers font de molts llenguatges de programació corrents. Contenen un enunciat de versió, són sensibles a les majúscules i generalment els espais s’ignoren. Les expressions es formen amb claus { } i els comentaris es denoten per un signe de percentatge (%) o per %{ … %} .

Si no enteneu res de la frase anterior, no us preocupeu! A continuació explicarem el significat de tots aquests termes:

Enunciat de la versió: Tot fitxer del LilyPond ha de contenir un enunciat de versió. Un enunciat de versió és una línia que descriu la versió del LilyPond per a la es va escriure aquest fitxer, com a l’exemple següent:
```
\version "2.21.0"
```
Per conveni, l’enunciat de versió es col·loca al principi del fitxer del LilyPond.

L’enunciat de versió és important per dos motius com a mínim. En primer lloc, permet l’actualització automàtica del codi d’entrada conforme es va modificant la sintaxi del LilyPond. En segon lloc, indica la versió del LilyPond que es necessita per compilar el fitxer.

Si no s’escriu cap enunciat de versió al fitxer d’entrada, el LilyPond imprimeix un advertiment durant la compilació del fitxer.
Sensible a les majúscules: el fet que s’introdueixi una lletra en minúscules (per exemple a, b, s, t) o en majúscules (per exemple A, B, S, T) té importància. Les notes són minúscules: ‘{ c d e }’ és una entrada vàlida; ‘{ C D E }’ produiria un missatge d’error.
Insensible al nombre d’espais: no importa quants espais (o salts de línia o de tabulació) afegiu. ‘{ c4 d e }’ significa el mateix que ‘{ c4 d e }’ i que
```
{ c4                       d
                   e   }
```
Per suposat, l’exemple anterior és difícil de llegir. Una regla pràctica és sagnar els blocs de codi amb un caràcter de tabulació, o bé amb dos espais:
```
{
  c4 d e
}
```
No obstant, sí es necessiten espais per separar molts elements sintàctics els uns dels altres. En altres paraules, els espais es poden sempre afegir, però no sempre eliminar. Degut a què la manca d’espais pot donar lloc a errors estranys, recomanem inserir espais sempre abans i després de qualsevol element sintàctic, per exemple, abans i després de les claus.
Expressions: Tot fragment de codi d’entrada per al LilyPond ha de portar { claus } abans i després de l’entrada. Aquestes claus li diuen al LilyPond que l’entrada és una expressió musical unitària, igual que els parèntesis ‘()’ de les matemàtiques. Les claus han d’anar rodejades d’un espai a no ser que es trobin al començament o al final d’una línia, per evitar qualsevol ambigüitat.
Una instrucció del LilyPond seguida d’una expressió simple entre claus (com per exemple ‘\relative c' {… }’) també és una expressió musical unitària.
Comentaris: Un comentari és una nota per al lector humà de l’entrada musical; s’ignora quan s’analitza aquesta entrada, de manera que no té cap efecte sobre la sortida impresa. Hi ha dos tipus de comentaris. El símbol de percentatge ‘%’ introdueix un comentari de línia; s’ignora tot el que es troba després de ‘%’ a aquesta línia. Per conveni, una línia de comentari es col·loca per sobre del codi a què es refereix el comentari.
```
a4 a a a
% aquest comentari es refereix a les notes Si
b2 b
```
Un comentari de bloc marca una secció sencera d’entrada musical com a comentari. Tot el que esta envoltat dins de %{ i %} s’ignora (però els comentaris no poden niuar-se, cosa que significa que un comentari de bloc no pot incloure altres comentaris de bloc). Si ho fes, el primer %} donaria per acabat els dos comentaris de bloc. El següent fragment mostra alguns possibles usos per als comentaris:
```
% a continuació van les notes de twinkle twinkle
  c4 c g' g a a g2

%{
  Aquesta línia i les notes que apareixen a sota
  s'ignoren, per estar dins d'un
  comentari de bloc.

  f4 f e e d d c2
%}
```

[ << Tutorial ]	[Part superior][Continguts][Índex][ ? ]			[ Notació corrent >> ]
[ < Tot a l'hora ]		[ Amunt : Com escriure fitxers d'entrada ]	[ Gestió dels errors > ]

Altres idiomes: English, česky, deutsch, español, français, magyar, italiano, 日本語, nederlands.
Quant a la selecció automàtica de la llengua.

1.2.2 Treball sobre els fitxers d’entrada

LilyPond — Manual d’aprenentatge v2.21.0 (branca de desenvolupament).