Skorowidz

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

 

Strona główna
Do góry

Jak już kilkakrotnie wskazywaliśmy, skorowidz (Index) jest zbiorem pojęć czy haseł, którym przypisujemy adresy stron, na których się owe pojęcia znajdują - fizycznie albo według naszego wyobrażenia. Może to być na przykład hasło „HTML Help Workshop – instalacja”, przypisane dokumentowi hhwinstal.htm. Po znalezieniu hasła w skorowidzu wystarczy kliknąć na nim podwójnie, aby wczytać żądaną stronę. Skorowidz jest zwykle dokładniejszy od spisu treści i zawiera znacznie więcej od niego pozycji - zauważmy, jak ogromne bywają skorowidze w pracach naukowych, licząc setki a nawet tysiące pozycji. Z drugiej strony, skorowidz nie może objąć swym zasięgiem tylu wyrazów co wyszukiwanie pełnotekstowe, ale jest od niego bardziej efektywny informacyjnie, gdyż koncentruje się tylko na istotnych problemach (o ich istotności oczywiście decydujemy my sami, budując skorowidz).

Skorowidz można skonstruować dwiema metodami – ręcznie, wprowadzając wszystkie pojęcia po kolei i przypisując im adresy stron, lub automatycznie, wykorzystując wprowadzone wcześniej do dokumentów wyrazy kluczowe (właśnie w tym drugim przypadku przydaje się wbudowany w HTML Help Workshop prosty edytor). Możemy stosować obie metody równolegle, a skorowidz zostanie skompilowany na podstawie informacji z obu źródeł.

Przyjrzyjmy się pierwszej metodzie.

Kliknięcie na zakładce Index spowoduje wyświetlenie okienka z pytaniem, czy otworzyć jakiś już istniejący plik skorowidza, czy też utworzyć nowy. Oczywiście wybieramy opcję Create a new index file.

Rysunek 49 - tworzenie nowego skorowidza

Podajemy nazwę skorowidza, np. archiwum, zapisując we właściwym katalogu. Na ekranie ukazuje się zakładka Index.

Drugi od góry przycisk w pasku narzędziowym pozwala wstawić wyraz kluczowy w okienku Index entry.

Rysunek 50 - przycisk do wprowadzania nowych haseł

Po kliknięciu na przycisku pojawia się okno dialogowe Index entry.

Rysunek 51 - nowy wyraz kluczowy

W polu Keyword wpisujemy hasło, po czym kliknięciem na przycisku Add przechodzimy do okienka Path or URL, gdzie wskazujemy dokument, do którego odwołuje się to hasło.

Rysunek 52 - przypisanie dokumentu wyrazowi kluczowemu

Po zatwierdzeniu wyboru w okienku Index entry zobaczymy przypisanie: wyrazowi kluczowemu odpowiada określony plik (np. msn.html), mający konkretny tytuł (np. MSN Messenger – wojna posłańców).

Rysunek 53 - pełna definicja wyrazu kluczowego

Oczywiście danemu wyrazowi kluczowemu można przypisać znacznie więcej dokumentów, gdyż jest jasne, że pojawia się on w różnych tekstach, a nie tylko w tym jednym. Możemy więc ponowić tę procedurę i w okienku Path or URL wskazać następne dokumenty. Niestety, HTML Help Workshop nie pozwala zaznaczyć od razu więcej plików i każde nowe wystąpienie wyrazu kluczowego należy wprowadzać osobno.

A oto rezultat przypisania wyrazu kluczowego trzem dokumentom:

Rysunek 54 - jeden wyraz kluczowy, wiele dokumentów

Po przypisaniu hasłu wszystkich dokumentów zatwierdzamy wybór przyciskiem OK i powracamy do zakładki Index, gdzie pojawi się gotowe hasło. Gdy klikniesz na nim podwójnie, zobaczysz okienko Topics found z trzema dokumentami (okienko pojawia się wtedy, gdy przypisań jest więcej niż jedno).

Aby skorowidz pojawił się w naszym archiwum, musimy przejść do zakładki Project, a następnie w opcjach projektu, w zakładce Files wskazać położenie skorowidza na dysku (pole Index file). Następnie trzeba podwójnie kliknąć na sekcji [WINDOWS] i w zakładce Files, w polu Index, wskazać na liście plik skorowidza.

Po skompilowaniu archiwum zobaczymy taki efekt:

Rysunek 55 - skorowidz po skompilowaniu

Podwójne kliknięcie na wyrazie kluczowym „Przeglądarka”, której przypisaliśmy jeden dokument, spowoduje natychmiastowe wyświetlenie go w prawym panelu. Podwójne kliknięcie na wyrazie „Windows”, któremu przypisaliśmy trzy dokumenty, wywoła najpierw okienko pomocnicze Znalezione tematy. Dopiero wskazanie konkretnego dokumentu na tej liście spowoduje wyświetlenie go w prawym panelu archiwum. To logiczne, gdyż przecież archiwum „nie wie”, który dokument chcemy wczytać.

Rysunek 56 - wybór dokumentu w skorowidzu

Oczywiście w panelu Index mamy do dyspozycji szereg dalszych narzędzi, analogicznych do narzędzi w spisie treści – usuwanie haseł, ponowna ich edycja, przesuwanie w górę lub w dół. Przycisk AZ pozwala posortować hasła skorowidza alfabetycznie – co ważne, polskie „ogonki” układają się we właściwej kolejności. Możemy też przesuwać hasła w prawo lub w lewo, co jest wygodne wtedy, gdy chcemy zbudować skorowidz w postaci gniazdowej, np.:

