                          La documentacin de

                                 CAB

                             Versin 1.4
                              19.09.1996

                                  por

                           Alexander Clauss
                         Stresemannstrae 44
                          D-64297 Darmstadt

                aclauss@rbg.informatik.th-darmstadt.de



Contenidos
==========

 1 Una pequea introduccin

 2 Legal

 3 Direcciones

 4 Requerimientos de sistema

 5 Instalacin

 6 Navegando por documentos HTML

 7 Mdulo para acceso Internet en-line 

 8 Descripcin de los tems del men
   8.1 Abrir URL...
   8.2 Abrir local...
   8.3 Recargar
   8.4 Imprimir
   8.5 Nueva ventana
   8.6 Cerrar ventana
   8.7 Ver origen
   8.8 Salir
   8.9 Pgina origen
   8.10 Atrs
   8.11 Encontrar clave
   8.12 Hotlist
   8.13 Documento -> Hotlist
   8.14 Opciones generales
   8.15 Mostrar
   8.16 Seleccin de fuente
   8.17 Visores externos
   8.18 Rutas...
   8.19 Cach
   8.20 Grabar opciones

 9 Barra de botones

10 Agradecimientos

11 Posibles mejoras futuras

12 Historia
   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.2 (10.04.1996)
   12.12  V1.2a (16.04.1996)
   12.13  V1.2b (19.04.1996)
   12.14  V1.3 (20.05.1996)
   12.15  V1.4 (19.09.1996)


1 Una pequea introduccin
==========================

*CAB* - taxi a las autopistas de informacin
*CAB* - Crystal Atari Browser

Comunmente llamado HTML-Browser

Este browser es capaz de leer documentos en formato HTML. El documento
HTML puede estar en disco o en CD. Leer paginas on-line de un servidor
World Wide Web (WWW) requiere un mdulo separado.



2 Legal
=======

CAB (HTML-Browser) es FREEWARE. Puede ser  copiado y usado libremente.
Est permitidas la distribucin por BBSs y librerias de dominio pbli-
co.  De  cualquier  forma  CAB (HTML-Browser) NO  puede  bajo  NINGUNA 
circunstancia ser incluido en colecciones CD o en discos de portada de
revista sin mi permiso por escrito. CAB (HTML-Browser) y su documenta-
cin  debe  de  permanecer  junta y  completa con todos los ficheros y
documentacin. Estn  prohibidos los  cambios  en  el programa y en su
documentacin.

Si  te  gusta  CAB  (HTML-Browser)  y lo usas  regularmente, por favor
registra tu copia, cualquier tipo de comercio es bienvenido.

Una ojeada al nmero de serie de la versin te informar que este pro-
grama  est en  un estadio de  desarrollo primario, as que si quieres
ver  este programa  desarrollado envia tu soporte y registra tu copia.
Los usuarios de UK y USA pueden hacer uso de las ventajas de su sopor-
te local,  mirar  SUPPORT.TXT para  mas detalles. Si no hay soporte no
hay desarrollo, es as de simple.



3 Direcciones
=============

*Mi direccin:*
Alexander Clauss
Stresemannstr. 44
D-64297 Darmstadt
Alemania

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

*Datos bancarios:*

    Sparkasse Darmstadt
    BLZ: 508 501 50
    Kontonr: 0115032143

*Soporte UK:*
Joe Connor
65 Mill Road
Colchester
CO4 5LJ
Reino Unido

    email: jconnor@cix.compulink.co.uk

*soporte Francia:*

Jouffrey Romuald
1 chemin de l'glise
38100 GRENOBLE
      FRANCIA
      
    email: rom38@gen4.pressimage.fr
    


4 Requerimientos de sistema
===========================

El  programa funciona en cualquier computadora usando el sitema opera-
tivo  TOS (Atari-) con 1Mb o mas de memoria. Los requisitos de memoria
para las imagenes depende de la profundidad de color. Contra ms  pro-
fundidad de color quieras ms memoria necesitaras. Usando  una tarjeta
de  grficos  a color  real (24  o 32  bit)  aumenta drsticamente los
requisitos de memoria haciendo que el uso de memoria sea  muy superior
a 1Mb.

CAB es independiente de la resolucin con dos limitaciones: en 320x200
(ST-baja)  no todos los dilogos pueden entrar en pantalla, en 640x200
(ST-media)  el  mostrado  de pantalla esta  distorsionado (un octavo).
Consequentemente recomendamos el uso de CAB en resoluciones de 640x400
(ST-alta) o superiores  con cualquier  nmero de  colores, un  entorno
multitarea (ej.: MagiC, Geneva, etc...) es muy deseable.

Aunque no es absolutamente necesario el uso de fuentes vectoriales va
NVDI v3.x o SpeedoGDOS  este  es recomendable. El  sistema  de fuentes
bitmap GDOS puede ser usado si es requerido.



5 Instalacin
=============

*Atencin:*

    Desde la v1.0 el programa no puede ser ms instalado como un acce-
    sorio del Desktop.

    Los  ficheros de  configuracin de  versiones anteriores de CAB no
    pueden ser usados (CAB.INF). Desafortunadamente tendrs que  rese-
    tear manualmente tus parmetros.

    El formato del fichero Hotlist tambin ha sido alterada pero  aun-
    que  un  fichero  en  el  nuevo  formato est disponible, el viejo
    fichero Hotlist (CAB.HOT) es cargado. El nuevo  fichero Hotlist es
    llamado  hotlist.html. Tan  pronto  como  el Hotlist es grabado al
    nuevo formato el viejo fichero (CAB.HOT) puede ser eliminado.

Los  ficheros HTML sacados de servidores  WWW amenudo incluyen nombres
de ficheros largos  que pueden  resultar fcilmente  de la duplicacin
del  sistema bsico de ficheros del TOS de formato 8+3. Ser una buena
idea preparar  una particin Minix en el disco duro u otro sistema que
soporte nombres de ficheros largos.

La  distribucin CAB  est suministrada para funcionar una vez descom-
primido en tu disco de trabajo, pero todava debers revisar los par-
metros en el men Opciones y configurar las opciones segn tus necesi-
dades.



6 Navegando por documentos HTML
===============================

