                          Dokumentation fr

                                 CAB

                Version 1.4 (versatt av Mille Babic)
                              19.09.1996

                                  av

                           Alexander Clauss
                         Stresemannstrae 44
                          D-64297 Darmstadt

                aclauss@rbg.informatik.th-darmstadt.de



Innehll
========

 1  En kort introduktion

 2  Rttigheter

 3  Adress

 4  Systemkrav

 5  Installation

 6  Navigera HTML Dokument

 7  Modul fr realtids Internettillgng

 8  Beskrivning av menyraden
    8.1  ppna URL...
    8.2  ppna lokal...
    8.3  Ladda om
    8.4  Utskrift
    8.5  Nytt Fnster
    8.6  Stng Fnster
    8.7  Visa kllskript
    8.8  Avsluta
    8.9  Hemsida
    8.10  Backa
    8.11  Sk nyckelord
    8.12  Bokmrken
    8.13  Dokument -> Bokmrke
    8.14  Huvudinstllningar
    8.15  Visa
    8.16  Teckensnitt
    8.17  Hjlpprogram
    8.18  Skvgar...
    8.19  Cacheminne
    8.20  Spara Instllningar

 9  Verktygsflt

10  Tack till...

11  Mjliga framtida uppdateringar

12  Historik
   12.1  V0.8 (20.04.1995)
   12.2  V0.9 (15.05.1995)
   12.3  V0.93 (07.06.1995)
   12.4  V0.94 (07.07.1995)
   12.5  V0.95 (04.08.1995)
   12.6  V0.96 (22.08.1995)
   12.7  V0.98 (03.10.1995)
   12.8  V1.0 (01.11.1995)
   12.9  V1.0a (12.12.1995)
   12.10  V1.1a (01.04.1996)
   12.11  V1.2a (16.04.1996)
   12.12  V1.2b (19.04.1996)
   12.13  V1.3 (20.05.1996)
   12.14  V1.4 (19.09.1996)
   12.15  V1.41a (01.10.1996)
   12.16  V1.5 (20.10.1996)



1  En kort introduktion
***********************

*CAB* - Taxin till informationens motorvgar!
*CAB* - Crystal Atari Browser

Tidigare benmnd HTML-Browser

Detta program r kapabelt att lsa HTML-Dokument. Dessa kan vara
lagrade p diskenhet eller CD-ROM. Fr att lsa HTML-Dokument i
realtid p Internet World Wide Web (WWW), s krvs en separat modul.



2  Rttigheter
**************

Detta program r FREEWARE. Det kan kopieras och lmnas vidare
kostnadsfritt genom media som BBS:er, FTP och diskbibliotek.
Programmet fr dock INTE spridas med CD-ROM eller som tidningsdisk
utan mitt skriftliga medgivande. Samtliga filer tillhrande CAB mste
hllas komplett tillsammans och ndringar i programmet och dess filer
inklusive dokumentationen r inte tilltet.

Om programmet faller till Er beltenhet och anvnds regelbundet, s
registrera den kopian, alla (frivilliga) summor r vlkomna.

Vill Du se fortsatt utveckling av CAB, s ge mig respons. Frslag om
frndringar, tillgg och kritik ermottages tacksamt.



3  Adress
*********

*Min adress:*

    Alexander Clauss
    Stresemannstr. 44
    D-64297 DARMSTADT
    TYSKLAND

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

*Bankkonto:*

    Sparkasse Darmstadt
    BLZ: 508 501 50
    Kontonr: 0115032143

*Brittiskt std:*

    Joe Connor
    65 Mill Road
    Colchester
    GB-CO4 5LJ
    ENGLAND

    email: jconnor@@cix.compulink.co.uk

*Fransk kontakt:*

    Jouffrey Romuald
    1 chemin de l'glise
    38100 GRENOBLE

    email: rom38@@gen4.pressimage.fr

*Svensk versttning:*

    Mille Babic


    email: mille@tripnet.se

*Hollndsk (BeNeLux) support:*

    (C.S.R.P.)
    Ton Ketting
    Katendrechtselaan 2
    3072 NM Rotterdam

    email: tonk@box.nl



4  Systemkrav
*************

Programmet r krbart p alla datorer som anvnder (Atari-) TOS
operativsystem med 1 MB RAM eller mer. Internminnestgngen r
alldeles beroende p vilken expanderad bildskrmsupplsning man kr
datorn med och vilket frgdjup bilderna har. Vid sdana uppsttningar
rcker 1 MB RAM inte lngt.

CAB r bildskrmsupplsningsoberoende, men vid lgre upplsningar som
ST-Lg (320x200) fr inte vissa av dialogrutorna plats p skrmytan
och med ST-Medel (640x200), s r inte bildpunkterna kvadratiska. Det
rekommenderas allts att kra programmet med en upplsning av 640x400
(ST-Hg) eller hgre.

Det r inte absolut ndvndigt, men anvnder man vektoriserade
teckensnitt genom NVDI eller SpeedoGDOS, s kan programmet optimalt
konfigureras. Bitmappade GDOS teckensnitt (systemfonten) fungerar
annars alldeles utmrkt.



5  Installation
***************

*Observera:*

    Sedan CAB passerade v1.0, s kan den inte lngre anvndas som
    en accessory.

    Instllningsfiler frn ldre versioner av CAB (CAB.INF) kan
    inte anvndas. Nykonfigurering fr ske frn programmet.

    Formatet fr datafilen innehllande bokmrkena r ocks
    ndrad. Tidigare CAB.HOT r ersatt med HOTLIST.HTM(L). Man kan
    anvnda sig av innehllet i frra versionen genom att starta
    upp CAB med CAB.HOT och sedan spara instllningar och drefter
    kan filen CAB.HOT tas bort.

HTML-filer som laddas ner frn WWW innehller ofta lnga filnamn,
detta kan leda till duplicering av filerna om man kr datorn med TOS
8+3 filsystem. Det rekommenderas hrav att man kr datorn med en Minix
hrddiskpartition med hjlp av MiNT.

CAB r med de frsatta instllningarna klar att kras, men man kan se
ver konfigurationen och anpassa den till ens egna behov.



6  Navigera HTML Dokument
*************************

