Pierwsza kompilacja

[ Strona główna ] [ Do góry ] [ Praktyczny przykład ] [ Rozszerzanie projektu ] [ Dodatkowe elementy ] [ Archiwum i źródła ]

 

Strona główna
Do góry

Mamy więc wreszcie pierwszą definicję projektu. Gdy zajrzysz do katalogu z projektem, dostrzeżesz w nim plik o nazwie archiwum.hhp (rozszerzenie od HTML Help project), gdy zaś wczytasz ten plik do dowolnego edytora pracującego w trybie tekstowym, dostrzeżesz, że jest to zwykły plik tekstowy. Na początek jego treść wygląda tak:

[OPTIONS]

[FILES]

websurf.html

govmail.html

msn.html

netacc2.html

offline.html

cselite.html

Zwróć uwagę na podobieństwo tej zawartości do definicji wyświetlonej w pokazanym wyżej okienku.

Ten właśnie plik tekstowy będzie podstawą do skompilowania archiwum. HTML Help Workshop sięgnie do zawartych tam danych, a także przypisze pewne domyślne parametry, które zawarte są w opcjach. To jeszcze dalece nie wszystkie elementy definicji, ale już ta najprostsza pozwala skompilować jakieś archiwum. Wykonajmy więc taką próbę.

Sięgnij w menu do File – Compile i kliknij na przycisku Compile. Program przyjął domyślnie, że chcesz kompilować opracowywany w danym momencie projekt. Zaznaczone pole wyboru Save all files before compiling oznacza, że wszystkie pliki związane z projektem zostaną automatycznie zapisane na dysku, jeśli zostały w jakiś sposób zmienione, czy to pliki definicji, czy też pliki HTML. Z kolei pole Automatically display compiled help file when done teoretycznie powinno uruchomić archiwum. Teoretycznie, gdyż dzieje się tak tylko niekiedy, a trudno się dopatrzyć jakiejś regularności w działaniu programu. Jeśli archiwum nie uruchomi się po skompilowaniu, wystarczy kliknąć nam nim podwójnie w katalogu. Przed skompilowaniem program zapyta jeszcze, w którym katalogu zapisać plik logu, w którym zostaną zawarte komunikaty.

Rysunek 16 - wybór projektu i opcje kompilacji

Jest jeszcze drugi sposób skompilowania projektu. W pasku narzędziowym znajduje się przycisk Save all files and compile (na rysunku zaznaczony strzałką), który uruchamia proces kompilacji bieżącego projektu.

Rysunek 17 - przycisk uruchamiający kompilację

W oknie roboczym programu pojawi się małe okienko z komunikatami, po czym zostanie wyświetlona zawartość logu, która może wyglądać następująco:

Microsoft HTML Help Compiler 4.73.8198

Compiling e:\roboczy\projekt\archiwum.chm

HHC3001: Warning: The file "e:\roboczy\projekt\offline.html" has a link to a non-existent file: "e:\roboczy\projekt\webzip.html".

HHC3001: Warning: The file "e:\roboczy\projekt\cselite.html" has a link to a non-existent file: "e:\roboczy\projekt\ezhtml.html".

Compile time: 0 minutes, 2 seconds

6     Topics

3     Local links

20    Internet links

12    Graphics

Created e:\roboczy\projekt\archiwum.chm, 280,856 bytes

Compression decreased file by 19,121 bytes.

W naszym przypadku w logu znalazło się ostrzeżenie, że nie zostały skompilowane dwa pliki, do których odwoływały się dokumenty HTML zawarte w projekcie. Program kompiluje bowiem "wszystko co żyje", czyli wszelkie pliki, do których odwołują się te dokumenty, także adresy internetowe. Tutaj zostały dołączone m.in. odsyłacze internetowe i grafiki, które wcześniej znalazły się w odpowiednim katalogu. Podany jest jeszcze czas akcji, wielkość archiwum i zysk na kompresji – stosunkowo niewielki, gdyż w archiwum znalazły się pliki GIF, które są z natury mocno skompresowane.

Teraz już możemy przyjrzeć się pierwszemu dziełu, czyli plikowi archiwum.chm.

Rysunek 18 - wynik wstępnej kompilacji

Archiwum zostało wyświetlone w postaci pojedynczego okienka, nie zawierającego żadnych narzędzi nawigacyjnych czy wyszukiwawczych. Na ekranie pojawił się pierwszy na liście plików dokument, ale nie mamy nawet dostępu do innych dokumentów archiwum. Z całą pewnością nie jest to wynik zadowalający i czeka nas jeszcze trochę pracy nad rozszerzeniem i wygładzeniem projektu.

Zamykamy więc archiwum (przed ponowną kompilacją zawsze zamykaj otwarty plik, gdyż w przeciwnym razie kompilator odmówi działania!) i przystępujemy do dalszej pracy.