docs: knowledge base on installing the previous version of a keyman keyboard #2531
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,57 @@ | ||
| # HOWTO: Download the previous version of a Keyman keyboard | ||
|
|
||
| The challenge with using an older version of the keyboard is that the Keyman for Android will be prompted to update to the new version every now and then. | ||
|
|
||
| ## Method 1 | ||
|
|
||
| **Every version of the published Keyman keyboards are available in downloads.keyman.com.** | ||
|
|
||
| 1) Go to [downloads.keyman.com/keyboards/](https://downloads.keyman.com/keyboards/) | ||
|
|
||
| 2) Locate the keyboard folder, e.g. khmer_angkor -> version number | ||
|
|
||
| 3) There should be a KMP file in every version folder of the keyboard | ||
|
|
||
| 4) Download the KMP file (read [KMP file](../developer/current-version/reference/file-types/kmp)) | ||
|
Member
There was a problem hiding this comment. I think we should avoid references to the Developer documentation here -- it may confuse end users (Developer docs intended for keyboard authors) |
||
|
|
||
| 5) Check [see-also](#toc-see-also) section to install the KMP file onto the the device. | ||
|
|
||
| ## Method 2 | ||
|
|
||
| **Change the version parameter in the URL path by version to get KMP file of the specified version of the keyboard.** | ||
|
|
||
| 1) Navigate to the [keyboard search](https://keyman.com/en/keyboards/) | ||
|
|
||
| 2) Search for the keyboard | ||
|
|
||
| 3) Click on the keyboard to go the the details page | ||
|
|
||
| 4) On the details page, scroll down to the "Keyboard Details" section | ||
|
|
||
| 5) Under the "Keyboard Details", at Package Download, copy the KMP link | ||
|
|
||
| > [!NOTE] | ||
| > The URL should be something like `https://keyman.com/go/package/download/basic_kbdus?version=1.2&tier=stable` | ||
|
|
||
| 6) Change the `version=1.2` to the desired version of the folder for installation | ||
|
|
||
| 7) Paste the newly updated link in the URL input of a browser. | ||
|
|
||
| > [!TIP] | ||
| > Use [Keyman keyboards repository](https://github.com/keymanapp/keyboards/blob/master/release/k/khmer_angkor/HISTORY.md) to find the version for that specific feature. | ||
|
|
||
| 6) Check [see-also](#toc-see-also) section to install the KMP file onto the the device. | ||
|
|
||
| ## See also | ||
|
|
||
| * [Files type](../developer/current-version/reference/file-types/) | ||
|
|
||
| * [Installing Custom Keyboards/Dictionaries - Keyman for Android Help](../products/android/current-version/basic/installing-custom-packages) | ||
|
|
||
| * [Installing Custom Keyboards/Dictionaries - Keyman for iPhone and iPad Help](../products/iphone-and-ipad/current-version/basic/installing-custom-keyboards-dictionaries) | ||
|
|
||
| * [How To - Download and Install a Keyman Keyboard on Windows](../products/windows/current-version/start/download-and-install-keyboard) | ||
|
|
||
| * [Installing Keyboards with Keyman for Linux](../products/linux/current-version/start/installing-keyboard) | ||
|
|
||
| * [Install a Keyman Keyboard on macOS](../products/mac/current-version/start/install-keyboard) | ||
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This paragraph belongs further down in the document under a 'Challenges' section along with how to turn off automatic updates. Note that Windows, iOS, and Android all have automatic keyboard updates, and we plan to support that on macOS and Linux as well.
The first paragraph should be an explanation of why you might want an older version of a keyboard, and also include reasons to use the latest version.
It would be good also to note that if the reader has encountered a problem with the latest version of a keyboard, it helps everyone if they report it to community.