Klicka p understrukna ord och ny sida laddas in. Med tryckning p
<Undo>-tangenten backar man till fregende sida och en klickning med
hger musknapp p ett understruket lnkord, visas adressen till den
sida lnken refererar till.



7  Modul fr realtids Internettillgng
**************************************

Fr att blddra WWW HTML-sidor i realtid p Internet, s krvs det en
extern modul (CAB.OVL). Denna skall placeras i samma katalog som
huvudprogrammet CAB.APP. Modulen innehller de ndvndiga rutiner fr
att CAB skall kunna "surfa" p Internet.

P en Minixpartition mste flaggan "x-flag" vara satt, annars startar
modulen inte upp.

Jag har inga frutsttningar att sjlv testa av en sdan modul, men
har programmerat in ett grnssnitt i CAB som stdjer sdana moduler.
P s stt lmnar jag drren ppen fr vem som helst som kan skapa en
Internetmodul med de ndvndiga rutinerna. Beskrivning av den hr
porten lmnar jag ut efter frfrgan och den finns som kommenterad
kllkod i C eller Pascal. Jag r intresserad av att hra av ngon som
kan ta fram en sdan modul, s kan jag distribuera den med CAB.



8  Beskrivning av menyraden
***************************


8.1  ppna URL...
=================

*ppna URL...* i *Arkiv@*-menyn tar fram dialogrutan fr inmatning av
URL-adress (Universal Resource Locator) fr inladdning av websidor.


8.2  ppna lokal...
===================

Valet fr *ppna lokal...* i *Arkiv*-menyn kallar p filvljaren, vilken
kan anvndas fr att ppna HTML-dokument frn diskenhet eller CD-ROM.

Vilka filtyper som helst kan vljas. HTML, XBM och GIF visas normalt
av CAB (HTML-Browser), andra filtyper handhas av externa hjlpprogram.
Referera till externa *Hjlpprogram* fr mer detaljer.

Ifall en katalog vljs ut, s visas dess innehll och de underliggande
katalogerna grafiskt som en HTML-sida och vilka filer som helst, samt
kataloger kan vljas med hjlp av musen!


8.3  Ladda om
=============

Laddar nyo HTML-sidan. Denna funktion r anvndbar i multikrnings-
milj under editering av HTML-kllskript med en editor motsv. med CAB
samtidigt.

Skulle HTML-sidan vara inladdad frn WWW, s laddas den in p nytt
trots att den finns i cacheminnet.


8.4  Utskrift
=============

Om GDOS r tillgngligt s kan den aktiva sidan skrivas ut som text.
Mrk att bitmappade teckensnitt krver matchande skrm- och printer-
fonter, medans vektoriserade teckensnitt med NVDI eller SpeedoGDOS
automatiskt skalas till rtt utskriftsproportioner.

I dialogrutan kan marginaler sttas, dessa fr alla offset fr
marginaler till antigen skrivar- eller GDOS-drivrutiner. En
rullgardinsmeny innehller val av alla tillgngliga installerade GDOS
drivrutiner fr skrivare, GEM Metafile (*.GEM) eller bild (*.IMG).

Frutsttningar fr bra utskrifter vilar p om GDOS skrivardrivrutin
stdjer speciell VDI-funktion, som r eller som inte r implementerad
i drivrutinen. Det rekommenderas att testa med utskrifter med bild i
psatt lge och om det inte skulle fungera, s stng av funktionen.
Anvnds matrisskrivare, s aktivera valet fr bildtoning annars kan
utskriften bli fr mrk.


8.5  Nytt Fnster
=================

ppnar ett nytt fnster med samma innehll som tidigare aktivt
fnster.


8.6  Stng Fnster
==================

Stnger aktivt fnster.


8.7  Visa kllskript
====================

Visar kllskriptet fr aktivt HTML-Dokument, refererar ven till
externa *Hjlpprogram* fr att presentera skriptet.


8.8  Avsluta
============

Avslutar programmet.


8.9  Hemsida
============

Detta val aktiverar hemsidan om den r satt i *Huvudinstllningar*.

CAB frsker att ladda hemsidan direkt efter start. Fr den som r
insatt i HTML-syntaxen s kan vilken sida som helst sttas som hemsida
och denne kan skapa en sida som refererar till olika websidor, som ett
snabbtkomligt register.


8.10  Backa
===========

Laddar fregende dokument.


8.11  Sk nyckelord
===================

Denna funktion lter anvndaren gra utskningar i HTML-filer med
hjlp av nyckelord och kan efter val skilja p gemener/VERSALER.
Skningen kan genomfras i fljande textomfng:

  1. Endast i aktivt dokument. Skulle skparametrarna f trff, s
     rullas sidan s att det efterskta nyckelordet lggs lngst upp i
     fnstret.

  2. Lokalt sparade HTML-Dokument. Skningen sker i alla lokala
     dokument som finns i den katalog, som r satt i *Skvgar...* och
     samtliga underkataloger till denna. De dokument som innehller
     skparametrarna fr en skvg nedskriven i en datafil kallad
     result.html.

     Frnrvarande s genomsks HTML-filer med punkt 2, endast som
     text, vilket gr att gmd text som kommentarer, HTML-kommandon,
     lnkar etc ocks hittas. Skning av dokument dr kommentarer
     ignoreras skulle bli vldigt tidskrvande. Det skall ppekas
     ocks att specialformaterade tecken som &auml; inte kan hittas.
     Detta r ngot som skulle kunna lsas framtida uppgraderingar

     Ett annat tips r att hur man kan ska speciell text, men frbig
     denna om den finns i HTML-kommandon eller URL-adresser: placera
     ett mellanslag framfr den efterskta strngen.

     Ett exempel: Skning efter strngen 'WWW' matchar ofta adresser
     fr URL:er eller skvgar fr dokument, i stil med
     '.../WWW/dummy.html'. Placerar man ett mellanslag frst i
     skstrngen s ignoreras exemplet ovan.

  3. I c't-CDROM databas. Denna funktion r endast anvnbar fr dem
     med c't CD-ROM (1994 (eller 1992/93) tyska c't tidningar i HTML-
     format.

     I dessa fall s genomsks inte HTML-dokumenten, utan indexfilen
     fr CD-ROM skivan. Fr att CAB skall veta var filerna fr CD:n
     finns ngonstans (diskenhet etc) s mste skvgen anges i
     *Skvgar...*. Resultatet av skningen av HTML-dokumenten (i \HTML
     vilken ven innehller filen DEFAULT.HTML) och index- databasen
     (\UNIX\CT94.DAT resp \UNIX\CT9293.DAT) lagras i filen
     RESULTS.HTML vilken sedan laddas in.


