From e3bec113736d39b49f4faac72d25304089981df1 Mon Sep 17 00:00:00 2001 From: Darcy Wong Date: Thu, 8 Feb 2024 10:44:05 +0700 Subject: [PATCH 1/6] docs(android): Update help for gestures --- android/help/context/menu-phone.md | 2 +- android/help/context/menu-tablet.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/android/help/context/menu-phone.md b/android/help/context/menu-phone.md index 363a08b9f4..62f2308461 100644 --- a/android/help/context/menu-phone.md +++ b/android/help/context/menu-phone.md @@ -9,7 +9,7 @@ title: Keyman for Android (Phone Layout) | ![](../android_images/backspace-ap.png) | Backspace | | ![](../android_images/return-ap.png) | Return | | ![](../android_images/shift-ap.png) | Shift key. Long press this key to access the CTRL, ALT and CTRLALT keys (which can access additional key layers) | -| ![](../android_images/touch-hold-ap.png) | Keys with a small dot in the top right corner indicate a long press key. Access further functionality by long pressing the key | +| ![](../android_images/touch-hold-ap.png) | Keys with a character (default of small dot) in the top right corner indicate further functionality by one of the following ways:
* long pressing the key
* multi-tapping the key
* a flick gesture in one of 8 directions (up, down, left, right, and the 4 intermediate corners) | | ![](../android_images/share-a.png) | Share your text with other apps like Messages, Gmail, or Twitter. Some versions of Android also let you copy your text to the clipboard. | ---- diff --git a/android/help/context/menu-tablet.md b/android/help/context/menu-tablet.md index f2264c7ac5..906b6ab175 100644 --- a/android/help/context/menu-tablet.md +++ b/android/help/context/menu-tablet.md @@ -9,7 +9,7 @@ title: Keyman for Android (Tablet Layout) | ![](../android_images/backspace-at.png) | Backspace | | ![](../android_images/return-at.png) | Return | | ![](../android_images/shift-at.png) | Shift key. Long press this key to access the CTRL, ALT and CTRLALT keys (which can access additional key layers) | -| ![](../android_images/touch-hold-at.png) | Keys with a small dot in the top right corner indicate a long press key. Access further functionality by long pressing the key | +| ![](../android_images/touch-hold-at.png) | Keys with a character (default of small dot) in the top right corner indicate further functionality by one of the following ways:
* long pressing the key
* multi-tapping the key
* a flick gesture in one of 8 directions (up, down, left, right, and the 4 intermediate corners) | ---- From 2cf3b970ca33879536c33e83ffe5df702bad4ad5 Mon Sep 17 00:00:00 2001 From: Darcy Wong Date: Thu, 8 Feb 2024 10:48:58 +0700 Subject: [PATCH 2/6] docs(android): Remove references to Keyman browser Browser removed in #8428 --- android/help/basic/index.md | 2 -- android/help/basic/using-keyman-browser.md | 18 ------------------ android/help/context/menu-phone.md | 1 - android/help/context/menu-tablet.md | 1 - android/help/index.md | 1 - 5 files changed, 23 deletions(-) delete mode 100644 android/help/basic/using-keyman-browser.md diff --git a/android/help/basic/index.md b/android/help/basic/index.md index 2dab69a969..66f6558488 100644 --- a/android/help/basic/index.md +++ b/android/help/basic/index.md @@ -9,7 +9,5 @@ title: Basic Help * [Using the Settings Screen](config/) -* [Using the Keyman Browser](using-keyman-browser) - * [Removing Keyboards](uninstalling-keyboards) * [Removing Dictionaries](uninstalling-dictionaries) diff --git a/android/help/basic/using-keyman-browser.md b/android/help/basic/using-keyman-browser.md deleted file mode 100644 index 7c62b8b39b..0000000000 --- a/android/help/basic/using-keyman-browser.md +++ /dev/null @@ -1,18 +0,0 @@ ---- -title: Using the Keyman Browser - Keyman for Android Help ---- - -## Using the Keyman Browser -Step 1) -Click the Keyman Browser button in the Keyman app - -Step 2) -Enter the URL of a website to visit into the address bar, for example google.com. - -Keyman Browser will load the page and detect your language if it is present, and reformat it to show your language instead of square boxes. - -Step 3) -Use the bookmark button to save the current page for browsing later. - -Step 4) -Use the Globe icon to swap between languages. diff --git a/android/help/context/menu-phone.md b/android/help/context/menu-phone.md index 62f2308461..12aadfcf32 100644 --- a/android/help/context/menu-phone.md +++ b/android/help/context/menu-phone.md @@ -16,7 +16,6 @@ title: Keyman for Android (Phone Layout) | | Toolbar Icons | |---|---| -| ![](../android_images/browser-a.png) | Open the Keyman Browser to use the web in your language | | ![](../android_images/menu-icon-a.png) | Open the menu for additional options | | ![](../android_images/font-size-a.png) | Adjust the font size | | ![](../android_images/delete-a.png) | Delete all current text | diff --git a/android/help/context/menu-tablet.md b/android/help/context/menu-tablet.md index 906b6ab175..4ad3864d57 100644 --- a/android/help/context/menu-tablet.md +++ b/android/help/context/menu-tablet.md @@ -16,7 +16,6 @@ title: Keyman for Android (Tablet Layout) | | Toolbar Icons | |---|---| | ![](../android_images/share-a.png) | Share your text with other atps like Messages, Gmail, or Twitter. Some versions of Android also let you copy your text to the clipboard. | -| ![](../android_images/browser-a.png) | Open the Keyman Browser to use the web in your language | | ![](../android_images/menu-icon-a.png) | Open the menu for additional options | | ![](../android_images/font-size-a.png) | Adjust the font size | | ![](../android_images/delete-a.png) | Delete all current text | diff --git a/android/help/index.md b/android/help/index.md index 6ba82a429b..0f9be7a75a 100644 --- a/android/help/index.md +++ b/android/help/index.md @@ -30,7 +30,6 @@ title: Keyman for Android 17.0 Help * [Installing Custom Keyboards/Dictionaries](basic/installing-custom-packages) * [Adding Dictionaries](basic/installing-dictionaries) * [Using the Settings Screen](basic/config/) -* [Using the Keyman Browser](basic/using-keyman-browser) * [Removing Keyboards](basic/uninstalling-keyboards) * [Removing Dictionaries](basic/uninstalling-dictionaries) From 059a0c2872b2fb757611e91cac9148ad0d1268fd Mon Sep 17 00:00:00 2001 From: Darcy Wong Date: Tue, 13 Feb 2024 06:49:29 +0700 Subject: [PATCH 3/6] docs(android/app): Add separate page on gestures --- android/help/context/gestures.md | 13 +++++++++++++ android/help/context/index.md | 5 +++-- android/help/context/menu-phone.md | 2 +- android/help/index.md | 7 ++++--- 4 files changed, 21 insertions(+), 6 deletions(-) create mode 100644 android/help/context/gestures.md diff --git a/android/help/context/gestures.md b/android/help/context/gestures.md new file mode 100644 index 0000000000..c8cb86fa43 --- /dev/null +++ b/android/help/context/gestures.md @@ -0,0 +1,13 @@ +--- +title: Gesture Hints and Tips +--- + +## Using Gestures on the Keyboard Keys +You can use gestures to interact with some keys on the keyboard. Keys which have gestures available will normally show them as a hint in the top right of the key: + +![](../android_images/touch-hold-ap.png) + +* **Long press**: you can press and hold a key, and after a moment a submenu will appear. You can slide your finger to the submenu, and when you release it, the highlighted key from the submenu will be output. +* **Flick**: you can hold and slide in various directions on a key to reach alternate outputs. The key will animate to show you the expected output. A common flick is to slide down to reach numerals on the top row of the keyboard. +* **Multitap**: some keys allow you to press them repeatedly, rapidly, to reach alternate outputs. Tapping rapidly twice on Shift will activate Caps Lock on many keyboards. + diff --git a/android/help/context/index.md b/android/help/context/index.md index ba873acdba..1e351a4369 100644 --- a/android/help/context/index.md +++ b/android/help/context/index.md @@ -2,5 +2,6 @@ title: Contextual Help --- -* [The Keyman Menu (Phone Layout)](menu-phone) -* [The Keyman Menu (Tablet Layout)](menu-tablet) \ No newline at end of file +* [The Keyboard Keys and Keyman Menu (Phone Layout)](menu-phone) +* [The Keyboard Keys and Keyman Menu (Tablet Layout)](menu-tablet) +* [Gesture Hints and Tips](gestures) \ No newline at end of file diff --git a/android/help/context/menu-phone.md b/android/help/context/menu-phone.md index 12aadfcf32..6f4becf498 100644 --- a/android/help/context/menu-phone.md +++ b/android/help/context/menu-phone.md @@ -9,7 +9,7 @@ title: Keyman for Android (Phone Layout) | ![](../android_images/backspace-ap.png) | Backspace | | ![](../android_images/return-ap.png) | Return | | ![](../android_images/shift-ap.png) | Shift key. Long press this key to access the CTRL, ALT and CTRLALT keys (which can access additional key layers) | -| ![](../android_images/touch-hold-ap.png) | Keys with a character (default of small dot) in the top right corner indicate further functionality by one of the following ways:
* long pressing the key
* multi-tapping the key
* a flick gesture in one of 8 directions (up, down, left, right, and the 4 intermediate corners) | +| ![](../android_images/touch-hold-ap.png) | You can use gestures to interact with some keys on the keyboard. Keys which have gestures available will normally show them as a hint in the top right of the key.
Gestures include: long press, flick, and multitap. | | ![](../android_images/share-a.png) | Share your text with other apps like Messages, Gmail, or Twitter. Some versions of Android also let you copy your text to the clipboard. | ---- diff --git a/android/help/index.md b/android/help/index.md index 0f9be7a75a..7573b2ff1b 100644 --- a/android/help/index.md +++ b/android/help/index.md @@ -12,9 +12,10 @@ title: Keyman for Android 17.0 Help * [How To - Download and Install a Keyman Keyboard](start/installing-keyboards) * [Enabling Keyman as a System-Wide Keyboard](start/enabling-system-keyboard) -## [Using the Menu](context/) -* [Using the menu buttons (phone layout)](context/menu-phone) -* [Using the menu buttons (tablet layout)](context/menu-tablet) +## [Using the Keyboard Keys and Menu](context/) +* [Using the keyboard keys and menu buttons (phone layout)](context/menu-phone) +* [Using the keyboard keys and menu buttons (tablet layout)](context/menu-tablet) +* [Gesture Hints and Tips](context/gestures) ## Ask for Help * [Ask other users in the SIL Keyman Community](https://community.software.sil.org/c/keyman) From 53e4840449c326da1815b2067dcb3e4267819b67 Mon Sep 17 00:00:00 2001 From: Darcy Wong Date: Wed, 14 Feb 2024 08:44:09 +0700 Subject: [PATCH 4/6] docs(android/app): Add links to gestures help --- android/help/context/menu-phone.md | 2 +- android/help/context/menu-tablet.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/android/help/context/menu-phone.md b/android/help/context/menu-phone.md index 6f4becf498..5a6e493e3e 100644 --- a/android/help/context/menu-phone.md +++ b/android/help/context/menu-phone.md @@ -9,7 +9,7 @@ title: Keyman for Android (Phone Layout) | ![](../android_images/backspace-ap.png) | Backspace | | ![](../android_images/return-ap.png) | Return | | ![](../android_images/shift-ap.png) | Shift key. Long press this key to access the CTRL, ALT and CTRLALT keys (which can access additional key layers) | -| ![](../android_images/touch-hold-ap.png) | You can use gestures to interact with some keys on the keyboard. Keys which have gestures available will normally show them as a hint in the top right of the key.
Gestures include: long press, flick, and multitap. | +| ![](../android_images/touch-hold-ap.png) | You can use [gestures](gestures) to interact with some keys on the keyboard. Keys which have gestures available will normally show them as a hint in the top right of the key.
Gestures include: long press, flick, and multitap. | | ![](../android_images/share-a.png) | Share your text with other apps like Messages, Gmail, or Twitter. Some versions of Android also let you copy your text to the clipboard. | ---- diff --git a/android/help/context/menu-tablet.md b/android/help/context/menu-tablet.md index 4ad3864d57..5601f04996 100644 --- a/android/help/context/menu-tablet.md +++ b/android/help/context/menu-tablet.md @@ -9,7 +9,7 @@ title: Keyman for Android (Tablet Layout) | ![](../android_images/backspace-at.png) | Backspace | | ![](../android_images/return-at.png) | Return | | ![](../android_images/shift-at.png) | Shift key. Long press this key to access the CTRL, ALT and CTRLALT keys (which can access additional key layers) | -| ![](../android_images/touch-hold-at.png) | Keys with a character (default of small dot) in the top right corner indicate further functionality by one of the following ways:
* long pressing the key
* multi-tapping the key
* a flick gesture in one of 8 directions (up, down, left, right, and the 4 intermediate corners) | +| ![](../android_images/touch-hold-at.png) | You can use [gestures](gestures) to interact with some keys on the keyboard. Keys which have gestures available will normally show them as a hint in the top right of the key.
Gestures include: long press, flick, and multitap. | ---- From e697eca62adde23c1866c2709a43d0b04ea90d3a Mon Sep 17 00:00:00 2001 From: Darcy Wong Date: Thu, 15 Feb 2024 10:14:09 +0700 Subject: [PATCH 5/6] docs(android/app): Tweak wording --- android/help/context/gestures.md | 8 ++++---- android/help/context/menu-phone.md | 4 ++-- android/help/context/menu-tablet.md | 2 +- 3 files changed, 7 insertions(+), 7 deletions(-) diff --git a/android/help/context/gestures.md b/android/help/context/gestures.md index c8cb86fa43..fe5aaf8138 100644 --- a/android/help/context/gestures.md +++ b/android/help/context/gestures.md @@ -3,11 +3,11 @@ title: Gesture Hints and Tips --- ## Using Gestures on the Keyboard Keys -You can use gestures to interact with some keys on the keyboard. Keys which have gestures available will normally show them as a hint in the top right of the key: +There are now several gestures available to interact with some keys on the keyboard. Keys which have gestures available will normally show them as a hint in the top right of the key: ![](../android_images/touch-hold-ap.png) -* **Long press**: you can press and hold a key, and after a moment a submenu will appear. You can slide your finger to the submenu, and when you release it, the highlighted key from the submenu will be output. -* **Flick**: you can hold and slide in various directions on a key to reach alternate outputs. The key will animate to show you the expected output. A common flick is to slide down to reach numerals on the top row of the keyboard. -* **Multitap**: some keys allow you to press them repeatedly, rapidly, to reach alternate outputs. Tapping rapidly twice on Shift will activate Caps Lock on many keyboards. +* **Long press**: Press and hold a key, and after a moment a submenu will appear. Slide the finger to the submenu to select a key. Release the finger, and the highlighted key from the submenu will be output. +* **Flick**: Press and hold a key, and then slide the finger in various directions on a key to reach alternate outputs. The key will animate to show the expected output when the finger gets released. A common flick is to slide down to reach numerals on the top row of the keyboard. +* **Multitap**: Some keys can be pressed repeatedly and rapidly to reach alternate outputs. Tapping rapidly twice on Shift will activate Caps Lock on many keyboards. diff --git a/android/help/context/menu-phone.md b/android/help/context/menu-phone.md index 5a6e493e3e..fd275a3fbb 100644 --- a/android/help/context/menu-phone.md +++ b/android/help/context/menu-phone.md @@ -9,13 +9,13 @@ title: Keyman for Android (Phone Layout) | ![](../android_images/backspace-ap.png) | Backspace | | ![](../android_images/return-ap.png) | Return | | ![](../android_images/shift-ap.png) | Shift key. Long press this key to access the CTRL, ALT and CTRLALT keys (which can access additional key layers) | -| ![](../android_images/touch-hold-ap.png) | You can use [gestures](gestures) to interact with some keys on the keyboard. Keys which have gestures available will normally show them as a hint in the top right of the key.
Gestures include: long press, flick, and multitap. | -| ![](../android_images/share-a.png) | Share your text with other apps like Messages, Gmail, or Twitter. Some versions of Android also let you copy your text to the clipboard. | +| ![](../android_images/touch-hold-ap.png) | There are several [gestures](gestures) to interact with some keys on the keyboard. Keys which have gestures available will normally show them as a hint in the top right of the key.
Gestures include: long press, flick, and multitap. | ---- | | Toolbar Icons | |---|---| +| ![](../android_images/share-a.png) | Share your text with other apps like Messages, Gmail, or Twitter. Some versions of Android also let you copy your text to the clipboard. | | ![](../android_images/menu-icon-a.png) | Open the menu for additional options | | ![](../android_images/font-size-a.png) | Adjust the font size | | ![](../android_images/delete-a.png) | Delete all current text | diff --git a/android/help/context/menu-tablet.md b/android/help/context/menu-tablet.md index 5601f04996..7daa9618ee 100644 --- a/android/help/context/menu-tablet.md +++ b/android/help/context/menu-tablet.md @@ -9,7 +9,7 @@ title: Keyman for Android (Tablet Layout) | ![](../android_images/backspace-at.png) | Backspace | | ![](../android_images/return-at.png) | Return | | ![](../android_images/shift-at.png) | Shift key. Long press this key to access the CTRL, ALT and CTRLALT keys (which can access additional key layers) | -| ![](../android_images/touch-hold-at.png) | You can use [gestures](gestures) to interact with some keys on the keyboard. Keys which have gestures available will normally show them as a hint in the top right of the key.
Gestures include: long press, flick, and multitap. | +| ![](../android_images/touch-hold-at.png) | There are several [gestures](gestures) to interact with some keys on the keyboard. Keys which have gestures available will normally show them as a hint in the top right of the key.
Gestures include: long press, flick, and multitap. | ---- From 6bded012faacdf5b85d60b927595ebbce1f8fe97 Mon Sep 17 00:00:00 2001 From: Darcy Wong Date: Thu, 15 Feb 2024 11:11:09 +0700 Subject: [PATCH 6/6] docs(android/app): Adjust more wording --- android/help/context/menu-phone.md | 2 +- android/help/context/menu-tablet.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/android/help/context/menu-phone.md b/android/help/context/menu-phone.md index fd275a3fbb..479e8b1715 100644 --- a/android/help/context/menu-phone.md +++ b/android/help/context/menu-phone.md @@ -9,7 +9,7 @@ title: Keyman for Android (Phone Layout) | ![](../android_images/backspace-ap.png) | Backspace | | ![](../android_images/return-ap.png) | Return | | ![](../android_images/shift-ap.png) | Shift key. Long press this key to access the CTRL, ALT and CTRLALT keys (which can access additional key layers) | -| ![](../android_images/touch-hold-ap.png) | There are several [gestures](gestures) to interact with some keys on the keyboard. Keys which have gestures available will normally show them as a hint in the top right of the key.
Gestures include: long press, flick, and multitap. | +| ![](../android_images/touch-hold-ap.png) | There are several [gestures](gestures) to interact with some keys on the keyboard. Keys which have gestures available will normally show a hint in the top right of the key.
Gestures include: long press, flick, and multitap. | ---- diff --git a/android/help/context/menu-tablet.md b/android/help/context/menu-tablet.md index 7daa9618ee..8092095ea7 100644 --- a/android/help/context/menu-tablet.md +++ b/android/help/context/menu-tablet.md @@ -9,7 +9,7 @@ title: Keyman for Android (Tablet Layout) | ![](../android_images/backspace-at.png) | Backspace | | ![](../android_images/return-at.png) | Return | | ![](../android_images/shift-at.png) | Shift key. Long press this key to access the CTRL, ALT and CTRLALT keys (which can access additional key layers) | -| ![](../android_images/touch-hold-at.png) | There are several [gestures](gestures) to interact with some keys on the keyboard. Keys which have gestures available will normally show them as a hint in the top right of the key.
Gestures include: long press, flick, and multitap. | +| ![](../android_images/touch-hold-at.png) | There are several [gestures](gestures) to interact with some keys on the keyboard. Keys which have gestures available will normally show a hint in the top right of the key.
Gestures include: long press, flick, and multitap. | ----