Script pstr2pdf

Le problème

Deux outils très utiles liés à LaTeX entrent en conflit :

• PSTricks est un ensemble de macros facilitant la création de graphiques qui peuvent être très complexes. Cliquez ici pour une présentation.
• PdfLaTeX est un très bon outil pour créer des fichiers PDF à partir de fichiers sources LaTeX aisément (il suffit de remplacer la commande latex par pdflatex).

Ces deux outils ne peuvent pas être directement utilisés conjointement. En effet, pdflatex ne gére pas le langage Postscript ce qui pose un problème si l'on veut utiliser des graphiques PSTricks et une compilation avec PdfLaTeX.

Des solutions existent ...

• ne pas utiliser pdflatex mais la chaîne de compilation latex → dvips → ps2pdf. On reste dans la suite avec pdflatex.
• la solution préconisée actuellement est auto-pst-pdf : présentation en français.
• pdftricks, quelques inconvénients :
• ne fonctionne pas à priori sur toutes les distributions de LaTeX (seulement celles basées sur Web2c)
• il faut donner l'autorisation à LaTeX d'exécuter des programmes externes, ce qui pose des problèmes de sécurité (si vous compilez un source contenant des instructions néfastes, genre effacer des fichiers ou reformater un dd...)
• il faut apporter quelques modifications au code source (voir le manuel pour plus de détails)
• ps4pdf : je ne connais pas trop...
• utiliser un autre langage de description de figures, comme Metapost, Asymptote ou PGF/TikZ, qui remplacent PSTricks et sont compilables avec pdflatex : documentation pour TikZ

Le script pstr2pdf

Descriptif

J'ai écrit un script nommé pstr2pdf qui permet la compilation directe (sans modification du code source) avec pdflatex de documents comportant des figures PSTricks.

Pour cela, partant d'un fichier toto.tex, il :

• extrait les portions de code correspondant aux figures
• les compile pour en faire des fichiers images en pdf
• crée un fichier temporaire qui fait appel à ces fichiers images grâce à la commande \includegraphics du package graphics
• compile ce fichier temporaire et lui donne le nom de toto.pdf.

Il est écrit en C (pour compiler ou développer sous Windows, je vous conseille DevCpp, sous Linux, il suffit d'installer gcc et un bon éditeur, genre Kate) et susceptible de nombreuses améliorations (toute suggestion est la bienvenue).

Téléchargement

Binaire pour windows. Binaire pour linux. Le tout (binaires, sources, exemple).

Installation

Copiez le fichier pstr2pdf (ou pstr2pdf.exe sous windows) à un endroit quelconque de votre disque dur, disons dans le dossier toto. Sous Linux, il faudra rendre le fichier executable (chmod +x pstr2pdf ou clic-droit sous Konqueror, Propriétés, Droits d'accès, cocher la cas 'est exécutable').

Lien à un éditeur de texte

Les éditeurs de texte permettent en général d'exécuter des commandes externes. Par exemple, avec Kile sous linux :
dans le menu Configuration / Configurer Kile, page Compilation, cliquez sur Nouvel Outil, donnez un nom (par exemple PSTricks->Pdf) puis cliquez sur "Suivant". Dans comportement, choisissez LaTeX puis "Terminer".

Vous êtes revenu dans la page Compilation. Dans la zone de saisie 'Commande', entrez le chemin de pstr2pdf :

chemin_vers_le_dossier_toto/toto/pstr2pdf

Dans la zone 'Options' :

'%source'

Cliquez sur OK pour terminer.
Le programme pstr2pdf est disponible dans le menu Compilation / Autre (vous pourrez créer un raccourci clavier pour l'utiliser plus rapidement).

Utilisation

Vous pouvez utiliser pstr2pdf à partir de votre éditeur ou directement à partir d'une invite de commande : en étant dans le dossier du document (cd dossier_du_document), tapez :

chemin_vers_le_dossier_toto/pstr2pdf nom_du_document

ou sous Windows :

chemin_vers_le_dossier_toto/pstr2pdf.exe nom_du_document