8.12  Bokmrken
===============

Bokmrken (favoriter) r ett register p dina mest anvnda HTML-
Dokument. Detta mjliggr att du snabbt kan n dina favoritsidor, utan
att behva navigera genom mnga HTML-sidor fr att n dit.

Registret r indelat i olika mnesomrden. Anvndning av popupfltet
verst i dialogrutan mjliggr snabb vxling mellan dessa rubriker.

*'Rubrik...' popup:*

 *ndra rubrik* ndrar namnet p aktivt mnesomrde./vrigt/ arean kan
     inte dpas om.

 *Ny Rubrik:* Skapar en ny rubrik.

 *Radera:* Raderar aktiv rubrik. /vrigt/ arean kan inte tas bort. Alla
     kvarstende bokmrken flyttas till /vrigt/ arean.

* 'Flytta...' popup:*

    Med denna funktion kan markerad adress flyttas till annan
    rubrikarea.

*'Dokument...' popup:*

 *Radera:* Raderar markerad.

 *ndra:* Fr att ndra i markerad, hr kan anteckningar ndras/lggas
     till.

 *ppna Dokument:* Laddar dokumentet.

 *Lgg till:* Adderar aktivt dokument till bokmrken i aktiv rubrik.

Dubbelklickning p ett flt laddar automatisk sidan.

Bokmrkena sparas till disk som ett normalt HTML-dokument, vilket gr
att fr den som r bekant med HTML-syntaxen kan skapa egna anpassade
bokmrken.


8.13  Dokument -> Bokmrke
==========================

Aktivt dokument infogas direkt som bokmrke till rubriken fr /vrigt/
om det redan inte finns dr.


8.14  Huvudinstllningar
========================

 *Hemsida:* (Startsida) Efter start av programmet eller vid valet fr
     Hemsida i huvudmenyn, s laddas automatiskt valt HTML-dokument.
     Anvndbart r att skapa en hemsida med lnkar till regelbundna
     beskta websidor eller lokala HTML-dokument. CAB laddar med
     frsatt instllning dokumentet home.html, detta kan enkelt ndras
     genom att man ndrar URL:en eller om dokumentet finns lokalt p
     disk och ligger i startkatalogen i CAB, s tar en tryckning p
     *Startkatalog*knappen skvgen dit. Alternativt om man skapat en
     egen hem(start)sida fr CAB och den inte ligger i startkatalogen,
     s kan knappen *Sk* anvndas, den startar upp filvljaren och det
     r bara att peka ut HTML-dokumentet.

 *Popupmenyer:* CAB innehller ett antal popupmenyer fr att p ett
     smidigt stt navigera genom HTML-dokument. Grundprinciper gller:

         Ett vnsterklick p ett lnkord startar upp refererande
          dokument.

         Hgerklick p lnkord visar adressen till mldokumentet.

         Klickning inne i fnstret (inte p lnkar) visar ytterligare
          popupmenyer.

     Du kan stlla vilken meny som skall visas genom att anvnda
     vnster och hger musknapp, samtidigt och/eller utan en
     nedhllning av <Shift>-tangenten. Fljande popupmenyer finns
     tillgngliga:

      *historik:* Visar alla fregende beskta dokument.

      *Referenser:* Listar alla referenser i aktivt dokument.

      *Meny:* Listar ngra menyer.

 *vrigt:* Under laddning, formattering och dataverfringar med CAB
     Internet, s visas en serie rapporter om vad som sker i en
     dialogruta mitt p skrmen. Om valet fr *Dialog fr
     statusmeddelanden* r satt s anvnds denna dialog, annars visas
     meddelandena i fnstrets informationsrad.

     Informationsraden i fnstret har dock den nackdelen att
     dokumentinnehllet inte placeras in i fnstret medans laddningen
     och formatteringen sker, samt att en dialogruta visar mer
     specifik information om vad som sker. Med dialogrutan aktiv s
     kan man med rullningslisterna i fnstret lsa redan inladdad
     information medans laddning och formattering sker.

     *Ladda index.html automatiskt* har endast den effekten att den
     refererar till lokala referenser (filer/kataloger) p diskenhet.
     Om referensen r stlld till en diskenhetskatalog, s kommer de
     filer att visas, frutsatt att katalogen inte redan har en fil
     index.html, i s fall kommer den att laddas. Nyttan med
     index.html r att du kan sammanfra bokmrken till dina
     favoritsidor.


8.15  Visa
==========

I denna dialog kan du konfigurera olika visaalternativ fr HTML
dokument.

 *Frger:* I denna del kan du stlla in frger fr bakgrund,
     frgrundstext och lnkfrg. Anvnds en bildskrmsupplsning med
     frre frger n 16, s kommer bakgrunden alltid att vara vit
     oavsett instllning. I 16-frgerslge rekommenderas att du
     anvnder endast de 9 frsta frgerna fr instllningar, ty de
     sista 7 frgerna anvnds fr bilder etc. Med mer n 16 frger s
     kan alla de frsta 16 frgerna anvndas, d de inte kommer att
     ndras.

     Vissa HTML-dokument anvnder formateringkod fr vilken frg som
     skall anvndas fr text, referenser och fnsterbakgrund. Med
     valet *Anvnd dokumentinstllningar* satt, talar om fr CAB att
     anvnda sig av dessa koder om de finns.

 *Lnkar:* Lnkar kan presenteras understrukna eller med fetstil, detta
     r bra fr monokrom upplsning, som inte kan skilja p lnkar
     genom frg.

 *Bilder:* Bilder i HTML-Dokument.

      *Visa inga* Ignorerar att ladda bilder, vilket snabbar upp
          dokumentladdningen.

      *Monokromt* Bilder visas monokromt. Det r den snabbaste metoden,
          men kvaliteten blir lidande.

      *Grskalor* Bilder visas med grskalor. Vesntligt bttre n
          monokromt, men r mer resurskrvande.

      *Frg* Bilder visas i frg med djup beroende av hrdvara:

              4-8 bitplan (16-256 frger). Ditrering (glidning) ifall
               tillgngliga frger r mindre n bildernas. I 16-
               frgers bildskrmsupplsning r oftast grskalor att
               fredra.

              15/16 bitars Highcolor (32768/65536 frger) jmf Falcon
               Truecolor upplsning.

              24- eller 32 bitars Truecolor (16.7 miljoner frger)

      *Text* HTML-syntaxen tillter att program som inte kan visa bilder
          (textblddrare), fr en alternativ text istllet fr bilder.
          Om detta val r satt (kryssat) s visas endast bilder ifall
          alternativ text saknas.

 *Textbredd:* Text kan presenteras antigen med fast bredd eller beroende
     av fnsterbredden. Text anpassat fr fnstret ser bttre ut, men
     tar lngre tid att framfra d texten mste omformateras.


