HTML Help Workshop - Inledning

Microsofts HTML Help Workshop är alltjämt ett av de mest använda programmen för att framställa hjälpfiler. Men programmet kan användas till så mycket mer än bara hjälpfiler. Använd det till exempel för att skapa presentationer, eller för att visa hela din webbplats offline.

Det här är en handledning i hur man använder HTML Help Workshop. Programmet är gratis och kan hämtas från Microsofts webbplats.

Den här hjälpfilen är gjord med HTML Help Workshop

Vad är HTML Help?

HTML Help är det moderna verktyget för att skapa hjälpfiler. Systemet utnyttjar Internet Explorers komponenter för att visa hjälpen.

En viktig skillnad mellan Microsofts äldre hjälpsystem WinHelp och andragenerationens verktyg HTML Help, är att det numera inte finns någon gräns för hur stor hjälpfilen får vara. På samma sätt kan de ingående sidorna vara "obegränsat" stora. De gränser som finns sätts av hur mycket datorn klarar och av HTML-koden.

HTML-sidor

I HTML Help byggs hela hjälpfilen upp av HTML-dokument och hjälpsystemet har stöd för ActiveX, Java, JavaScript, VBScript, bilder (som GIF och JPEG) och stilmallar.

Varje avsnitt i hjälpen skall ha en egen HTML-fil, men genom att lägga in ankare i HTML-filen kan man koppla flera avsnitt till samma fil.

Skapa HTML-sidorna

Det första du skall göra är alltså att skapa de HTML-sidor som du vill ha med i hjälpfilen. Spara alla sidorna i den mapp där du sedan kommer att skapa själva hjälpfilen.

De olika avsnitten i hjälpen kan också koppla till extrerna filer eller webbplatser på Internet. Om du kommer att använda sådana länkar skall du se till att du har hela sökvägen till dem antecknade. Du kan inte utelämna http:// eller http://www.

Struktur på innehållsförteckningen

Du kan göra en hjälpfil som består av en enda HTML-sida, och i så fall behövs ingen innehållsförteckning. Men så snart hjälpsystemet består av mer än en sida, måste du ha innehållsförteckningen med eftersom det annars bara blir "startsidan" som finns tillgänglig.

Om hjälpfilen kommer att bestå av mer än tre fyra HTML-dokument, är det klokt att planera strukturen med penna och papper. Bestäm vad som skall stå i titelraden, och ordna sedan HTML-sidorna i logiska grupper. Redan på papperet sorterar du sedan dessa grupper till en innehållsförteckning, där det tydligt framgår vilken sida varje avsnitt skall visa.

Rubriker och underrubriker

Ge varje grupp en rubrik, och bestäm om själva rubriken skall visa en sida eller om alla sidor skall ligga som avsnitt under rubrikerna. I filen ovan har jag valt att lägga Bruksanvisning, Använda Pryttel och Felsökning som rena rubriker, med de tillhörande avsnitten under respektive rubrik.

Om du vill kan du använda rubriker i flera nivåer, på precis samma sätt som i Utforskarens mappstruktur.

Index

Slutligen - innan det är dags att börja göra hjälpfilen - bör du fundera över om du vill ha ett index i hjälpfilen, för att ge användaren möjligheten att söka efter mer än bara de grundläggande avsnitten. Om du tänker lägga in ett index, går du igenom HTML-sidorna och gör anteckningar om viktiga nyckelord och vilka sidor dessa bör öppna. Tänk på att samma avsnitt kan öppnas av flera nyckelord - sökmålet "hur man monterar" kan till exempel representeras av sökorden montera, sätta ihop, installation, hopfoga, göra i ordning.

Ett och samma nyckelord kan koppla till flera hjälpavsnitt, vilket ökar hjälpfilens användbarhet. När ett nyckelord leder till flera avsnitt kommer det upp en dialogruta, där användaren väljer vilket avsnitt som skall visas. Rubriken för dessa avsnitt blir den titel du gav åt HTML-sidan. Därför bör du vara noggrann i valet av titel på de ingående HTML-dokumenten.

Innan du går vidare

Du har installerat MS HTML Help Workshop.
Du har gjort en mapp som du skall skapa hjälpfilen i, och i den har du samlat allt som hör ihop med hjälpsystemet: HTML-sidor, stilmallar, bilder...
Du har öppnat HTML-sidorna i webbläsaren och kontrollerat att allt fungerar.
Om du skall ta med externa länkar, har du kontrollerat att dessa är giltiga.
Du har en planerad struktur för hjälpsystemet.
Om du skall ha ett index i hjälpsystemet, har du antecknat nyckelorden och vilka sidor de skall leda till.
Om ett nyckelord kommer att leda till flera HTML-sidor, har du sett till att dessa sidor har olika och förklarande titlar.