Opcje projektu

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

 

Strona główna
Do góry

Całemu projektowi można przypisać pewne opcje. Kliknięcie na przycisku Change project options lub podwójne kliknięcie na sekcji [OPTIONS] spowoduje wyświetlenie okienka dialogowe Options.

W zakładce General możemy wprowadzić następujące informacje:

Title – tytuł całego archiwum. Jest on widoczny wtedy, gdy nie przypiszemy innych tytułów okienkom (pisaliśmy o tym w rozdziale poświęconym definiowaniu okienek).

Default file – nazwa pliku pojawiającego się w momencie otwarcia archiwum. Jest to wczytywany wtedy, gdy nie został określony domyślny plik w definicji głównego okienka programu.

Default window – nazwa głównego okienka programu.

Language – ustawienia językowe archiwum. Wbrew logice, nie decyduje to wcale o językowej powłoce archiwum, gdyż ta jest zależna od wersji językowej używanego Help Viewera (ze strony Microsoftu można pobrać i zainstalować jedną z kilkudziesięciu wersji językowych Viewera – plik hhupd.exe). Również wybranie np. języka angielskiego nie powoduje zmiany powłoki, gdy używamy polskiej wersji Viewera. Nie dostrzegłem żadnych skutków zmiany języka, ale dla formalności przyjmujmy zawsze polskie ustawienia.

Font – czcionka dla interfejsu archiwum, widoczna wtedy, gdy nie wybraliśmy innej czcionki dla odrębnych elementów archiwum. Najlepiej jest jednak pozostawić czcionkę domyślną, czyli puste pole.

Rysunek 44 - opcje archiwum: General

Zakładka Files

Compiled file – nazwa i położenie pliku skompilowanego archiwum.

Log file – nazwa i położenie pliku logu. Podanie go nie jest konieczne.

Contents file – nazwa pliku spisu treści.

Automatically create contents file (.hhc) when compiling (maximum head level x) – opcja pozwala utworzyć automatycznie plik spisu treści na podstawie znajdujących się w nich tytułów stopnia pierwszego, drugiego itd., odpowiednio zagnieżdżając poziomy. Funkcja ta działa tym poprawniej, im mniej poziomów uwzględniamy. Nazwami w spisie treści stają się tytuły danego stopnia.

Potrzebne są tutaj dodatkowe uwagi techniczne. Jeśli użyjemy funkcji automatycznego generowania spisu treści, uzyskany spis będzie skonstruowany dość przypadkowo, aczkolwiek znajdą się w nim wszystkie dokumenty z tytułami wskazanego stopnia. Konieczne będzie przejście do zakładki Contents i dokonanie edycji spisu, czyli poprzesuwanie pozycji, zarówno co do kolejności, jak i stopnia zagnieżdżenia. Potem, przed ponowną kompilacją, konieczne będzie usunięcia zaznaczenia pola Automatically create contents file..., gdyż inaczej program usunie nasze poprawki i stracimy wykonaną pracę!

Jeszcze jednym problemem jest to, że HTML Help Workshop generuje pozycje spisu z polskimi literami reprezentowanymi symbolicznie, np. „MSN Messenger - wojna pos³añców”, zarówno w samym spisie, jak i potem w archiwum. Konieczne jest więc ręczne poprawienie tych symboli na "normalne" polskie litery.

Wybór metody tworzenia spisu treści zależy więc od okoliczności. Gdy dokumentów jest wiele, można wykorzystać automat, a potem dokonać ręcznych poprawek, co zajmie na pewno mniej czasu niż tworzenie spisu całkowicie ręcznie.

I jeszcze jedna uwaga. W naszych dokumentach HTML znajdują się niejednokrotnie tytuły niższych stopni, np. drugiego czy trzeciego. HTML Help Workshop, wbrew oczekiwaniom, nie tworzy bynajmniej odsyłaczy do miejsc, w których znajdują się te tytuły (webmasterom znane jest oczywiście pojęcie zakładek czy kotwic), lecz tylko do stron jako takich. Może to powodować niepotrzebne dublowanie dokumentów w spisie. Gdybyśmy rzeczywiście chcieli odwoływać się do kotwic w dokumencie, należałoby je wcześniej tam wprowadzić, a potem ręcznie zdefiniować odpowiednie pozycje w spisie treści, np. plik.htm#kotwica. Program w obecnej wersji nie potrafi tego wykonać samodzielnie.

