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


Wymagane jest tylko 10 kroków, aby zainstalować WWWOFFLE z kodu źródłowego do
w pełni pracującego i przetestowanego programu. Jeśli używasz wydania binarnego
(Win32), wtedy powinieneś pominąć pierwsze 3 kroki.

Kompilacja
----------

Następne dziesięć kroków powinno być wystarczające do zademonstrowania
działającego WWWOFFLE.

1) Wyedytuj plik Makefile i ustaw poniższe parametry:
        Nazwę i port serwera (LOCALHOST)         - domyślnie localhost:8080
        Miejsce zainstalowania (INSTDIR)         - domyślnie /usr/local
        Katalog buforowanych stron (SPOOLDIR)    - domyślnie /var/spool/wwwoffle
        Położenie pliku konfiguracji (CONFDIR)   - domyślnie /var/spool/wwwoffle
        Opcjonalnie język stron web (LANG)       - domyślnie tylko Angielski
        Opcje kompilatora (CC i CFLAGS).
   (Plik Makefile zawiera pewne specyficzne opcje maszyn dla systemów
    nielinuksowych, które mogą wymagać odkomentowania.)

2) Skompiluj programy
     make all

        **** Ważne ****
   Od tej wersji WWWOFFLE naprzód, nie będę dostarczał kodu źródłowego C, który
   jest generowany z plików źródłowych lex (*.l). Oznacza to, że będziesz
   potrzebował zainstalowanej i działającej wersji lex lub flex, aby skompilować
   WWWOFFLE.
        **** Ważne ****


3) Zainstaluj programy i utwórz katalog buforowanych stron (spool)
     make install

        **** Ważne ****
   Jeśli już używasz WWWOFFLE, powinieneś zatrzymać obecnie działającą wersję
   programu, zanim przeprowadzisz instalację nowej wersji.
        **** Ważne ****

   Powinieneś zwrócić uwagę na komunikaty podawane przez make, które poprzedzone
   są ciągiem znaków 'WWWOFFLE:', informacje te są ważne i oznaczają, że proces
   instalacji napotkał na coś, co wymaga twoj interwencji.

        **** Ważne * Jeśli obecnie używasz wersji 2.0/2.1 ****
    *MUSISZ* uruchomić program endian-cache, aby przekonwertować twój bufor z
    zaniechanego formatu wersji 2.0/2.1 do formatu wersji 2.2. Przeczytaj plik
    CONVERT, aby zasięgnąć więcej szczegółowych informacji.
        **** Ważne * Jeśli obecnie używasz wersji 2.0/2.1 ****

        **** Ważne * Jeśli obecnie używasz wersji 1.x ****
    *MUSISZ* uruchomić program upgrade-cache, aby przekonwertować twój bufor z
    formatu wersji 1.x do formatu wersji 2.x. Przeczytaj plik UPGRADE, aby
    zasięgnąć więcej szczegółowych informacji.
        **** Ważne * Jeśli obecnie używasz wersji 1.x ****


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

4) Wyedytuj plik konfiguracji.
   wwwoffle.conf

        **** Ważne * Jeśli musisz używać zewnętrznego serwera proxy HTTP ****
    Będziesz potrzebował dodania nazwy proxy i numeru portu do pliku
    konfiguracji wwwoffle.conf, w nim zawarte są instrukcje.
        **** Ważne * Jeśli musisz używać zewnętrznego serwera proxy HTTP ****

        **** Ważne * Jeśli obecnie używasz wersji 1.x ****
    Plik konfiguracji wwwoffle.conf został zmieniony, plik CHANGES.CONF wyjaśnia
    różnice od wersji 1.3.
        **** Ważne * Jeśli obecnie używasz wersji 1.x ****

        **** Ważne * Jeśli obecnie używasz wersji 2.x ****
    Plik konfiguracji wwwoffle.conf został zmieniony, plik CHANGES.CONF wyjaśnia
    różnice, natomiast upgrade-config.pl może naprawić je.
        **** Ważne * Jeśli obecnie używasz wersji 2.x ****

5) Uruchom działanie demona WWWOFFLE.
   wwwoffled -c wwwoffle.conf

6) Uruchom twoją Przeglądarkę WWW i ustaw localhost:8080 jako proxy.
   Zablokuj buforowanie pomiędzy sesjami w przeglądarce.


Testowanie
----------

