Installation du Mauro-T_EX sur Mac OS X

On trouvera ici une aide à l'installation du Mauro-T_EX sur Mac OS X. Il existe plusieurs manières de faire: on en propose ici une seule.

1  Aperçu

Pour écrire un fichier source Mauro-T_EX, il est nécessaire de disposer d'un éditeur de texte (ici TeXShop).

Pour obtenir à partir des fichiers sources Mauro-T_EX des fichiers PDF, pour les visualiser ou les imprimer, il est nécessaire d'installer une distribution L^AT_EX (ici gwTeX), le préprocesseur Mauro-T_EX pour L^AT_EX (m2lv), et les paquets supplémentaires du Mauro-T_EX pour L^AT_EX (mauro.sty, mauro.mf, adn.sty, ibycus, etc).

Pour utiliser le Mauro-T_EX avec une interface graphique qui permette d'éditer les fichiers sources, lancer la compilation et prévisualiser le résultat, on utilise ici TeXShop et un SHELL script ad hoc (jpmtex.sh).

Pour obtenir des fichiers HTML, que l'on peut visualiser avec un navigateur internet, il est nécessaire d'installer le programme Mauro-T_EX pour l'HTML (m2hv) et le répertoire d'images des symboles Mauro-T_EX (micons).

2  Installation de L^AT_EX

Installation de la distribution gwTeX

Aller sur la page internet de Gerben Wierda http://www.rna.nl/tex.html et télécharger l'image TeX-fat.dmg. Cette image contient la distribution L^AT_EX, Ghostscript et l'installateur i-Installer.

Double-cliquer sur l'image Tex-fat.dmg puis sur Tex-Fat.iid. Sélectionner (l'un après l'autre ou en même temps) dans la fenêtre de i-Installer qui s'est ouverte les deux paquets à installer Ghostscript et TeX. Cliquer sur le bouton Open i-Package. Cliquer sur le bouton Install & Configure. L'installation commence. Répondre aux questions de configuration (le bouton Default suffit généralement).

Ces paquets sont de toute façon fournis avec une documentation complète pour l'installation et l'utilisation, généralement des fichiers RTF ou PDF.

Installation de TeXShop

Aller sur la page internet de Richard Koch http://www.uoregon.edu/~koch/texshop/texshop.html et télécharger l'image Latest TeXShop.

Double cliquer sur l'image texshop.dmg. Copier TeXShop dans le dossier /Applications de la machine.

TeXShop est de toute façon fourni avec une documentation complète pour l'installation et l'utilisation, généralement des fichiers RTF ou PDF.

3  Installation du Mauro-T_EX

Récupération des archives

Aller sur la page internet de Paolo Mascellani http://elabor.homelinux.org/mtex/README-src.html et télécharger les archives m2x-src-1.9.tgz et mtex-supp.tgz.

Attention: la version du site semble assez ancienne. Au besoin, demander à Paolo M. la version des sources la plus récente.

Compilation des programmes Mauro-T_EX

Pour pouvoir compiler les programmes du Mauro-T_EX, il faut installer les outils de développement de Mac OS X. Ils se trouvent sur le CD-ROM ou le DVD d'installation du système. À défaut on trouvera des versions pré-compilées (compilées sur Mac OS X version 10.3.7) des programmes dans l'archive jpmtex.zip.

Double-cliquer sur l'archive m2x-src-1.9.tgz pour la décompacter. Ouvrir une fenêtre terminal et aller dans répertoire m2x-src-1.9¹.

Lancer la commande make linux pour compiler les programmes. Le résultat doit être les programmes m2hv, m2lv et mmerge.

Installation des programmes Mauro-T_EX

Installer les programmes afronte, m2hv, m2lv et mmerge en les copiant dans /usr/local/bin². Il faudra peut-être entrer le mot de passe de l'administrateur pour cela.

Les ajouts à texmf/

