5. Installation sous FreeBSD

Tous les logiciels cités ci-dessus sont également disponibles pour FreeBSD. En voici la liste et quelques notes sur l'installation et l'utilisation.

5.1. Environnement d'édition

Il faudra tout d'abord la machine java de Sun. Sun n'a pas compilé sa machine java pour FreeBSD, mais on peut installer la version linux et utiliser la couche de compatibilité de FreeBSD. Pour cela, il faut d'abord télécharger le kit Java 1.4 SDK pour linux, ici: http://java.sun.com, puis mettre le fichier téléchargé dans le répertoire /usr/ports/distfiles. Ensuite tapez dans un terminal en tant que root:

cd /usr/ports/java/linux-sun-jdk14
make
make install
make clean
ln -s /usr/local/bin/javavm /usr/local/bin/java

Je ne sais pas pourquoi le port java ne place pas directement un exécutable java, mais en créant le lien comme indiqué en dernière ligne ça marche.

Ensuite il faut télécharger XXE ici: http://www.xmlmind.com/xmleditor/download.shtml et décomprimer l'archive dans un répertoire, de préférence dans la hiérarchie /usr/local. (/usr/local/apps/xxe par exemple). On pourra lancer XXE en utilisant le script xxe présent dans le répertoire principal de l'application.

5.2. Processeur xslt

On peut également installer xsltproc, toujours en exécutant en tant que root:

cd /usr/ports/textproc/libxslt
make
make install
make clean

Les mêmes commandes xsltproc que sous Windows peuvent être utilisées. Pour utiliser un catalogue, il faut comme sous Windows déclarer une variable globale XML_CATALOG_FILES.

5.3. xmltex

5.3.1. installation automatique

Les archives de passivetex et xmltex n'ont pas de numéros de version, et les installations automatiques des ports correspondants sur les BSD ne marcheront que s'ils correspondent exactement à la version disponible au moment de l'installation sur le site de TEI. Donc vous pouvez tenter l'installation automatique, et si ça ne marche pas, faire l'installation manuelle décrite dans le paragraphe suivant. Pour installer teTeX, xmltex et passivetex, exécutez en tant que root:

cd /usr/ports/print/passivetex
make
make install
make clean

5.3.2. installation manuelle

Tout d'abord on va installer teTeX. Exécutez en tant que root:

cd /usr/ports/print/teTeX
make
make install
make clean

Ensuite il faut télécharger les archives de xmltex et passivetex sur le site de TEI, ici: http://www.tei-c.org.uk/Software/passivetex/. Créer un dossier /usr/local/texmf/tex/xmltex et décomprimer les archives base (xmltex) et passivetex dedans. Ensuite il y a quelques actions a faire pour créer les fichiers de format et les exécutables correspondants:

cd /usr/local/share/texmf/web2c
texconfig rehash
tex -ini -progname=xmltex "&latex" xmltex.ini
pdftex -ini -progname=pdfxmltex "&pdflatex" pdfxmltex.ini
texconfig rehash
ln -s /usr/local/bin/tex /usr/local/bin/xmltex
ln -s /usr/local/bin/pdftex /usr/local/bin/pdfxmltex

5.3.3. Taille des buffers mémoire

Il se peut que lors du traitement d'un fichier fo TeX se plaigne de ne pas avoir assez de mémoire. Par exemple avec un message d'erreur comme ceci:

! TeX capacity exceeded, sorry [save size=8000].
<to be read again>

Dans ce cas il faut augmenter le buffer correspondant dans le fichier /usr/local/share/texmf/web2c/texmf.cnf. Ici TeX dit que c'est le buffer save qui est trop petit, il faut donc augmenter les variables save_size et save_size.context. Il y a aussi les variables hash_extra pour la table hash, etc... Voici la liste des variables que j'ai modifiées et leur nouvelle valeur:

main_memory.context = 3000000
main_memory = 1500000

hash_extra.context = 25000
hash_extra = 25000

pool_size.context = 1500000
pool_size = 1000000

string_vacancies.context = 90000
string_vacancies = 50000

max_strings.context = 200000
max_strings = 60000

save_size.context = 20000
save_size = 16000

Attention, après avoir modifié certaines valeurs (main_memory surtout), il faut regénérer les fichiers de format pour qu'elles soient prises en compte. Pour les formats de base (LaTeX...) on peut faire:

fmtutil --all

Et pour les formats créés vous-même (xmltex et pdfmltex) il suffit de retaper les commandes de création (Section 5.3.2).

Quand vous créez un fichier .pdf, TeX crée aussi un fichier .log avec des messages sur ce qu'il a fait. A la fin de ce fichier, il indique la taille des différents buffers et quelle partie a été utilisée. Ceci peut permettre de vérifier que les changements ont bien été pris en compte, et de prévoir s'il y aura un risque de saturation d'un des tampons mémoire.

5.4. dvi2bitmap

dvi2bitmap ne sera indispensable que si vous voulez insérer des équations au format TeX et que vous voulez une sortie HTML. Pour cela il faut d'abord charger les sources sur le site http://www.astro.gla.ac.uk/users/norman/star/dvi2bitmap/. Ensuite en tant que root, on va décomprimer l'archive et installer le programme. Allez dans le répertoire dans lequel l'archive a été décomprimée, et tapez:

./configure
make --enable-gif --enable-png
make test
mv dvi2bitmap /usr/local/bin

La commande make test va vous donner entre autres le chemin vers les polices que dvi2bitmap utilise. Ensuite s'il ne les trouve pas tout seul, il faudra mettre ce chemin dans la variable d'environnement DVI2BITMAP_PK_PATH.