diff options
Diffstat (limited to 'keyboards/splitkb/kyria/keymaps/lw/readme.md')
| -rw-r--r-- | keyboards/splitkb/kyria/keymaps/lw/readme.md | 104 |
1 files changed, 104 insertions, 0 deletions
diff --git a/keyboards/splitkb/kyria/keymaps/lw/readme.md b/keyboards/splitkb/kyria/keymaps/lw/readme.md new file mode 100644 index 000000000..67be1950a --- /dev/null +++ b/keyboards/splitkb/kyria/keymaps/lw/readme.md | |||
| @@ -0,0 +1,104 @@ | |||
| 1 | # Kyria's lw Keymap | ||
| 2 | |||
| 3 | Custom keymap for the [kyria keyboard](https://blog.splitkb.com/blog/introducing-the-kyria). It is intended to be used with an *English (US, intl. with dead keys)* keyboard layout (includes the `keymap_us_international.h` header). | ||
| 4 | |||
| 5 | This layout is mainly designed for every day writing in either English, French or German and programming. | ||
| 6 | |||
| 7 | The layout implements all accents and symbols (leveraging dead keys) found on a **swiss** keyboard. It uses Unicode for special characters. It makes use of the [Linux built-in IBus Unicode input](https://docs.qmk.fm/#/feature_unicode?id=input-modes) and relies on [WinCompose](https://github.com/samhocevar/wincompose) for Windows. | ||
| 8 | |||
| 9 | ## Build this keymap | ||
| 10 | ```bash | ||
| 11 | qmk compile -kb splitkb/kyria/rev1 -km lw | ||
| 12 | ``` | ||
| 13 | |||
| 14 | ## Flash this keymap | ||
| 15 | |||
| 16 | > **Note**: this was tested for an Elite-C microcontroller. | ||
| 17 | |||
| 18 | First, check that the bootloader is visible. For instance: | ||
| 19 | ```bash | ||
| 20 | $ lsusb | ||
| 21 | ... | ||
| 22 | Bus 001 Device 034: ID 03eb:2ff4 Atmel Corp. atmega32u4 DFU bootloader | ||
| 23 | ... | ||
| 24 | ``` | ||
| 25 | If the bootloader is not visible, press the reset button of the microcontroller. The bootloader should become visible when running the `lsusb` command again. | ||
| 26 | |||
| 27 | The microcontroller can now be flashed: | ||
| 28 | ```bash | ||
| 29 | qmk flash -kb splitkb/kyria/rev1 -km lw | ||
| 30 | ``` | ||
| 31 | > **Note**: if there is any issue, run `qmk doctor` to see whether the qmk configuration is valid. | ||
| 32 | |||
| 33 | ## Implemented keymaps | ||
| 34 | The default keymap contains 5 layers which allows it to include all keys found on an ANSI layout TKL keyboard plus media keys. | ||
| 35 | Hardware features of the Kyria such as OLEDs, rotary encoders and underglow are also supported. | ||
| 36 | |||
| 37 | The five different layers are the following: | ||
| 38 | 1. Base layer (QWERTZ) | ||
| 39 | 2. Symbols/Numbers layer | ||
| 40 | 3. Navigation layer | ||
| 41 | |||
| 42 | ### Base layer | ||
| 43 | This layer is activated by default. | ||
| 44 | |||
| 45 | ``` | ||
| 46 | /* | ||
| 47 | * 0. Base Layer: QWERTZ | ||
| 48 | * | ||
| 49 | * ,-------------------------------------------. ,-------------------------------------------. | ||
| 50 | * | Esc | Q | W | E | R | T | | Z | U | I | O | P | Del | | ||
| 51 | * |--------+------+------+------+------+------| |------+------+------+------+------+--------| | ||
| 52 | * | Tab | A | S | D | F | G | | H | J | K | L | ' " | BkSpace| | ||
| 53 | * |--------+------+------+------+------+------+-------------. ,-------------+------+------+------+------+------+--------| | ||
| 54 | * | LShift | Y | X | C | V | B | \ | | ` ~ | | ( | ) | N | M | , < | . > | ; : | CpLock | | ||
| 55 | * `----------------------+------+------+------+------+------| |------+------+------+------+------+----------------------' | ||
| 56 | * |LCtrl | LGUI | LAlt | Space| MO(1)| | MO(2)| Enter| - _ | ! | / ? | | ||
| 57 | * | | | | | | | |/shift| | | | | ||
| 58 | * `----------------------------------' `----------------------------------' | ||
| 59 | */ | ||
| 60 | ``` | ||
| 61 | |||
| 62 | Hold down the `Enter` key to make it a shift. This compensates for the poor placement of the dedicated `LShift` key. | ||
| 63 | |||
| 64 | ### Symbol layer | ||
| 65 | This layer is activated when holding `MO(1)`. | ||
| 66 | |||
| 67 | ``` | ||
| 68 | /* | ||
| 69 | * 1. Sym Layer: Numbers and symbols | ||
| 70 | * | ||
| 71 | * ,-------------------------------------------. ,-------------------------------------------. | ||
| 72 | * | F1 | F2 | F3 | F4 | LAlt | PASTE| | , | 7 | 8 | 9 | * | / | | ||
| 73 | * |--------+------+------+------+------+------| |------+------+------+------+------+--------| | ||
| 74 | * | F5 | F6 | F7 | F8 | @ | COPY | | . | 6 | 7 | 8 | = | | | ||
| 75 | * |--------+------+------+------+------+------+-------------. ,-------------+------+------+------+------+------+--------| | ||
| 76 | * | F9 | F10 | F11 | F12 | & | CUT | UNDO | FIND | | [ | ] | 0 | 1 | 2 | 3 | + | - | | ||
| 77 | * `----------------------+------+------+------+------+------| |------+------+------+------+------+----------------------' | ||
| 78 | * | $ | # | % | | MO(1)| | MO(2)| | \ | | { | } | | ||
| 79 | * | | | | | | | | | | | | | ||
| 80 | * `----------------------------------' `----------------------------------' | ||
| 81 | */ | ||
| 82 | ``` | ||
| 83 | |||
| 84 | ### Navigation layer | ||
| 85 | This layer is activated when holding `MO(2)`. | ||
| 86 | |||
| 87 | ``` | ||
| 88 | /* | ||
| 89 | * 2. Nav Layer: Media, navigation, accents | ||
| 90 | * | ||
| 91 | * ,-------------------------------------------. ,-------------------------------------------. | ||
| 92 | * | | Brt+ | Next | Fwd | Play | Vol+ | | Home | PgUp | Up | PgDn | | Del | | ||
| 93 | * |--------+------+------+------+------+------| |------+------+------+------+------+--------| | ||
| 94 | * | | Brt- | Prev | Bckw | Stop | Vol- | | End | Left | Down | Right|ScrLck| BkSpace| | ||
| 95 | * |--------+------+------+------+------+------+-------------. ,-------------+------+------+------+------+------+--------| | ||
| 96 | * | LShift | ´ | ` | ^ | ¨ | Mute | |UC_MOD| |RShift| Menu | PrtSc| ç/Ç | § ° | | SAVE | Insert | | ||
| 97 | * `----------------------+------+------+------+------+------| |------+------+------+------+------+----------------------' | ||
| 98 | * |LCtrl | LGUI | LAlt | | MO(1)| | MO(2)| UNDO | CUT | COPY | PASTE| | ||
| 99 | * | | | | | | | | | | | | | ||
| 100 | * `----------------------------------' `----------------------------------' | ||
| 101 | */ | ||
| 102 | ``` | ||
| 103 | |||
| 104 | The key `UC_MOD` allows to switch between Linux and Windows unicode. Note however that [WinCompose](https://github.com/samhocevar/wincompose) must be installed on Windows (simply download and install the latest release and it will run). \ No newline at end of file | ||