8.16  Teckensnitt
=================

Programmet anvnder, om tillgngligt, olika teckensnitt och storlekar
fr textformatering av HTML-dokument. Optimal utdatakvalitet erhlles
genom vektoriserade teckensnitt med hjlp av NVDI eller SpeedoGDOS.
Bitmappade teckensnitt kan anvndas men gr inte dokumenten vrst
snygga.

Hr stller du in vilka teckensnitt som skall anvndas fr varje typ
av textformatering. Vektoriserade teckensnitt rekommenderas. Tre
fonttyper skall skall stllas in (sans-serif, serif, och
ickeproportionell) i fyra olika formateringar (normal, fetstil, kursiv
och fet kursiv), vilket gr 12 olika instllningar.

Om mjligt s rekommenderas att vid instllningar fr fetstil, kursiv
stil och fet kursiv stil, s anvnd 'riktiga' separata
teckensnittsfiler fr dessa ur respektive teckenfamilj.

Viss HTML-syntax som <PRE>...</PRE>, <FORM>...</FORM> etc kan f
formateringsproblem med anvndning av icke proportionella fonter. Fr
att undvika detta s anvnd icke proportionella fr formaterad text.

Den frsatta medlevererade konfigurationsfilen innehller fljande
instllningar:

 *verskrift:* Swiss 721 (normal, fetstil, kursiv, fet+kursiv)

 *Normal brdtext:* Dutch 801 (normal, fetstil, kursiv, fet+kursiv)
     (Stt grna MONACO.FNT, det gr snabbare och r mer lttlst)

 *Formaterad:* Letter Gothic 12 Pitch (normal, fet, kursiv, fet+kursiv)

r dessa teckensnitt inte tillgngliga i ditt system, s fr de
ersttas med befintliga.

Punktstorleken fr normal brdtext kan ocks stllas in. Vlj inga
vrden som r fr stora eller fr sm. Ngonstans mellan 10 till 13
punkter (12 punker r vanligt).

Anvnder man inte vektoriserade teckensnitt, s kommer storleken inte
att ndras, men texten blir lsbar med systemfonten med 10 punkter.


8.17  Hjlpprogram
==================

Om en lnk i ett HTML-dokument pekar p en fil som inte r i HTML-
format, s kan externa hjlpprogram anvndas. Dessa program kan
nyttjas p tv stt och stlls in i CAB genom *Hjlpprogram* i
*Alternativ* p menyraden.

Inviduella filtyper kan associeras till olika program. Filtyperna
anges i *FILTYP*-fltet. Flera filtyper kan associeras till samma
hjlpprogram separerat med kommatecken.

Hjlpprogrammen vljs genom ett musklick p flten under *PROGRAM*, det
startar upp filvljaren och lmpligt program pekas ut.

Slutligen, fr varje externt hjlpprogram, s kan det vljas om det
*Stdjer VA_START*. r valet satt s kommer CAB att snda ett VA_START-
meddelande till programmet om det redan r aktivt.

Valet av **.* (FRSATT)* r fr ett program, som klarar visa s mnga
olika filtyper som mjligt, filtyper som inte redan r associerade med
hjlpprogrammen ovan.

Om en eller flera olika dokument(fil)typer inte blivit associerade, s
kommer CAB att frska visa dessa. Dessa endast fr *.gif, *.xbm,
*.htm och textfiler (jmf: *.txt, *.doc, *.c, *.pas, *.tex etc...) fr
vilka CAB har inbyggda funktioner fr att visa. Nr ett icketext
dokument laddas kommer CAB att ropa p filvljaren, s att dokumentet
kan sparas ner p diskenhet.

Den aktiva inladdade HTML-sidans kllskript kan visas genom ett val
till ett hjlpprogram i *Kllkodsskript*. Detta program kommer att
starta genom val av *Visa kllskript...* i Arkivmenyn eller genom *Skript*
i verktygsfltet i CAB. Anges inget program, s kommer det program
installerat under *.* (FRSATT) att starta.

En dubbelklickning p fltet fr hjlpprogram startar en dialogruta,
dr frgan stlls vad man vill gra (Ta bort, Nytt program eller
Avbryt) med fltet.

Ngra rekommenderade externa hjlpprogram:

 *.text,txt:      ST-Guide, 1st-Guide (eller ingen, d CAB lser
                  detta)

 *.mpeg,mpg,mpe:  1st-Guide (p en Falcon under SingleTOS
                  rekommenderas DSP MPEG-Player)

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

 *.tiff,tif:      GEMview, Imagecopy

 *.gif,xbm:       GEM-View, Imagecopy (eller ingen, d CAB lser
                  detta)

 *.dvi:           DVI visningsprogram frn ett TeX-paket.

 *.* (Default):   GEM-View (eller ett annat program som klarar visa s
                  mnga format som mjligt).

 *.html,htm:      ST-Guide, 1st-Guide, (eller en editor, s dokumentet
                  kan ndras)


8.18  Skvgar...
=================

