summaryrefslogtreecommitdiff
path: root/users/alfrdmalr/readme.md
diff options
context:
space:
mode:
authorAlfred Maler <alfrdmalr@gmail.com>2020-02-07 21:42:04 -0500
committerGitHub <noreply@github.com>2020-02-07 18:42:04 -0800
commit707c04b4ab588967c803114d7d88ef3fdd934967 (patch)
tree8f786f6371ddbf094d72841749cd40e7e4771b79 /users/alfrdmalr/readme.md
parentbe05de6a3de19e5641692651ef03ae16f3bf653e (diff)
[Keymap] Add users/alfrdmalr and switch to layouts (#8030)
* WIP do not merge * first pass at custom preonic layout * add auto shift and reset via leader key * Update readme * update copyright notice * formatting changes * fix: use MO instead of process_record_user * added backslash and moved grave position * remove extraneous 'j' characer in NUMPAD template * update template formatting * remove process_record_user * swap "!" with "@" * fix readme formatting * update readme layout image * restore settings layer * add windows minimize sequence * fix: switch to correct seq function for three-key sequence * fix: missing semicolon * refactor: move keymap to userspace and generic 5x12 layout * add numlock to numpad layer * add readme * update readme formatting * remove unused wrappers from layout keymap * update readme title to reflect new location * remove alfrdmalr directory from preonic/keymaps * clean up user config
Diffstat (limited to 'users/alfrdmalr/readme.md')
-rw-r--r--users/alfrdmalr/readme.md47
1 files changed, 47 insertions, 0 deletions
diff --git a/users/alfrdmalr/readme.md b/users/alfrdmalr/readme.md
new file mode 100644
index 0000000000..d462a5baf1
--- /dev/null
+++ b/users/alfrdmalr/readme.md
@@ -0,0 +1,47 @@
+# alfrdmalr's userspace
+## Overview
+The alphanumeric characters and symbols are spread between three main 'typing' layers: REGULAR, NUMPAD, and SYMBOLS.
+
+A fourth layer, NAVIGATION, contains useful modifiers, shortcuts, and navigation functions like the arrow keys and page up/down. This layer also provides access to the `ENTER` and `ESC` keys.
+
+Finally, a SETTINGS layer can be used to adjust certain keyboard-related options.
+
+A visual representation of each layer can be found in [alfrdmalr.h](./alfrdmalr.h)
+
+### Layers
+
+#### REGULAR
+Right now this is just a QWERTY layer, but other layouts (DVORAK, COLEMAK, etc.) could easily be added. The REGULAR layer uses the default modifiers.
+
+The default modifiers are defined in the style `K00`, where the first digit is the row index and the second digit is the column index. These indices are based on the Preonic's 5x12 grid, and are **not** adjusted for a board of different size; for instance, the upper-leftmost key in the preonic layout is `K00`, whereas the upper-leftmost key on a Planck would be `K10`.
+
+This convention is designed to work nicely with layout wrappers.
+
+#### NUMPAD
+The NUMPAD layer puts a numpad under the right hand, surrounding the home row position. Several basic arithmetic operators are also provided, as well as comma/decimal symbols, to emulate a traditional numpad. The numlock/capslock keys are accessible from this layer as well, though it should be noted that the actual keycodes being sent by the numpad are NOT the numpad versions of the numbers - this is to prevent the normal numlock behavior from blocking numbers from being sent.
+
+This layer also holds the first twelve function keys.
+
+#### SYMBOLS
+This layer holds all the symbols that are not accessible from the REGULAR layer. There is some redundancy (for instance, `/` exists in both the REGULAR and SYMBOLS layer; its position, however, remains consistent) but with the exception of single and double quotes, all symbols are available from this layer.
+
+#### NAVIGATION
+The primary function of this layer is to provide arrow keys under hjkl. The surrounding keys contain similar functionality - for instance, the keys directly below `DOWN` and `UP` are `PAGEDOWN` and `PAGEUP`, respectively. `HOME` and `END` are inverted from this convention, simply because I kept hitting the wrong key when trying to jump to the beginning/end of lines when editing text.
+
+To the immediate right of the NAVIGATION layer key are the following modifiers: `SHIFT`, `CONTROL`, `ALT`, `GUI`. All modifiers are the "left" variants. The idea is to use the left hand to hold different modifiers as necessary while using the right hand to navigate and format.
+
+`ESCAPE` is located on the spacebar from this layer, and `DELETE` is placed next to `BACKSPACE`, for convenience when formatting text. There are also four Windows shortcuts for undo, cut, copy, and paste, located in the same position as the relevant keys on the base layer (undo, for example, is in the same place as the `Z` key).
+
+#### SETTINGS
+Right now, this is pretty similar to the default settings layer (the planck's ADJUST layer).
+
+Primary differences are the inclusion of an autoshift toggle and the removal of the reset button. The bootloader functionality has been moved to a leader key sequence: LEAD - R - E - S - E - T.
+
+### Leader Key Sequences
+A complete list of leader sequences can be found below:
+
+#### Reset
+LEAD - R - E - S - E - T
+
+#### Minimize (Windows)
+LEAD - M - I - N