Cliquea en cualquier letra  subrayada para cambiar a una nueva pgina.
Pulsa la tecla [Undo] para volver al paso anterior de la pgina.  Cli-
quea en la  unin  con  el  botn  derecho  del  ratn para mostrar la
direccin a la que est unida la pgina.



7 Mdulo para acceso Internet en-lnea 
======================================

Para  hojear en-lnea  pginas WWW en Internet un mdulo  posterior es
necesario (CAB.OVL). Este mdulo debera ser copiado al mismo directo-
rio  que  CAB.APP.  Este  fichero  contiene  las  rutinas  adicionales
necesarias para acceder a Internet.

En  particiones  Minix  la  bandera-x  del fichero CAB.OVL debe de ser
activada de otra forma el mdulo no puede ser arrancado.

No me ha sido posible probar un mdulo Internet pero he creado  un in-
terface  en  CAB  (HTML-Browser)  para  permitir a cualquiera capaz de
programar  esas rutinas  para crear un mdulo en-lnea. La descripcin
de este interface est disponible cuando esta es pedida, y esta  tanto
en  C  comentado como en  Pascal. Me gustara conocer a cualquiera que
programe un mdulo en-lnea y le gustase copiarlo  y distribuirlo  con
CAB (HTML-Browser)...



8 Descripcin de los tems del men
===================================


8.1 Abrir URL...
----------------

La  opcin *Abrir URL...* en  el men *Fichero* muestra el dilogo URL
conteniendo  cualquier direccin  URL (Universak Resource Locator) que
hayas definido al acceder al WWW.


8.2 Abrir local...
------------------

La opcin *Abrir local* en el men *Fichero* llama  al selector de fi-
cheros el cual puede ser usado para abrir cualquier documento HTML del
disco duro o del CD-ROM.

Puede  ser seleccionado cualquier  tipo de fichero. Los ficheros HTML,
XBM y GIF son mostrados normalmento con CAB (HTML-Browser)  con  otros
tipos  de ficheros  soportados por programas externos. Ir a *Programas
externos* para ms detalles.

Si una  carpeta est seleccionada, el contenido de la carpeta y subdi-
rectorios  son mostrados  de forma grfica como una pgima HTML  y los
ficheros y carpetas pueden ser seleccionados usando el ratn.


8.3 Recargar
------------

Recarga  la pgina HTML  de nuevo. Esta funcin es til (en un entorno
multitarea) para editar las pginas HTML en un editor con CAB en para-
lelo para mostrar las pginas.

Si la pgina originda desde el WWW usando *Recargar* traer la  pgina
de  nuevo desde  el WWW,  incluso si  hay una  copia disponible  en el 
cache.


8.4 Imprimir
------------

Si GDOS  est disponible  el documento  en la ventana activa puede ser
imprimido.  Las  fuentes bitmap  requieren tanto fuentes para pantalla
como para impresora y para cada tamao, sin embargo las fuentes vecto-
riales  bajo NVDI 3.x o SpeedoGDOS son automticamente escaladas segn
tu quieras.

Los   mrgenes pueden  ser  establecidos  desde  el  dilogo. Estos se
aaden a  cualquier margen preestablecido,  tanto de la impresora como
de  la propia  fuente. Un men  deslizante ofrece una  seleccin entre
cualquier dispositivo GDOS instalado y va tan lejos como el dispositi-
vo permite, GEM Metafile (*.GEM) o imagen de bits (*.IMG).

El xito  en la salida de imagenes depende del soporte de la impresora
de  una funcin  VDI concreta  la cual puede estar o no incluida en el
dispositivo  activo. Recomendamos que intentes imprimir con las imge-
nes  activas  y  si no  funciona,  simplemente desactiva esa opcin de
impresin. Si estas usando una impresora matricial activa la opcin de
imgenes claras de otra forma las imgenes sern demasiado oscuras.


8.5 Nueva ventana
-----------------

Abre  una nueva  ventana mostrando el contenido de la ventana superior
previa.


8.6 Cerrar ventana
------------------

Cierra la ventana.


8.7 Ver origen
--------------

Muestra el texto origen del documentp HTML  mostrado. Mirar tambin la
opcin *Programas externos* del men de opciones.


8.8 Salir
---------

Sale del programa.


8.9 Pgina origen
-----------------

Esta opcin del men muestra la pgina origen, si est disponible.

CAB intenta cargar, directamente, la pgina origen. Cualquiera que en-
tienda  la sintaxis  HTML puede, fcilmente, preparar cualquier pgina
como referencia a otros documentos HTML. El fichero usado como la  p-
gina origen puede ser definido en el dilogo *Opciones generales*.


8.10 Atrs
---------

Muestra el documento anterior.


8.11 Encontrar clave
--------------------

Esto  permite al  usuario hacer una  bsqueda de conceptos o claves en
ficheros HTML, pudiendo ser, opcionalmente, sensible a las maysculas.
La  bsqueda puede  ser dirigida sobre uno de los siguientes rangos de
documento.

  1. Slo documento actual. El texto es buscado en el documento actual
     (ventana superior). Si  el texto es encontrado en la ventana esta
     es desplazada hasta que el texto es mostrado en pantalla.

  2. Documentos HTML locales. El texto es buscado por todos los  docu-
     mentos HTML locales contenidos en la ruta especificada en la caja
     de dilogos *Rutas* (y en sus directorios). Los ficheros que con-
     tienen  el texto  son puestos  en  una  lista  en un fichero HTML
     llamado result.html.

     Por el  momento los ficheros  HTML buscados por el mtodo dos son
     buscados,  exclusivamente, como texto,  as que texto oculto como
     comentarios, comandos HTML, uniones y similares tambin sern en-
     contradas. Procesar  los ficheros  para  ignorar el  texto oculto
     tomara mucho tiempo. Esto tambin significa que caracteres espe-
     ciales como  acentos y  similares que  se escriben usando cdigos
     HTML  como &auml; no  sern encontrados. Esta pequea pega espera
     ser subsanada en una versin futura.

     Otro truco: Si ests buscando algo que amenudo es usado en cdigo
     HTML como comando o direccin URL colocando un espacio antes pue-
     de hacer ms difcil su semejanza con un comando o direccin URL.

     Por  ejemplo:  Buscar  el  texto  'WWW' a menudo  coincidir  con
     subdirectorios y direcciones de pginas de la forma '.../WWW/foo.
     html...'.  Colocando  un  espacio  antes la  cadena a buscar ser
     ' WWW' eliminando estas coincidencias anteriores y resultando una
     bsqueda mejor. Esto no es til para los mtodos 1) y 3)

  3. En las bases de datos c't-CDROM. Esta opcin slo es til para la
     gente con el c't-CDROM (el 1994, o 92/93, de las revistas  c't en
     formato HTML)

     En este caso los ficheros propiamente HTML no son buscados,  pero
     en  su  lugar  se  accede  al  fichero  indice  del  CD.  As que
     HTML-Browser conoce dnde estn los ficheros de ese CD, debes  de
     rellenar de forma apropiada la seccin *Rutas* de la caja de dia-
     logo - el  documento  HTML (en \HTML  el cual tambin contiene el
     fichero   DEFAULT.HTML)   y   el   ndice   de   bases  de  datos
     (\UNIX\CT94.DAT o \UNIX\CT9293.DAT). Como  en  el  mtodo previo,
     la  coincidencia  de  documentos  se  realiza  sobre el documento
     results.html que es abierto entonces.


