Note

Unless you are still using Windows 98 and a very old version of Microsoft Word, you might find the Autohotkey script for Esperanto accents more suitable. That script lets you type Esperanto accented characters in nearly all (modern) Windows programs, whereas the Microsoft Word template (below) only works for Microsoft Word.

About Esperanto Template.dot

You can download this template bundle in a zipfile from http://wgtw.co.uk/software/eotempl.zip, or run the individual install programs by clicking on their links in the text below.

New! Now with slightly easier installation.

Introduction

"Esperanto Template.dot" is a template file for Microsoft Word for Windows™ (hereafter called just Word), that allows you to create text with Esperanto accented characters.

The template works with Word 97 and beyond (including Word 2000 and Word 2002), but it is not suitable for earlier versions of Microsoft Word, e.g. Word 95 or Word 7).

Disclaimer: This template was created by Vilĉjo Walker. It is supplied without guarantees. I believe that it works correctly, but I accept no responsibility for any loss caused by problems or errors with the template or its installation.

Do note that the enclosed KL3 spell checker is copyright of its own author, and comes with its own operating conditions (described below).

This page explains about Set-up, Creating a new Esperanto document, Typing Accented Characters, the Esperanto Spelling Checker, Other Commands, Other Programs, Optional Manual Installation, and Updates.

Set-up

This description refers to the English/US versions of Microsoft Windows and Word. If you use other language versions, the names of the programs and commands might be differ.

1. Set-Up Windows

If you can see these accented Esperanto characters here (ĈĜĤĴŜŬ ĉĝĥĵŝŭ) then your computer has already been set up to support the necessary Unicode range Latin-Extended A, and you can go straight to step 2.

