X-Git-Url: https://shimmer.witbreuk.eu/gitweb/UltimateKEYS.git/blobdiff_plain/3f4df1062c3cdd4887afee05c3bc83382404940b..7dc65ca954a21c290fd53159f530c6bc5c7ac14d:/README.md diff --git a/README.md b/README.md index 06c5981..99743c5 100644 --- a/README.md +++ b/README.md @@ -1,52 +1,27 @@ -# UltimateKEYS Keyboard Layout (Windows) -This project is based on US-QWERTY and is forked from the EurKEY Keyboard Layout. +# UltimateKEYS Keyboard Layout (Windows/Linux) -## Download the latest version +International US QWERTY layout with AltGr (Right Alt) dead keys via AutoHotkey (Win), MSKLC (Win) and XKB/Xmodmap + .XCompose (Linux). This layout has borrowed some aspects from EurKEY (by Steffen Brüntjen). -- **https://github.com/pieter-degroote/UltimateKEYS/releases** +**Official release :** [![GitHub Release](https://img.shields.io/github/release/pieter-degroote/UltimateKEYS.svg)](https://github.com/pieter-degroote/UltimateKEYS/releases) +**Testing release :** [![GitHub Testing](https://img.shields.io/github/release/pieter-degroote/UltimateKEYS-testing.svg?label=testing)](https://github.com/pieter-degroote/UltimateKEYS-testing/releases) +## Keyboard Layout Image : -## Installation Instructions +![UltimateKEYS - Keyboard Layout Image](images/UltimateKEYS%20-%20Keyboard%20Layout%20Image.png) -### Important - Please note : +## Important - Security Warning : -- **The current version(s) should be sufficiently stable and reliable for everyday use, but are _NOT_ certified for mission-critical systems !** +**=> Win/Linux :  Only use "BASIC LATIN" characters (codes 32 to 126) for your Windows, Microsoft Live and Linux passwords !** +Otherwise, it might be impossible to type any Unicode character higher than "Basic Latin" at the login screen/prompt (due to a different keyboard configuration) ! **=> ACCOUNT LOCKOUT** -### Uninstalling a previous version : +**=> Win/Linux :  ALWAYS make your system passwords VISIBLE during modification !** -In case you have already installed a previous version of UltimateKEYS, uninstall it beforehand : +## Website :  [www.ultimatekeys.info](https://pieter-degroote.github.io/UltimateKEYS/) -1. Remove it from the 'language bar'. -2. Uninstall it via 'Control Panel' -> 'Programs and Features'. -3. Restart your computer. +**See also :  [https://pieter-degroote.github.io/UltimateKEYS/](https://pieter-degroote.github.io/UltimateKEYS/)** -### Installing UltimateKEYS : +## Releases :  https://github.com/pieter-degroote/UltimateKEYS/releases -1. Unpack the ZIP file and run 'setup.exe'. -2. Confirm the UAC (User Account Control) prompt by clicking 'Yes'. -3. Log off and back on. -4. Optionally, enable UltimateKEYS as the preferred keyboard layout in the 'language bar'. +## Testing Repository - Additional experimental versions : -## Documentation - Keyboard Layout Image, Dead Key Descriptions - -- **https://pieter-degroote.github.io/UltimateKEYS/documentation.html** -- **https://pieter-degroote.github.io/UltimateKEYS/** - -## Script for AutoHotkey - -In case you prefer this approach, there is also a highly customizable, slimmed down script. Just note that there are no dead keys when using this script (plus some small modifications have been made). To work properly, the Windows keyboard has to be set to standard US-QWERTY. - -- **AutoHotkey website : https://www.autohotkey.com/** -- **Download the 'UltimateKEYS - YYYY-MM-DD.ahk' file from this repository.** -- **After AutoHotkey is installed, you can optionally put the AHK file in the 'Startup' folder.** - -## Tools for opening and handling KLC files - -The source '.KLC' file is found in the 'source' folder of the UltimateKEYS package. - -- **Microsoft Keyboard Layout Creator 1.4 : https://www.microsoft.com/en-us/download/details.aspx?id=22339** -- **KbdEdit : http://www.kbdedit.com/** - -## Enjoy and have fun ! - -Pieter Degroote +## https://github.com/pieter-degroote/UltimateKEYS-testing