8.12 Hotlist
------------

El hotlist es una lista con los documentos HTML ms usados. Esta lista
te  permite moverte  de una formas ms rpida a tus pginas favoritas,
sin  tener que  navegar  a travs de  una serie de pginas para llegar
all.

El hotlist est dividido en areas temticas. Usando el men de la par-
superior  de  la  ventana  de  dilogo  te ser sencillo cambiar entre
diferentes temas.

*El men 'Tema...':*

 *Cambiar tema:* Cambia el nombre de la actual area temtica. El  area
    /Miscellaneous/ no puede ser renombrada.

 *Nuevo tema:* Crea una nueva area temtica.

 *Borrar tema:* Borra la actual area temtica. El area /Miscellaneous/
    no puede ser borrada. Todas las entradas que quedan en una area  a
    ser borrada son movidas al area /Miscellaneous/.

*El men 'Nuevo tema...':*
                                                                     
Usando  esta opcin  una entrada seleccionada puede ser  movida a otra
area temtica.

*El men 'Documento...`:*

 *Borrar entrada:* Borra la entrada seleccionada.

 *Cambiar entrada:* Cambia la  entrada seleccionada. Anotaciones en la
       pgina, tambin pueden realizarse.

 *Abrir documento:* Abre un documento.

 *Aadir documento actual:* Copia el documento actual al Hotlist.

Doble click en una entrada abre el documento.

El Hotlist es  grabado en disco como un documento HTML lo cul permite
que  usuarios no familiarizados  con la sintaxis HTML tengan una forma
fcil e intuitiva de crear su propia pgina.


8.13 Documento -> Hotlist
------------------------

El  documento actual  es insertado en  el Hotlist proveido, todava no
listado. Ser colocado en el area temtica /Miscellaneous/.


8.14 Opciones generales
-----------------------

 *Pgina origen:* Despus de lanzar CAB o de seleccionar la entrada de
    men *Pgina origen* el fichero  HTML especificado  ser mostrado.
    Amenudo es til crear una pgina origen que contiene referencias a
    las  pginas HTML  ms usadas. Por  defecto  CAB intenta cargar el
    home.html como la pgina origen aunque cualquier pgina puede  ser
    definida como la pgina origen -  simplemente  introduce  su dire-
    ccin URL. Si el fichero esta localizado en el directorio  especi-
    ficado  como directorio de  comienzo  para CAB.APP  puedes  elegir
    el botn *Carpeta comienzo* y usando el botn *Bscar* seleccionar
    el fichero deseado usando el selector de ficheros.

 *Mens deslizantes:* CAB  provee  de  una  lnea de mens deslizantes
    para relevarte del tedio de la navegacin por pginas HTML.  Prin-
    cipios bsicos:

       Botn izquierdo del ratn en una referencia para bloquear a la
        pgina correspondiente.

       Botn derecho del ratn en una referencia para mostrar el des-
        tino de la referencia.

       Cliquear en el fondo de la ventana (no en una referencia) para
        mostrar los mens deslizantes.

    Puedes seleccionar que mens sern mostrados usando el botn dere-
    cho e izquierdo del ratn (pulsando y sin pulsar la tecla [Shift])
    Los siguientes mens estn disponibles:

     *Historia:* Lista los docuementos previamente mostrados.

     *Referencias:* Lista las referencias en el documento actual.

     *Men:* Lista algunos items de los mens.

 *Miscellaneous:* Durante la carga, formateo y transferencia de  datos
    de  Internet, CAB muestra  una serie de informes en una ventana de
    dilogo (si la opcin *Dilogo para mensages de estado* est acti-
    vada) de otra forma la lnea de informacin de la ventana es usada
    para ello.  La muestra en la lnea de la informacin de la ventana
    tiene  un par de  desventajas. Primero que  no se  puede abrir una
    ventana  para mostrar los errores y segundo que el dilogo muestra
    los  errores  ms claramente.  Por otro  lado  usando  la lnea de
    informacin de  la ventana  puede ser  leida y desplazada mientras
    que el texto est siendo formateado.

    El *cargar index.html automticamente* slo tiene efecto en  refe-
    rencias  locales (ejemplo: a  ficheros/directorios en tus unidades
    de disco).  Si la  referencia apunta a un directorio en una unidad
    de disco el contenido ser mostrado a menos que exista un  fichero
    index.html que  en ese caso ser cargado este fichero. El uso para
    un  index.html es el  hacer  una  pgina  conteniendo un ndice de
    todos tus documentos favoritos.


8.15 Mostrar
------------

