spiegel-keyman/developer/docs/help/guides/develop/tutorial/step-7.md
Marc Durdin b751336c13 refactor(developer): copy dev 17.0 help into repo
1. Copy help.keyman.com/developer/17.0/* into /developer/docs/help
2. Update references to 18.0 where appropriate
3. Copy all referenced images from /cdn/dev into
   /developer/docs/help/images and update links in documentation

Next commit: add deployment to help-keyman-com.sh. Note: simplest way to
test links at this point is to use the help.keyman.com auto deploy and
wait for the PR on help.keyman.com to be validated; we could look at an
internal link validation tool that verifies markdown links?

Relates-to: #12347
2024-09-16 08:46:24 +07:00

1.8 KiB


title: Step 7: Testing the Keyboard

Compiling the Keyboard

Before we can test the keyboard, we must compile it. Choose Keyboard, Compile Keyboard or press F7 to compile the keyboard. The Message window will display the results of the compilation; if you have no typing errors, the keyboard should compile successfully.

If there are any mistakes, an error message will be displayed in the Message window, which will tell you the line on which the error occurred.

Compiling the Keyboard

After compiling the keyboard successfully, we can start testing it. Choose Debug, Start Debugging or press F5 to begin testing. The Keyboard debug window will appear.

Now we test that all the rules operate as expected. To test the rules, we type the keystrokes that will give us the output; for example, we can type a quote ' followed by one of A, E, I, O, U, or Y to test the uppercase acute-accented vowels. Similarly we can test the other accents, and C-cedilla (Ç) and the angled quotes. If the rules are correct, all this should work as we wanted.

Testing the rules in isolation like this will show if the rules are correct or not, but won't show other possible errors that might occur in everyday usage of the keyboard. For example, look at what happens if you type the following quote:

'Alors Alice demande, "Où est mon chat ?"'

As you can see, it comes out incorrectly as:

Álors Alice demande, Öù est mon chat ?"'

The problem occurs when we have a word in quotes that begins with a vowel: the keyboard will convert it to an accented vowel. We will need to come up with a solution to this problem.