7) a) Połącz się z Internetem
   b) Przekaż demonowi WWWOFFLE, że jesteś połączony
        wwwoffle -online
   c) Rozpocznij przeglądanie
   d) Przekaż demonowi WWWOFFLE, że jesteś rozłączony
        wwwoffle -offline
   e) Rozłącz się z Internetem

8) Powróć i przeglądnij ponownie strony, przy braku połączenia, przejdć do
   łączy, których nie odwiedziłeś tym razem (zobaczysz komunikat serwera
   WWWOFFLE w przeglądarce).

9) a) Połącz się z Internetem
   b) Przekaż demonowi WWWOFFLE, że jesteś połączony
        wwwoffle -online
   c) Przekaż demonowi WWWOFFLE, aby pobrał nowe strony
        wwwoffle -fetch
   d) Przekaż demonowi WWWOFFLE, że jesteś rozłączony
        wwwoffle -offline
   e) Rozłącz się z Internetem

10)a) Przejdź do http://localhost:8080/index/ i odszukaj nowo pobrane strony.
   b) Przeglądnij nowe strony, które właśnie zostały pobrane.




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

W pliku wwwoffle.h znajduje się wiele dodatkowych opcji czasu kompilacji, które
być może będziesz chciał zmienić.


Pierwsze trzy są wkompilowane jako domyśle wartości opcji w sekcji StartUp
pliku wwwoffle.conf. Są one również używane jako wkompilowane wartości domyślne
dla programu wwwoffle.

/*+ Domyślny numer portu używany przez demona http proxy. +*/
#define DEF_HTTP_PORT 8080

/*+ Domyślny numer portu używany do kontroli WWWOFFLE. +*/
#define DEF_WWWOFFLE_PORT 8081

/*+ Domyślny katalog spool. +*/
#define DEF_SPOOL "/var/spool/wwwoffle"

/*+ Domyślny katalog pliku konfiguracji. +*/
#define DEF_CONF "/var/spool/wwwoffle"


Następne cztery opcje ograniczją liczbę połączeń, które wwwoffled zaakceptuje w
tym samym czasie oraz liczbę serwerów, które zostaną rozwidlone w odpowiedzi na
to. Całkowita liczba MAX_SERVERS zawiera MAX_FETCH_SERVERS kiedy uruchomiony
jest 'wwwoffle -fetch'. Opcje te są w wwwoffle.conf, ale absolutne wartości
maksymalne mogą zostać zmienione tutaj jako wartości domyślne.

/*+ Absolutna maksymalna liczba serwerów do rozwidlenia w całości. +*/
#define MAX_SERVERS 64
/*+ Domyślna całkowita liczba serwerów do rozwidlenia. +*/
#define DEF_MAX_SERVERS 8

/*+ Absolutna maksymalna liczba serwerów do rozwidlenia dla pobierania
    poprzednio żądanych stron. +*/
#define MAX_FETCH_SERVERS 48
/*+ Domyślna liczba serwerów do rozwidlenia dla pobierania stron. +*/
#define DEF_MAX_FETCH_SERVERS 4


Następna opcja jest liczbą katalogów poprzednich razów, które tworzoną historię
pobranych stron podczas ostatnich połączeń. Jeśli ta liczba zostaje zmieniona,
wymagana jest wtedy edycja pliku
/var/spool/wwwoffle/html/messages/IndexLastTime-Tail.html, poprzez dodanie łączy
do tych katalogów.

/*+ Liczba tworzonych katalogów poprzedniego razu (historia ostatnich
    połączeń). +*/
#define NUM_PREVTIME_DIR 3


Następna jest rozmiarem bufora, który jest używany podczas odczytu danych z
bufora lub z gniazdka sieciowego.

/*+ Rozmiar bufora w pamięci używanego podczas odczytu z bufora dyskowego lub gniazdka. +*/
#define READ_BUFFER_SIZE 1024


Następne dwie ustalają prawa dostępu, które są używane podczas tworzenia
katalogów i plików w buforze (Nie zapomnij poprzedzić ich '0', bo są to
liczby ósemkowe).

/*+ Domyślne prawa dostępu podczas tworzenia katalogów. +*/
#define DEF_DIR_PERM  0755
/*+ Domyślne prawa dostępu przy tworzeniu plików. +*/
#define DEF_FILE_PERM 0644
