
A Visual Studio .NET Help Integration Kit aktuálisan elérhető verziója a 2.1. Ez jelenleg a http://download.microsoft.com/download/VisualStudioNET/Install/2.1/NT45XP/EN-US/VSHIK.exe címről tölthető le. Mérete 7.2 MB.
Letöltés után a telepítése igen egyszerű, különösebb magyarázatra nem szorul.
Telepítés után, ha elindítjuk a Visual Studio.NET-et, akkor egy új projekt létrehozásakor az Other Projects-en belül kapunk egy Help Project elemet. Erre kattintva négy új projekt lehetőség tárul elénk. Ezeket felhasználva létrehozhatunk új Help 2.0 verziójú súgót, vagy visszafejthetünk már kész HxS állományokat, melyek lefordított help-ek, illetve itt nyílik lehetőség arra, hogy már meglévő CHM (Html Help 1.x) állományokat konvertáljuk Help 2.0 formára, vagy forrás szinten rendelkezésre álló Html Help 1.x-et használjuk fel 2.0-s help készítéséhez.
Mostani példánkhoz új súgót hozunk létre, így válasszuk a New Help Project elemet.
Help tulajdonságainak beállítása
Ha a Solution Explorer-ben a létrejött új HelpProject1-en (alapértelmezett név!) kattintunk és a Properties menüpontot választjuk, akkor megnyílik egy olyan ablak, ahol a súgóval kapcsolatos alapvető beállításokat elvégezhetjük. Például a General lapon lévő Title mezőbe írt szöveg jelenik majd meg a már kész és megnyitott súgó ablak fejléceként. Beállíthatunk egy alapértelmezett betűtípust is az Apperance lapon, ahol a súgó nyelvét is megadhatjuk.
Tartalom létrehozása
Mivel a Help 2.0 is web lapokból épül fel, épp úgy mint elődje a HTML Help 1.x ezért itt is szükségünk lesz néhány web oldalra amiből a help fel fog épülni.
Hozzunk most létre három web oldalt egy külön könyvtárba. Ehhez válasszuk a Solution Explorer-ben a help projektet, majd jobb gomb Add - New folder. Az új könyvtárat Source-nek neveztük el. Ezen belül hozzuk létre a web lapokat. Most kattintsunk jobb gombbal a Source mappán és az Add - New item menüpont után a Help Workshop Topic Items elemnél látható HTML File tételt válasszuk ki. Ezt a lépést ismételjük meg még kétszer, így összesen három web oldalunk lesz melyek a HTMLFile1.htm, HTMLFile2.htm, HTMLFile3.htm állományokban kapnak helyet.
Az egyszerűség kedvéért most csak annyit írjunk ezekre a web lapokra, hogy meg tudjuk azokat egymástól különböztetni majd.
A HTML formátuma help készítése során kötött. Ez látható is a létrejött új HTML állományokban. Ezt a formátumot célszerű megjegyezni, mert ha más módon hozzuk létre a HTML lapjainkat és nem így a Visual Studion.NET-en belül, akkor is ezt a formátumot fenn kell tartanunk.
<HTML xmlns:MSHelp="http://msdn.microsoft.com/mshelp">
<HEAD>
<TITLE>Tartalomjegyzék</TITLE>
<meta name="vs_targetSchema" content="HTML 4.0">
</HEAD>
<BODY>
<H1>Software Online</H1>
<H2>HTMLFile1.htm</H2>
</BODY>
</HTML>
Tartalomjegyzék létrehozása
Ha adott a súgónk tartalma, akkor ezeket a lapokat célszerűen egy tartalomjegyzékbe kell foglalnunk. Ehhez ismét jelöljük ki a Solution Explorer-be az aktuális help projektet és jobb gomb után az Add - New item menüpont kiválasztásával nyissuk meg az ablakot, melyben a Help Workshop Project Items elemnél válasszuk ki a Table of Contents tételt. Ekkor létrejön alapértelmezésben egy TOC1.HxT nevű állomány.
A TOC1.HxT-re kattintva megnyílik egy ablak, melyben létrehozhatjuk a tartalomjegyzéket. Kattintsunk itt a Global TOC elemen jobb gombbal, majd az Add Blank Node menüpont kiválasztásával vegyünk fel egy új elemet. Az új elemet kijelölve a Properties ablakban beállíthatjuk ennek feliratát a Title property-nél és hozzárendelhetünk egy HTML oldalt az URL property-nél. A projektünkbe létrehozott első web lapot a „source/htmlfile1.htm” érték megadásával rendelhetjük ehhez az elemhez.
Vegyünk fel most két újabb elemet és rendeljük hozzá a másik két HTML lapunkat is.
Tartalomjegyzék szerkesztésénél megjelenik egy TOC Editor nevű eszköz sor. Ezen találunk négy nyíl gombot, melyekkel szabályozhatjuk, hogy a felvett tartalomjegyzék elemek egymáshoz képest miként helyezkedjenek el. Ezeket használva elrendezhetjük tetszés szerint az oldalainkat.
Ha mindezzel megvagyunk, akkor már használható help áll rendelkezésünkre, csupán le kell azt fordítani. Ha rögtön az eredményt is szeretnénk látni, akkor egyszerűen csak futtassuk a projektet a jól megszokott F5-el. A help fordítása után, ekkor automatikusan elindul a dexplore.exe és betölti a mi help-ünket. A dexplore.exe az az alkalmazás, mely képes megjeleníteni Help 2.0 típusú súgó állományokat.