keyboards/planck/keymaps/callum/readme.md

   1 # callum’s planck layout
   2
   3 This is a layout for the grid planck, built with a few ideals in mind:
   4
   5 - Consistent and minimal response times should be maintained. Keys that react
   6   differently depending on whether they are tapped or held, keys that react
   7   differently if they are double tapped, etc. should be avoided – they
   8   inevitably send their keycode later than a normal key – interrupting the
   9   immediate feedback from the screen. Therefore we restrict ourselves to
  10   chording as our only means of getting more than one symbol out of a single
  11   physical key.
  12
  13 - The hands should never need to leave the home position. The usual culprit for
  14   this is the arrow cluster, so the arrow cluster should be as close to home as
  15   possible.
  16
  17 - There should be two of every modifier (one on each side), otherwise certain
  18   long key combinations become hard to make.
  19
  20 We have five layers. A `BASE` layer, in colemak; a `MOVE` layer, with an arrow
  21 cluster, other movement keys, and hotkeys; a `SYMB` layer, with numbers and
  22 symbols; a `FUNC` layer, with function keys and media keys; and a `MORE` layer,
  23 with stuff that doesn’t fit anywhere else. The `MORE` layer is activated by
  24 holding the Move and Symb keys simultaniously.
  25
  26 ```
  27 /* BASE
  28  * ,-----------------------------------------------------------------------------------.
  29  * | Tab  |   Q  |   W  |   F  |   P  |   G  |   J  |   L  |   U  |   Y  |   ;  |   -  |
  30  * |------+------+------+------+------+------+------+------+------+------+------+------|
  31  * | Bksp |   A  |   R  |   S  |   T  |   D  |   H  |   N  |   E  |   I  |   O  |   '  |
  32  * |------+------+------+------+------+------+------+------+------+------+------+------|
  33  * | Shift|   Z  |   X  |   C  |   V  |   B  |   K  |   M  |   ,  |   .  |   /  | Shift|
  34  * |------+------+------+------+------+------+------+------+------+------+------+------|
  35  * | Func | Ctrl |  Alt |  Cmd | Symb | Enter| Space| Move |  Cmd |  Alt | Ctrl | Func |
  36  * `-----------------------------------------------------------------------------------'
  37  */
  38
  39 /* MOVE
  40  * ,-----------------------------------------------------------------------------------.
  41  * | H(F7)| H(F8)| H(6) | H(5) | H(4) | H(F9)|H(F10)| Home |  Up  |  End | H(A) |  Esc |
  42  * |------+------+------+------+------+------+------+------+------+------+------+------|
  43  * | H(F3)| H(F4)| H(3) | H(2) | H(1) | H(F5)| H(F6)| Left | Down | Right| Caps |  Del |
  44  * |------+------+------+------+------+------+------+------+------+------+------+------|
  45  * |      | H(0) | H(9) | H(8) | H(7) | H(F1)| H(F2)| Pg Dn| Pg Up|H(F11)|H(F12)|      |
  46  * |------+------+------+------+------+------+------+------+------+------+------+------|
  47  * |      |      |      |      |      |      |      |      |      |      |      |      |
  48  * `-----------------------------------------------------------------------------------'
  49  */
  50
  51 /* SYMB
  52  * ,-----------------------------------------------------------------------------------.
  53  * |  Esc |   1  |   2  |   3  |   4  |   5  |   6  |   7  |   8  |   9  |   0  |   –  |
  54  * |------+------+------+------+------+------+------+------+------+------+------+------|
  55  * |  Del |   !  |   @  |   #  |   $  |   %  |   ^  |   &  |   *  |   (  |   )  |   ’  |
  56  * |------+------+------+------+------+------+------+------+------+------+------+------|
  57  * |      |   ~  |   `  |   +  |   =  |   |  |   \  |   [  |   ]  |   {  |   }  |      |
  58  * |------+------+------+------+------+------+------+------+------+------+------+------|
  59  * |      |      |      |      |      |      |      |      |      |      |      |      |
  60  * `-----------------------------------------------------------------------------------'
  61  */
  62
  63 /* MORE
  64  * ,-----------------------------------------------------------------------------------.
  65  * |      |      |      |      |      |      |      |      |      |      |      |      |
  66  * |------+------+------+------+------+------+------+------+------+------+------+------|
  67  * |      |      |      |      |   £  |      |      |      |      |      |      |      |
  68  * |------+------+------+------+------+------+------+------+------+------+------+------|
  69  * |      |      |      |      |      |      |      |   “  |   ”  |   ‘  |   ’  |      |
  70  * |------+------+------+------+------+------+------+------+------+------+------+------|
  71  * |      |      |      |      |      |      |      |      |      |      |      |      |
  72  * `-----------------------------------------------------------------------------------'
  73  */
  74
  75 /* FUNC
  76  * ,-----------------------------------------------------------------------------------.
  77  * | Reset|  F1  |  F2  |  F3  |  F4  |  F5  |  F6  |  F7  |  F8  |  F9  |  F10 | Vol+ |
  78  * |------+------+------+------+------+------+------+------+------+------+------+------|
  79  * | Power|  F11 |  F12 |  F13 |  F14 |  F15 |  F16 |  F17 |  F18 |  F19 |  F20 | Vol- |
  80  * |------+------+------+------+------+------+------+------+------+------+------+------|
  81  * |      |  F21 |  F22 |  F23 |  F24 |      |      |      |      |      |      |      |
  82  * |------+------+------+------+------+------+------+------+------+------+------+------|
  83  * |      |      |      |      | Prev | Mute | Play | Next |      |      |      |      |
  84  * `-----------------------------------------------------------------------------------'
  85  */
  86 ```