1
0
Fork 0

Bocaj - Third Annual Refactor (Redux) (#10295)

* Reset everything to upstream, reapply Bocaj changes

* Bocaj - address PR comments

* Just in time changes

* Bocaj - Several adjustments after using the layout for a while
This commit is contained in:
Jacob Jerrell 2020-12-06 00:30:27 -06:00 committed by GitHub
parent 6b1f96dca8
commit 3076f86dc1
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
24 changed files with 1418 additions and 1007 deletions

View file

@ -1,37 +1,28 @@
# Bocaj Layout
# Overview
While I've put my own spin on most things, much of the credit for these ideas belongs to Drashna and/or the people he derived things from. Please see his [layout](../drashna/) and [userspace](../../../../users/drashna/) for lots of ideas and inspiration.
This is my personal Ergodox EZ configuration, and my daily driver.
## Layers Overview
Most of the code resides in my userspace and is heavily based upon [Drashna's work](https://github.com/qmk/qmk_firmware/tree/master/users/drashna)... although considerably slimmed down.
* Default
* Workman
* Qwerty
* Windows Workman (swaps GUI and CTRL buttons)
* Lower
* F1-12 Top Row
* Grave / Layer Switch macro at Caps Lock position
* Navigation at QWERTY 'ESDF' position
* Numpad under right hand
* Adjust
* Volume Control
* Mac Lock Macro
* Make / Reset/ EEPROM keys
* Default Layer changing keys
* Diablo Layer
* Moved shortcuts within left hands reach
* Macros to spam 1-4 every ~1 second
* Shift in thumb cluster to prevent pinky fatique
## How to build
## LEDs Overview
Put simply:
`make ergodox_ez:bocaj`
* Used for _LOWER, _ADJUST, and _DIABLO layer indication
* Used for Ctrl/GUI, Shift, and Alt indication when on a default layer
On that note, I use a separate workspace when making changes to my layouts or userspace. In that repo, there is a tool that does this for me. See [JacobJerrell/qmk_layouts/tools/](https://github.com/JacobJerrell/qmk_layouts/tree/master/tools)
## Wrappers Overview
## Layers
While it isn't a novel idea, I feel the need to mention it because it really appeals to me as a person that doesn't like repetitive code.
* WORKMAN: No one uses this board but me and I've never had a reason to switch to QWERTY
* LOWER:
* Left: Grave and navigation arrows
* Right: Numpad
* RAISE:
* Symbols across the top, F-Keys on the second row
* ADJUST
* Audio control, make/reset/version macros
* MOD: mouse navigation
We've all come to know and love the pretty wrapper for Ergodox because it makes for such a beautiful, self-documenting keymap. In this keymap, we are building ontop of the pretty wrapper to wrap our default layers with our keys that aren't unique to the layer.
## Ergodox Specifics
Now you can wrap your keymap with `LAYOUT_ergodox_pretty_base_wrapper()` and only feed it the alpha keys, having the top, side, bottom, and thumb clusters automatically filled in. If you make a key to any of the top, side, bottom, or thumb cluster keys, it will propegate to all layers that have this wrapper, or have KC_TRNS keycodes in the same location
I don't have the underglow or backlit versions so the 3 LEDs on the right board are used for layer indication if not on the base layer. If you're on the base layer, they're used for mod-key indicators.