#-------------------------------------------------------------------------------
# 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 verffentlicht. Dieses Paktet ist lediglich eine Umsetzung
auf Fli4l (siehe www.fli4l.de), vernderungen am Quellencode wurden nicht
vorgenommen. An einigen HTML-Dateien der Steuerungsseiten wurden Vernderungen
vorgenommen, z.T. weil einige Funktionen nicht genauso wie im Original
funktionieren und z.T. weil m.E. einige Hinweise fr mit dem Programm nicht
vertraute Benutzer fehten.

Benutzung des Programms auf eigene Gefahr! Der Author bernimmt keine Haftung
fr Folgeschden, 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 (mglicherweise auch unter frheren Versionen lauffhig,
  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 knnen
sollen. Dies ist der Name, ber den andere Computer den Proxy ansprechen mssen.
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 fr 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.
Lngere Zeiten knnen durch einen Suffix ('m' fr Minuten, 'h' fr Stunden,
'd' fr Tage oder 'w' fr 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 Restgre 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 besttigt werden mssen oder nicht.

WWWOFFLED_ADD_CACHE_INFO
Fgt 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 groe 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 Gre des Cache im MB; -1 fr beliebige Gre

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 knnen unter /opt/etc/wwwoffled.conf gesetzt werden.
Weitere Informationen sind in der WWWOFFLE-Dokumentation zu finden.
Fr dieses Paket ist wegen seiner Gre unbedingt eine Festplatte o.. als
Bootmedium erforderlich, auerdem 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 fr ISDN optimaler
Betrieb ohne weitere nderungen mglich ist (allerdings sind einige der
nderungen auch geschmacksache).

Weitere Informationen knnen auch, wenn der Proxy luft, ber
http://name-des-servers:http-portnummer abgerufen werden. Die dort von
WWWOFFLINE bereitgestellte Mglichkeit, die Konfigurationsdatei zu verndern,
wird nicht funktionieren, da die Konfigurationsdatei beim Neustart des Servers
berschrieben wird. Entsprechende Einstellungen knnen vor der bertragung zum
Server vorgenommen werden.
Falls weitere Einstellungen als fli4l-Konfigurationsvariablen erwnscht sind,
bitte ich um eine Mail!

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