4 À faire après l’installation

Une fois l’installation terminée il fau, quel que soit le système, configurer le système pour certains besoins locaux et faire des tests de base.

Cette phase de post-installation comprend aussi l’acquisition de composants, fontes ou de programmes qui n’étaient pas inclus dans TeX Live. L’idée de base est de faire les ajouts dans l’arborescence TEXMFLOCAL (si vous avez installé depuis le disque) ou dans VARTEXMF (si vous exécutez depuis le disque) ; voir « répertoires d’installation » en page 24.

Bien sûr, les détails varient d’un cas à l’autre et nous n’essayerons donc pas de les traiter ici. Voir

http://www.ctan.org/tex-archive/info/beginlatex/html/chapter5.html#pkginst pour une bonne description générale et http://www.ctan.org/tex-archive/info/Type1fonts pour la création de fontes et des informations sur l’installation en particulier.

4.1 Le programme texconfig

N’importe quand après votre installation, vous pouvez, et même devez !, utiliser le programme texconfig pour configurer votre système de façon à satisfaire les besoins locaux. Ce programme est installé avec les autres sous le répertoire propre à votre architecture TEXDIR/bin/arch .

Si on le lance sans arguments, il entre en mode plein-écran et on peut alors voir et modifier interactivement les paramètres.

On peut aussi le lancer avec diverses options, dont voici les plus habituelles :

texconfig dvips paper letter
Mettre la taille par défaut du papier à letter pour dvips.
texconfig xdvi us
De même, pour xdvi.
texconfig rehash
Mettre à jour toute la base de données des fichiers du système TeX.
texconfig faq
Afficher la FAQ sur teTeX. (voir aussi la FAQ principale de TeX dans le sous-répertoire FAQ du TeX Live).
texconfig help
Obtenir de l’aide.

Bien sûr, texconfig ne permet de changer que certaines des nombreuses options et paramètres de configuration d’un système TeX. Le fichier principal de configuration pour les programmes de la base Web2C s’appelle texmf.cnf. On peut trouver son emplacement en exécutant « kpsewhich texmf.cnf » ; il contient de nombreux commentaires expliquant les options par défaut et d’autres choix utiles.

4.2 Tester l’installation

Une fois l’installation de TeX Live terminée, il faut la tester avant de créer des documents ou des fontes.

On donne ici quelques procédures de base pour vérifier que le nouveau système est opérationnel. On les décrit pour Unix ; pour Mac OS X ou Windows, il vaut mieux tester au travers d’une interface graphique, mais les principes sont les mêmes.

  1. S’assurer en premier lieu que le programme tex fonctionne :

    > tex --version
    TeX (Web2c 7.5.2) 3.141592
    kpathsea version 3.5.2
    Copyright (C) 1997-2003 D.E. Knuth.
    ...

    Si on récupère un command not found au lieu d’informations comme le numéro de version et le copyright, il est fort probable que vous n’avez pas le bon répertoire bin dans votre PATH. Voir les informations sur l’environnement page 20.

  2. Traiter un fichier LaTeX simple :

    > latex sample2e.tex
    >TeX (Web2c 7.5.2) 3.141592
    ...
    Output written on sample2e.dvi (3 pages, 7256 bytes).
    Transcript written on sample2e.log.
    Si ça échoue en cherchant sample2e.tex ou d’autres fichiers, il y a peut-être des interférences entre vos anciennes variables d’environnement ou fichiers de configuration. Pour analyser en détail votre problème, vous pouvez demander à TeX de dire exactement ce qu’il cherche et trouve ; voir « Actions de débogage » page 86.
  3. Prévisualiser les résultats en ligne :

    > xdvi sample2e.dvi

    Sous Windows, la commande équivalente est windvi. Une nouvelle fenêtre doit s’ouvrir et montrer un document expliquant les bases de LaTeX (document à lire d’ailleurs si vous êtes débutant !). Vous devez tourner sous X pour que xdvi fonctionne. Si non, votre variable d’environnement DISPLAY n’est pas correcte et vous aurez une erreur « Can’t open display ».

  4. Créer un fichier PostScript pour l’imprimer ou l’afficher :

    > dvips sample2e.dvi -o sample2e.ps
  5. Créer un fichier PDF au lieu de DVI ; cet exemple traite le fichier sample2e.tex et crée directement du PDF :

    > pdflatex sample2e.tex
  6. Prévisualiser le fichier PDF :

    > gv sample2e.pdf
    ou
    > xpdf sample2e.pdf

    Hélas, ni gv ni xpdf ne sont actuellement inclus dans TeX Live, aussi devez-vous les installer séparément si ce n’est déjà fait. Voir respectivement http://wwwthep.physik.uni-mainz.de/~plass/gv et http://www.foolabs.com/xpdf.

  7. Autres fichiers de tests utiles :

    docstrip.tex
    Produit documentation et source TeX à partir d’un fichier « .dtx ».
    small2e.tex
    Un document plus simple à compiler que sample2e si celui-ci pose des problèmes.
    testpage.tex
    Teste que l’imprimante n’introduit pas de décalages.
    nfssfont.tex
    Imprime des tables de fontes et des tests.
    testfont.tex
    Aussi pour les tables de fontes, mais en (plain) TeX.
    story.tex
    Le fichier de test de (plain) TeX le plus canonique de tous. Il faut taper « \bye » à la commande * après « tex story.tex ».

    On peut exécuter ces tests comme on l’a fait pour sample2e.tex.

Si vous êtes débutant ou si vous avez besoin d’aide pour réaliser des documents TeX ou LaTeX, n’hésitez pas à consulter http://tug.org/begin.html. On vous recommande notamment le manuel de Peter FLYNN, Formatting Information, disponible à http://www.ctan.org/tex-archive/documentation/beginlatex et celui, en français, de Tobias OETIKER à http://www.gutenberg.eu.org/publications/cahiers/98-introlatex2e.html