En  este dilogo  puedes configurar varios opciones para mostrar docu-
mentos HTML.

 *Colores:*  Esta  seccin  permite  configuirar  los  colores con que
    mostrar el  documento, el  color del fondo y el de las uniones. Si
    estas usando menos de 16 colores, el color de fondo de  la ventana
    ser siempre blanco a pesar de las configuraciones. En un modo  de
    16 colores, solo  los  primeros 9 colores deberan ser usados pues
    los ltimos 7 pueden ser cambiado por los grficos, etc... En  ms
    de 16  colores,  cualquiera  de los primeros  16 colores puede ser
    usado pues no son cambiados.

    Algunos  documentos  HTML incluyen  informacin sobre  que colores
    deben ser usados por el texto, referencias y fondo de la  ventana.
    La  opcin *Uso de lneas gua* le  informa a  CAB  como usar esta
    informacin (si est disponible).

 *Uniones:* Las uniones pueden ser mostradas como subrayados y/o texto
    en negrita (esto es importante para sistemas monocromo pues no  se
    puede distinguir en ellos las uniones por colores).

 *Imgenes:* Controla la forma de mostras las imgenes.

     *No mostrar* Impide que las imgenes sean cargadas y mostradas lo
        que acelera la carga de la pgina.

     *Monocromo* Las imgenes son mostradas en monocromo usando tcni-
        cas de dithering. Es el mtodo ms rpido, pero obviamente  la
        calidad empeora.

     *Escala grises* Las  imgenes son  mostradas en escala de grises.
        Un modo de muy alta calidad a expensas de la velocidad.

     *Color*  Las  imagenes  son mostradas  en color,  dependiendo del
        hardware disponible:

          4-8 planos de bits (16-256 colores).  La  imagen  sufre  un
           dithering si el  nmero  de colores disponibles es menor al
           nmero  de  colores contenidos en la imagen. En modos de 16
           colores la escala de grises es a menudo ms recomendable.

          15/16 bit Highcolor (32768/65536 colores) ej.: Falcon en el
           modo Truecolor.

          24 o 32 bit Truecolor (16.7 millones de colores)

     *Texto en vez de imgen* El  lenguaje  HTML  tiene  soporte  para
        sistemas slo texto, permitiendo que  las imgenes vayan acom-
        paadas por  algn  texto  el  cul es  mostrado  en vez de la
        imgen.  Esto  permite  a los hojeadores  WWW  que  no  pueden
        mostrar imgenes mostrar en su lugar texto. Si la opcin  est
        disponible (cruzada) slo las imgenes por las que no hay  al-
        ternativa en texto son mostradas como imgenes.

 *Ancho texto:* El  texto puede  ser tanto formateado a una ancho fijo
    como justificado  para abarcar el  ancho  de  la ventana. El texto
    ajustado a  la ventana  se ve mejor pero tarda ms en ser mostrado
    pues debe ser reformateado.


8.16 Seleccin de fuente
------------------------

Dnde sea  posible CAB (HTML-Browser) usa diferentes fuentes y tamaos
de  fuente  para mostrar  los ficheros  HTML. La ms ptima calidad de
salida es con fuentes de tipo vectorial para las que necesitars  ins-
talar  NVDI  v3.x  o SpeedoGDOS.  Las fuentes bitmap pueden ser usadas
pero no son tan bonitas.

Luego  necesitas decirle  a  CAB (HTML-Browser) que fuente (GDOS) ser
usada para  cada  estilo en el documento HTML. Las fuentes vectoriales
suministradas con  SpeedoGDOS o NVDI 3.x son recomendadas. Debes espe-
cificar  tres  fuentes  (sans serif, serif y  monoespaciada) en cuatro
diferentes  estilos  (normal, negrita,  itlica  y  negrita e itlica)
haciendo, realemente, doce selecciones.

Para establecer la negrita e itlica deberas usas una negrito  o it-
lica 'reales' siempre que sea posible. Si no tienes ninguna disponible
debers  simular  estos efectos  usando  los correspondientes  botones
adyacentes  al men  deslizante de  seleccin. Si estas usando fuentes
vectoriales  entonces  usa  la apropiada fuente de la familia, si est
disponible.

Algunos  comandos como son <PRE>...</PRE>, <FORM>...</FORM> etc causa-
rn problemas a la hora de mostrar en pantalla fuentes proporcionales.
Para  evitar este problema solo usa fuentes *no proporcional*  para el
texto *preformateado*.

El  fichero INF suministrado  tiene los siguientes valores por defecto
(para NVDI 3.x):

 *Headings:* Swiss 721 (normal, bold, italic, bold+italic)

 *Normal text:* Dutch 801 (normal, bold, italic, bold+italic)

 *Formatted:* Letter Gothic 12 Pitch (normal, bold, italic,
    bold+italic)

Si no  te gustan o no tienes estas fuentes, debers seleccionar alter-
nativas.

El  tamao  del  cuerpo  del  texto  tambin puede ser alterado. No lo
hagas  demasiado  grande  o pequeo.  Cualquier valor entre 10 y 13 es
cmodo y adecuado, de hecho yo uso 12 puntos.

Si no tienes acceso a fuentes vectoriales (ej.: no tienes una copia de
NVDI 3.x o del SpeedoGDOS) entonces el tamao  del punto no  cambiar,
pero el texto puede ser mostrado todava usando el sistema de fuentes,
habitualmente de 10 puntos.


8.17 Visores externos
---------------------

Si hay una  unin en un punto de un documento HTML a un fichero que no
est en formato HTML, entonces se ejecuta un visor externo. Estos pro-
gramas pueden  ser llamados de una de las dos formas configurables va
el dilogo *Programas externos...* del men *Opciones*.

Se pueden asignar tipos de ficheros individuales  a diferentes progra-
mas.  Las  extensiones  de  los  ficheros  se  introducen  en el campo
*Ficheros*. Varias extensiones pueden ser introducidas usando una coma
para separarlas.

Los programas  son seleccionados  cliquenado en la caja de seleccin a
la derecha  del  campo *Ficheros*  que muestra en selector de ficheros
para seleccionar el visor deseado.

Finalmente  cada  entrada  incluye  un  *Soporta VA_START* que debe de
estar cruzada si el visor entiende los mensajes VA_START as  que  CAB
puede enviar un mensaje VA_START al visor con lo que el fichero  puede
ser visionado con el relanzamiento del visor.