If you don't see accented Esperanto characters here (ĈĜĤĴŜŬ ĉĝĥĵŝŭ) then you'll need to set up Windows to display them. (Note that you'll probably need your original Windows installation discs for this step...)

In Windows XP and Windows 2000:

  1. From Control Panel choose Regional Options
  2. Choose the General tab.
  3. In Language settings for the system...
  4. put a tick against Central Europe, then click OK. See a picture..
In Windows 98 and Windows 95:
  1. From Control Panel choose Add/Remove Programs.
  2. Choose the tab Windows Setup.
  3. Scroll down the Components list and
  4. put a tick against Multilanguage Support. See a picture.

2. Install the Template

For this step, you'll need to know where Word keeps its template files. To find out:

  1. Start Microsoft Word, and do the menu command File, New. See a picture.

  2. If you're using Word 2000 onwards, you'll then need to click the General Templates... link below the New from Template heading; see a picture.

  3. (Whatever version of Word you're using) you should now see a list of available templates.
    Choose the General tab, then right-click on Blank Document and choose Properties.
    This shows you the properties of a template called Normal.dot; make a note of its Location.
    In this example the Location is C:\Program Files\Microsoft Office\Templates.

  4. Tip: Select the location string then press CTRL+C to copy it to the clipboard; then, later, instead of having to re-type it, you can simply press CTRL+V to paste the location string

  5. Common locations for Word's template files are:
    C:\Program Files\Microsoft Office\Templates
    or
    C:\Documents and Settings\<user name>\Application Data\Microsoft\Templates

  6. After you've noted or copied the folder location, click Cancel to close the Properties box, and Cancel again to close the File, New... dialogue.
Now click on this link to run the installer instempl.exe; type or paste the templates location (which you noted, above) into the Install to box, then click on Install. See a picture.

This installs the Esperanto Template.dot into your Word templates folder.

3. Install the spell-check utility

If you want be able to use the Esperanto spelling checker, click on this link to run the installer inskl3.exe; click on the Install button, but this time do not change the location in the Install to box. See a picture.

Note that you do have to pay a (trivial) sum to use the spelling checker program; see below.

Windows Vista: Unfortately the KL3 program doesn't run directly in Windows Vista; it's necessary to us a separate program DosBox to run it. That is a more complicated set-up activity, which the installation program (above) doesn't do.

Creating a new Esperanto document

When you want to work with a new Esperanto document in Word, you first have to create an empty document, based on the Esperanto Template. The procedure for this depends on whether you are using Word 97, or Word 2000 onwards.

In Word 97:

  1. Do the menu command File, New.... See a picture.
  2. Choose the General tab, select Esperanto Template.dot then click OK. See a picture.
    This creates a new, empty document ready for your Esperanto text.
In Word 2000 onwards:
  1. Do the menu command File, New.... See a picture.
  2. Click the General Templates... link below the New from Template heading. See a picture.
  3. Click on Esperanto Template.dot, then click OK. See a picture.
    This creates a new, empty document ready for your Esperanto text.
  4. In future, when you start Word, you can take a short-cut by simply clicking the new Esperanto Template.dot link in the New Document bar. See a picture.

How to Type Accented Characters

While you are working in a document created from the Esperanto Template.dot template, the key X is the 'accent' key; it puts an Esperanto accent on the previous letter. Thus keys H then x will give Ĥ (accented H), h then x will give ĥ (accented h). Press x a second time to remove the accent.

The letter x is not part of the Esperanto alphabet and so does not occur in Esperanto words. If you want to have the letter x itself (for example, when typing a place-name or a foreign word), either press keys z then x, or press ALT+x. To have upper-case X, press upper-case Z then x, or SHIFT+ALT+x.

You can also use the x key to turn the dollar character $ into the Euro currency character and vice-versa.

Esperanto Spelling Checker "Kontrolu Literumadon"

The template links to an optional Esperanto spelling checker, called KL3 ("Kontrolu Literumadon"). This checks your text and highlights any words that it doesn't recognise. Note that you can't actually change the text on the KL3 screen; you have to note which words are in error and then, after KL3 has finished checking the text, you'll be returned to Word where you can make any necessary changes.

To launch the utility KL3 from within Word, either

... then an (English) dialogue asks if you want to check the selection or the whole document. Word will do some work, preparing a temporary copy of your text to give to KL3, and then you will see the black-and-white screen of KL3 with any unrecognised words highlighted.

Within the KL3 screen, the keys:

To add a word to KL3's dictionary of 'correct' Esperanto words, choose menu command Tools, Eo Add Spell. This command asks for the word to be added - if you have already selected a word in the text, it proposes this word. To show accents in the input box, type the letter x (so to enter Vilĉjo, type Vilcxjo). If the word is an exact Esperanto root, put a space between the root and the ending (o, a or i ), thus: 'dom o'.

Please note this condition, attached to the use of the KL3 spell-checker:

This program (KL version 3.0) is provided without guarantees.

You may try it for free, but if you use it for more than two weeks, I request that you pay for it. Please send $10 (Canadian or US), or ¥1000 (Japanese yen) to the address shown below. If that is inconvenient, you can pay 14 guilders to my account with UEA (account code lndn-d).

If you have already paid for a previous version, it is not necessary to pay again. You may distribute this program, but please do not charge more than your expenses for disks and postage.

Klivo LENDON, 1-15-2 Tama-machi, Fuchu-shi, Tokyo 183, Japan
indriko ĉe yahoo.com

For more details about the component files of KL3, click here.

If your document contains both Esperanto and English text, and you want to use Word's English language spell checker, chose menu command Tools, Spelling. Note that you can 'hide' Esperanto text from the English spell checker by selecting it then doing the command Tools, Set Language, and choosing (no proofing).

Other Commands

While you are working on a document created with the Esperanto Template.dot template, you have several new commands available:

Menu command Insert, EoDate will enter today's date, as Esperanto text, in the style: YYYY mmmm dd. For example: 2004 aprilo 23.

Menu command Tools, Recode Supersigns... gives a choice of transforming text from various coding conventions to either Unicode or x-code letters. Among the source-format choices are Cx, Ch, various C^ and C<, the Alfadelta (DOS) and Werdin (also known as "Mono") conventions. Because some authors use au for , you can also choose to 'search and replace' this letter pair. At the top, a dialogue asks if you want to change just the selection, or the whole text document.

Toolbar button , or menu command Tools, EoSpell, or key <f7>, launches the KL3 utility which checks Esperanto spelling (see above).

Menu command Tools, Eo Add Spell adds a new word to KL3's dictionary of 'correct' Esperanto words (see above).

Menu command Tools, Macro shows various macros (little programs) used by the template. If the special key definitions are accidentally lost, use the macro DefMacroKeys to reinitialise them..

Other Programs

Outlook Express: If you want to paste blocks of text containing accents into an Outlook Express e-mail message, make sure that the message is Rich Text (HTML) format and not Plain Text; in the message window, do menu command Format then select the Rich Text (HTML) option. Note that the block of text you paste cannot have an accented character as its first character (otherwise this first accent gets lost); if necessary put a space in front of the first character, before copying the block.

Netscape Composer: If you want to paste Unicode Esperanto accented letters into a Netscape Composer document, you must first choose the menu command View, Character Set... and select Unicode (UTF-8).

Manual Installation

If you don't trust auto-install .exe files, you can download a zipfile of the component files as eodocdot.zip, and then unpack it yourself.

The file Esperanto Template.dot must go in the Word templates folder.

The other files are used by the KL3 spell-checker, and must go in the folder C:\Program Files\Utils (otherwise the macros in the Word template can't find them).

File List
Esperanto Template.dot
KL3.EXE
KREUSUPL.EXE
KL3.TXT
KL.BAT
ADD_VORT.BAT
SUPERSGN.INF

For more details about the component files of KL3, click here.

Updates

Version 2002 January: This now creates the necessary folder C:\temp if it doesn't already exist, and checks the presence of the necessary KL files if the Eo SpellCheck command is chosen.

Version 2003 December: Renamed the template file from Eo doc(Unicode).dot to Esperanto Template.dot and packaged the component files in self-installing zipfiles.

[return to Software Downloads Index Page]


Acknowledgements and thanks go to Matt Tellier for help with the auto-install zips and Windows XP details.

Author: wgtwalker at wgtw.co.uk
Date Posted: March 2009