Ĉapelanto

Legu ĉi tiun paĝon Esperante.

Display Esperanto accents correctly on PalmOS handhelds

	Do you want to see the right-hand image instead of the left? Ĉapelanto can help!
Before		After

Introduction

What is Ĉapelanto?

Ĉapelanto is a Hack for Palm handhelds (and all other compatibles, such as Handspring, Symbol etc.). It works correctly on all PalmOS systems from PalmOS 2.0 onwards, including PalmOS 5.

If you have an old version of Ĉapelanto and want to know what has changed, you can read the change history.

Where is Ĉapelanto?

You can download Ĉapelanto from here. The download is a ZIP file, which contains the Ĉapelanto files and this manual.

How do I install Ĉapelanto?

Within the ZIP file, as well as this manual, you will find three other files: Cxapelanto_os2-4.prc, Cxapelanto_os5.prc and Sistemoj.pdb. You must install either Cxapelanto_os2-4.prc (for PalmOS 2.0 - PalmOS 4.x) or Cxapelanto_os5.prc (for PalmOS 5.0+) on your Palm. You do not have to install Sistemoj.pdb, but I recommend that you do install it. It contains many pre-defined encoding systems, which will help you avoid the effort of creating them yourself.

Note: To use Ĉapelanto, you need HackMaster or a similar compatible program, such as YAHM. For Ĉapelanto to work on PalmOS 5, you must use YAHM as no other Hack program currently supports ARM hacks. If you do not have a suitable program already, you can download the freeware YAHM from here and install it on your handheld. You can install it at the same time as Cxapelanto.prc and Sistemoj.pdb.

Basic use

How do I configure Ĉapelanto?

Run your HackMaster program and enable Ĉapelanto. How you do this depends on your program. Next choose the "configure" option for Ĉapelanto. Again, this depends on your HackMaster program. For example, with HackMaster, you press the "+" button next to Ĉapelanto; For X-Master you select Ĉapelanto and press the "Configure" button. For YAHM, you can do either!

You will see the following form (see right). This form has three controls: Por: (For:) This control selects the application that you are configuring. The "Aprioraĵoj" (defaults) selection controls the configuration for all applications that do not have their own individual configuration. Uzu: (Use:) This control selects the encoding system that you will use to recognise Esperanto accented letters in the application being configured. It also defines the system that will be used to encode any new text that you enter in this application. Kaj ankaŭ rekonu: (And also recognise:) You can also choose to have Ĉapelanto recognise letters that are encoded in other systems. For example, if you are reading e-mail messages on your Palm, they are often encoded in a number of different systems. So, you can choose to also recognise these other systems by ticking the checkboxes in this control.

Explanation of the pre-defined systems

Most of the system names are (I hope) self-explanatory. For example, "^C ... ^u" means that the system recognises ^C, ^G, ^H, ^J, ^S, ^U, ^c, ^g, ^h, ^j, ^s and ^u as representing accented Esperanto characters. The following systems perhaps need to be explained:

Example

Here's an example of the Ĉapelanto configuration page. You have decided that you will use the "Cx ... vx" sistemon as your main system and you also want to recognise "Cx ... ux (sekura)" kaj "CX ... ux (sekura)".

1.  2.  3. 

First you choose the main system (1). Next you tick the other systems that you want to be recognised (2). Finally you press "Konfirmu" (OK) to save your configuration (3). If you do not want to save your changes, you can press "Rezignu" (Cancel).

How do I use Ĉapelanto?

After you have configured Ĉapelanto, it works more or less automatically. The only additional information you need to know is how to enter accented characters.

How do I write Esperanto characters?

Obviously you can enter the characters by just writing the letters of your selected system. For example, if you chose the "Cx ... ux" system, you can write "cx" and "ĉ" will appear. However there is also a Graffiti method that doesn't depend on the chosen system.

You can enter Ĉ, Ĝ, Ĥ, Ĵ, Ŝ, ĉ, ĝ, ĥ, ĵ or ŝ by writing the basic letter and then using the circumflex stroke. For example, to enter "ĉ", you first write: and then:

You can enter Ŭ or ŭ by writing the basic letter and then the tilde stroke. For example, to enter "ŭ" you first write: and then:

If you can't remember the accent strokes, they are given in the help for Graffiti.

How do I type Esperanto characters?

There are two ways of typing the accented Esperanto letters. You select the desired method using the Klavaro: (Keyboard) control.

