Dołączona płyta zawiera całość źródeł programów i innych plików niezbędnych do
zainstalowania i uruchomienia systemu, a także dodatkową dokumentację.
Oczywiście nie było możliwe umieszczenie na płycie wszystkich niezbędnych
bibliotek koniecznych do kompilacji. Biblioteki te są zawarte np. w dystrybucji
Linux RedHat 7.3.
Konkretne katalogi zawierają:
Katalog szarp zawiera źródła części biblioteki systemu SZARP, konieczne do
kompilacji programów. Sama biblioteka nie wchodzi w skład pracy. Przed
kompilacją pozostałych programów należy skompilować bibliotekę przez wydanie
komendy make.
W katalogu znajduje się także przykładowy plik szarp.cfg, który należy
skopiować do katalogu /etc/szarp. Zawiera on opcje niezbędne do działania
programu xsltd.
Katalog ISL zawiera kod i dokumentację wykonaną w ramach pracy.
Kompilację źródeł wykonujemy przez wydanie poleceń ./configure i make, instalację przez wydanie polecenia make install. Polecenie
make
doxy spowoduje utworzenie podkatalogu doxy, zawierającego dokumentację
techniczną źródeł programów wygenerowaną ze źródeł, w języku angielskim.
Odpowiednie podkatalogi zawierają:
cocoon -- pliki konfiguracyjne dla serwerów Apache Cocoon i xsltd,
szablony XSLT, dokumenty HTML/ISL i schematy SVG/ISL oraz inne pliki stanowiące
kompletną konfigurację serwisów WWW wykonanych w ramach pracy. Instalacja w
przypadku serwera Apache Cocoon jest opisana w pliku cocoon/README.TXT.
Instalacja w przypadku programu xsltd polega na umieszczeniu
odpowiedniego wpisu w pliku /etc/szarp/szarp.cfg (zobacz dodatek
D.2).
doc -- dodatkowe, oddzielne pliki z dokumentacją części systemu oraz
dokumenty DTD. Zamieszczony plik Makefile służy do generacji dokumentacji
programu paramd ze źródeł w SGML DocBook.
doxy -- wygenerowana automatycznie dokumentacja kodu źródłowego systemu
w HTML.
includes -- pliki nagłówkowe biblioteki serwerowej HTTP.
mgr -- kod źródłowy w Latexu tekstu pracy magisterskiej i innych plików
niezbędnych do wygenerowania pracy w formacie PostScript. Zamieszczony jest
odpowiedni plik Makefile.
paramd -- kod źródłowy programu paramd (serwera parametrów). Poza
kompilacją i instalacją
samego programu (która powinna być wykonywana z katalogu ISL,
razem z pozostałymi programami), wydanie polecenia make ssl spowoduje
wygenerowanie i instalację w odpowiedniej lokalizacji certyfikatów dla połączeń
szyfrowanych. Szczegóły można znaleźć w instrukcji programu (dodatek
D.1).
server -- kod źródłowy biblioteki serwerowej HTTP.
sodi -- pliki niezbędne do kompilacji programu sodipng. Sposób
kompilacji opisuje zawarty w tym katalogu plik README.pl.
xsltd -- kod źródłowy programu xsltd (procesora dokumentów).
Katalog sodipodi zawiera zmodyfikowane przeze mnie źródła programu
Sodipodi. Kompilacja i instalacja odbywa się przez wydanie poleceń:
