         WWWOFFLE - Eksplorator Offline World Wide Web - Wersja 2.6
         ==========================================================


Wymagane jest tylko 10 krokw, aby zainstalowa WWWOFFLE z kodu rdowego do
w peni pracujcego i przetestowanego programu. Jeli uywasz wydania binarnego
(Win32), wtedy powiniene pomin pierwsze 3 kroki.

Kompilacja
----------

Nastpne dziesi krokw powinno by wystarczajce do zademonstrowania
dziaajcego WWWOFFLE.

1) Wyedytuj plik Makefile i ustaw ponisze parametry:
        Nazw i port serwera (LOCALHOST)         - domylnie localhost:8080
        Miejsce zainstalowania (INSTDIR)         - domylnie /usr/local
        Katalog buforowanych stron (SPOOLDIR)    - domylnie /var/spool/wwwoffle
        Pooenie pliku konfiguracji (CONFDIR)   - domylnie /var/spool/wwwoffle
        Opcjonalnie jzyk stron web (LANG)       - domylnie tylko Angielski
        Opcje kompilatora (CC i CFLAGS).
   (Plik Makefile zawiera pewne specyficzne opcje maszyn dla systemw
    nielinuksowych, ktre mog wymaga odkomentowania.)

2) Skompiluj programy
     make all

        **** Wane ****
   Od tej wersji WWWOFFLE naprzd, nie bd dostarcza kodu rdowego C, ktry
   jest generowany z plikw rdowych lex (*.l). Oznacza to, e bdziesz
   potrzebowa zainstalowanej i dziaajcej wersji lex lub flex, aby skompilowa
   WWWOFFLE.
        **** Wane ****


3) Zainstaluj programy i utwrz katalog buforowanych stron (spool)
     make install

        **** Wane ****
   Jeli ju uywasz WWWOFFLE, powiniene zatrzyma obecnie dziaajc wersj
   programu, zanim przeprowadzisz instalacj nowej wersji.
        **** Wane ****

   Powiniene zwrci uwag na komunikaty podawane przez make, ktre poprzedzone
   s cigiem znakw 'WWWOFFLE:', informacje te s wane i oznaczaj, e proces
   instalacji napotka na co, co wymaga twoj interwencji.

        **** Wane * Jeli obecnie uywasz wersji 2.0/2.1 ****
    *MUSISZ* uruchomi program endian-cache, aby przekonwertowa twj bufor z
    zaniechanego formatu wersji 2.0/2.1 do formatu wersji 2.2. Przeczytaj plik
    CONVERT, aby zasign wicej szczegowych informacji.
        **** Wane * Jeli obecnie uywasz wersji 2.0/2.1 ****

        **** Wane * Jeli obecnie uywasz wersji 1.x ****
    *MUSISZ* uruchomi program upgrade-cache, aby przekonwertowa twj bufor z
    formatu wersji 1.x do formatu wersji 2.x. Przeczytaj plik UPGRADE, aby
    zasign wicej szczegowych informacji.
        **** Wane * Jeli obecnie uywasz wersji 1.x ****


Konfiguracja
------------

4) Wyedytuj plik konfiguracji.
   wwwoffle.conf

        **** Wane * Jeli musisz uywa zewntrznego serwera proxy HTTP ****
    Bdziesz potrzebowa dodania nazwy proxy i numeru portu do pliku
    konfiguracji wwwoffle.conf, w nim zawarte s instrukcje.
        **** Wane * Jeli musisz uywa zewntrznego serwera proxy HTTP ****

        **** Wane * Jeli obecnie uywasz wersji 1.x ****
    Plik konfiguracji wwwoffle.conf zosta zmieniony, plik CHANGES.CONF wyjania
    rnice od wersji 1.3.
        **** Wane * Jeli obecnie uywasz wersji 1.x ****

        **** Wane * Jeli obecnie uywasz wersji 2.x ****
    Plik konfiguracji wwwoffle.conf zosta zmieniony, plik CHANGES.CONF wyjania
    rnice, natomiast upgrade-config.pl moe naprawi je.
        **** Wane * Jeli obecnie uywasz wersji 2.x ****

5) Uruchom dziaanie demona WWWOFFLE.
   wwwoffled -c wwwoffle.conf

6) Uruchom twoj Przegldark WWW i ustaw localhost:8080 jako proxy.
   Zablokuj buforowanie pomidzy sesjami w przegldarce.


