The Filter allows a user to reduce the number of characters displayed in the character map. The standard filter options used are by font name or block name.
The Character Map Grid displays each character in a square, with a visual representation of the character and the Unicode value displayed at the bottom of the square. Each font group is divided into a block headed by the font name.
The name of the keyboard is displayed in Keyman Configuration, in the tray menu and in many other places. It should be a descriptive name, in any language, but remember that some applications may use a font that does not include the language you are writing the keyboard name in. Don't include a version number, help information or hotkey in the name.
This corresponds to the following source line:
Specifies the platforms for which this keyboard is designed. Where possible, use more generic targets, for example, use
Your keyboard should be either Unicode or Codepage based. Most keyboards today will be Unicode. If you are designing in the source editor, you can create a keyboard that is includes both Unicode and Codepage (or "ANSI") rules.
This corresponds to either of the following source lines:
Copyright details for the keyboard are displayed when the keyboard is installed. They can also be viewed in Keyman Configuration.
The message provides some additional information to a user of your keyboard, when they install the keyboard.
In this field, enter information about the keyboard for your own reference. These comments will only be visible in the source file, and not to users of your keyboard.
The comments are placed at the top of the source file, e.g.:
To select another key in the keyboard, either:
Select this option to tell KeymanWeb to flag text entered by this keyboard as right-to-left (e.g. Arabic, Hebrew)
A simple line of text to show under the On Screen Keyboard in KeymanWeb. Can contain HTML formatting and links. Mutually exclusive with the Help File box
More complex help can be included by including an external file. See the European Latin keyboard in Samples for a comprehensive example.
Choose a help file to include in the keyboard
Compiles the keyboard for KeymanWeb. Two output files will be generated: [filename].js and [filename]_load.js. The KeymanWeb Tutorial contains more information about the difference between the two output files.
Tests your KeymanWeb keyboard in an Internet Explorer embedded window
The Change option allows the editing of the icon filename.
The Export option allows the exporting of the new image to a selected location.
The import option allows for the loading of an existing icon from a selected location.
The toolbox allows for the changing of the colours, addition of text and shapes. It also allows for the moving of the icon around the canvas and also a preview of the icon is displayed.
A custom on screen (visual) keyboard can be included with your new keyboard. Check this option to display the on screen keyboard and options available.
On European Keyboards a 102nd key is added. This allows you to map a character on the 102nd key.
This option allows the user to choose whether the keyboard icon is displayed on the taskbar and to customise the look of the icon. Check the Include Icon on the Taskbar to display the icon bitmap editor.
Allows for more combinations and also leaves the left Ctrl and Alt keys for general keyboard shortcuts, for example Ctrl C for Copy and Ctrl V for Paste.
This option adds the keyboard to the current active project.
Select this option to begin the compiling of the keyboard. The success of the compile is displayed at the bottom of the screen. If errors are displayed, click on the Start Debugging button.
Insert Copyright
This allows for the insertion of a copyright symbol if needed.
Install the compiled keyboard on to the computer.
To test on other platforms, open one of the debug host addresses on your device. Your device will need to be on the same network as this computer.
You can test within the web browser on your device, or in the native app if you have it installed: just click the Install button on the debugger web page.
The Send to email function makes it easier to open the addresses on your mobile device without having to enter them manually.
This option will open the folder that contains all the files saved for the new keyboard project.
This option will allow for the debugging of a keyboard that could not be compiled and specific errors are displayed. It will direct the user to the source code of the keyboard file.
Uninstall the keyboard from the computer.
This option allows the user to upload the compiled keyboard to Tavultesoft website to allow the sharing of the keyboard files.
The change button allows the change of the filename and/or location of the on screen keyboard.
begin ANSI > use(main)
begin Unicode > use(main)
store(&message) 'Here is a message about a keyboard''
If the Unicode value is known, enter the value and the corresponding character will be displayed on the key.
To add additional details about the keyboard. The message will be displayed when the keyboard is selected in Keyman Configuration.
Click on the key with the mouse, or
Press and release the Ctrl key to choose with the keyboard
KVK Filename
Displays the file path and file name of the Keyman Visual Keyboard (KVK). Press the END key on your keyboard to view the filename or click on the Change button to change the filename and location.
If selected, then the visual keyboard will only be used if the current underlying layout is active.
Display 102nd Key
This allows for a bitmap/picture to be displayed on the selected key. Click on the Browse button to select the bitmap.
Export the keyboard to other file formats (HTML, BMP, or PNG), for use in documentation. Export the structure of the keyboard to XML format for automated processing.
Import an existing on screen keyboard layout.
Use the same layout as the new keyboard, assigning the same characters to the same keyboard letters.
Allows the user to enter text to be displayed on the selected key.
The Touch Layout tab is used to create the visible representation of the keyboard layout for touch devices. It works similarly to the On Screen Keyboard Editor conceptually, but has a number of additional features specific to touch. Keys on the touch layout trigger rules within the normal Keyman keyboard; if no rule is defined for a given key, it will be given output if it has a standard code beginning with K_, or if it is a Unicode value code, starting with U_.
K_
U_
Keyman Developer Debugger
Debug information must be included in the compile keyboard before the debugger process can be started. From the Keyboard menu select Include Debug Information. The debug information will display the error sources when compiling.
The debugger can be used without the debug information by clicking on Test without debugger.
Enter the name for your new keyboard. Click on the Browse button to change the location of the new keyboard.
You can include an image file that will be displayed to the left of the install details when the package is installed. This image should be 140 pixels wide and 250 pixels high.
The readme file can be displayed after the installation of the keyboard package, but can also be accessed from the keyboard folder at a later time. The file must be loaded under the Files tab, add option before being able to be selected from the drop down list.
This option will allow you to create a folder on the Start menu when the keyboard package is installed.
The uninstall shortcut will be added automatically to the shortcut menu list when the package is installed.
This option allows the user to add new files to the package.
To delete the selected shortcut menu item from the Start menu folder.
A readme file can be a text file (ANSI, UTF-8, or UTF-16), or an HTML file (recommended). Other file types are also acceptable, but the package installer will load the file in a separate program.
You should try installing your package on your system before distributing it, to ensure that all files are installed correctly. If you can, try installing your package on several different machines.
Displays the output path and filename of the file when the package is compiled.
Creates a self-extracting installer consisting of the package plus Keyman or another Keyman Engine product that was created with the Branding Pack.
Displays the output filename and path for the self-extract installer.
Chooses a product installer, such as the Keyman installation source. You can download Keyman installers from keyman.com.
This option allows the user to add the compile package to the project, keeping all files together in the one location.
This option checks the package has all the required files and for any errors. The success of the compilation is displayed at the bottom of the screen.
This option will install the package on the computer. A message will be displayed as to the success of the install.
To add a new menu item to the list of shortcuts to be displayed in the Start menu folder created when the keyboard package is installed.
Opens the source folder of the selected file.
This option will open the folder the selected package is located in.
This option allows the user to edit the selected file if the appropriate editor is available.
This option allows the user to remove a selected file from the list.
This option will uninstall the package from the computer. A message will be displayed as to the success of the uninstall.
This option will enable the developer to upload the package to the Tavultesoft website.
Displays the location of the selected file.
File Type
Enter the details of the file type being added to the keyboard package.
Enter the name of the author or authors of the keyboard package.
Enter the copyright details of the keyboard package This information will be displayed with the version, author and message information when the package is installed.
Enter the contact email address for the keyboard package.
Package Name is the name that will be displayed when the package is installed. It should be a descriptive name, in any language, but remember that some applications may use a font that does not include the language you are writing the keyboard name in. Don't include a version number, help information or hotkey in the name.
The version number allows the user to check whether they have the latest version of the keyboard. The format should be 'major.minor[.subversion]'. Each number should be an integer, and you should avoid non-integer version strings. See help for more details.
The website details for the keyboard package if available.
The text to be displayed for the selected file as a menu item in the Start up folder that is created when the package is installed.
Start Menu Path
Enter the path of the start menu to be displayed when the keyboard package is installed.
This will display all the files that have been added to the keyboard package. It allows for the addition and removal of files, the entering of file details and the editing of any of the files listed if the appropriate editor is available.
This option allows the user to enter details and other additional information about the selected file.
The Project Manager allows you to manage all the files related to a keyboard layout in a single location.
This dialog lets you check the virtual key code for any key combination (except Window reserved key combinations such as Alt + Tab). You can then insert the virtual key code into the last active edit window at the current cursor position.
Press Shift + Enter to insert the current virtual key code into your source at the insertion point.
You can see the virtual key codes for left and right Ctrl / Alt combinations by checking the "Distinguish between left and right ctrl/alt" checkbox.
To close the dialog, click the Close button or press Shift + Esc.