Profesionalno kreiranje help dokumenata

Svaki iole ozbiljan program mora da poseduje prateći priručnik sa adekvatnim objašnjenjima načina rada aplikacije, korisničkog interfejsa, pa često i skupa akcija koje su potrebne kako bi se ostvarila određena radnja. Različiti programi se na različite načine hvataju u koštac sa ovim problemom – pojedini svoja rešenja zasnivaju isključivo na online stranicama, u kvalitetnijim ostvarenjima se može videti miks offline dokumentacije i prateće Web baze koja se osvežava i proširuje, dok je najrasprostranjenije ipak jednostavno pakovanje help fajlova sa aplikacijom.

Kreiranje sadržaja ove vrste pomoću HelpSmitha vrši se sistematično putem standardnog tree grananja tema, olakšano je kreiranje baze ključnih reči, a moguće je importovati i gotove RTF dokumente, odnosno njihove pojedinačne segmente. UNICODE podrška je naravno neizostavna, te možete koristiti i naše ćirilično pismo ukoliko radite na lokalizovanom programu. Provera pravopisa je takođe prisutna, ali nažalost nije funkcionalna za naše govorno područje. Naime, moguće je odrediti koji segment teksta je napisan kojim jezikom, na listi postojećih je i srpski, ali pozivanje spellchecka izdaje poruku da je proces uspešno završen, iako u stvarnosti nije ni započet.

Implementiran je princip WYSIWYG, pa je ono što kreirate zaista jednako rezultujućem help dokumentu. Prisutna je Celokupna HTML garnitura komandi, te jednostavno možete dodavati horizontalne rulere, proizvoljne tabele, linkove, slike, filmove u AVI formatu itd. Jedina razlika je što ovde ne postoji neki kvazi-HTML View u kojem bi se mogao editovati sam kôd, već se sve obavlja jednostavnim dodavanjem elemenata iz menija ili toolbara.

Pored kreiranja klasičnih help „priloga”, HelpSmith je u stanju da se lako izbori i sa HTML i štampanim verzijama programskih priručnika. Za razliku od „statično dokumentovanog” izdanja koje nas nije značajno oduševilo, web-zasnovano rešenje zaista briljira! Struktura offline dokumenta verno je preneta na HTML osnovu sa navigacionim frejmovima. Pregled sadržaja se opet može vršiti preko indeksa ili samih tema, jedino što se za pretraživanje mora koristiti dodatno rešenje. Što se tiče pomenutog stanja ravnodušnosti prema načinu kreiranja „čvrste” kopije priručnika, pojednostavljeno formatiranje i isuviše veliki broj poluispunjenih strana u dokumentu, u pratnji činjenice da se pojedine sekcije moraju i ručno editovati, ovu mogućnost HelpSmitha čine tek relativno upotrebljivom. Izbor nekolicine opcija uključuje promenu fontova, udaljenosti elemenata u sadržaju, podešavanje paragrafa i selekciju celokupnog dokumenta ili samo određenih regiona za „preobražavanje”.

Krajnjeg korisnika retko zanima u kom je formatu help kreiran, ali iz ugla razvojnog tima za „pravi” izbor treba razmotriti potrebe konkretnog projekta i pratećeg OS-a. Jedan od problema koje Vista sa sobom donosi jeste nekompatibilnost sa starim HLP fajlovima, te ovo takođe treba imati u vidu prilikom „kompajliranja”. Novi format skladištenja dokumentacije je CHM, za čije je korišćenje neophodno preuzeti dodatni paket sa Mreže. Radi se o HTML Help Workshopu (3,3 MB), besplatnom Microsoftovom programu najosnovnijih mogućnosti. Može se skinuti i direktno sa sajta HelpSmitha, a po završetku instalacije potrebni kompajler se automatski pronalazi i omogućava čuvanje projekata u novom help formatu. Pored ovog pomalo neočekivanog propusta, demo verzija programa krije još jednu „poslasticu” – ograničenje od svega deset tema koje možete dodati u help fajl.

Miloš KNEŽEVIĆ