                           Documentation de

                                 CAB

                             Version 1.0a
                              12.12.1995

                                 par

                           Alexander Clauss
                         Stresemannstrae 44
                          D-64297 Darmstadt

                aclauss@rbg.informatik.th-darmstadt.de


                    Traduction de Romuald Jouffrey



Table des matires
==================

 1 Une courte introduction

 2 Aspect Lgal

 3 Adresses

 4 Matriel requis

 5 Installation

 6 Navigation parmi les documents HTML

 7 Module pour l'accs direct  Internet

 8 Description des options des menus
   8.1 Ouvrir une URL...
   8.2 Ouvrir un fichier local...
   8.3 Recharger
   8.4 Nouvelle fentre
   8.5 Fermer fentre
   8.6 Voir le source
   8.7 Quitter
   8.8 Page d'accueil
   8.9 Retour
   8.10 Trouver un mot
   8.11 Liste utilisateur (BookMarks en anglais)
   8.12 Document -> Liste
   8.13 Options Gnral
   8.14 Affichage
   8.15 Slection des fontes
   8.16 Visualiseurs externes
   8.17 Chemins...
   8.18 Cache
   8.19 Sauver les options

 9 Barre de bouttons

10 Remerciements

11 Amliorations futures possibles

12 Historique



1 Une courte introduction
=========================

*CAB* - Le Taxi pour les autoroutes de l'information!
*CAB* - Crystal Atari Browser

Nomm prcdemment HTML-Browser

Ce browser est capable de lire les documents au format HTML. Les
documents HTML peuvent tre sur disque ou sur un CD. Pour lire des
pages du rseau Internet, World Wide Web (WWW), il faut un module
spar.



2 Aspect Lgal
==============

CAB (HTML-Browser) est un FREEWARE. Il peut tre copi et utilis
gratuitement. La distribution par un BBS ou une bibliothque de
domaines publiques est autorise. Cependant; CAB (HTML-Browser) NE
doit sous aucune circonstances tre plac sur un CD-ROM ou sur une
disquette de magazine sans mon autorisation crite pralable. CAB
(HTML-Browser) et sa documentation doivent toujours rester ensemble
et l'ensemble des fichiers doivent tre prsents dans la
distribution. Les modifications tant au programme qu' sa
documentation sont interdites.

Si vous aimez CAB et que vous l'utiliser rgulirement, enregistrez
votre copie s'il vous plat. Toutes les devises sont acceptes.

Un coup d'oeil au numro de version vous apprendra que le programme
est encore en phase de dveloppement. Aussi si vous souhaitez que ce
programme continue  tre amlior, dites le et enregistrez vous. Les
utilisateurs Franais, du Royaume-Uni et des tats-unis peuvent
contacter les antennes ou supports locaux. Voyer SUPPORT.TXT pour
plus de dtails. Aucune participation de chacun conduira  l'arrt
des dveloppements ultrieurs, c'est aussi simple que cela !



3 Adresses
==========

*Mon adresse:*

    Alexander Clauss
    Stresemannstr. 44
    D-64297 Darmstadt
    Allemagne

    email: aclauss@rbg.informatik.th-darmstadt.de
    WWW: http://www.student.informatik.th-darmstadt.de/~aclauss/

*Coordonnes bancaires:*

    Sparkasse Darmstadt
    BLZ: 508 501 50
    Kontonr: 0115032143

*Contact au Royaume Uni:*

    Joe Connor
    65 Mill Road
    Colchester
    CO4 5LJ
    England

    email: jconnor@cix.compulink.co.uk

*Contact au USA, Canada:*

    Jeff Wisniewski
    P.O. Box 1243
    Newtown, PA 18940-0871

    email: jeffrey.wisniewski@microserve.com

*Contact France:*

    Jouffrey Romuald
    1 chemin de l'glise
    38100 GRENOBLE

    email: rom38@gen4.pressimage.fr

Traduction : Jouffrey Romuald



4 Matriel requis
=================

Le programme fonctionne sur n'importe quel ordinateur utilisant le
systme d'exploitation TOS (Atari)), avec au moins 1 Mo de mmoire.
La mmoire requise pour les images dpend du nombre de couleurs. Plus
le nombre de couleurs est grand et plus il faudra de mmoire.
L'utilisation d'une carte graphique dite "True colour" (24 or 32 bit)
ncessite beaucoup de mmoire et il vous faudra trs certainement
beaucoup plus de mmoire.

