Help Editor 2.0 FAQ

Posted: (EET/GMT+2)

 

Help Editor 2.0 FAQ

This FAQ contains the only single commonly asked question about Help Editor 2.0. This only applies to Finnish (or other non-English) users as it is about using special characters like ä and ö in Help files.

The reason there is only a single question asked is probably a good thing: the software is so simple to use that there is no need to ask questions! ;-)


FAQ #1: How do I use characters like ä and ö in Help files?

    Microsoft Help Compiler, which is used by Help Editor 2.0 doesn't accept characters whose ASCII values are greater than 127. To use such characters, one must use special RTF codes. Fortunately, Help Editor 2.0 includes support for such characters.

    For example, to insert "ä" character, do this:

    • Position cursor to the place where you want to insert the character.
    • From the Insert menu choose Special Character
    • Write to the Characters To Insert field the character(s) you want to insert
    • Choose OK




And then the same in Finnish (isn't it a funny language?):

"Ääkkösten" käyttö Help Editor 2.0:ssa

    Koska Help Editor 2.0:aa ei alunperin oltu suunniteltu käytettäväksi suomen kielellä, en tehnyt ohjelmaan automaattista ääkkösten konvertointia. Seuraavaan versioon sellainen on kuitenkin tulossa.

    Kuten olet varmaan huomannut, Help Editor käyttää Microsoftin valmistamaa Help Compiler:ia. Help Compiler ei suoraan tue merkkejä, joiden ASCII-arvo on suurempi kuin 127 (johon mm. ääkköset kuuluvat), vaan merkit täytyy antaa koodien muodossa. Jos koodeja ei käytetä, seurauksena on "Error at byte offset nnnn" virheilmoitus.

    Help Editor:ssa saat lisättyä esim. "ä" kirjaimen seuraavasti:

    • Aseta kohdistin paikkaan, johon haluat lisätä merkin
    • Valitse Insert-valikosta Special Character
    • Kirjoita Characters To Insert -kenttään haluttu merkki tai merkit, esim. "ä" ilman lainausmerkkejä
    • Paina OK

    Periaatteessa edellistä on toistettava niin usein kun erikoismerkkejä tarvitaan. Suomen kieltä kirjoitettaessa se olisi kuitenkin erittäin työlästä, joten kannattaa menetellä seuraavasti:

    • Kirjoita aiheen teksti normaalisti ääkkösten kanssa
    • Valitse Edit-valikosta Find & Replace
    • Kirjoita Find What -kenttään muutettava merkki, esim. "ä" ilman lainausmerkkejä
    • Kirjoita Replace With -kenttään kirjainta vastaava koodi. Koodit ovat seuraavat (älä unohda hakasulkuja):

        pieni ä {\'E4:}
        pieni ö {\'F6:}
        iso Ä {\'C4:}
        iso Ö {\'D6:}

    • Varmista, että Match Case -asetus on valittuna, ja paina Replace All

    Edellistä on siis toistettava jokaiselle erikoismerkille erikseen, siis yleensä neljä kertaa, jos kirjoitetaan suomeksi. Sama on vielä toistettava jokaiselle aiheelle erikseen. Muutos kannattaa suorittaa vasta kun aiheen teksti on tarkistettu, sillä teksti on korjauksen jälkeen melko vaikeasti luettavaa. Lisätietoja saat Ohje-tiedostosta kohdassa How To's, Creating Topic Text, Inserting Special Characters, tai nopeammin etsimällä hakusanaa "Special characters, inserting".