3.5 La documentation sous forme électronique 

3.5.1 Les programmes d'affichage 

1.   Les fichiers de documentation écrits en texte ordinaire peuvent être lus avec un éditeur ou un afficheur quelconque. Le programme List de V. Buerg (inclus dans la distribution) est utilisable avec tous les systèmes d'exploitation du PC et permet d'afficher les textes non accentués, ou les textes accentués écrits dans la page de codes 850 du DOS, au format DOS (fin de ligne = cr+lf) ou Unix (fin de ligne = lf).

   Pour les textes accentués écrits dans la page de codes de Windows, le Bloc-notes de Windows peut être utilisé, mais il est préférable d'utiliser Wordpad, car il permet d'afficher correctement les fichiers au format DOS ou Unix, contrairement au Bloc-notes.

2.   Les fichiers de documentation au format html peuvent être affichés avec un navigateur Web quelconque. Si vous n'en avez pas, vous pouvez télécharger Netscape ou Internet Explorer à partir des sites de Netscape ou Microsoft. Si vous travaillez sous Windows 9x/NTx, vous pouvez aussi installer ces logiciels à partir du cédérom² .
3.   Les fichiers au format dvi peuvent être affichés avec les programmes Dviwin ou Dview (Windows 3x/9x/NTx), Dviscr (DOS) ou Dvipm (OS/2). La distribution doit être installée au préalable pour pouvoir les afficher. L'installation doit être faite en mode Plug & Play, ou à la carte avec le type Voir/Impr au minimum (cf. Fig. 4.1).
4.   Les fichiers au format ps (PostScript) peuvent être affichés avec GSview (Windows 3x/9x/NTx, OS/2) ou Ghostscript (DOS). La distribution doit être installée au préalable pour pouvoir les afficher. L'installation doit être faite en mode Plug & Play, ou à la carte en sélectionnant le type d'installation Ghostscript et en installant le Paquet de Base (DOS, cf. Fig. 4.1) et le Paquet Complémentaire (Windows et OS/2, cf. Fig. 5.1).
5.   Les fichiers au format pdf peuvent être affichés avec Acrobat Reader ou GSview. Si vous travaillez sous Windows 9x/NTx, il n'est pas nécessaire d'installer la distribution au préalable, vous pouvez installer Acrobat Reader 3 à l'aide de son programme d'installation (cf. sec. 3.4.5). Si vous travaillez sous Windows 3x ou OS/2, vous devez télécharger la version ad-hoc d'Acrobat Reader sur le site d'Adobe, ou utiliser GSview. Si vous travaillez sous DOS, vous devez utiliser Ghostscript (la version d'Acrobat Reader pour DOS ne marche pas avec le nouveau format pdf).
6.   Les fichiers au format d'aide en ligne pour Windows peuvent être affichés avec le programme WinHelp de Windows (fichier winhelp.exe).

3.5.2 Point d'entrée de la documentation HTML 

Le point d'entrée pour la documentation au format html est le fichier ast\index.htm du cédérom (cf. Fig. 11.1.2) ou la page d'accueil de l'association AsTEX. Tous les manuels d'AsTEX sont disponibles sous forme html et sont accessibles à partir de ce point d'entrée. Quelques autres manuels sont disponibles aussi sous forme html, en particulier la FAQ française sur TeX, de M.P. Kluth, et sont accessibles de la même façon.

3.5.3 Les panneaux PanDoc de l'assistant AsTEX 

Si vous travaillez sous Windows 9x/NTx, vous pouvez accéder à une bonne partie de la documentation de la distribution à partir des panneaux de documentation de l'assistant. Vous n'avez pas à vous soucier du format de la documentation, l'afficheur adapté est automatiquement sélectionné. Les panneaux de documentation se trouvent dans le groupe de panneaux Doc. La version 3.0 de l'assistant contient cinq panneaux, de noms DocDvi (documentations au format dvi), ArbDvi (arabe avec FarsiTeX), Docmsc (documentation d'emTeX, aide en ligne sur LaTeX2 etc.), Imagik (documentation d'Image Magick), DocAst (documentation d'AsTEX) et Fortran (documentation sur le compilateur Fortran, la librairie Slatec et le livre Professional Fortran 77, de G. Clive).

3.5.4 Les manuels d'AsTEX 

Les manuels d'AsTEX se trouvent dans le répertoire principal ast\astex\doc du cédérom. La documentation en français se trouve dans le sous-répertoire fr et la documentation en anglais dans le sous-répertoire en. Chaque manuel est lui-même dans un sous-répertoire. Les fichiers de la version html se trouvent dans un sous-répertoire de nom html. Les fichiers dvi, ps, pdf et apd (table de navigation) d'un manuel, et les sources en TeX lorsqu'ils sont disponibles, se trouvent dans un sous-répertoire de nom src. Par exemple, le manuel en français de l'assistant AsTEX sous forme pdf a pour nom aastex0s.pdf et se trouve dans le répertoire ast\astex\doc\fr\assist\src.

Sous Windows 9x/NTx, les manuels sous forme dvi, ps ou pdf peuvent être affichés à partir du panneau DocAst de l'assistant, et consultés en mode hypertexte à l'aide du navigateur AsTEX. Celui-ci fournit une interface commune pour ces trois formats (cf. les manuels de l'assistant et du navigateur AsTEX).

Les navigateurs web les plus répandus permettent de faire des recherches de texte dans un document html. Toutefois, pour des raisons de rapidité de chargement sur le réseau et de rafraîchissement de l'affichage du navigateur, les manuels d'AsTEX sont découpés en un très grand nombre de fichiers (près de 500 fichiers htm et 200 images gif, pour le manuel d'installation). Dans ces conditions, la recherche de texte est inefficace. Les formes dvi, ps et pdf en revanche s'y prêtent très bien. C'est pourquoi la documentation est fournie sous plusieurs formats.

3.5.5 Les manuels d'emTeX 

Les manuels des logiciels d'emTeX (compilateurs TeX et Metafont, pilotes d'écran et d'imprimantes, etc.) se trouvent dans le répertoire ast\emtex\doc. Les versions anglaises se trouvent dans le sous-répertoire english et les versions allemandes dans le sous-répertoire german. Sous Windows 9x/NTx, ils sont accessibles aussi à partir du panneau PanDoc\Docmsc du groupe de panneaux Docs de l'assistant AsTEX.

3.5.6 Les autres manuels 

Sous Windows 9x/NTx, un certain nombre de manuels de styles LaTeX sont accessibles à partir des panneaux PanDoc\DocDvi et PanDoc\ArbDvi. Les manuels des autres logiciels se trouvent pour la plupart soit dans le répertoire ou un sous-répertoire du logiciel lui-même, soit dans un sous-répertoire du répertoire principal d'emTeX, ast\emtex\doc. Il faut les rechercher pour l'instant individuellement. Sous Windows 9x/NTx, une façon commode de procéder est d'utiliser l'option Démarrer | Rechercher | Fichiers ou dossiers et de faire une recherche sur les noms de fichiers avec les jokers, soit une recherche sur le contenu des fichiers avec l'onglet Avancée, en limitant éventuellement la portée de la recherche à l'aide du bouton Parcourir. Cette recherche peut aussi être faite à l'aide de l'utilitaire Salamander, de P. Solin. Ce dernier est inclus dans la distribution et est accessible par le bouton Salamand du panneau Programmes | Etc\PrgIn2 de l'assistant AsTEX.