CAB fonctionne dans toutes les rsolutions avec deux limitations :
Dans le mode 320x200 (ST-Basse), tous les dialogues ne tiennent pas
entirement dans l'cran. En 640x200 (ST-Moyenne) l'affichage sera
tir en hauteur (moiti de l'cran). Aussi il est recommand
d'utiliser CAB dans des rsolutions d'au moins 640x400 (ST-haute).
Quelquesoit le nombre de couleurs, un environnement multitche (par
exemple MagiC, Geneva etc) est souhaitable.

Bien que leurs usage ne soit pas absolument ncessaire, les fontes
vectorielles permises par NVDI v3.x ou SpeedoGDOS est recommand. Le
systme de fontes bitmap ou les fontes GDOS peuvent toutefois tre
utilises, si besoin est.



5 Installation
==============

*Attention:*

    Depuis la version v1.0, le programme ne peut plus tre install
    comme un accessoire de bureau.

    Les fichiers de configuration des versions antrieures de CAB
    (CAB.INF) ne peuvent pas tre utilises. Vous devrez
    malheureusement effectuer  nouveau les rglages.

    Le format du fichier Liste utilisateur a galement t modifi
    mais tant que le nouveau format n'a pas t gnr, l'ancien
    format (CAB.HOT) reste valable et est charg. Le nouveau fichier
    o est sauvegard la liste utilisateur s'appelle hotlist.html.
    Ds lors que la liste utilisateur a t sauvegarde sous son
    nouveau format. L'ancien fichier (CAB.HOT) peut tre effacer sans
    risque.

Les fichiers HTML rcuprs sur les sites WWW contiennent souvent des
longs noms de fichier qui conduisent frquemment  la cration de
doublons lorsque l'on utilise le systme de fichier du TOS (8+3). Il
est donc conseill d'install une partition Minix ou un autre systme
de fichier qui pourra grer les fichiers HTML  long nom de fichier.

La distribution de CAB est livre prte  l'emploi une fois
dcompacte sur votre disque de travail. Pour profiter pleinement des
avantages que procure CAB (HTML-Browser), il est tout de mme
conseill d'effectuer quelques rglages afin d'tre conforme  vos
besoins.



6 Navigation parmi les documents HTML
=====================================

Cliquez sur n'importe quel mot soulign pour accder  la nouvelle
page. Appuyer sur la touche [Undo] pour retourner  la page
prcdente. En cliquant avec le bouton droit de la souris sur lien,
il apparat l'adresse de la page lie.



7 Module pour l'accs direct  Internet
=======================================

Pour accder directement  des pages WEB sur Internet, un module
supplmentaire (CAB.OVL) est ncessaire. Ce module doit tre plac
dans le mme rpertoire que le programme CAB.APP. Ce fichier contient
les routines additionnelles ncessaires pour l'accs  Internet.

Sur les partitions Minix, le flag x du fichier CAB.OVL doit tre
"mis" sinon le module ne pourra pas tre dmarrer.

L'auteur n'a pas la possibilit de tester le module Internet mais a
programm une interface intressante dans CAB (HTML-Browser) pour
permettre  quiconque capable de programmer ces routines de crer de
nouveau modules. La description de cette interface est disponible sur
demande en C comment ou en source Pascal. Je souhaite avoir des
remarques de ceux qui dsirent programmer un module en ligne (on-
line), pour permettre sa diffusion avec CAB (HTML-Browser)...



8 Description des options des menus
===================================


8.1 Ouvrir une URL...
---------------------

L'option *ouvrir une URL* du menu *Fichier* affiche une bote de dialogue
qui affiche l'URL (de l'anglais Universal Resource Locator), c'est--
dire l'addresse que vous avez saisie pour accder au WWW.


8.2 Ouvrir un fichier local...
------------------------------

L'option *Ouvrir un fichier local...* du menu *Fichier* appelle le
slecteur de fichier qui permet d'ouvrir n'importe quel document HTML
du disque dur ou d'un CD-ROM.

N'importe quel type de fichier peut tre utiliser ! Les fichiers de
types HTML, XBM et GIF sont normalement affichs par CAB (HTML-
Browser). Les autres types de fichier sont pris en charge par des
programmes de visualisation externes. Voyez *Visualiseurs externes*
pour plus de dtails.

Si un rpertoire est slectionn, le contenu de ce rpertoire est
alors affich et ses sous-rpertoires sont affichs graphiquement
dans une page HTML; les rpertoires et fichiers peuvent alors tre
slectionns  la souris !


8.3 Recharger
-------------

Charge  nouveau la page HTML courante. Cette fonction est utile
(dans un environnement multitche) pour l'dition grce  un diteur
des pages HTML CAB tournant en parallle pour afficher les pages.