El  programa  *Por defecto*  (*.*)  es  llamado para mostrar cualquier
fichero que no tenga asignado ningn programa.

Si  una  o ms extensiones han sido definidas sin un programa asignado
CAB intentar mostrar el fichero. Esto slo es til para *.gif, *.xbm,
*.htm y ficheros ASCII (por ejemplo: *.txt, *.doc,  *.c, *.pas, *.tex,
etc...)  para  los cuales CAB (HTML Browers) incluye unas rutinas para
mostrarlos.  Usando  CAB (HTML Browser) para  estos tipos  de ficheros
permite mantener al mnimo el nmero de visores externos.

La pgina HTML  actual puede ser mostrada como  texto origen seleccio-
nando  la entrada *Origen*. Esta  aplicacin es llamada va la entrada
de  men  *Ver origen...*. Si  no  hay  aplicaciones  asignadas  en el
programa *Por defecto* se llamar en ese caso al programa.

Doble  pulsacin  en  la  caja *ruta programa* abre un dilogo con una
opcin a borrar la actual ruta.

Algunos programas externos sugeridos:

 *.text,txt:     ST-Guide,  1st-Guide  (o  ninguno,  entonces  se  usa
                 HTML.APP)

 *.mpeg,mpg,mpe: 1st-Guide (en un Falcon bajo TOS  simple el ms rpi-
 		 do reproductor MPEG que use el DSP es recomendable)

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

 *.tiff,tif:     GEMview, Imagecopy

 *.gif,xbm:      GEMview,  Imagecopy  (o   ninguno, entonces   se  usa
 		 HTML.APP)

 *.dvi:          DVI display, incluido en archivos TeX

 *.* (por defecto):  GEMview (u  otro  programa que  soporte el mximo
		     nmero posible de formatos)

 *.html,htm:     ST-Guide, 1st-Guide, (o un editor as se puede editar 
		 el fuente HTML)


8.18 Rutas...
-------------

