3.3.1 Inclusió de fitxers del LilyPond

Un projecte gran es pot dividir en diversos fitxers. Per referir-se a un altre fitxer, utilitzeu

\include "unaltrefitxer.ly"

La línia \include "unaltrefitxer.ly" equival a enganxar el contingut de unaltrefitxer.ly al fitxer actual al lloc en el qual apareix l’\include. Por exemple, a un projecte gran podríem voler fitxer diferents per a cada part instrumental i crear un fitxer de “partitura completa” que reuneix els fitxers individuals dels instruments. Normalment el fitxer inclòs defineix un cert nombre de variables que a partir d’aleshores queden disponibles per poder-les utilitzar al fitxer de la partitura completa. Als fitxers inclosos es poden marcar les seccions etiquetades per ajudar a fer-les utilitzables a diferents llocs de la partitura. Vegeu Diferents edicions a partir d’una mateixa font.

Els fitxers que estan al directori de treball actual es poden referenciar simplement especificant el nom després de l’ordre \include. Els fitxers a d’altres llocs es poden incloure proporcionant una referència de ruta completa o una ruta relativa (però utilitzeu la barra inclinada normal de l’UNIX, /, no la barra invertida de DOS/Windows, \, com a separador de directori). Per exemple, si material.ly està ubicat un directori per sobre del directori de treball actual, utilitzeu

\include "../material.ly"

o si els fitxers de les parts orquestrals incloses estan tots situats en un subdirectori anomenat parts dins del directori actual, useu

\include "partes/VI.ly"
\include "partes/VII.ly"
… etc.

Els fitxers d’inclusió també poden contenir enunciats \include al seu cop. De forma predeterminada, aquests enunciats \include de segon nivell no s’interpreten fins que s’incorporen al fitxer principal, per la qual cosa els noms de fitxer que especifiquen han de ser relatius al directori que conté el fitxer principal, no al directori que conté el fitxer inclòs. Malgrat això, aquest comportament es pot modificar globalment passant l’opció -drelative-includes a la línia d’ordres (o mitjançant l’addició de #(ly:set-option 'relative-includes #t) al principi del fitxer principal d’entrada).

Quan relative-includes està establert al valor #t, la ruta de cada ordre \include es considera relativa al fitxer que conté aquesta ordre. Aquest comportament és el recomanat i es convertirà en el comportament predeterminat a una versió futura del LilyPond.

Tant els fitxers relatius al directori principal com els fitxers relatius a algun altre directori es poden incloure (\include) mitjançant l’establiment de relative-includes al valor #t o a #f als llocs apropiats dins dels fitxers. Per exemple, si s’ha creat una biblioteca genèrica, libA, que al seu cop utilitza sub-fitxers que s’inclouen (\include) per mitjà del fitxer d’entrada d’aquesta biblioteca, aquestes instruccions \include hauran d’anar precedides per #(ly:set-option #relative-includes #t) de manera que s’interpretin correctament en construir el fitxer d’entrada .ly principal, d’aquesta forma:

libA/
  libA.ly
  A1.ly
  A2.ly
  …

aleshores el fitxer d’entrada, libA.ly, conté

#(ly:set-option 'relative-includes #t)
\include "A1.ly"
\include "A2.ly"
…
% retorn a l'ajustament predeterminat
#(ly:set-option 'relative-includes #f)

Qualsevol fitxer .ly pot aleshores incloure la biblioteca completa, simplement amb

\include "~/libA/libA.ly"

Es poden utilitzar estructures de fitxer més complexes instant els canvis als llocs adequats.

També es poden incloure fitxers d’un directori que està a una ruta de cerca especificada com opció en invocar al LilyPond des de la línia d’ordres. Els fitxers inclosos s’especifiquen usant sols el seu nom de fitxer. Per exemple, per compilar mitjançant aquest mètode un fitxer principal.ly que inclou fitxers situats a un subdirectori anomenat parts, canvieu el directori que conté principal.ly e introduïu

lilypond --include=parts principal.ly

i a principal.ly escriviu

\include "VI.ly"
\include "VII.ly"
… etc.

Els fitxers que s’inclouen a moltes partitures es poden posar al directori del LilyPond ../ly (la localització d’aquest directori depèn de la instal·lació: vegeu Altres fonts d’informació). Aquests fitxers es poden incloure senzillament pel seu nom a una ordre \include. D’aquesta forma s’inclouen els fitxers dependents de la llengua com catala.ly.

El LilyPond inclou de forma predeterminada certes fitxers quan s’inicia el programa. Aquestes inclusions no són visibles per a l’usuari, però els fitxers es poden identificar executant lilypond --verbose des de la línia d’ordres. Això presentarà una llista de rutes i fitxers que fa servir el LilyPond, junt amb moltes altres indicacions. De forma alternativa, poden veure’s explicacions sobre els fitxers més importants d’aquest conjunt a Altres fonts d’informació. Aquests fitxers es poden editar, però els canvis realitzats sobre ells es perdran en instal·la una nova versió del LilyPond.

Es poden veure exemples senzills sobre l’ús de \include a en Partitures i particel·les.

Vegeu també

Manual d’aprenentatge Altres fonts d’informació, Partitures i particel·les.

Advertiments i problemes coneguts

Si un fitxer inclòs rep un nom igual al d’un dels fitxers d’instal·lació del LilyPond, el fitxer que té prioritat és el dels fitxers d’instal·lació del LilyPond.