Si la page est d'origine rseau, c'est--dire qu'elle  t charge
sur un serveur WEB via Stick, l'utilisation de la fonction *Recharger*
conduit  un nouveau rapatriement de cette page depuis le serveur
WEB; mme si une copie de cette page est dj disponible dans le
cache.


8.4 Nouvelle fentre
--------------------

Ouvre une nouvelle fentre qui affiche le contenu de la page
prcdente du document en cours.


8.5 Fermer fentre
------------------

Ferme la fentre active.


8.6 Voir le source
------------------

Affiche le texte source du document HTML affich. Voir galement
l'option *Visualiseurs externes*.


8.7 Quitter
-----------

Sort du programme.


8.8 Page d'accueil
------------------

Cette option du menu affiche la page d'accueil, si elle est
disponible.

CAB essaye de charger ds le dpart la page d'accueil. N'importe qui
connaissant la syntaxe HTML peut aisment dfinir une page d'accueil
et crer une page qui rferencera d'autres documents HTML. Le fichier
utilis comme page d'accueil peut tre dfini dans la bote de
dialogue *Gnral* du menu options.


8.9 Retour
----------

Affiche le document prcdent.


8.10 Trouver un mot
-------------------

Cette fonction permet  l'utilisateur de rechercher un mot dans un
fichier HTML, elle peut ou non tre sensible aux caractres
minuscules et majuscules. La recherche peut tre effectue dans :

  1. Le document courant et seulement lui. La chane dsigne est
     recherche dans le document de la fentre active courante. Si la
     chane est trouve, le document est affich de faon  ce que
     l'on voit celle-ci au sommet de la fentre.

  2. les documents HTML locaux. La chane est recherche parmi tous
     les document HTML des chemins spcifis dans la bote de
     dialogue *Chemins*, ainsi que dans leurs sous-rpertoires. Le
     fichier contenant le rsultat de la recherche et nomm
     result.html, il et est compos de la liste des liens
     correspondants.

     Pour l'instant, la recherche de type 2 est effectu sur le texte
     seulement. Aussi le texte cach comme les commentaires, les
     commandes HTML et les liens ne sont pas recherchs. Permettre
     cette recherche serait trs couteux en temps. Ceci signifie
     galement que les caractres spciaux comme les accents qui sont
     cods en HTML par des commandes du type &auml; ne seront
     galement pas retrouvs. Cette limitation sera traite dans une
     version future.

     Un autre truc : Si vous recherchez quelque chose qui est souvent
     utilis dans le code HTML comme une commande ou une adresse URL,
     prfix la chaine recherche par un espace, ceci aura pour effet
     d'viter de trouver une commande ou une adresse URL.

     Par exemple : La recherche du texte 'WWW' trouve les rpertoires
     et les adresses de pages de la forme '.../WWW/foo.html...'. En
     placant un espace avant, ' WWW' supprimera les occurences
     conduisant  un meilleur rsultat de la recherche. Ceci ne
     s'applique pas aux mthodes de recherche 1 et 3.

  3. La base de donnes du c't-CDROM. Cette option n'est valable que
     pour les gens qui possde le c't-CDROM (the 1994 (or 92/93) de
     c't magazines au format HTML)

     Dans ce cas, les fichiers HTML eux-mmes sont parcourues pour la
     recherche mais le fichier d'index est ouvert  la place. Pour
     que HTML-Browser sache o sont placs les fichiers pour ce CD,
     vous devez dfinir le bon chemin dans la zone texte approprie
     de la bote de dialogue du menu *Chemins* - Les documents HTML
     (sous \HTML et ceux galement contenus dans le fichier
     DEFAULT.HTML), ainsi que l'index de la base de donnes
     (\UNIX\CT94.DAT ou \UNIX\CT9293.DAT). Au mme titre que la
     mthode prcdente, les documents qui contiennent la chane
     recherche sont compils dans un document HTML nomm
     results.html, qui sera ouvert automatiquement par la suite.


8.11 Liste utilisateur (BookMarks en anglais)
---------------------------------------------

La liste utilisateur est une liste des pages (documents HTML) que
vous utiliser le plus. Cette liste vous permet d'accder rapidement 
vos pages favorites, sans avoir  nouveau  "surfer"  travers une
longue srie de pages pour l'atteindre.

La liste utilisateur est organise par thme. En utilisant le menu
popup situ au sommet de la bote de dialogue, il est facile de
passer d'un thme  l'autre.

