La documentation de la distribution est composée de la documentation originale des
logiciels, et d'un certain nombre de documents généraux sur TeX, le Fortran,
Internet etc. La documentation en français représente près de 2000 pages. Elle
comprend les manuels d'AsTEX, les manuels de référence et les aides en ligne en
français.
2.5.1
Les manuels d'AsTEX sont les manuels des logiciels qui ont été écrits spécialement pour la
distribution. Ils sont tous en français et sont disponibles sous forme imprimée auprès de
l'association 4 ,
et sous forme électronique (aux formats html, dvi, ps ou pdf) sur le cédérom et sur le
serveur web. Le format html est destiné à la consultation en ligne avec un navigateur
web. Les autres formats sont destinés à l'impression, ou à la consultation en ligne à partir
du navigateur AsTEX.
-
Manuel
d'installation,
configuration
et
prise
en
main
d'AsTEX :
c'est
le
manuel
que
vous
êtes
en
train
de
lire.
Son
contenu
est
décrit
dans
la
section 1.3.
- Manuel d'utilisation d'AsTEX : il complète la partie Prise en main du manuel
précédent. Il est divisé en six parties.
-
La
première
partie,
Manuel
de
l'assistant
AsTEX pour
Windows 9x/NTx,
explique
comment
installer,
utiliser,
adapter
à
vos
besoins
et
étendre
les
possibilités
de
l'assistant
AsTEX.
Elle
décrit
en
détail
comment
utiliser
l'assistant
pour
traiter
des
documents
TeX avec
des
éditeurs
Windows
ou
DOS.
Un
chapitre
est
consacré
à
son
utilisation
avec
Emacs.
-
La
seconde
partie,
Manuel
du
navigateur
AsTEX pour
Windows 9x/NTx,
explique
comment
créer
une
table
de
navigation,
et
comment
l'utiliser
avec
le
navigateur
AsTEX pour
se
déplacer
facilement
dans
un
document
volumineux
au
format
dvi,
ps
ou
pdf.
-
La
partie
Utilisation
de
TeXShell
avec
AsTEX
décrit
les
options
supplémentaires
qui
ont
été
rajoutées
à
TeXShell
pour
la
distribution.
Elle
complète
le
manuel
d'utilisation
de
TeXShell,
qui
se
trouve
dans
le
vol. 1
des
Manuels
de
référence.
-
La
partie
Rédaction
de
documents
en
français
et
en
anglais
explique
comment
écrire
des
documents
en
français
ou /
et
en
anglais
avec
le
style
fr/frmin.
-
La
partie
Rédaction
de
documents
en
français,
anglais
et
arabe
explique
comment
écrire
des
documents
trilingues
avec
les
paquets
ArabTeX et
fr/frmin.
-
La
dernière
partie,
Calcul
scientifique
en
Fortran
est
une
introduction
à
l'utilisation
du
Fortran
avec
le
compilateur
et
la
librairie
de
sous-routines
Slatec.
- ALIRE : c'est un résumé du manuel d'installation, de configuration et de prise en
main.
- Mise à jour d'AsTEX : il explique comment mettre à jour une installation précédente
d'AsTEX (version 2.2x) vers la version 3.x.
- FAQ : Foire aux questions sur la distribution.
- Historique d'AsTEX 3.x : Historique des différentes versions d'AsTEX 3. Si vous
avez une version du début de l'année 1999, ce document vous permet de
savoir les bogues qui ont été corrigées, les améliorations apportées et les
nouveautés.
- Historique des versions précédentes d'AsTeX : Historique des premières versions
d'AsTEX (PC-GUT 1.x et AsTEX 2.x).
2.5.2
La documentation des principaux logiciels a été traduite en français et est disponible
dans les manuels de référence. Leur contenu est le suivant :
-
Vol. 1 :
il
comprend
l'Introduction
à
Plain
TeX
et
Introduction
à
LaTeX,
de
D. Wilkins,
le
Manuel
d'utilisation
de
TeXShell,
de
J. Schlegelmich
et
le
Manuel
d'utilisation
de
Dvips,
de
T. Rokicki.
-
Vol. 2 :
Manuel
d'utilisation
de
MicroEmacs
pour
Windows,
de
D.M. Lawrence
et
P. Perret,
traduit
par
A. Jaccomard.
Ce
manuel
décrit
le
mode
d'emploi
du
logiciel
et
le
langage
de
programmation
de
MicroEmacs.
-
Vol. 3 :
Manuel
des
programmes
emTeX,
de
E. Mattes,
traduit
par
A. Jaccomard.
Il
contient
la
documentation
des
compilateurs
TeX et
Metafont,
ainsi
que
celle
des
programmes
Mfjob
(frontale
pour
Metafont)
Pkedit
(éditeur
de
fontes
pk),
Fontlib
(gestionnaire
de
fontes
pk),
makedot
(création
de
fichiers
de
configuration
d'imprimante),
Dvispell
(création
de
fichier
ASCII
à
partir
de
fichier
dvi)
et
tous
les
utilitaires
de
TeX portés
sur
PC
(Tftopl,
Gftopk,
etc.).
-
Vol. 4 :
Manuel
des
pilotes
emTeX,
de
E. Mattes,
traduit
par
A. Jaccomard.
Il
contient
la
documentation
des
pilotes
d'écran
Dviscr
et
Dvipm,
pour
DOS
et
OS/2,
et
des
pilotes
Dvidot
et
Dvihplj,
pour
les
imprimantes
non
PostScript.
-
Vol. 5 :
Introduction
générale
à
MuPAD,
de
C. Heckler
et
al.,
traduit
par
A. Jaccomard.
Il
présente
en
détail
le
fonctionnement
de
MuPAD
et
propose
de
nombreux
exemples,
et
peut
fournir
une
base
pour
un
cours
d'introduction
au
calcul
formel.
-
Vol. 6 :
Introduction
à
Scilab,
de
C. Gomez
et
al.,
traduit
par
A. Jaccomard.
Il
présente
les
principales
possibilités
de
Scilab
à
partir
de
nombreux
exemples
et
explique
comment
l'interfacer
avec
d'autres
langages
(Fortran,
C
et
Maple).
-
Vol. 7 :
Guide
du
programmeur
Fortran
77
professionnel,
de
C.G.
Page,
traduit
par
A. Jaccomard.
Ce
manuel
décrit
toutes
les
instructions
du
Fortran 77
de
façon
didactique,
avec
de
nombreux
exemples.
2.5.3
Les logiciels ci-dessous sont ou ont été dotés d'une aide en ligne en français :
-
Programme
d'installation
d'AsTEX.
-
Assistant
et
navigateur
AsTEX.
-
Burgundy
Editor,
GSview
et
MéTeX.
-
Dviwin
(traduction
de
F. Brouchier).
-
MicroEmacs
(traduction
de
A. Jaccomard).
-
TeXCad
(traduction
et
compléments
de
H. Cabane).
-
Librairie
Slatec
(traduction
de
A. Jaccomard).
2.5.4
Tous les manuels originaux se trouvent sous forme électronique sur le cédérom. Ils se
présentent sous des formats très divers. Ceci reflète la diversité de leurs origines. Les
documents généraux, en particulier le TeXBook et le Metafont Book de D. Knuth, sont
disponibles sous forme de code source en TeX, ce qui permet de se familiariser par
l'exemple avec ce langage.
Des indications sont données dans la section 3.5 sur l'emplacement des différents
manuels électroniques sur le cédérom, et sur la façon de les afficher en fonction de leur
format.