Testowanie
----------

7) a) Pocz si z Internetem
   b) Przeka demonowi WWWOFFLE, e jeste poczony
        wwwoffle -online
   c) Rozpocznij przegldanie
   d) Przeka demonowi WWWOFFLE, e jeste rozczony
        wwwoffle -offline
   e) Rozcz si z Internetem

8) Powr i przegldnij ponownie strony, przy braku poczenia, przejd do
   czy, ktrych nie odwiedzie tym razem (zobaczysz komunikat serwera
   WWWOFFLE w przegldarce).

9) a) Pocz si z Internetem
   b) Przeka demonowi WWWOFFLE, e jeste poczony
        wwwoffle -online
   c) Przeka demonowi WWWOFFLE, aby pobra nowe strony
        wwwoffle -fetch
   d) Przeka demonowi WWWOFFLE, e jeste rozczony
        wwwoffle -offline
   e) Rozcz si z Internetem

10)a) Przejd do http://localhost:8080/index/ i odszukaj nowo pobrane strony.
   b) Przegldnij nowe strony, ktre wanie zostay pobrane.




Opcje Czasu Kompilacji
----------------------

W pliku wwwoffle.h znajduje si wiele dodatkowych opcji czasu kompilacji, ktre
by moe bdziesz chcia zmieni.


Pierwsze trzy s wkompilowane jako domyle wartoci opcji w sekcji StartUp
pliku wwwoffle.conf. S one rwnie uywane jako wkompilowane wartoci domylne
dla programu wwwoffle.

/*+ Domylny numer portu uywany przez demona http proxy. +*/
#define DEF_HTTP_PORT 8080

/*+ Domylny numer portu uywany do kontroli WWWOFFLE. +*/
#define DEF_WWWOFFLE_PORT 8081

/*+ Domylny katalog spool. +*/
#define DEF_SPOOL "/var/spool/wwwoffle"

/*+ Domylny katalog pliku konfiguracji. +*/
#define DEF_CONF "/var/spool/wwwoffle"


Nastpne cztery opcje ograniczj liczb pocze, ktre wwwoffled zaakceptuje w
tym samym czasie oraz liczb serwerw, ktre zostan rozwidlone w odpowiedzi na
to. Cakowita liczba MAX_SERVERS zawiera MAX_FETCH_SERVERS kiedy uruchomiony
jest 'wwwoffle -fetch'. Opcje te s w wwwoffle.conf, ale absolutne wartoci
maksymalne mog zosta zmienione tutaj jako wartoci domylne.

/*+ Absolutna maksymalna liczba serwerw do rozwidlenia w caoci. +*/
#define MAX_SERVERS 64
/*+ Domylna cakowita liczba serwerw do rozwidlenia. +*/
#define DEF_MAX_SERVERS 8

/*+ Absolutna maksymalna liczba serwerw do rozwidlenia dla pobierania
    poprzednio danych stron. +*/
#define MAX_FETCH_SERVERS 48
/*+ Domylna liczba serwerw do rozwidlenia dla pobierania stron. +*/
#define DEF_MAX_FETCH_SERVERS 4


Nastpna opcja jest liczb katalogw poprzednich razw, ktre tworzon histori
pobranych stron podczas ostatnich pocze. Jeli ta liczba zostaje zmieniona,
wymagana jest wtedy edycja pliku
/var/spool/wwwoffle/html/messages/IndexLastTime-Tail.html, poprzez dodanie czy
do tych katalogw.

/*+ Liczba tworzonych katalogw poprzedniego razu (historia ostatnich
    pocze). +*/
#define NUM_PREVTIME_DIR 3


Nastpna jest rozmiarem bufora, ktry jest uywany podczas odczytu danych z
bufora lub z gniazdka sieciowego.

/*+ Rozmiar bufora w pamici uywanego podczas odczytu z bufora dyskowego lub gniazdka. +*/
#define READ_BUFFER_SIZE 1024


Nastpne dwie ustalaj prawa dostpu, ktre s uywane podczas tworzenia
katalogw i plikw w buforze (Nie zapomnij poprzedzi ich '0', bo s to
liczby semkowe).

/*+ Domylne prawa dostpu podczas tworzenia katalogw. +*/
#define DEF_DIR_PERM  0755
/*+ Domylne prawa dostpu przy tworzeniu plikw. +*/
#define DEF_FILE_PERM 0644