*Le popup 'Thme...':*

 *Changer thme:* Modifie le nom du thme courant. Le thme
    /Miscellaneous/ ne peut tre renomm.

 *Nouveau thme:* Crer un nouveau thme.

 *Effacer thme:* Efface le thme courant. Le thme /Miscellaneous/ ne
    peut pas tre effac. Tous les autres thmes peuvent tre
    effacer, les adresses correspondant  ce thme sont alors
    automatiquement dplaces dans le thme /Miscellaneous/.

*Le popup 'Dplacer thme...':*

    Cette option permet de dplacer une entre dans un autre thme.

*Le popup 'Document...':*

 *Effacer entre:* Efface l'entre slectionne.

 *Modifier entre:* Modifie l'entre slectionne Une note concernant
    la page peut galement tre ajoute.

 *Ouvre un document:* Ouvre un document.

 *Ajoute doc:* Copie le document courant  la liste utilisateur.

Un double clique sur une entre ouvre le document correspondant.

La liste utilisateur est sauvegarde sur le disque en tant qu'un
simple document HTML ce qui permet de proposer une manire simple 
quiconque de crer sa propre page.


8.12 Document -> Liste
----------------------

Le document courant est insr dans la liste utilisateur pour peu
qu'il n'y figure pas dj. Il est ajout dans le thme /Miscellaneous/.


