Documentation de

                                 CAB

                             Version 1.1
                              16.01.1996

                                 par

                           Alexander Clauss
                         Stresemannstraže 44
                          D-64297 Darmstadt

                aclauss@rbg.informatik.th-darmstadt.de



Table des matiŠres
==================

 1 Une courte introduction

 2 Aspect L‚gal

 3 Adresses

 4 Mat‚riel requis

 5 Installation

 6 Navigation parmi les documents HTML

 7 Module pour l'accŠs 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 fenˆtre
   8.5 Fermer fenˆtre
   8.6 Voir le source
   8.7 Impression
   8.8 Quitter
   8.9 Page d'accueil
   8.10 Retour
   8.11 Trouver un mot
   8.12 Liste utilisateur (BookMarks en anglais)
   8.13 Document -> Liste
   8.14 Options G‚n‚ral
   8.15 Affichage
   8.16 S‚lection des fontes
   8.17 Visualiseurs externes
   8.18 Chemins...
   8.19 Cache
   8.20 Sauver les options

 9 Barre de bouttons

10 Remerciements

11 Am‚liorations futures possibles

12 Historique



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

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

Nomm‚ pr‚c‚demment 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 r‚seau Internet, World Wide Web (WWW), il faut un module
s‚par‚.



2 Aspect L‚gal
==============

CAB (HTML-Browser) est un FREEWARE. Il peut ˆtre copi‚ et utilis‚
gratuitement. La distribution par un BBS ou une bibliothŠque de
domaines publiques est autoris‚e. 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 pr‚alable. CAB
(HTML-Browser) et sa documentation doivent toujours rester ensemble
et l'ensemble des fichiers doivent ˆtre pr‚sents dans la
distribution. Les modifications tant au programme qu'… sa
documentation sont interdites.

Si vous aimez CAB et que vous l'utiliser r‚guliŠrement, enregistrez
votre copie s'il vous plaŒt. Toutes les devises sont accept‚es.

Un coup d'oeil au num‚ro de version vous apprendra que le programme
est encore en phase de d‚veloppement. Aussi si vous souhaitez que ce
programme continue … ˆtre am‚lior‚, dites le et enregistrez vous. Les
utilisateurs Fran‡ais, du Royaume-Uni et des ‚tats-unis peuvent
contacter les antennes ou supports locaux. Voyer SUPPORT.TXT pour
plus de d‚tails. Aucune participation de chacun conduira … l'arrˆt
des d‚veloppements ult‚rieurs, 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/

*Coordonn‚es 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 Mat‚riel requis
=================

Le programme fonctionne sur n'importe quel ordinateur utilisant le
systŠme d'exploitation TOS (Atari)), avec au moins 1 Mo de m‚moire.
La m‚moire requise pour les images d‚pend du nombre de couleurs. Plus
le nombre de couleurs est grand et plus il faudra de m‚moire.
L'utilisation d'une carte graphique dite "True colour" (24 or 32 bit)
n‚cessite beaucoup de m‚moire et il vous faudra trŠs certainement
beaucoup plus de m‚moire.

CAB fonctionne dans toutes les r‚solutions avec deux limitations :
Dans le mode 320x200 (ST-Basse), tous les dialogues ne tiennent pas
entiŠrement 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 r‚solutions d'au moins 640x400 (ST-haute).
Quelquesoit le nombre de couleurs, un environnement multitƒche (par
exemple MagiC, Geneva etc) est souhaitable.

Bien que leurs usage ne soit pas absolument n‚cessaire, les fontes
vectorielles permises par NVDI v3.x ou SpeedoGDOS est recommand‚. Le
systŠme de fontes bitmap ou les fontes GDOS peuvent toutefois ˆtre
utilis‚es, 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 ant‚rieures de CAB
    (CAB.INF) ne peuvent pas ˆtre utilis‚es. Vous devrez
    malheureusement effectuer … nouveau les r‚glages.

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

