keyboards/planck/keymaps/jeremy-dev/readme.md

   1 Jeremy Cowgar's Planck Keymap
   2 =============================
   3
   4 I am a programmer by trade and suffer from the beginning stages of RSI. As a programmer, I use letters, symbols and cursor navigation most often. To prevent strange finger gymnastics, I wrote a script to rank which non-letter characters occurred in my primary source projects most often and then placed these characters in the easiest to reach locations, within reason and for me. I made heavy use of momentary layer toggling.
   5
   6 Layers
   7 ------
   8
   9 The key mapping is made up of 5 layers: Letters, Symbols, Navigation, Numbers, and Function Keys.
  10
  11 The layout can be viewed visually at:
  12
  13 http://www.keyboard-layout-editor.com/#/gists/319474e5e2d199e583371ed1d2aec316
  14
  15 * Purple buttons are dual function keys.
  16 * Green buttons are layer momentary toggle keys.
  17 * Red buttons are layer persistent toggle keys.
  18
  19 The keys have multiple symbols:
  20
  21 * Upper left: standard layer, the letter layer
  22 * Upper right: function layer
  23 * Lower left: navigation layer
  24 * Lower right: symbol layer
  25
  26 The symbols in the layout editor are not entirely clear.
  27
  28 The Z and ? keys double as shift keys. Hold for a shift, tap for a Z or ?
  29
  30 The bottom row from left to right:
  31
  32 * Tab when pressed, Control when held. It also is the volume mute key when in the "Navigation" layer
  33 * Function layer momentary toggle
  34 * Number layer momentary toggle
  35 * Symbol layer momentary toggle. When in the "Number" layer, this key also makes the "Number" layer sticky for using the 10 key for quite a bit of entry
  36 * Space
  37 * Backspace when tapped, Option when held
  38 * Delete when tapped, Command when held
  39 * Return
  40 * Symbol layer momentary toggle. When in the "Number" layer, key also is the zero key.
  41 * Navigation layer momentary toggle
  42 * Navigation layer toggle. This was included for when you are browsing a website, document or otherwise wish to stay in navigation mode. When in the "Number" layer, the key is the = symbol
  43 * Escape when pressed, Control when held. When in the "Number" layer, the key is the + symbol
  44
  45 General Notes
  46 -------------
  47
  48 The letter layer is separated by 2 center rows of keys. This spreads the hands out a little further which helps not twist the wrists as much. The 2 center rows are [], (), [], and Ctrl and Alt keys.
  49
  50 The symbol layer keys are accessed by the thumbs. They are the closest to the thumbs, instead of the number toggle, because in my code I found I used symbols much more often than numbers. There are two symbol layer keys because the symbols spread across the right and left half of the keyboard. Thus, some symbols are easier hit with the left hand modifier or right hand modifier.
  51
  52 The number layer key is only accessible by the left thumb because all of the number keys are on the right side of the keyboard. When in the number layer, you can press the key to the right to make that layer sticky when you are going to do a lot of number entry.
  53
  54 The function layer key is only accessible by the left thumb because all of the function keys are on the right side of the keyboard.
  55
  56 The navigation layer key is only accessible by the right thumb because all of the navigation keys are on the left side of the keyboard. You can press the key to the right of the navigation layer to make the navigation layer sticky when you are doing a lot of navigation, reading a web page for example.
  57
  58 When using the number or navigation layers, the same hand that accesses the momentary layer toggle key also has the 4 primary modifiers under their home row.
  59
  60 * Pointer finger is control
  61 * Middle finger is option
  62 * Ring finger is command
  63 * Pinky finger is shift
  64
  65 This is so you can easily press Cmd+Shift+F4 or when navigating, select text or words of text by pressing Shift+Control, for example.
  66
  67 Some keys are duplicated. For example, () are available in easy to reach locations while in the Number layer because they are often used in math.
  68
  69 The symbol layer has additional helpers for programming including a single keys that enter /=, \*=, -=, +=, !=, <>, ||, and &&. It also includes three special Return keys on the left:
  70
  71 * Up CR which moves the cursor up, to the end of the line and then presses CR
  72 * Down CR which moves the cursor to the end of the line and then presses CR
  73 * Right ; which moves the cursor to the end of the line and presses ; for C styled languages, such as JavaScript which is a primary language I use
  74
  75 Word of Warning
  76 ---------------
  77
  78 I have been using the keymap for some time now and believe it to be a good keymap. There are a few things through the week that I wonder if it would have been better if this key were moved to that location.
  79
  80 This keymap may change for further optimization.
  81
  82 Please Give Feedback!
  83 ---------------------
  84
  85 I am very interested in your feedback. Send me a message here on GitHub, r/jcowgar or @jcowgar.