Index file – nazwa i położenie pliku skorowidza (o skorowidzu powiemy w dalszej części pracy).

Include keywords from HTML files – automatyczne generowanie skorowidza na podstawie wyrazów kluczowych znajdujących się w dokumentach (powiemy o tym później).

Full text search stop list file – lista wyjątków w funkcji wyszukiwania pełnotekstowego, np. często używane przyimki, zaimki itd., które zajmują miejsce, ale nie mają znaczenia informacyjnego. Pozwala to niekiedy wyraźnie zmniejszyć objętość archiwum, co może mieć znaczenie, gdy zależy nam na małych rozmiarach archiwum.

Rysunek 45 - opcje archiwum: Files

Zakładka Compiler

While compiling, display Notes/Progress - program wyświetla w trakcie kompilacji uwagi i postęp pracy.

Compatibility - zgodność z wcześniejszymi (1.0) lub nowszymi bibliotekami (1.1) HTML Help. Nowsza wersja wymaga od czytelnika posiadania najnowszych wersji przeglądarek, ale daje większe możliwości, jak tworzenie binarnych wersji skorowidza i spisu treści, a także zagnieżdżanie infrmacji z innych plików pomocy - merging. HTML Help Workshop jest dość kłopotliwy w określaniu wersji, gdyż nie zawsze zachowuje ustawienia, a nawet wyświetla niepoprawne kombinacje (1.0 i binarny indeks!), co wymaga stałej kontroli.

Don't include folders in compiled file - wielce enigmatyczna opcja. Jej widocznym efektem jest nieuwzględnianie podfolderów w trakcie kompilacji.

Support enhanced decompilation - brak jakichkolwiek wiarygodnych informacji na temat tej opcji. Zarówno jej zaznaczenie, jak i pominięcie, nie wpływa na możliwość dokonania dekompilacji archiwum z poziomu HTML Help Workshop - można odzyskać zarówno pliki treści, jak i pliki spisu treści czy skorowidza. Jednak w żadnej sytuacji nie jest możliwe odzyskanie pliku projektu .hhp.

Compile full-text search information - pozwala utworzyć bazę dla pełnotekstowego wyszukiwania. Zaznaczenie opcji jest konieczne, gdy deklarujemy funkcję wyszukiwania w archiwum. W przeciwnym wypadku zakładka wyszukiwania pozostanie pusta.

Create a binary Index - pozwala tworzyć binarną wersję skorowidza (indeksu).

W HTML Help istnieją dwie wersje indeksu - binarna i jako mapa witryny. Binarna jest mniejsza, szybsza w działaniu, pozwala łączyć ze sobą indeksy różnych plików (merging), jest automatycznie sortowana w trakcie kompilacji, pozwala łączyć wyrazy kluczowe zawarte w dokumentach HTML (KLinks). Mapa nie musi być kompilowana, można ją wykorzystać nie tylko w pliku .chm, ale i na stronach WWW (czytanych w przeglądarce IE), użytkownik ma pełną kontrolę nad jej postacią (jest to plik tekstowy).

Create a binary TOC - pozwala utworzyć w archiwum binarną wersję spisu treści, co przyspiesza jej ładowanie, gdy spis jest bardzo obszerny. Jedną z zalet jest możliwość zastosowania nieobecnej  w HTML Help Workshop opcji Next/Previous w pasku narzędziowym archiwum (pozwala ona przeglądać po kolei dokumenty do przodu lub wstecz za pomocą przycisku na pasku). Wersja binarna ma ograniczenia - między innymi nie obsługuje ikon innych niż book i page, a także typów informacji. W normalnych warunkach tworzenie binarnego spisu treści nie jest konieczne. Jeśli chcemy łączyć później pliki archiwów (Merge), wręcz nie wolno tego robić!

Rysunek 46 - opcje archiwum: Compiler

Zakładka Merge files

Add - dodajemy inny plik archiwum .chm, który zostanie "zmieszany" z tworzonym właśnie archiwum.

Remove - usuwamy plik .chm z listy.

O łączeniu archiwów powiemy w odrębnym rozdziale.

Rysunek 47 - opcje archiwum: Merge Files