Le Mauro-T_EX utilise un certain nombre d'extensions à L^AT_EX qui ne se trouvent pas généralement dans la distribution de base: mauro.sty, mauro.mf, adn.sty, ibycus, etc. Il faut les ajouter dans un répertoire texmf/, et les placer dans le répertoire Library/ du répertoire utilisateur. L'organisation du répertoire texmf/ est relativement rigide: il contient les répertoires dvips/, fonts/ et tex/. Le répertoire fonts/ contient les répertoires afm/, source/, tfm/, type1/ et vf/. Il faut placer: les fichiers *.enc³ *.iby iby.map dans dvips/; les fichiers *.afm dans afm; les fichiers *.mf dans source/; les fichiers *.tfm *.pl dans /tfm; les fichiers *.PFB *.pfa dans type1/; les fichiers *.vf dans vf/; les fichiers *.tex *.sty *.ltx *.fd *.map dans tex/. En résumé:

Library/texmf/ Library/texmf/dvips/: *.enc *.iby iby.map Library/texmf/fonts/ Library/texmf/fonts/afm/: *.afm Library/texmf/fonts/source/: *.mf Library/texmf/fonts/tfm/: *.tfm Library/texmf/fonts/type1/: *.PFB *.pfa Library/texmf/fonts/vf/: *.vf Library/texmf/tex/: *.tex *.sty *.ltx *.fd *.map

Les fichiers à placer dans ces répertoires se trouvent dans l'archive m2x-supp.tgz. Lors de la première installation du Mauro-T_EX, on peut suivre la procédure suivante:

• double-cliquer sur l'archive m2x-supp.tgz pour la décompacter;

• créer si nécessaire un répertoire texmf/ dans Library;

• copier le contenu du répertoire greco/ dans texmf/;

• copier le contenu du répertoire manyfoots/ dans le répertoire tex/ du répertoire texmf/;

• copier le contenu du repertoire mf/ du répertoire maurotex/ dans le répertoire source/ du répertoire fonts/ du répertoire texmf/;

• copier le contenu du repertoire sty/ du répertoire maurotex/ dans le répertoire tex/ du répertoire texmf/.

À défaut, on peut récupérer dans l'archive jpmtex.zip un répertoire texmf/ minimal mais complet déjà constitué.

Le répertoire des images et symboles micons/

Le répertoire micons/ de m2x-supp contient les images des symboles utilisés par le Mauro-T_EX utiles si l'on visualise le résultat de m2hv avec un navigateur HTML. Ce répertoire doit être copié dans le répertoire des fichiers HTML obtenus⁴.

4  Utilisation

La ligne de commande

Avec la ligne de commande, si l'on suppose que l'on a un fichier source Mauro-T_EX source.tex et si l'on souhaite obtenir un fichier PDF visualisable et imprimable: ouvrir une fenêtre terminal et aller dans le répertoire où se trouve le fichier source. Lancer la commande: m2lv source.tex. Elle doit génèrer le fichier source.m.tex. Lancer deux fois la commande: pdflatex source.m.tex. Elle génère le fichier source.m.pdf, que l'on peut alors visualiser avec un lecteur PDF.

Si l'on souhaite obtenir des fichiers HTML que l'on puisse visualiser avec un navigateur internet: lancer la commande: m2hv source.tex.

Le script jpmtex.sh et TeXShop

On trouvera dans l'archive jpmtex.zip le SHELL script jpmtex.sh. On peut l'installer en le copiant dans /usr/local/bin. Il peut remplacer la série de commandes précédentes pour construire le fichier PDF et s'utilise ainsi: jpmtex.sh source.tex.

Il peut aussi être appelé directement à partir de TeXShop. Pour cela aller dans la commande Préférences... du menu TeXShop, choisir l'onglet Divers et entrer dans le second champ (Script Personnel/Commande Latex): /usr/local/bin/jpmtex.sh. Sauvegarder avec le bouton Ok. Ouvrir ensuite un fichier source Mauro-T_EX avec TeXShop, sélectionner la commande Script Personnel du menu Composer. On peut maintenant « compiler » un fichier source Mauro-T_EX avec la commande Composer.

¹  Par exemple si le répertoire se trouve sur le bureau: cd Desktop/m2x-src-1.9

²  Par exemple en ouvrant ce répertoire avec la commande dans le terminal: open /usr/local/bin; puis en déplaçant les éléments.

³  L'étoile a un rôle générique: *.enc signifie tous les fichiers dont l'extension est .enc.

⁴  Pour ne pas dupliquer à l'excès ce répertoire, on aura intérêt à créer des alias.