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 :

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

[image of music]

La version abrégée

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

produit

[image of music]

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.


GNU LilyPond – Utilisation des programmes v2.25.14 (branche de développement).