"Apache. Przewodnik encyklopedyczny. Wydanie III"
Peter Laurie, Ben Laurie
O'Reilly 2003

PLIKI WITRYN PRZYKŁADOWYCH

Umieszczone w niniejszym katalogu pliki to dodatek do książki
"Apache. Przewodnik encyklopedyczny", stanowiąc ilustrację omawianych
w niej zagadnień. Kolejne przykłady stanowią modyfikację podstawowej,
przykładowej witryny internetowej o nazwie 'www.butterthlies.com.pl',
będącej namiastką witryny firmy handlującej pocztówkami.

Uruchomienie plików przykładowych wymaga zainstalowania w systemie
serwera WWW Apache, przy czym część przykładów zakłada korzystanie z
serwera Apache w wersji 1.3.x, a część wymaga posiadania serwera Apache
w wersji 2.0.x. Sposób pobrania serwera ze strony http://www.apache.org
i procedura jego instalacji została szczegółowo opisana w rozdziale 1.

Podkatalogi o nazwach rozpoczynających się od ciągu 'site.'
('site.simple', 'site.multiview' itp.) stanowią katalogi witryn
przykładowych, ilustrujących zagadnienia omawiane w poszczególnych
rozdziałach i podrozdziałach książki. W skład tych witryn wchodzą
zazwyczaj podkatalogi 'conf' i 'htdocs', w których umieszczone są
odpowiednio: pliki konfiguracyjne dla serwera, przygotowane pod kątem
cech danej witryny, oraz pliki dokumentów udostępnianych w ramach
witryny. Dodatkowo podkatalog witryny zawierać może katalog 'logs',
przeznaczony do przechowywania plików dziennika generowanych przez
serwer podczas obsługi witryny przykładowej.

Pozostałe katalogi są katalogami pomocniczymi, wymaganymi ze względu na konfigurację witryn
przykładowych, i tak:
 - katalog 'main_docs' - podstawowe wersje dokumentów serwowanych
   przez kolejne wersje przykładowej witryny,
 - katalogi 'cgi.bin' i 'cgi' - wersje skryptów serwowanych w ramach
   witryn przykładowych; oprócz skryptów interpretowanych katalog
   zawiera również pliki źródłowe programów - do kompilacji tych plików
   w systemie Linux służy polecenie make (katalog zawiera odpowiednio
   przygotowany plik Makefile).
 - katalog 'ok_users' - baza danych użytkowników witryny z podziałem
   na grupy użytkowników; uwaga! niektóre przykłady wymagają od Czytelnika
   utworzenia innej bazy danych użytkowników witryny, obsługiwanych przez
   wyspecjalizowane moduły uwierzytelniające serwera Apache (auth_db.c,
   auth_dbm.c itp.); bazy te należy umieścić w podkatalogach (odpowiednio)
   'ok_db', 'ok_dbm', 'ok_digest'.

INSTALACJA PLIKÓW PRZYKŁADOWYCH
Instalacja plików przykładowych w systemie Linux sprowadza się do rozpakowania
archiwum do katalogu '/usr/www' (uwaga! struktura podkatalogów witryn przykładowych
nie jest dowolna: odzwierciedla ona strukturę katalogów i plików witryn
przykładowych omawianą w książce i została wymuszona zawartością plików
konfiguracyjnych poszczególnych witryn).
