1.4 Com llegir els manuals

@translationof How to read the manuals

Aquesta secció mostra com llegir la documentació de forma eficient, i presenta algunes funcionalitats interactives de la versió en línia.

1.4.1 Material omès

@translationof Omitted material

Com ja hem vist a Treball sobre els fitxers d’entrada codi d’entrada del LilyPond ha d’estar rodejat de claus { } o de ‘\relative c'' { … }’. Durant la resta del manual actual, la major part dels exemple ometran les claus. Per a reproduir els exemples, haureu de copiar i enganxar l’entrada que es mostra, però haureu d’escriure el ‘\relative c'' { … }’, de la forma següent:

\relative c'' {
  …aquí va l'exemple…
}

Perquè ometre les claus? Gairebé tots els exemples del manual actual es poden inserir al mig d’un fragment més gran de música. Per a aquests exemple no té cap sentit afegir ‘\relative c'' { … }’ (no hauríeu de posar un \relative dins d’altre \relative!); si haguéssim inclòs ‘\relative c'' { … }’ envoltant a cadascú dels exemples, no podríeu copiar un exemple petit procedent de la documentació i enganxar-lo dins de la seva pròpia partitura. La major part de la gent voldrà inserir el codi dins d’una partitura més gran, és per això que hem formatat el manual d’aquesta manera.

Recordeu també que tot fitxer del LilyPond ha de portar un enunciat \version. Considerant que els exemple dels manuals són fragments de codi i no fitxers complets, l’enunciat \version s’omet. Tot i així, ens hem d’acostumar a incloure’ls als nostres documents.

1.4.2 Exemples amb enllaç

@translationof Clickable examples

Moltes persones aprendran a utilitzar programes provant i trastejant amb ells. Això també es pot fer amb el LilyPond. Si cliqueu sobre una imatge a la versió en HTML d’aquest manual, podreu veure l’entrada exacta del LilyPond que es va fer servir per generar aquesta imatge. Proveu-lo sobre aquesta imatge:

Tallent i enganxant tot el que es troba dins de la secció “ly snippet” (fragment de tipus ly), tindreu una plantilla inicial per als vostres experiments. Per poder veure exactament el mateix resultat (amb la mateixa amplada i tot), copieu tot el que hi ha des de “Start cut-&-pastable section” fins al final del fitxer.

1.4.3 Panoràmica dels manuals

@translationof Overview of manuals

Hi ha molt abundant documentació sobre el LilyPond. Els nous usuaris es troben desorientats amb freqüència en quant a quina part o quines parts han de llegir, i ocasionalment passen per alt la lectura de parts d’importància vital.

• Abans d’intentar fer qualsevol cosa: llegiu el Tutorial del manual d’Aprenentatge, i la secció Notació corrent. Si trobeu termes musicals que no reconeixeu, busqueu-los al (music-glossary)Top section ‘Glossari’ in Glossari musical.
• Abans d’intentar escriure una peça completa de música: llegiu la secció Conceptes fonamentals del manual d’Aprenentatge . Després us vindrà bé consultar les seccions corresponents de la (notation)Top section ‘Referència de la notació’ in Referència de la notació.
• Abans d’intentar de modificar els resultats predeterminats: llegiu la secció Ajustament de la sortida del manual d’Aprenentatge.
• Abans d’afrontar un projecte gran: llegiu la secció (usage)Suggeriments per escriure fitxers d’entrada section ‘Suggeriments per escriure fitxers d'entrada’ in Utilització del programa del manual d’utilització del programa.

This document was generated by gub on Juliol 13, 2020 using texi2html 1.82.

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