8.13 Options Gnral
--------------------

 *Page d'accueil:* Aprs le dmarrage de CAB ou en slectionnant
    l'entre *Page d'accueil* du menu gnral, la page HTML spcifie
    sera affiche. Il est souvent utile de crer une page d'accueil
    contenant les rfrences aux pages visites frquemment. Par
    dfaut, CAB essaye de charger la page home.html comme document
    initial mme si aucune page n'a t dfinie dans le menu *gnral*.
    Saisissez simplement l'adresse URL de la page dsir. Si le
    fichier prcis n'existe pas dans le rpertoire de CAB, vous
    pouvez choisir le *rpertoire de dmarrage* ou utiliser le boutton
    de *recherche* pour dsigner le fichier voulu en utilisant le
    slecteur de fichier.

 *Popup menus:* CAB propose une barre de boutton qui rsume les
    principales fonctionnalits de navigation  travers les documents
    HTML.

    Utilisation de la souris

       Clique gauche sur une rfrence pour accder  la page
        dsign.

       Clique droit sur une rfrence pour afficher la rfrence
        URL.

       Clique sur le fond (pas sur une rfrence) pour afficher le
        menu complmentaire.

    Vous pouvez dfinir quel menu sera afficher par les clique droit
    et gauche de la souris (en tenant ou non appuy la touche
    [Shift]). Les menus suivants sont disponibles :

     *Historique:* Liste les documents prcdemment affichs.

     *Rfrences:* Liste les rfrences du document courant.

     *Menu:* Liste certains items des menus.

 *Divers:* Durant le chargement, le formatage et le transfert de
    donnes depuis Internet, CAB affiche une srie de messages dans
    une fentre de dialogue (Si l'option *Dialogue* est active) sinon
    la fentre dnformation on-line est utilis. L'affichage dans la
    fentre d'info  quelques dsavantages. Premirement, une fentre
    peut ne pas pouvoir tre ouverte pour afficher l'information et
    deuximement, la fentre de dialogue affiche les informations de
    manire plus complte. d'un autre cot, l'utilisation de la
    fentre d'info permet que le document de la fentre puisse tre
    lu et dplac alors que le texte est toujours en train d'tre
    formatt.

    Le choix *Charge index.html* n'a d'effet que sur les rfrences
    locales (c-a-d aux fichiers/rpertoires de votre disque). Si la
    rfnrece pointe sur un rpertoire du disque, le contenu sera
    afficher  moins qu'un fichier nomm index.html existe, auquel
    cas il sera charg  sa place. Un des usages des pages index.html
    est de dfinir un index de tous vos documents favoris.


8.14 Affichage
--------------

Dans ce dialogue, vous pouvez configurer diverses options pour les
documents HTML.

 *Couleurs:* Cette section vous permet de configurer les couleurs
    d'ffichage, du fond du texte, la couleur de fond et la couleur
    des liens. Si vous avez moind de 16 couleurs, le fond sera
    toujours blanc quelquesoit les rglages effectus. En mode 16
    couleurs, seules les premires 9 couleurs peuvent tre utilises
    car les 7 dernires peuvent tre modifies par CAB pour
    l'affichage des images. Dans les modes de plus de 16 couleurs,
    toutes les 16 peuvent tre modifier et elle ne seront pas
    modifies par CAB.

    Certains documents HTML contiennent des informations sur la
    couleur de du texte, des rfrences et le fond d'cran. L'option
    *Utilise guidelines in document* dit  CAB d'utiliser cette
    information (Si elle est disponible).

 *Liens:* Les Liens peuvent tre afficher en soulign et/ou en gras
    (Ceci est important pour les crans monochromes qui ne pourraient
    permettre la distinction entre le texte normal et les liens par
    la couleur).

 *Images:* Controle l'affichage des images.

     *Ne pas voir* empche le chargement des images et leur affichage,
        ce qui acclre le chargement des pages.

     *Monochrome* Les images sont affiches en monochrome par la
        mthode du "dithering". C'est la mthode la plus rapide mais
        bien videmment la qualit en souffre.

     *Niveaux de gris* Les images sont affiches en niveaux de gris.
        Meilleur qualit se paie par une vitesse d'affichage plus
        faible.

     *Couleur* Les images sont affiches en couleur selon le mode vido
        courant :

          4-8 plans (16-256 couleurs). Les images sont "ditheres"
           si le nombre de couleurs disponibles est infrieur  celui
           de l'image. En mode 16 couleurs, le mode niveau de gris
           est gnralement souhaitable.

          15/16 bit Highcolor (32768/65536 couleurs) Par exemple le
           mode Truecolor du Falcon

          24 or 32 bit Truecolor (16.7 million de couleurs)

     *Texte  la place des images* Le language HTML peut tre dcripter
        par des systmes fonctionnant en mode texte seul, les images
        sont alors acompagnes d'un texte qui remplacera l'image 
        l'cran. Ceci permet aux Browsers WEB qui ne peuvent afficher
        les images d'afficher un texte alternatif. Si cette option
        est active, seules les images qui n'ont pas de texte
        alternatif sont affiches en tant qu'images.

 *Largeur de Texte:* Le texte peut soit tre formatt sur une largeur
    fixe, soit de manire  remplir la largeur de la fentre. Les
    textes justifis pour remplir la fentre sont plus jolis mais
    sont plus longs  tre affichs car le texte doit tre
    reformatt.


8.15 Slection des fontes
-------------------------

Bien que CAB soit capable d'utiliser des fontes de tailles fixes pour
l'affichage du texte, le meilleur rendu sera obtenu en utilisant soit
NVDI v3.x, soit SpeedoGDOS. Les fontes bitmap normales peuvent
nanmoins tre utilises.

Il vous faudra par la suite indiquer  CAB (HTML-Browser) quelles
fontes (GDOS) utiliser pour chacun des styles des documents HTML. Les
fontes vectorielles fournies avec SpeedoGDOS ou NVDI 3.x sont
recommandes. Vous devez prcisez trois fontes (sans-serif, serif et
monospaced) dans quatres styles (normal, gras, italique et gras et
italique), ce qui fait 12 slections au total.

Pour le rglage du gras et de l'italique, vous devez utiliser une
'vraie' fonte de type gras ou italique si c'est possible. Si vous ne
possder pas de telles fontes, ces effets seront simules, ils vous
faut alors activer le bouton adjacent correspondant au popup de la
fonte concerne. Si vous utilisez des fontes vectorielles, utiliser
alors une fonte proportionnelle de la mme famille, si disponible.

Le fichier INF possde les prrglages suivants (pour NVDI 3.x):

 *Ttes de chapitres:* Swiss 721 (normal, gras, italique,
    gras+italique)

 *Texte Normal:* Dutch 801 (normal, gras, italique, gras+italique)

 *formatt:* Letter Gothic 12 Pitch (normal, gras, italique,
    gras+italique)

Si vous n'aimez pas ces fontes ou si vous ne les avez pas, vous
devrez en dfinir d'autres.

La taille du corps du texte peut galement tre modifie. N'en
dfinissez pas une trop grande ou trop petite ! Entre 10 et 13 points
est correcte (J'utilise 12 points).

Si vous n'avez pas accs  des fontes vectorielles (c.a.d que vous ne
possder pas ni NVDI 3.x, ni SpeedoGDOS), alors la taille des fontes
ne sera pas modifier, mais le texte pourra toujours tre visualis
avec les fontes systmes, gnralement en taille 10 points.


8.16 Visualiseurs externes
--------------------------

Si un lien dans un document HTML pointe vers un fichier qui n'est pas
au format HTML, un visualiseur externe peut tre invoqu. Ces
programmes peuvent tre appels de deux manire diffrentes et ils
sont dfinis dans le dialogue *visualiseurs externes...* du menu
*Options*.

Des types de fichier individuels peuvent tre affects  diffrents
programmes. L'extension de fichier doit tre saisie dans le champ
*Fichiers*. Plusieurs extensions peuvent tre entres, en utilisant la
virgule comme sparateur.

Les programmes sont slectionnes en cliquant sur le boutton
slection situ  droite du champ *Fichiers* qui appelle le selecteur
de fichier pour dsigne le visualiseur dsir.

Enfin chaque entre comporte une bote  cocher *Supports VA_START* qui
doit tre active si le visualiseur slectionn est conforme au
protocole VA_START, ainsi CAB pourra envoy un paramtre en VA_START
au visualiseur pour que le fichier puisse tre directement ouvert.

Le programme *Dfaut* (*.*) est appel pour l'affichage de n'importe
quel fichier pour lequel aucun programmes n'a t assign.

Si une ou plus extensions a t dfinie sans qu'un programme ne soit
dfini, CAB essaiera dfficher le fichier. Ceci ne sera possible que
pour les fichiers de type *.gif, *.xbm, *.htm et ASCII (Par exemple:
*.txt, *.doc, *.c, *.pas, *.tex etc...) pour lesquels CAB (HTML-
Browser) possde des routines d'affichage en interne. L'usage de CAB
(HTML-Browser) avec ces fichiers permet de rduire au maximum le
nombre de visualiseurs externes ncessaires.

La page HTML courante peut tre affiche sou la forme de son texte
source en slectionnant une application dans le champ *Source*. Cette
application est appel par l'entre *Voir source...* du menu. Si aucune
application n'a t assigne, le programme par *Dfaut* sera appel.

En double cliquant sur le bouton *Chemin*, un dialogue apparat
permettant d'effacer le chemin courant.

Quelques programmes de visualisations conseills :

 *.text,txt:     ST-Guide, 1st-Guide (ou aucun, CAB.APP sera utilis)

 *.mpeg,mpg,mpe: 1st-Guide (sur un Falcon sous TOS, DSP MPEG est
                 recomnand)

 *.jpeg,jpg,jpe: 1st-Guide, GEMview

 *.tiff,tif:     GEMview, Imagecopy

 *.gif,xbm:      GEMview, Imagecopy (ou aucun, CAB.APP sera utilis)

 *.dvi:          Affichage DVI inclus dan le package TeX

 *.* (Dfaut):   GEMview (ou tout autre programme qui peut prendre en
                 charge le plus de formats possibles)

 *.html,htm:     ST-Guide, 1st-Guide, (ou un diteur pour permettre
                 l'dition du source)


8.17 Chemins...
---------------

Si vous possdez un CDROM c't ROM '94 (or 92/93) (CD compilant le
contenu du magazine allemand c't), alors dfinissez le chemin dans le
champ c't CDROM.

Dans le champ *Rpertoire HTML*, saisissez le rpertoire qui contient
le fichier DEFAULT.HTM sur le CD (eg ?:\HTML\, o ? est remplac par
la lettre de votre lecteur CD). Dans le champ *Base de donnes*,
saisissez le chemin du contenu du CD (?:\UNIX\CT94.DAT) (ou
?:\UNIX\CT9293.DAT).

Si vous dsirez utiliser CAB en on-line sur un site Internet, vous
devez dfinir le rpertoire le *Rpertoire Cache* o tous les fichiers
chargs seront sauvegards. Ce rpertoire devrait idalement se
trouver sur une partiton Minix, ou un systme de fichier qui prend en
compte les longs noms de fichiers. En effet, l'utilisation d'un
classique systme de fichier systme TOS 8+3 conduit souvent  la
duplication de noms. assurez vous que ce rpertoire est dans une
partition possdant beaucoup d'espace libre !

Dans les champs *Rpertoires HTML*, vous pouvez entrer les chemins o
CAB (HTML-Browser) cherchera les fichiers HTML.

Les fichiers HTML contiennent les chemins absolus (ex
/path/file.html) qui peuvent conduirent au chaos dans votre
rpertoire racine. Le rpertoire HTML permet d'viter ceci en
dfinissant pour CAB un dossier spcifique.

Un exemple:

 *Rpertoire HTML saisies:*

       F:\HTML.DOC\

       G:\VARIOUS\

 *Partition courante:* F:\

 *Chemin dans le fichier HTML:*

       /example/text/index.html

 *CAB cherche dans:*

      1. F:\example\text\index.html

      2. F:\HTML.DOC\example\text\index.html

      3. G:\VARIOUS\example\text\index.html

En double cliquant sur le bouton *chemin des programmes*, il est alors
possible d'effacer le chemin.


8.18 Cache
----------

CAB (HTML-Browser) utilise deux caches pour optimiser l'affichage.

Le *Cache Image* est utilis pour viter les dcompactages et dithering
rpt des images, qui prennent tout deux beaucoup de temps. Les
images qui ne sont plus affiches sont maintenues en mmoire (RAM) au
cas o on ait encore besoin de les afficher. Naturellement, ceci
demande de la mmoire, aussi cette taille peut tre dfinie dans le
champ *Taille maximum*. Si le cache est plein, le minimum des images
est effacer du cache pour librer de l'espace. L'usage de l'option
*Garder libre* permet de rgler la taille minimum de mmoire qui doit
tre prserve pour les autres applications. Le cache peut galement
tre effacer manuellement en utilisant le bouton *Vider cache* qui peut
tre utile pour librer rapidement de la mmoire pour d'autres
applications dans un environnement multitche. Le cache reste vide
jusqu' ce qu'une image soit de nouveau afficher par CAB (HTML-
Browser).

*Attention*

La quantit de memoire utilis par le cache peut tre sensiblement
plus leve que celle dfinie dans le dialogue.s. Ceci arrive lorsque
une image occupe plus de place que la taille de son fichier.

Le *Cache Internet* est utilis pour stocker les fichiers chargs 
partir Internet pour viter les chargements rpts inutiles d'un
mme fichier. Voyez galement *Chemins*.

Les options *Taille maximum* et *Garder libre* limitent la quantit
d'espace disque utilis par le cache et CAB (HTML-Browser) effacera
les fichiers les plus anciens du cache afin de maintenir la taille du
cache dans ces limites.

Si l'option *Effacer en 'quittant'* est active, les fichiers du cache
seront effacer  la sortie de CAB (HTML-Browser). Naturellement, 
moins que l'espace disque soit limit ou que vous soyez sr de ne pas
avoir  nouveau besoin de ces fichiers, il est prfrable de
conserver ces fichiers.

Le bouton *Vider cache* est  utiliser en cas d'urgence si vous
souhaitez recouvrir de l'espace disque rapidement ! Seuls les
fichiers placs dans me rpertoire de cache seront effacs.


8.19 Sauver les options
-----------------------

Sauve les options courantes



9 Barre de bouttons
===================

Chaque fentre de CAB contient une barre de boutons qui permet de un
accs facile  des fonctions importantes:

 *Retour* Affiche la page prcedente

 *Home* Affiche la page d'accueil

 *URL* Slectionne un document par son adresse URL

 *Fichier* Slectionne un fichier avec le slectur de fichier

 *Source* Affiche le texte source du document courant

 *Recharge* Recharge  nouveau le document courant

 *Liste* Affiche le dialogue Liste utilisateur

Si un 'smiley' triste apparat sur la droite de la barre de de
boutons, cela signifie que le document contient une erreur. Cliquer
sur le smiley pour obtenir plus dnformation. Ceci est
particulirement utile  tous ceux qui utiliseront CAB pour crer ou
diter des pages HTML. Seules les erreurs que CAB saura dterminer
sans perte d'espace disque ou de temps seront traites.

Les documents incorrectes ne seront pas forcment mal affichs par
CAB mais conduirait  des problmes d'affichage dans d'autres
browsers (ex: Mosaic, Netscape, WebExplorer etc) n'afficheraient pas
le document comme vous vous y attendriez.



10 Remerciements
================

Je souhaite remercier tout ceux qui,  travers leurs demandes,
critiques, suggestions et dcouvertes de bogues m'ont aid dans le
dveloppement de CAB, les personnes cites ci-dessous mritent une
mention toute particulire :

    Stefan Becker

    Ben Bell

    Stephane Boisson

    Joe Connor

    Dieter Fiebelkorn

    Stefan Haake

    Romuald Jouffrey

    Ulrich Kaiser

    Tim Newsome

    Fred Nicklisch

    Jeff Wisniewski

    Manfred Ssykor



11 Amliorations futures possibles
==================================

    Plus grande compatibilit avec les commandes HTML3

    Option d'impression des pages

    Chargement des images (Par double-clic sur le texte [IMG])

    Option permettant de sauvegarder le contenu du cache (ou partie)
     avec les noms originaux.

Sl vous plait, ne vous gnez pas pour apporter des suggestions et
des critiques constructives ...



12 Historique
=============

 *V0.8 (20.04.1995)*

       Premire version

 *V0.9 (15.05.1995)*

       Rduction de la quantit de mmoire requise

       Compatibilit avec le Drag&Drop de MTOS(ARGS)

       Les programmesmes externes fonctionnenet maintenant sous TOS
        seul.

       La description des erreur est plus explicite

       Bugfix: when running as an accessory no longer tries to
        invert (non-existant) menu items

       The .INF file is now found even if HTML is not started in it
        own directory

       Is now a lot more tolerant of buggy HTML file syntax.

       home.html is now loaded on startup if possible

       Hotlist

       Configuration of window and text colours etc.

       Search (including searching c't CDROM)

       In-line images can be displayed as greyscales

 *V0.93 (07.06.1995)*

       Preparation for on-line operation implemented (although not
        activated in this version)

       Bugfix: Problem with line spacing fixed

       Bugfix: Endless loop with defective gifs fixed

       Bugfix: fclose() for Hotlist was forgotton :-(

       A few other minor bugfixes

 *V0.94 (07.07.1995)*

       Bugfix: Deleting the last Hotlist entry caused a crash :-(

       Bugfix: CR/LF inside tags led to problems

       Bugfix: Last word in an HTML file gobbled

       Documents access using absolute path information, including
        directories listed in the 'Paths...' dialog

       Contents of a drive can be displayed as an HTML document
        (including launching programs and viewing files)!

       Support for the special Netscape <CENTER> tags

 *V0.95 (04.08.1995)*

       Inline colour images

       Configurable image cache (in RAM)

       Configurable WWW cache (on disk)

       Option to automatically format text to the window width

       ASCII, xbm and gif files can now be viewed directly in HTML-
        Browser. Calling external programs is no longer required (but
        naturally still available as an option)

       Interface for 'Internet module' implemented Using a suitable
        module HTML-Browser could be used to display WWW pages on-
        line to the Internet, naturally you'd need an Internet
        account to do this!

       Support for xbm images

 *V0.96 (22.08.1995)*

       Lots of minor bugfixes

 *V0.98 (03.10.1995)*

       In colour resolutions with fewer than 16 colours the colour
        palette is no longer altered

       Zero length files should no longer cause problems

       The program is now called:
        CAB - The Taxi to the information highway!
        CAB = Crystal Atari Browser

 *V1.0 (01.11.1995)*

       Minor adjustments to accomodate the 3D look under Geneva
        release 4 (unfortunately Geneva is not entirely MultiTOS
        compatible)

       Multiple open windows may be opened

       Each window may individually configured with its own colour
        and font

       Support for the following Netscape tags (commands):

         - <FONT SIZE=[+|-]n> </FONT>

         - <BASEFONT SIZE=n>

         - <CENTER> </CENTER>

         - <NOBR> </NOBR>

         - <BODY BACKGROUND=url BGCOLOR=#rrggbb TEXT=#rrggbb
           LINK=#rrggbb>

       Support for the <FORM>-area (forms)

       Tables (<TABLE>...</TABLE>) are supported.

       The Hotlist dialog has been extended to accomodate themes.
        Each entry can be optionally be annotated

       Cache management has been changed. Files are no longer saved
        in the cache using their original names which should avoid
        problems long filenames may have caused on standard TOS 8+3
        character file systems

       History popup implemented

       Popup showing all links in a page

       <IMG ...> with the attribute ALIGN=LEFT or ALIGN=RIGHT now
        functions correctly.

       Font sizes in the <Hn> </Hn>-areas changed (in line with the
        method used by Netscape and Mosaic)

       Search now works correctly with the 92/93 c't ROM database

       New: Button bar in the window provides convienient access to
        most important functions.
        If a 'sad' smiley appears to the right of the button bar the
        displayed document does not conform to HTML specification.
        CAB will nevertheless try to display the document which may
        well look fine. On the other hand a 'happy' smiley does not
        indicate a perfect document because CAB does not waste
        resources analysing documents in-depth.

       Right aligned format (ALIGN=RIGHT) is now supported.

       Numerous minor bugfixes ;-)

 *V1.0a (12.12.1995)*

       Bugfix: Where available the transparent colour of background
        images is evaluated.

       Bugfix: In larger than 32Kb HTML files where tables are
        included after the first 32Kb garbage (maybe even crashes)
        was likely.

       The cursor keys can be used to scroll the window. If a form
        is depicted and the cursor is postioned in an input field the
        cursor keys can be used to navigate the form.

       Bugfix: Inside <PLAINTEXT> empty lines are no longer ignored.

       Bugfix: Under old TOS versions hard drive directories were
        not correctly evaluated.

       Bugfix: Under old TOS versions there were sometimes problems
        if a window title was set straight after opening a window.



