Ce fichier modèle est abondamment commenté, ce qui permettra à chacun de l’adapter à sa manière.
En tête de fichier on trouvera les inclusions obligatoires des fichiers d’initialisation, de configuration et de fonctions de harpoTab , ainsi que a totalité des options modifiables localement.
Il sera probablement judicieux de retirer une grande partie des options de configuration et ne garder que celles convenant à vos besoins.
On trouve ensuite plusieurs blocs dédiées à la saisie de la musique :
- le bloc \header, qui permet d’enregistrer le titre, l’auteur, etc. ;
-
la variable musicale Global : qui est utilisée pour noter les indications de clés, tempo, tonalité, etc. que vous pourrez préférer noter avec la musique ;
-
la variable musicale Melody qui est destinée à recevoir la mélodie jouée à la main droite, ce qui n’interdit nullement d’écrire tout ou partie de cette mélodie dans d’autres variables et de les insérer à cet endroit ;
-
la variable musicale Tablature qui est destinée à recevoir la mélodie sous forme de numéros de trous et non de notes, ce qui sera expliqué en détail dans page ;
-
la variable musicale Chords est pré-configuré pour la saisie des accords (façon accords de guitare) ;
-
et enfin, la variable musicale Lyrics qui permet de saisir des paroles.
Il est parfaitement possible de choisir d’autres noms pour les variables musicales à condition de les modifier partout où ils apparaissent. Donc, l’avertissement d’usage vaut ici aussi : ne changez rien sauf si vous savez très exactement ce que vous faites…
La partie restitution de la musique, à savoir le bloc \score, est également pré-configurée pour utiliser les variables précédentes. Normalement les seules modifications à y apporter consisteront à (dé-)commenter certaines options, tout ceci étant bien entendu expliqué dans le fichier.
Enfin, le bloc \paper comporte lui aussi toutes les données nécessaires pour avoir une sortie papier conforme à vos envies.
Toute cette partie de restitution, qui ne change quasiment jamais, peut être externalisée dans un fichier nommé harpoTab-footer.ly par exemple, qui sera appelé avec une instruction \include placée en fin de fichier. Cette externalisation n’est pas faite par défaut, le choix vous appartient.