1        WWWOFFLE - World Wide Web Offline Explorer - Versi�n 2.6
2        =========================================================
3
4Se necesitan solo 10 pasos para instalar WWWOFFLE desde el c�digo fuente a
5un programa completamente funcional y probado.  Si est� usando una
6distribuci�n binaria(Win32) entonces debe saltar los tres primeros pasos.
7
8Compilaci�n
9-----------
10
11Los siguiente diez pasos deber�an ser suficientes para mostrar WWWOFFLE en
12ejecuci�n.
13
141) Edite el Makefile y ponga lo siguiente:
15        El nombre y puerto del servidor (LOCALHOST) - por defecto localhost:8080
16        El camino de instalaci�n (INSTDIR)          - por defecto /usr/local
17        El directorio de almacenamiento (SPOOLDIR)  - por defecto /var/spool/wwwoffle
18        El camino del fichero de configuraci�n (CONFDIR) - por defecto /var/spool/wwwoffle
19        Las opciones del compilador (CC y CFLAGS).
20   (El fichero Makefile incluye algunas opciones espec�ficas para m�quinas
21    no-Linux que pueden necesitar ser descomentadas.)
22
232) Compile los programas
24     make all
25
26        **** Importante ****
27    Desde esta versi�n de WWWOFFLE en adelante no proveer� del c�digo C que
28    generan los ficheros de c�digo fuente de lex (*.l). Esto significa que
29    necesitar� tener instalada una versi�n funcional de lex o flex para
30    compilar WWWOFFLE.
31        **** Importante ****
32
33
343) Instale los programas y cree el directorio de almacenamiento
35     make install
36
37        **** Importante ****
38    Si est� usando WWOFFLE deber�a parar la versi�n actualmente instalada
39    antes de instalar esta nueva versi�n
40        **** Importante ****
41
42   Debe mirar cualquier salida de make que este precedida por la palabra
43   'WWWOFFLE:' esta es informaci�n importante e indica que el proceso de
44   instalaci�n a encontrado algo que requiere de usted durante la
45   instalaci�n.
46
47        **** Importante * Si actualmente usa una versi�n 2.0/2.1 ****
48  *DEBE* ejecutar el programa endian-cache para convertir su cach� desde el
49  formato roto de la versi�n 2.0/2.1 al formato de la versi�n 2.2.  Lea el
50  fichero CONVERT para encontrar detalles.
51        **** Importante * Si actualmente usa una versi�n 2.0/2.1 ****
52
53        **** Importante * Si actualmente usa una versi�n 1.x ****
54    *DEBE* ejecutar el programa upgrade-cache para convertir su cach� desde el
55    formato de la versi�n 1.x al de la versi�n 2.x.  Lea el fichero
56    UPGRADE para encontrar detalles.
57        **** Importante * Si actualmente usa una versi�n 1.x ****
58
59
60Configuraci�n
61-------------
62
634) Edite el fichero de configuraci�n
64   wwwoffle.conf
65
66        **** Importante * Si debe usar un proxy HTTP externo ****
67    Necesitar� a�adir el nombre del proxy y el puerto al fichero de
68      configuraci�n wwwoffle.conf, l�alo para tener m�s instrucciones.
69        **** Importante * Si debe usar un proxy HTTP externo ****
70
71        **** Importante * Si actualmente usa una versi�n 1.x ****
72    El fichero de configuraci�n wwwoffle.conf ha cambiado, el fichero
73    CHANGES.CONF explica las diferencias desde la versi�n 1.3.
74        **** Importante * Si actualmente usa una versi�n 1.x ****
75
76        **** Importante * Si actualmente usa una versi�n 2.x ****
77    El fichero de configuraci�n wwwoffle.conf ha cambiado, el fichero
78    CHANGES.CONF explica las diferencias y upgrade-config.pl puede arreglarlo.
79        **** Importante * Si actualmente usa una versi�n 2.x ****
80
815) Arranque el demonio WWWOFFLE.
82   wwwoffled -c wwwoffle.conf
83
846) Arranque su Navegador Web y ponga localhost:8080 como el proxy.
85   Desactive la cach� entre sesiones en el navegador.
86
87
88Prueba
89------
90
917) a) Conecte a internet
92   b) Diga al demonio WWWOFFLE que est� conectado
93        wwwoffle -online
94   c) Empiece a navegar
95   d) Diga al demonio WWWOFFLE que est� desconectado
96        wwwoffle -offline
97   e) Desconecte de internet
98
998) Vuelva atr�s y vea las p�ginas sin estar conectado, esta vez siga diferentes
100   enlaces (Ver� un mensaje del servidor WWWOFFLE en el navegador).
101
1029) a) Conecte a internet
103   b) Diga al demonio WWWOFFLE que est� conectado
104        wwwoffle -online
105   c) Diga al demonio WWWOFFLE que recoja nuevas p�ginas
106        wwwoffle -fetch
107   d) Diga al demonio WWWOFFLE que est� desconectado
108        wwwoffle -offline
109   e) Desconecte de internet
110
11110)a) Vaya a http://localhost:8080/index/ y busque las p�ginas bajadas
112      anteriormente.
113   b) Vea la p�ginas nuevas que acaba de descargar.
114
115
116
117
118Opciones de Compilaci�n
119-----------------------
120
121En el fichero wwwoffle.h hay un n�mero extra de opciones de compilaci�n
122que quiz�s quiera cambiar.
123
124
125Las primeras tres son las opciones por defecto en la secci�n StartUp del
126fichero de configuraci�n wwwoffle.conf.  Tambi�n son usadas como las opciones
127por defecto para el programa wwwoffle.
128
129/*+ El n�mero de puerto a usar por el demonio proxy http. +*/
130#define DEF_HTTP_PORT 8080
131
132/*+ El n�mero de puerto a usar para el control de WWWOFFLE. +*/
133#define DEF_WWWOFFLE_PORT 8081
134
135/*+ El directorio de almacenaje por defecto. +*/
136#define DEF_SPOOL "/var/spool/wwwoffle"
137
138/*+ El directorio del fichero de configuraci�n por defecto. +*/
139#define DEF_CONF "/var/spool/wwwoffle"
140
141
142Las siguientes cuatro limitan el n�mero de conexiones que wwwoffled aceptar�
143de una vez y el n�mero de servidores que abrir� en respuesta a esto. Un total
144de MAX_SERVERS, incluyendo hasta MAX_FETCH_SERVERS cuando 'wwwoffle -fetch'
145est� siendo ejecutado.
146Estas opciones est�n en wwwoffle.conf, pero los valores m�ximos absolutos
147pueden ser cambiados aqu� as� como los valores por defecto.
148
149/*+ El n�mero m�ximo de servidores a abrir en total. +*/
150#define MAX_SERVERS 64
151/*+ El n�mero por defecto de servidores a abrir. +*/
152#define DEF_MAX_SERVERS 8
153
154/*+ El m�ximo absoluto de servidores a abrir para descargar p�ginas previamente
155    pedidas. +*/
156#define MAX_FETCH_SERVERS 48
157/*+ El n�mero por defecto de servidores a abrir para descargar p�ginas. +*/
158#define DEF_MAX_FETCH_SERVERS 4
159
160
161El siguiente es el n�mero de directorios "prevtime" que se crear�n para permitir
162un historial de las �ltimas veces que se estuvo conectado.  Si este n�mero
163es cambiado necesita tambi�n editar los ficheros
164/var/spool/wwwoffle/html/messages/IndexLastTime-Tail.html y
165IndexLastOut-Tail.html para hacer visibles los enlaces.
166
167/*+ El n�mero de directorios "prevtime" a crear (historial de �ltimas veces). +*/
168#define NUM_PREVTIME_DIR 3
169
170
171El siguiente el el tama�o de la memoria intermedia que se usar� para la
172creaci�n de directorios y ficheros en la cach� (No olvide el '0' a la
173izquierda para especificar base octal).
174
175/*+ Los permisos por defecto al crear directorios. +*/
176#define DEF_DIR_PERM  0755
177/*+ Los permisos por defecto al crear ficheros. +*/
178#define DEF_FILE_PERM 0644
179