Les fichiers HTML r‚cup‚r‚s sur les sites WWW contiennent souvent des
longs noms de fichier qui conduisent fr‚quemment … la cr‚ation de
doublons lorsque l'on utilise le systŠme de fichier du TOS (8+3). Il
est donc conseill‚ d'install‚ une partition Minix ou un autre systŠme
de fichier qui pourra g‚rer les fichiers HTML … long nom de fichier.

La distribution de CAB est livr‚e prˆte … l'emploi une fois
d‚compact‚e sur votre disque de travail. Pour profiter pleinement des
avantages que procure CAB (HTML-Browser), il est tout de mˆme
conseill‚ d'effectuer quelques r‚glages afin d'ˆtre conforme … vos
besoins.



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

Cliquez sur n'importe quel mot soulign‚ pour acc‚der … la nouvelle
page. Appuyer sur la touche [Undo] pour retourner … la page
pr‚c‚dente. En cliquant avec le bouton droit de la souris sur lien,
il apparaŒt l'adresse de la page li‚e.



7 Module pour l'accŠs direct … Internet
=======================================

Pour acc‚der directement … des pages WEB sur Internet, un module
suppl‚mentaire (CAB.OVL) est n‚cessaire. Ce module doit ˆtre plac‚
dans le mˆme r‚pertoire que le programme CAB.APP. Ce fichier contient
les routines additionnelles n‚cessaires pour l'accŠs … Internet.

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

L'auteur n'a pas la possibilit‚ de tester le module Internet mais a
programm‚ une interface int‚ressante dans CAB (HTML-Browser) pour
permettre … quiconque capable de programmer ces routines de cr‚er 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 d‚sirent 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 boŒte de dialogue
qui affiche l'URL (de l'anglais Universal Resource Locator), c'est-…-
dire l'addresse que vous avez saisie pour acc‚der au WWW.


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

L'option *Ouvrir un fichier local...* du menu *Fichier* appelle le
s‚lecteur 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 affich‚s 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 d‚tails.

Si un r‚pertoire est s‚lectionn‚, le contenu de ce r‚pertoire est
alors affich‚ et ses sous-r‚pertoires sont affich‚s graphiquement
dans une page HTML; les r‚pertoires et fichiers peuvent alors ˆtre
s‚lectionn‚s … la souris !


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

Charge … nouveau la page HTML courante. Cette fonction est utile
(dans un environnement multitƒche) pour l'‚dition grƒce … un ‚diteur
des pages HTML CAB tournant en parallŠle pour afficher les pages.

Si la page est d'origine r‚seau, c'est-…-dire qu'elle … ‚t‚ charg‚e
sur un serveur WEB via Stick, l'utilisation de la fonction *Recharger*
conduit … un nouveau rapatriement de cette page depuis le serveur
WEB; mˆme si une copie de cette page est d‚j… disponible dans le
cache.


8.4 Nouvelle fenˆtre
--------------------

Ouvre une nouvelle fenˆtre qui affiche le contenu de la page
pr‚c‚dente du document en cours.


8.5 Fermer fenˆtre
------------------

Ferme la fenˆtre active.


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

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


8.7 Impression
--------------

Si GDOS est disponible, le texte du document de la fenˆtre active
peut ˆtre imprim‚. Les fontes Bitmap n‚cessitent les fontes adapt‚es
pour l'‚cran et l'imprimante sinon les fontes vecti•rielles de NVDI
3.x ou SpeedoGDOS seront automatiquement mises … l'‚chelle voulue.

Les marges peuvent ˆtre d‚finies dans la boŒte de dialogue. Celles-ci
sont ajout‚es aux d‚calages et marges d‚finies par l'imprimante et le
pilote GDOS. Un menu popup permets la s‚lection d'un pilote GDOS si
disponible, d'un fichier GEM Metafile (*.GEM) ou d'une image binaire
(*.IMG).

