groff: puis-je intégrer des images?

Question

Je génère une documentation de style troff. Est-il possible d'incorporer une image (jpg, etc) dans un fichier groff?

Answer 1

Dépend du format de sortie. Si vous créez un fichier PostScript, vous pouvez utiliser PSPIC qui utilise un fichier PS lui-même avec une seule image. Par exemple:

.PSPIC image.ps 

L'alignement, etc. est un peu limité. Par défaut, il est aligné sur le centre, mais vous pouvez le placer à gauche ou à droite en utilisant -L ou -R. Il existe d'autres options, vérifiez le groff_tmac manpage pour ces (recherche de pspic).

Si vous créez une page Web, vous devrez peut-être utiliser .IMG à la place. La syntaxe est la même.

Answer 2

J'utilise groff pour préparer des rapports d'analyse de données, et j'ai souvent besoin de modifier mes graphiques en dehors de R en utilisant Inkscape.

Ce qui suit peut ne pas être au goût des puristes mais cela fonctionne pour moi. Nommez soigneusement les images au fur et à mesure que vous les générez et indiquez l'espace vertical nécessaire pour chaque image, en ajoutant les étiquettes appropriées.

Créez le pdf du rapport (par exemple tbl report.roff | eqn | groff -Tps -ms | ps2pdfwr - report.pdf) et utilisez Inkscape (ou tout autre éditeur de pdf tel que Pdf Studio) pour copier-coller les images dans le pdf du rapport.