3.2.2 Texinfo ¶

Texinfo est le format standard pour toute la documentation du projet GNU. À titre d’exemple, toute la documentation de LilyPond – qu’il s’agisse des versions HTML, PDF ou info – est générée à partir de documents Texinfo.

Afin d’insérer de la musique dans vos fichiers Texinfo, lilypond-book dispose des environnements et commandes suivants :

• la commande @lilypond{…} qui permet de directement saisir du code LilyPond simple ;
• l’environnement @lilypond…@end lilypond qui permet de saisir directement du code LilyPond plus élaboré ;
• la commande @lilypondfile{…} qui permet d’insérer un fichier LilyPond ;
• la commande @musicxmlfile{…} qui permet d’insérer un fichier MusicXML qui est alors traité par musicxml2ly puis lilypond.

Il suffit, pour inclure de la musique, d’utiliser l’une des instructions suivantes dans votre fichier source :

@lilypond[liste,des,options]
  VOTRE CODE LILYPOND
@end lilypond

@lilypond[liste,des,options]{ VOTRE CODE LILYPOND }

@lilypondfile[liste,des,options]{fichier}

@musicxmlfile[liste,des,options]{fichier}

Par ailleurs, l’utilisation d’un @lilypondversion permet d’afficher la version de LilyPond utilisée.

L’environnement lilypond doit être en tête de ligne (éventuellement précédé d’une espace) même si le fragment prend place dans le fil du texte par l’option inline. de façon similaire, @end lilypond peut être précédé d’une espace, mais sans rien à sa suite sur la ligne. Lorsque cet environnement est pourvu d’options, le crochet ouvrant doit se trouver sur la même ligne que le mot-clé lilypond – ceci n’est pas nécessaire pour les commandes dont les arguments sont bornés par des accolades. Hormis cette restriction, espaces et sauts de ligne sont permis avant, après et entre les options mentionnées à la commande. Des accolades non appairées ne son pas prises en charge par@lilypond{…}.

Le traitement du fichier source par lilypond-book génère un fichier Texinfo (extension .itexi) qui contiendra les balises @image pour les formats HTML, Info ou imprimable. Les images générées par lilypond-book sont au format EPS et PDF en vue d’une impression, et au format PNG pour leur utilisation en HTML ou Info.

En voici deux exemples. Un environnement lilypond

@lilypond[quote,fragment]
c'4 d' e' f' g'2 g'
@end lilypond

produit

La version abrégée

@lilypond[quote,fragment,staffsize=11]{<c' e' g'>}

produit

Voir aussi ¶