Le succŠs de l'impression des images depends du pilote d'impression
GDOS qui doit supporter une fonction VDI particuliŠre. Celle-ci peut
ou non ˆtre pr‚sente dans le pilote que vous utiliser. Nous vous
recommandons donc d'essayer d'imprimer avec les images affich‚es et
losrque cela ne fonctionne pas, de simplement d‚sactiver l'affichage
des images pour les impressions suivantes. Si vous utilisez une
imprimante … aiguilles, activer l'option "Plus Clair" du menu
impression sinon l'impression est trop sombre.


8.8 Quitter
-----------

Sort du programme.


8.9 Page d'accueil
------------------

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

CAB essaye de charger dŠs le d‚part la page d'accueil. N'importe qui
connaissant la syntaxe HTML peut ais‚ment d‚finir une page d'accueil
et cr‚er une page qui r‚ferencera d'autres documents HTML. Le fichier
utilis‚ comme page d'accueil peut ˆtre d‚fini dans la boŒte de
dialogue *G‚n‚ral* du menu options.


8.10 Retour
-----------

Affiche le document pr‚c‚dent.


8.11 Trouver un mot
-------------------

Cette fonction permet … l'utilisateur de rechercher un mot dans un
fichier HTML, elle peut ou non ˆtre sensible aux caractŠres
minuscules et majuscules. La recherche peut ˆtre effectu‚e dans :

  1. Le document courant et seulement lui. La chaŒne d‚sign‚e est
     recherch‚e dans le document de la fenˆtre active courante. Si la
     chaŒne est trouv‚e, le document est affich‚ de fa‡on … ce que
     l'on voit celle-ci au sommet de la fenˆtre.

  2. les documents HTML locaux. La chaŒne est recherch‚e parmi tous
     les document HTML des chemins sp‚cifi‚s dans la boŒte de
     dialogue *Chemins*, ainsi que dans leurs sous-r‚pertoires. Le
     fichier contenant le r‚sultat 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 recherch‚s. Permettre
     cette recherche serait trŠs couteux en temps. Ceci signifie
     ‚galement que les caractŠres sp‚ciaux comme les accents qui sont
     cod‚s en HTML par des commandes du type ä ne seront
     ‚galement pas retrouv‚s. Cette limitation sera trait‚e 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,
     pr‚fix‚ la chaine recherch‚e 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 r‚pertoires
     et les adresses de pages de la forme '.../WWW/foo.html...'. En
     placant un espace avant, ' WWW' supprimera les occurences
     conduisant … un meilleur r‚sultat de la recherche. Ceci ne
     s'applique pas aux m‚thodes de recherche 1 et 3.

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

     Dans ce cas, les fichiers HTML eux-mˆmes sont parcourues pour la
     recherche mais le fichier d'index est ouvert … la place. Pour
     que HTML-Browser sache o— sont plac‚s les fichiers pour ce CD,
     vous devez d‚finir le bon chemin dans la zone texte appropri‚e
     de la boŒte 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 donn‚es
     (\UNIX\CT94.DAT ou \UNIX\CT9293.DAT). Au mˆme titre que la
     m‚thode pr‚c‚dente, les documents qui contiennent la chaŒne
     recherch‚e sont compil‚s dans un document HTML nomm‚
     results.html, qui sera ouvert automatiquement par la suite.


8.12 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'acc‚der rapidement …
vos pages favorites, sans avoir … nouveau … "surfer" … travers une
longue s‚rie de pages pour l'atteindre.

La liste utilisateur est organis‚e par thŠme. En utilisant le menu
popup situ‚ au sommet de la boŒte de dialogue, il est facile de
passer d'un thŠme … l'autre.

*Le popup 'ThŠme...':*

 *Changer thŠme:* Modifie le nom du thŠme courant. Le thŠme
    /Miscellaneous/ ne peut ˆtre renomm‚.

 *Nouveau thŠme:* Cr‚er un nouveau thŠme.

 *Effacer thŠme:* Efface le thŠme courant. Le thŠme /Miscellaneous/ ne
    peut pas ˆtre effac‚. Tous les autres thŠmes peuvent ˆtre
    effacer, les adresses correspondant … ce thŠme sont alors
    automatiquement d‚plac‚es dans le thŠme /Miscellaneous/.

