#-------------------------------------------------------------------------------
# wwwoffled.txt - OPT_WWWOFFLED documentation
#
# Creation:      06.03.2003  Martin Hierholzer <mhier@web.de>
# Last Update:   31.10.2003  Martin Hierholzer <mhier@web.de>
#-------------------------------------------------------------------------------

Beschreibung
------------

Dieses Programm ist ein Proxy, der das Browsen über langsame Einwahlverbindungen
beschleunigen soll. Er kann auch zwischengespeicherte Seiten offline wieder
anzeigen. Weitere Informationen sind auf der offiziellen WWWOFFLINE-Homepage
unter http://www.gedanken.demon.co.uk/wwwoffle/ zu finden.
WWWOFFLINE wurde von Andrew M. Bishop (amb@gedanken.demon.co.uk) geschrieben
und unter der GPL veröffentlicht. Dieses Paktet ist lediglich eine Umsetzung
auf Fli4l (siehe www.fli4l.de), veränderungen am Quellencode wurden nicht
vorgenommen. An einigen HTML-Dateien der Steuerungsseiten wurden Veränderungen
vorgenommen, z.T. weil einige Funktionen nicht genauso wie im Original
funktionieren und z.T. weil m.E. einige Hinweise für mit dem Programm nicht
vertraute Benutzer fehten.

Benutzung des Programms auf eigene Gefahr! Der Author übernimmt keine Haftung
für Folgeschäden, es gibt keine Garantie, dass dieses Paket irgendetwas
sinnvolles tut!
Dieses Paket beinhaltet eine im Quellencode unmodifizierte Version 2.8


Vorraussetzungen
----------------

- fli4l 2.0.7 bis 2.0.8 (möglicherweise auch unter früheren Versionen lauffähig,
  wurde aber nicht getestet)
- OPT_GLIBC225
- Festplatten-Installation


Konfiguration
-------------

OPT_WWWOFFLED
Auf 'yes' setzen, sonst wird WWWOFFLED nicht verwendet ;)

WWWOFFLED_SERVER_NAME
Name des Servers, von den Computern aus gesehen, die den Proxy verwenden können
sollen. Dies ist der Name, über den andere Computer den Proxy ansprechen müssen.
Dieser Name muss im Browser zusammen mit der Portnummer (siehe
WWWOFFLED_HTTP_PORT) bei den Proxy-Einstellungen angegeben werden.

WWWOFFLED_HTTP_PORT
HTTP- und Proxy-Port von WWWOFFLE. Dieser Port sollte im Browser bei den Proxy-
Einstellungen für den HTTP-, HTTPS- und FTP-Proxy eingestellt werden.

WWWOFFLED_CONTROL_PORT
Intern verwendete Portnummer

WWWOFFLED_SPOOL_DIR
Datenverzeichnis, sollte auf einer Festplatte liegen, da hier die gecacheten
Internetseiten abgelegt werden.

WWWOFFLED_REQUEST_CHANGED_AGE
Im Online-Modus werden Seiten nur aus dem Internet geladen, wenn die Version
im Cache älter ist, als die hier angegebene Zeit in Sekunden. Negative Zahlen
bewirken, dass im Online-Modus immer die Seiten aus dem Cache geladen wird.
Längere Zeiten können durch einen Suffix ('m' für Minuten, 'h' für Stunden,
'd' für Tage oder 'w' für Wochen) angegeben werden (z.B. 10m=600).

WWWOFFLED_REQUEST_CHANGED_ONCE
Wenn dies auf 'yes' gesetzt wird, werden die Seiten nur dann aus dem Internet
geladen, wenn sie nicht bereits in dieser Online-Sitzung aus dem Internet gela-
den wurden.

WWWOFFLED_INTR_DOWNLOAD_KEEP
WWWOFFLED_INTR_DOWNLOAD_SIZE
WWWOFFLED_INTR_DOWNLOAD_PERCENT
Wenn WWWOFFLED_INTR_DOWNLOAD_PERCENT auf 'yes' gesetzt wird, werden unterbroche-
ne Downloads fortgesetzt, falls die herunterzuladene Restgröße kleiner als
WWWOFFLED_INTR_DOWNLOAD_SIZE oder wenn sie bereits zu einem Prozentsatz von
mindestens WWWOFFLED_INTR_DOWNLOAD_PERCENT geladen sind.

WWWOFFLED_TIMEOUT_KEEP
Falls ein Download wegen eines Timeouts abgebrochen wird, wird der bereits her-
untergeladene Teil im Cache gespeichert.

WWWOFFLED_CONFIRM_REQUESTS
Gibt an, ob Bestellungen im Offline-Modus bestätigt werden müssen oder nicht.

WWWOFFLED_ADD_CACHE_INFO
Fügt als Seitenfuß Informationen über das Alter der Seite und Links zum Aktuali-
sieren und zu Optionen an.

WWWOFFLED_REPLACE_WEBBUG_IMAGES
Auf 'yes' setzen, falls "Webbug"-Bilder (1x1-Pixel große Bilder, die nur dem
Zweck dienen, mittels Cookies das Surfverhalten zu überwachen) entfernt werden
sollen.

WWWOFFLED_ALLOWED_HOSTS
Hosts, denen eine Verbindung mit dem Proxy-Port erlaubt wird. Wildcards sind er-
laubt.

WWWOFFLED_CACHE_SIZE
Maximale Größe des Cache im MB; -1 für beliebige Größe

WWWOFFLED_AUTODIAL
Gibt an, ob WWWOFFLINE im Autodial-Modus laufen soll. Die Einstellung legt fest,
ob eine Seite, die sich nicht im Cache befindet, bei nicht bestehender Internet-
Verbindung aus dem Internet geladen werden soll.


Weitere Hinweise
----------------

Weitere Einstellungen können unter /opt/etc/wwwoffled.conf gesetzt werden.
Weitere Informationen sind in der WWWOFFLE-Dokumentation zu finden.
Für dieses Paket ist wegen seiner Größe unbedingt eine Festplatte o.ä. als
Bootmedium erforderlich, außerdem ist es sinnvoll, die Cache-Daten (siehe
WWWOFFLED_SPOOL_DIR) auf einem permanenten Speicher abzulegen. Einige Standard-
Werte in dieser Datei wurden von mir angepasst, damit ein für ISDN optimaler
Betrieb ohne weitere Änderungen möglich ist (allerdings sind einige der
Änderungen auch geschmacksache).

Weitere Informationen können auch, wenn der Proxy läuft, über
http://name-des-servers:http-portnummer abgerufen werden. Die dort von
WWWOFFLINE bereitgestellte Möglichkeit, die Konfigurationsdatei zu verändern,
wird nicht funktionieren, da die Konfigurationsdatei beim Neustart des Servers
überschrieben wird. Entsprechende Einstellungen können vor der Übertragung zum
Server vorgenommen werden.
Falls weitere Einstellungen als fli4l-Konfigurationsvariablen erwünscht sind,
bitte ich um eine Mail!

#-------------------------------------------------------------------------------