diff --git a/developer/docs/help/guides/develop/touch-keyboard-tutorial/gestures.md b/developer/docs/help/guides/develop/touch-keyboard-tutorial/gestures.md new file mode 100644 index 0000000000..d39d86891f --- /dev/null +++ b/developer/docs/help/guides/develop/touch-keyboard-tutorial/gestures.md @@ -0,0 +1,26 @@ +--- +title: Using Gestures in Keyman Developer +--- + +Keyman Developer offers **Longpress** keys, **Flicks**, and **Multitaps** for touch keyboard layout. To allow gestures onto your keyboard, go to the Touch layout tab and define the keys as followed: + +Keyman Developer touch layout gestures + +## Tips + +* We can use both **flicks** and **long presses** in a single keyboard. Generally, we recommend only having flicks in one direction--south (down), and long presses work well with this pattern. See, for example, [sil_euro_latin](../../../../keyboard/sil_euro_latin/3.0.3/sil_euro_latin#toc-mobile-keyboard-layout). + * You’ll also notice on sil_euro_latin that the south-flicks on the base (and shift) layers correspond to the numeric/symbol layer, which is also helpful for remembering and discovering. +* **Flicks** in multiple directions are possible, but currently Keyman does not support hints for multiple directions, so they are not very discoverable. +* **Long presses** are more discoverable, but **flicks** are faster. We suggest using south flicks along with long presses, and including the flick output in the long press for maximum discoverability and optimum ergonomics. + +## Caution + +* **Flicks** near screen edges tend to be problematic--once you drag off the screen, then Keyman can no longer tell that you are flicking (or you may end up activating system controls on the bottom edge): + * On the bottom row, south flicks are not recommended. + * On the top row, we have the banner space reserved in order to be able to support flicks and long presses up into that region of the screen--not an ideal solution, but it works. + * Left/right screen edges, horizontal flicks are not the best practice. + +## See also + +* The [Winchus keyboard](../../../../keyboard/winchus/1.4/winchus#guia-rapida-celular) +* The [GFF Amharic keyboard](../../../../keyboard/gff_amharic/3.2.1/gff_amharic#toc-using-this-keyboard) \ No newline at end of file diff --git a/developer/docs/help/images/touch-keyboard-tutorial/touch-layout-gestures.jpg b/developer/docs/help/images/touch-keyboard-tutorial/touch-layout-gestures.jpg new file mode 100644 index 0000000000..1d407cc22a Binary files /dev/null and b/developer/docs/help/images/touch-keyboard-tutorial/touch-layout-gestures.jpg differ diff --git a/developer/docs/help/main/credits.md b/developer/docs/help/main/credits.md index f2c8a027c5..a4c2124870 100644 --- a/developer/docs/help/main/credits.md +++ b/developer/docs/help/main/credits.md @@ -2,6 +2,6 @@ title: Additional Credits --- -## Code2000, Code2001 and Code2002 fonts +## Code2000, Code2001 and Code2002 fonts © 2006 James Kass. diff --git a/developer/docs/help/main/license.md b/developer/docs/help/main/license.md index 73b788f900..83f45978e9 100644 --- a/developer/docs/help/main/license.md +++ b/developer/docs/help/main/license.md @@ -4,7 +4,7 @@ title: Keyman® Developer License MIT License -Copyright (c) 1994-2018 SIL International +Copyright (c) 1994-2025 SIL Global Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the