        WWWOFFLE - World Wide Web Offline Explorer - Versin 2.6
        =========================================================

Se necesitan solo 10 pasos para instalar WWWOFFLE desde el cdigo fuente a
un programa completamente funcional y probado.  Si est usando una 
distribucin binaria(Win32) entonces debe saltar los tres primeros pasos.

Compilacin
-----------

Los siguiente diez pasos deberan ser suficientes para mostrar WWWOFFLE en 
ejecucin.

1) Edite el Makefile y ponga lo siguiente:
        El nombre y puerto del servidor (LOCALHOST) - por defecto localhost:8080
        El camino de instalacin (INSTDIR)          - por defecto /usr/local
        El directorio de almacenamiento (SPOOLDIR)  - por defecto /var/spool/wwwoffle
        El camino del fichero de configuracin (CONFDIR) - por defecto /var/spool/wwwoffle
        Las opciones del compilador (CC y CFLAGS).
   (El fichero Makefile incluye algunas opciones especficas para mquinas 
    no-Linux que pueden necesitar ser descomentadas.)

2) Compile los programas
     make all

        **** Importante ****
    Desde esta versin de WWWOFFLE en adelante no proveer del cdigo C que
    generan los ficheros de cdigo fuente de lex (*.l). Esto significa que
    necesitar tener instalada una versin funcional de lex o flex para
    compilar WWWOFFLE.
        **** Importante ****


3) Instale los programas y cree el directorio de almacenamiento
     make install

        **** Importante ****
    Si est usando WWOFFLE debera parar la versin actualmente instalada
    antes de instalar esta nueva versin
        **** Importante ****
    
   Debe mirar cualquier salida de make que este precedida por la palabra
   'WWWOFFLE:' esta es informacin importante e indica que el proceso de 
   instalacin a encontrado algo que requiere de usted durante la
   instalacin.

        **** Importante * Si actualmente usa una versin 2.0/2.1 ****
  *DEBE* ejecutar el programa endian-cache para convertir su cach desde el 
  formato roto de la versin 2.0/2.1 al formato de la versin 2.2.  Lea el
  fichero CONVERT para encontrar detalles.
        **** Importante * Si actualmente usa una versin 2.0/2.1 ****

        **** Importante * Si actualmente usa una versin 1.x ****
    *DEBE* ejecutar el programa upgrade-cache para convertir su cach desde el 
    formato de la versin 1.x al de la versin 2.x.  Lea el fichero
    UPGRADE para encontrar detalles.
        **** Importante * Si actualmente usa una versin 1.x ****


Configuracin
-------------

4) Edite el fichero de configuracin
   wwwoffle.conf

        **** Importante * Si debe usar un proxy HTTP externo ****
    Necesitar aadir el nombre del proxy y el puerto al fichero de 
      configuracin wwwoffle.conf, lalo para tener ms instrucciones.
        **** Importante * Si debe usar un proxy HTTP externo ****

        **** Importante * Si actualmente usa una versin 1.x ****
    El fichero de configuracin wwwoffle.conf ha cambiado, el fichero 
    CHANGES.CONF explica las diferencias desde la versin 1.3.
        **** Importante * Si actualmente usa una versin 1.x ****

        **** Importante * Si actualmente usa una versin 2.x ****
    El fichero de configuracin wwwoffle.conf ha cambiado, el fichero 
    CHANGES.CONF explica las diferencias y upgrade-config.pl puede arreglarlo.
        **** Importante * Si actualmente usa una versin 2.x ****

5) Arranque el demonio WWWOFFLE.
   wwwoffled -c wwwoffle.conf

6) Arranque su Navegador Web y ponga localhost:8080 como el proxy.
   Desactive la cach entre sesiones en el navegador.


Prueba
------

7) a) Conecte a internet
   b) Diga al demonio WWWOFFLE que est conectado
        wwwoffle -online
   c) Empiece a navegar
   d) Diga al demonio WWWOFFLE que est desconectado
        wwwoffle -offline
   e) Desconecte de internet

8) Vuelva atrs y vea las pginas sin estar conectado, esta vez siga diferentes
   enlaces (Ver un mensaje del servidor WWWOFFLE en el navegador).

9) a) Conecte a internet
   b) Diga al demonio WWWOFFLE que est conectado
        wwwoffle -online
   c) Diga al demonio WWWOFFLE que recoja nuevas pginas
        wwwoffle -fetch
   d) Diga al demonio WWWOFFLE que est desconectado
        wwwoffle -offline
   e) Desconecte de internet

10)a) Vaya a http://localhost:8080/index/ y busque las pginas bajadas 
      anteriormente.
   b) Vea la pginas nuevas que acaba de descargar.




Opciones de Compilacin
-----------------------

En el fichero wwwoffle.h hay un nmero extra de opciones de compilacin
que quizs quiera cambiar.


Las primeras tres son las opciones por defecto en la seccin StartUp del 
fichero de configuracin wwwoffle.conf.  Tambin son usadas como las opciones 
por defecto para el programa wwwoffle.

/*+ El nmero de puerto a usar por el demonio proxy http. +*/
#define DEF_HTTP_PORT 8080

/*+ El nmero de puerto a usar para el control de WWWOFFLE. +*/
#define DEF_WWWOFFLE_PORT 8081

/*+ El directorio de almacenaje por defecto. +*/
#define DEF_SPOOL "/var/spool/wwwoffle"

/*+ El directorio del fichero de configuracin por defecto. +*/
#define DEF_CONF "/var/spool/wwwoffle"


Las siguientes cuatro limitan el nmero de conexiones que wwwoffled aceptar
de una vez y el nmero de servidores que abrir en respuesta a esto. Un total
de MAX_SERVERS, incluyendo hasta MAX_FETCH_SERVERS cuando 'wwwoffle -fetch' 
est siendo ejecutado. 
Estas opciones estn en wwwoffle.conf, pero los valores mximos absolutos 
pueden ser cambiados aqu as como los valores por defecto.

/*+ El nmero mximo de servidores a abrir en total. +*/
#define MAX_SERVERS 64
/*+ El nmero por defecto de servidores a abrir. +*/
#define DEF_MAX_SERVERS 8

/*+ El mximo absoluto de servidores a abrir para descargar pginas previamente
    pedidas. +*/
#define MAX_FETCH_SERVERS 48
/*+ El nmero por defecto de servidores a abrir para descargar pginas. +*/
#define DEF_MAX_FETCH_SERVERS 4


El siguiente es el nmero de directorios "prevtime" que se crearn para permitir
un historial de las ltimas veces que se estuvo conectado.  Si este nmero
es cambiado necesita tambin editar los ficheros
/var/spool/wwwoffle/html/messages/IndexLastTime-Tail.html y
IndexLastOut-Tail.html para hacer visibles los enlaces.

/*+ El nmero de directorios "prevtime" a crear (historial de ltimas veces). +*/
#define NUM_PREVTIME_DIR 3


El siguiente el el tamao de la memoria intermedia que se usar para la
creacin de directorios y ficheros en la cach (No olvide el '0' a la
izquierda para especificar base octal).

/*+ Los permisos por defecto al crear directorios. +*/
#define DEF_DIR_PERM  0755
/*+ Los permisos por defecto al crear ficheros. +*/
#define DEF_FILE_PERM 0644