*Le popup 'D‚placer thŠme...':*

    Cette option permet de d‚placer une entr‚e dans un autre thŠme.

*Le popup 'Document...':*

 *Effacer entr‚e:* Efface l'entr‚e s‚lectionn‚e.

 *Modifier entr‚e:* Modifie l'entr‚e s‚lectionn‚e Une note concernant
    la page peut ‚galement ˆtre ajout‚e.

 *Ouvre un document:* Ouvre un document.

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

Un double clique sur une entr‚e ouvre le document correspondant.

La liste utilisateur est sauvegard‚e sur le disque en tant qu'un
simple document HTML ce qui permet de proposer une maniŠre simple …
quiconque de cr‚er sa propre page.


8.13 Document -> Liste
----------------------

Le document courant est ins‚r‚ dans la liste utilisateur pour peu
qu'il n'y figure pas d‚j…. Il est ajout‚ dans le thŠme /Miscellaneous/.


8.14 Options G‚n‚ral
--------------------

 *Page d'accueil:* AprŠs le d‚marrage de CAB ou en s‚lectionnant
    l'entr‚e *Page d'accueil* du menu g‚n‚ral, la page HTML sp‚cifi‚e
    sera affich‚e. Il est souvent utile de cr‚er une page d'accueil
    contenant les r‚f‚rences aux pages visit‚es fr‚quemment. Par
    d‚faut, CAB essaye de charger la page home.html comme document
    initial mˆme si aucune page n'a ‚t‚ d‚finie dans le menu *g‚n‚ral*.
    Saisissez simplement l'adresse URL de la page d‚sir‚. Si le
    fichier pr‚cis‚ n'existe pas dans le r‚pertoire de CAB, vous
    pouvez choisir le *r‚pertoire de d‚marrage* ou utiliser le boutton
    de *recherche* pour d‚signer le fichier voulu en utilisant le
    s‚lecteur de fichier.

 *Popup menus:* CAB propose une barre de boutton qui r‚sume les
    principales fonctionnalit‚s de navigation … travers les documents
    HTML.

    Utilisation de la souris

      ù Clique gauche sur une r‚f‚rence pour acc‚der … la page
        d‚sign‚.

      ù Clique droit sur une r‚f‚rence pour afficher la r‚f‚rence
        URL.

      ù Clique sur le fond (pas sur une r‚f‚rence) pour afficher le
        menu compl‚mentaire.

    Vous pouvez d‚finir 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 pr‚c‚demment affich‚s.

     *R‚f‚rences:* Liste les r‚f‚rences du document courant.

     *Menu:* Liste certains items des menus.

 *Divers:* Durant le chargement, le formatage et le transfert de
    donn‚es depuis Internet, CAB affiche une s‚rie de messages dans
    une fenˆtre de dialogue (Si l'option *Dialogue* est active) sinon
    la fenˆtre d¡nformation on-line est utilis‚. L'affichage dans la
    fenˆtre d'info … quelques d‚savantages. PremiŠrement, une fenˆtre
    peut ne pas pouvoir ˆtre ouverte pour afficher l'information et
    deuxiŠmement, la fenˆtre de dialogue affiche les informations de
    maniŠre plus complŠte. d'un autre cot‚, l'utilisation de la
    fenˆtre d'info permet que le document de la fenˆtre puisse ˆtre
    lu et d‚plac‚ alors que le texte est toujours en train d'ˆtre
    formatt‚.

    Le choix *Charge index.html* n'a d'effet que sur les r‚f‚rences
    locales (c-a-d aux fichiers/r‚pertoires de votre disque). Si la
    r‚f‚nrece pointe sur un r‚pertoire 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 d‚finir un index de tous vos documents favoris.


8.15 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 r‚glages effectu‚s. En mode 16
    couleurs, seules les premiŠres 9 couleurs peuvent ˆtre utilis‚es
    car les 7 derniŠres peuvent ˆtre modifi‚es 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
    modifi‚es par CAB.

    Certains documents HTML contiennent des informations sur la
    couleur de du texte, des r‚f‚rences 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* empˆche le chargement des images et leur affichage,
        ce qui acc‚lŠre le chargement des pages.

     *Monochrome* Les images sont affich‚es en monochrome par la
        m‚thode du "dithering". C'est la m‚thode la plus rapide mais
        bien ‚videmment la qualit‚ en souffre.

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

     *Couleur* Les images sont affich‚es en couleur selon le mode vid‚o
        courant :

         ù 4-8 plans (16-256 couleurs). Les images sont "dither‚es"
           si le nombre de couleurs disponibles est inf‚rieur … celui
           de l'image. En mode 16 couleurs, le mode niveau de gris
           est g‚n‚ralement 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 d‚cripter
        par des systŠmes fonctionnant en mode texte seul, les images
        sont alors acompagn‚es 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 affich‚es en tant qu'images.

 *Largeur de Texte:* Le texte peut soit ˆtre formatt‚ sur une largeur
    fixe, soit de maniŠre … remplir la largeur de la fenˆtre. Les
    textes justifi‚s pour remplir la fenˆtre sont plus jolis mais
    sont plus longs … ˆtre affich‚s car le texte doit ˆtre
    reformatt‚.


8.16 S‚lection 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
n‚anmoins ˆtre utilis‚es.

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
recommand‚es. Vous devez pr‚cisez trois fontes (sans-serif, serif et
monospaced) dans quatres styles (normal, gras, italique et gras et
italique), ce qui fait 12 s‚lections au total.

Pour le r‚glage du gras et de l'italique, vous devez utiliser une
'vraie' fonte de type gras ou italique si c'est possible. Si vous ne
poss‚der pas de telles fontes, ces effets seront simul‚es, ils vous
faut alors activer le bouton adjacent correspondant au popup de la
fonte concern‚e. Si vous utilisez des fontes vectorielles, utiliser
alors une fonte proportionnelle de la mˆme famille, si disponible.

Le fichier INF possŠde les pr‚r‚glages suivants (pour NVDI 3.x):

 *Tˆtes 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 d‚finir d'autres.

La taille du corps du texte peut ‚galement ˆtre modifi‚e. N'en
d‚finissez pas une trop grande ou trop petite ! Entre 10 et 13 points
est correcte (J'utilise 12 points).

Si vous n'avez pas accŠs … des fontes vectorielles (c.a.d que vous ne
poss‚der 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 systŠmes, g‚n‚ralement en taille 10 points.

*formatt‚:*
Certaines commandes comme <PRE>...</PRE>, <FORM>...</FORM> etc sont
la causent de problŠmes d'affichage avec les polices /proportionelles/.
Pour ‚viter ces problŠmes, utiliser seulement les polices *non-
proportional* avec ces commandes.


8.17 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 appel‚s de deux maniŠre diff‚rentes et ils
sont d‚finis dans le dialogue *visualiseurs externes...* du menu
*Options*.

Des types de fichier individuels peuvent ˆtre affect‚s … diff‚rents
programmes. L'extension de fichier doit ˆtre saisie dans le champ
*Fichiers*. Plusieurs extensions peuvent ˆtre entr‚es, en utilisant la
virgule comme s‚parateur.

Les programmes sont s‚lectionn‚es en cliquant sur le boutton
s‚lection situ‚ … droite du champ *Fichiers* qui appelle le selecteur
de fichier pour d‚signe le visualiseur d‚sir‚.

Enfin chaque entr‚e comporte une boŒte … cocher *Supports VA_START* qui
doit ˆtre activ‚e si le visualiseur s‚lectionn‚ est conforme au
protocole VA_START, ainsi CAB pourra envoy‚ un paramŠtre en VA_START
au visualiseur pour que le fichier puisse ˆtre directement ouvert.

Le programme *D‚faut* (*.*) 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‚ d‚finie sans qu'un programme ne soit
d‚fini, CAB essaiera d fficher 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) possŠde des routines d'affichage en interne. L'usage de CAB
(HTML-Browser) avec ces fichiers permet de r‚duire au maximum le
nombre de visualiseurs externes n‚cessaires.

La page HTML courante peut ˆtre affich‚e sou la forme de son texte
source en s‚lectionnant une application dans le champ *Source*. Cette
application est appel‚ par l'entr‚e *Voir source...* du menu. Si aucune
application n'a ‚t‚ assign‚e, le programme par *D‚faut* sera appel‚.

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

Quelques programmes de visualisations conseill‚s :

 *.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

 *.* (D‚faut):   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.18 Chemins...
---------------

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

Dans le champ *R‚pertoire HTML*, saisissez le r‚pertoire 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 donn‚es*,
saisissez le chemin du contenu du CD (?:\UNIX\CT94.DAT) (ou
?:\UNIX\CT9293.DAT).

Si vous d‚sirez utiliser CAB en on-line sur un site Internet, vous
devez d‚finir le r‚pertoire le *R‚pertoire Cache* o— tous les fichiers
charg‚s seront sauvegard‚s. Ce r‚pertoire devrait id‚alement se
trouver sur une partiton Minix, ou un systŠme de fichier qui prend en
compte les longs noms de fichiers. En effet, l'utilisation d'un
classique systŠme de fichier systŠme TOS 8+3 conduit souvent … la
duplication de noms. assurez vous que ce r‚pertoire est dans une
partition poss‚dant beaucoup d'espace libre !

Dans les champs *R‚pertoires 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
r‚pertoire racine. Le r‚pertoire HTML permet d'‚viter ceci en
d‚finissant pour CAB un dossier sp‚cifique.

Un exemple:

 *R‚pertoire 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.19 Cache
----------

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

Le *Cache Image* est utilis‚ pour ‚viter les d‚compactages et dithering
r‚p‚t‚ des images, qui prennent tout deux beaucoup de temps. Les
images qui ne sont plus affich‚es sont maintenues en m‚moire (RAM) au
cas o— on ait encore besoin de les afficher. Naturellement, ceci
demande de la m‚moire, aussi cette taille peut ˆtre d‚finie dans le
champ *Taille maximum*. Si le cache est plein, le minimum des images
est effacer du cache pour lib‚rer de l'espace. L'usage de l'option
*Garder libre* permet de r‚gler la taille minimum de m‚moire qui doit
ˆtre pr‚serv‚e pour les autres applications. Le cache peut ‚galement
ˆtre effacer manuellement en utilisant le bouton *Vider cache* qui peut
ˆtre utile pour lib‚rer rapidement de la m‚moire pour d'autres
applications dans un environnement multitƒche. 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 ‚lev‚e que celle d‚finie 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 charg‚s …
partir Internet pour ‚viter les chargements r‚p‚t‚s inutiles d'un
mˆme 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 s–r de ne pas
avoir … nouveau besoin de ces fichiers, il est pr‚f‚rable 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 plac‚s dans me r‚pertoire de cache seront effac‚s.


8.20 Sauver les options
-----------------------

Sauve les options courantes



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

Chaque fenˆtre de CAB contient une barre de boutons qui permet de un
accŠs facile … des fonctions importantes:

 *Retour* Affiche la page pr‚cedente

 *Home* Affiche la page d'accueil

 *URL* S‚lectionne un document par son adresse URL

 *Fichier* S‚lectionne un fichier avec le s‚lect‚ur 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 apparaŒt sur la droite de la barre de de
boutons, cela signifie que le document contient une erreur. Cliquer
sur le smiley pour obtenir plus d¡nformation. Ceci est
particuliŠrement utile … tous ceux qui utiliseront CAB pour cr‚er ou
‚diter des pages HTML. Seules les erreurs que CAB saura d‚terminer
sans perte d'espace disque ou de temps seront trait‚es.

Les documents incorrectes ne seront pas forc‚ment mal affich‚s par
CAB mais conduirait … des probl‚mes 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 d‚couvertes de bogues m'ont aid‚ dans le
d‚veloppement de CAB, les personnes cit‚es ci-dessous m‚ritent une
mention toute particuliŠre :

   ù 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 Am‚liorations 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.

S¡l vous plait, ne vous g‚nez pas pour apporter des suggestions et
des critiques constructives ...



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

 *V0.8ž (20.04.1995)*

      ù PremiŠre version

 *V0.9ž (15.05.1995)*

      ù R‚duction de la quantit‚ de m‚moire requise

      ù Compatibilit‚ avec le Drag&Drop de MTOS(ARGS)

      ù Les programmesmes externes fonctionnenet maintenant sous TOS
        seul.

      ù La description des erreur est plus explicite

      ù Correction d'erreur: N'essaye plus d'inverser les ‚l‚ments
        non existants des menus lorsque CAB est lanc‚ comme
        accessoire.

      ù Le fichier .INF est dor‚navant trouv‚ mˆme lorsque CAB n'est
        pas ‚xecuter depuis son propre r‚pertoire.

      ù Plus de tol‚rance envers le code HTML erron‚.

      ù home.html est maintenant charg‚ au d‚marrage quand c'est
        possible

      ù Liste utilisateur (Hotlist)

      ù Configuration des couleurs des fenˆtres et du texte, etc.

      ù Recherche (Dans la base CDROM aussi)

      ù Les images peuvent ˆtre affich‚es en niveaux de gris

 *V0.93ž (07.06.1995)*

      ù Pr‚paration pour les op‚rations on-line (Pas encore actif)

      ù Correction de bug : ProblŠme avec l'espacement des lignes est
        r‚solu

      ù Correction de bug : boucle sans fin avec des fichiers gif
        d‚fecteux

      ù Correction de bug : Oubli du fclose() pour la liste
        utilisateur :-(

 *V0.94ž (07.07.1995)*

      ù Correction de bug : L'effacement du dernier ‚l‚ment de la
        liste utilisateur causait un plantage :-(

      ù Correction de bug : Les CR/LF … l'int‚rieur des tags
        amenaient des problŠmes

      ù Correction de bug : Disparition du dernier mot des fichier
        HTML

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

      ù Le contenu d'un lecteur peut ˆtre affich‚ dans un document
        HTML (y compris l'‚xecution des programmes et la
        visualisation des fichiers)!

      ù Accepte la commande sp‚ciale Netscape <CENTER>

 *V0.95ž (04.08.1995)*

      ù Images en couleurs

      ù Cache image configurable (en RAM)

      ù Cache WWW configurable (sur le disque)

      ù Option pour formatter automatiquement le texte selon la
        largeur de la fenˆtre

      ù Les fichiers ASCII, xbm et gif peuvent maintenant ˆtre
        directement visualis‚ dans CAB. L'appel de visualiseurs
        externes n'est plus n‚cessaire (Mais reste bien entendu
        disponible en 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!

      ù Accepte les images xbm

 *V0.96ž (22.08.1995)*

      ù Plein de correction de petits bugs

 *V0.98ž (03.10.1995)*

      ù Dans les r‚solutions de moins de 4 couleurs, la palette n'est
        plus modifi‚e

      ù Les fichiers de longueur nulle ne posent plus de problŠmes

      ù Le programme est maintenant nomm‚ :
        CAB - Le Taxi pour les autoroutes de l'inforation !
        CAB = Crystal Atari Browser

 *V1.0 (01.11.1995)*

      ù Petite modification pour le look 3D sous Geneva release 4
        (Geneva n'est malheureusement pas entiŠrement compatible avec
        MultiTOS)

      ù Plusieurs fenˆtres peuvent ˆtre ouvertes

      ù Chaque fenˆtre peut ˆtre configur‚e individuellement avec ses
        propres couleurs et fontes

      ù Accepte les commandes Netscape suivantes :

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

         - <BASEFONT SIZE=n>

         - <CENTER> </CENTER>

         - <NOBR> </NOBR>

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

      ù Accepte les zones <FORM> (formulaires)

      ù Les tableaux (<TABLE>...</TABLE>) sont pris en compte.

      ù Les dialogues de la liste utilisateurs ont ‚t‚s augment‚ pour
        s'adapter aux thŠmes. Chaque entr‚e peut ˆtre comment‚e de
        fa‡on optionnelle

      ù La gestion du cache a ‚t‚ modifi‚e. Les fichiers ne sont
        dor‚navant plus sauvegard‚s dans le cache sous leur nom
        original ce qui devrait r‚soudre les problŠmes sous le
        systŠme de fichier standard TOS 8+3

      ù Adjonction d'un popup d'historique

      ù Adjonction d'un menu popup affichant tous les liens de la
        page

      ù Les images <IMG ...> avec les attributs ALIGN=LEFT ou
        ALIGN=RIGHT fonctionnent maintenant correctement.

      ù La taille des fontes dans les zones <Hn> </Hn> sont modifi‚es
        (en ligne par la m‚thode utilis‚e par Netscape et Mosaic)

      ù La recherche fonctionne maintenant correctement avec la base
        de donnÇes du CDROM c' 92/93

      ˘ Nouveau : une barre de boutons permet un accäs facile aux
        fonctions les plus importantes. Si un visage triste apparaåt
        Ö la droite de la barre de boutons, cela signifie que le
        document affichÇ n'est pas conforme avec les spÇcifications
        HTML. CAB essaye nÇanmoins d'afficher le document qui peut
        tout aussi bien paraåtre bon. D'un autre cotÇ, aucun visage
        souriant indiquera un document parfait car CAB ne perd pas
        son prÇcieux temps Ö analyser le document en profondeur.

      ˘ Le format d'alignement Ö droite (ALIGN=RIGHT) est maintenant
        acceptÇ.

      ˘ Nombreuse corrections de petits bugs ;-)

 *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.

 *V1.1 (01.01.1996)*

      ˘ L'impression avec GDOS est maintenant possible. Pour
        l'instant, l'impression des images n'est possible qu'en
        monochrome. La sortie peut àtre effectuÇe via n'importe quel
        pilote GDOS disponible, GEM Metafile, ou fichier IMG etc.

      ˘ Le dialogue Liste utilisateur peut maintenant àtre
        entiärement controlÇ par des touches du clavier (Si tel est
        votre dÇsir).

      ˘ Le Clipboard, Les commandes Couper [Control]+X, Copier
        [Control]+C et Coller [Control]+V sont maintenant disponibles
        dans tous les champs Çditables des dialogues.

      ˘ Ces màmes commandes sont Çgalement disponibles dans les
        champs Çditables des documents HTML.

      ˘ La position de la fenàtre est maintenant sauvegardÇe par
        l'option 'Sauver options' dans le menu 'Options'.

      ˘ Nouvelles commandes supportÇes (HTML3) :

         - <BIG>, </BIG> gros texte

         - <SMALL>, </SMALL> petit texte

         - <SUP>, </SUP> Exponanciation

         - <SUB>, </SUB> Indexation

      ˘ Les entrÇes de la liste utilisateur peuvent àtre dorÇnavant
        entiärement àtre crÇÇs manuellement.

      ˘ Correction de bug : Les fichiers HTML dont les commentaires
        sont exceptionellement longs et qui n'avaient pas l'extension
        .HTM (ou .html sur les systämes supportant les longs noms de
        fichiers) Çtaient affichÇs comme des fichiers ASCII.

      ˘ Correction de bug : Les tables avec des gros nombres de
        lignes et/ou de colonnes posaient problämes.

      ˘ Encore plus de tolärance envers les inventions farfelues de
        certains auteurs qui inventent des associations de commandes
        HTML incongrues - màme lorsque une simple commande HTML
        existe däjÖ pour effectuer cet effet :-\