1         WWWOFFLE - Eksplorator Offline World Wide Web - Wersja 2.6
2         ==========================================================
3
4
5Wymagane jest tylko 10 krok�w, aby zainstalowa� WWWOFFLE z kodu �r�d�owego do
6w pe�ni pracuj�cego i przetestowanego programu. Je�li u�ywasz wydania binarnego
7(Win32), wtedy powiniene� pomin�� pierwsze 3 kroki.
8
9Kompilacja
10----------
11
12Nast�pne dziesi�� krok�w powinno by� wystarczaj�ce do zademonstrowania
13dzia�aj�cego WWWOFFLE.
14
151) Wyedytuj plik Makefile i ustaw poni�sze parametry:
16        Nazw� i port serwera (LOCALHOST)         - domy�lnie localhost:8080
17        Miejsce zainstalowania (INSTDIR)         - domy�lnie /usr/local
18        Katalog buforowanych stron (SPOOLDIR)    - domy�lnie /var/spool/wwwoffle
19        Po�o�enie pliku konfiguracji (CONFDIR)   - domy�lnie /var/spool/wwwoffle
20        Opcjonalnie j�zyk stron web (LANG)       - domy�lnie tylko Angielski
21        Opcje kompilatora (CC i CFLAGS).
22   (Plik Makefile zawiera pewne specyficzne opcje maszyn dla system�w
23    nielinuksowych, kt�re mog� wymaga� odkomentowania.)
24
252) Skompiluj programy
26     make all
27
28        **** Wa�ne ****
29   Od tej wersji WWWOFFLE naprz�d, nie b�d� dostarcza� kodu �r�d�owego C, kt�ry
30   jest generowany z plik�w �r�d�owych lex (*.l). Oznacza to, �e b�dziesz
31   potrzebowa� zainstalowanej i dzia�aj�cej wersji lex lub flex, aby skompilowa�
32   WWWOFFLE.
33        **** Wa�ne ****
34
35
363) Zainstaluj programy i utw�rz katalog buforowanych stron (spool)
37     make install
38
39        **** Wa�ne ****
40   Je�li ju� u�ywasz WWWOFFLE, powiniene� zatrzyma� obecnie dzia�aj�c� wersj�
41   programu, zanim przeprowadzisz instalacj� nowej wersji.
42        **** Wa�ne ****
43
44   Powiniene� zwr�ci� uwag� na komunikaty podawane przez make, kt�re poprzedzone
45   s� ci�giem znak�w 'WWWOFFLE:', informacje te s� wa�ne i oznaczaj�, �e proces
46   instalacji napotka� na co�, co wymaga twoj interwencji.
47
48        **** Wa�ne * Je�li obecnie u�ywasz wersji 2.0/2.1 ****
49    *MUSISZ* uruchomi� program endian-cache, aby przekonwertowa� tw�j bufor z
50    zaniechanego formatu wersji 2.0/2.1 do formatu wersji 2.2. Przeczytaj plik
51    CONVERT, aby zasi�gn�� wi�cej szczeg�owych informacji.
52        **** Wa�ne * Je�li obecnie u�ywasz wersji 2.0/2.1 ****
53
54        **** Wa�ne * Je�li obecnie u�ywasz wersji 1.x ****
55    *MUSISZ* uruchomi� program upgrade-cache, aby przekonwertowa� tw�j bufor z
56    formatu wersji 1.x do formatu wersji 2.x. Przeczytaj plik UPGRADE, aby
57    zasi�gn�� wi�cej szczeg�owych informacji.
58        **** Wa�ne * Je�li obecnie u�ywasz wersji 1.x ****
59
60
61Konfiguracja
62------------
63
644) Wyedytuj plik konfiguracji.
65   wwwoffle.conf
66
67        **** Wa�ne * Je�li musisz u�ywa� zewn�trznego serwera proxy HTTP ****
68    B�dziesz potrzebowa� dodania nazwy proxy i numeru portu do pliku
69    konfiguracji wwwoffle.conf, w nim zawarte s� instrukcje.
70        **** Wa�ne * Je�li musisz u�ywa� zewn�trznego serwera proxy HTTP ****
71
72        **** Wa�ne * Je�li obecnie u�ywasz wersji 1.x ****
73    Plik konfiguracji wwwoffle.conf zosta� zmieniony, plik CHANGES.CONF wyja�nia
74    r�nice od wersji 1.3.
75        **** Wa�ne * Je�li obecnie u�ywasz wersji 1.x ****
76
77        **** Wa�ne * Je�li obecnie u�ywasz wersji 2.x ****
78    Plik konfiguracji wwwoffle.conf zosta� zmieniony, plik CHANGES.CONF wyja�nia
79    r�nice, natomiast upgrade-config.pl mo�e naprawi� je.
80        **** Wa�ne * Je�li obecnie u�ywasz wersji 2.x ****
81
825) Uruchom dzia�anie demona WWWOFFLE.
83   wwwoffled -c wwwoffle.conf
84
856) Uruchom twoj� Przegl�dark� WWW i ustaw localhost:8080 jako proxy.
86   Zablokuj buforowanie pomi�dzy sesjami w przegl�darce.
87
88
89Testowanie
90----------
91
927) a) Po��cz si� z Internetem
93   b) Przeka� demonowi WWWOFFLE, �e jeste� po��czony
94        wwwoffle -online
95   c) Rozpocznij przegl�danie
96   d) Przeka� demonowi WWWOFFLE, �e jeste� roz��czony
97        wwwoffle -offline
98   e) Roz��cz si� z Internetem
99
1008) Powr�� i przegl�dnij ponownie strony, przy braku po��czenia, przejd� do
101   ��czy, kt�rych nie odwiedzi�e� tym razem (zobaczysz komunikat serwera
102   WWWOFFLE w przegl�darce).
103
1049) a) Po��cz si� z Internetem
105   b) Przeka� demonowi WWWOFFLE, �e jeste� po��czony
106        wwwoffle -online
107   c) Przeka� demonowi WWWOFFLE, aby pobra� nowe strony
108        wwwoffle -fetch
109   d) Przeka� demonowi WWWOFFLE, �e jeste� roz��czony
110        wwwoffle -offline
111   e) Roz��cz si� z Internetem
112
11310)a) Przejd� do http://localhost:8080/index/ i odszukaj nowo pobrane strony.
114   b) Przegl�dnij nowe strony, kt�re w�a�nie zosta�y pobrane.
115
116
117
118
119Opcje Czasu Kompilacji
120----------------------
121
122W pliku wwwoffle.h znajduje si� wiele dodatkowych opcji czasu kompilacji, kt�re
123by� mo�e b�dziesz chcia� zmieni�.
124
125
126Pierwsze trzy s� wkompilowane jako domy�le warto�ci opcji w sekcji StartUp
127pliku wwwoffle.conf. S� one r�wnie� u�ywane jako wkompilowane warto�ci domy�lne
128dla programu wwwoffle.
129
130/*+ Domy�lny numer portu u�ywany przez demona http proxy. +*/
131#define DEF_HTTP_PORT 8080
132
133/*+ Domy�lny numer portu u�ywany do kontroli WWWOFFLE. +*/
134#define DEF_WWWOFFLE_PORT 8081
135
136/*+ Domy�lny katalog spool. +*/
137#define DEF_SPOOL "/var/spool/wwwoffle"
138
139/*+ Domy�lny katalog pliku konfiguracji. +*/
140#define DEF_CONF "/var/spool/wwwoffle"
141
142
143Nast�pne cztery opcje ograniczj� liczb� po��cze�, kt�re wwwoffled zaakceptuje w
144tym samym czasie oraz liczb� serwer�w, kt�re zostan� rozwidlone w odpowiedzi na
145to. Ca�kowita liczba MAX_SERVERS zawiera MAX_FETCH_SERVERS kiedy uruchomiony
146jest 'wwwoffle -fetch'. Opcje te s� w wwwoffle.conf, ale absolutne warto�ci
147maksymalne mog� zosta� zmienione tutaj jako warto�ci domy�lne.
148
149/*+ Absolutna maksymalna liczba serwer�w do rozwidlenia w ca�o�ci. +*/
150#define MAX_SERVERS 64
151/*+ Domy�lna ca�kowita liczba serwer�w do rozwidlenia. +*/
152#define DEF_MAX_SERVERS 8
153
154/*+ Absolutna maksymalna liczba serwer�w do rozwidlenia dla pobierania
155    poprzednio ��danych stron. +*/
156#define MAX_FETCH_SERVERS 48
157/*+ Domy�lna liczba serwer�w do rozwidlenia dla pobierania stron. +*/
158#define DEF_MAX_FETCH_SERVERS 4
159
160
161Nast�pna opcja jest liczb� katalog�w poprzednich raz�w, kt�re tworzon� histori�
162pobranych stron podczas ostatnich po��cze�. Je�li ta liczba zostaje zmieniona,
163wymagana jest wtedy edycja pliku
164/var/spool/wwwoffle/html/messages/IndexLastTime-Tail.html, poprzez dodanie ��czy
165do tych katalog�w.
166
167/*+ Liczba tworzonych katalog�w poprzedniego razu (historia ostatnich
168    po��cze�). +*/
169#define NUM_PREVTIME_DIR 3
170
171
172Nast�pna jest rozmiarem bufora, kt�ry jest u�ywany podczas odczytu danych z
173bufora lub z gniazdka sieciowego.
174
175/*+ Rozmiar bufora w pami�ci u�ywanego podczas odczytu z bufora dyskowego lub gniazdka. +*/
176#define READ_BUFFER_SIZE 1024
177
178
179Nast�pne dwie ustalaj� prawa dost�pu, kt�re s� u�ywane podczas tworzenia
180katalog�w i plik�w w buforze (Nie zapomnij poprzedzi� ich '0', bo s� to
181liczby �semkowe).
182
183/*+ Domy�lne prawa dost�pu podczas tworzenia katalog�w. +*/
184#define DEF_DIR_PERM  0755
185/*+ Domy�lne prawa dost�pu przy tworzeniu plik�w. +*/
186#define DEF_FILE_PERM 0644
187