diff --git a/windows/src/desktop/help/about/credits.md b/windows/src/desktop/help/about/credits.md index 2ebf779457..d0f16aca23 100644 --- a/windows/src/desktop/help/about/credits.md +++ b/windows/src/desktop/help/about/credits.md @@ -3,7 +3,8 @@ title: Credits --- These help files were written by Marc Durdin, Peirce Baehr and Jeremy -Kirkham; updated by Makara Sok and Joshua Horton +Kirkham; updated by Makara Sok, Joshua Horton, Darcy Wong, +Eberhard Beilharz. Keyman is a registered trademark of Summer Institute of Linguistics Inc in Australia. diff --git a/windows/src/desktop/help/about/history.md b/windows/src/desktop/help/about/history.md index 2cd7bcd708..2d48a601db 100644 --- a/windows/src/desktop/help/about/history.md +++ b/windows/src/desktop/help/about/history.md @@ -3,7 +3,7 @@ title: Version History --- A frequently updated changelog for Keyman is kept at - on the Keyman +[help.keyman.com/version-history](https://help.keyman.com/version-history/) on the Keyman Help website. ## Related Topics diff --git a/windows/src/desktop/help/about/welcome.md b/windows/src/desktop/help/about/welcome.md index 5743ce6134..475b391d52 100644 --- a/windows/src/desktop/help/about/welcome.md +++ b/windows/src/desktop/help/about/welcome.md @@ -14,24 +14,28 @@ Keyman is used by more than a million people to type in over 1000 languages and counting. Keyman remaps your hardware keyboard to any one of hundreds of virtual -keyboards, available for download from the [Keyman -Website](https://keyman.com/) and around the Web. If you cannot find a -keyboard for your language, we offer the companion application [Keyman -Developer](https://keyman.com/developer/). Keyman Developer is a +keyboards, available for download from the +[Keyman Website](https://keyman.com/keyboards) and around the Web. If +you cannot find a suitable keyboard for your language, the companion +application [Keyman Developer](https://keyman.com/developer/) is a powerful software solution for creating the perfect Keyman keyboard to suit your needs. -Keyman features seamless integration with your Windows operating system -and the Windows language bar. You can use Keyman keyboards with Keyman -in almost any Windows or Web application. Try it in office software like -Word or Excel; browsers like Firefox or Internet Explorer; design -programs like Adobe InDesign; and email services like Outlook or Gmail. +Keyman is completely free and open source. Development of Keyman is +supported by your donations and volunteers. +[Please get involved!](https://keyman.com/about/get-involved) -Keyman fully supports [Unicode](https://www.unicode.org/) and legacy -standards and can be used with all standard hardware keyboards, making -it the perfect solution for typing in any language on your computer. +Keyman features seamless integration with your Windows operating system. +You can use Keyman keyboards with Keyman in almost any Windows or +Web application. Try it in office software like Word or Excel; browsers +like Chrome, Firefox, or Edge; design programs like Adobe InDesign; and +email services like Windows Mail, Outlook, or Gmail. -A list of features in Keyman is available [here](whatsnew). +Keyman fully supports [Unicode](https://www.unicode.org/) and can be +used with all standard hardware keyboards, making it the perfect +solution for typing in any language on your computer. + +A list of new features in Keyman is available [here](whatsnew). ![](../desktop_images/osk_keyboard.png) diff --git a/windows/src/desktop/help/about/whatsnew.md b/windows/src/desktop/help/about/whatsnew.md index e579276f63..d8fcdda6cc 100644 --- a/windows/src/desktop/help/about/whatsnew.md +++ b/windows/src/desktop/help/about/whatsnew.md @@ -2,36 +2,42 @@ title: What's New --- -Here are some of the great things we have added to Keyman 14.0. +Here are some of the new features we have added to Keyman 14.0 for Windows: -- Renamed from Keyman Desktop to Keyman for Windows +- We renamed the program from **Keyman Desktop** to **Keyman for Windows**. + Now that Keyman runs on so many platforms, it didn't make sense for + us to use a special, different name for Keyman on Windows. - Keyman keyboards are no longer hidden from the Windows language picker when you exit Keyman. Rather, if you select a Keyman keyboard, Keyman will be restarted for you automatically. -- Simpler and Smoother Keyboard Search -- Localizable UI through - translate.keyman.com +- Simpler and Smoother Keyboard Search (\#3326) +- Localizable user interface through + [translate.keyman.com](https://translate.keyman.com) - Added user interface for configuring all Keyman system-level options (\#3733) - Refreshed user interface no longer depends on Internet Explorer - (\#1720) + (\#1720); now uses Chromium to host all web-based user interface + (e.g. Keyman Configuration) - Smoother and more reliable installation of keyboard languages (\#3509) - Choose associated language when keyboard is installed (\#3524) -- Much improved keyboard download experience (\#3326) - Improved BCP 47 tag support (\#3529) - Much improved initial download and installation experience including bundled keyboards (\#3304) - Keyman Configuration changes now apply instantly (\#3753) -- Improved user experience when many keyboards installed (\#3626, +- Improved user experience when many keyboards are installed (\#3626, \#3627) -- Improved bootstrap installer -- Now uses Chromium to host all web-based UI (e.g. Keyman - Configuration) -- Breaking change: Keyman Engine no longer supports the keyboard usage - page (usage.htm) +- Improved error reporting with Sentry.io, so we can learn about + and fix bugs more quickly + +## Breaking Changes +- Keyman Engine no longer supports the keyboard usage page + (usage.htm). This functionality reduction arises because it is + not safe to host a web page within the Keyman Toolbox, which runs + at a higher level of privilege. We are looking for alternatives + to restore similar functionality in a future update. ## Related Topics - [Version History](history) -- [New Ways to Use Keyman](../basic/newways) +- [New Ways to Use Keyman](../basic/new-ways-to-use-keyman) diff --git a/windows/src/desktop/help/advanced/proxy_config.md b/windows/src/desktop/help/advanced/proxy_config.md index 1d3ee0d953..42f0371384 100644 --- a/windows/src/desktop/help/advanced/proxy_config.md +++ b/windows/src/desktop/help/advanced/proxy_config.md @@ -5,7 +5,7 @@ title: Proxy Configuration The Proxy Configuration dialog allows you to enter HTTP proxy details for Keyman Configuration. -![](desktop_images/proxy-config.png) +![](../desktop_images/proxy-config.png) Most users do not need to change their proxy configuration. Proxy configuration is used only in networked environments, and if a proxy @@ -18,5 +18,5 @@ Configuration will use the proxy settings from Windows. ## Related Topics -- [How To - Download and Install a Keyman Keyboard](../start/download-install_keyboard) -- [Software Task - Update Keyman](../basic/engine_tasks/update) +- [How To - Download and Install a Keyman Keyboard](../start/download-and-install-keyboard) +- [Software Task - Update Keyman](../basic/engine/update) diff --git a/windows/src/desktop/help/advanced/text_services_framework.md b/windows/src/desktop/help/advanced/text_services_framework.md index c075228672..7b3ed4f994 100644 --- a/windows/src/desktop/help/advanced/text_services_framework.md +++ b/windows/src/desktop/help/advanced/text_services_framework.md @@ -16,7 +16,7 @@ keyboard input, handwriting recognition and speech recognition. In Windows 8, the Language Bar is no longer used, and the interface is tightly integrated into the taskbar. -![](desktop_images/language-bar.png) +![](../desktop_images/language-bar.png) With Keyman Desktop 9 and later versions, all keyboards are registered through the Windows interfaces, and the key advantage is that Keyman now diff --git a/windows/src/desktop/help/basic/config_tasks/hotkeys_tab.md b/windows/src/desktop/help/basic/config/hotkeys.md similarity index 63% rename from windows/src/desktop/help/basic/config_tasks/hotkeys_tab.md rename to windows/src/desktop/help/basic/config/hotkeys.md index 5e97011dd2..860f51e21a 100644 --- a/windows/src/desktop/help/basic/config_tasks/hotkeys_tab.md +++ b/windows/src/desktop/help/basic/config/hotkeys.md @@ -1,36 +1,35 @@ --- -title: Keyman Configuration - Hotkeys Tab {#basic_hotkeys_tab} +title: Keyman Configuration - Hotkeys Tab --- The Hotkeys tab of Keyman Configuration lets you set hotkeys for Keyman functions, Keyman keyboards and Windows languages. -![](desktop_images/tab-hotkeys.png) +![](../../desktop_images/tab-hotkeys.png) -**Opening the Hotkeys Tab** +## Opening the Hotkeys Tab To open the Hotkeys tab of Keyman Configuration: -1. Click on the Keyman icon ![](desktop_images/icon-keyman.png), on the +1. Click on the Keyman icon ![](../../desktop_images/icon-keyman.png), on the Windows Taskbar near the clock. 2. From the Keyman menu, select Configuration.... 3. Select the Hotkeys tab. - ::: {.tip} + **Tip:** Keyman Configuration opens in the same tab you last closed it in. - ::: -**Setting Hotkeys** +## Setting Hotkeys For help setting hotkeys in the Hotkeys tab of Keyman Configuration, -see: [???](#start_hotkey_set) +see: [How To - Set Hotkeys for Keyman, Keyman Keyboards and Windows Languages](../../start/hotkey_set) -::: {.note} +**Note:** By default, hotkeys only turn on a function or keyboard. If you prefer hotkeys to turn on or off a function or keyboard, you can change this -behaviour in the [Options tab](#basic_options_tab) of Keyman +behaviour in the [Options tab](options) of Keyman Configuration. Tick \'Keyboard hotkeys toggle keyboard activation\' and click OK. @@ -38,46 +37,31 @@ Some hotkeys do not toggle even if this option is enabled. Only the following hotkeys will toggle with this option enabled: - Show On Screen Keyboard Pane - - Show Keyboard Usage Pane - - Show Font Helper Pane - - Show Character Map Pane - - Any Keyman Keyboard Hotkey -::: -**About Hotkeys** +## About Hotkeys The General Hotkeys section of the Hotkeys tab lists hotkeys for Keyman functions: - Switch Keyman Off --- Switches to your default Windows keyboard, but does not exit Keyman. - -- Open Keyboard Menu --- Opens the [Keyman Menu](#basic_traymenu). - +- Open Keyboard Menu --- Opens the [Keyman Menu](../tray-menu). - Open Language Switcher --- Opens the [Language - Switcher](#basic_languageswitcher). - + Switcher](../language-switcher). - Show On Screen Keyboard Pane --- Opens or shows the [On Screen - Keyboard](#basic_osk) tool of the Keyman Toolbox. - -- Show Keyboard Usage Pane --- Opens or shows the [Keyboard - Usage](#basic_usage) tool of the Keyman Toolbox. - + Keyboard](../toolbox/osk) tool of the Keyman Toolbox. - Show Font Helper Pane --- Opens or shows the [Font - Helper](#basic_fonthelper) tool of the Keyman Toolbox. - + Helper](../toolbox/font-helper) tool of the Keyman Toolbox. - Show Character Map Pane --- Opens or shows the [Character - Map](#basic_charactermap) tool of the Keyman Toolbox. - + Map](../toolbox/character-map) tool of the Keyman Toolbox. - Open Text Editor --- Opens the [Keyman Text - Editor](#basic_text_editor). - + Editor](../text-editor). - Open Configuration --- Opens [Keyman - Configuration](#basic_config_menu). + Configuration](../config/). The Keyboards section of the Hotkeys tab lists hotkeys for all currently installed Keyman keyboards. @@ -85,10 +69,8 @@ installed Keyman keyboards. The Windows Languages section of the Hotkeys tab lists hotkeys for all currently installed Windows languages. -**Related Topics** +## Related Topics -- [???](#start_hotkey_set) - -- [???](#basic_config_menu) - -- [???](#basic_options_tab) +- [How To - Set Hotkeys for Keyman, Keyman Keyboards and Windows Languages](../../start/hotkey_set) +- [Keyman Configuration](../config/) +- [Keyman Configuration - Options Tab](options) diff --git a/windows/src/desktop/help/basic/config/index.md b/windows/src/desktop/help/basic/config/index.md new file mode 100644 index 0000000000..0c5c50e9f5 --- /dev/null +++ b/windows/src/desktop/help/basic/config/index.md @@ -0,0 +1,30 @@ +--- +title: Keyman Configuration +--- + +Keyman Configuration is the central control panel for Keyman. Use Keyman +Configuration to install and uninstall keyboards, change options, set +hotkeys, disable addins, associate languages, check for updates, +switch the language of Keyman user interface, and run support diagnostics. + +![](../../desktop_images/tab-support.png) + +## Opening Keyman Configuration + +To open Keyman Configuration: + +1. Click on the Keyman icon ![](../../desktop_images/icon-keyman.png), on the + Windows Taskbar near the clock. + +2. From the Keyman menu, select Configuration.... + +## Using Keyman Configuration + +For more information on using Keyman Configuration, see: + +- [How To - Set the Language for Keyman Menus](../../start/locale) +- [Keyman Configuration - Keyboard Layouts Tab](keyboards) +- [Keyman Configuration - Options Tab](options) +- [Keyman Configuration - Hotkeys Tab](hotkeys) +- [Keyman Configuration - Support Tab](support) +- [Keyman Configuration - Keep in Touch Tab](keep-in-touch) diff --git a/windows/src/desktop/help/basic/config/keep-in-touch.md b/windows/src/desktop/help/basic/config/keep-in-touch.md new file mode 100644 index 0000000000..4c852db551 --- /dev/null +++ b/windows/src/desktop/help/basic/config/keep-in-touch.md @@ -0,0 +1,6 @@ +--- +title: Keep in touch tab +--- + +This page provides options to engage with the Keyman community and +follow the Keyman team to learn more about development on Keyman. diff --git a/windows/src/desktop/help/basic/config/keyboards.md b/windows/src/desktop/help/basic/config/keyboards.md new file mode 100644 index 0000000000..fdc4c5a638 --- /dev/null +++ b/windows/src/desktop/help/basic/config/keyboards.md @@ -0,0 +1,105 @@ +--- +title: Keyman Configuration - Keyboard Layouts Tab +--- + +The Keyboard Layouts tab of Keyman Configuration lists all the Keyman +keyboards which are currently installed on your computer. You can use +the Keyboard Layouts tab to install and uninstall keyboards, enable and +disable keyboards, set keyboard hotkeys, show keyboard help and view +keyboard details. + +![](../../desktop_images/tab-layout.png) + +## Opening the Keyboard Layouts Tab + +To open the Keyboard Layouts tab of Keyman Configuration: + +1. Click on the Keyman icon ![](../../desktop_images/icon-keyman.png), on the + Windows Taskbar near the clock. + +2. From the Keyman menu, select Configuration.... + +3. Select the Keyboard Layouts tab. + + **Tip:** + Keyman Configuration opens in the same tab you last closed it in. + +## Installing a Keyboard + +To install a keyboard layout in Keyman, see: [Installing a Keyman Keyboard within Keyman](../../start/download-and-install-keyboard) + +## Uninstalling a Keyboard + +To uninstall a Keyman keyboard from the Keyboard Layouts tab of Keyman +Configuration, see: [Keyboard Task - Uninstall a Keyboard](../uninstall-keyboard) + +## Enabling and Disabling a Keyboard + +To enable or disable a Keyman keyboard from the Keyboard Layouts tab of +Keyman Configuration, see: [Keyboard Task - Enable or Disable a Keyboard](../enable-or-disable-keyboard) + +## Setting a Hotkey + +To set a hotkey for a Keyman keyboard, use the [Hotkeys tab](hotkeys). + +## Showing Introductory Help + +To show introductory help for a Keyman keyboard from the Keyboard +Layouts tab of Keyman Configuration: + +1. Find a keyboard in the keyboard list. + +2. Click on the question mark icon + (![](../../desktop_images/icon-introductory-help.png)) beside the keyboard + name. The keyboard help documentation will be shown. + +## Viewing Keyboard Details + +To view details for a Keyman keyboard from the Keyboard Layouts tab of +Keyman Configuration: + +1. Find a keyboard in the keyboard list. + +2. Click on the down arrow + (![](../../desktop_images/keyboards-downarrow.png)) beside the keyboard + name. The keyboard information window will expand. + + ![](../../desktop_images/keyboards-hotkey.png) + +3. In the information window you can view keyboard details, including: + + - Keyboard filename. + - Keyboard package name. + - Keyboard version number. + - Keyboard encodings. + - Keyboard layout type. + - On Screen Keyboard status. + - Documentation status. + - Copyright details. + - Installation details. + +## Sharing a keyboard with other users and devices + +If you installed a keyboard layout using the Download keyboard button, +then you can share the keyboard with other devices and users using a QR +Code. + +1. Expand the keyboard details for the keyboard you wish to share, and + click Share keyboard. + +2. A popup will appear with a QR Code. This QR Code can be scanned with + a mobile phone camera to automatically open a web page with a + download link to install the keyboard. + + ![](../../desktop_images/keyboard-share.png) + +## Associating a keyboard with a Windows language + +All Keyman keyboards are associated with a Windows language by default. +To change the association, or add a new association, see the following: + +- [How To - Set up Your Computer for a Keyman Keyboard](../../start/configure-computer) + +## Related Topics + +- [Keyman Configuration](../config/) diff --git a/windows/src/desktop/help/basic/config_tasks/options_tab.md b/windows/src/desktop/help/basic/config/options.md similarity index 60% rename from windows/src/desktop/help/basic/config_tasks/options_tab.md rename to windows/src/desktop/help/basic/config/options.md index 572abbb139..4e79c23ae3 100644 --- a/windows/src/desktop/help/basic/config_tasks/options_tab.md +++ b/windows/src/desktop/help/basic/config/options.md @@ -1,31 +1,30 @@ --- -title: Keyman Configuration - Options Tab {#basic_options_tab} +title: Keyman Configuration - Options Tab --- The Options tab of Keyman Configuration includes the Keyman application options. You can use the Options tab to set general, startup, Keyman Toolbox On Screen Keyboard and advanced options. -![](desktop_images/tab-options2.png) +![](../../desktop_images/tab-options2.png) -**Opening the Options Tab** +## Opening the Options Tab To open the Options tab of Keyman Configuration: -1. Click on the Keyman icon ![](desktop_images/icon-keyman.png), on the +1. Click on the Keyman icon ![](../../desktop_images/icon-keyman.png), on the Windows Taskbar near the clock. 2. From the Keyman menu, select Configuration.... 3. Select the Options tab. - ::: {.tip} + **Tip:** Keyman Configuration opens in the same tab you last closed it in. - ::: -**Using General Options** +## Using General Options -![](desktop_images/options-general.png) +![](../../desktop_images/options-general.png) - Keyboard hotkeys toggle keyboard activation @@ -34,22 +33,36 @@ To open the Options tab of Keyman Configuration: keyboard on and off. Untick this option and a Keyman keyboard hotkey will only turn the Keyman keyboard on. - ::: {.tip} - Set hotkeys in the - Hotkeys tab - of Keyman Configuration. - ::: + **Tip:** + Set hotkeys in the Hotkeys tab of Keyman Configuration. - Simulate AltGr with Ctrl+Alt - Some hardware keyboards do not have a designated AltGr key (Right - Alt key). Some Keyman keyboards require AltGr. Tick this option to - allow Ctrl+Alt to be used for AltGr. Untick this option and Ctrl+Alt - will not be used for AltGr. + Some hardware keyboards do not have a designated AltGr key + (Right Alt key). Some Keyman keyboards require + AltGr. Tick this option to allow Ctrl + + Alt to be used for AltGr>. Untick this option + and Ctrl + Alt will not be used for + AltGr. -- Select keyboard layout for all applications +- Show hint messages - Unlike Windows default behaviour, Keyman allows you to select one + You can turn on and off the beginner hint messages which appear + while using Keyman. Tick this option to show all hint messages. + Untick this option to hide all hint messages. + + **Note:** + You can also hide hint messages on a case-by-case basis by ticking + at the bottom of each hint. + +- Reset Hints + + Click the Reset Hints button to switch all hint messages on again, + even those that you have switched off on a case-by-case basis. + +- Select keyboard layout for all applications (Windows 7) + + Unlike Windows 7 default behaviour, Keyman allows you to select one Windows language and Keyman keyboard for all open applications and text fields across your entire system. Tick this option to select one Windows language and Keyman keyboard across your entire system. @@ -60,44 +73,55 @@ To open the Options tab of Keyman Configuration: because Windows has this functionality built in. The setting can be changed in Windows, with the following steps: - - Open Control Panel - - Select Language, Advanced Settings + - Search for "Advanced Keyboard Settings" - Check the \"Let me set a different input method for each app window\" checkbox. -- Show hint messages +- Automatically report errors to keyman.com - You can turn on and off the beginner hint messages which appear - while using Keyman. Tick this option to show all hint messages. - Untick this option to hide all hint messages. + If Keyman crashes, then it can automatically send a report to the + development team. This report is anonymous and contains only + technical details relating to the crash. It does not include + keystroke data or personally identifying data. - ::: {.note} - You can also hide hint messages on a case-by-case bases by ticking - at the bottom of each hint. - ::: +- Share anonymous usage statistics with keyman.com -- Reset Hints + In order to understand how users engage with different parts of + the Keyman program, anonymous usage statistics may be periodically + sent to keyman.com. These statistics do not include keystroke data + or any personally identifying data. If you would prefer not to + share these statistics, uncheck this box. - Click the Reset Hints button to switch all hint messages on again, - even those that you have switched off on a case-by-case basis. + **Note:** In Keyman 14.0, no statistics are currently sent, + although the infrastructure is in place. -**Using Startup Options** +## Using Startup Options -![](desktop_images/options-startup.png) +![](../../desktop_images/options-startup.png) + +- Test for conflicting applications when Keyman starts + + Some applications are not written according to the Windows software + development standards and can cause problems with Keyman keyboard + input. Tick this option to have Keyman detect problem applications + and attempt to work around them. - Start when Windows starts - You can have Keyman start when Windows starts. Tick this option to - have Keyman start when Windows starts. Untick this option to start - Keyman manually. + You can have Keyman start when you login to Windows. Tick this + option to have Keyman start automatically after you have logged in. + When you use this option, Keyman will not show its startup screen. + If you untick this option, you can start Keyman yourself from the + Start Menu. - Show splash screen - You can turn on and off the Keyman splash screen that appears when - Keyman starts. Tick this option to show the splash screen on - startup. Untick this option to remove the splash screen. + You can turn on and off the Keyman startup screen that appears when + Keyman starts. Tick this option to show the startup screen when + Keyman is started. Note that the startup screen will not show when + Keyman is started automatically with Windows. -- Automatically check www.keyman.com weekly for updates. +- Automatically check keyman.com weekly for updates. Keyman can automatically check for application and keyboard updates once a week. No personally identifiable information is sent to @@ -106,31 +130,23 @@ To open the Options tab of Keyman Configuration: you have installed. Untick this option to check for updates manually. - ::: {.note} + **Note:** Keyman can be updated manually through the Support tab in the Configuration menu. - ::: -- Test for conflicting applications when Keyman starts +## Using On Screen Keyboard Options - Some applications are not written according to the Windows software - development standards and can cause problems with Keyman keyboard - input. Tick this option to have Keyman detect problem applications - and work around them. Untick this option to prevent Keyman from - working around problem applications. - -**Using On Screen Keyboard Options** - -![](desktop_images/options-osk.png) +![](../../desktop_images/options-osk.png) - Release Shift/Ctrl/Alt on On Screen Keyboard after clicking a key By default, the On Screen Keyboard of the Keyman Toolbox uses - \'sticky\' Ctrl, Shift or Alt keys. This means Ctrl, Shift, and Alt + \'sticky\' Ctrl, Shift or Alt + keys. This means Ctrl, Shift and Alt stay down on the On Screen Keyboard until they are clicked again or until you press the actual keys on your hardware keyboard. Tick this - option to disable the default sticky key behaviour. Untick this - option to enable the default sticky key behaviour. + option to release these keys after any key is clicked on the + On Screen Keyboard. - Always show On Screen Keyboard Window when Keyman keyboard is selected @@ -143,16 +159,11 @@ To open the Options tab of Keyman Configuration: - Switch to appropriate On Screen Keyboard/Help automatically when a keyboard is selected - Each time you turn on a Keyman keyboard, Keyman can automatically - detect and switch to the Keyman Toolbox tool which is best for that - Keyman keyboard: either the On Screen Keyboard or Keyboard Usage. - Tick this option to have Keyman automatically detect and display the - best view for your Keyman keyboard. Untick this option to prevent - Keyman from switching its display automatically. + This option is deprecated in Keyman 14.0 and has no function. -**Using Advanced Options** +## Using Advanced Options -![](desktop_images/options-advanced.png) +![](../../desktop_images/options-advanced.png) - Debugging @@ -174,25 +185,21 @@ To open the Options tab of Keyman Configuration: tool. Debug log files are in binary format and can be imported into - Windows Event Viewer for viewing, or Microsoft Message Analyzer - (recommended). + Windows Performance Analyzer for viewing. - ::: {.note} + **Note:** It is highly recommended that you switch off this option after obtaining the debug log. The log files can grow very large very quickly! - ::: - ::: {.warning} + **Warning:** Privacy Warning - The debug log records every keystroke you type, even if a Keyman keyboard is not active. This includes logins and passwords! For this reason, we recommend only switching the debug log on for short and isolated tests as specifically requested by Keyman Technical Support. - ::: -**Related Topics** +## Related Topics -- [???](#basic_config_menu) - -- [???](#basic_hotkeys_tab) +- [Keyman Configuration](../config/) +- [Hotkeys tab](hotkeys) diff --git a/windows/src/desktop/help/basic/config_tasks/support_tab.md b/windows/src/desktop/help/basic/config/support.md similarity index 61% rename from windows/src/desktop/help/basic/config_tasks/support_tab.md rename to windows/src/desktop/help/basic/config/support.md index d8df951ac1..1123c2a447 100644 --- a/windows/src/desktop/help/basic/config_tasks/support_tab.md +++ b/windows/src/desktop/help/basic/config/support.md @@ -1,5 +1,5 @@ --- -title: Keyman Configuration - Support Tab {#basic_support_tab} +title: Keyman Configuration - Support Tab --- The Support tab of Keyman Configuration displays Keyman version @@ -7,47 +7,45 @@ information and support tools. You can use the Support tab to send a support request, check Windows language settings, check for updates, and view Keyman version information. -![](desktop_images/tab-support.png) +![](../../desktop_images/tab-support.png) -**Opening the Support Tab** +## Opening the Support Tab To open the Support tab of Keyman Configuration: -1. Click on the Keyman icon ![](desktop_images/icon-keyman.png), on the +1. Click on the Keyman icon ![](../../desktop_images/icon-keyman.png), on the Windows Taskbar near the clock. 2. From the Keyman menu, select Configuration.... 3. Select the Support tab. - ::: {.tip} + **Tip:** Keyman Configuration opens in the same tab you last closed it in. - ::: -**Collecting Diagnostic Information** +## Collecting Diagnostic Information You can collect diagnostic information about Keyman by clicking the \'Diagnostics\' link under the \'Useful Links\' section. The support diagnostic will collect critical diagnostic information from your computer and generate a report. -**Checking for Updates** +## Checking for Updates To check for Keyman updates, from the Support tab of Keyman Configuration click the \'Check for Updates\' link. You can also download and install Keyman again from the Keyman website. -**About Version Information** +## About Version Information You can view version details from the Support tab of Keyman -Configuration. In the Support tab you will see: +Configuration. In the Support tab you will see a version +number beneath the Keyman logo. This version number will show +whether you are using a stable or pre-release version of Keyman +and should be reported in its entirety if you are ever requesting +help from the Keyman Community. -- Version Detals - - Edition --- Details on your current edition of Keyman. - - - Version --- The current Keyman version number - -**Accessing the Keyman Community** +## Accessing the Keyman Community [Keyman Community](https://community.software.sil.org/c/keyman) @@ -55,8 +53,7 @@ Configuration. In the Support tab you will see: internet browser. You will need to have internet access for this to open successfully. -**Related Topics** +## Related Topics -- [???](#basic_config_menu) - -- [???](#start_download-install_keyman) +- [Keyman Configuration](../config/) +- [How To - Download and Install Keyman](../../start/download-and-install-keyman) diff --git a/windows/src/desktop/help/basic/config_tasks/config_menu.md b/windows/src/desktop/help/basic/config_tasks/config_menu.md deleted file mode 100644 index 539678e5b6..0000000000 --- a/windows/src/desktop/help/basic/config_tasks/config_menu.md +++ /dev/null @@ -1,34 +0,0 @@ ---- -title: Keyman Configuration {#basic_config_menu} ---- - -Keyman Configuration is the central control panel for Keyman. Use Keyman -Configuration to purchase and activate Keyman, switch the language of -Keyman menus, install and uninstall keyboards, change options, set -hotkeys, disable addins, associate languages, check for updates and run -support diagnostics. - -![](desktop_images/tab-support.png) - -**Opening Keyman Configuration** - -To open Keyman Configuration: - -1. Click on the Keyman icon ![](desktop_images/icon-keyman.png), on the - Windows Taskbar near the clock. - -2. From the Keyman menu, select Configuration.... - -**Using Keyman Configuration** - -For more information on using Keyman Configuration, see: - -- [???](#start_locale) - -- [???](#basic_keyboards_tab) - -- [???](#basic_options_tab) - -- [???](#basic_hotkeys_tab) - -- [???](#basic_support_tab) diff --git a/windows/src/desktop/help/basic/config_tasks/keyboards_tab.md b/windows/src/desktop/help/basic/config_tasks/keyboards_tab.md deleted file mode 100644 index a176160d49..0000000000 --- a/windows/src/desktop/help/basic/config_tasks/keyboards_tab.md +++ /dev/null @@ -1,154 +0,0 @@ ---- -title: Keyman Configuration - Keyboard Layouts Tab {#basic_keyboards_tab} ---- - -The Keyboard Layouts tab of Keyman Configuration lists all the Keyman -keyboards which are currently installed on your computer. You can use -the Keyboard Layouts tab to install and uninstall keyboards, enable and -disable keyboards, set keyboard hotkeys, show keyboard help and view -keyboard details. - -![](desktop_images/tab-layout.png) - -**Opening the Keyboard Layouts Tab** - -To open the Keyboard Layouts tab of Keyman Configuration: - -1. Click on the Keyman icon ![](desktop_images/icon-keyman.png), on the - Windows Taskbar near the clock. - -2. From the Keyman menu, select Configuration.... - -3. Select the Keyboard Layouts tab. - - ::: {.tip} - Keyman Configuration opens in the same tab you last closed it in. - ::: - -**Installing a Keyboard** - -There are two ways to install a Keyman keyboard from the Keyboard -Layouts tab of Keyman Configuration: - -- To install a keyboard layout from a local folder, see: [Installing a - Keyman keyboard from a Folder on Your Computer](#install_folder) - -- To install a keyboard layout online, see: [Downloading & Installing - a Keyman Keyboard within Keyman](#install_tav) - -**Uninstalling a Keyboard** - -To uninstall a Keyman keyboard from the Keyboard Layouts tab of Keyman -Configuration, see: [???](#basic_uninstall_keyboard) - -**Enabling and Disabling a Keyboard** - -To enable or disable a Keyman keyboard from the Keyboard Layouts tab of -Keyman Configuration, see: [???](#basic_disable_keyboard) - -**Setting a Hotkey** - -To set a hotkey for a Keyman keyboard from the Keyboard Layouts tab of -Keyman Configuration: - -1. Find a keyboard in the keyboard list. - -2. Click on the (no hotkey) or current hotkey link found beside the - keyboard name. The Change Hotkey dialog box will be displayed. - - ![](desktop_images/hotkeys-change.png) - -3. Select a default hotkey or click Custom and type the hotkey you wish - to use. - - ::: {.note} - If you press a single letter or Shift plus a single letter, the - hotkey will default to Ctrl + Alt plus the letter you pressed, in - order to avoid conflicts with standard keyboard input. - ::: - - ::: {.note} - To clear a hotkey that has been set previously, click Clear Hotkey - or press Backspace. - ::: - - ::: {.note} - Be aware that you can set the hotkey to replace common Windows - hotkeys (Ctrl + C, Ctrl + V, etc). - ::: - -4. Click OK to save your selection. - -5. Click OK again from the Configuration window to apply the changes. - -The new hotkey will now be available. - -**Showing Introductory Help** - -To show introductory help for a Keyman keyboard from the Keyboard -Layouts tab of Keyman Configuration: - -1. Find a keyboard in the keyboard list. - -2. Click on the question mark icon - (![](desktop_images/icon-introductory-help.png)) beside the keyboard - name. The keyboard help documentation will be shown. - -**Viewing Keyboard Details** - -To view details for a Keyman keyboard from the Keyboard Layouts tab of -Keyman Configuration: - -1. Find a keyboard in the keyboard list. - -2. Click on the down arrow - (![](desktop_images/keyboards-downarrow.png)) beside the keyboard - name. The keyboard information window will expand. - - ![](desktop_images/keyboards-hotkey.png) - -3. In the information window you can view keyboard details, including: - - - Keyboard filename. - - - Keyboard package name. - - - Keyboard version number. - - - Keyboard encodings. - - - Keyboard layout type. - - - On Screen Keyboard status. - - - Documentation status. - - - Copyright details. - - - Installation details. - -**Sharing a keyboard with other users and devices** - -If you installed a keyboard layout using the Download keyboard button, -then you can share the keyboard with other devices and users using a QR -Code. - -1. Expand the keyboard details for the keyboard you wish to share, and - click Share keyboard. - -2. A popup will appear with a QR Code. This QR Code can be scanned with - a mobile phone camera to automatically open a web page with a - download link to install the keyboard. - - ![](desktop_images/keyboard-share.png) - -**Associating a keyboard with a Windows language** - -All Keyman keyboards are associated with a Windows language by default. -To change the association, or add a new association, see the following: - -- [???](#start_configure_computer) - -**Related Topics** - -- [???](#basic_config_menu) diff --git a/windows/src/desktop/help/basic/keyboard_tasks/disable_keyboard.md b/windows/src/desktop/help/basic/enable-or-disable-keyboard.md similarity index 54% rename from windows/src/desktop/help/basic/keyboard_tasks/disable_keyboard.md rename to windows/src/desktop/help/basic/enable-or-disable-keyboard.md index b14b1a20c6..0d9fb6733c 100644 --- a/windows/src/desktop/help/basic/keyboard_tasks/disable_keyboard.md +++ b/windows/src/desktop/help/basic/enable-or-disable-keyboard.md @@ -1,10 +1,12 @@ --- -title: Keyboard Task - Enable and Disable a Keyboard {#basic_disable_keyboard} +title: Keyboard Task - Enable or Disable a Keyboard --- -Keyman keyboards can be enabled and disabled. +Keyman keyboards can be enabled and disabled. When disabled, they are +removed from the list of keyboards you can select from, but they are +not uninstalled. -**Disabling a Keyman keyboard** +## Disabling a Keyman keyboard Disabling a Keyman keyboard removes it from the Keyman menu and Keyman Toolbox but does not uninstall the keyboard. This is useful if: @@ -20,14 +22,14 @@ To disable a Keyman keyboard: 1. Open Keyman. -2. Click on the Keyman icon ![](desktop_images/icon-keyman.png), on the +2. Click on the Keyman icon ![](../desktop_images/icon-keyman.png), on the Windows Taskbar near the clock. - ![](desktop_images/menu.png) + ![](../desktop_images/menu.png) 3. Select Configuration. - ![](desktop_images/tab-layout.png) + ![](../desktop_images/tab-layout.png) 4. Select the Keyboard Layouts tab. @@ -38,20 +40,20 @@ To disable a Keyman keyboard: When a keyboard layout is disabled, its name appears in grey and its checkbox is unticked. -**Enabling a Keyman keyboard** +## Enabling a Keyman keyboard To enable a Keyman keyboard: 1. Open Keyman. -2. Click on the Keyman icon ![](desktop_images/icon-keyman.png), on the +2. Click on the Keyman icon ![](../desktop_images/icon-keyman.png), on the Windows Taskbar near the clock. - ![](desktop_images/menu.png) + ![](../desktop_images/menu.png) 3. Select Configuration. - ![](desktop_images/tab-layout.png) + ![](../desktop_images/tab-layout.png) 4. Select the Keyboard Layouts tab. @@ -59,10 +61,8 @@ To enable a Keyman keyboard: 6. Click OK. -**Related Topics** +## Related Topics -- [???](#basic_uninstall_keyboard) - -- [???](#basic_enable_keyboard) - -- [???](#basic_keyboards_tab) +- [Keyboard Task - Uninstall a Keyboard](uninstall-keyboard) +- [Keyboard Task - Turn on a Keyboard](select-keyboard) +- [Keyman Configuration - Keyboard Layouts Tab](config/keyboards) diff --git a/windows/src/desktop/help/basic/engine_tasks/uninstall.md b/windows/src/desktop/help/basic/engine_tasks/uninstall.md deleted file mode 100644 index b999d5deb9..0000000000 --- a/windows/src/desktop/help/basic/engine_tasks/uninstall.md +++ /dev/null @@ -1,18 +0,0 @@ ---- -title: Software Task - Uninstall Keyman {#basic_uninstall} ---- - -To uninstall Keyman: - -1. Close Keyman. - -2. Open Windows Control Panel. - -3. Select \'Add or Remove Programs\' or \'Programs and Features\' or - \'Uninstall a program\'. - -4. Click Keyman in the list. - -5. Click Remove or Uninstall or right-click \'Uninstall\'. - -6. Follow the prompts to complete the uninstall. diff --git a/windows/src/desktop/help/basic/help.md b/windows/src/desktop/help/basic/help.md index 3767ef9282..3baea61c4c 100644 --- a/windows/src/desktop/help/basic/help.md +++ b/windows/src/desktop/help/basic/help.md @@ -12,14 +12,14 @@ Keyman. To open Keyman Help: -1. Click on the Keyman icon ![](desktop_images/icon-keyman.png), on the +1. Click on the Keyman icon ![](../desktop_images/icon-keyman.png), on the Windows Taskbar near the clock. 2. From the Keyman menu, select Help…. 3. Select Help Contents. - ![](desktop_images/help-dialog.png) + ![](../desktop_images/help-dialog.png) ## Using Help diff --git a/windows/src/desktop/help/basic/index.md b/windows/src/desktop/help/basic/index.md index f7d9f2dfee..0267f1ccc3 100644 --- a/windows/src/desktop/help/basic/index.md +++ b/windows/src/desktop/help/basic/index.md @@ -2,30 +2,21 @@ title: Basic Help --- -* [newways](newways) +* [New Ways to Use Keyman](new-ways-to-use-keyman) -* [update](update) -* [uninstall](uninstall) +* [Update Keyman](update) +* [Uninstall Keyman](uninstall) -* [enable_keyboard](enable_keyboard) -* [disable_keyboard](disable_keyboard) -* [uninstall_keyboard](uninstall_keyboard) +* [Keyboard Task - Turn on a Keyboard](select-keyboard) +* [Keyboard Task - Enable or Disable a Keyboard](enable-or-disable-keyboard) +* [Keyboard Task - Uninstall a Keyboard](uninstall-keyboard) -* [traymenu](traymenu) -* [toolbox](toolbox) -* [osk](osk) -* [usage](usage) -* [fonthelper](fonthelper) -* [charactermap](charactermap) +* [The Keyman Menu](tray-menu) +* [The Keyman Toolbox](toolbox/) +* [Keyman Configuration](config/) +* [Language Switcher](language-switcher) +* [Keyman Text Editor](text-editor) -* [languageswitcher](languageswitcher) +* [How To - Make the Keyman icon visible](make-taskbar-icon-visible) -* [text_editor](text_editor) - -* [config_menu](config_menu) -* [keyboards_tab](keyboards_tab) -* [options_tab](options_tab) -* [hotkeys_tab](hotkeys_tab) -* [support_tab](support_tab) - -* [help](help) +* [About Keyman Help](help) diff --git a/windows/src/desktop/help/basic/keyboard_tasks/enable_keyboard.md b/windows/src/desktop/help/basic/keyboard_tasks/enable_keyboard.md deleted file mode 100644 index 45eb146dbb..0000000000 --- a/windows/src/desktop/help/basic/keyboard_tasks/enable_keyboard.md +++ /dev/null @@ -1,139 +0,0 @@ ---- -title: Keyboard Task - Turn on a Keyboard {#basic_enable_keyboard} ---- - -Here are five simple ways to turn on a Keyman keyboard. - -::: {.note} -To use a Keyman keyboard, the keyboard must be enabled in the Keyboard -Layouts tab of Keyman Configuration. For help enabling your keyboard, -see: -::: - -**Turning on a Keyboard from the Keyman Menu** - -To turn on a keyboard from the Keyman menu: - -1. Open an application to type in, like MS Word. - - ::: {.note} - You need to have an application open for your Keyman keyboard to - load correctly. - ::: - -2. Start Keyman. - -3. Click on the Keyman icon ![](desktop_images/icon-keyman.png), on the - Windows Taskbar near the clock. - - ![](desktop_images/menu.png) - -4. Select your Keyman keyboard from the list. You will notice the - Keyman menu icon change to the icon of your Keyman keyboard. This - means your Keyman keyboard is on. - -**Turning on a Keyboard from the Keyman Toolbox** - -To turn on a keyboard from the Keyman Toolbox: - -1. Open an application to type in, like MS Word. - -2. Start Keyman. - -3. Click on the Keyman icon ![](desktop_images/icon-keyman.png), on the - Windows Taskbar near the clock. - - ![](desktop_images/menu.png) - -4. Click to open the On Screen Keyboard view of the Keyman Toolbox. - - ![](desktop_images/osk-tibetan.png) - -5. Click to select your Keyman keyboard from the toolbar of the Keyman - Toolbox. You will notice the Keyman menu icon change to the icon of - your Keyman keyboard. This means your Keyman keyboard is on. - -**Turning on a Keyboard from the Language Switcher** - -Here\'s how to turn on a keyboard using the Language Switcher: - -1. Open an application to type in, like MS Word. - - ::: {.note} - You need to have an application open for your Keyman keyboard to - load correctly. - ::: - -2. Start Keyman. - -3. Press the Language Switcher hotkey to bring up the Language - Switcher. If you are using the default Language Switcher hotkey - (Left.Alt + Shift) or another hotkey with Alt, you will need to - press and HOLD the Alt part of the hotkey and press and RELEASE the - last key in the hotkey to use the Language Switcher. When you - release Alt, the Language Switcher will close. - - ::: {.note} - By default, the Language Switcher hotkey is Left.Alt + Shift. You - can view or change the current Language Switcher hotkey from the - [Hotkeys tab](#basic_hotkeys_tab) of Keyman Configuration. - ::: - - ![](desktop_images/languageswitcher-small.png) - -4. Navigate the Language Switcher using the arrow keys or by pressing - Shift to select your Keyman keyboard. - -5. Release the Language Switcher hotkey or press Enter to activate the - selected keyboard and close the Language Switcher. You will notice - the Keyman menu icon change to the icon of your Keyman keyboard. - This means your Keyman keyboard is on. - -**Turning on a Keyboard with a Hotkey** - -To turn on a keyboard from the Keyman menu: - -1. Open an application to type in, like MS Word. - -2. Start Keyman. - -3. Press and release the hotkey for your Keyman keyboard. - - ::: {.note} - You can find the current hotkey for your keyboard in the Keyman - menu. You can set or reset a hotkey for your keyboard from the - Hotkeys tab - of Keyman Configuration. - ::: - - ![](desktop_images/menu.png) - -4. You will notice the Keyman menu icon change to the icon of your - Keyman keyboard. This means your Keyman keyboard is on. - -**Turning on a Keyboard by switching Windows languages** - -Because Keyman keyboards are always associated with a Windows language, -turning on that Windows language will automatically turn on the Keyman -keyboard. If a Windows keyboard is also associated with the language, or -multiple Keyman keyboards are associated with the language, an extra -icon will appear next to the Windows language that will allow you to -choose the keyboard you want to use. - -**Related Topics** - -- [???](#basic_traymenu) - -- [???](#basic_toolbox) - -- [???](#basic_languageswitcher) - -- [???](#basic_hotkeys_tab) - -- [???](#basic_keyboards_tab) - -- [???](#start_download-install_keyboard) - -- [???](#basic_disable_keyboard) - -- [???](#troubleshooting_hidden) diff --git a/windows/src/desktop/help/basic/keyboard_tasks/uninstall_keyboard.md b/windows/src/desktop/help/basic/keyboard_tasks/uninstall_keyboard.md deleted file mode 100644 index b58c2da882..0000000000 --- a/windows/src/desktop/help/basic/keyboard_tasks/uninstall_keyboard.md +++ /dev/null @@ -1,44 +0,0 @@ ---- -title: Keyboard Task - Uninstall a Keyboard {#basic_uninstall_keyboard} ---- - -Uninstalling a Keyman keyboard removes it from Keyman. If you want to -use the Keyman keyboard again it must be reinstalled. - -::: {.note} -You can disable a keyboard temporarily, instead of uninstalling it. For -more help, see: -::: - -To uninstall a Keyman keyboard: - -1. Open Keyman. - -2. Click on the Keyman icon ![](desktop_images/icon-keyman.png), on the - Windows Taskbar near the clock. - - ![](desktop_images/menu.png) - -3. Select Configuration. - -4. Select the Keyboard Layouts tab. - - ![](desktop_images/tab-layout.png) - -5. Click on the uninstall icon ![](desktop_images/icon-uninstall.png) - for the keyboard you want to uninstall. - -6. A message box is displayed asking you to confirm this is the package - or keyboard layout that you wish to uninstall. Click OK. - -7. Click OK. - -The Keyman keyboard is now removed from Keyman. - -**Related Topics** - -- [???](#basic_disable_keyboard) - -- [???](#basic_enable_keyboard) - -- [???](#start_download-install_keyboard) diff --git a/windows/src/desktop/help/basic/languageswitcher.md b/windows/src/desktop/help/basic/language-switcher.md similarity index 86% rename from windows/src/desktop/help/basic/languageswitcher.md rename to windows/src/desktop/help/basic/language-switcher.md index fe5faf23a6..ae0113a855 100644 --- a/windows/src/desktop/help/basic/languageswitcher.md +++ b/windows/src/desktop/help/basic/language-switcher.md @@ -6,7 +6,7 @@ The Keyman Language Switcher is a single popup menu to let you rapidly switch between any installed Keyman keyboard, Windows language or Windows layout. -![](desktop_images/languageswitcher.png) +![](../desktop_images/languageswitcher.png) ## Opening and Using the Language Switcher @@ -21,7 +21,7 @@ To open and use the Keyman Language Switcher **Note**: By default, the Language Switcher hotkey is Left.Alt + Shift. You can view or change the current Language Switcher hotkey from the - [Hotkeys tab](#basic_hotkeys_tab) of Keyman Configuration. + [Hotkeys tab](config/hotkeys) of Keyman Configuration. ![](../desktop_images/languageswitcher-small.png) @@ -35,5 +35,5 @@ To open and use the Keyman Language Switcher ## Related Topics -- [The Keyman Menu](traymenu) -- [Keyman Configuration - Hotkeys Tab](config_tasks/hotkeys_tab) +- [The Keyman Menu](tray-menu) +- [Keyman Configuration - Hotkeys Tab](config/hotkeys) diff --git a/windows/src/desktop/help/basic/make-taskbar-icon-visible.md b/windows/src/desktop/help/basic/make-taskbar-icon-visible.md new file mode 100644 index 0000000000..d68cf47544 --- /dev/null +++ b/windows/src/desktop/help/basic/make-taskbar-icon-visible.md @@ -0,0 +1,66 @@ +--- +title: How To - Make the Keyman icon visible +--- + +If the Keyman icon is not on the Windows Taskbar near the clock, click +the arrow or triangle near the clock: + +- You will see a collection of icons. If the Keyman icon + (![](../desktop_images/icon-keyman.png)) is not in this collection, + Keyman is not running. + +- If the Keyman icon is in this collection, you can optionally + move it permanently to the Windows Taskbar, to make it more + easily accessible. However, Keyman will run correctly even if + the icon is left in this collection. + +## Move the icon with the mouse + +You can move the Keyman icon simply by dragging it down to the Taskbar +notification area with your mouse. + +## Move the icon using Windows Settings + +Here's how to make the change with Windows Settings: + +- On Windows 10 + + 1. Right-click on the Windows Taskbar. + ![](../desktop_images/win10-taskbar1.png) + 2. Select 'Taskbar settings'. + 3. Under 'Notification area', click on 'Select which icons + appear on the taskbar' + ![](../desktop_images/win10-taskbar2.png) + 4. From the toggle button beside 'Keyman + Engine x86', click to turn it on. + ![](../desktop_images/win10-taskbar3.png) + 5. The Keyman icon will now always appear in the Windows + Taskbar near the clock, if Keyman is on. + 6. Continue on to [Step 5](#tutorial_step5) of this guide. + +- On Windows 8: + + 1. Right-click on the Windows Taskbar. + ![](../desktop_images/win8-taskbar1.png) + 2. Select 'Properties'. + 3. Next to 'Notification area', click Customize…. + ![](../desktop_images/win8-taskbar2.png) + 4. From the dropdown menu beside 'Keyman + Engine x86', select 'Show icon and notifications'. + ![](../desktop_images/win8-taskbar3.png) + 5. Click OK to apply changes. The Keyman icon will now always + appear in the Windows Taskbar near the clock, if Keyman is + on. + 6. Continue on to [Step 5](#tutorial_step5) of this guide. + +- On Windows 7: + + 1. Open the Windows Start menu. + 2. In the search field, type and enter: Notification Area Icons + 3. From the dropdown menu beside Keyman + Engine x86, select 'Show icon and notifications'. + ![](../desktop_images/7-taskbar.png) + 4. Click OK to apply changes. The Keyman icon will now always + appear in the Windows Taskbar near the clock, if Keyman is + on. + 5. Continue on to [Step 5](#tutorial_step5) of this guide. \ No newline at end of file diff --git a/windows/src/desktop/help/basic/newways.md b/windows/src/desktop/help/basic/new-ways-to-use-keyman.md similarity index 78% rename from windows/src/desktop/help/basic/newways.md rename to windows/src/desktop/help/basic/new-ways-to-use-keyman.md index c8d0517e5f..af2f259168 100644 --- a/windows/src/desktop/help/basic/newways.md +++ b/windows/src/desktop/help/basic/new-ways-to-use-keyman.md @@ -8,6 +8,8 @@ you can or should access some of Keyman's features. These changes have been implemented as part of enhancing how Keyman integrates with modern versions of Windows. +## Keyman 14 + Keyman Configuration no longer requires you to click the OK to save changes. All changes are applied instantly. @@ -15,13 +17,18 @@ Keyman keyboards are no longer hidden from the Windows language picker when you exit Keyman. Rather, if you select a Keyman keyboard, Keyman will be restarted for you automatically. +The 'Usage Page' option has been removed as it posed a potential +security risk. + +## Keyman 10-13 + The key change in your usage will be how you access keyboard layouts. With version 9.0 and later, all keyboard layouts are registered as Windows Text Services, and are always available through Windows language -interfaces as well as with the [Keyman menu](#basic_traymenu), [language -switcher](#basic_languageswitcher) and [hotkeys](#basic_hotkeys_tab). +interfaces as well as with the [Keyman menu](tray-menu), [language +switcher](language-switcher) and [hotkeys](config/hotkeys). -[Keyboard Task - Turn on a Keyboard](enable_keyboard) +[Keyboard Task - Turn on a Keyboard](select-keyboard) Most of the following changes were made in Keyman 10.0 @@ -29,7 +36,7 @@ When you install a keyboard layout, it will be registered under the language for which the keyboard has been designed, or if this has not been specified by the keyboard designer, then it will be installed under your default language. You can always change the language registration -in the [Keyboards tab](#basic_keyboards_tab). +in the [Keyboards tab](config/keyboards). In earlier versions of Keyman, language association was controlled in the Languages tab in Keyman Configuration. With the new model of @@ -46,23 +53,6 @@ European Latin-script keyboard. You can change the base layout in the Options tab, which will allow Keyman to automatically generate new versions of your keyboards that adapt to your base layout. -## Other Minor Changes - -- In the Support tab, we have reorganised the support and diagnostics - links. - - - -- The Addins tab has been eliminated as it is no longer required. - - - -- A number of obsolete options have been removed. - - - -- The proxy settings dialog is now accessed through the Options tab. - ## Related Topics - [What's New](../about/whatsnew) diff --git a/windows/src/desktop/help/basic/select-keyboard.md b/windows/src/desktop/help/basic/select-keyboard.md new file mode 100644 index 0000000000..f660235def --- /dev/null +++ b/windows/src/desktop/help/basic/select-keyboard.md @@ -0,0 +1,122 @@ +--- +title: Keyboard Task - Turn on a Keyboard +--- + +Here are five simple ways to turn on a Keyman keyboard. + +**Note:** +To use a Keyman keyboard, the keyboard must be enabled in the Keyboard +Layouts tab of Keyman Configuration. For help enabling your keyboard, +see [Keyboard Task - Enable or Disable a Keyboard](enable-or-disable-keyboard). + +## Turning on a Keyboard from the Keyman Menu + +To turn on a keyboard from the Keyman menu: + +1. Open an application to type in, like MS Word. + + **Note:** + You should open an application before you select a Keyman keyboard, + depending on your Windows settings. + +2. Start Keyman. + +3. Click on the Keyman icon ![](../desktop_images/icon-keyman.png), on the + Windows Taskbar near the clock. + + ![](../desktop_images/menu.png) + +4. Select your Keyman keyboard from the list. You will notice the + Keyman menu icon change to the icon of your Keyman keyboard. This + means your Keyman keyboard is on. + +## Turning on a Keyboard from the Keyman Toolbox + +To turn on a keyboard from the Keyman Toolbox: + +1. Open an application to type in, like MS Word. + +2. Start Keyman. + +3. Click on the Keyman icon ![](../desktop_images/icon-keyman.png), on the + Windows Taskbar near the clock. + + ![](../desktop_images/menu.png) + +4. Click to open the On Screen Keyboard view of the Keyman Toolbox. + + ![](../desktop_images/osk-tibetan.png) + +5. Click to select your Keyman keyboard from the toolbar of the Keyman + Toolbox. You will notice the Keyman menu icon change to the icon of + your Keyman keyboard. This means your Keyman keyboard is on. + +## Turning on a Keyboard from the Language Switcher + +Here's how to turn on a keyboard using the Language Switcher: + +1. Open an application to type in, like MS Word. + +2. Start Keyman. + +3. Press the Language Switcher hotkey to bring up the Language + Switcher. If you are using the default Language Switcher hotkey + (Left Alt + Shift) or another hotkey with + Alt, you will need to press and HOLD the Alt + part of the hotkey and press and RELEASE the + last key in the hotkey to use the Language Switcher. When you + release Alt, the Language Switcher will close. + + **Note:** + By default, the Language Switcher hotkey is Left Alt + + Shift. You can view or change the current Language Switcher + hotkey from the [Hotkeys tab](config/hotkeys) of Keyman Configuration. + + ![](../desktop_images/languageswitcher-small.png) + +4. Navigate the Language Switcher using the arrow keys or by pressing + Shift to select your Keyman keyboard. + +5. Release the Language Switcher hotkey or press Enter to + activate the selected keyboard and close the Language Switcher. You + will notice the Keyman menu icon change to the icon of your Keyman + keyboard. This means your Keyman keyboard is on. + +## Turning on a Keyboard with a Hotkey + +To turn on a keyboard from the Keyman menu: + +1. Open an application to type in, like MS Word. + +2. Start Keyman. + +3. Press and release the hotkey for your Keyman keyboard. + + **Note:** + You can find the current hotkey for your keyboard in the Keyman + menu. You can set or reset a hotkey for your keyboard from the + Hotkeys tab of Keyman Configuration. + + ![](../desktop_images/menu.png) + +4. You will notice the Keyman menu icon change to the icon of your + Keyman keyboard. This means your Keyman keyboard is on. + +## Turning on a Keyboard by switching Windows languages + +Because Keyman keyboards are always associated with a Windows language, +you can also switch Keyman keyboards using the Windows language switcher, +located near the clock in the Taskbar. The default hotkey for the Windows +language switcher is Win + spacebar. Hold the +Win key and press spacebar repeatedly until you +reach the desired keyboard, then release spacebar. + +## Related Topics + +- [The Keyman Menu](tray-menu) +- [The Keyman Toolbox](toolbox/index) +- [Language Switcher](language-switcher) +- [Keyman Configuration - Hotkeys Tab](config/hotkeys) +- [Keyman Configuration - Keyboard Layouts Tab](config/keyboards) +- [How To - Download and Install a Keyman Keyboard](../start/download-and-install-keyboard) +- [Keyboard Task - Enable or Disable a Keyboard](enable-or-disable-keyboard) \ No newline at end of file diff --git a/windows/src/desktop/help/basic/text_editor.md b/windows/src/desktop/help/basic/text-editor.md similarity index 81% rename from windows/src/desktop/help/basic/text_editor.md rename to windows/src/desktop/help/basic/text-editor.md index 99faf47b8c..2e7e5af2b6 100644 --- a/windows/src/desktop/help/basic/text_editor.md +++ b/windows/src/desktop/help/basic/text-editor.md @@ -5,7 +5,7 @@ title: The Keyman Text Editor The Keyman Text Editor is a basic text editor for testing your Keyman keyboards. -![](desktop_images/texteditor.png) +![](../desktop_images/texteditor.png) **Note**: You do not need to use the Keyman Text Editor to type with Keyman. You can use Keyman in almost any application on your computer that accepts keyboard input. @@ -13,7 +13,7 @@ keyboards. To open the Keyman Text Editor: -1. Click on the Keyman icon ![](desktop_images/icon-keyman.png), on the +1. Click on the Keyman icon ![](../desktop_images/icon-keyman.png), on the Windows Taskbar near the clock. 2. From the Keyman menu, select Text Editor…. @@ -30,7 +30,7 @@ To use the Keyman Text Editor: When you select a Unicode Keyman keyboard, the Text Editor brings up a font panel. This font panel behaves like the [Font Helper -tool](#basic_fonthelper) in the Keyman Toolbox. Each font listed in the +tool](toolbox/font-helper) in the Keyman Toolbox. Each font listed in the panel includes a percentage value. This value indicates how many characters in the current Keyman keyboard are available from the font. Most of the time, fonts with greater than 90% coverage will work for @@ -42,4 +42,4 @@ link for the font in the font panel. ## Related Topics - [Getting Started with Keyman](../start/tutorial) -- [Keyboard Task - Turn on a Keyboard](enable_keyboard) +- [Keyboard Task - Turn on a Keyboard](select-keyboard) diff --git a/windows/src/desktop/help/basic/toolbox/character-map.md b/windows/src/desktop/help/basic/toolbox/character-map.md new file mode 100644 index 0000000000..b4c7d84644 --- /dev/null +++ b/windows/src/desktop/help/basic/toolbox/character-map.md @@ -0,0 +1,238 @@ +--- +title: Keyman Toolbox - Character Map +--- + +The Character Map tool in the [Keyman Toolbox](../toolbox/) can be +used to find and insert any standard Unicode character into your text. + +![](../../desktop_images/charmap.png) + +## Opening the Character Map + +To open the Keyman Character Map: + +1. Click on the Keyman icon ![](../../desktop_images/icon-keyman.png), on the + Windows Taskbar near the clock. + +2. From the Keyman menu, select Character Map. + +## Using the Character Map + +To insert a character from the Character Map into a document: + +1. Position the text cursor in your document where you want to insert + the character. + +2. Locate the character in the Character Map. + +3. Insert the character by: + + - Selecting the character and pressing the Enter key. + + - Double-clicking on the character. + + - Right-clicking on the character and selecting Insert Character. + +**Note:** +If the Insert Mode is set to Code or Name, pressing Enter or +double-clicking on a character will insert the Unicode code or Unicode +name of the character, not the character itself! + +**Note:** +You can also hold Ctrl and then a single click on a character will +insert it into the document. This allows for smoother insertion of +multiple characters from the Character Map. + +## Character Map Options + +![](../../desktop_images/charmap-options.png) + +Right click on the Character Map to display a menu with the following +options: + +Insert Character +: Inserts the selected character at the cursor position in your document. + +Filter... +: Sends the curser to the \'Filter by\' Character Map search field. +: See [Filtering](#filtering) below. + +Goto... +: Displays the Goto dialog box. See [Goto](#goto) below. + +Font... +: Allows you to choose a different font for use in +: the Character Map. This will not affect the font +: being used in your document! See [Fonts and +: Characters](#fonts) below. + +Insert Mode +: Allows you to select your desired character insert +: mode. See [Insert Modes](#insertmodes) below. + +Display Quality +: Allows you to set the desired display quality for +: the characters in the Character Map. See +: [Display Quality](#displayquality) below. + +## Character Map Options - Filter... + +You can search the Character Map by using the Filter by search field at +the bottom of the Character Map window. + +![](../../desktop_images/charmap-filter.png) + +When no search filter is applied, the Character Map shows all characters +from the Unicode standard. If a filter has been applied, the name of the +filter will appear in the upper left corner of the Character Map window. + +![](../../desktop_images/charmap-big.png) + +The following parameters define how the search filter in the Character +Map works: + +- When searching by Unicode name, the filter field searches within of + the Unicode name. + +- When searching by Unicode code point or range, the filter field + allows 2, 3, and 4 digit partial code points. For example, all of + the following will give the Latin Capital Letter E (U+0045): + + - 45 + - 045 + - 0045 + - U+45 + - U+045 + - U+0045 + +- Filter entries can use the letters A-Z, the numerals 0-9 and the + characters underscore (\_), hyphen (-) and plus (+). + +- Filter entries are NOT case sensitive. + +- Spaces between words in a filter entry can be represented by either + underscore (\_) or space ( ). Spaces at the end of a filter entry + must be represented by underscore; otherwise they will be discarded + during the search. + +- Filters can be entered by Unicode character names or Unicode + character ranges. + +- The filtering format for a character range is given below, where U+ + is optional, XXXX is the starting Unicode value and YYYY is the + finishing Unicode value. + + [U+]XXXX-[U+]YYYY + +- The filtering options for character names are: + + - `>` placed at the start of an entry will only show characters + in the currently selected Character Map font. This is helpful + when trying to determine which characters a given font supports. + + - `<` placed at the start of an entry will search Unicode block + names instead of character names. This is helpful when searching + for characters within related blocks (e.g. all Latin blocks). + + - Words are searched in order, so for example `latin capital letter b` + will not find different results than `latin letter capital b`. + + - Using `?` anywhere in an entry serves as a wildcard for that + single place in the entry. For example, searching for `s???e` + will return both the SPACE and the SMILE characters, among + others. + + - `[ - ]` is used to match any character in a set. For + instance, `[ac-z]` matches all letters except "b". A set can + be made up of ranges and individual characters, but cannot be + made up of `?` or `*`. + + - `$` placed at the end of an entry will match from the end of + a Unicode character name. This option works best when used with + `*` or `?`. + + - As noted above, when no filtering options are in use, the filter + field searches for characters within their Unicode names. + +The following chart provides examples of filtering. + +| Filter Entry | Filter Result | +|-----------------------|-----------------------------------------------| +| `latin capital letter a` | Searches for all Unicode characters whose names contain the words starting with "latin", "capital", "letter", and "a". Thus, finds all variations of the Latin capital letter A, plus the Latin capital letter Alpha and the Latin capital letter African d. +| `latin letter a` | Searches for all Unicode characters whose names contain words starting with "latin", "letter", and "a". Thus, finds all variations of the Latin letter A capital and lower case, along with a small selection of other characters whose names fit the search. +| `_[aeu]_ acute` | Matches all letter "a", "e", or "u" with an acute mark. The `_` matches a space. +| `latin letter [aeiou]` | Searches for all Unicode characters whose names contains words starting with "latin", "letter", and "a", "e", "i", "o", or "u". Finds all variations of the Latin vowels A,E,I,O,U, both upper and lower case, along with a small selection of other characters whose names fit the search. +| `lao` | Searches the current Character Map font for all available characters whose names begin with the sequence "Lao". +| `YI_` | Searches for all characters whose Unicode names begin with the sequence "YI" followed by a space. Finds all YI syllables and YI radicals. Note: You must use underscore (`_`) and not space (` `) at the end of a filter entry. Spaces at the end of a filter entry are discarded. If you had used `YI ` (with space) instead of `YI_`, the search would also return the character YIN_YANG. +| `latin letter _a$` | Searches for all Unicode characters whose names contain word starting with "latin" and "letter", and end with the word "a". +| `1000-109F` | Searches for all Unicode characters in the range from U+1000 to U+109F (inclusive). Finds all characters - in this case, the Myanmar block. + + +To help you edit filters, the Filter dialog is available from the +Character Map by clicking the ![...](../../desktop_images/charmap-button.png) +button. + +![](../../desktop_images/charmap-filterdialog.png) + +## Character Map Options - Goto... + +The Goto tool can be used to move directly to a specific Unicode +character or value. + +1. Right click on a character and select Goto. The Enter Unicode + character value or namedialog box will be displayed: + + ![](../../desktop_images/charmap-goto.png) + +2. Enter a Unicode character value (e.g. `6B` or `U+006B`) OR enter + the start of the character name (e.g. `Lao letter`, which will go + to the first matching character, "LAO_LETTER_KO") + +3. Click OK. The Character Map will move to the chosen character, if + available. + +## Character Map Options - Font... + +You can choose the font for use in the Character Map tool by right +clicking on the Character Map window and selecting Font. + +![](../../desktop_images/charmap-font.png) + +From the Font dialog, you can select to display the Character Map using +any of the fonts available on your system. If a character is not +available in the selected font, the Character Map will use font linking +to attempt to find a character from other fonts installed on your system. +As a last resort, the Character Map will show square boxes or question +marks if no suitable font can be found for a character. + +## Character Map Options - Insert Mode + +Characters can be inserted from the Character Map using one of three +insert modes - Code, Character and Name: + +- Code - Inserts the character's Unicode code. +- Character - Inserts the character itself. +- Name - Inserts the character's Unicode name. + +To change the character insert mode: + +1. Right-click on the Character Map. +2. Highlight the Insert Mode submenu. + ![](../../desktop_images/charmap-insert.png) +3. Choose the desired insert mode from the submenu. + +## Character Map Options - Display Quality + +![](../../desktop_images/charmap-quality.png) + +There are three options for the display quality of characters in the +Character Map. + +- Plain - Uses no font smoothing. +- Antialiased - Uses the Windows standard font smoothing. +- ClearType - Uses the Windows ClearType font smoothing. + +## Related Topics + +- [The Keyman Toolbox](../toolbox/) diff --git a/windows/src/desktop/help/basic/toolbox_tasks/fonthelper.md b/windows/src/desktop/help/basic/toolbox/font-helper.md similarity index 71% rename from windows/src/desktop/help/basic/toolbox_tasks/fonthelper.md rename to windows/src/desktop/help/basic/toolbox/font-helper.md index b59979cb1f..4d19984771 100644 --- a/windows/src/desktop/help/basic/toolbox_tasks/fonthelper.md +++ b/windows/src/desktop/help/basic/toolbox/font-helper.md @@ -1,23 +1,23 @@ --- -title: Keyman Toolbox - Font Helper {#basic_fonthelper} +title: Keyman Toolbox - Font Helper --- -The Font Helper tool in the [Keyman Toolbox](#basic_toolbox) identifies +The Font Helper tool in the [Keyman Toolbox](../toolbox/) identifies fonts on your system that should work with the currently selected keyboard layout. -![](desktop_images/fonthelper.png) +![](../../desktop_images/fonthelper.png) -**Opening the Font Helper** +## Opening the Font Helper To open the Font Helper: -1. Click on the Keyman icon ![](desktop_images/icon-keyman.png), on the +1. Click on the Keyman icon ![](../../desktop_images/icon-keyman.png), on the Windows Taskbar near the clock. 2. From the Keyman menu, select Font Helper. -**Using the Font Helper** +## Using the Font Helper To use the Font Helper: @@ -36,14 +36,12 @@ The Character Chart will allow you to see exactly which characters your font supports. It will also allow you to see how the same characters look in different fonts. -::: {.tip} +**Tip:** If no fonts are listed in the Font Helper, check the documentation of the keyboard layout to see if it includes information on where to obtain the fonts you need. -::: -**Related Topics** +## Related Topics -- [???](#basic_toolbox) - -- [???](#basic_enable_keyboard) +- [The Keyman Toolbox](../toolbox/) +- [Keyboard Task - Turn on a Keyboard](../select-keyboard) diff --git a/windows/src/desktop/help/basic/toolbox/index.md b/windows/src/desktop/help/basic/toolbox/index.md new file mode 100644 index 0000000000..42f850763e --- /dev/null +++ b/windows/src/desktop/help/basic/toolbox/index.md @@ -0,0 +1,85 @@ +--- +title: The Keyman Toolbox +--- + +The Keyman Toolbox contains a collection of tools for working with +Keyman. + +![](../../desktop_images/osk_keyboard.png) + +## Opening the Keyman Toolbox + +To display the Keyman Toolbox: + +1. Click on the Keyman icon ![](../../desktop_images/icon-keyman.png), on the + Windows Taskbar near the clock. + +2. From the Keyman menu, select On Screen Keyboard. + +**Note:** +The Keyman Toolbox is displayed by default in the last position it was +used. It will be displayed initially in the bottom right hand corner of +the screen. + +**Note:** +The Keyman Toolbox opens automatically when you select a Keyman keyboard +layout. You can change this behaviour in the Options tab of Keyman Configuration. + +## Using the Keyman Toolbox + +Along the top of the Keyman Toolbox is a toolbar. + +![](../../desktop_images/toolbox-toolbar.png) + +Any of the following buttons may appear in the toolbar: + +| Icon | Button Name | Description | +|---|---------------------|--------------------------------------------| +| ![](../../desktop_images/toolboxicon-osk.png) | View On Screen Keyboard | Opens the [On Screen Keyboard](osk) for the currently selected Keyman keyboard or Windows layout. +| ![](../../desktop_images/toolboxicon-fonthelper.png) | View Font Helper | Opens the [Font Helper](font-helper) for the selected Keyman keyboard. +| ![](../../desktop_images/toolboxicon-charmap.png) | View Character Map | Opens the [Keyman Character Map](character-map). +| ![](../../desktop_images/toolboxicon-config.png) | Open Keyman Configuration | Opens [Keyman Configuration](../config/), where you can install or uninstall keyboard layouts and change various Keyman options and settings. +| ![](../../desktop_images/toolboxicon-help.png) | Open Help | Opens [Keyman Help](../help). +| ![](../../desktop_images/toolboxicon-close.png) | Close Keyman Toolbox | Closes the Keyman Toolbox but does not exit Keyman. The Keyman Toolbox can be displayed again by following the instructions at the top of this help topic. + +You can move the Keyman Toolbox around your screen by clicking and +dragging anywhere on the Keyman Toolbox toolbar not covered by a button. + +You can resize the Keyman Toolbox by clicking and dragging on a corner +of the Keyman Toolbox. + +**Note:** +When the On Screen Keyboard tool is selected, the Keyman Toolbox will +only resize according to the proportions of the keyboard. + +## Toolbox Options + +![](../../desktop_images/toolbox-options.png) + +Right click on the Keyman Toolbox to display a menu with the following +options: + +Fade When Inactive +: If this option is enabled, the Keyman Toolbox appears partially transparent + when the mouse is not over it. + +Show Toolbar +: This option hides or displays the toolbar at the top of the Keyman Toolbox. + +Save as Web Page... +: This option saves the keyboard view of the current + keyboard layout as a web page for easy reference. + The new web page will include diagrams for every state + of the current keyboard layout, including shift states. + +Print... +: This option prints the keyboard view of the current + keyboard layout for easy reference. The printout + will include diagrams for every state of the + current keyboard layout, including shift states. + +## Related Topics + +- [On Screen Keyboard](osk) +- [Font Helper](font-helper) +- [Character Map](character-map) diff --git a/windows/src/desktop/help/basic/toolbox_tasks/osk.md b/windows/src/desktop/help/basic/toolbox/osk.md similarity index 50% rename from windows/src/desktop/help/basic/toolbox_tasks/osk.md rename to windows/src/desktop/help/basic/toolbox/osk.md index b9d6a78e27..02de5aac6f 100644 --- a/windows/src/desktop/help/basic/toolbox_tasks/osk.md +++ b/windows/src/desktop/help/basic/toolbox/osk.md @@ -1,91 +1,73 @@ --- -title: Keyman Toolbox - On Screen Keyboard {#basic_osk} +title: Keyman Toolbox - On Screen Keyboard --- -The On Screen Keyboard tool of the [Keyman Toolbox](#basic_toolbox) +The On Screen Keyboard tool of the [Keyman Toolbox](../toolbox/) shows the currently selected Keyman keyboard or Windows layout. -![](desktop_images/osk-tibetan.png) +![](../../desktop_images/osk-tibetan.png) -::: {.note} +**Note:** Some Keyman keyboards do not contain an On Screen Keyboard view. You can -find more help for those keyboards from the +find more help for those keyboards from the Help icon on the Keyman Toolbox toolbar. -Keyboard Usage tool - -of the Keyman Toolbox. -::: - -**Opening the On Screen Keyboard** +## Opening the On Screen Keyboard To open the On Screen Keyboard: -1. Click on the Keyman icon ![](desktop_images/icon-keyman.png), on the +1. Click on the Keyman icon ![](../../desktop_images/icon-keyman.png), on the Windows Taskbar near the clock. 2. From the Keyman menu, select On Screen Keyboard. -**Using the On Screen Keyboard** +## Using the On Screen Keyboard You can use the On Screen Keyboard in two ways: - As a reference help, to teach you how to type all the letters in your Keyman keyboard. - - To enter text by point-and-click. To use the On Screen Keyboard as a reference help: 1. Open the On Screen Keyboard - 2. Type on your physical keyboard, using the On Screen Keyboard as a guide. - ::: {.note} + **Note:** The On Screen Keyboard will match the Shift state of your hardware - keyboard. This means you can press any combination of Shift, Ctrl, - Alt and AltGr (or RightAlt) and the On Screen Keyboard will change - to show you the Shift state of your hardware keyboard. - ::: + keyboard. This means you can press any combination of Shift, + Ctrl, Alt and AltGr (or + RightAlt) and the On Screen Keyboard will change + to show you the modifier state of your hardware keyboard. To enter text using the On Screen Keyboard: 1. Position your text cursor where you want to type in your application. -2. On the On Screen Keyboard, click Shift, Ctrl or Alt if you need them - to type your desired character. +2. On the On Screen Keyboard, click Shift, Ctrl or + Alt if you need them to type your desired character. 3. On the On Screen Keyboard, click the key with the character you want to enter. When a Keyman keyboard is on, the black font on the keycaps shows the -characters assigned to each key. The blue font on the keycaps shows the -characters of the Windows layout currently associated with the Keyman -keyboard. +characters assigned to each key. The smaller grey font on the keycaps +shows the characters of the Windows layout currently associated with the +Keyman keyboard. -When no Keyman keyboard is on, the blue font on the keycaps shows the +When no Keyman keyboard is on, the grey font on the keycaps shows the characters of your active Windows layout. -::: {.note} +**Note:** Some Keyman keyboards do not have an On Screen Keyboard view. For keyboards designed phonetically, this is because there is not a simple 1-1 correspondence between each key and the letter you want to type. The +keyboard help will usually provide more information on how to use these +keyboards. -Keyboard Usage tool +## Related Topics -is often helpful for these keyboards and Keyman will switch to this view -by default. This option can be changed in - -Keyman Configuration - -. -::: - -**Related Topics** - -- [???](#basic_toolbox) - -- [???](#basic_usage) - -- [???](#basic_options_tab) +- [The Keyman Toolbox](../toolbox/) +- [Keyman Configuration - Options tab](../config/options) diff --git a/windows/src/desktop/help/basic/toolbox_tasks/charactermap.md b/windows/src/desktop/help/basic/toolbox_tasks/charactermap.md deleted file mode 100644 index 176b0e4f7f..0000000000 --- a/windows/src/desktop/help/basic/toolbox_tasks/charactermap.md +++ /dev/null @@ -1,317 +0,0 @@ ---- -title: Keyman Toolbox - Character Map {#basic_charactermap} ---- - -The Character Map tool in the [Keyman Toolbox](#basic_toolbox) can be -used to find and insert any standard Unicode character into your text. - -![](desktop_images/charmap.png) - -**Opening the Character Map** - -To open the Keyman Character Map: - -1. Click on the Keyman icon ![](desktop_images/icon-keyman.png), on the - Windows Taskbar near the clock. - -2. From the Keyman menu, select Character Map. - -**Using the Character Map** - -To insert a character from the Character Map into a document: - -1. Position the text cursor in your document where you want to insert - the character. - -2. Locate the character in the Character Map. - -3. Insert the character by: - - - Selecting the character and pressing the Enter key. - - - Double-clicking on the character. - - - Right-clicking on the character and selecting Insert Character. - -::: {.note} -If the Insert Mode is set to Code or Name, pressing Enter or -double-clicking on a character will insert the Unicode code or Unicode -name of the character, not the character itself! -::: - -::: {.note} -You can also hold Ctrl and then a single click on a character will -insert it into the document. This allows for smoother insertion of -multiple characters from the Character Map. -::: - -**Character Map Options** - -![](desktop_images/charmap-options.png) - -Right click on the Character Map to display a menu with the following -options: - -+-----------------+-----------------------------------------------------+ -| Insert | Inserts the selected character at the cursor | -| Character | position in your document. | -+-----------------+-----------------------------------------------------+ -| Filter... | Sends the curser to the \'Filter by\' Character Map | -| | search field. See [Filtering](#filtering) below. | -+-----------------+-----------------------------------------------------+ -| Goto... | Displays the Goto dialog box. See [Goto](#goto) | -| | below. | -+-----------------+-----------------------------------------------------+ -| Font... | Allows you to choose a different font for use in | -| | the Character Map. This will not affect the font | -| | being used in your document! See [Fonts and | -| | Characters](#fonts) below. | -+-----------------+-----------------------------------------------------+ -| Insert Mode | Allows you to select your desired character insert | -| | mode. See [Insert Modes](#insertmodes) below. | -+-----------------+-----------------------------------------------------+ -| Display Quality | Allows you to set the desired display quality for | -| | the characters in the Character Map. See [Display | -| | Quality](#displayquality) below. | -+-----------------+-----------------------------------------------------+ - -**[]{#filtering}Character Map Options - Filter...** - -You can search the Character Map by using the Filter by search field at -the bottom of the Character Map window. - -![](desktop_images/charmap-filter.png) - -When no search filter is applied, the Character Map shows all characters -from the Unicode standard. If a filter has been applied, the name of the -filter will appear in the upper left corner of the Character Map window. - -![](desktop_images/charmap-big.png) - -The following parameters define how the search filter in the Character -Map works: - -- When searching by Unicode name, the filter field searches within of - the Unicode name. - -- When searching by Unicode code point or range, the filter field - allows 2, 3, and 4 digit partial code points. For example, all of - the following will give the Latin Capital Letter E (U+0045): - - - 45 - - 045 - - 0045 - - U+45 - - U+045 - - U+0045 - -- Filter entries can use the letters A-Z, the numerals 0-9 and the - characters underscore (\_), hyphen (-) and plus (+). - -- Filter entries are NOT case sensitive. - -- Spaces between words in a filter entry can be represented by either - underscore (\_) or space ( ). Spaces at the end of a filter entry - must be represented by underscore; otherwise they will be discarded - during the search. - -- Filters can be entered by Unicode character names or Unicode - character ranges. - -- The filtering format for a character range is given below, where U+ - is optional, XXXX is the starting Unicode value and YYYY is the - finishing Unicode value. - - [U+]XXXX-[U+]YYYY - -- The filtering options for character names are: - - - \"\>\" placed at the start of an entry will only show characters - in the currently selected Character Map font. This is helpful - when trying to determine which characters a given font supports. - - - \"\<\" placed at the start of an entry will search Unicode block - names instead of character names. This is helpful when searching - for characters within related blocks (e.g. all Latin blocks). - - - Using \"\*\" in an entry serves as a wildcard for any number of - places in that entry. For example, searching for - \"greek\*alpha\" will find characters whose Unicode names begin - with the word \"Greek\" and contain the word \"Alpha\" any - number of places later. This is helpful when searching for - characters that share a common element in their names (e.g. - capital). - - - Using \"?\" anywhere in an entry serves as a wildcard for that - single place in the entry. For example, searching for \"s???e\" - will return both the SPACE and the SMILE characters, among - others. - - - \"\[ - \]\" is used to match any character in a set. For - instance, \[ac-z\] matches all letters except \"b\". A set can - be made up of ranges and individual characters, but cannot be - made up of \"?\" or \"\*\". - - - \"\$\" placed at the end of an entry will match from the end of - a Unicode character name. This option works best when used with - \"\*\" or \"?\". - - - As noted above, when no filtering options are in use, the filter - field searches for characters within their Unicode names. - -The following chart provides examples of filtering. - -+-----------------------+-----------------------------------------------+ -| Filter Entry | Filter Result | -+-----------------------+-----------------------------------------------+ -| \"latin capital | Searches for all Unicode characters whose | -| letter a\" | names begin with the sequence \"latin capital | -| | letter a\". | -| | | -| | Finds all variations of the Latin capital | -| | letter A, plus the Latin capital letter Alpha | -| | and the Latin capital letter African d. | -+-----------------------+-----------------------------------------------+ -| \"latin \* letter a\" | Searches for all Unicode characters whose | -| | names begin with the word \"Latin\" and | -| | elsewhere contain the sequence \"letter a\". | -| | | -| | Finds all variations of the Latin letter A, | -| | capital and lower case, along with a small | -| | selection of other characters whose names fit | -| | the search. | -+-----------------------+-----------------------------------------------+ -| \"\_\[aeu\]\_ acute\" | Matches all letter \"a\", \"e\", or \"u\" | -| | with an acute mark. The \"\_\" matches a | -| | space. | -+-----------------------+-----------------------------------------------+ -| \"latin \* letter | Searches for all Unicode characters whose | -| \[aeiou\]\" | names begin with the word \"Latin\" and | -| | elsewhere contain the sequence \"letter a\", | -| | \"letter e\", \"letter i\", \"letter o\", or | -| | \"letter u\". | -| | | -| | Finds all variations of the Latin vowels | -| | A,E,I,O,U, both upper and lower case, along | -| | with a small selection of other characters | -| | whose names fit the search. | -+-----------------------+-----------------------------------------------+ -| \"\lao\" | Searches the current Character Map font for | -| | all available characters whose names begin | -| | with the sequence \"Lao\". | -| | | -| | Finds all characters of Lao available in the | -| | current font. | -+-----------------------+-----------------------------------------------+ -| \"YI\_\" | Searches for all characters whose Unicode | -| | names begin with the sequence \"YI\" followed | -| | by a space. | -| | | -| | Finds all YI syllables and YI radicals. Note: | -| | You must use underscore (\_) and not space ( | -| | ) at the end of a filter entry. Spaces at the | -| | end of a filter entry are discarded. If you | -| | had used \"YI \" instead of \"YI\_\", the | -| | search would also return the character | -| | YIN_YANG. | -+-----------------------+-----------------------------------------------+ -| \"latin \* letter | Searches for all Unicode characters whose | -| a\$\" | names begin with the word \"Latin\" and end | -| | with the sequence \"latin a\". | -| | | -| | Finds only \"a\", \"A\" and Latin subscript | -| | small letter a. | -+-----------------------+-----------------------------------------------+ -| \"1000-109F\" | Searches for all Unicode characters in the | -| | range from U+1000 to U+109F (inclusive). | -| | | -| | Finds all characters - in this case, the | -| | Myanmar block. | -+-----------------------+-----------------------------------------------+ - -To help you edit filters, the Filter dialog is available from the -Character Map by clicking the ![](desktop_images/charmap-button.png) -button. - -![](desktop_images/charmap-filterdialog.png) - -**[]{#goto}Character Map Options - Goto...** - -The Goto tool can be used to move directly to a specific Unicode -character or value. - -1. Right click on a character and select Goto. The Enter Unicode - character value or namedialog box will be displayed: - - ![](desktop_images/charmap-goto.png) - -2. Enter a Unicode character value (e.g. \"6B\" or \"U+006B\") OR enter - the start of the character name (e.g. \"Lao letter\", which will go - to the first matching character, \"LAO_LETTER_KO\") - -3. Click OK. The Character Map will move to the chosen character, if - available. - -**[]{#fonts}Character Map Options - Font...** - -You can choose the font for use in the Character Map tool by right -clicking on the Character Map window and selecting Font. - -![](desktop_images/charmap-font.png) - -From the Font dialog, you can select to display the Character Map using -any of the fonts available on your system. If a character is not -available in the selected font, the Character Map will fall back to -Code2000, Code2001, Code2002, Arial Unicode MS and Lucida Sans Unicode -fonts. If the character is not found in these fallback fonts, the -Character Map will use font linking to attempt to find a character from -other fonts installed on your system. As a last resort, the Character -Map will show square boxes or questions marks if no suitable font can be -found for a character. - -**[]{#insertmodes}Character Map Options - Insert Mode** - -Characters can be inserted from the Character Map using one of three -insert modes - Code, Character and Name: - -- Code - Inserts the character\'s Unicode code. - -- Character - Inserts the character itself. - -- Name - Inserts the character\'s Unicode name. - -To change the character insert mode: - -1. Right-click on the Character Map. - -2. Highlight the Insert Mode submenu. - - ![](desktop_images/charmap-insert.png) - -3. Choose the desired insert mode from the submenu. - -**[]{#displayquality}Character Map Options - Display Quality** - -![](desktop_images/charmap-quality.png) - -There are three options for the display quality of characters in the -Character Map. - -- Plain - Uses no font smoothing. - -- Antialiased - Uses the Windows standard font smoothing. - -- ClearType - Uses the Windows ClearType font smoothing. - -**Related Topics** - -- [???](#basic_toolbox) diff --git a/windows/src/desktop/help/basic/toolbox_tasks/toolbox.md b/windows/src/desktop/help/basic/toolbox_tasks/toolbox.md deleted file mode 100644 index 4ae3f75fe2..0000000000 --- a/windows/src/desktop/help/basic/toolbox_tasks/toolbox.md +++ /dev/null @@ -1,411 +0,0 @@ ---- -title: The Keyman Toolbox {#basic_toolbox} ---- - -The Keyman Toolbox contains a collection of tools for working with -Keyman. - -![](desktop_images/osk_keyboard.png) - -**Opening the Keyman Toolbox** - -To display the Keyman Toolbox: - -1. Click on the Keyman icon ![](desktop_images/icon-keyman.png), on the - Windows Taskbar near the clock. - -2. From the Keyman menu, select On Screen Keyboard. - -::: {.note} -The Keyman Toolbox is displayed by default in the last position it was -used. It will be displayed initially in the bottom right hand corner of -the screen. -::: - -::: {.note} -The Keyman Toolbox opens automatically when you select a Keyman keyboard -layout. You can change this behaviour in the - -Options tab - -of Keyman Configuration. -::: - -**Using the Keyman Toolbox** - -Along the top of the Keyman Toolbox is a toolbar. - -![](desktop_images/toolbox-toolbar.png) - -Any of the following buttons may appear in the toolbar: - -+---+---------------------+--------------------------------------------+ -| I | Button Name | Description | -| c | | | -| o | | | -| n | | | -+---+---------------------+--------------------------------------------+ -| ! | View On Screen | Opens the [On Screen Keyboard](#basic_osk) | -| [ | Keyboard | for the currently selected Keyman keyboard | -| ] | | or Windows layout. | -| ( | | | -| d | | | -| e | | | -| s | | | -| k | | | -| t | | | -| o | | | -| p | | | -| _ | | | -| i | | | -| m | | | -| a | | | -| g | | | -| e | | | -| s | | | -| / | | | -| t | | | -| o | | | -| o | | | -| l | | | -| b | | | -| o | | | -| x | | | -| i | | | -| c | | | -| o | | | -| n | | | -| - | | | -| o | | | -| s | | | -| k | | | -| . | | | -| p | | | -| n | | | -| g | | | -| ) | | | -+---+---------------------+--------------------------------------------+ -| ! | View Keyboard Usage | Opens the [Keyboard Usage](#basic_usage) | -| [ | | for the selected Keyman keyboard. | -| ] | | | -| ( | | | -| d | | | -| e | | | -| s | | | -| k | | | -| t | | | -| o | | | -| p | | | -| _ | | | -| i | | | -| m | | | -| a | | | -| g | | | -| e | | | -| s | | | -| / | | | -| t | | | -| o | | | -| o | | | -| l | | | -| b | | | -| o | | | -| x | | | -| i | | | -| c | | | -| o | | | -| n | | | -| - | | | -| u | | | -| s | | | -| a | | | -| g | | | -| e | | | -| . | | | -| p | | | -| n | | | -| g | | | -| ) | | | -+---+---------------------+--------------------------------------------+ -| ! | View Font Helper | Opens the [Font Helper](#basic_fonthelper) | -| [ | | for the selected Keyman keyboard. | -| ] | | | -| ( | | | -| d | | | -| e | | | -| s | | | -| k | | | -| t | | | -| o | | | -| p | | | -| _ | | | -| i | | | -| m | | | -| a | | | -| g | | | -| e | | | -| s | | | -| / | | | -| t | | | -| o | | | -| o | | | -| l | | | -| b | | | -| o | | | -| x | | | -| i | | | -| c | | | -| o | | | -| n | | | -| - | | | -| f | | | -| o | | | -| n | | | -| t | | | -| h | | | -| e | | | -| l | | | -| p | | | -| e | | | -| r | | | -| . | | | -| p | | | -| n | | | -| g | | | -| ) | | | -+---+---------------------+--------------------------------------------+ -| ! | View Character Map | Opens the [Keyman Character | -| [ | | Map](#basic_charactermap). | -| ] | | | -| ( | | | -| d | | | -| e | | | -| s | | | -| k | | | -| t | | | -| o | | | -| p | | | -| _ | | | -| i | | | -| m | | | -| a | | | -| g | | | -| e | | | -| s | | | -| / | | | -| t | | | -| o | | | -| o | | | -| l | | | -| b | | | -| o | | | -| x | | | -| i | | | -| c | | | -| o | | | -| n | | | -| - | | | -| c | | | -| h | | | -| a | | | -| r | | | -| m | | | -| a | | | -| p | | | -| . | | | -| p | | | -| n | | | -| g | | | -| ) | | | -+---+---------------------+--------------------------------------------+ -| ! | Open Keyman | Opens [Keyman | -| [ | Configuration | Configuration](#basic_config_menu), where | -| ] | | you can install or uninstall keyboard | -| ( | | layouts and change various Keyman options | -| d | | and settings. | -| e | | | -| s | | | -| k | | | -| t | | | -| o | | | -| p | | | -| _ | | | -| i | | | -| m | | | -| a | | | -| g | | | -| e | | | -| s | | | -| / | | | -| t | | | -| o | | | -| o | | | -| l | | | -| b | | | -| o | | | -| x | | | -| i | | | -| c | | | -| o | | | -| n | | | -| - | | | -| c | | | -| o | | | -| n | | | -| f | | | -| i | | | -| g | | | -| . | | | -| p | | | -| n | | | -| g | | | -| ) | | | -+---+---------------------+--------------------------------------------+ -| ! | Open Help | Opens [Keyman Help](#basic_help). | -| [ | | | -| ] | | | -| ( | | | -| d | | | -| e | | | -| s | | | -| k | | | -| t | | | -| o | | | -| p | | | -| _ | | | -| i | | | -| m | | | -| a | | | -| g | | | -| e | | | -| s | | | -| / | | | -| t | | | -| o | | | -| o | | | -| l | | | -| b | | | -| o | | | -| x | | | -| i | | | -| c | | | -| o | | | -| n | | | -| - | | | -| h | | | -| e | | | -| l | | | -| p | | | -| . | | | -| p | | | -| n | | | -| g | | | -| ) | | | -+---+---------------------+--------------------------------------------+ -| ! | Close Keyman | Closes the Keyman Toolbox but does not | -| [ | Toolbox | exit Keyman. The Keyman Toolbox can be | -| ] | | displayed again by following the | -| ( | | instructions at the top of this help | -| d | | topic. | -| e | | | -| s | | | -| k | | | -| t | | | -| o | | | -| p | | | -| _ | | | -| i | | | -| m | | | -| a | | | -| g | | | -| e | | | -| s | | | -| / | | | -| t | | | -| o | | | -| o | | | -| l | | | -| b | | | -| o | | | -| x | | | -| i | | | -| c | | | -| o | | | -| n | | | -| - | | | -| c | | | -| l | | | -| o | | | -| s | | | -| e | | | -| . | | | -| p | | | -| n | | | -| g | | | -| ) | | | -+---+---------------------+--------------------------------------------+ - -You can move the Keyman Toolbox around your screen by clicking and -dragging anywhere on the Keyman Toolbox toolbar not covered by a button. - -You can resize the Keyman Toolbox by clicking and dragging on a corner -of the Keyman Toolbox. - -::: {.note} -When the On Screen Keyboard tool is selected, the Keyman Toolbox will -only resize according to the proportions of the keyboard. -::: - -**Toolbox Options** - -![](desktop_images/toolbox-options.png) - -Right click on the Keyman Toolbox to display a menu with the following -options: - -+-----------------+-----------------------------------------------------+ -| Fade When | If this option is enabled, the Keyman Toolbox | -| Inactive | appears partially transparent when the mouse is not | -| | over it. | -+-----------------+-----------------------------------------------------+ -| Show Toolbar | This option hides or displays the toolbar at the | -| | top of the Keyman Toolbox. | -+-----------------+-----------------------------------------------------+ -| Save as Web | This option saves the keyboard view of the current | -| Page\... | keyboard layout as a web page for easy reference. | -| | The new web page will include diagrams for every | -| | state of the current keyboard layout, including | -| | shift states. | -+-----------------+-----------------------------------------------------+ -| Print\... | This option prints the keyboard view of the current | -| | keyboard layout for easy reference. The printout | -| | will include diagrams for every state of the | -| | current keyboard layout, including shift states. | -+-----------------+-----------------------------------------------------+ - -**Toolbox Hints** - -![](desktop_images/toolbox-hints.png) - -At the bottom of the Keyman Toolbox, a hint bar shows handy tips on how -to use Keyman and access some of the more advanced features available. -The hint bar will slowly cycle through the available hints, or you can -use the arrow buttons on the right of the hint bar to cycle through the -hints yourself. - -You can close the hint bar by clicking the X icon on the right hand side -of the hint bar. This X icon is not the same as the Close Keyman Toolbox -button at the top of the window! - -To access the hint bar again, open the [Options tab](#basic_options_tab) -of Keyman Configuration and click Reset Hints. - -**Related Topics** - -- [???](#basic_osk) - -- [???](#basic_usage) - -- [???](#basic_fonthelper) - -- [???](#basic_charactermap) diff --git a/windows/src/desktop/help/basic/toolbox_tasks/usage.md b/windows/src/desktop/help/basic/toolbox_tasks/usage.md deleted file mode 100644 index 0b8301b0a2..0000000000 --- a/windows/src/desktop/help/basic/toolbox_tasks/usage.md +++ /dev/null @@ -1,62 +0,0 @@ ---- -title: Keyman Toolbox - Keyboard Usage {#basic_usage} ---- - -The Keyboard Usage tool of the [Keyman Toolbox](#basic_toolbox) shows -helpful hints on how to use the currently selected Keyman keyboard. - -Keyman allows you to select either Keyboard Usage or the On-Screen -Keyboard - -![](desktop_images/usage.png) - -**Opening Keyboard Usage** - -To open the Keyboard Usage tool: - -1. Click on the Keyman icon ![](desktop_images/icon-keyman.png), on the - Windows Taskbar near the clock. - -2. From the Keyman menu, select Keyboard Usage. - -**Using Keyboard Usage** - -The content of the Keyboard Usage tool changes depending on the active -Keyman keyboard: - -- Some keyboards include dynamic help in Keyboard Usage. This help - allows you to click on a letter to insert it into your document - directly. - - ![](desktop_images/usage-dynamic.png) - -- Some keyboards include static help in Keyboard Usage. This help will - give you important information about the keyboard. - - ![](desktop_images/usage-static.png) - -- Some keyboards include links to help documentation in Keyboard - Usage. Click Keyboard Help to find the help document for the - keyboard. - - ![](desktop_images/usage-help.png) - -- Some keyboards include links to the On Screen Keyboard tool in - Keyboard Usage. This means that the keyboard has an On Screen - Keyboard view. - - ![](desktop_images/usage-osk.png) - -- Some keyboards do not include Keyboard Usage. You may find help for - these keyboards by looking in the Windows Start menu, under the name - of the keyboard. - - ![](desktop_images/usage-none.png) - -**Related Topics** - -- [???](#basic_toolbox) - -- [???](#basic_osk) - -- [???](#basic_enable_keyboard) diff --git a/windows/src/desktop/help/basic/tray-menu.md b/windows/src/desktop/help/basic/tray-menu.md new file mode 100644 index 0000000000..e3cf87f597 --- /dev/null +++ b/windows/src/desktop/help/basic/tray-menu.md @@ -0,0 +1,79 @@ +--- +title: The Keyman Menu +--- + +## Opening the Keyman Menu + +When you start Keyman, the Keyman icon +(![](../desktop_images/icon-keyman.png)) is displayed on the Windows +Taskbar near the clock. This area is called the System Tray or System +Notification Area. + +![](../desktop_images/start_tray.png) + +To display the Keyman menu, click on the Keyman icon. + +![](../desktop_images/menu.png) + +**Note**: If you cannot find the Keyman menu or Keyman icon, for more help see: + +[Finding a Missing Keyman Menu](make-taskbar-icon-visible) + +## Using the Keyman Menu + +Click the Keyman icon (![](../desktop_images/icon-keyman.png)) with either +mouse button to bring up the Keyman menu. + +![](../desktop_images/menu.png) + +The left side of the Keyman menu lists the Keyman keyboards currently +installed and enabled on your computer. Click on a keyboard to turn it +on and start using it. + +**Note**: You can add more Keyman keyboards to the Keyman menu through the Keyboard +Layouts tab of Keyman Configuration. + +**Note**: To use a Keyman keyboard, the keyboard must be enabled in the Keyboard Layouts +tab of Keyman Configuration. For help enabling your keyboard, see +[Keyboard Task - Enable or Disable a Keyboard](enable-or-disable-keyboard). + +The right side of the Keyman menu contains links to tools and features +in Keyman: + +![](../desktop_images/menuicon-osk.png) +: Opens or closes the On Screen Keyboard tool + +![](../desktop_images/menuicon-fonthelper.png) +: Opens or closes the Font Helper tool + +![](../desktop_images/menuicon-charmap.png) +: Opens or closes the Character Map tool + +![](../desktop_images/menuicon-texteditor.png) +: Opens the Keyman Text Editor + +![](../desktop_images/menuicon-config.png) +: Opens Keyman Configuration + +![](../desktop_images/menuicon-help.png) +: Opens Keyman Help + +![](../desktop_images/menuicon-exit.png) +: Exits Keyman + +## Finding a Missing Keyman Menu + +If you cannot find the Keyman icon for the Keyman menu, it may be in the +hidden notifications area of the Windows Taskbar. Check for the Keyman +icon by clicking the arrow or triangle next to the Windows clock. + +If the Keyman icon is in this collection, you can optionally +[move it permanently to the Windows Taskbar](make-taskbar-icon-visible), +to make it more easily accessible. However, Keyman will run +correctly even if the icon is left in this collection. + +## Related Topics + +- [The Keyman Toolbox](toolbox/) +- [Keyboard Task - Turn on a Keyboard](select-keyboard) +- [How To - Make the Keyman icon visible](make-taskbar-icon-visible) \ No newline at end of file diff --git a/windows/src/desktop/help/basic/traymenu.md b/windows/src/desktop/help/basic/traymenu.md deleted file mode 100644 index 03c38419cd..0000000000 --- a/windows/src/desktop/help/basic/traymenu.md +++ /dev/null @@ -1,122 +0,0 @@ ---- -title: The Keyman Menu ---- - -## Opening the Keyman Menu - -When you start Keyman, the Keyman icon -(![](desktop_images/icon-keyman.png)) is displayed on the Windows -Taskbar near the clock. This area is called the System Tray or System -Notification Area. - -![](desktop_images/start_tray.png) - -To display the Keyman menu, click on the Keyman icon. - -![](desktop_images/menu.png) - -**Note**: If you cannot find the Keyman menu or Keyman icon, for more help see: - -[Finding a Missing Keyman Menu](***) - -## Using the Keyman Menu - -Click the Keyman icon (![](desktop_images/icon-keyman.png)) with either -mouse button to bring up the Keyman menu. - -![](desktop_images/menu.png) - -The left side of the Keyman menu lists the Keyman keyboards currently -installed and enabled on your computer. Click on a keyboard to turn it -on and start using it. - -**Note**: You can add more Keyman keyboards to the Keyman menu through the Keyboard Layouts tab of Keyman Configuration. - -**Note**: To use a Keyman keyboard, the keyboard must be enabled in the Keyboard Layouts tab of Keyman Configuration. For help enabling your keyboard, see: - -TODO: missing links - -The right side of the Keyman menu contains links to tools and features -in Keyman: - -TODO: missing icons and descriptions - -- – Opens or closes the - On Screen Keyboard tool - . -- – Opens or closes the - Keyboard Usage tool - . -- – Opens or closes the - Font Helper tool - . -- – Opens or closes the - Character Map tool - . -- – Opens the - Keyman Text Editor - . -- – Opens - Keyman Configuration - . -- – Opens - Keyman Help - . -- – Exits Keyman. - -## Finding a Missing Keyman Menu - -If you cannot find the Keyman icon for the Keyman menu, it may be in the -hidden notifications area of the Windows Taskbar. Check for the Keyman -icon by clicking the arrow or triangle next to the Windows clock. - -If the Keyman icon is in the hidden notifications area, you should move -the Keyman icon permanently to the Windows Taskbar. Here's how to move -the icon: - -- On Windows 7: - - 1. Open the Windows Start menu. - - 2. In the search field, type and enter: Notification Area Icons - - 3. From the dropdown menu beside SIL International Keyman Engine - x86, select 'Show icon and notifications'. - - ![](desktop_images/7-taskbar.png) - - 4. Click OK to apply changes. The Keyman icon will now always - appear in the Windows Taskbar near the clock, if Keyman is on. - -- On Windows 8 and above: - - 1. Right-click on the Windows Taskbar. - - ![](desktop_images/win8-taskbar1.png) - - 2. Select 'Properties'. - - 3. Next to 'Notification area', click Customize…. - - ![](desktop_images/win8-taskbar2.png) - - 4. From the dropdown menu beside Keyman Engine - x86, select 'Show icon and notifications'. - - ![](desktop_images/win8-taskbar3.png) - - 5. Click OK to apply changes. The Keyman icon will now always - appear in the Windows Taskbar near the clock, if Keyman is on. - - 6. Continue on to [Step 5](#tutorial_step5) of this guide. - -If the Keyman icon is not in the hidden notifications area and not on -the Windows Taskbar near the clock, make sure Keyman has been started. -If you still cannot locate the Keyman icon and menu, visit the [SIL -Keyman Community](https://community.software.sil.org/c/keyman) for -further assistance. - -## Related Topics - -- [The Keyman Toolbox](toolbox) -- [Keyboard Task - Turn on a Keyboard](enable_keyboard) diff --git a/windows/src/desktop/help/basic/uninstall-keyboard.md b/windows/src/desktop/help/basic/uninstall-keyboard.md new file mode 100644 index 0000000000..f98c6daaac --- /dev/null +++ b/windows/src/desktop/help/basic/uninstall-keyboard.md @@ -0,0 +1,40 @@ +--- +title: Keyboard Task - Uninstall a Keyboard +--- + +Uninstalling a Keyman keyboard removes it from Keyman. If you want to +use the Keyman keyboard again it must be reinstalled. + +**Note:** You can disable a keyboard temporarily, instead of uninstalling it. For +more help, see: [Keyboard Task - Enable or Disable a Keyboard](enable-or-disable-keyboard). + +To uninstall a Keyman keyboard: + +1. Open Keyman. + +2. Click on the Keyman icon ![](../desktop_images/icon-keyman.png), on the + Windows Taskbar near the clock. + + ![](../desktop_images/menu.png) + +3. Select Configuration. + +4. Select the Keyboard Layouts tab. + + ![](../desktop_images/tab-layout.png) + +5. Click on the uninstall icon ![](../desktop_images/icon-uninstall.png) + for the keyboard you want to uninstall. + +6. A message box is displayed asking you to confirm this is the package + or keyboard layout that you wish to uninstall. Click OK. + +7. Click OK. + +The Keyman keyboard is now removed from Keyman. + +## Related Topics + +- [Keyboard Task - Enable or Disable a Keyboard](enable-or-disable-keyboard) +- [Keyboard Task - Turn on a Keyboard](select-keyboard) +- [How To - Download and Install a Keyman Keyboard](../start/download-and-install-keyboard) diff --git a/windows/src/desktop/help/basic/uninstall.md b/windows/src/desktop/help/basic/uninstall.md new file mode 100644 index 0000000000..d9952a4279 --- /dev/null +++ b/windows/src/desktop/help/basic/uninstall.md @@ -0,0 +1,32 @@ +--- +title: Software Task - Uninstall Keyman +--- + +## Uninstall Keyman from Windows 10 + +1. Exit Keyman. + +2. Open Windows Start Menu and type "Add or Remove Programs", and open that app. + +3. In the App & features search box, type "Keyman". + +4. Click Keyman in the list. + +5. Click Uninstall. + +6. Follow the prompts to complete the uninstall. + +## Uninstall Keyman from Windows 7 or 8 + +1. Exit Keyman. + +2. Open Windows Control Panel. + +3. Select \'Add or Remove Programs\' or \'Programs and Features\' or + \'Uninstall a program\'. + +4. Click Keyman in the list. + +5. Click Remove or Uninstall or right-click \'Uninstall\'. + +6. Follow the prompts to complete the uninstall. diff --git a/windows/src/desktop/help/basic/engine_tasks/update.md b/windows/src/desktop/help/basic/update.md similarity index 56% rename from windows/src/desktop/help/basic/engine_tasks/update.md rename to windows/src/desktop/help/basic/update.md index 7679486b1c..37e4e3237f 100644 --- a/windows/src/desktop/help/basic/engine_tasks/update.md +++ b/windows/src/desktop/help/basic/update.md @@ -1,8 +1,8 @@ --- -title: Software Task - Update Keyman {#basic_update} +title: Software Task - Update Keyman --- -**Check for Updates Automatically** +## Check for Updates Automatically Keyman can check for updates automatically once a week. Here\'s how: @@ -11,28 +11,28 @@ Keyman can check for updates automatically once a week. Here\'s how: 2. Open Keyman Configuration, from the Keyman menu (on the Windows Taskbar near the clock). - ![](desktop_images/menu.png) + ![](../desktop_images/menu.png) 3. Select the Options tab. - ![](desktop_images/tab-options.png) + ![](../desktop_images/tab-options.png) 4. Tick \'Automatically check keyman.com weekly for updates.\' 5. Click OK to apply changes. -**Check for Updates Manually** +## Check for Updates Manually You can check for updates at any time by clicking \'Check for Updates...\' from the Support tab of Keyman Configuration. -![](desktop_images/tab-support.png) +![](../desktop_images/tab-support.png) -**Updating Manually** +## Updating Manually You can manually update Keyman at any time by downloading and installing -it again from the [Keyman Website](https://keyman.com/). +Keyman for Windows again from the [Keyman Website](https://keyman.com/windows/download). -**Related Topics** +## Related Topics -- [???](#advanced_proxy_config) +- [Proxy Configuration](../advanced/proxy_config) diff --git a/windows/src/desktop/help/common/osk.md b/windows/src/desktop/help/common/osk.md index 2173d38ec5..fe100a81b7 100644 --- a/windows/src/desktop/help/common/osk.md +++ b/windows/src/desktop/help/common/osk.md @@ -5,7 +5,7 @@ title: Does Keyman include a virtual on-screen keyboard? Yes. However, some of the Keyman keyboards available on our website do not currently include an On Screen Keyboard. To know if a keyboard download includes an On Screen Keyboard, look for the -![](desktop_images/icon-osk.png) icon in the Keyman keyboard downloads +![](../desktop_images/icon-osk.png) icon in the Keyman keyboard downloads list. To check if an installed keyboard includes an On Screen Keyboard, start diff --git a/windows/src/desktop/help/context/index.md b/windows/src/desktop/help/context/index.md index 0b929f0619..7ca83be11c 100644 --- a/windows/src/desktop/help/context/index.md +++ b/windows/src/desktop/help/context/index.md @@ -26,7 +26,7 @@ title: Contextual Help * [osk_keyboard](osk_keyboard) * [osk_usage](osk_usage) * [fonthelper](fonthelper) -* [charactermap](charactermap) +* [character-map](character-map) * [psrtwindowslanguage](psrtwindowslanguage) * [psrtmsofficelanguage](psrtmsofficelanguage) \ No newline at end of file diff --git a/windows/src/desktop/help/context/manualactivate.md b/windows/src/desktop/help/context/manualactivate.md deleted file mode 100644 index cf14d9c77b..0000000000 --- a/windows/src/desktop/help/context/manualactivate.md +++ /dev/null @@ -1,3 +0,0 @@ ---- -title: Manually Activate Keyman ---- diff --git a/windows/src/desktop/help/context/splash.md b/windows/src/desktop/help/context/splash.md index 3c2eaca41c..0c06d4cc6d 100644 --- a/windows/src/desktop/help/context/splash.md +++ b/windows/src/desktop/help/context/splash.md @@ -2,7 +2,7 @@ title: The Keyman Splash Screen --- -![](desktop_images/setup-click3.png) +![](../desktop_images/setup-click3.png) The Splash screen shows information about which keyboards are installed, plus the version of Keyman. diff --git a/windows/src/desktop/help/desktop_images/config-locale.png b/windows/src/desktop/help/desktop_images/config-locale.png index 0c1808506b..eb26d1ea7e 100644 Binary files a/windows/src/desktop/help/desktop_images/config-locale.png and b/windows/src/desktop/help/desktop_images/config-locale.png differ diff --git a/windows/src/desktop/help/desktop_images/download-keyboard-step0.png b/windows/src/desktop/help/desktop_images/download-keyboard-step0.png new file mode 100644 index 0000000000..cd48fe0ab6 Binary files /dev/null and b/windows/src/desktop/help/desktop_images/download-keyboard-step0.png differ diff --git a/windows/src/desktop/help/desktop_images/download-keyboard-step1.png b/windows/src/desktop/help/desktop_images/download-keyboard-step1.png new file mode 100644 index 0000000000..2cd6fc1919 Binary files /dev/null and b/windows/src/desktop/help/desktop_images/download-keyboard-step1.png differ diff --git a/windows/src/desktop/help/desktop_images/download-keyboard-step2.png b/windows/src/desktop/help/desktop_images/download-keyboard-step2.png new file mode 100644 index 0000000000..5436bf6ccd Binary files /dev/null and b/windows/src/desktop/help/desktop_images/download-keyboard-step2.png differ diff --git a/windows/src/desktop/help/desktop_images/download-keyboard-step3.png b/windows/src/desktop/help/desktop_images/download-keyboard-step3.png new file mode 100644 index 0000000000..1f905b3321 Binary files /dev/null and b/windows/src/desktop/help/desktop_images/download-keyboard-step3.png differ diff --git a/windows/src/desktop/help/desktop_images/download-keyboard-step4.png b/windows/src/desktop/help/desktop_images/download-keyboard-step4.png new file mode 100644 index 0000000000..1a2ff2b899 Binary files /dev/null and b/windows/src/desktop/help/desktop_images/download-keyboard-step4.png differ diff --git a/windows/src/desktop/help/desktop_images/download-keyboard-step5.png b/windows/src/desktop/help/desktop_images/download-keyboard-step5.png new file mode 100644 index 0000000000..978f79c09e Binary files /dev/null and b/windows/src/desktop/help/desktop_images/download-keyboard-step5.png differ diff --git a/windows/src/desktop/help/desktop_images/download-keyboard-step6.png b/windows/src/desktop/help/desktop_images/download-keyboard-step6.png new file mode 100644 index 0000000000..7d5ac96392 Binary files /dev/null and b/windows/src/desktop/help/desktop_images/download-keyboard-step6.png differ diff --git a/windows/src/desktop/help/desktop_images/fonthelper.png b/windows/src/desktop/help/desktop_images/fonthelper.png index 198c1119d9..848a8dd50b 100644 Binary files a/windows/src/desktop/help/desktop_images/fonthelper.png and b/windows/src/desktop/help/desktop_images/fonthelper.png differ diff --git a/windows/src/desktop/help/desktop_images/menu.png b/windows/src/desktop/help/desktop_images/menu.png index 84924c8bfb..759e93c390 100644 Binary files a/windows/src/desktop/help/desktop_images/menu.png and b/windows/src/desktop/help/desktop_images/menu.png differ diff --git a/windows/src/desktop/help/desktop_images/options-advanced.png b/windows/src/desktop/help/desktop_images/options-advanced.png index 153a05a9de..f208cd9581 100644 Binary files a/windows/src/desktop/help/desktop_images/options-advanced.png and b/windows/src/desktop/help/desktop_images/options-advanced.png differ diff --git a/windows/src/desktop/help/desktop_images/options-general.png b/windows/src/desktop/help/desktop_images/options-general.png index 7a5cc8d9fe..cb17931e68 100644 Binary files a/windows/src/desktop/help/desktop_images/options-general.png and b/windows/src/desktop/help/desktop_images/options-general.png differ diff --git a/windows/src/desktop/help/desktop_images/options-osk.png b/windows/src/desktop/help/desktop_images/options-osk.png index 02b382806b..3d04af6353 100644 Binary files a/windows/src/desktop/help/desktop_images/options-osk.png and b/windows/src/desktop/help/desktop_images/options-osk.png differ diff --git a/windows/src/desktop/help/desktop_images/options-startup.png b/windows/src/desktop/help/desktop_images/options-startup.png index 821e01375e..19e04e2183 100644 Binary files a/windows/src/desktop/help/desktop_images/options-startup.png and b/windows/src/desktop/help/desktop_images/options-startup.png differ diff --git a/windows/src/desktop/help/desktop_images/osk_keyboard.png b/windows/src/desktop/help/desktop_images/osk_keyboard.png index 3519067beb..94d962c8c9 100644 Binary files a/windows/src/desktop/help/desktop_images/osk_keyboard.png and b/windows/src/desktop/help/desktop_images/osk_keyboard.png differ diff --git a/windows/src/desktop/help/desktop_images/setup-click1.png b/windows/src/desktop/help/desktop_images/setup-click1.png index 317361e2e7..27f43701a5 100644 Binary files a/windows/src/desktop/help/desktop_images/setup-click1.png and b/windows/src/desktop/help/desktop_images/setup-click1.png differ diff --git a/windows/src/desktop/help/desktop_images/setup-click2.png b/windows/src/desktop/help/desktop_images/setup-click2.png index aa0f84b05c..ac70478997 100644 Binary files a/windows/src/desktop/help/desktop_images/setup-click2.png and b/windows/src/desktop/help/desktop_images/setup-click2.png differ diff --git a/windows/src/desktop/help/desktop_images/setup-click3.png b/windows/src/desktop/help/desktop_images/setup-click3.png index 96087d813c..f8d02ce5df 100644 Binary files a/windows/src/desktop/help/desktop_images/setup-click3.png and b/windows/src/desktop/help/desktop_images/setup-click3.png differ diff --git a/windows/src/desktop/help/desktop_images/start_tray.png b/windows/src/desktop/help/desktop_images/start_tray.png index e4bf690e8c..f0b018cc1c 100644 Binary files a/windows/src/desktop/help/desktop_images/start_tray.png and b/windows/src/desktop/help/desktop_images/start_tray.png differ diff --git a/windows/src/desktop/help/desktop_images/tab-hotkeys.png b/windows/src/desktop/help/desktop_images/tab-hotkeys.png index d20314edc7..a9354f645c 100644 Binary files a/windows/src/desktop/help/desktop_images/tab-hotkeys.png and b/windows/src/desktop/help/desktop_images/tab-hotkeys.png differ diff --git a/windows/src/desktop/help/desktop_images/tab-options.png b/windows/src/desktop/help/desktop_images/tab-options.png index 06c068699e..8f443bcac3 100644 Binary files a/windows/src/desktop/help/desktop_images/tab-options.png and b/windows/src/desktop/help/desktop_images/tab-options.png differ diff --git a/windows/src/desktop/help/desktop_images/tab-options2.png b/windows/src/desktop/help/desktop_images/tab-options2.png index 302d286ae7..16b4e5816a 100644 Binary files a/windows/src/desktop/help/desktop_images/tab-options2.png and b/windows/src/desktop/help/desktop_images/tab-options2.png differ diff --git a/windows/src/desktop/help/desktop_images/tab-support.png b/windows/src/desktop/help/desktop_images/tab-support.png index 13af121735..b77aa34174 100644 Binary files a/windows/src/desktop/help/desktop_images/tab-support.png and b/windows/src/desktop/help/desktop_images/tab-support.png differ diff --git a/windows/src/desktop/help/desktop_images/toolbox-hints.png b/windows/src/desktop/help/desktop_images/toolbox-hints.png deleted file mode 100644 index 8c962b4da2..0000000000 Binary files a/windows/src/desktop/help/desktop_images/toolbox-hints.png and /dev/null differ diff --git a/windows/src/desktop/help/desktop_images/toolbox-toolbar.png b/windows/src/desktop/help/desktop_images/toolbox-toolbar.png index ea97cf4b99..01e9c623c0 100644 Binary files a/windows/src/desktop/help/desktop_images/toolbox-toolbar.png and b/windows/src/desktop/help/desktop_images/toolbox-toolbar.png differ diff --git a/windows/src/desktop/help/desktop_images/usage-dynamic.png b/windows/src/desktop/help/desktop_images/usage-dynamic.png deleted file mode 100644 index 244e03bcb0..0000000000 Binary files a/windows/src/desktop/help/desktop_images/usage-dynamic.png and /dev/null differ diff --git a/windows/src/desktop/help/desktop_images/usage-help.png b/windows/src/desktop/help/desktop_images/usage-help.png deleted file mode 100644 index 3bf3c0893c..0000000000 Binary files a/windows/src/desktop/help/desktop_images/usage-help.png and /dev/null differ diff --git a/windows/src/desktop/help/desktop_images/usage-none.png b/windows/src/desktop/help/desktop_images/usage-none.png deleted file mode 100644 index 34b0dd5a59..0000000000 Binary files a/windows/src/desktop/help/desktop_images/usage-none.png and /dev/null differ diff --git a/windows/src/desktop/help/desktop_images/usage-osk.png b/windows/src/desktop/help/desktop_images/usage-osk.png deleted file mode 100644 index d89e76cc03..0000000000 Binary files a/windows/src/desktop/help/desktop_images/usage-osk.png and /dev/null differ diff --git a/windows/src/desktop/help/desktop_images/usage-static.png b/windows/src/desktop/help/desktop_images/usage-static.png deleted file mode 100644 index b1fc20f124..0000000000 Binary files a/windows/src/desktop/help/desktop_images/usage-static.png and /dev/null differ diff --git a/windows/src/desktop/help/desktop_images/usage.png b/windows/src/desktop/help/desktop_images/usage.png deleted file mode 100644 index 9a952a65c5..0000000000 Binary files a/windows/src/desktop/help/desktop_images/usage.png and /dev/null differ diff --git a/windows/src/desktop/help/htmlink.lua b/windows/src/desktop/help/htmlink.lua index f5641f57c2..d74d974c2d 100644 --- a/windows/src/desktop/help/htmlink.lua +++ b/windows/src/desktop/help/htmlink.lua @@ -1,10 +1,18 @@ function Link(elem) - if isLocalElem(elem) then - return pandoc.Link(elem.content, elem.target .. '.html', elem.title, elem.attr) + if isLocalLink(elem) then + if isFolderLink(elem) then + return pandoc.Link(elem.content, elem.target .. 'index.html', elem.title, elem.attr) + else + return pandoc.Link(elem.content, elem.target .. '.html', elem.title, elem.attr) + end end return elem end -function isLocalElem(elem) +function isLocalLink(elem) return string.match(elem.target, "://") == nil -end \ No newline at end of file +end + +function isFolderLink(elem) + return not ( string.match(elem.target, "/$") == nil ) +end diff --git a/windows/src/desktop/help/index.md b/windows/src/desktop/help/index.md index ef35825e93..8f9a439770 100644 --- a/windows/src/desktop/help/index.md +++ b/windows/src/desktop/help/index.md @@ -2,16 +2,16 @@ title: Keyman 14.0 Help --- -* [About Keyman](about) +* [About Keyman](about/) -* [Getting Started][start] +* [Getting Started](start/) -* [Basic Help](basic) +* [Basic Help](basic/) -* [Advanced Help](advanced) +* [Advanced Help](advanced/) -* [Common Questions](common) +* [Common Questions](common/) -* [Troubleshooting](troubleshooting) +* [Troubleshooting](troubleshooting/) -* [Contextual Help](context) +* [Contextual Help](context/) diff --git a/windows/src/desktop/help/start/configure_computer.md b/windows/src/desktop/help/start/configure-computer.md similarity index 81% rename from windows/src/desktop/help/start/configure_computer.md rename to windows/src/desktop/help/start/configure-computer.md index 753e4d7942..fe8a942207 100644 --- a/windows/src/desktop/help/start/configure_computer.md +++ b/windows/src/desktop/help/start/configure-computer.md @@ -40,35 +40,35 @@ Correctly associating your Keyman keyboard has three main benefits. **Note**: Keyman allows you to associate multiple Windows languages to a keyboard. -1. Click on the Keyman icon ![](desktop_images/icon-keyman.png), on the +1. Click on the Keyman icon ![](../desktop_images/icon-keyman.png), on the Windows Taskbar near the clock. 2. From the Keyman menu, select Configuration…. 3. Select the Keyboard Layouts tab. - ![](desktop_images/tab-keyboards.png) + ![](../desktop_images/tab-keyboards.png) 4. Click on the down arrow - (![](desktop_images/keyboards-downarrow.png)) beside the keyboard + (![](../desktop_images/keyboards-downarrow.png)) beside the keyboard name. 5. Click the Add language button on the left side under 'Languages:' - ![](desktop_images/tab-layout.png) + ![](../desktop_images/tab-layout.png) 6. From the pop up window, search for the Windows langauge you would like to use and click OK - ![](desktop_images/language-association.png) + ![](../desktop_images/language-association.png) 7. To remove an association, hover over the language name, and click - the ![](desktop_images/icon-uninstall.png) button that appears. + the ![](../desktop_images/icon-uninstall.png) button that appears. ## Related Topics -- [How To - Download and Install a Keyman Keyboard](download-install_keyboard) +- [How To - Download and Install a Keyman Keyboard](download-and-install-keyboard) - [How To - Set up MS Office for a Keyman Keyboard](configure_office) - [How To - Find the Best Fonts for a Keyman Keyboard](font) - [How To - Type in Right-to-Left Languages](rtl) -- [Keyboard Task - Turn on a Keyboard](enable_keyboard) +- [Keyboard Task - Turn on a Keyboard](../basic/select-keyboard) diff --git a/windows/src/desktop/help/start/configure_office.md b/windows/src/desktop/help/start/configure_office.md index 3ccf1c5fc5..972b7d2c2f 100644 --- a/windows/src/desktop/help/start/configure_office.md +++ b/windows/src/desktop/help/start/configure_office.md @@ -19,7 +19,17 @@ settings. ## Setting up MS Office 2017 and MS Office 365 -TODO: complete this +To set up Microsoft Office 2017 / 365 for your Keyman keyboard: + +1. Click Start, and search for Office Language Preferences. + +2. Find your language by clicking the button \[Add a language\]. + +3. Click Add. + +4. Click OK to confirm. + +5. Restart your Office applications. ## Setting up MS Office 2013 @@ -93,8 +103,8 @@ To set up Microsoft Office 2003 for your Keyman keyboard: ## Related Topics -- [How To - Download and Install a Keyman Keyboard](download-install_keyboard) -- [How To - Set up Your Computer for a Keyman Keyboard](configure_computer) +- [How To - Download and Install a Keyman Keyboard](download-and-install-keyboard) +- [How To - Set up Your Computer for a Keyman Keyboard](configure-computer) - [How To - Find the Best Fonts for a Keyman Keyboard](font) - [How To - Type in Right-to-Left Languages](rtl) -- [Keyboard Task - Turn on a Keyboard](enable_keyboard) +- [Keyboard Task - Turn on a Keyboard](../basic/select-keyboard) diff --git a/windows/src/desktop/help/start/download-install_keyboard.md b/windows/src/desktop/help/start/download-and-install-keyboard.md similarity index 62% rename from windows/src/desktop/help/start/download-install_keyboard.md rename to windows/src/desktop/help/start/download-and-install-keyboard.md index 6eaa6cc2c7..096f4fd285 100644 --- a/windows/src/desktop/help/start/download-install_keyboard.md +++ b/windows/src/desktop/help/start/download-and-install-keyboard.md @@ -5,7 +5,7 @@ title: How To - Download and Install a Keyman Keyboard You must have a Keyman keyboard installed to type with Keyman in your language. You can download and install a Keyman keyboard at the same time you download and install Keyman. For more information, see: -[How To - Download and Install Keyman](download-install_keyman). +[How To - Download and Install Keyman](download-and-install-keyman). You can also add keyboards to Keyman after you have installed Keyman. For more information, keep reading. @@ -19,32 +19,36 @@ Here's how to download and install a Keyman keyboard within Keyman: 2. Open Keyman Configuration, from the Keyman menu (on the Windows Taskbar near the clock). - ![](desktop_images/start_tray.png) + ![](../desktop_images/start_tray.png) -3. Select the Keyboard Layouts tab. +3. Click Download keyboard… at the bottom of the window. -4. Click Download keyboard…. + ![](../desktop_images/download-keyboard-step0.png) -5. From the dropdown boxes, find a language associated with your - keyboard and click Search. +4. Type a language name, a country name, a keyboard name or even name of + the author of the keyboard into the search box, or click the Popular + keyboards link to see some of the most commonly installed keyboards. -6. Click Install Keyboard for the keyboard you want to install. + ![](../desktop_images/download-keyboard-step1.png) - **Tip:** The icons to the right of each keyboard name show valuable - information about what the keyboard includes: +5. After a moment, Keyman will present a list of keyboards. Choose the + keyboard you wish to install. -TODO: missing images + ![](../desktop_images/download-keyboard-step2.png) - - – means that the keyboard is a Unicode keyboard. - - – means the keyboard has a virtual On Screen Keyboard. - - – means the keyboard contains help documentation. - - – means the keyboard comes with fonts. - - – means the keyboard has introductory help. +6. A page with more details about the keyboard will be presented. + Click Install keyboard in this page to continue downloading and + installing the keyboard. - **Note:** You may also download the keyboard without installing it. Tick - 'Don't install, just download' in the Download Keyboard window. + ![](../desktop_images/download-keyboard-step3.png) -7. Click Install at the Install Keyboard or Package dialog. +7. The keyboard will be downloaded to your computer. + + ![](../desktop_images/download-keyboard-step4.png) + +8. Click Install at the Install Keyboard/Package dialog. + + ![](../desktop_images/download-keyboard-step5.png) **Tip:** The Install Keyboard/Package dialog includes some helpful information about the keyboard you are installing. In addition to @@ -56,20 +60,19 @@ TODO: missing images - Specific help and readme information (under the readme tab). - - Other details. - **Note:** Install installs the keyboard for anyone who can log on to your - computer. You may be prompted by User Account Control to allow - Keyman to make changes to your computer -- click 'Yes'. + computer. **Note:** If a keyboard with the same name is already installed, Keyman will ask you if you want to replace the old keyboard or cancel the installation. -8. Click OK if asked to configure your computer to work with your new - keyboard. +9. You may be prompted by User Account Control to allow + Keyman to make changes to your computer -- click 'Yes'. -9. Click OK to save your settings and exit Keyman Configuration. + ![](../desktop_images/download-keyboard-step6.png) + +10. The keyboard will now be installed; you can close Keyman Configuration. ## Installing a Keyman Keyboard from a Folder on Your Computer @@ -86,7 +89,7 @@ how: 2. Open Keyman Configuration, from the Keyman menu in the Windows taskbar. - ![](desktop_images/start_tray.png) + ![](../desktop_images/start_tray.png) 3. Select the Keyboard Layouts tab. @@ -118,20 +121,13 @@ how: ask you if you want to replace the old keyboard or cancel the installation. -8. Click OK if asked to configure your computer to work with your new - keyboard. - -9. Click OK to save your settings and exit Keyman Configuration. +8. Click OK to save your settings and exit Keyman Configuration. ## Related Topics -- [How To - Download and Install Keyman](download-install_keyman) -- [Keyboard Task - Turn on a Keyboard](../basic/enable_keyboard) - -- [Keyboard Task - Enable and Disable a Keyboard](../basic/disable_keyboard) - -- [Keyboard Task - Uninstall a Keyboard](../basic/uninstall_keyboard) - -- [Keyman Configuration - Keyboard Layouts Tab](../basic/config_tasks/keyboards_tab) - -- [Keyman Configuration](../basic/config_tasks/config_menu) +- [How To - Download and Install Keyman](download-and-install-keyman) +- [Keyboard Task - Turn on a Keyboard](../basic/select-keyboard) +- [Keyboard Task - Enable or Disable a Keyboard](../basic/enable-or-disable-keyboard) +- [Keyboard Task - Uninstall a Keyboard](../basic/uninstall-keyboard) +- [Keyman Configuration - Keyboard Layouts Tab](../basic/config/keyboards) +- [Keyman Configuration](../basic/config/) diff --git a/windows/src/desktop/help/start/download-and-install-keyman.md b/windows/src/desktop/help/start/download-and-install-keyman.md new file mode 100644 index 0000000000..762c2061e0 --- /dev/null +++ b/windows/src/desktop/help/start/download-and-install-keyman.md @@ -0,0 +1,52 @@ +--- +title: How To - Download and Install Keyman +--- + +## Downloading Keyman + +You can download Keyman with a keyboard for your language from the +[Keyman Website](https://keyman.com/windows/download). + +## Installing Keyman + +After you download Keyman, to install the program: + +1. Find the Keyman executable file on your computer. The name of the + file begins with 'keyman-' and ends with '.exe'. It should + be visible in the Downloaded Files interface of your web browser. + +2. Double-click the file to begin installation. + +3. You will be asked to allow the installer to access your system. + Click Yes to continue. + + ![](../desktop_images/setup-click1.png) + +4. The installer may need to download additional components from keyman.com + in order to complete the installation. If prompted by your firewall + software, ensure you Allow the installer to access the web. + +5. Click Install Keyman to finish installing. Keyman may download additional + files during the installation process. + + ![](../desktop_images/setup-click2.png) + + **Note:** If you downloaded Keyman together with a keyboard, the keyboard + that will be installed will be shown on the left, as in the image above. + + **Note:** You can select advanced installation options from the Install + Options link on the bottom left. + +6. At the end of the installation, click Start Keyman to begin using + Keyman or click Configuration to change Keyman settings first. + + ![](../desktop_images/setup-click3.png) + +When you finish your installation of Keyman, you can delete or move the +installation's executable file. It doesn't need to remain on your +computer for Keyman to work. + +## Related Topics + +- [How To - Download and Install a Keyman Keyboard](download-and-install-keyboard) +- [Software Task - Uninstall Keyman](../basic/uninstall) diff --git a/windows/src/desktop/help/start/download-install_keyman.md b/windows/src/desktop/help/start/download-install_keyman.md deleted file mode 100644 index bc622e2a69..0000000000 --- a/windows/src/desktop/help/start/download-install_keyman.md +++ /dev/null @@ -1,46 +0,0 @@ ---- -title: How To - Download and Install Keyman ---- - -## Downloading Keyman - -You can download Keyman with a keyboard for your language from the -[Keyman Website](https://keyman.com/keyboards/). - -## Installing Keyman - -TODO: rewrite for 14.0 UX - -After you download Keyman, to install the program: - -1. Find the Keyman executable file on your computer. The name of the - file begins with 'keyman-' and ends with '.exe'. - -2. Double-click the file to begin installation. - -3. You will be asked to allow the installer to access your system. - Click Yes to continue. - - ![](desktop_images/setup-click1.png) - -4. Once you have read and agreed to the license terms, click Install - Keyman to continue. - - ![](desktop_images/setup-click2.png) - - **Note:** You can select advanced installation options from the Install - Options link on the bottom left. - -5. At the end of the installation, click Start Keyman to begin using - Keyman or click Take the tour for the Getting Started tutorial. - - ![](desktop_images/setup-click3.png) - -When you finish your installation of Keyman, you can delete or move the -installation's executable file. It doesn't need to remain on your -computer for Keyman to work. - -## Related Topics - -- [How To - Download and Install a Keyman Keyboard](download-install_keyboard) -- [Software Task - Uninstall Keyman](../basic/uninstall) diff --git a/windows/src/desktop/help/start/font.md b/windows/src/desktop/help/start/font.md index ad2a33f225..2d97e26c04 100644 --- a/windows/src/desktop/help/start/font.md +++ b/windows/src/desktop/help/start/font.md @@ -21,7 +21,7 @@ to be 100% to work well for your keyboard, but higher percentages are better. You will also see a chart in the Font Helper, showing exactly which letters and symbols from your keyboard are supported by each font. -![](desktop_images/fonthelper.png) +![](../desktop_images/fonthelper.png) **Note:** The Font Helper tool is designed to tell you which fonts support the letters and characters in your language. It is not intended to show you @@ -33,7 +33,7 @@ your text to see which fonts look the best for your entire text. ## Related Topics - [How To - Fix Font Issues](../troubleshooting/font) -- [How To - Download and Install a Keyman Keyboard](download-install_keyboard) -- [Keyman Toolbox - Font Helper](../basic/toolbox_tasks/fonthelper) -- [Keyman Configuration - Hotkeys Tab](../basic/config_tasks/hotkeys_tab) -- [Keyboard Task - Turn on a Keyboard](../basic/enable_keyboard) +- [How To - Download and Install a Keyman Keyboard](download-and-install-keyboard) +- [Keyman Toolbox - Font Helper](../basic/toolbox/font-helper) +- [Keyman Configuration - Hotkeys Tab](../basic/config/hotkeys) +- [Keyboard Task - Turn on a Keyboard](../basic/select-keyboard) diff --git a/windows/src/desktop/help/start/hotkey_set.md b/windows/src/desktop/help/start/hotkey_set.md index 8b4a903dbb..b960c92a5f 100644 --- a/windows/src/desktop/help/start/hotkey_set.md +++ b/windows/src/desktop/help/start/hotkey_set.md @@ -13,32 +13,31 @@ language: 2. Select the Hotkeys tab. - ![](desktop_images/tab-hotkeys.png) + ![](../desktop_images/tab-hotkeys.png) 3. Click the hotkey link beside the function, keyboard or language. The Change Hotkey dialog box will be displayed. - ![](desktop_images/hotkeys-change.png) + ![](../desktop_images/hotkeys-change.png) 4. Select a default hotkey or click Custom and type the hotkey you wish to use. **Note:** If you press a single letter or Shift plus a single letter, the - hotkey will default to Ctrl + Alt plus the letter you pressed, in + hotkey will default to Ctrl + Alt plus the letter you pressed, in order to avoid conflicts with standard keyboard input. **Note:** To clear a hotkey that has been set previously, click Clear Hotkey or press Backspace. - **Note:** Be aware that you can set the hotkey to replace common Windows hotkeys (Ctrl + C, Ctrl + V, etc). - + **Note:** Be aware that you can set the hotkey to replace common Windows hotkeys ( + Ctrl + C, Ctrl + V, etc). This is not + recommended. 5. Click OK to save your selection. -6. Click OK again from the Configuration window to apply the changes. - The new hotkey will now be available. ## Related Topics -- [Keyman Configuration - Hotkeys Tab](../basic/config_tasks/hotkeys_tab) +- [Keyman Configuration - Hotkeys Tab](../basic/config/hotkeys) diff --git a/windows/src/desktop/help/start/index.md b/windows/src/desktop/help/start/index.md index 678fdf7fc0..e3927980d1 100644 --- a/windows/src/desktop/help/start/index.md +++ b/windows/src/desktop/help/start/index.md @@ -2,12 +2,12 @@ title: Getting Started --- -* [tutorial](tutorial) -* [download-install_keyman](download-install_keyman) -* [download-install_keyboard](download-install_keyboard) -* [configure_computer](configure_computer) -* [configure_office](configure_office) -* [font](font) -* [rtl](rtl) -* [locale](locale) -* [hotkey_set](hotkey_set) +* [Getting Started with Keyman](tutorial) +* [How To - Download and Install Keyman](download-and-install-keyman) +* [How To - Download and Install a Keyman Keyboard](download-and-install-keyboard) +* [How To - Set up Your Computer for a Keyman Keyboard](configure-computer) +* [How To - Set up MS Office for a Keyman Keyboard](configure_office) +* [How To - Find the Best Fonts for a Keyman Keyboard](font) +* [How To - Type in Right-to-Left Languages](rtl) +* [How To - Set the Language for Keyman Menus](locale) +* [How To - Set Hotkeys for Keyman, Keyman Keyboards and Windows Languages](hotkey_set) diff --git a/windows/src/desktop/help/start/locale.md b/windows/src/desktop/help/start/locale.md index 38a61f5215..00469bb567 100644 --- a/windows/src/desktop/help/start/locale.md +++ b/windows/src/desktop/help/start/locale.md @@ -12,7 +12,7 @@ English: 2. Click English in the 'Display in:' menu on the top right corner. - ![](desktop_images/config-locale.png) + ![](../desktop_images/config-locale.png) 3. Select your language from the list. If your language is not in the list, click Find other display languages online…. @@ -26,5 +26,5 @@ English: ## Related Topics -- [Keyman Configuration](../basic/config_tasks/config_menu) +- [Keyman Configuration](../basic/config/) - [Translating the Keyman for Windows User Interface](../advanced/locale_edit) diff --git a/windows/src/desktop/help/start/rtl.md b/windows/src/desktop/help/start/rtl.md index a56da5a8cd..5a9e037c5c 100644 --- a/windows/src/desktop/help/start/rtl.md +++ b/windows/src/desktop/help/start/rtl.md @@ -17,11 +17,12 @@ get started. To do this, simply associate the keyboard with a right-to-left Windows language (like Arabic). For instructions on associating a Keyman keyboard with a Windows language, see: - [???](#start_configure_computer) + [How To - Set up Your Computer for a Keyman Keyboard](configure-computer) 2. If you will be using MS Office programs like Word, you should configure MS Office for your right-to-left language. For - instructions, see: [???](#start_configure_office) + instructions, see: + [How To - Set up MS Office for a Keyman Keyboard](configure_office) 3. Each time you start typing with a right-to-left Keyman keyboard, you may need to change the typing direction in the program you are @@ -29,19 +30,18 @@ get started. (including MS Word, Internet Explorer, and Notepad), you can use the following shortcuts to switch direction: - - For right-to-left, press: Ctrl + Right.Shift - - - For left-to-right, press: Ctrl + Left.Shift + - For right-to-left, press: Ctrl + Right Shift + - For left-to-right, press: Ctrl + Left.Shift In Firefox: - - To toggle between right-to-left and left-to-right, press: Ctrl + - Shift + X + - To toggle between right-to-left and left-to-right, press: + Ctrl + Shift + X ## Related Topics -- [How To - Set up Your Computer for a Keyman Keyboard](configure_computer) -- [How To - Download and Install a Keyman Keyboard](download-install_keyboard) +- [How To - Set up Your Computer for a Keyman Keyboard](configure-computer) +- [How To - Download and Install a Keyman Keyboard](download-and-install-keyboard) - [How To - Set up MS Office for a Keyman Keyboard](configure_office) - [How To - Find the Best Fonts for a Keyman Keyboard](font) -- [Keyboard Task - Turn on a Keyboard](../basic/enable_keyboard) +- [Keyboard Task - Turn on a Keyboard](../basic/select-keyboard) diff --git a/windows/src/desktop/help/start/tutorial.md b/windows/src/desktop/help/start/tutorial.md index 569afa4632..ce033f082d 100644 --- a/windows/src/desktop/help/start/tutorial.md +++ b/windows/src/desktop/help/start/tutorial.md @@ -5,106 +5,47 @@ title: Getting Started with Keyman Follow these steps for a basic introduction to Keyman: **Note:** Keyman must be installed first. For help on installing -Keyman, please see: [How To - Download and Install Keyman](../basic/download-install_keyman). +Keyman, please see: [How To - Download and Install Keyman](download-and-install-keyman). ## Step 1 Check the Windows Taskbar near the clock to see if Keyman is running. If it is running you will see the Keyman icon: -![](desktop_images/icon-keyman.png) +![](../desktop_images/icon-keyman.png) ## Step 2 If the Keyman icon is in the Windows Taskbar near the clock, continue on to [Step 5](#tutorial_step5). -![](desktop_images/start_tray.png) +![](../desktop_images/start_tray.png) If the Keyman icon is not on the Windows Taskbar near the clock, click -the arrow or triangle next to the clock: +the arrow or triangle near the clock: - You will see a collection of icons. If the Keyman icon - (![](desktop_images/icon-keyman.png)) is not in this collection, + (![](../desktop_images/icon-keyman.png)) is not in this collection, Keyman is not running. Read steps 3 and 4 to learn how to start Keyman. -- If the Keyman icon is in this collection, you should move it - permanently to the Windows Taskbar. Here's how: - - - On Windows 7: - - 1. Open the Windows Start menu. - - 2. In the search field, type and enter: Notification Area Icons - - 3. From the dropdown menu beside Keyman - Engine x86, select 'Show icon and notifications'. - - ![](desktop_images/7-taskbar.png) - - 4. Click OK to apply changes. The Keyman icon will now always - appear in the Windows Taskbar near the clock, if Keyman is - on. - - 5. Continue on to [Step 5](#tutorial_step5) of this guide. - - - On Windows 8: - - 1. Right-click on the Windows Taskbar. - - ![](desktop_images/win8-taskbar1.png) - - 2. Select 'Properties'. - - 3. Next to 'Notification area', click Customize…. - - ![](desktop_images/win8-taskbar2.png) - - 4. From the dropdown menu beside SIL International Keyman - Engine x86, select 'Show icon and notifications'. - - ![](desktop_images/win8-taskbar3.png) - - 5. Click OK to apply changes. The Keyman icon will now always - appear in the Windows Taskbar near the clock, if Keyman is - on. - - 6. Continue on to [Step 5](#tutorial_step5) of this guide. - - - On Windows 10 - - 1. Right-click on the Windows Taskbar. - - ![](desktop_images/win10-taskbar1.png) - - 2. Select 'Taskbar settings'. - - 3. Under 'Notification area', click on 'Select which icons - appear on the taskbar' - - ![](desktop_images/win10-taskbar2.png) - - 4. From the toggle button beside 'SIL International Keyman - Engine x86', click to turn it on. - - ![](desktop_images/win10-taskbar3.png) - - 5. The Keyman icon will now always appear in the Windows - Taskbar near the clock, if Keyman is on. - - 6. Continue on to [Step 5](#tutorial_step5) of this guide. +- If the Keyman icon is in this collection, you can optionally + [move it permanently to the Windows Taskbar](../basic/make-taskbar-icon-visible), + to make it more easily accessible. However, Keyman will run + correctly even if the icon is left in this collection. ## Step 3 -To Start Keyman, click on the Windows Start Menu, select All Programs, -and select Keyman. +To Start Keyman, click on the Windows Search box, type "Keyman", +and select Keyman from the list of Apps (it will probably be the +best match). ## Step 4 -Keyman will now be running and the Keyman icon will be on the Windows +Keyman may show a startup screen; simply click Start Keyman to +start the app. Keyman will now be running and the Keyman icon will be on the Windows Taskbar near the clock. -## Step 5 +## Step 5 Open a typing application, like Microsoft Word. @@ -116,7 +57,7 @@ your Keyman keyboard is on. **Tip:** If there are no Keyman keyboards in the Keyman menu, you can learn how to install one here: -- [How To - Download and Install a Keyman Keyboard](download-install_keyboard) +- [How To - Download and Install a Keyman Keyboard](download-and-install-keyboard) ## Step 7 @@ -125,9 +66,8 @@ Keyboard tool of the Keyman Toolbox. You can open the On Screen Keyboard tool from the On Screen Keyboard link in the Keyman menu. **Tip:** Some Keyman keyboards do not include an On Screen Keyboard. You can -usually find help for these keyboards from the Keyboard Usage tool of -the Keyman Toolbox. You can open the Keyboard Usage tool from the -Keyboard Usage link in the Keyman menu. +usually find help for these keyboards in the keyboard help, by clicking the +help icon in the Keyman Toolbox. ## Step 8 @@ -140,5 +80,5 @@ To return to using your normal keyboard, open the Keyman menu and select your de ## Related Topics -- [How To - Download and Install Keyman](../basic/download-install_keyman) -- [How To - Download and Install a Keyman Keyboard](download-install_keyboard) +- [How To - Download and Install Keyman](download-and-install-keyman) +- [How To - Download and Install a Keyman Keyboard](download-and-install-keyboard) diff --git a/windows/src/desktop/help/troubleshooting/bootstrapper.md b/windows/src/desktop/help/troubleshooting/bootstrapper.md index 3a0f95d3c5..c71e9f357c 100644 --- a/windows/src/desktop/help/troubleshooting/bootstrapper.md +++ b/windows/src/desktop/help/troubleshooting/bootstrapper.md @@ -43,4 +43,4 @@ The following command line parameters are supported in the bootstrapper: ## Related Topics -- [How To - Download and Install Keyman](../start/download-install_keyman) +- [How To - Download and Install Keyman](../start/download-and-install-keyman) diff --git a/windows/src/desktop/help/troubleshooting/font.md b/windows/src/desktop/help/troubleshooting/font.md index a1a595a900..a69540c867 100644 --- a/windows/src/desktop/help/troubleshooting/font.md +++ b/windows/src/desktop/help/troubleshooting/font.md @@ -24,4 +24,4 @@ appears at a smaller size to the 'ha'. ## Related Topics - [How To - Find the Best Fonts for a Keyman Keyboard](../start/font) -- [Keyman Toolbox - Font Helper](../basic/toolbox_tasks/fonthelper) +- [Keyman Toolbox - Font Helper](../basic/toolbox/font-helper)