4 This is my personal userspace. Most of my code exists here. I only have one keymap, and that
5 is for an ergodox_ez. There are a lot of layers, 7 of them are default layers. I primarily use
6 dvorak and Bepo. I've been using emacs in vi mode for over 23 years. I also us Xmonad as my
7 window manager, additionally I've been using a Kinesis advantage keyboard in dvorak for over 20
8 years. All of those things tend to color the layouts I have.
10 The Bepo layer needs some love. It is true to the layout at Bepo.fr, but I find it a little
11 cumbersome, and I miss some of my favorite keys.
13 There are 2 dvorak layers, one for a qwerty OS keyboard, and one for a Bepo OS keyboard.
14 There is a symbol/keypad layer for bepo and qwerty. And of course there is a mouse/media layer.
15 There are 2 Xmonad layers one for qwerty and one for Bepo. Layer selection happens automatically
16 based on your current default layer. I use 2 tap dance keys for layer selection.
18 There are also Qwerty, Colemak, Workman and Norman layers for qwerty.
21 Keyboard Layout Templates
22 -------------------------
24 I borrowed the idea for the keyboard defines and some of the definitions from @drashna.
25 I think it is an awesome idea, It makes consistency between layout definitions so much easier.
26 @drashna had this to say about it.
29 This borrows from @jola5's "Not quite neo" code. This allows me to maintain blocks of keymaps in the userspace, so that I can modify the userspace, and this is reflected in all of the keyboards that use it, at once.
31 This makes adding tap/hold mods, or other special keycodes or functions to all keyboards super easy, as it's done to all of them at once.
33 The caveat here is that the keymap needs a processor/wrapper, as it doesn't like the substitutions. However, this is as simple as just pushing it through a define. For instance:
35 `#define LAYOUT_ergodox_wrapper(...) LAYOUT_ergodox(__VA_ARGS__)`
37 Once that's been done and you've switched the keymaps to use the "wrapper", it will read the substitution blocks just fine.
39 Credit goes to @jola5 for first implementing this awesome idea.
45 Keycodes are defined in the ericgebhart.h file and need to be included in the keymap.c files, so that they can be used there. The keymap.c file has very little in it, the most important thing to see there are the keys that are at the ends of each row, ie. the 1st and last key on each row is defined there.
46 Everything else is in ericgebhart.h.
51 The ergodox_ez only has 3 leds, layer indication is pretty lame.
52 Currently the first led lights up if the default layer is not qwerty. The symbol and media layers get
53 the other 2 leds, and all the leds light up if you are on the "layers" layer.
54 I hope I can figure out how to make it better, but I just don't see a way with 3 leds and 11 layers.
60 There are 7 base layers. Dvorak, qwerty, Colemak, Workman, and Norman work on a Qwerty software layer on the OS. Dvorak_on_bepo and Bepo both work on a Bepo software layer on the os.
61 Dvorak on qwerty is the default. There is a function in ericgebhart.c which will allow the keyboard
62 to persist it's default layer through power down. It is currently commented out.
64 I don't actually use Qwerty, but it seemed like I should have it,
65 @drashna had it along with Colemak, Workman and Norman so I added them
66 to my existing dvorak and bepo definitions.
68 There are two tap dance functions that allow switching the default layers
69 and the overlay layers.
71 The default layers switch according to the current OS keyboard of the current Default layer.
72 Shifting the key, causes the selection to use the other OS keyboard selections. ie,
73 if you are on qwerty, you get dvorak, qwerty, colemak, workman and norman. If you shift it you get
74 dvorak on bepo and bepo. If you are not on qwerty the unshifted taps get dvorak and bepo on bepo.
76 The other tap dance for layers is for the symbol, mouse and layers layers. The layers layer is just a
77 safety layer, knowing I can get to if I screw something up...
82 Additionally there is an advanced tap dance called XMONAD_ESC. One tap is Escape, tap and hold is
83 LGUI with the proper XMONAD layer, it is essentially dvorak, for the
84 given OS layer. 2 taps is Shift lgui with xmonad, and 2 taps and hold
85 is Control LGUI with Xmonad. This allows for the finger patterns for
86 Xmonad to remain the same regarless of the keyboard in use. The hold
87 versions allow for secondary menu selection in Xmonad, the 2 tap function
88 must be for a key that is in the top level keymap of Xmonad. This is how
89 many people use xmonad so it's not a real problem. There are plenty of
90 keys combinations to choose from with these choices. The function can
91 be expanded to 3 taps and 3 tap and hold, and on and on....
93 I have a few other special keys, for momentary symbols or shift on the home row of each hand.
95 Also, after using a kinesis for many years I'm very accustomed to the
96 space, enter, backspace and delete keys on the thumbs. I've added control
97 and alt as a secondary function. These are also the Control and Alt keys
103 Additionally there are other tap dance functions, tab-backtab, home-end as well as I few I'm not actually using.
105 Building and flashing
106 -----------------------
108 ```make ergodox_z:ericgebhart``` will compile the code.
110 I use the teensy-loader cli so that's all I know. There is a script here called flash_ergodox
114 ```flash-ergodox <path to your hex file>```
116 then use a paperclip to push the reset button on your keyboard.
118 Switching the OS keyboard
119 -------------------------
121 This varies from system to system. I use Arch Linux, so I use ```setxkbmap```.
122 I've included a helper script which makes it easy to switch between EN and FR Bepo,