Om du ger en kopia av c't ROM '94 (eller 92/93), en CD-ROM med
innehll frn tyska tidningen c't, stll d skvgen dit. I fltet fr
*HTML Katalog* stlls skvgen fr DEFAULT.HTM p CD-skivan (?:\HTML\,
dr ? erstts med diskenhet dr du har CD-ROM enheten). I fltet fr
*Databas{0} stlls skvgen till sjlva databasen (?:\UNIX\CT94.DAT
eller ?:\UNIX\CT9293.DAT), nyo ? erstts med diskenhet fr
installerad CD-ROM.

Om CAB skall anvndas i realtid till Internet WWW, s skall fltet fr
*Spara HTML-dokument* stllas till en katalog, dr alla filer nedladdade
frn Internet skall sparas. Idealiskt r en minixpartition eller annat
system som stdjer lnga filnamn, ty vissa filer som laddas ner frn
Internet kan med lnga filnamn bli duplicerade i ett 8+3 filsystem.

I *HTML Kataloger* kan skvgar stllas fr att CAB skall hitta lokala
HTML-Dokument p diskenheter.

HTML Kataloger skall innehlla absoluta skvgar (jmf
/skvg/fil.html) vilket annars kan bli ett lokalt kaos p hrddisken.
Dessa flt talar om fr CAB var den skall leta efter lokala HTML-
dokument. P s stt kan man strukturera upp dokumenten i kataloger.

Hr fljer ett exempel:

 *Angivna HTML kataloger:*

         F:\HTML.DOC\

         G:\VALBART\

 *Vald diskenhet:* F:\

 *Skvg i HTML-fil:*

         /exempel/text/index.html

 *Var CAB letar:*

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

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

       3. G:\VALBART\exempel\text\index.html

En dubbelklickning p dessa flt startar en dialogruta, med frfrgan
om fltet skall rensas.


8.19  Cacheminne
================

CAB (HTML-Browser) anvnder sig av tv fickminnen fr att optimera och
snabba upp visning av data.

*Bildminne (RAM)* anvnds fr att frng upprepad uppackning och
bildkonvertering, som tr mycket p resurser och tid. Bilder som inte
lngre visas i fnster hlls kvar i internminnet, ifall de skulle
behvas igen. Sjlvklart r att detta ter p internminnet (RAM),
drfr kan grnsvrden stllas in. Maximal minnesanvndning kan
stllas i fltet fr *Max storlek*. Skulle cacheminnet bli fyllt, s
kastas de frst inlsta bilderna fr att ge plats t nya.

Inmatningsfltet fr *Hll ledigt* anvnds fr att det skall finnas
internminne (RAM) fr andra program att starta i, som externa
hjlpprogram till CAB.

Cachminnet kan ocks manuellt rensas, genom ett tryck p knappen Tm
minnet, vilket r bra om man snabbt vill lmna tillbaka RAM till
systemet fr ngot annat program. Cacheminnet hlls d tomt tills man
laddar nya HTML-dokument med bilder.

*Observera*

    Minnestgngen fr cacheminnet kan vara strre n det man
    anger i fltet.

*Internetminne (HD)* anvnds fr filer som laddas ner frn Internet p
hrddisken, fr att frhindra terkommande nedladdningar av samma
HTML-dokument (inkl bilder, ljud, film etc). Se ven *Skvgar...*.

*Max storlek* och *Hll ledigt* stter grns fr hur stor hrddiksutrymme
som skall anvndas. Passerar man maxgrnsen, s tms de lsta filerna,
fr att hlla ramen.

Om valet *Radera efter avslut* r satt, s raderas samtliga nedladdade
filer vid avslutning av CAB. Naturligtvis, ifall det finns rikligt med
hrddiskutrymme och du vet att du kommer ladda dessa dokument nyo, s
lt dem vara kvar.

Knappen *Tm minnet* r en ndlsning ifall du pltsligt skulle behva
hrddiskutymme fort. Bara filer i vald katalog och ditplacerade av CAB
kommer att raderas.


8.20  Spara Instllningar
=========================

Sparar nuvarande instllningar



9  Verktygsflt
***************

Varje fnster i CAB innehller en knapp i verktygsfltet, som ger en
snabb och enkel tillgng till mer viktigare funktioner:

 *Backa* Laddar fregende dokument

 *Hemsida* Laddar hem(start)sidan

 *URL* Vlj en HTML-sida med adress

 *Lokal* Vlj en HTML-sida med filvljaren

 *Skript* Visar kllskript fr aktiv HTML-sida

 *Nytt* Laddar om aktiv HTML-sida

 *Bokmrken* Visar sparade bokmrken

Om en s k 'smiley' upptrder hger om knapparna i verktygsfltet, s
betyder det att det inladdade HTML-dokumentet r felaktigt p ngot
stt. Klicka p 'smiley' fr mer detaljerad felkod. Denna funktion r
bra fr dem som hller p att ta fram egna dokument. Felkoden kommer
endast upp om CAB knner igen syntaxen och ingen prosesstid eller
hrddiskutymmen behvs.

Felaktiga dokument behver inte vanligtvis presenteras felagtigt i
CAB, men kanske ger felaktigheter i andra blddrare, som Mosaic,
Netscape, Webexplorer etc och kanske inte visar din framtagna HTML-
sida som du tnkt dig.



10  Tack till...
****************

Jag vill tacka alla, som genom sina lovord, kritik, frslag och
felrapportering har hjlpt till i utvecklingen av CAB. Framfrallt
fljande personer har gjort sig vrda att nmnas:

    Dan Ackerman

    Mille Babic

    Stefan Becker

    Ben Bell

    Stephane Boisson

    Joe Connor

    Dieter Fiebelkorn

    Nicholas Flintham

    Stefan Haake

    Romuald Jouffrey

    Ulrich Kaiser

    Ton Ketting

    Antonio Lillo

    Graziano Morando

    Thomas Much

    Tim Newsome

    Fred Nicklisch

    Rosario Pignatelli

    Manfred Ssykor

    Andrew Versperman

    Lodovico Zanier



11  Mjliga framtida uppdateringar
**********************************

    Fortsatt implementering av HTML3 kommandon

    Bildladdning (Dubbelklick p en [IMG] text)

    ...

Tacksam till mer frslag och konstruktiv kritik



