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.

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

Certaines options de la ligne de commande spécifiques à lilypond-book et d’autres détails utiles aux documents Texinfo sont mentionnés dans Utilisation de lilypond-book.