Adopted LAYOUT, added some keys (#5320)
* Add HOME/END keys as upper/lower on arrow-up/down
* Reduce .hex file size by turning off unneeded options
* Put digit keypad onto left hand upon RAISE; this will sometimes be preferable to double-hits of right hand
* Latest super latest version merge
* cbbrowne keymap for XD75re
* starting notes on XD75re keymap plans
* First draft of bottom row of QWERTY
* Switch my special bottom line over to QCENT
* Dunno
* Filling in wanted keys, bit by bit...
* Add copyright, extra macro
* Clean up comments, remove some experimental code I didn't like
* TODO plans for xd75re
* clean up keyboard layout
* QCENT2 is my new experiment for the main keyboard...
* Add a few more main layer keys, and modify LOWER to shift things outwards to conform with main layer
* Clean up RAISE layer to conform with main layer, remove QCENT layer as QCENT2 is the new thing
* More xd75 changes, now that I actually have it in hand
* shift keymap around, as original attempt was a bit too aggressive in keeping to the edges
* more revs to XD75
* Dropping parts of the centre keypad in favor of Keys I Really Need
* Improve documentation to conform with how builds are done now
* Improve documentation to conform with how builds are done now
* Add cbbrowne rules file as alternative to having the rules in Makefile
* Makefile not needed anymore for individual keymap
* Some revs to my keymapping
* Add {}
* Add PGUP/PGDN
* Shifted some middle-range keys around
* Needed Tilde, Backquote, and to shift RESET onto FUNCTION layer
* Wanted ~
* cbbrowne hasn't anything to do with hadron keymaps
* trim unneeded bits
* I prefer OrgMode for my notes
* Have a right-alt
* Layer keys make LED colors change
* Add sample user rules for cbbrowne
* Add source of xd75 rules
* Individualized xd75 rules
* Adopt LAYOUT to genericize the layout as an ortholinear 5x15 keyboard
			
			
This commit is contained in:
		
							parent
							
								
									8c2a23dee1
								
							
						
					
					
						commit
						dbfbe0d7f0
					
				
					 7 changed files with 173 additions and 96 deletions
				
			
		
							
								
								
									
										117
									
								
								keyboards/planck/keymaps/cbbrowne/readme.org
									
										
									
									
									
										Normal file
									
								
							
							
						
						
									
										117
									
								
								keyboards/planck/keymaps/cbbrowne/readme.org
									
										
									
									
									
										Normal file
									
								
							| 
						 | 
				
			
			@ -0,0 +1,117 @@
 | 
			
		|||
* cbbrowne custom keyboard
 | 
			
		||||
 | 
			
		||||
  Due to cbbrowne@acm.org
 | 
			
		||||
  Christopher Browne
 | 
			
		||||
 | 
			
		||||
  This was originally based on the default keyboard map, but I have
 | 
			
		||||
  been doing sundry experimentation:
 | 
			
		||||
 | 
			
		||||
** Useful Experiments
 | 
			
		||||
 | 
			
		||||
 - It made sense to mess around some with keyboard maps.
 | 
			
		||||
   - I added a keypad, originally based on keymaps/numpad.c, but
 | 
			
		||||
     mighty substantially revised, as that one seems to be rotated 90
 | 
			
		||||
     degrees from usual conventions for number pads
 | 
			
		||||
 - The keypad layer also includes some sample "hacks" of cool things,
 | 
			
		||||
   all using actions attached in using the function action_get_macro()
 | 
			
		||||
   - Key [1][2] aka "q" types out my name, cbbrowne, as a fun example
 | 
			
		||||
     of a key generating a bunch of keystrokes.  The keystroke is
 | 
			
		||||
     sufficiently inconvenient that it isn't terribly practical for me
 | 
			
		||||
     to use it, but hey, it shows how others might use this facility
 | 
			
		||||
     in a more useful context.
 | 
			
		||||
   - Key [2][2] aka "a" uses a random number generator to select a digit 0-9 at random
 | 
			
		||||
   - Key [3][2] aka "z" uses a random number generator to select a letter a-z at random
 | 
			
		||||
   - Key [1][3] aka "e" spits out the keymap version number
 | 
			
		||||
  - Trying out sgoodwin's "hold Enter down to get Shift"
 | 
			
		||||
    - Liking this Quite Well Enough...
 | 
			
		||||
    - Applied this to both Shift and Quote
 | 
			
		||||
    - It seems likely that Alt should get a right-hand-side, akin to this...
 | 
			
		||||
    - Alt needs to move, and get a RHS
 | 
			
		||||
      - Hence ALTRIGHT, and shifted ROT_LED over
 | 
			
		||||
      - Emacs likes this!!!  :-)
 | 
			
		||||
    - I'm suspicious that I'll want to shift ROT_LED another location over,
 | 
			
		||||
      so some modifier can replace the OS/KC_LGUI key
 | 
			
		||||
  - I have added an alternate ADJUST layer that is activated via update_tri_layer()
 | 
			
		||||
    - e.g. - LOWER+RAISE simultaneously
 | 
			
		||||
    - This seems entirely more useful for handling my "special keys"
 | 
			
		||||
      like the random numbers, user name, and such, than the keypad layer
 | 
			
		||||
  - The _ADJUST layer provides a good place to have RESET
 | 
			
		||||
    - But this isn't strictly enough; I want RESET somewhat accessible from
 | 
			
		||||
      main layer lest an error hide that layer
 | 
			
		||||
    - I never use the OS/KC_LGUI key (that's Command on MacOS, Windows
 | 
			
		||||
      Key on Windows), so that's a good place to have it as a chord of
 | 
			
		||||
      some sort
 | 
			
		||||
        
 | 
			
		||||
 | 
			
		||||
