qmk-keychron-q3-colemak-dh/keyboards/melody96/keymaps/zunger/readme.md

• The "Cadet-Style" keymap for the melody96.
• Author: Yonatan Zunger (zunger@gmail.com)

This is an experimental keymap being used both for practical reasons (as my daily driver) and to work out the ideas of a "space-cadet-style" keyboard which can type text and mathematical symbols with equal ease. It's designed for anyone who frequently needs to do this outside of a LaTeX environment, or for anyone who loves the old "Space Cadet" keyboard! And it works at its best when you have actual Cadet keycaps (like SA Symbolics) installed, because those keycaps will actually show what you get.

The core idea of this keyboard is that, in addition to a QWERTY base layer and a function layer, it supports two additional base layers -- the GREEK layer (the analogue of the Space Cadet "Greek," or "Front," keys) and the CADET layer (the analogue of the Space Cadet "Top" keys). These layers use Unicode to generate all of the mathematical symbols you can find on a traditional Space Cadet layout, plus a bunch of extras.

Because Unicode can't be encoded using the traditional USB HID protocol, QMK does some clever but horrifying things to fool your OS. One consequence of this is that the shift key needs to be handled by the keyboard firmware, not the host OS. To handle this, we have two additional layers -- SHIFTGREEK and SHIFTCADET -- and handle the flipping between all of these layers here in the firmware.

The simple bit: Using this layout on a Melody96

At the core of this layout are three special modifier keys and two special lock keys:

• The GREEK key, to the right of the spacebar, activates the GREEK layer. GREEK+SHIFT activates SHIFTGREEK. These keys generate Greek letters on the letter keys (thus the name), and a few mathematical symbols on other keys. They correspond to the notations on the front of traditional Space Cadet keys; if your capset doesn't include those (alas, most don't), they're the "pretty obvious" mappings.
• The CADET key, to the right of GREEK, activates the CADET layer. These are the symbols above the letters on a Space Cadet layout. CADET+SHIFT activates the SHIFTCADET layer, with even more symbols.
• The FUNCTION key, to the right of CADET, activates the function layer. This is where you have a reset mechanism, a selector for which Unicode input type you want, and so on.

Additionally, GREEK+ALT is equivalent to CADET. This is handy for other keyboards where you don't have room for this many modifiers.

The lock keys are:

• Caps lock, if you use it, will also act as a "shift lock" for the Greek and Cadet layers. Shift lock is slightly different, in that while it is engaged shift will _dis_engage it; that's actually pretty useful when typing math.
• An additional "layer lock" key, by default where "num lock" usually goes, will lock the choice of base layer. To use it, hold down any invocation of the GREEK or CADET layers, or none at all, and hit lock; it will then put you in that layer. The corresponding modifier key will then toggle you back to the QWERTY layer. (So for example, if you hit GREEK+LAYER_LOCK and release them, you're now typing in Greek; the GREEK modifier would cause you to type QWERTY momentarily. To go back to ordinary QWERTY mode, you'd just hit LAYER_LOCK again with no modifiers held)

To see the full layout, check out the big comment in keymap.c.

A less-simple bit: Adapting this to other keyboards

This is really a canary for generic Cadet implementations. Before this can be made generic, a few things will have to happen:

(1) Instead of a fixed keymap, this has to be refactored into some kind of array showing the mappings of QWERTY-layer keys onto the appropriate code points in the GREEK and CADET layers, and some preprocessor magic needs to auto-transform this plus a traditional keymap for the QWERTY layer into keymaps for all five of the core layers. (Function layers would presumably be handled on a per-keyboard basis)

(2) The standard mapping of those should have some #define's to control things like whether there are physical F-keys (you would probably want to move superscript and subscripts onto the numbers if there weren't, and figure out what to do with the non-numeric super/sub keys), whether you actually want to enable GREEK+ALT=CADET, and so on;

(3) There should be support for controlling indicator LEDs based on the base layer selection, caps/shift lock state, and layer lock state, as well as for triggering audio on transitions;

(4) All the core fancy logic in process_record_user which implements the layer handling should be factored out into its own function, so that keyboards can easily reuse that, too.

This is a lovely TODO for future work, and could be particularly fun to go along with new releases of SA Symbolics and the like. Anyone interested in such things, ping me!