From 793bb47e443a4c5718c53d8925b6028dfd0a2d1a Mon Sep 17 00:00:00 2001 From: Meng-Heng Date: Fri, 29 May 2026 16:04:25 +0700 Subject: [PATCH 01/11] docs: knowledge base on installing the previous version of a keyman keyboard fixes #2523: --- knowledge-base/kb0121.md | 36 ++++++++++++++++++++++++++++++++++++ 1 file changed, 36 insertions(+) create mode 100644 knowledge-base/kb0121.md diff --git a/knowledge-base/kb0121.md b/knowledge-base/kb0121.md new file mode 100644 index 000000000..9177bf6c2 --- /dev/null +++ b/knowledge-base/kb0121.md @@ -0,0 +1,36 @@ +# 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 prompt to update to the new version every now and then. + +## Method 1 + +1) Every version of a keyboard since it was published for Keyman keyboards repository are available for download through the [downloads.keyman.com/keyboards/](https://downloads.keyman.com/keyboards/) + +2) There should be a KMP file for every version folders. + +## Method 2 + +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) Scroll down to the Keyboard Details section + +5) 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. + +## See also + +* [Files type](../developer/current-version/reference/file-types/) + * [KMP file](../developer/current-version/reference/file-types/kmp) From 98022159b54dce60e0d7d498f5dde8b86c280fa0 Mon Sep 17 00:00:00 2001 From: Meng-Heng Date: Mon, 15 Jun 2026 14:17:19 +0700 Subject: [PATCH 02/11] docs: update kb0076 on log reading on Firefox --- knowledge-base/kb0076.md | 31 ++++++++++++++++++++++++++++--- 1 file changed, 28 insertions(+), 3 deletions(-) diff --git a/knowledge-base/kb0076.md b/knowledge-base/kb0076.md index ecd626663..5b951bff9 100644 --- a/knowledge-base/kb0076.md +++ b/knowledge-base/kb0076.md @@ -2,8 +2,8 @@ Keyman Support may ask you to run debugging in Keyman Desktop or Keyman Developer. The debug report assists us in resolving complex support issues. Please follow the steps below to generate the debug report. -> **WARNING:** -*Everything* you type or click on your computer while running debugging will be visible (including passwords) when we review the debug files. We strongly recommend only running debugging during the test, and immediately turning it off after the test is finished. +> [!WARNING] +> *Everything* you type or click on your computer while running debugging will be visible (including passwords) when we review the debug files. We strongly recommend only running debugging during the test, and immediately turning it off after the test is finished. 1. Start Keyman Configuration. 2. Select the Options tab. @@ -17,7 +17,32 @@ Keyman Support may ask you to run debugging in Keyman Desktop or Keyman Develope 10. Send us a copy of your debug file(s). You'll find them, in the folder above, named system##.etl or system##.log (where ## is a number). 11. Please include notes to us about the issue, including what you typed, what output you expected to get (if possible!), and the results you actually received. -**NOTE**: Please only perform send Keyman Support a log file if we request it. We don't have the resources to review unsolicited log files! +## Capture a log in Firefox + +#### Only follow this if the issue is related to Google products or other web applications. + +1) Open a testcase in a tab, e.g. Google Docs or Sheets + +2) Open and write `about:logging` in another tab + +3) Choose “Logging to a file” radio button and type a path to save the log into the text field, then, press “Set Log File” button + +4) Set “New log modules:” field to KeyboardHandler:4,IMEHandler:4,sync and click “Set Log Module” button. + +5) If you see “Start logging” button in top of the page, click it. + +6) Back to the tab loaded the testcase with mouse + +7) Click the editor and do the minimum steps to reproduce the bug + +8) Back to the tab loaded about:logging with mouse + +9) Click the “Stop logging” button + +10) The Log file is available the path set above. + +> [!NOTE] +> Please only perform send Keyman Support a log file if we request it. We don't have the resources to review unsolicited log files! ## Applies to: * Keyman for Windows 14.0+ From 3746b92251510b1573505bc0aa6cb5ae4359ebef Mon Sep 17 00:00:00 2001 From: Meng-Heng Date: Mon, 15 Jun 2026 14:21:36 +0700 Subject: [PATCH 03/11] Revert "docs: knowledge base on installing the previous version of a keyman keyboard" This reverts commit df82f925c20059ba57622e6a40794a752b361e9a. --- knowledge-base/kb0121.md | 36 ------------------------------------ 1 file changed, 36 deletions(-) delete mode 100644 knowledge-base/kb0121.md diff --git a/knowledge-base/kb0121.md b/knowledge-base/kb0121.md deleted file mode 100644 index 9177bf6c2..000000000 --- a/knowledge-base/kb0121.md +++ /dev/null @@ -1,36 +0,0 @@ -# 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 prompt to update to the new version every now and then. - -## Method 1 - -1) Every version of a keyboard since it was published for Keyman keyboards repository are available for download through the [downloads.keyman.com/keyboards/](https://downloads.keyman.com/keyboards/) - -2) There should be a KMP file for every version folders. - -## Method 2 - -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) Scroll down to the Keyboard Details section - -5) 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. - -## See also - -* [Files type](../developer/current-version/reference/file-types/) - * [KMP file](../developer/current-version/reference/file-types/kmp) From 9fa473145ad42395653451dd11c7c9559670c9a7 Mon Sep 17 00:00:00 2001 From: Meng-Heng Date: Mon, 15 Jun 2026 14:31:30 +0700 Subject: [PATCH 04/11] docs: update kb0076 to include log capturing on firefox --- knowledge-base/kb0076.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/knowledge-base/kb0076.md b/knowledge-base/kb0076.md index 5b951bff9..de40e4996 100644 --- a/knowledge-base/kb0076.md +++ b/knowledge-base/kb0076.md @@ -1,4 +1,4 @@ -# HOWTO: Run Debugging in Keyman Desktop +# HOWTO: Run Debugging in Keyman Desktop and Firefox Keyman Support may ask you to run debugging in Keyman Desktop or Keyman Developer. The debug report assists us in resolving complex support issues. Please follow the steps below to generate the debug report. @@ -35,7 +35,7 @@ Keyman Support may ask you to run debugging in Keyman Desktop or Keyman Develope 7) Click the editor and do the minimum steps to reproduce the bug -8) Back to the tab loaded about:logging with mouse +8) Back to the tab loaded `about:logging` with mouse 9) Click the “Stop logging” button From ba630f52690778364d65fa71fd48662f8b036167 Mon Sep 17 00:00:00 2001 From: MengHeng <90595388+Meng-Heng@users.noreply.github.com> Date: Tue, 23 Jun 2026 13:30:54 +0700 Subject: [PATCH 05/11] Apply suggestions from code review Co-authored-by: Eberhard Beilharz Co-authored-by: rc-swag <58423624+rc-swag@users.noreply.github.com> --- knowledge-base/kb0076.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/knowledge-base/kb0076.md b/knowledge-base/kb0076.md index de40e4996..a351dbfa5 100644 --- a/knowledge-base/kb0076.md +++ b/knowledge-base/kb0076.md @@ -1,4 +1,4 @@ -# HOWTO: Run Debugging in Keyman Desktop and Firefox +# HOWTO: Run Debugging in Keyman for Windows and Firefox Keyman Support may ask you to run debugging in Keyman Desktop or Keyman Developer. The debug report assists us in resolving complex support issues. Please follow the steps below to generate the debug report. @@ -21,7 +21,7 @@ Keyman Support may ask you to run debugging in Keyman Desktop or Keyman Develope #### Only follow this if the issue is related to Google products or other web applications. -1) Open a testcase in a tab, e.g. Google Docs or Sheets +1) Open a testcase in a tab, e.g. Google Docs or Sheets, Website with issue 2) Open and write `about:logging` in another tab @@ -31,11 +31,11 @@ Keyman Support may ask you to run debugging in Keyman Desktop or Keyman Develope 5) If you see “Start logging” button in top of the page, click it. -6) Back to the tab loaded the testcase with mouse +6) Go back to the tab loaded with the testcase using the mouse -7) Click the editor and do the minimum steps to reproduce the bug +7) Do the minimum steps to reproduce the bug -8) Back to the tab loaded `about:logging` with mouse +8) Go back to the tab loaded `about:logging` with mouse 9) Click the “Stop logging” button From a45a861c9888f7bc81acf83a13e9e217548467da Mon Sep 17 00:00:00 2001 From: MengHeng <90595388+Meng-Heng@users.noreply.github.com> Date: Tue, 23 Jun 2026 13:54:56 +0700 Subject: [PATCH 06/11] Apply suggestions from code review Co-authored-by: MengHeng <90595388+Meng-Heng@users.noreply.github.com> --- knowledge-base/kb0076.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/knowledge-base/kb0076.md b/knowledge-base/kb0076.md index a351dbfa5..2b70c89d2 100644 --- a/knowledge-base/kb0076.md +++ b/knowledge-base/kb0076.md @@ -19,7 +19,7 @@ Keyman Support may ask you to run debugging in Keyman Desktop or Keyman Develope ## Capture a log in Firefox -#### Only follow this if the issue is related to Google products or other web applications. +#### These steps are for debugging the issues that are reproducible using Firefox. 1) Open a testcase in a tab, e.g. Google Docs or Sheets, Website with issue From 713c921a11fd649f29c6fa42649a2cb1ce74663f Mon Sep 17 00:00:00 2001 From: keyman-server Date: Tue, 16 Jun 2026 13:27:44 +0000 Subject: [PATCH 07/11] chore: update BOOTSTRAP_VERSION to v1.0.14 --- build.sh | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/build.sh b/build.sh index eda99bc68..a0a5a67a5 100755 --- a/build.sh +++ b/build.sh @@ -2,8 +2,7 @@ ## START STANDARD SITE BUILD SCRIPT INCLUDE readonly THIS_SCRIPT="$(readlink -f "${BASH_SOURCE[0]}")" readonly BOOTSTRAP="$(dirname "$THIS_SCRIPT")/resources/bootstrap.inc.sh" -BOOTSTRAP_VERSION="$(cat "$(dirname "THIS_SCRIPT")/resources/.bootstrap-required-version")" || exit 1 -readonly BOOTSTRAP_VERSION +readonly BOOTSTRAP_VERSION=v1.0.14 if ! [ -f "$BOOTSTRAP" ] || ! source "$BOOTSTRAP"; then curl -H "Cache-Control: no-cache" --fail --silent --show-error -w "curl: Finished attempt to download %{url}" "https://raw.githubusercontent.com/keymanapp/shared-sites/$BOOTSTRAP_VERSION/bootstrap.inc.sh" -o "$BOOTSTRAP.tmp" || exit 1 source "$BOOTSTRAP.tmp" From abbdea8730f9b7d6eddf94c486159d25aebc1df3 Mon Sep 17 00:00:00 2001 From: Marc Durdin Date: Wed, 10 Jun 2026 10:11:14 +0200 Subject: [PATCH 08/11] feat: footer Edit Page and Support links on touch devices Move the footer-tab block above the footer so it can attach to the top of the footer for mobile devices and adjust CSS accordingly. Fixes: #133 Test-bot: skip --- _includes/includes/footer.php | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/_includes/includes/footer.php b/_includes/includes/footer.php index 28e698be8..fbb3f2424 100644 --- a/_includes/includes/footer.php +++ b/_includes/includes/footer.php @@ -1,6 +1,13 @@ From e140d25a7d3c8c6b813ce04a308c187a43f8fee1 Mon Sep 17 00:00:00 2001 From: Meng-Heng Date: Thu, 25 Jun 2026 17:04:30 +0700 Subject: [PATCH 09/11] docs: apply suggestions --- knowledge-base/kb0076.md | 38 ++++++++++++++++++++++++-------------- 1 file changed, 24 insertions(+), 14 deletions(-) diff --git a/knowledge-base/kb0076.md b/knowledge-base/kb0076.md index 2b70c89d2..2966218ca 100644 --- a/knowledge-base/kb0076.md +++ b/knowledge-base/kb0076.md @@ -1,21 +1,31 @@ # HOWTO: Run Debugging in Keyman for Windows and Firefox -Keyman Support may ask you to run debugging in Keyman Desktop or Keyman Developer. The debug report assists us in resolving complex support issues. Please follow the steps below to generate the debug report. +Keyman Support may ask you to run debugging in Keyman for Windows or Keyman Developer. The debug report assists us in resolving complex support issues. Please follow the steps below to generate the debug report. > [!WARNING] > *Everything* you type or click on your computer while running debugging will be visible (including passwords) when we review the debug files. We strongly recommend only running debugging during the test, and immediately turning it off after the test is finished. -1. Start Keyman Configuration. -2. Select the Options tab. -3. Tick 'Debugging' and click OK to confirm. -4. Exit Keyman Desktop and Keyman Developer, if they are running, as well as any application where you need to demonstrate the problem. -5. Restart Keyman Desktop and the target application. -6. Demonstrate the problem you are having. -7. After the problem is sufficiently demonstrated, exit Keyman Desktop. -8. Open Keyman Configuration, and untick 'Debugging' from the Options tab. -9. Click the Windows Search box, and type "%localappdata%\keyman\diag" and press enter. -10. Send us a copy of your debug file(s). You'll find them, in the folder above, named system##.etl or system##.log (where ## is a number). -11. Please include notes to us about the issue, including what you typed, what output you expected to get (if possible!), and the results you actually received. +1) Start Keyman Configuration. + +2) Select the Options tab. + +3) Tick 'Debugging' and click OK to confirm. + +4) Exit Keyman for Windows and Keyman Developer, if they are running, as well as any application where you need to demonstrate the problem. + +5) Restart Keyman for Windows and the target application. + +6) Demonstrate the problem you are having. + +7) After the problem is sufficiently demonstrated, exit Keyman for Windows. + +8) Open Keyman Configuration, and untick 'Debugging' from the Options tab. + +9) Click the Windows Search box, and type "%localappdata%\keyman\diag" and press enter. + +10) Send us a copy of your debug file(s). You'll find them, in the folder above, named system##.etl or system##.log (where ## is a number). + +11) Please include notes to us about the issue, including what you typed, what output you expected to get (if possible!), and the results you actually received. ## Capture a log in Firefox @@ -27,9 +37,9 @@ Keyman Support may ask you to run debugging in Keyman Desktop or Keyman Develope 3) Choose “Logging to a file” radio button and type a path to save the log into the text field, then, press “Set Log File” button -4) Set “New log modules:” field to KeyboardHandler:4,IMEHandler:4,sync and click “Set Log Module” button. +4) Set “New log modules:” field to KeyboardHandler:4,IMEHandler:4,sync and click “Set Log Module” button -5) If you see “Start logging” button in top of the page, click it. +5) If you see “Start logging” button in top of the page, click it 6) Go back to the tab loaded with the testcase using the mouse From 933b125d887948f82f74e994973a63ecb97b5bc1 Mon Sep 17 00:00:00 2001 From: Meng-Heng Date: Fri, 26 Jun 2026 10:45:39 +0700 Subject: [PATCH 10/11] chore: remove unwanted file --- _includes/includes/footer.php | 9 +-------- 1 file changed, 1 insertion(+), 8 deletions(-) diff --git a/_includes/includes/footer.php b/_includes/includes/footer.php index fbb3f2424..28e698be8 100644 --- a/_includes/includes/footer.php +++ b/_includes/includes/footer.php @@ -1,13 +1,6 @@ From b1bb0a65f8fb39f029d777394403c94f682b0298 Mon Sep 17 00:00:00 2001 From: Meng-Heng Date: Fri, 26 Jun 2026 10:46:47 +0700 Subject: [PATCH 11/11] chore: remove build.sh file --- build.sh | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/build.sh b/build.sh index a0a5a67a5..eda99bc68 100755 --- a/build.sh +++ b/build.sh @@ -2,7 +2,8 @@ ## START STANDARD SITE BUILD SCRIPT INCLUDE readonly THIS_SCRIPT="$(readlink -f "${BASH_SOURCE[0]}")" readonly BOOTSTRAP="$(dirname "$THIS_SCRIPT")/resources/bootstrap.inc.sh" -readonly BOOTSTRAP_VERSION=v1.0.14 +BOOTSTRAP_VERSION="$(cat "$(dirname "THIS_SCRIPT")/resources/.bootstrap-required-version")" || exit 1 +readonly BOOTSTRAP_VERSION if ! [ -f "$BOOTSTRAP" ] || ! source "$BOOTSTRAP"; then curl -H "Cache-Control: no-cache" --fail --silent --show-error -w "curl: Finished attempt to download %{url}" "https://raw.githubusercontent.com/keymanapp/shared-sites/$BOOTSTRAP_VERSION/bootstrap.inc.sh" -o "$BOOTSTRAP.tmp" || exit 1 source "$BOOTSTRAP.tmp"