Si  tienes una  copia del c't ROM '94 (o 92/93) (CD  que  contiene  la
revista  alemana c't)  entonces  prepara  una  ruta para  el campo c't
CDROM.

En el campo *Carpeta HTML* activa el directorio que contenga el fiche-
ro  DEFAULT.HTM en  el CD (ej.: ?:\HTML\, donde ? es sustituido por el
nombre  del  dispositivo CD-ROM). En  el campo *Base de datos*  pon la
ruta al  contenido del  CD (?:\UNIX\CT94.DAT o ?:\UNIX\CT92.93.DAT, de
nuevo ? es el nombre del dispositivo CD-ROM).

Si quieres usar  CAB en lnea en un servidor WWW de Internet, deberas
establecer  la *Carpeta cach* dnde  todos los ficheros sern bajados
de Internet y pueden ser almacenados. Lo ideal es que esa carpeta est
en  una  particin  Minix  del  disco duro, u otro sistema que soporte
nombres de ficheros largos para soportar ficheros HTML pues los fiche-
ros  HTML bajados de Inernet a menudo tienen nombres largos los cuales
resultan facilmente de la duplicacin del nombre del fichero usando el
tradicional  formato TOS de 8+3 caracteres, y asegrate  que la parti-
cin tiene bastante espacio.

En  las *Carpetas HTML* puedes  introducir las rutas dnde CAB buscar
los ficheros HTML.

Los   ficheros   HTML   contienen   rutas   absolutas   locales  (ej.:
/path/file.html) las cuales pronto volvern el directorio principal de
la  particin en el caos. Las carpetas HTML ayudan a prevenir esto di-
ciendoles  al  Browser HTML que mire los ficheros HTML en las carpetas
especificadas.

Aqui hay un ejemplo:

 *Introduce las carpetas HTML:*

       F:\HTML.DOC\

       G:\VARIOUS\

 *Unidad de disco actual:* F:\

 *Ruta en fichero HTML:*

       /example/text/index.html

 *Dnde busca CAB:*

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

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

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

Doble  pulsacin en  la caja *rutas programas* abre un dilogo con una
opcin para borrar la ruta actual.


8.19 Cach
----------

CAB  (HTML-Browser)  usa dos  cachs para  maximizar la muestra de los
ficheros.

El *Cach imagen* es  usado para prevenir repetidas  descompresiones y
ditherings los cuales son procesos que toman mucho tiempo del procesa-
dor. Las imagenes  que no  se van a mostrar son almacenadas en memoria
(RAM)  para ser  usadas si son requeridas de nuevo. Evidentemento esto
consume memoria as que el mximo tamao del cach podr  ser estable-
cido en el campo *Tamao mximo*. Si el cach se llena la imagen menos
usada  es eliminada del cach  para liberar  espacio. Usando la opcin
*Mantener libre* tambin  es posible  dejar un mnimo de memoria libre
para  otros programas. El cach  tambin puede ser vaciado manualmente
usando  el botn *Liberar cach* que  puede  ser muy til para liberar
memoria de forma rpida para otra aplicacin cuando ests en un siste-
ma  operativo  multitarea. El  cach permanece  vacio hasta que nuevas
imgenes sean mostradas en CAB (HTML-Browser).

*Atencin*

    La actual consumicin de memoria por el Cach puede ser superior
    al introducido en el dilogo.

El *Cache Internet*  es  usado  para  almacenar  ficheros  bajados  de
Inernet a tu disco permitiendo, repetidamente, la bajada de los mismos
ficheros  de  Internet  si  son  vistos  ms  de  una vez. Ver tambin
*Rutas*.

Las  opciones  *Tamao mximo*  y  *Mantener libre* limitan el espacio
total  disponible  en el disco usado por el cach y CAB (HTML-Browser)
liberar  los  ficheros ms  viejos del cach, manteniendo el cach en
los lmites definidos.

Si la opcin *Borrar despus 'salir'* est activa (cruzada) los fiche-
ros  en el  cach sern borrados al salir de CAB (HTML-Browser). Natu-
ralmente  a no ser  que el  espacio del disco sea muy limitado o ests
seguro  que los  ficheros no  los vas a necesitar sera mejor mantener
los ficheros.

El  botn *Liberar cach* es  para  uso de  emergencia, en el caso que
necesites espacio libre de  forma rpida. Slo  los ficheros colocados
en el directorio cach por CAB (HTML-Browser) sern borrados.


8.20 Grabar opciones
--------------------

Almacena la actual configuracin.



9 Barra de botones
==================

Cada ventana CAB contiene una barra de botones la  cul permite de una
forma sencilla acceder a algunas funciones importantes:

 *Atrs* Muestra el documento anterior.

 *Origen* Muestra la pgina origen.

 *URL* Selecciona un documento de una direccin URL.

 *Fichero* Selecciona un fichero usando el selector de ficheros.

 *Fuente* Muestra el  texto fuente  del documento que actualmente est
          siendo mostrado.

 *Nuevo* Recarga el documento actual de nuevo.

 *Hotlist* Muestra el dilogo hotlist.

Si aparece  un smiley  triste en  la parte  derecha de los botones eso
significa que el  documento mostrado  ha fallado de alguna forma. Para
saber  cual  ha sido  el problema  cliquea  en el  smiley. Esta es una
opcin particularmente til cuando alguien usa CAB como autor de pgi-
nas HTML. Solo los errores que CAB pueda determinar sin desperdicio de
espacio de disco o de tiempo de proceso sern mostrados.

Documentos incompletos no son, necesariamente, mostrados de una manera
incorrecta  por  CAB pero pueden ser exhibidos con problemas con otros
programas 'browsers' (ej.: Mosaic, Netsacape, WebExplorer, etc...) que
puede que no muestren el documento como tu quieres.



10 Agradecimientos
==================

Quiero agradecer  a todos  aquellos que  me dieron su animo, crticas,
sugerencias e informe de errores los cuales me ayudaron  al desarrollo
de CAB (HTML-Browser). En particular quiero mencionar a las siguientes
personas:

    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
   
    Jeff Wisniewski
   
    Lodovico Zanier


11 Posibles mejoras futuras
===========================

    Futura implementacin de comandos HTML3

    Carga de imagen (Doble click en [IMG] del texto)

    ...

Por favor, siente libre de enviarme cualquier  tipo de sugerencia y de
critica constructiva...



12 Historia
===========

12.1  V0.8 (20.04.1995)
------------------------

       Primera versin publicada

12.2  V0.9 (15.05.1995)
------------------------

       Reducidos los requisitos de memoria

       Soportado (ARGS) arrastrar y tirar de MTOS 

       Programas externos funcionan bajo una TOS simple

       Mensajes de error ms descriptivos
                                                                      
       Fijado error: cuando funciona como accesorio no volver  a in-
        tentar invertir tems de men (no existentes)

       El fichero .INF es encontrado incluso si el HTML no ha empeza-
        do en el directorio propio

       Ahora hay una ms tolerable sintaxis de errores en  el fichero
        HTML

       home.html se carga al principio si es posible

       Hotlist

       Configuracin de ventanas y colores de texto

       Bsquedas (incluidas bsquedas en CDROM c't)

       Imgenes en documento pueden ser mostradas en escala de grises

12.3  V0.93 (07.06.1995)
-------------------------

       Preparacin  para  operacin  on-line  implementada (aunque no
        activa en esta versin)

       Fijado error: Problema con el espaciado de lneas corregido

       Fijado error: Final de bucle con gifs defectuosos corregido

       Fijado error: fue olvidado fclose() para Hotlist :-(

       Otros errores menores tambin fueron corregidos

12.4  V0.94 (07.07.1995)
-------------------------

       Fijado error: borrado de  la ltima entrada  del hotlist haca
        que la mquina se colgase :-(

       Fijado error: CR/LF dentro de marcadores conducin a problemas

       Fijado error:  La  ltima  palabra  en  un  fichero  HTML  era
        engullida

       Acceso a documentos usando informacin de rutas absolutas, in-
        cluyendo directorios listados en el dilogo 'Rutas...'

       El contenido de una unidad puede ser mostrado como un documen-
        to HTML (incluido programas de lanzamiento y programas para el
        visonado de ficheros)

       Soporte para marcadores especiales Netscape <CENTER> 

12.5  V0.95 (04.08.1995)
-------------------------

       Imgenes a color en el documento

       Cach de imagen configurable (en RAM)

       Cach WWW configurable (en disco)

       Opcin para automticamente formatear  el texto en el ancho de
        la ventana

       Los  ficheros ASCII, xbm y gif  pueden ser visionados directa-
        mente en HTML-Browser. La llamada  a programas  externos ya no
        es  necesaria (pero, evidentemente, todava  sigue activa esta
        opcin)

       Implementado  interface  para  'Mdulo internet'   usando   el
        adecuado mdulo HTML-Browser puede ser  usado para mostrar p-
        ginas  WWW directamente  de Internet, naturalmente necesitars
        tener una cuenta Internet para hacer esto.

       Soporte para imgenes xbm

12.6  V0.96 (22.08.1995)
-------------------------

       Un montn de pequeos errores fijados

12.7  V0.98 (03.10.1995)
-------------------------

       En resoluciones  a color con menos  de 16 colores la paleta de
        color no se ve alterada

       Los ficheros con longitud cero no volvern a causar problemas

       El programa ahora se llama:
        CAB - El Taxi a la autopista de informacin!
        CAB = Crystal Atari Browser

12.8  V1.0 (01.11.1995)
-----------------------

       Algunos  ajustes  menores  para acomodar  la visin en 3D bajo
        Geneva edicin 4 (desafortunadamente Geneva no es  enteramente
        compatible MultiTOS)

       Se pueden abrir multiples abre ventanas

       Cada  ventana puede  ser configurada  individualemente  con su
        propio color y fuente

       Soporte para los siguientes marcadores Netscape (comandos):

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

         - <BASEFONT SIZE=n>

         - <CENTER> </CENTER>

         - <NOBR> </NOBR>

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

       Soporte para el <FORM>-area (forms)

       Son soportadas las tables (<TABLE>...</TABLE>)
                                                                      
       El dilogo Hotlist ha sido extendido para acomodar temas. Cada
        entrada puede ser opcionalmente anotada

       El funcionamiento del cach ha sido cambiada. Los ficheros  no
        son ms alamacenados en el cach con su nombre original lo que
        podra generar  problemas con nombres largos en contraposicin
        del estandar TOS de 8+3 caracteres.

       Implementado men deslizante 'Historia'

       Men mostrando todas las uniones en una pgina

       <IMG ...> con  el  atributo ALIGN=LEFT o ALIGN=RIGHT  funciona
        correctamente

       Tamao  de fuentes en  areas <Hn> </Hn>- ha sido  cambiado (en
        lnea con el mtodo usado por Netscape y Mosaic)

       La bsqueda funciona correctamente con las bases de datos  c't
        92/93

       Nuevo: Barra  de botones  en la ventana aporta acceso rpido a
        las funciones ms importantes.
        Si aparece un smiley 'triste' a la derecha de la barra  signi-
        fica que el documento mostrado no se conforma a las  especifi-
        caciones HTML. CAB no volver a intentar  mostrar el documento
        que se vea de forma correcta. De otra parte, un smiley 'feliz'
        no indica  que el  documento est  perfecto pues CAB no pierde
        el tiempo analizando el documento en profundidad.

       Alineamiemto a la derecha est soportado (ALIGN=RIGHT) 

       Numerosos errores menores fijados ;-)

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

       Fijado error: donde se poda el color trasparente del fondo de
        las imgenes era evaluado.

       Fijado error: en  ficheros HTML  ms largos  de 32Kb donde las
        tablas estan incluidas despues de las 32 primeras Kb de basura
        (puede que incluso con colgadas) era abandonado.

       Las teclas de  cursor pueden ser usadas para desplazar la pan-
        talla. Si es un  formulario y  el cursor  esta  en un campo de
        entrada, se pueden usar las teclas de cursor para navegar  por
        el.

       Corregido  error: <PLAINTEXT> dentro  de lneas  vacias ya  no
        vuelve a ser ignorado.

       Corregido error: Bajo  viejas  TOS  los  directorios del disco
        duro no eran evaluados correctamente.

       Corregido error: Bajo viejas TOS algunas veces haba problemas
        si el  ttulo de  la ventana  era activado despus de abrir la
        ventana.

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

       Cuando  CAB se  est usando  offline (por  ejemplo: CAB.OVL no
        est instalado)  todas  las uniones despus  son tratadas como
        locales. Por  ejemplo una direccin http http://host/path/file
        ser soportada como //localhost/path/file.

       Cuando seleccionamos bases de datos c't CD ahora es posible el
        uso de smbolos comodn. Por ejemplo 'K:\HTML\CT*.DAT'  busca-
        ra todas las bases de datos en todos los c't CDs.

       El icono de cerrar ahora cierra la ventana (anteriormente este
        mostraba  la  pgina  anterior). A la pgina anterior se puede
        acceder de manera fcil usando el botn `Atrs'.

       En la resolucin 640x200 (ST media) las imgenes  son tratadas
        a media altura para mantener sus proporciones.

       Manteniendo  la  tecla [Shift] cuando  seleccionamos una unin
        muestra la nueva pgina en su propia ventana. Igualmente  man-
        teniendo la  tecla [Shift] cuando seleccionamos `OK' en `Abrir
        local', `Abrir URL' y `Hotlist' muestra la nueva pgina en una
        ventana distinta.

       CAB ahora muestra  el cdigo fuente por si mismo si no hay una
        aplicacin externa apropiada e instalada.

       Se ha ampliado CAB para comprender  las siguientes extensiones
        Netscape:

         - Usando  el  marcador  <HR>  los   atributos  WIDTH=, SIZE=,
           NOSHADE y ALIGN= son evaluados.

         - Usando <TD> y <TH>  los atributos WIDTH= y HEIGHT= son eva-
           luados.

         - Mapas de imgenes de la parte del cliente estn parcialmen-
           te implementadas <MAPNAME=name><AREA SHAPE=rect COORDS="x1,
           y1,x2,y2" HREF=url> </MAP>

       Menor optimizacin  para poder  soportar ciertas tablas cajas.
        La tabla principal puede  ser repetidas veces calculada depen-
        diendo  del ancho de  la ventana y consecuentemente el proceso
        en las tablas puede ser intensivo.
        Ejemplo: Las pginas FOCUS (a principio de 1996)(www.focus.de)
        posea una  tabla en  caja con  siete niveles anidados y estos
        tardaban  un tiempo ridculo  en ser calculados  (ms de cinco
        minutos para  algunas  pginas). De los siete niveles solo dos
        son usados de alguna forma (el resto consiste de celdas conte-
        niendo  nada de  las  otras  celdas  (vale,  puede que sea una
        programacin  legal, pero  es  un poco estupido)). CAB calcula
        cada tabla como una celda simple (por ejemplo como una  colum-
        na)  con  lo  que  resulta  una velocidad  mucho ms rpida de
        clculo, aunque no es exactamente  rpido por  lo menos es una
        mejora.

       Cualquier  tipo de fichero que  no  puede ser mostrado por CAB
        y para el cual no existe ninguna aplicacin asociada (definido
        por la extensin del fichero) puede ser, opcionalmente, copia-
        do a una carpeta.

       Ya es posible la impresin GDOS. Actualmente slo las imgenes
        monocromo  pueden  ser  imprimidas.  La  salida mediante otros 
        drivers GDOS es posible (Metafile, Img,...)

       Si se desea el dilogo Hotlist puede  ser controlado completa-
        mente por el teclado.

       Las opciones de bloque, cortar [Control]+X, copiar [Control]+C
        y pegar [Control]+V son ahora soportadas  por todos los campos
        editables de los dilogos.

       Los comandos de bloque  tambin estn disponible en los campos
        editables del documento.

       La posicin de la ventana en ahora almacenada usando la entra-
        da `grabar opciones' del men `opciones'.

       Soporte para los nuevos comandos (HTML3):

         - <BIG>, </BIG> texto grande

         - <SMALL>, </SMALL> texto pequeo

         - <SUP>, </SUP> Superindice

         - <SUB>, </SUB> Subindice

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

       Se puede crear manualmente las entradas Hotlist.

       Corregido error: los ficheros HTML  que excepcionalemte tienen
        largos comentarios al principio que  no haban usado el exten-
        sor  de  ficheros .HTM (o .html en sistemas  con  soporte para
        nombres de ficheros largos) son mostrados como ASCII.

       Corregido error: Tablas con nmeros grandes de lneas y/o  co-
        lumnas causaban problemas.

       Incluso una mayor tolerancia en la  construccin para acomodar
        a los autores de HTML que inventan pasmosamente retorcidos co-
        mandos  HTML,  an  incluso  cuando un simple comando HTML  ya
        existe :-\

12.11  V1.2 (10.04.1996)
------------------------

       Fijado  error:  Cuando  queda poca memoria CAB liberar, menos
        urgentemente, la memoria requerida (por  ejemplo  las imgenes
        en la RAM cach). Gracias a un clculo incorrecto poda acabar
        en un bucle sin fin.

       Es posible la impresin a color (tanto como  tu driver GDOS lo
        soporte).

       El tamao absoluto en pixels (con tablas o <HR>) es ahora con-
        vertido a la resolucipon de la impresora actual.

       Protocolo OLGA: CAB es un cliente OLGA

       Primer  intento  para  soportar  imgenes  JPEG,  el   fichero
        CAB_JPEG.OVL se encarga de las imgenes JPEG y debera residir
        en el directorio CAB. NOTA: CAB.OVL todava es necesario  para
        el  programa  (hojear  por lneas) no renombrar ninguno de los
        ficheros.

12.12  V1.2a (16.04.1996)
-------------------------

    Fijado error: Si  CAB va corto de memoria intenta liberar mas me-
     moria  (ej.:  borrando  imgenes  del cach imagen). Gracias a un
     fallo en el clculo de memoria disponible CAB poda meterse en un
     bucle sin fin.


12.13  V1.2b (19.04.1996)
-------------------------

    Los  valores  de mrgenes de impresora no eran evaluados de forma
     correcta si la entrada era de 3?

    Fijado error: CAB intenta formatear tablas incluso si el marcador
     <tr> es  omitido y est disponible el marcador </tr>. Debido a un
     error en CAB esto conduca a un problema con las tablas encajona-
     das. Ahora funcionar de nuevo.

    La  impresin  a color  con NVDI 4 funciona correctamente. Fijado
     error  item: Si la opcin "usar parmetros de documento" (concer-
     niente  al texto  y color  de fondo)  no  era  seleccionada no se
     mostraba  ninguna  imagen de fondo.  Ambos  parmetros  son ahora
     independientes el uno del otro.


12.14  V1.3 (20.05.1996)
------------------------

    Nuevo mdulo JPEG de Dieter Fiebelkorn

    Soporte Mail (mailto:user@address)

    Se puede acceder directamente a servidores SMTP y Proxy desde CAB
     (no aplicable a una operacin (offline) local)

    Algunos pequeos errores subsanados

    Extensiones no  reconocidas son ignoradas. Por ejemplo JavaScript
     (<SCRIPT>...</SCRIPT>) es  ignorada  y  no  se  muestra mas en el
     texto HTML.

    Se soportand 'Slide shows' via <meta http-equiv="Refresh" content
     ="5;url=xyz">

    El marcador <FONT> ahora soporta color (<FONT COLOR=...>)

    Los colores en las tablas son soportados:BGCOLOR= para tablas y/o
     fondo de celda BORDERCOLOR=, BORDERCOLORLIGHT= y BORDERCOLORDARK=
     para los contornos de las tablas

    El color mas importante puede ser tambin asignado tanto por nom-
     bre  como  por  su nmero hexadecimal. Por ejemplo COLOR=White en
     vez de COLOR=#FFFFFF

    Las referencias pueden ser seguidas durante el formateo del texto
     (el  ratn  todava no es evaluado durante la carga de imgenes).
     El formateo es abandonado y se carga el documento deseado.


12.15  V1.4 (19.09.1996)
========================

    Usar NVDI 4  para las impresiones requiere un montn menos de me-
     moria  porque  ahora se  le  da al  NVDI  4 la responsabilidad de
     escalar  las imgenes. En particular el TrueColor, ej.: un driver
     de  impresin  halftone  (32  bit/pixel). Desafortunadamente otro
     software GDOS o sustitutos no tienen esta habilidad, usa NVDI.

    CAB  soporta  las mismas descripciones de color que Netscape y MS
     Explorer.

    Aadido  botn  de  para  as que el formateo del texto puede ser
     abortada usando el ratn (correspondiente a pulsar la tecla ESC).

    Durante  la  conversin de  imagen (dithering) CAB avisa ahora de
     los eventos AES. Esto significa que es posible desplazar documen-
     tos,  seleccionar  uniones  y  deterner  el  formateo  durante la
     conversin de la imagen.

    Fijado error: En 640x200 (ST-Media) la coordenadas del ratn para
     el mapa de imagen no estaban escaladas.

    El texto origen es ahora mostrado con todos los marcadores HTML y
     los comentarios resaltados (marcadores HTML en azul y comentarios
     en rojo).

    Las  extensiones 'Frames' de Netscape se desvia mucho de la filo-
     sofa  y  prctica  del HTML. Normalmente los browsers WWW pueden
     ignorar cualquier marcador HTML y sin activarse no perder el sen-
     tido de la informacin del fichero. Desafortunadamente esto no es
     cierto  para los 'Frames' Netscape as que los browsers que no lo
     soportan, efectivamente, pierden informacin.
     CAB  todava  no soporta 'Frames' NetScape pero ahora muestra una
     lista  de  todos los documentos en un marco que permite el acceso
     al contenido del marco.

    Los mdulos y ficheros externos cargados por CAB pueden ser alma-
     cenados  de  manera  opcional  en  una carpeta MODULES localizada
     dentro de la carpeta CAB o fuera en la misma carpeta que CAB.APP.
     Los siguientes ficheros se ven afectados:

        - CAB_JPEG.OVL (este fichero tambin se puede llamar JPEG.OVL)

        - CAB.INF

        - CAB.OVL

        - CACHE_ED.PRG  y  CACHE_ED.PRG (programa para usar los cachs
          WWW)

        - HOTLIST.HTML




