
        WWWOFFLE - World Wide Web Offline Explorer - Version 2.5
        =========================================================

Se necesitan solo 10 pasos para instalar WWWOFFLE desde el cdigo fuente a
un programa completamente funcional y testeado.  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 and CFLAGS).
   (El Makefile incluye algunas opciones especficas para mquinas no-Linux
    que pueden necesitar ser descomentadas.)

2) Compile todos los programas
     make all

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

   Debe mirar por 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, lealo para las instrucciones.
        **** Importante * Si debe usar un proxy HTTP externo ****

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

        **** Importante * Si actualmente est usando 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 est usando 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 el cacheo entre sesiones en el navegador.


Testeo
------

7) a) Conecte a internet
   b) Diga al demonio WWWOFFLE que est en lnea
        wwwoffle -online
   c) Empiece a navegar
   d) Diga al demonio WWWOFFLE que est fuera de lnea
        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 en lnea
        wwwoffle -online
   c) Diga al demonio WWWOFFLE que recoja nuevas pginas
        wwwoffle -fetch
   d) Diga al demonio WWWOFFLE que est fuera de lnea
        wwwoffle -offline
   e) Desconecte de internet

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




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 de fichero
de configuracin wwwoffle.conf.  Tambin son usadas como las opciones por 
defecto para el programa wwwoffle.

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

/*+ El nmero de puerto para 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 recoger pginas previamente
	pedidas. +*/
#define MAX_FETCH_SERVERS 48
/*+ El nmero por defecto de servidores a abrir para recoger 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 en lnea.

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


