Start with an existing Windows keyboard
This tutorial refers to a Google Shared Drive which was part of a workshop training. You can save your Keyman projects in your preferred location.
A Keyman Project contains the various parts of your keyman keyboard definition that are required for creating a distributable or downloadable package. These files and the project file itself are stored on your hard drive in the folder with the same name as your project.
- Start Keyman Developer
- Project > New Project
- Click on the icon Import Windows Keyboard, then
- Complete information as follows:
- Choose Persian (Standard). Find by typing p and choosing the 2nd one, click
- Fill out - Name:Hazargi, Copyright: 2020 My Company, Author: Me
- Target: any
- Languages: remove fa, Add haz, leave defaults, click
- Browse, go to the shared Google folder
- ID: hazargi (lowercase!)
Make sure that all the options are correct here because this dialog box can't be re-opened after you click OK. To make changes later, you would have to either edit the XML file manually or delete the project file and start over.
- Click
-- now you have a project
- Choose Persian (Standard). Find by typing p and choosing the 2nd one, click
- Click on the Keyboards tab
- Click the plus sign next to hazargi.kmn
- Click on hazargi.kmn blue link (now you have two top tabs)
- Name: Hazargi, Targets: Any, click Keyboard is right-to-left.
- Modify the layout:
- Click on the Layout big button
- Click on e key, note the Unicode value and output char. below
- Click in text box for Output char., erase what’s there
- Go to Character Map, type peh
- Double-click to insert it.
- Go to Build Area
- Click Compile Keyboard - should get Success (twice)
- Click Keyboard > Test
- Install the Debug Host Keyboard (if necessary)
- Type the e key and you should see پ (U+067E)
- To stop testing select Debug > Stop Debugger
Start with a blank keyboard
- Start Keyman Developer
- Project > New Project
- Click on the icon Basic, then click
- Complete information as follows:
- Fill out - Name: Hazargi Phonetic
- Target: any
- Languages: Add haz, leave defaults, click
- Browse, go to Google Shared folder
- ID: should be hazargi, click
-- now you have a project
- Click on the Keyboards tab
- Click on hazargi_phonetic.kmn blue link
- Targets: Any, RTL box
- Modify the layout:
- Click on Layout
- Click on p key, note: Unicode value and output character are blank
- Click in the text box for Output ch.
- Go to Char. Map, type peh
- Double-click to insert it (067E).
The project is a place where various parts of your keyman keyboard definition are accessible. On your hard drive the files, including the project file, live under the folder with the same name as your project.
If you have an existing Keyman keyboard, use the Add existing keyboard... button to add it.
- Go to Build Area
- Click Compile Keyboard - should get Success (twice)
- Click Keyboard > Test
- Type the p key and you should see پ (U+067E)
Start with an English US Windows keyboard
No visual keyboard layout display. Why? Because there’s complex code.
- Start Keyman Developer
- Project > New Project
- Click on the icon Import Windows Keyboard, then click
- Type US and go down one to the US (KBDUS.DLL) row, then click
- Complete information as follows:
- Fill out - Name: Fulfulde
- Target: any
- Languages: Add ffm, leave defaults, click
- Browse, go to Google Shared folder
- ID: should be fulfulde, click
-- now you have a project
- Click on the Keyboards tab
- Click on fulfulde.kmn blue link
- Targets: Any
- Click on Layout (It takes you automatically to the code view)
- Click Design and see the error message
- Try cutting the code out temporarily. Design can be used.
- Change K_1 to map to ‘P’. Click On-Screen button, then Fill from layout. Click
to overwrite. See the ‘P’ on the 1 key. F7 to compile. Debug > Stop Debugger