** Some code structure ideas
 | 
			
		||||
 | 
			
		||||
   Each layer is given a name to aid in readability, which is then
 | 
			
		||||
   used in the keymap matrix below.  The underscores do not denote
 | 
			
		||||
   anything - you can have a layer called STUFF or any other name.
 | 
			
		||||
 | 
			
		||||
   Layer names don't all need to be of the same length, obviously, and
 | 
			
		||||
   you could also skip them entirely and just use numbers, though that
 | 
			
		||||
   means needing to manage the numbers.
 | 
			
		||||
 | 
			
		||||
   It is preferable to keep the symbols short so that a line worth of
 | 
			
		||||
   key mappings fits compactly onto a line of code.  It might be an
 | 
			
		||||
   interesting idea to express the maps rotated 90%, so that you
 | 
			
		||||
   only need to fit 4 symbols onto each line, rather than 12.
 | 
			
		||||
 | 
			
		||||
   I use enums to manage layer IDs and macro IDs so that I don't need
 | 
			
		||||
   to care (beyond "start at 0", and arguably even that's not needed)
 | 
			
		||||
   about their values.
 | 
			
		||||
 | 
			
		||||
** Things I did not like about the default mapping
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
   - I found control too hard to get to.  I use it more than Tab, so
 | 
			
		||||
     switched it there.
 | 
			
		||||
   - Having dash on [lower-j] is a bit nonintuitive, but may be OK
 | 
			
		||||
   - I switched ESC/TAB/M(0) around
 | 
			
		||||
   - I'm suspicious that I want to shift M(0) from [4][1] to [4][2],
 | 
			
		||||
     and shift ESC off the first column so KC_LCTL and KC_LALT can
 | 
			
		||||
     be on the first column.
 | 
			
		||||
   - I needed to swap ' and ENTER
 | 
			
		||||
 | 
			
		||||
** Unuseful experiments
 | 
			
		||||
 | 
			
		||||
I have tried some things out that didn't turn out particularly well.
 | 
			
		||||
I'll note some of these for posterity, hopefully helpful in not doing
 | 
			
		||||
unwise things again...
 | 
			
		||||
 | 
			
		||||
   - I tried added Workman alongside Dvorak and Colemak
 | 
			
		||||
     - Boy, oh boy, these don't help!!!
 | 
			
		||||
     - I have done 30 years of learning of Emacs key mappings, and
 | 
			
		||||
       these alternative keyboards massively mess me up
 | 
			
		||||
 | 
			
		||||
   - Space Cadet Shift; switching L_SHIFT to KC_LSP0, so that when I
 | 
			
		||||
     just hit SHIFT, I get a left parens.  In principle, this is great
 | 
			
		||||
     for Lisping.
 | 
			
		||||
     - Unfortunately, there are times when mouse interfaces use SHIFT
 | 
			
		||||
       to allow selecting multiple items, and this really interferes
 | 
			
		||||
        with that
 | 
			
		||||
 | 
			
		||||
** TODO
 | 
			
		||||
 | 
			
		||||
  - I use tmux quite a lot; the mollat keymap seems to have some
 | 
			
		||||
    interesting helpers.  It might be interesting to add a "tmux
 | 
			
		||||
    layer," or to have a few keys in a layer oriented towards that
 | 
			
		||||
    - Keys for...
 | 
			
		||||
      - Picking windows 0 thru 8
 | 
			
		||||
      - next/prev/new window
 | 
			
		||||
  - The mollat tmux layer also suggests some thoughts about Emacs
 | 
			
		||||
    helpers.    
 | 
			
		||||
  - I do not presently have anything that handles X11 screen
 | 
			
		||||
    switching, as with Control-Alt-various
 | 
			
		||||
  - I ought to probably look into KC_LEAD, to have some key combos
 | 
			
		||||
    that do not need to be concurrent
 | 
			
		||||
  - The jeebak keymap seems to have some neat ideas:
 | 
			
		||||
    - Number layer which is aggressive about having numbers in several places
 | 
			
		||||
    - TouchCursor layer seems interesting
 | 
			
		||||
      - It sets up a layer with cursor keys on the home keys
 | 
			
		||||
  - The jeremy-dev keymap has some very interesting concepts
 | 
			
		||||
    - Shift hands outwards; the special keys go in the center
 | 
			
		||||
    - Symbol layer has some compound keys for C operators like /=, *=, -=, +=, ...
 | 
			
		||||
    - This is likely what I'll use for my XD75re, and maybe I'll fork a
 | 
			
		||||
      planck keymap for similar
 | 
			
		||||
		Loading…
	
	Add table
		Add a link
		
	
		Reference in a new issue