• If you choose the normala (standard) keyboard, the keyboard works as normal and if you selected, for example, the "Cx ... ux" system, you can type "cx" and "ĉ" will appear.
• If you choose the x-morta (dead x) keyboard, the x key acts as a "dead" key for adding accents. So, if you first type "x" and then "c", "ĉ" will appear. To enter an "x", you must type "xx". This method is better if you have selected a system that has letters that are difficult to find on the standard keyboard. For example the "C` ... u`" system uses the difficult to find character "`".

As with the encoding systems, you can give a particular application its own keyboard configuration.

How do I sort my address book?

Ĉapelanto also ensures that text is sorted according to the order of the Esperanto alphabet. However note that the Palm address book does not re-sort itself automatically when Ĉapelanto is enabled. If you already have Esperanto names in your address book, you can sort them correctly as follows:

1. In the address book program choose the "Options" menu and then the "Preferences..." item.
2. Change the "List By" option to the other setting and press "OK".
3. Repeat the first two steps to return the configuration to the original.

After you have enabled Ĉapelanto, any new name that you enter will be sorted correctly.

Advanced use

This section describes things are aren't often used.

How do I create special settings for a specific application?

There are possibly two reasons for giving an application a configuration that differs from the default:

1. You have an application that encodes its characters using a system not recognised by default. You don't want to add to the default settings e.g. because it would be confusing or conflict with another system already in the default settings.

   A good example is the mail program. Because you can receive messages encoded in many different systems, you need to recognise many systems in this application. However you perhaps don't want to enable these systems for all applications because this would cause problems. So you can give the mail program its own configuration.

2. You have an application that never uses Esperanto characters but it has letters that are the same as Esperanto encoded letters. Ĉapelanto is erroneously translating these letters and you want to disable it.

   You can do this by choosing the "neniun" (none) system as the default and then unchecking all the checkboxes.

Example

You have installed the Esperanto bible from Olive Tree. This uses the "C` ... ù" system, which differs from your default configuration.

1.  2.  3. 

First, select the application that you want to configure (1). Next select the new main system and uncheck the other systems that you don't want to be recognised in this application (2). Finally, press "Konfirmu" (OK) to save your new configuration (3).

Note: You can change both the default settings and the settings for multiple applications before pressing "Konfirmu" (OK). All changes will be saved.

How do I revert an application to the default settings?

All applications that have their own custom settings,

1. are marked in the application menu, and
2. have an "Apriorigu" (Change to default) button that you can press to return the application to the default settings.

Example

You want to reset the settings for "BibleReader" to the default.

1.  2.  3. 

First you select the application you want to reset. Note that the application is marked in the menu (1), and this configuration has the "Apriorigu" (Change to default) button (2). You press the "Apriorigu" button, and the configuration is reset to the default. Note that the "Apriorigu" button disappears (3). As usual, you press "Konfirmu" (OK) to save the new configuration.

How do I create a new encoding system?

The most common Esperanto encoding systems are provided in Sistemoj.pdb, but if you want to add a new system or look at the existing systems, you can use the "Sistemoj" (Systems) form. Press the "Sistemoj..." (Systems...) button (which is only visible when you are configuring the defaults) and you will see the "Sistemoj" form: Here you can look at the systems. You can see the letters that make up the code, though for some systems (e.g. utf-8) the hexadecimal codes for the characters are more important. So, you can show these codes by pressing "Montru: Kodojn" (Show: Codes) (see right). You can create a new empty system by pressing "Nova..." (New...), or create a copy of the currently visible system by pressing "Kopiu..." (Copy...). If you want to change the current system, press "Ŝanĝu..." (Change...). When you create or change a system all the fields are editable. If the letters are visible, you can select the letter and write in a new letter. If the codes are visible, you can tap the code buttons to change the code. There are two checkboxes for specifying "safe" systems. These checkboxes limit when Ĉapelanto recognises the encodings of "ŭ" and "Ŭ". Note, you can only see and select the second checkbox after the first has been checked. You can remove systems that you don't need. The "Forstreku" (Delete) button is visible when you are editing a system. Note that you can't delete a system that is currently in use in a configuration. In that case the button isn't shown.

Afterword

Thankyou for using this tool. If you have comments, suggestions or problems, please contct me via the e-mail address below.

Contact details

Tel: +44 (0) 1223 721516
GSM: +44 (0) 7779 355983
E-mail: cxapelanto@micropraxis.com
WWW: www.micropraxis.com