\message{Converted from GuideToTeX.guide by GuideToDVI, Copyright 1998 Frederic Delacroix, MAILWARE.}
\magnification=\magstep0
\catcode`\@=11\hsize=16cm\vsize=24cm\hoffset=0mm\voffset=0mm
\pretolerance=1000\tolerance=5000\brokenpenalty=7000
\hfuzz=1pt\hbadness=1000\overfullrule=2mm
\parindent=0mm
\catcode`\;=\active\def;{\relax\ifhmode\ifdim\lastskip>\z@\unskip\fi\kern.2em\fi\string;}
\catcode`\:=\active\def:{\relax\ifhmode\ifdim\lastskip>\z@\unskip\fi\penalty\@M\ \fi\string:}
\catcode`\!=\active\def!{\relax\ifhmode\ifdim\lastskip>\z@\unskip\fi\kern.2em\fi\string!}
\catcode`\?=\active\def?{\relax\ifhmode\ifdim\lastskip>\z@\unskip\fi\kern.2em\fi\string?}
\frenchspacing
\def\^#1{\if#1i{\accent"5E\i}\else{\accent"5E #1}\fi}
\def\"#1{\if#1i{\accent"7F\i}\else{\accent"7F #1}\fi}
\catcode`\@=12
\newif\iftitlepage\titlepagefalse
\newtoks\titlepagehead\titlepagehead={\hfil}
\newtoks\titlepagefoot\titlepagefoot={\hfil}
\newtoks\leftpagehead\leftpagehead={\hfil\tenrm\the\databasename/\the\currentnodetitle\hfil}
\newtoks\leftpagefoot\leftpagefoot={\qquad\tenrm\folio\hfil}
\newtoks\rightpagehead\rightpagehead={\hfil\tenrm\the\databasename/\the\currentnodetitle\hfil}
\newtoks\rightpagefoot\rightpagefoot={\hfil\tenrm\folio\qquad}
\headline={\iftitlepage\the\titlepagehead\else\ifodd\pageno\the\rightpagehead\else\the\leftpagehead\fi\fi}
\footline={\iftitlepage\the\titlepagefoot\global\titlepagefalse\else\ifodd\pageno\the\rightpagefoot\else\the\leftpagefoot\fi\fi}
\def\link#1{\underbar{#1}}
\def\node#1#2{{\bf #1.--- #2}\medskip\nobreak\currentnodenumber=#1\currentnodetitle={#2}}
\def\endnode{\smallskip\hrule\goodbreak\bigskip}
\def\gobold{\bf{}}
\def\goitalic{\it{}}
\def\gounderline{\tt{}}
\def\gounbold{\rm{}}
\def\gounitalic{\rm{}}
\def\goununderline{\rm{}}
\def\blanklineskip{\medskip}
\newtoks\databasename\databasename={GuideToTeX.guide}
\newtoks\guidefilename\guidefilename={GuideToTeX.guide}
\newtoks\guidedirname\guidedirname={}
\newtoks\guidepath\guidepath={GuideToTeX.guide}
\newtoks\guideabspath\guideabspath={D\'eveloppement:Progs/GuideToTeX/Doc/Fran\c cais/GuideToTeX.guide}
\newcount\currentnodenumber\currentnodenumber=0
\newtoks\currentnodetitle\currentnodetitle={}
\newif\ifauthordef\newif\ifguideversiondef\newif\ifcpyrghtdef\newif\ifmasterdef
\authordeffalse\guideversiondeffalse\cpyrghtdeffalse\masterdeffalse
\cpyrghtdeftrue
\newtoks\cpyrght
\cpyrght={Copyright $\copyright$1998 Fr\'ed\'eric Delacroix}
\guideversiondeftrue
\newtoks\guideversion
\guideversion={GuideToTeX.guide 1.01 (27.10.98)}
\authordeftrue
\newtoks\author
\author={Fr\'ed\'eric Delacroix}
\message{TitlePage.tex 1.1 english, Copyright 1998 Frederic Delacroix, part
of the GuideToTeX package}

% Feel free to modify this file and distribute under a different name
% Mail me your creations so that they're included with the next GuideToTeX
% package!
% Frederic.Delacroix@univ-valenciennes.fr

%$VER: TitlePage 1.1 english (12.08.98)

\font\TitleFont = cmcsc10 scaled \magstep5
\font\AuthorFont = cmssdc10 scaled \magstep2
\titlepagetrue

\null\vfill
{\centerline{\vbox{\hrule height 3pt depth 1pt\hbox{\vrule width 4pt
\vbox spread 1cm{\vfill\hbox spread 1cm{\hfill{\TitleFont\the\databasename
}\hfill}\vfill}%
\vrule width 4pt}\hrule height 3pt depth 1pt}}
}

\ifauthordef\vskip 2cm\centerline{\AuthorFont by \the\author}\fi

\vfill

\ifguideversiondef\centerline{{\tenrm\the\guideversion}}\vskip 5mm\fi
\ifcpyrghtdef\centerline{{\tenrm\the\cpyrght}}\vskip 1cm\fi

\null\eject

\null\vfill
{\sevenrm Converted from the AmigaGuide file \the\guidefilename\ with
GuideToTeX on {\oldstyle\the\day}/{\oldstyle\the\month}/{\oldstyle\the\year}.}
\medskip
{\sevenrm GuideToTeX \copyright\ {\oldstyle 1998} Fr\'ed\'eric Delacroix, MAILWARE.}

\vskip 1cm\null

\eject


\node{1}{Documentation de GuideToTeX}
\blanklineskip
Ce fichier d\'ecrit \bf{}GuideToTeX 1.01\rm{}, un ensemble de programmes ARexx servant \`a
convertir  un  fichier  AmigaGuide\raise 1ex\hbox{\rlap{$\,$\fiverm R}$\scriptstyle\bigcirc$}  en  un  fichier  source pour TeX, pour
compilation  avec  TeX  et  visualisation/impression  par  ShowDVI/DVIPrint
(fourni avec PasTeX).
\blanklineskip
\par\hskip 56mm{}TABLE DES MATIERES
\blanklineskip
\par\hskip 16mm{}\link{Distribution et non-garantie}
\par\hskip 16mm{}\link{Introduction}
\par\hskip 16mm{}\link{Syst\`eme n\'ecessaire}
\blanklineskip
\par\hskip 16mm{}\link{GuideToTeX.rexx}
\par\hskip 16mm{}\link{GuideToDVI.rexx}
\par\hskip 16mm{}\link{En-t\^etes fournis}
\par\hskip 16mm{}\link{FAQs et conseils}
\blanklineskip
\par\hskip 16mm{}\link{Historique}
\par\hskip 16mm{}\link{Probl\`emes connus}
\par\hskip 16mm{}\link{Cr\'edits}
\par\hskip 16mm{}\link{Contacter l'auteur}
\endnode
\node{2}{Distribution et non-garantie}
Cette  archive  contient  \bf{}GuideToTeX.rexx\rm{}, un programme que j'ai \'ecrit pour
convertir les fichiers AmigaGuide\raise 1ex\hbox{\rlap{$\,$\fiverm R}$\scriptstyle\bigcirc$} en fichiers source pour TeX.
\blanklineskip
Elle est diffus\'ee en \it{}MAILWARE\rm{}, ce qui signifie:
\blanklineskip
---  Que  vous \^etes autoris\'e \`a distribuer ce programme \bf{}gratuitement\rm{}, pourvu
qu'\bf{}aucune  modification\rm{} ne soit effectu\'ee \`a l'archive et qu'aucun profit ne
soit  r\'ealis\'e  \`a  partir  de  la  distribution. Les exceptions sont les CDs
Aminet et AmigaNews.
\blanklineskip
---  Que si vous voulez distribuer GuideToTeX comme partie d'un package qui
n'est  pas  gratuit,  vous  devez  d'abord  me  \link{contacter}.  En  g\'en\'eral, je
demanderai une copie gratuite du package en question.
\blanklineskip
---  Qu'aucune  restriction n'est plac\'ee quant \`a l'utilisation des fichiers
produits par GuideToTeX.
\blanklineskip
---  Que  vous  pouvez librement et gratuitement utiliser ce logiciel, vous
n'avez  pas  \`a me payer quoi que ce soit. Cependant, j'aimerais recevoir du
courrier alors je vous demande de \link{me} laisser un mot disant que vous trouvez
GuideToTeX utile. Bien s\^ur, je ne refuserai pas les cadeaux/ch\`eques/A4000Ts
:-)
\blanklineskip
--- Non-garantie:
\blanklineskip
\bf{}AUCUNE GARANTIE N'EST DONNEE POUR CE PROGRAMME, DANS LES LIMITES AUTORIS\'EES
PAR  LA  LOI  EN VIGUEUR. SAUF MENTION ECRITE DU CONTRAIRE, LE DETENTEUR DU
COPYRIGHT  ET/OU  D'AUTRES  TIERS  FOURNISSENT CE PROGRAMME "TEL QUEL" SANS
GARANTIE  D'AUCUNE  SORTE,  EXPLICITE OU IMPLICITE, Y COMPRIS, MAIS SANS SE
LIMITER  \`A CELA, LES GARANTIES IMPLICITES DE NEGOCIABILIT\'E ET DE CONVENANCE
\`A UN BUT PARTICULIER. L'INT\'EGRALIT\'E DES RISQUES CONCERNANT LA QUALIT\'E ET LA
PERFORMANCE  DU  PROGRAMME  VOUS INCOMBE. SI LE PROGRAMME DEVAIT SE R\'EV\'ELER
DEFECTUEUX,  VOUS  PRENEZ  EN  CHARGE  L'INT\'EGRALIT\'E  DES  CO\^UTS DE LA MAIN
D'OEUVRE, DES R\'EPARATIONS OU CORRECTIONS.
\blanklineskip
EN AUCUN CAS, EXCEPT\'E MENTION CONTRAIRE DE LA LOI EN VIGUEUR OU ACCEPTATION
\'ECRITE,  UN  D\'ETENTEUR  DE  COPYRIGHT,  OU  TOUT  AUTRE TIERCE PERSONNE QUI
POURRA\^IT  DISTRIBUER  CE  PROGRAMME COMME INDIQU\'E CI-DESSUS, NE POURRA \^ETRE
TENU POUR RESPONSABLE DE DOMMAGES, Y COMPRIS TOUT DOMMAGE G\'EN\'ERAL, SP\'ECIAL,
ACCIDENTEL  OU  CONS\'ECUTIF \`A L'UTILISATION OU L'IMPOSSIBILIT\'E D'UTILISER CE
PROGRAMME  (Y COMPRIS, MAIS SANS CE LIMITER \`A, LES PERTES DE DONN\'EES OU DES
DONN\'EES RENDUES IMPR\'ECISES OU LES PERTES SUBIES PAR VOUS-M\^EME OU DE TIERCES
PERSONNES  OU  L'IMPOSSIBILIT\'E DE CE PROGRAMME DE FONCTIONNER AVEC D'AUTRES
PROGRAMMES), MEME SI UN TEL D\'ETENTEUR OU TIERCE PERSONNE A \'ET\'E AVERTI DE LA
POSSIBILIT\'E DE TELS DOMMAGES.
\blanklineskip
\bf{}L'AUTEUR  N'A  AUCUNE OBLIGATION DE FOURNIR DES MISES-\`A-JOUR, DE L'AIDE, DE
LA MAINTENANCE, DES AM\'ELIORATIONS OU DES MODIFICATIONS.\rm{}
\endnode
\node{3}{Introduction}
Tout  a  commenc\'e quand j'essayais d'imprimer un fichier AmigaGuide\raise 1ex\hbox{\rlap{$\,$\fiverm R}$\scriptstyle\bigcirc$}. Comme
tout  le  monde  sait,  un fichier AmigaGuide\raise 1ex\hbox{\rlap{$\,$\fiverm R}$\scriptstyle\bigcirc$} est divis\'e en noeuds, qui ne
sont  pas  tous  affich\'es en m\^eme temps. Ils sont reli\'es les uns aux autres
par des liens (surprise!) et l'utilisateur peut sauter d'un noeud \`a l'autre
en cliquant sur un tel lien.
\blanklineskip
Une  telle structure est pratique pour afficher un fichier de documentation
\`a l'\'ecran mais le r\'esultat devient tr\`es \'etrange quand le fichier est envoy\'e
\`a une imprimante, car toutes les commandes AmigaGuide\raise 1ex\hbox{\rlap{$\,$\fiverm R}$\scriptstyle\bigcirc$} qui sont normalement
cach\'ees deviennent visibles.
\blanklineskip
J'ai  alors  pens\'e effacer \`a la main toutes les commandes AmigaGuide, et de
copier le contenu de chaque noeud dans un fichier de pur texte, avec l'aide
du  presse-papier.  Mais  ce  n'\'etait pas pratique du tout et devenait vite
tr\`es longs pour les gros guides.
\blanklineskip
J'ai  donc  pens\'e \`a un programme pour faire ce travail. Comme ARexx poss\`ede
des  fonctions  pratiques  pour  manipuler les cha\^ines de caract\`eres et est
tr\`es  facile  \`a  utiliser,  c'\'etait le meilleur choix pour un d\'eveloppement
rapide.   J'ai  alors  pens\'e  "pourquoi  abandonner  toutes  ces  adorables
commandes  AmigaGuide\raise 1ex\hbox{\rlap{$\,$\fiverm R}$\scriptstyle\bigcirc$}  qui  pourraient  servir \`a am\'eliorer l'impression du
fichier?".  J'ai  donc choisi convertir le fichier au format TeX au lieu de
pur texte ASCII.
\blanklineskip
L'outil  texinfo existe pour la production (parmi d'autres formats comme le
html)  de fichiers AmigaGuide\raise 1ex\hbox{\rlap{$\,$\fiverm R}$\scriptstyle\bigcirc$} et DVI, mais requiert que l'auteur \'ecrive la
documentation dans un langage d'encore plus haut niveau. Les programmes que
vous  trouvez  sur Aminet (ou ailleurs) ne fournissent g\'en\'eralement que les
fichiers  de  documentation  AmigaGuide\raise 1ex\hbox{\rlap{$\,$\fiverm R}$\scriptstyle\bigcirc$}.  De  toutes  fa\c con,  les fichiers
AmigaGuide\raise 1ex\hbox{\rlap{$\,$\fiverm R}$\scriptstyle\bigcirc$}  produits  par  texinfo  sont  g\'en\'eralement  convertis de fa\c con
excellente par GuideToTeX.
\blanklineskip
Pour  ceux  qui  ne  connaissent  pas TeX, c'est un syst\`eme de mise en page
portable  universellement  utilis\'e  pour  sa  mise en page de haute qualit\'e
(gr\^ace  \`a  des  algorithmes intelligents et des fontes vectorielles) et son
excellente  gestion  des  math\'ematiques.  TeX  n'est pas un syst\`eme WYSIWYG
(What  You  See Is What You Get = Ce que vous voyez est ce que vous aurez),
mais  un langage: vous tapez d'abord un document "source" (un fichier ASCII
contenant beaucoup de commandes commen\c cant par un "$\backslash$") et le passez ensuite
\`a  TeX,  qui  produit un fichier "dvi" (device independent = ind\'ependant de
tout p\'eriph\'erique), qui peut ensuite \^etre visualis\'e \`a l'\'ecran ou imprim\'e.
\blanklineskip
La  meilleure  impl\'ementation  de TeX sur l'Amiga \`a l'heure actuelle (et la
plus \`a-jour) est AmiWeb2C, par Andreas Scherer (qui a fait la conversion de
la  version  Unix  sur  l'AmigaOS).  Elle utilise des parties de PasTeX, la
premi\`ere  impl\'ementation  domaine public de TeX sur l'Amiga. Aminet poss\`ede
un r\'epertoire complet pour les fichiers concernant TeX ("text/tex").
\blanklineskip
J'ai donc \'ecrit GuideToTeX sous forme d'un programme ARexx. Inutile de dire
que  mes  premi\`eres impressions sur "un travail facile d'une heure" se sont
r\'ev\'el\'ees  fausses.  En  effet, il fallait prendre en compte beaucoup de cas
particuliers,  convertir  tous  les  caract\`eres  au  format TeX... Bref, le
voici.  Il  n'est pas parfait (voyez les \link{probl\`emes}) mais s'est montr\'e utile
bien  que  le  fichier produit puisse n\'ecessiter un peu de remaniement pour
une mise en page parfaite.
\blanklineskip
Maintenant, le package GuideToTeX est divis\'e en plusieurs parties. Le coeur
du  syst\`eme  est  le  script ARexx \link{GuideToTeX.rexx}, qui effectue toutes les
conversions  n\'ecessaires.  Le  programme  \link{GuideToDVI.rexx}  ajoute  plus  de
possibilit\'es  et  d'options  \`a  un  niveau plus \'elev\'e. Et il y a un certain
nombre  (enfin  pour  l'instant  1:-)  de  \link{fichiers  en-t\^ete}  pour certains
ajustements.  Avec  de  l'exp\'erience,  je  suis  s\^ur  que vous trouverez ce
syst\`eme assez puissant. N'oubliez pas de m'en parler!
\endnode
\node{4}{Syst\`eme n\'ecessaire}
GuideToTeX n\'ecessite:
\blanklineskip
-- Un Amiga (ou peut-\^etre UAE)
\blanklineskip
--  La version 2.04 ou sup\'erieure de l'AmigaOS est peut-\^etre n\'ecessaire. Je
sugg\`ere fortement d'utiliser la version 3.1 ou sup\'erieure.
\blanklineskip
--  ARexx,  activ\'e  (assurez-vous  que  RexxMast  est  d\'emarr\'e  dans  votre
startup-sequence ou user-startup).
\blanklineskip
--  La  rexxdossupport.library  $\copyright$1994-1997  Hartmut  Goebel  (l'archive est
fournie).
\blanklineskip
-- Des fichiers AmigaGuide\raise 1ex\hbox{\rlap{$\,$\fiverm R}$\scriptstyle\bigcirc$} \`a convertir :-)
\blanklineskip
-- Une distribution de TeX sera n\'ecessaire pour la pr\'eparation des fichiers
TeX produits. Cherchez "AmiWeb2C" sur Aminet.
\blanklineskip
--  un  peu  de  connaissances  et  TeXniques peuvent \^etre n\'ecessaires pour
ajuster les r\'esultats.
\blanklineskip
--  si  vous  voulez utiliser l'interface graphique GuideToDVI-GUI, il vous
faut Argue version 0.9 ou sup\'erieure, c'est un syst\`eme d'interface MUI pour
les  programmes  utilisant  ReadArgs(). Vous le trouverez sur Aminet. Argue
est \'ecrit et copyright Thorsten "Flavour" Stocksmeier.
\endnode
\node{5}{GuideToTeX.rexx}
GuideToTeX.rexx est le script sur lequel le syst\`eme GuideToTeX est bas\'e. Il
s'occupe  de la conversion de la plupart des commandes AmigaGuide\raise 1ex\hbox{\rlap{$\,$\fiverm R}$\scriptstyle\bigcirc$} en leurs
"\'equivalents"  TeX. Plusieurs autres scripts appellent GuideToTeX.rexx mais
proposent des options de plus haut niveau.
\blanklineskip
Depuis le shell, l'utilisation se fait comme suit:
\blanklineskip
rx GuideToTeX.rexx GUIDEFILE/A, PRE= PREINCLUDE/K, POST= POSTINCLUDE/K,
LINKTOKENS/K, NODETOKENS/K, ENDNODETOKENS/K, B=BOLD/K, UB= UNBOLD/K, I=
ITALIC/K, UI= UNITALIC/K, U= UNDERLINE/K, UU= UNUNDERLINE/K,
SPACEINDENT/K/N, TABINDENT/K/N, RUNTEX/K, NOACCENTS/S, ONLYNODES/S,
BLS=BLANKLINESKIP/K, LOGFILE/K, QUIET/S
\blanklineskip
Pour  ceux  qui  ne  sont  pas  familiers  avec  la  syntaxe de la fonction
ReadArgs(), lisez \link{ici} pour la signification des /$<$lettre$>$.
\blanklineskip
\bf{}GUIDEFILE\rm{}:  (obligatoire)  le  nom du fichier guide \`a convertir. Le fichier
produit aura le m\^eme nom mais avec l'extension ".tex".
\blanklineskip
\bf{}PREINCLUDE\rm{}:  le  nom  d'un  fichier TeX \`a inclure avant qu'un texte ne soit
converti.  Un  tel  fichier  peut contenir des d\'efinitions de fontes et des
macros  sp\'eciales  n\'ecessaires  \`a  LINKTOKENS  ou NODETOKENS, et tout texte
n\'ecessaire  avant  le le contenu du guide ne soit inclus. Par d\'efaut: aucun
fichier.
\blanklineskip
\bf{}POSTINCLUDE\rm{}:  le  nom d'un fichier TeX \`a inclure apr\`es que tout le texte du
guide ait \'et\'e converti. Par d\'efaut: aucun fichier.
\blanklineskip
\blanklineskip
\bf{}LINKTOKENS\rm{}: les tokens \`a inclure quand un lien est d\'etect\'e dans le fichier.
Par  exemple,  si  LINKTOKENS  est  mis  \`a  "$\{\backslash$bf  \%s$\}$",  alors  les  liens
appara\^itront  en  gras. Par d\'efaut, c'est "$\backslash$underbar$\{$\%s$\}$", qui souligne les
liens. Le "\%s" indique o\`u le texte du guide sera plac\'e.
\blanklineskip
\bf{}NODETOKENS\rm{}:  les tokens \`a inclure quand un nouveau noeud est d\'etect\'e. Alors
le "\%s" d\'esigne le titre du noeud (le nom du noeud s'il n'y a pas de titre)
et  \%d  indique  le  num\'ero  du  noeud  (commence  \`a 1). Ceci peut servir \`a
construire  des  titres  de sections comme "$\backslash$vskip 1cm $\{\backslash$headingfont \%d.---
\%s$\}$".  Utilisez  NODETOKENS=""  si  vous n'en voulez pas. Vous pouvez aussi
utiliser  un  saut  de  page  ($\backslash$vfill$\backslash$eject). Par d\'efaut, c'est $\{\backslash$bf \%d.---
\%s$\}\backslash$medskip$\backslash$nobreak",  qui provoque l'impression en gras du num\'ero du noeud
et  son titres s\'epar\'es par un point et un tiret em, un saut moyen sans saut
de page.
\blanklineskip
\bf{}ENDOFNODETOKENS\rm{}: les tokens \`a inclure quand la fin d'un noeud est atteinte.
Ils  sont ins\'er\'es "tels quels", c'est-\`a-dire qu'il n'y a pas reconnaissance
de  "\%s".  Par  d\'efaut, c'est "$\backslash$smallskip$\backslash$hrule$\backslash$goodbreak$\backslash$bigskip": un sauv
vertical,  une ligne horizontale, indication d'une coupure de page possible
et un autre blanc vertical.
\blanklineskip
\bf{}BOLD\rm{}: la commande AmigaGuide @$\{$b$\}$ sera chang\'ee en cela. Par d\'efaut: $\backslash$bf$\{\}$.
\blanklineskip
\bf{}UNBOLD\rm{}: la commande AmigaGuide @$\{$ub$\}$ sera chang\'ee en cela. Par d\'efaut: $\backslash$rm$\{\}$.
\blanklineskip
\bf{}ITALIC\rm{}: la commande AmigaGuide @$\{$i$\}$ sera chang\'ee en cela. Par d\'efaut: $\backslash$it$\{\}$.
\blanklineskip
\bf{}UNITALIC\rm{}: la commande AmigaGuide @$\{$ui$\}$ sera chang\'ee en cela. Par d\'efaut: $\backslash$rm$\{\}$.
\blanklineskip
\bf{}UNDERLINE\rm{}: la commande AmigaGuide @$\{$u$\}$ sera chang\'ee en cela. Par d\'efaut: $\backslash$tt$\{\}$.
\blanklineskip
\bf{}UNUNDERLINE\rm{}: la commande AmigaGuide @$\{$uu$\}$ sera chang\'ee en cela. Par d\'efaut: $\backslash$rm$\{\}$.
\blanklineskip
\bf{}SPACEINDENT\rm{}:  si  une ligne est indent\'ee avec des espaces, les espaces sont
remplac\'es  par  un  $\backslash$hskip  provoquant un blanc horizontal. La taille de ce
blanc  est  le  nombre  d'espace indentant la ligne multipli\'e par la valeur
exprim\'ee ici en millim\`etres. Par d\'efaut: 2 millim\`etres.
\blanklineskip
\bf{}TABINDENT\rm{}:  si  une ligne est indent\'ee avec des tabulations, celles-ci sont
remplac\'ees  par  un  $\backslash$hskip provoquant un blanc horizontal. La taille de ce
blanc  est  le  nombre  de  tabulations indentant la ligne multipli\'e par la
valeur exprim\'ee ici en millim\`etres. Par d\'efaut c'est 16 millim\`etres, ce qui
fait que la tabulation \'equivaut par d\'efaut \`a huit espaces (par d\'efaut).
\blanklineskip
\bf{}RUNTEX\rm{}:  si  cet  argument  est  non vide (ce qui est sa valeur par d\'efaut)
alors  il  est  utilis\'e  comme commande d'invocation pour la compilation de
TeX.  La  valeur  sugg\'er\'ee  est  simplement  "tex \%s". Le "\%s" est bien s\^ur
remplac\'e par le nom du fichier destination.
\blanklineskip
\bf{}NOACCENTS\rm{}:  si  vous  savez  que  votre  fichier  guide  ne contient pas de
caract\`eres accentu\'es ou si vous utilisez une version huit bits de TeX, vous
pouvez  d\'esactiver  la  conversion  des  caract\`eres  accentu\'es  (et autres)
((\`a,\'e,\`e,\~N,$\times$,etc.) avec cet interrupteur. Ceci acc\'el\`erera la conversion.
\blanklineskip
\bf{}ONLYNODES\rm{}:  Normalement,  tout  texte  qui  ne  se trouve pas dans un noeud
(c'est-\`a-dire  entour\'e d'une paire @node/@endnode) est quand m\^eme converti,
bien  qu'il  ne  soit  pas  visible dans le guide. Avec l'activation de cet
interrupteur, GuideToTeX ignorera ce texte.
\blanklineskip
\bf{}BLS=BLANKLINESKIP\rm{}: si une ligne vide est d\'etect\'ee, cette macro est ins\'er\'ee.
Par d\'efaut, c'est "medskip" mais vous pouvez la changer comme vous voulez.
Notez  cependant  qu'une ligne vierge implique aussi la fin d'un paragraphe
et  que  TeX  ajoute  alors  le  blanc  vertical  parskip avant un nouveau
paragraphe.  Cette  macro  est  utile si un paragraphe est d\'ebut\'e par TeX \`a
cause  d'une  ligne indent\'ee mais qu'aucune ligne vide ne se trouve dans le
guide: cette macro n'est PAS incluse dans ce cas.
\blanklineskip
\bf{}LOGFILE\rm{}:  nom d'un fichier qui contient tous les messages de GuideToTeX. Il
n'est pas affect\'e par l'option QUIET. Par d\'efaut: "GuideToTeX.log".
\blanklineskip
\bf{}LOGFILE\rm{}  :  Name of a file which will contain all outputs of GuideToTeX. It
is not affected by the QUIET option. Default: "GuideToTeX.log".
\blanklineskip
\bf{}QUIET\rm{}: n'affiche que les messages d'erreur.
\blanklineskip
N'oubliez pas de lire la section concernant les \link{probl\`emes}!
\endnode
\node{6}{GuideToDVI.rexx}
GuideToDVI.rexx  est un script qui utilise GuideToTeX.rexx mais propose des
options  de plus haut niveau pour la conversion. \`A la base, GuideToDVI.rexx
pr\'epare un fichier temporaire contenant des d\'efinitions de macros utiles et
de  tokens  utilis\'es pour la conversion, avec certains ajustements pour une
meilleure mise en page.
\blanklineskip
GuideToDVI.rexx s'utilise \`a partir du shell comme ceci:
\blanklineskip
rx GuideToDVI.rexx GUIDEFILE/A, CONFIG/K, MAGNIFICATION/K/N, HSIZE/K/N,
VSIZE/K/N, HOFFSET/K/N, VOFFSET/K/N, BLACKBOXES/S, PARINDENT/K/N, FRENCH/S,
TPH=TITLEPAGEHEAD/K, TPF=TITLEPAGEFOOT/K, LPH=LEFTPAGEHEAD/K,
LPF=LEFTPAGEFOOT/K, RPH=RIGHTPAGEHEAD/K, RPF=RIGHTPAGEFOOT/K, PREINCLUDE/K,
POSTINCLUDE/K, LOGFILE/K, QUIET/S
\blanklineskip
Tous  ces  arguments  peuvent  \'egalement  \^etre  remplis  via  une interface
graphique  MUI  en  double-cliquant  sur GuideToDVI-GUI. Il vous \link{faut} Argue
pour cela.
\blanklineskip
Pour  ceux  qui  ne  sont  pas  familiers  avec  la  syntaxe de la fonction
ReadArgs(), lisez \link{ici} pour la signification des /$<$lettre$>$.
\blanklineskip
Avant de continuer avec la description de chaque argument, notez que chacun
de  ceux-ci  peuvent  se trouver dans un fichier de configuration (sp\'ecifi\'e
par  le  mot-cl\'e  \bf{}CONFIG\rm{}).  Les arguments sur la ligne de commande \'ecrasent
ceux  du  fichier  de configuration. Le fichier de configuration par d\'efaut
est \it{}"TEX:config/GuideToDVI.config"\rm{}.
\blanklineskip
\bf{}GUIDEFILE\rm{}: (obligatoire) le nom du fichier guide \`a convertir.
\blanklineskip
\bf{}CONFIGFILE\rm{}:  nom  d'un  fichier  de  configuration  \`a lire. Les fichiers de
configuration  contiennent  les  m\^emes  commandes,  except\'e  \bf{}GUIDEFILE\rm{}. Par
d\'efaut: "TEX:config/GuideToDVI.config".
\blanklineskip
\bf{}MAGNIFICATION\rm{}: le facteur d'agrandissement pour le document. Par d\'efaut: 0.
\blanklineskip
\bf{}HSIZE\rm{}: largeur de la page, en centim\`etres. Par d\'efaut: 16.
\blanklineskip
\bf{}VSIZE\rm{}: hauteur de la page, en centim\`etres. Par d\'efaut: 24.
\blanklineskip
\bf{}HOFFSET\rm{}:  d\'ecalage  horizontal  du  texte dans la page, en millim\`etres. Par
d\'efaut: 0.
\blanklineskip
\bf{}VOFFSET\rm{}:  d\'ecalage  vertical  du  texte  dans  la page, en millim\`etres. Par
d\'efaut: 0.
\blanklineskip
\bf{}BLACKBOXES\rm{}:  (utilisez  BLACKBOXES  on|off). Active ou d\'esactive les bo\^ites
noires  de  TeX  dans  la  marge  droite lorsqu'il y a des overfull $\backslash$hboxes
(bo\^ites horizontales trop pleines). Par d\'efaut: off.
\blanklineskip
\bf{}PARINDENT\rm{}: Indentation des paragraphes, en millim\`etres. Par d\'efaut: 0.
\blanklineskip
\bf{}FRENCH\rm{}:  Active ou d\'esactive le mode fran\c cais. Cela implique $\backslash$frenchspacing
et  la  red\'efinition des signes de ponctuation pour tenir compte des r\`egles
fran\c caises les concernant. Par d\'efaut: off.
\blanklineskip
\bf{}TPH=TITLEPAGEHEAD\rm{}: les tokens \`a ins\'erer dans la ligne du haut de la page de
titre (normalement la premi\`ere page du document). Par d\'efaut: "$\{\backslash$hfill$\}$".
\blanklineskip
\bf{}TPF=TITLEPAGEFOOT\rm{}:  les  tokens  \`a  ins\'erer  en  bas  de  la  page de titre
(normalement la premi\`ere page du document). Par d\'efaut: "$\{\backslash$hfil$\}$".
\blanklineskip
\bf{}LPH=LEFTPAGEHEAD\rm{}:  les  tokens  \`a  ins\'erer  dans la ligne du haut des pages
gauches         (de         num\'ero         pair).        Par        d\'efaut:
$\{\backslash$hfil$\backslash$tenrm$\backslash$the$\backslash$databasename/$\backslash$the$\backslash$currentnodetitle$\backslash$hfil$\}$".
\blanklineskip
\bf{}LPF=LEFTPAGEFOOT\rm{}:  les tokens \`a ins\'erer en bas de la page gauche (de num\'ero
pair). Par d\'efaut: "$\{\backslash$hfil$\backslash$tenrm$\backslash$folio$\backslash$hfil$\}$".
\blanklineskip
\bf{}RPH=RIGHTPAGEHEAD\rm{}:  les  tokens  \`a  ins\'erer dans la ligne du haut des pages
droites (de num\'ero impair). Par d\'efaut identique \`a \bf{}LPH\rm{}.
\blanklineskip
\bf{}RPF=RIGHTPAGEFOOT\rm{}: les tokens \`a ins\'erer en bas de la page droite (de num\'ero
impair). Par d\'efaut identique \`a \bf{}LPF\rm{}.
\blanklineskip
\bf{}PRE=PREINCLUDE\rm{}: nom d'un fichier TeX \`a inclure avant le texte du guide. Par
d\'efaut: "" (aucun).
\blanklineskip
\bf{}POST=POSTINCLUDE\rm{}:  nom  d'un fichier TeX \`a inclure apr\`es le texte du guide.
Par d\'efaut: "" (aucun).
\blanklineskip
\bf{}LOGFILE\rm{}:  nom  d'un fichier qui contiendra tous les messages de GuideToDVI.
N'est pas affect\'e par l'option QUIET. Par d\'efaut: "GuideToDVI.log".
\blanklineskip
\bf{}QUIET\rm{}:  n'affiche  que les messages d'erreur. Implique \'egalement QUIET pour
\link{GuideToTeX}.
\blanklineskip
Apr\`es  conversion  par  GuideToDVI.rexx,  le fichier est pass\'e \`a TeX via la
commande \it{}tex \%s\rm{} (\%s est remplac\'e par le nom du fichier converti).
\blanklineskip
\blanklineskip
Il  vous faudra un peu de connaissances sur TeX si vous voulez modifier les
valeurs  et  macros  suivantes. Les valeurs par d\'efaut devraient convenir \`a
l'utilisateur novice.
\blanklineskip
Certains  tokens  ou  compteurs  sp\'eciaux  sont  d\'efinis  (dans  le fichier
temporaire  cr\'e\'e  par GuideToDVI) et peuvent \^etre utilis\'es sans risque pour
red\'efinir  les  macros  \bf{}$\backslash$link\rm{},  \bf{}$\backslash$node\rm{} ou \bf{}$\backslash$endnode\rm{} (voir plus loin pour leur
description),  ou utilis\'es dans un fichier \bf{}PREINCLUDE\rm{} ou \bf{}POSTINCLUDE\rm{}. Ce ne
sont  PAS  des macros eux-m\^emes, vous devrez utiliser $\backslash$the pour les inclure
dans le texte.
\blanklineskip
\bf{}$\backslash$databasename\rm{}:  nom  de  la  base de donn\'ees (apr\`es le mot-cl\'e @database au
d\'ebut du guide).
\blanklineskip
\bf{}$\backslash$guidefilename\rm{}:  nom  du fichier guide. Bien s\^ur, il peut \^etre diff\'erent de
\bf{}$\backslash$databasename\rm{}. Uniquement la composante "fichier" du chemin.
\blanklineskip
\bf{}$\backslash$guidedirname\rm{}:  nom  du r\'epertoire contenant le fichier guide. Ce n'est PAS
un chemin absolu, mais la composante "chemin" de l'argument \bf{}GUIDEFILE\rm{}.
\blanklineskip
\bf{}$\backslash$guidepath\rm{}:  chemin  d'acc\`es  du  guide,  tel  qu'indiqu\'e  sur  la ligne de
commande.
\blanklineskip
\bf{}$\backslash$guideabspath\rm{}: chemin absolu du guide.
\blanklineskip
\bf{}$\backslash$currentnodenumber\rm{}:  c'est  un compteur contenant le num\'ero du noeud. Mis \`a
jour par la macro \bf{}$\backslash$node\rm{} par d\'efaut.
\blanklineskip
\bf{}$\backslash$currentnodetitle\rm{}:  titre  du noeud en cours. Mis \`a jour par la macro \bf{}$\backslash$node\rm{}
par d\'efaut.
\blanklineskip
\bf{}$\backslash$titlepagehead\rm{},      \bf{}$\backslash$titlepagefoot\rm{},      \bf{}$\backslash$leftpagehead\rm{},     \bf{}$\backslash$leftpagefoot\rm{},
\bf{}$\backslash$rightpagehead\rm{}, \bf{}$\backslash$rightpagefoot\rm{}:  contiennent  les tokens correspondants aux
arguments de m\^emes noms.
\blanklineskip
\bf{}$\backslash$titlepage\rm{} est un nouveau if. Indiquez \bf{}$\backslash$titlepagetrue\rm{} si vous voulez qu'une
page  soit  consid\'er\'ee comme page de titre (c'est-\`a-dire que \bf{}$\backslash$titlepagehead\rm{}
et   \bf{}$\backslash$titlepagefoot\rm{}   seront   ins\'er\'es   \`a   la   place  respectivement  de
\bf{}$\backslash$left(right)pagehead\rm{}  et  \bf{}$\backslash$left(right)pagefoot\rm{}. Ne reste actif que pour une
seule page et est faux (\bf{}$\backslash$titlepagefalse\rm{}) par d\'efaut.
\blanklineskip
\bf{}$\backslash$authordef\rm{} est un nouveau if. Il est vrai ($\backslash$authordeftrue) si une commande @author
a \'et\'e trouv\'ee dans le guide, auquel cas le token \bf{}$\backslash$author\rm{} est d\'efini.
\blanklineskip
\bf{}$\backslash$author\rm{}  contient  le  nom  de  l'auteur  du  guide, si \bf{}$\backslash$authordef\rm{} est vrai
(testez  avec  une  commande  comme  \it{}"$\backslash$ifauthordef  auteur:$\backslash$the$\backslash$author$\backslash$else
auteur inconnu$\backslash$fi"\rm{}).
\blanklineskip
\bf{}$\backslash$guideversiondef\rm{}  est  un  nouveau if qui est vrai si une commande @\$VER: a
\'et\'e trouv\'ee dans le guide, auquel cas \bf{}$\backslash$guideversion\rm{} est d\'efini.
\blanklineskip
\bf{}$\backslash$guideversion\rm{} contient le message de version du guide. Valide uniquement si
\bf{}$\backslash$guideversiondef\rm{} est vrai (voyez $\backslash$author ci-dessus).
\blanklineskip
\bf{}$\backslash$cpyrghtdef\rm{}  est  un  nouveau  if  qui  est vrai si une commande @(c) a \'et\'e
trouv\'ee dans le guide, auquel cas \bf{}$\backslash$cpyrght\rm{} est d\'efini.
\blanklineskip
\bf{}$\backslash$cpyrght\rm{}  contient  le message de copyright du guide, s'il est d\'efini (i.e.
\bf{}$\backslash$cpyrghtdef\rm{} est vrai). Faites bien la diff\'erence entre $\backslash$copyright (le signe
$\copyright$, en TeX) et ce token.
\blanklineskip
\bf{}$\backslash$masterdef\rm{}  est  un  nouveau  if, vrai si la commande @master a \'et\'e trouv\'ee
dans le guide. Dans ce cas, \bf{}$\backslash$master\rm{} est d\'efini.
\blanklineskip
\bf{}$\backslash$master\rm{}  contient  le  nom du fichier d'origine utilis\'e pour la cr\'eation du
guide. Peu utilis\'e en pratique. N'est valide que si \bf{}$\backslash$masterdef\rm{} est vrai.
\blanklineskip
\blanklineskip
Enfin,  les macros suivantes sont utilis\'ees, vous pouvez les red\'efinir dans
un fichier \bf{}PREINCLUDE\rm{}, pour un look diff\'erent du fichier converti.
\blanklineskip
\bf{}$\backslash$link\#1\rm{}:  c'est la macro appel\'ee pour chaque lien trouv\'e. L'argument \#1 est
le texte du lien. Par d\'efaut c'est $\backslash$underbar$\{$\#1$\}$ (souligne le lien).
\blanklineskip
\bf{}$\backslash$node\#1\#2\rm{}: c'est la macro appel\'ee quand un nouveau noeud est rencontr\'e. Les
arguments \#1 et \#2 sont respectivement le num\'ero du noeud et son titre. Par
d\'efaut c'est 
$\{\backslash$bf  \#1.--- \#2$\}\backslash$medskip$\backslash$nobreak$\backslash$currentnodenumber=\#1$\backslash$currentnodetitle=$\{$\#2$\}$
(imprime  en  gras  le  num\'ero du noeud, un point, un tiret em, le titre du
noeud, passe un blanc vertical moyen, interdit le saut de page et r\`egle les
valeurs  de  \bf{}$\backslash$currentnodenumber\rm{}  et  \bf{}$\backslash$currentnodetitle\rm{}).  N'oubliez  pas de
r\'egler  ces deux valeurs si vous les utilisez ailleurs (par exemple dans la
ligne de haut/bas d'une page.
\blanklineskip
\bf{}$\backslash$endnode\rm{}:  c'est la macro appel\'ee quand la fin d'un noeud est atteinte. Par
d\'efaut c'est $\backslash$smallskip$\backslash$hrule$\backslash$goodbreak$\backslash$bigskip qui provoque un petit blanc
vertical,  trace une ligne horizontale, indique la possibilit\'e d'un saut de
page et saute un grand blanc vertical.
\blanklineskip
\bf{}$\backslash$gobold\rm{},  \bf{}$\backslash$gounbold\rm{},  \bf{}$\backslash$goitalic\rm{},  \bf{}$\backslash$gounitalic\rm{}, \bf{}$\backslash$gounderline\rm{}, \bf{}$\backslash$goununderline\rm{}
sont des macros appel\'ees quand un changement de style est n\'ecessaire. Voyez
\link{GuideToTeX.rexx}  pour  les  valeurs  par d\'efaut. Elles sont l\`a pour pouvoir
\^etre  facilement  red\'efinies,  elles  ne  sont  pas  vraiment utilis\'ees par
GuideToDVI.rexx mais par \link{GuideToTeX.rexx}.
\blanklineskip
\bf{}$\backslash$blanklineskip\rm{}:  cette  macro est ins\'er\'ee quand une ligne vide est d\'etect\'ee
dans  le guide. Voyez \link{GuideToTeX.rexx} pour une description, car cette macro
est  utilis\'ee  comme argument \bf{}BLANKLINESKIP\rm{} pour \link{GuideToTeX.rexx}. La valeur
par d\'efaut est $\backslash$medskip.
\endnode
\node{7}{Les conventions de ReadArgs()}
\bf{}/A\rm{}  indique  un  argument  obligatoire.  S'il n'est pas donn\'e, le programme
\'echouera.
\blanklineskip
\bf{}/K\rm{} indique que le mot-cl\'e doit \^etre explicitement donn\'e pour que l'argument
soit reconnu. Vous pouvez utiliser un espace ou un signe = entre le mot-cl\'e
et l'argument.
\blanklineskip
\bf{}/N\rm{} dit que l'argument doit \^etre un nombre.
\blanklineskip
\bf{}/S\rm{}  dit que l'argument est un interrupteur: soit il est pr\'esent, soit il ne
l'est pas.
\blanklineskip
\bf{}/T\rm{}  dit que l'argument est une bascule. Vous pouvez soit utiliser le nom de
l'argument  pour faire basculer son \'etat de faux \`a vrai ou son nom suivi de
on  ou  off.  Ce  cette fa\c con un argument peut \^etre sp\'ecifi\'e plusieurs fois
(sur la ligne de commande ou dans un fichier de configuration).
\blanklineskip
\tt{}Note\rm{}:  l'impl\'ementation  ARexx  de la fonction ReadArgs() se trouve dans la
rexxdossupport.library de Hartmut Goebel. Bon travail, Hartmut.
\endnode
\node{8}{Fichiers en-t\^ete fournis}
Cette distribution de GuideToTeX ne contient que deux fichier en-t\^ete. Il y
en   aura   sans   doute  plus  la  prochaine  fois.  Si  vous  en  \'ecrivez
d'int\'eressants,  envoyez-les  \link{moi},  pour  que je puisse les inclure dans la
prochaine distribution.
\blanklineskip
Les   fichiers   en-t\^ete   sont   utilis\'es   avec  l'option  \bf{}PREINCLUDE\rm{}  de
\link{GuideToTeX.rexx} ou de \link{GuideToDVI.rexx}. Ils ajoutent plus de fonctionnalit\'es
dans la mise en page.
\blanklineskip
\it{}TitlePage.tex\rm{}:
\par\hskip 16mm{}Ce  fichier  est mon premier essai pour la cr\'eation d'un g\'en\'erateur
automatique de page titre. Utilisez-le (seulement) avec \link{GuideToDVI.rexx}:
\blanklineskip
\it{}RX GuideToDVI $<$AmigaGuidefile$>$ PRE TitlePage.tex\rm{}
\blanklineskip
Ceci  g\'en\`erera  une page titre avec le nom de la base de donn\'ees encadr\'e au
milieu  de  la  page  et  des informations sur l'auteur, le copyright et la
version  si  elles  sont  d\'efinies  (voyez  \link{GuideToDVI}),  une page de garde
derri\`ere. Essayez-le.
\blanklineskip
\it{}BoxLinks.tex\rm{}
\par\hskip 16mm{}Ceci \'ecrit les liens dans un encadr\'e (comme sous Multiview) au lieu
de  les  souligner.  Le  r\'esultat  \`a  l'imression  n'est  pas si bon, c'est
pourquoi  je  ne  l'ai  pas  inclus  par  d\'efaut.  Mais si vous aimez cela,
utilisez ce fichier dans l'argument \bf{}PRE\rm{} de \link{GuideToDVI}.
\endnode
\node{9}{FAQs et conseils}
Dans  cette  section,  j'ai  ajout\'e  des  conseils  et  FAQs \`a propos de la
conversion et de la compilation par GuideToTeX d'un fichier AmigaGuide\raise 1ex\hbox{\rlap{$\,$\fiverm R}$\scriptstyle\bigcirc$}. Si
vous  avez  d'autres probl\`emes non list\'es ici ou dans les \link{probl\`emes connus},
\'ecrivez-\link{moi}.
\blanklineskip
\it{}Lors  de  la compilation, TeX se plaint \`a propos de beaucoup de bo\^ites trop
pleines (overfull boxes) et il y a des carr\'es noirs dans la marge droite.\rm{}
\blanklineskip
\par\hskip 16mm{}Ce  n'est  pas  la  faute  de GuideToTeX mais celle de TeX, qui est
plut\^ot  pointilleux \`a propos des lignes qui d\'epassent dans la marge droite.
La solution est de reformatter le fichier guide et d'ajouter des espaces l\`a
o\`u  vous  pouvez  tol\'erer  des  coupures de ligne. Si ce n'est toujours pas
suffisant,  vous  pouvez  avoir  \`a  \'editer  le  fichier  TeX  pour indiquer
manuellement \`a TeX quoi faire.
\par\hskip 16mm{}Si  le  d\'epassement  est faible et que vous pouvez le tol\'erer, vous
pouvez  ignorer  le message d'erreur et utiliser l'option \bf{}BLACKBOXES off\rm{} de
\link{GuideToDVI.rexx}.  Ou  bien  vous  pouvez  augmenter  la tol\'erance de TeX en
modifiant  la  valeur  \it{}$\backslash$hfuzz\rm{}  (qui est r\'egl\'ee \`a 1pt \`a \link{GuideToDVI.rexx} (pas
\link{GuideToTeX.rexx}!).  Si  ce  n'est  pas  encore  assez,  vous pouvez ins\'erer
quelques   macros  \it{}$\backslash$goodbreak\rm{}  l\`a  o\`u  les  lignes  peuvent  \^etre  cass\'ees,
\'eventuellement   un   \it{}$\backslash$raggedright\rm{}   pour   dire   \`a  TeX  d'abandonner  la
justification \`a droite.
\blanklineskip
\blanklineskip
\it{}Que dois-je faire des messages "bo\^ites pas assez pleines" (underfull boxes)?\rm{}
\blanklineskip
\par\hskip 16mm{}Les ignorer, dans la plupart des cas.
\blanklineskip
\blanklineskip
\it{}J'ai des messages "warning, untranslated non-ASCII character" (attention,
caract\`ere non-ASCII intraduisible). Que dois-je faire?\rm{}
\blanklineskip
\par\hskip 16mm{}TeX  ne  travaille  qu'avec les caract\`eres \bf{}ASCII\rm{} (c'est-\`a-dire ceux
dont  le  code est compris entre 0 et 127) car les autres (128-255) ne sont
pas compl\`etement standards. GuideToTeX fait de son mieux pour convertir les
caract\`eres  du  jeu  \bf{}Latin-1\rm{}  (utilis\'e  par l'Amiga, Unix et euh... Widnoz?
C'est quoi d\'ej\`a le nom de l'interface graphique du DOS? :-) ) en macros TeX
valides,  mais  ce n'est pas toujours possible. C'est assez facile pour les
lettres  accentu\'ees, mais je n'ai pas toujours trouv\'e d'\'equivalent pour les
autres.  Un des plus difficiles \'etait le logo "enregistr\'e" \raise 1ex\hbox{\rlap{$\,$\fiverm R}$\scriptstyle\bigcirc$}, mais je pense
que le r\'esultat est assez bon. Actuellement, les caract\`eres reconnus sont:
\blanklineskip
\`A \'A \^A \~A \"A \^A \AE  \c C \`E \'E \^E \"E \`I \'I \^I \"I \~N \`O \'O \^O \~O \"O \`U \'U \^U \"U \'Y \ss  \`a \'a \^a \~a \"a \aa  \ae  \c c \`e \'e
\^e \"e \`i \'i \^i \"i \~n \`o \'o \^o \~o \"o $\div$ $\phi$ \`u \'u \^u \"u \'y \"y $\times$ $\emptyset$ ~ !` $\copyright$ \leavevmode\raise.3ex\hbox{$\scriptscriptstyle\langle\!\langle$} \leavevmode\raise.3ex\hbox{$\scriptscriptstyle\,\rangle\!\rangle$} $\neg$ $-$ ${}^o$ $\pm$ ${}^2$ ${}^3$ $\mu$ \P  $\bullet$ , ${}^1$
$\scriptscriptstyle {1\over4}$ $\scriptscriptstyle {1\over2}$ $\scriptscriptstyle {3\over4}$ ?` \raise 1ex\hbox{\rlap{$\,$\fiverm R}$\scriptstyle\bigcirc$}
\blanklineskip
Si vous avez des suggestions pour les autres, faites-le \link{moi} savoir pour que
je   puisse  \'etendre  la  routine  de  traduction.  Pour  l'instant,  quand
GuideToTeX   rencontre   un   caract\`ere   intraduisible,   il   en  avertit
l'utilisateur  et  inclut  le  caract\`ere "tel quel" dans le fichier TeX. La
plupart  du  temps,  \`a moins que vous n'utilisiez une version 8 bits de TeX
(la  plupart  le sont de nos jours) ET que le caract\`ere en question ne soit
d\'efini  comme  une macro, il est ignor\'e par l'algorithme de mise en page de
TeX.
\blanklineskip
\par\hskip 16mm{}Si vous savez que votre fichie guide ne contient que des caract\`eres
purement  ASCII,  vous  pouvez  d\'esactiver  la  routine  de  traduction  de
\link{GuideToTeX.rexx}  avec  le  mot-cl\'e  \bf{}NOACCENT\rm{}.  Ce  n'est  pas possible pour
l'instant dans \link{GuideToDVI.rexx}. \'Ecrivez-moi si c'est un probl\`eme.
\blanklineskip
\blanklineskip
\it{}Comment puis-je inclure plusieurs fichiers en-t\^ete ou de post-conversion?\rm{}
\blanklineskip
\par\hskip 16mm{}Ce  n'est  possible  que  pour  \link{GuideToDVI.rexx}.  Il faut \'editer le
fichier  de  configuration  et ajouter une ligne avec l'argument \bf{}PREINCLUDE\rm{}
(ou  \bf{}POSTINCLUDE\rm{}) et le fichier correspondant. On peut en mettre autant que
l'on  veut mais toujours sur une ligne diff\'erente. Attention, on ne peut en
mettre qu'un seul sur la ligne de commande.
\blanklineskip
\blanklineskip
\it{}Les titres de sections soulign\'es "manuellement" sont \'etranges en TeX...\rm{}
\blanklineskip
\par\hskip 16mm{}Beaucoup utilisent des rang\'ees de tirets ou d'ast\'erisques ou autres
caract\`eres   \'etranges  pour  souligner  ou  encadrer  du  texte  important.
Malheureusement  il  n'existe pas de moyen v\'eritable pour d\'etecter cela et,
m\^eme  si GuideToTeX convertira sans mot dire ces caract\`eres, le r\'esultat en
TeX  ne  sera pas aussi bon qu'il devrait l'\^etre car TeX traite les retours
chariots  comme  des espaces. M\^eme avec une macro obeylines, soyez s\^ur que
l'art  ASCII  et TeX ne font pas bon m\'enage. D'ailleurs, l'art ASCII et les
fontes  proportionnelles  non  plus.  La seule chose \`a faire est de retirer
manuellement   ces   souligneurs   du  source  TeX  avant  de  relancer  la
compilation.
\endnode
\node{10}{Historique}
\tt{}Version 1.01 (27.10.98)\rm{}
\par\hskip 16mm{}R\'epar\'e  la  fa\c con  dont \^\  et \~\  sont convertis. Cela devrait marcher
mainenant (rapport\'e par Himanshu Gohel).
\par\hskip 16mm{}Il manquait un espace apr\`es la conversion de \aa  et \^A.
\par\hskip 16mm{}Mise \`a jour des FAQs.
\par\hskip 16mm{}Mise \`a jour de mon adresse e-mail.
\blanklineskip
\tt{}Version 1.0 (10.08.98)\rm{}
\par\hskip 16mm{}Ajout d'un groupe vide $\{\}$ apr\`es une commande $\backslash$hskip pour \'eviter une
mauvaise   interpr\'etation   de  lignes  commen\c cant  par  "plus"  apr\`es  une
indentation.
\par\hskip 16mm{}Modification  de  la  gestion  des inclusions dans GuideToDVI.rexx:
ligne  $\backslash$input au  lieu d'inclusion brutale, mais la gestion des fichiers en
TeX  est  si grossi\`ere qu'il ne pouvait pas trouver la moiti\'e des fichiers.
Je suis revenu \`a la m\'ethode brutale. Elle marche :-).
\par\hskip 16mm{}Maintenant  une correction dans la routine de lecture du fichier de
configuration  de  GuideToDVI permet plusieurs arguments PRE/POST, bien que
ReadArgs()  ne permette pas /K/M. Notez cependant que chacun des diff\'erents
fichiers  de  ces  arguments  doit  se  trouver sur une ligne diff\'erente du
fichier de configuration.
\par\hskip 16mm{}Reconnaissance des commandes @author, @\$ver:, @(c), @master.
\par\hskip 16mm{}Ajout\'e une GUI Argue pour GuideToDVI.rexx.
\blanklineskip
\tt{}Version 1.0 beta (03.08.98)\rm{}
\par\hskip 16mm{}Premi\`ere version interne.
\endnode
\node{11}{Probl\`emes connus}
Voici  une  liste  des  probl\`emes  connus.  Je travaille actuellement \`a les
corriger.
\blanklineskip
---  Probl\`emes  avec  les  styles  mix\'es: la d\'esactivation du gras entra\^ine
\'egalement  celle  de l'italique et ainsi de suite. Ceci pourrait \^etre \'evit\'e
par un peu de programmation conditionnelle en TeX. J'y penserai.
\blanklineskip
---  Certains  guides utilisent une marge gauche non nulle, ce qui provoque
le  d\'ebut d'un nouveau paragraphe \`a chaque ligne. Dans des versions futures
j'ajouterai  une  modification  pour  en  tenir  compte, avec peut-\^etre une
r\'eelle reconnaissance des paragraphes indent\'es.
\blanklineskip
--- Il y a encore des commandes AmigaGuide\raise 1ex\hbox{\rlap{$\,$\fiverm R}$\scriptstyle\bigcirc$} qui pourraient \^etre exploit\'ees,
mais il fallait bien commencer quelque part.
\blanklineskip
---  Pas de v\'eritable reconnaissance de l'index. Ceci sera \bf{}TR\`ES\rm{} difficile \`a
r\'ealiser. :-)
\blanklineskip
---  C'est  lent. Je le sais. Quand j'en aurai le temps, je ferai \bf{}peut-\^etre\rm{}
une version compil\'ee!
\blanklineskip
Si vous d\'ecouvrez des bugs ou voudriez des am\'eliorations, \link{\'ecrivez}-moi!!
\endnode
\node{12}{Contacter l'auteur}
Si  vous  voulez  parler Amiga, Maths, avez trouv\'e des bugs ou voulez juste
bavarder, n'h\'esitez pas \`a me contacter:
\blanklineskip
\tt{}e-mail\rm{}: fdelacroix@nordnet.fr
\blanklineskip
\tt{}Snail-mail\rm{}:
\par\hskip 16mm{}Fr\'ed\'eric Delacroix
\par\hskip 16mm{}4 rue Mirland
\par\hskip 16mm{}59300 Valenciennes
\par\hskip 16mm{}France.
\blanklineskip
GuideToTeX   a  \'et\'e  \'ecrit  et  test\'e  sur  un  A1200  \'equip\'e  d'une  carte
acc\'el\'eratrice  Blizzard  1230IV SCSI-2, d'un disque dur IDE 405Mo et 8Mo de
m\'emoire  FAST.  Comme  c'est  un  programme  ARexx, je ne vois vraiment pas
pourquoi  il devrait \'echouer \`a cause d'une configuration diff\'erente... sauf
si vous utilisez Widows, bien s\^ur :-)
\endnode
\node{13}{Credits et remerciements}
Je  voudrais  saluer  et  remercier  les  personnes  suivantes,  sans ordre
particulier:
\blanklineskip
\par\hskip 16mm{}\it{}Hartmut Goebel\rm{} pour la rexxdossupport.library.
\blanklineskip
\par\hskip 16mm{}\it{}Thorsten "Flavour" Stocksmeier\rm{} pour Argue.
\blanklineskip
\par\hskip 16mm{}\it{}Andreas Scherer\rm{} pour le merveilleux AmiWeb2C.
\blanklineskip
\par\hskip 16mm{}\it{}William S. Hawes\rm{} pour ARexx.
\blanklineskip
\par\hskip 16mm{}\it{}Guido Mersmann\rm{} pour BoulderD\"ash.
\blanklineskip
\par\hskip 16mm{}\it{}La m\'emoire de Jay Miner\rm{} pour l'Amiga.
\blanklineskip
\par\hskip 16mm{}\it{}Himanshu Gohel\rm{} pour le rapport de bug.
\blanklineskip
\par\hskip 16mm{}\it{}Toute la communaut\'e Amiga\rm{} pour son support ininterrompu en ces
temps difficiles.
\endnode
\bye
% File converted from AmigaGuide by GuideToTeX
% GuideToTeX Copyright 1998 Frederic Delacroix, FREEWARE
% <Frederic.Delacroix@univ-valenciennes.fr>
