Menu

DeveloperDocumentation

Anonymous

Introduction

The best way to use this documentation is to jump straight to the operating system you want to develop for. Go there and find the information that is useful to you!

Linux, Ubuntu

The Linux version of the kasahorow keyboard comes as a download of a single zip archive. You can download the keyboard from kasahorow.org.

Follow these instructions to install and test the kasahorow keyboard:

  • Copy the Africa X keyboard definition file "africa" in the linux folder to /etc/X11/xkb/symbols
  • Create a backup copy of your existing xorg.xml file in /etc/X11/xkb/rules/xorg.xml
  • Copy the xorg.xml file in the linux folder to /etc/X11/xkb/rules/xorg.xml
  • Use the gnome/KDE keyboard switcher to choose and use the Africa Keyboard

You may modify the files in order to generate your own keyboard layouts. For testing purposes, all the proposed keyboard layouts are being distributed as a single file. This will appear under the folder "linux" as one keyboard layout with many variants. After going through testing and acceptance, the keyboard definitions will be grouped first, by country and second, by language with the respective currency symbol defined.

Linux, OpenBSD

  • Follow the instructions as for Ubuntu above
  • Copy the layout you want to /etc/X11/xkb/symbols/pc
  • In the absence of a keyboard switcher, use setxkbmap -rules xorg -layout <iso-code>. The iso-code (name you have given to the layout really) could be for example gbe

Windows, XP

The windows keyboard definition files are provided as Microsoft Keyboard Layout Creator 1.4 files. You will need to download and install this package. Use the MKLC tool to compile and install each of the keyboards you want to test.

To do this, perform the following steps:

  1. Go to Microsoft's website to obtain the MKLC tool.
  2. Install the MKLC tool by following instructions provided by Microsoft.
  3. Lunch the MKLC tool from the Start >> All Programs menu.
  4. From the file menu, select "Load Source File" and use the "File Open" dialog box to locate and open the klc keyboard definition files in the "windows" folder that comes with your download.
  5. The selected keyboard layout is displayed. From the Project menu, select Validate menu. Windows may return with warning message. These are safe to ignore. If it fails, review the error log it provides you for a clue to resolving the problem. Eg. You cannot build a keyboard package that is currently installed on your computer.
  6. Again, from the Project menu select “Build DLL and Setup Package”
  7. A setup package is created in your current working folder, which is "My Documents" by default.
  8. From windows explorer, navigate to your working folder and lunch the double click on the setup.exe file for your system architecture to launch the installation wizard. Follow the on-screen instructions to complete the installation.
  9. To select the installed keyboard for testing, navigate to the Control Panel and launch the "Regional and Language options" component.
  10. The Regional and Language Options window opens. Click the "Languages" tab, and click the "Details" button.
  11. The Text Services and Input Language window opens. Click the Add button to open the Add Input Language window.
  12. All the keyboards are currently assigned to English language for testing purposes, as not languages have locale support under windows.
  13. Select the "Keyboard Layout/IME" checkbox to activate installed keyboards drop down list.
  14. From the drop down list, select the keyboard youíve just installed and click OK.
  15. Click OK again, to close the Text Services and Input Language window.
  16. A small keyboard icon will appear on windows task bar. Use this icon to switch between installed keyboards.

Macintosh, OS X 10.5

Help!

Contact kasahorow for assistance if you encounter any difficulties.


MongoDB Logo MongoDB