12  Historik
************


12.1  V0.8 (20.04.1995)
========================

    Frsta slppta versionen


12.2  V0.9 (15.05.1995)
========================

    Reducerat minnesbehov

    MTOS Drag&Drop (ARGS) std

    Externa hjlpprogram kan nu anvndas under SingleTOS

    Utfrligare beskrivning av felmeddelanden

    buggfix: under krning som accessory, s sker inga frsk till
     att invertera menybalken.

    INF filen hittas ven om inte HTML startas frn sin egen katalog

    r nu mer tolerant fr felaktiga HTML-dokument.

    home.html laddas vid start om mjligt

    Bokmrken

    Konfigurering av fnster och textfrger etc.

    Skning (inklusive skning i c't CD-ROM)

    Bilder kan visas som grskalor


12.3  V0.93 (07.06.1995)
=========================

    Frberedelser fr on-line Internet access tagna (dock inte
     aktiverat i denna version)

    buggfix: Problem med radmellanrum tgrdade

    buggfix: ndls loop med defekta GIF

    buggfix: fclose() fr bokmrken glmdes :-(

    Ngra f vriga buggfixar


12.4  V0.94 (07.07.1995)
=========================

    buggfix: Radering av sista bokmrket tgrdade en krash :-(

    buggfix: CR/LF inne i ett formattag gav problem

    buggfix: Sista ordet i en HTML-fil trasades

    Dokumenttillgng med absolut skvg, inklusive kataloger listade
     i 'Skvgar...'.

    Hrddiskinnehll kan visas som HTML-dokument (inklusive
     programstart och visa filer)

    Std fr det speciella Netscape <CENTER> formatet.


12.5  V0.95 (04.08.1995)
=========================

    Bilder i frg

    Konfigurerbart bildcacheminne (i RAM)

    Konfigurerbar WWW cacheminne (p HD)

    Val att automatiskt justera dokument beroende p fnsterbredd

    ASCII, xbm och gif filer kan visas direkt i HTML-Browser. Att f
     hjlp av externa program behvs inte lngre fr dessa, men
     mjlighetn r kvar som val.

    Grnssnitt fr en WWW Internetmodul implementerat. En sdan modul
     mjliggr fr programmet att visa WWW-dokument i realtid frn
     Internet, naturligtvis behver du ett internet- konto fr att
     gra detta.

    Std fr xbm bilder


12.6  V0.96 (22.08.1995)
=========================

    Mnga smrre buggfixar


12.7  V0.98 (03.10.1995)
=========================

    I frgupplsningar med frre frger n 16 anropas inte paletten.

    Nollfiler orsakar inga problem lngre

    Programmet benmns numera: CAB - Taxin till informationens
     motorvgar! CAB = Crystal Atari Browser


12.8  V1.0 (01.11.1995)
=======================

    Smrre justeringar fr att mta ett 3D utseende i Geneva release
     4. (Geneva r beklagligt inte helt MultiTOS kompatibel)

    Multipla fnster kan ppnas

    Varje fnster kan konfigureras med egna tecken och frg

    Std fr fljande Netscape kommandon:

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

        - <BASEFONT SIZE=n>

        - <CENTER> </CENTER>

        - <NOBR> </NOBR>

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

    Std fr tabeller <FORM>-area (forms)

    Tables (<TABLE>...</TABLE>) stds.

    Bokmrken kan nu indelas i mnesomrden (teman)

    Cacheminneshanteringen har ndrats. Filerna sparas inte lngre i
     cachekatalogen med dess originalnamn. Detta fr att frhindra
     duplicering i standard TOS 8+3 filsystem.

    Popupmeny med de fregende HTML-sidorna temp sparade

    Popupmeny som visar samtliga lnkar p aktiv HTML-sida

    <IMG ...> med atttributen ALIGN=LEFT eller ALIGN=RIGHT fungerar
     nu korrekt.

    Storlekar fr teckensnitt i <Hn> </Hn>-areor ndrat, kompatibelt
     med Netscape och Mosaic.

    Skning sker nu korrekt med 92/93 c't ROM databas.

    Nytt: Verktygsmenyn under menyraden ger snabb tillgng till alla
     viktiga funktioner. Ifall en 'ledsen' smiley dyker upp efter
     knapparna s finns det en felaktighet i det inladdade HTML-
     dokumentet. CAB frsker ladda dokumentet nd och det dyker inte
     upp en glad 'smiley' ifall allt r korrekt, ty CAB slsar inte
     med resurser fr att analysera i djupet.

    Hgerjusterad format stds (ALIGN=RIGHT).

    Flertalet mindre buggfixar ;-)


12.9  V1.0a (12.12.1995)
========================

    buggfix: Dr tillgngligt, den transparenta bakgrundsfrgen fr
     bilder evaluerad.

    buggfix: I HTML-dokument strre n 32KB dr listor finns efter de
     frsta 32 KB kunde krasha.

    Piltangenterna kan anvndas fr att rulla dokumenten i fnstren.
     I listor kan piltangenterna anvndas fr att navigera runt, ven
     i indataflt.

    buggfix: Med ldre versioner av TOS evaluerades inte kataloger
     rtt.

    buggfix: Med ldre versioner av TOS var det ibland problem nr

     en fnstertitel sattes precis efter fnstret ppnades.


12.10  V1.1a (01.04.1996)
=========================

    Nr CAB anvnds offline (CAB.OVL installeras inte) sks alla
     lnkar lokalt. Ett exempel, http-adressen: http://host/path/file
     hanteras som //localhost/path/file

    Under val av c't databas, kan man numera anvnda "wildcards".
     Exempelvis, 'K:\HTML\CT*.DAT' finner alla databasfiler p
     samtliga c't CD-ROM skivor.

    Stng fnster knappen i fnstret, stnger numera fnstret,
     tidigare backade fnstret och laddade in fregende dokument.
     Fortfarande kan man backa till fregende dokument med knappen
     'backa' i verktygsmenyn.

    I 640x200 bildskrmsupplsning (ST medel) skalas bilderna i
     halvhjd, fr att ge dem rtta proportioner.

    Hller man ned <Shift>-tangenten under klickning p ett lnkord,
     s ppnas lnken i ett eget fnster. Samma gller om <Shift>-
     tangenten hlls nere nr man vljer 'OK' i dialogrutorna fr
     ppna lokal..., ppna URL... och Bokmrken, d startar dessa i
     egna fnster.

    CAB visar sjlv kllskript till HTML-dokument, om inget externt
     hjlpprogram installerats.

    CAB har expanderats till att stdja fljande Netscapemrken:

        - Med <HR> mrket kan WIDTH=, SIZE=, NOSHADE och ALIGN=
          attributen anvndas.

        - Med <TD> och <TH>, kan WIDTH= och HEIGHT= anvndas

        - 'Client Side Image Maps' std fr kartor r partiellt
          implementerat: <MAP NAME=name> <AREA SHAPE=rect
          COORDS="x1,y1,x2,y2" HREF=url> </MAP>

    Mindre optimering fr handhavandet av speciella boxade listor. I
     princip kommer formen p dessa listor att frutsttningslst att
     berknas beroende p aktiv fnsterbredd, detta medfr att de r
     resurskrvande fr systemet. Ett exempel: Websidorna fr FOCUS
     (tidigt 1996) p www.focus.de handhar en boxad lista med sju
     nstlade niver och dessa tar betydande tid att ladda (mer n fem
     minuter fr vissa sidor!). Av dessa sju niver, s anvnds tv
     vettigt (resterande innehller inget n celler med innehll av
     andra celler. (OK det m vara legalt, men det r korkat!)) CAB
     berknar sdana celler som enstaka sdana (i kolumn), vilket
     resulterar i snabbare berkningar. Mrk att funktionen inte r
     exakt utan en frbttring.

    Filtyper som CAB inte kan presentera och som inte finns
     associerade till externa hjlpprogram, kan sparas ner till
     hrddisk.

    GDOS utskrifter nu mjliga. I nulget kan endast monokroma bilder
     skrivas ut. Utskrift kan ven ske med andra GDOS- drivrutiner,
     som Metafile och IMG etc.

    Dialog fr bokmrken kan nu totalt styras med tangentbordet.

    Klippbordet, Klipp ut [Control]+X, Kopiera [Control]+C och
     Klistra in [Control]+V kommandon stds i alla dialogrutor med
     editerbara flt.

    Klippbordskommandona r ven tillgngliga i editerbara flt i
     dokument.

    Fnsterposition kan sparas under 'Spara Instllningar' i
     Alternativmenyn.

    Std fr nya (HTML3) kommandon:

        - <BIG>, </BIG> stor text

        - <SMALL>, </SMALL> liten text

        - <SUP>, </SUP> Superscript

        - <SUB>, </SUB> Subscript

        - <Q>, </Q>, <LANG>, </LANG>

    Bokmrken kan nu skapas helt och hllet manuellt.

    buggfix: HTML filer med exeptionellt lnga kommentarer i brjan
     och som inte har filtypen .HTM (eller .html p system med std
     fr lnga filnamn) visades som ASCII.

    Buggfix: Listor med mnga rader och/eller kolumner skapade
     problem.

    nnu mer tolerans inbyggt fr att mta HTML-konstruktrer som
     skapar komplexa HTML-syntaxdokument, trots att enkla HTML-
     kommandon redan finns :-\


12.11  V1.2a (16.04.1996)
=========================

    Utskrift i frg r nu mjligt, frutsatt att man anvnder en GDOS
     drivrutin som stdjer detta (Br fungera med NVDI v4.11).

    Std fr OLGA protokollet (CAB r en OLGA klient)

    Riktig upplsning i punkter (med tabeller och <HR>) konverteras
     nu fr gllande skrivarupplsning.

    Buggfix: Nr cacheminnet fr reserverat internminne i CAB brjar
     tryta, s kunde en ndls loop intrda pga en felaktig utrkning,
     som skulle ta bort bilder som inte anvnds frekvent.

    Frsta frsket med att stdja JPEG/JFIF-bilder, filen
     CAB_JPEG.OVL tar hand om dessa och skall ligga i samma katalog
     som CAB.APP. Mrk att: CAB.OVL behvs fortfarande fr std av att
     i realtid anvnda WWW p Internet.


12.12  V1.2b (19.04.1996)
=========================

    Vrdet fr sidmarginaler skedde inte tillfrlitligt, d det inte
     angavs med tre tecken.

    Buggfix: CAB frsker tillrttastlla tabeller om <TR> saknas,
     (fungerar om det finns ett </TR>). Pga en bugg i CAB, s ledde
     tyvrr detta till fel i nstlade tabeller. Skall nu fungera.

    Frgutskrifter med NVDI 4 skall nu fungera.

    Om valet "Anvnd dokumentinstllningar" inte r satt, s laddades
     inte bakgundsbilder in. Detta har nu gjorts oberoende val.


12.13  V1.3 (20.05.1996)
========================

    Ny JPEG-modul frn Dieter Fiebelkorn.

    Std fr elektronisk post (mailto:anvndare.adress)

    Proxy och SMTP-Server kan stllas in direkt frn CAB.

    Ngra ytterligare buggfixar tgrdade.

    Icke igenknnbara typer avlgsnade, exempelvis JavaScript
     (<SCRIPT>...</SCRIPT> ignoreras och visas inte lngre som HTML-
     text.

    'Bildspel' via <meta http-equiv="Refresh" content0"5; url=xyz">
     stds.

    HTML-koden <FONT> stdjer frg (<FONT COLOR=...>)

    Frger i tabeller stds: BGCOLOR= fr tabeller och/eller
     fltbagrund BORDERCOLOR=, BORDERCOLORLIGHT= och BORDERCOLORDARK=
     fr kantlinjer.

    Den viktigaste frgen kan nu associeras till namnet, som dess
     hexadecimala tal. Exempelvis COLOR=white istllet fr
     COLOR=#FFFFFF

    Referenser kan vljas under textformateringen (pekdonet kan dock
     inte anvndas under nedladdning av bild). Formateringen ignoreras
     och det valda dokumentet laddas in.


12.14  V1.4 (19.09.1996)
========================

    Anvndning av NVDI 4 fr utskrifter krver mindre internminne i
     och med att NVDI 4 har ftt uppgiften att skala bilder. Framfr
     allt i TrueColor med halvtonsskrivare (32 bit/punkt). Tyvrr ger
     inga andra systemprogram med GDOS samma mjlighet, NVDI 4 r att
     fredra.

    CAB stdjer numera samma frgtextbeskrivning, som Netscape och MS
     Explorer.

    Stoppknapp r implementerad, s att textformattering kan avbrytas
     med ett musklick. (motsvarar ett tryck p [ESC])

    Under bildmonteringen, s knner CAB av AES-kall. Det innebr att
     det r mjligt att blddra i dokument, vlja lnkar och avbryta
     processen under sjlva bildmonteringen.

    Klltexten visas nu med alla HTML-kommandon och kommentarer
     markerat. (HTML-kommandon i bl stil och kommentarer med rd)

    Vad gller Netscape 'Frames', s brukar normalt Webblddrare
     ignorera kommandon som den inte kan presentera, Detta gller
     tyvrr inte fr Netscapes 'Frames'. S blddrare som inte stdjer
     dessa frlorar dokumentinformation. CAB stdjer nnu inte
     Netscapes 'Frames', men presenterar en lista ver alla dokument i
     en 'Frame', som ger access i 'Frame'-innehllet.

    De externa filerna och modulerna, som laddas av CAB kan valbart
     lagras i en MODULES-katalog lokaliserad som underkatalog till CAB
     eller finnas i samma katalog som CAB.APP. Fljande filer berrs:

        - CAB_JPEG.OVL (denna fil kan ocks dpas om till JPEG.OVL)

        - CAB.INF

        - CAB.OVL

        - CACHE_ED.PRG och CACHE_ED.RSC (program som hanterar WWW
          fickminnen)

        - HOTLIST.HTML

    Bilder med attributen WIDTH= och HEIGHT= satta laddas in efter
     textformateringen. Detta innebr att text laddas snabbare. Bilder
     utan WIDTH= och HEIGHT= attributen mste laddas ner med en gng,
     ty det finns inga mjligheter fr CAB (eller ngon annan
     blddrare) att veta hur stor bilden r.

    Buggfix: CAB kunde inte ladda lnga filnamn innehllande
     blanktecken, som skickas via VA_START eller Drag&Drop, detta
     fungerar igen.

    Nya kommandon:

        - <DIV> </DIV>

        - <IMAGE> (ytterligare ett Netscapekommando, identisk med
          <IMG>)

    'about:'-Protocol

    Strukturen p dokumentorganiseringen vad gller cache r
     frndrad. Datafilerna sparas numera i underkataloger, detta fr
     att frhindra verfulla kataloger och minimera tkomsttiden fr
     att ladda och spara bilder. Vid lsning av ett ldre cache CAB
     format, uppdaterar CAB automatiskt den nya filstrukturen med
     underkataloger - Detta kan ta lite tid (men r en
     engngsfreteelse).

    CAB-Protokoll: Std fr ytterligare ngra AES meddelanden fr
     kall av olika CAB funktioner frn externa program har blivit
     implementerade. En 'BROWSER' miljvariabel innehllande
     fullstndig skvg till CAB. Program, som vill ta del av CAB
     funktioner kan anvnda denna fr att lokalisera/starta CAB.

    In tables ALIGN=LEFT and ALIGN=RIGHT are evaluated.


12.15  V1.41a (01.10.1996)
==========================

    Buggfix: Vissa frger var inte korrekt utfrda vid utskrift via
     en TrueColor skrivardrivrutin.


12.16  V1.5 (20.10.1996)
========================

    Buggfix: CAB anvnde av misstag den globala frgpaletten fr GIF
     filer vilken inkluderade lokala frgpaletter.

    Std fr animerad GIF. Animationer kan stannas nr man vill med
     anvndning av Stopp-knappen.

    GIF animationer kan stngas av i 'Alternativ/Visa...'. Detta
     sparar bde minnes- och systemresurser, d endast den frsta
     bilden i en animerad GIF avlses och ditreras. Bilder nedladdade
     i cacheminnet behlls intakta och presenteras, som stillbilder om
     funktionen r avstngd.

    CAB presenterar nu destination av lnkar i fnsterinformationen
     under muspekaren - vilken ndras till en pekande hand. Det r nu
     inte lngre ndvndigt att hgerklicka fr att f fram
     destination av lnkar.

    Buggfix: Om en ny cachekatalog vljes, utan att en CACHE.CAB-fil
     skapats, s initierades ibland inte katalogen korrekt.

    Buggfix: Sista delen i en lista under <CENTER> presenterades inte
     korrekt.

    Nya versioner av CAB.OVL installerar sig sjlva, ven om STiK
     inte r aktiverad. Detta resulterade i 'Ntverket nere'
     meddelanden nr STiK var off-line. CAB.OVL anvnds nu endast om
     STiK rapporterar 'On-line'-status.

    Nytt dialogfnster 'Alternativ/Internetprogram...'. Hr kan olika
     program med skiftande Internetprotokoll initieras. I fall dr URL
     kallar p dessa protokoll, s startas tillhrande program (om
     dessa accepterar URL, som parameter). Alla protokoll stds (inte
     nnu) i CAB.OVL och fr vilka passande program finns, s kan de
     anvndas via CAB. Angivna program i detta dialogfnster har
     prioritering ver CAB.OVL.

    Ny funktion fr 'Binrfil' har implementerats till dialogfnstret
     'Alternativ/Hjlpprogram...'. Filtyper, som skall handskas som
     binrfiler kan anges. Binrfiler, som inte har program
     associerade, kan via filvljaren kopieras till diskenhet och CAB
     kommer inte att frska presentera dem. Denna funktion r endast
     avsedd fr icke-ASCII filformat, inklusive UUE-kodade filer, Mac
     BinHex filer etc. Sdana filtyper br anges i funktionen. CAB
     knner igen 'riktiga' binrfiler, s dessa skall inte anges i
     detta sammanhang.

    Ikonerna i knappsatsen kan sls p/av genom klickning p den
     lilla triangeln, hger om stoppknappen. Att inte presentera
     ikonerna ger mer utymme i presentationsfnstret.