Piłsudski

-          przewrót majowy

-          stosunki z Sejmem

-          bitwa warszawska

Plik skorowidza jest także plikiem tekstowym, o rozszerzeniu .hhk, mającym przykładową postać:

<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML//EN">

<HTML>

<HEAD>

<meta name="GENERATOR" content="Microsoft&reg; HTML Help Workshop 4.1">

<!-- Sitemap 1.0 -->

</HEAD><BODY>

<UL>

      <LI> <OBJECT type="text/sitemap">

            <param name="Name" value="Przegl&sup1;darka">

            <param name="Name" value="Web SurfACE - pochwa¦a integracji">

            <param name="Local" value="websurf.html">

            </OBJECT>

      <LI> <OBJECT type="text/sitemap">

            <param name="Name" value="Windows">

            <param name="Name" value="MSN Messenger - wojna pos¦a˝cˇw">

            <param name="Local" value="msn.html">

            <param name="Name" value="Web SurfACE - pochwa¦a integracji">

            <param name="Local" value="websurf.html">

            <param name="Name" value="NetAccelerator 2">

            <param name="Local" value="netacc2.html">

            </OBJECT>

      <LI> <OBJECT type="text/sitemap">

            <param name="Name" value="a">

            <param name="See Also" value="windows">

            </OBJECT>

</UL>

</BODY></HTML>

Jak widać, jest to także plik HTML, w którym znajduje się wykaz (znaczniki UL i LI), grupujący obiekty z definicjami poszczególnych wyrazów kluczowych.

A teraz zajmijmy się drugą metodą tworzenia skorowidza, czyli wykorzystaniem wyrazów kluczowych w dokumentach.

Aby wprowadzić wyrazy kluczowe do dokumentu HTML, kliknij dwukrotnie na nazwie pliku w sekcji [FILES] – w prawym panelu HTML Help Workshop ukaże się źródło dokumentu. Wstaw kursor do dokumentu, np. tuż za kodem <BODY>.

W menu programy wybierz Edit – Compiler information, co spowoduje wyświetlenie okienka Compiler information.

Kliknij na przycisku Add, wywołując Add keyword.



Wpisz dowolną liczbę wyrazów kluczowych, rozdzielając je średnikiem (;). Nie wstawiaj żadnych spacji.



Zatwierdź zapis przyciskiem OK, po czym na ekranie zobaczysz kolumnę wyrazów kluczowych. Potwierdź przyciskiem OK.

W treści dokumentu ukaże się następujący kod:

<Object type="application/x-oleobject" classid="clsid:1e2a7bd0-dab9-11d0-b93a-00c04fc99f9e">

      <param name="Keyword" value="Internet">

      <param name="Keyword" value="Web SurfACE">

      <param name="Keyword" value="Windows">

      <param name="Keyword" value="WWW">

</OBJECT>

kliknij na przycisku opcji projektu i w zakładce Files zaznacz pole wyboru Include keywords from HTML files. Po skompilowaniu wszystkie wyrazy kluczowe znajdą się w skorowidzu.

Od razu istotna uwaga: wyrazy pobrane automatycznie z dokumentów HTML nie są rejestrowane w pliku .hhk!



Narzuca się naturalne pytanie, jak postępować i co jest najefektywniejszą metodą budowania skorowidza. Jeśli wyrazów takich jest kilkadziesiąt, ręczne ich wstawienie do skorowidza nie powinno być specjalnie kłopotliwe. Jeśli jednak są ich już setki, efektywniejsze będzie niewątpliwie wykorzystanie haseł z dokumentów. Oczywiście trzeba je wstawić ręcznie, ale i tak jest to mniej czasochłonne.

Można sobie wyobrazić następującą procedurę: przeglądamy dokument i zapisujemy w jakimś edytorze interesujące nas wyrazy kluczowe (niektóre można wręcz skopiować), jeden za drugim, rozdzielając je średnikami. Po zakończeniu pracy kopiujemy do schowka cały ciąg i wstawiamy go w polu Add keyword. W ten sposób możemy sukcesywnie opatrzyć wszystkie dokumenty zestawami wyrazów kluczowych, a jeśli zakładamy, że będziemy regularnie publikować archiwa, wszystkie następne dokumenty można poddawać tej niezbyt już uciążliwej procedurze.

Zwróćmy jeszcze uwagę na pewną różnicę między tworzeniem haseł skorowidza pierwszym i drugim sposobem. W pierwszym przypadku tworzymy hasło i przypisujemy je jednemu lub wielu dokumentom. W drugim przypadku wybieramy jeden dokument i tworzymy wiele haseł.

Ważna uwaga techniczna: gdy wstawiamy obiekt z wyrazami kluczowymi do dokumentu, w ramach BODY, wczytanie takiej strony bezpośrednio do przeglądarki internetowej powoduje wyświetlenie pustego kwadracika w miejscu tego obiektu, a wczytanie trwa nieco dłużej. Aby nasze pliki HTML, które są posyłane do Internetu, nie miały takiego efektu, można postąpić dwojako: albo wstawiać wyrazy kluczowe tylko do kopii plików, z których będą tworzone archiwa, albo wstawiać je nie do BODY, lecz do części nagłówkowej HEAD. Wprawdzie w dokumentacji programu jest mowa o BODY, ale ten drugi sposób także działa. Wybór zależy oczywiście od autora, choć bezpieczniej jest chyba tworzyć archiwum z kopii dokumentów.