Update noroadsleft userspace and keymaps (2021-04-26) (#12711 )

* Update noroadsleft userspace and keymaps (2021-04-26)

- add Discipline keymap
- move Emulated Non-US Backslash, Numeric Keypad and F13-F24 code fully to userspace
- re-add some custom keycode handling I accidentally deleted
- update VRSN keycode
- update KC60 and userspace readmes

* remove Git readme from kc60 keymap

* update kc60:noroadsleft readme

Concatenates this readme into one file, and updates the image links.

2021-04-26 23:44:45 -07:00

@noroadsleft's Userspace

This directory holds the code that's the same for every keyboard I use in QMK, which is currently:

kc60
kbdfans/kbd75/rev1
coseyfannitutti/discipline

Macro Features and Custom Keycodes

VRSN

Outputs a string that tells me the Git commit from which my flashed firmware was built. Looks something like:

kc60:noroadsleft @ 0.6.326-6-gae6d7b-dirty

Git Macros

Some frequently used Git commands.

Keycode	Output	Output with `Shift`
`G_PUSH`	`git push origin`	`git push origin`
`G_FTCH`	`git fetch upstream`	`git pull upstream`
`G_BRCH`	`master`	`$(git branch-name)`

$(git branch-name) is an alias for git rev-parse --abbrev-ref HEAD, which normally return the name of the current branch.

"Macro Mode" Macros and Customized Keycodes

Some of my macros and keycodes do different things depending on the value of the macroMode variable, which is toggled between 0 and 1 by the M_MDSWP custom keycode.¹ This is mainly at attempt to make various shortcuts use the same physical key combinations between Windows/Linux and MacOS (which I use at home and work, respectively).

Keycode	`macroMode == 0`	`macroMode == 1`	`macroMode == 1` with `Shift`
`M_SALL`	`Ctrl+A`	`Cmd+A`	`Cmd+A`
`M_UNDO`	`Ctrl+Z`	`Cmd+Z`	`Cmd+Shift+Z`
`M_CUT`	`Ctrl+X`	`Cmd+X`	`Cmd+X`
`M_COPY`	`Ctrl+C`	`Cmd+C`	`Cmd+C`
`M_PASTE`	`Ctrl+V`	`Cmd+V`	`Cmd+Shift+Opt+V`
`KC_PSCR`	`KC_PSCR`	`Cmd+Shift+3`	`Cmd+Shift+3`
`KC_HOME`	`KC_HOME`	`Cmd+Left`	`Cmd+Left`
`KC_END`	`KC_END`	`Cmd+Right`	`Cmd+Right`

Emulated Non-US Backslash

Sometimes I type in languages from countries that use ISO layout, but my keyboard is ANSI, so I have one key fewer. This macro simulates the Non-US Backslash key if I use Right Alt + KC_Z.

Emulated Numeric Keypad

If I hold the Right Alt key, the number row (KC_1 through KC_0) will output numpad keycodes instead of number row keycodes, enabling quicker access to characters like ™ and °.

Emulated Extended Function Keys

Similar to the emulated numpad, if I hold the Right Alt key with the Fn key, the function row (KC_F1 through KC_F12) will output keycodes KC_F13 throught KC_F24.

License

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.

Footnotes

1: ^ The M_MDSWP keycode is used in my keymaps in the following locations:

4.5 KiB Raw Blame History