[Keymap] initial user directory for milestogo + babblepaste (#7698)

* initial user directory

* fix missing endif in vi mode

* fix includes per drashna and a few typos. I have not tested the userspace keymap, it is just there to help keep the user space and keymap in sync

* move babblepaste docs to md format

* clean up block quotes

* TIL clang-format - miles2go userspace

1 files changed, 207 insertions, 0 deletions

diff --git a/users/miles2go/babblePaste.md b/users/miles2go/babblePaste.md
new file mode 100644
index 0000000000..cc1c31bd0d
--- /dev/null
+++ b/users/miles2go/babblePaste.md
@@ -0,0 +1,207 @@
+## Babblepaste, a universal translator for keyboard shortcuts
+
+The idea is to have one "paste" key do the right thing for any operating system.
+Put the keyboard in Windows mode, and  "paste" means Ctrl-v.
+Switch to Emacs and "Paste" means Ctrl-y.  Mac is GUI-v and so on.
+
+Currently supported modes are Windows, OS X, Gnome/KDE, Emacs, VI , ChromeOS, and Readline, with 70+ common macro actions.
+
+The babblepaste library looks for the current OS in the babble_mode global variable.
+To switch modes, run the switch_babble_mode() function, or a pre defined BABL_DO_x macro.
+
+**BE CAREFUL**
+  * Not all actions are defined for all OSes. The default is to do nothing.
+  * Not all actions are _TESTED_ on all OSes.
+  * Keys can have very different meanings between windows in the same OS. If you switch apps without switching modes, bad things can happen.
+
+###To use the library
+#### Add #defines to your config.h.
+```
+    #define USE_BABBLEPASTE
+    
+    //// Uncomment the modes you want to enable
+    #define BABL_WINDOWS
+    #define BABL_READMUX
+    #define BABL_VI
+    #define BABL_MAC
+    #define BABL_LINUX
+    #define BABL_EMACS
+    #define BABL_CHROMEOS
+    
+    //// These enable subsets of babble macros. Disable options to save space
+    #define BABL_MOVE // Uncomment to add basic cursor movement
+    #define BABL_OSKEYS // This adds Cut, paste, window movement and common OS shortcuts
+    #define BABL_BROWSER // Browser shortcuts
+    
+    //// What Browser shortcuts?
+    #define BABL_BROWSER_CHROME // Chrome browser, Google apps
+    //#define BABL_BROWSER_MS
+    //#define BABL_BROWSER_SAFARI // Safari, Apple defaults.
+    
+    //// applications vary even more between OSes. We'll do our best.
+    #define BABL_APP
+    // To enable specific App options.
+    #define BABL_APP_CELLS // spreadsheets and tables
+    #define BABL_APP_EDITOR // Fancy editor commands
+    #define BABL_APP_WINDOWSPLITTING // splitting frames & windows
+    
+    //// What App keybinding is assumed?
+    //#define BABL_APP_GOOGLE // Google office
+    #define BABL_APP_MSOFFICE // MS office
+    //#define BABL_APP_APPLE // Apple office
+    #define BABL_APP_SUBLIME
+```
+
+#### Enable Babblepaste in your Keymap
+
+Add the following to your keymap in process_record_user, before the main switch statement.
+```
+  #ifdef USE_BABBLEPASTE
+       if( keycode > BABBLE_START && keycode < BABBLE_END_RANGE )  {
+          if (record->event.pressed)  { // is there a case where this isn't desired?
+            babblePaste ( keycode );
+          } else{
+            return true;
+          }
+        }
+  #endif
+```
+
+#### Add makefile rules
+
+Update your rules.mk to include the modes you want.
+
+    `SRC += babblePaste.c babl_windows.c babl_mac.c babl_vi.c babl_readmux.c  babl_chromeos.c babl_emacs.c babl_linux.c`
+
+
+#### Custom Keycodes
+
+If you are using custom keycodes, update the safe range in your user.h
+```
+  #if defined(BABBLE_END_RANGE)
+        #define USER_START BABBLE_END_RANGE
+  #else
+      #if defined(KEYMAP_SAFE_RANGE)
+          #define USER_START KEYMAP_SAFE_RANGE
+      #else
+          #define USER_START SAFE_RANGE
+      #endif
+  #endif
+```
+
+#### Add Babblepaste actions to your keymap.
+See the full list in babblePaste.h, or the list below
+```
+  B_WIN // switch babblepaste to  windows mode.
+  B_MAC // Mac Mode
+  B_LNX // switch to linux
+  B_VI // switch to Vi mode
+  B_EMAX //  switch mode to emacs
+  B_READ // switch to readline /tmux mode
+  B_CROM // switch to chromeos mode.
+
+  #define B_L1C  BABL_GO_LEFT_1C
+  #define B_R1C  BABL_GO_RIGHT_1C
+  #define B_L1W  BABL_GO_LEFT_WORD
+  #define B_R1W  BABL_GO_RIGHT_WORD
+  #define B_GSOL  BABL_GO_START_LINE
+  #define B_GEOL  BABL_GO_END_LINE
+  #define B_GTOP  BABL_GO_START_DOC
+  #define B_GEND  BABL_GO_END_DOC
+  #define B_DOWN  BABL_GO_NEXT_LINE
+  #define B_UP    BABL_GO_PREV_LINE
+  #define B_PTOP  BABL_GO_PARA_START
+  #define B_PEND  BABL_GO_PARA_END
+  #define B_PGDN  BABL_PGDN
+  #define B_PGUP  BABL_PGUP
+  #define B_DEL    BABL_DEL_RIGHT_1C
+  #define B_DLW    BABL_DEL_LEFT_WORD
+  #define B_DRW    BABL_DEL_RIGHT_WORD
+  #define B_DEOL  BABL_DEL_TO_LINE_END // delete from cursor to end of line
+  #define B_DSOL  BABL_DEL_TO_LINE_START // delete from cursor to begining line
+  #define B_MODE   BABL_MODE //type out name of current mode.
+
+  #define B_UNDO    BABL_UNDO
+  #define B_REDO    BABL_REDO
+  #define B_CUT     BABL_CUT
+  #define B_COPY    BABL_COPY
+  #define B_PASTE    BABL_PASTE
+  #define B_SELALL    BABL_SELECT_ALL
+  #define B_SELA    BABL_SELECT_ALL
+  #define B_FIND     BABL_FIND
+  #define B_FINDN    BABL_FIND_NEXT
+  #define B_FINDP    BABL_FIND_PREV
+  #define B_RPLACE    BABL_FIND_REPLACE
+  #define B_RUNAPP    BABL_RUNAPP
+  #define B_NAPP  BABL_SWITCH_APP_NEXT
+  #define B_PAPP  BABL_SWITCH_APP_LAST // previous
+  #define B_CAPP  BABL_CLOSE_APP
+  #define B_HELP  BABL_HELP
+
+  #define B_NTAB  BABL_BROWSER_NEW_TAB
+  #define B_CTAB  BABL_BROWSER_CLOSE_TAB
+  #define B_ROTB  BABL_BROWSER_REOPEN_LAST_TAB
+  #define B_NXTB  BABL_BROWSER_NEXT_TAB
+  #define B_PTAB  BABL_BROWSER_PREV_TAB
+  #define B_NURL  BABL_BROWSER_URL_BAR
+  #define B_BFWD  BABL_BROWSER_FORWARD
+  #define B_BBAK  BABL_BROWSER_BACK
+  #define B_BFND  BABL_BROWSER_FIND
+  #define B_BOOK  BABL_BROWSER_BOOKMARK
+  #define B_BDEV  BABL_BROWSER_DEV_TOOLS // hard one to remember
+  #define B_BRLD  BABL_BROWSER_RELOAD
+  #define B_BFULL BABL_BROWSER_FULLSCREEN
+  #define B_ZIN    BABL_BROWSER_ZOOM_IN
+  #define B_ZOUT  BABL_BROWSER_ZOOM_OUT
+
+  #define B_PASTV BABL_APP_PASTE_VALUES
+  #define B_CALN  BABL_APP_CENTER_ALIGN
+  #define B_CFMT  BABL_APP_CLEAR_FORMATTING
+  #define B_SCLA  BABL_APP_SCROLL_ACTIVE_CELL
+  #define B_NCEL  BABL_NEWLINE_IN_CELL
+  #define B_IPRW  BABL_INSERT_ROW_ABOVE
+  #define B_ICOL  BABL_INSERT_COL_LEFT
+  #define B_IROW  BABL_INSERT_ROW
+  #define B_DROW  BABL_DELETE_ROW
+  #define B_SELC  BABL_SELECT_COL
+  #define B_SELR  BABL_SELECT_ROW
+
+  #define B_MSEL    BABL_APP_MULTI_SELECT
+  #define B_VSPLIT  BABL_SPLIT_FRAME_VERT
+  #define B_VUNSPT  BABL_UNSPLIT_FRAME_VERT
+  #define B_HSPLIT  BABL_SPLIT_FRAME_HORIZONTAL
+  #define B_HUNSPT  BABL_UNSPLIT_FRAME_HORIZONTAL
+  #define B_NXTFM   BABL_NEXT_FRAME
+  #define B_PRVFM   BABL_PREV_FRAME
+```
+
+
+## Development FAQs
+
+**Todos**
+eeprom store state of babble_mode? or update docs so that people can change the order of the enum in
+babblespace.h?
+
+**You have huge ifdef stanzas instead of functions**
+This fails gracefully if you don't have all options defined. Patch if you can think how to use fewer defines.
+
+** Why not an array of arrays as a lookup instead of a function?**
+This would allow you to store the lookup table in PROGMEM.
+True, but that takes more pre-processor skill than I have, and may be less portable to ARM or other flash mappings.
+
+** Have you tested every key on every platform?**
+No. Be careful, submit a patch.
+
+** Why not update Apps at the same global level as the OS? **
+This is only a good thing if it doesn't confuse the user. If you can show state of OS vs App, it's probably a good thing.
+
+** Can the OS tell the keyboard what mode to use? **
+The keyboard side is easy to do with virtser_recv & a function that updates babble_mode. It still needs a PC side app to track where the keyboard focus is.
+One could use a keyboard macro to launch an app & switch modes for that app.
+
+## Thanks
+
+Thanks to [wikipedia shortcuts page](https://en.wikipedia.org/wiki/Table_of_keyboard_shortcuts)
+and [Jeebak's keymap](https://github.com/qmk/qmk_firmware/blob/master/keyboards/planck/keymaps/jeebak/keymap.c)
+this [howtogeek shortcuts page](https://www.howtogeek.com/115664/42-text-editing-keyboard-shortcuts-that-work-almost-everywhere/)
+And of course QMK...