fix mac ver obsolete document

Author: 墨航

README.md

@@ -0,0 +1,96 @@
+# Capslock Enhancement Design
+
+⇪CapsLock，即大写锁定键，其起源可追溯至打字机时代。打字机是纯机械的设备，当按下Shift时，整套设备会与墨条纸带发生位移，使小写字母“上档”为大写字母。此等操作对小拇指是不小的负担，以致连续输入两到三个大写字母都比较吃力。于是在今天键盘上⇪Capslock的位置上出现了其原型Shiftlock功能键：可以在大小写状态之间切换与保持。这样的设计解决了一指禅选手的困境，更减轻了打字员的负担。
+
+然而随着科技的进步，这样的问题已经不存在了。除了一指禅选手，Shift能够毫不费力的满足人们的需求。而⇪Capslock这个'多余'的按键，则因为历史惯性保留在了绝大多数键盘的黄金位置。
+
+历史上有很多人注意到了这一点，不少人都琢磨着让这个占据宝地的按键发挥出更大的作用。一些键盘直接去掉了⇪Capslock键，而另一些则直接把它作为⌃Ctrl使用。在一些Unix Like（e.g ）环境中，⇪Capslock还被用作语言切换的按键。有些人将⇪Capslock改为复合功能键：单独键入时是⎋ESC，而按住不放时是⌃Ctrl。
+
+不过为什么要浪费这样一个绝佳的机会呢？我们所能做的远比这更多：
+
+譬如创造一个类似⇧ Shift、⌃ Ctrl、⌥ Option、⊞ Win、⎇ Alt 、 ⌘ Command等修饰键的全新功能键：
+
+​										✱ Hyper
+
+## Design
+
+1. `CapsLock`单独按下与长按的区分
+
+   传统上扩展`Capslock`，要么是将其语言切换，要么是将其作为`Control`。但其实这两个功能并不矛盾，一个是单按触发，一个是按下时触发，所以完全可以合并在一起。
+
+   单独按下Capslock时，会触发**语言切换**功能，按住不放时，则激活一个新的功能键`Hyper`，替代传统的`Ctrl`实现更多更丰富的定制功能。当然，另一种做法是将单独按下改造为`ESC`，这就要视需求选择了。
+
+2. 导航键
+
+   导航键包括：`↑`,`↓`，`←`，`→`,`Home`,`End`,`PgUp`,`PgDn`，提供了一套通用的光标移动操作。不过这些键都远离核心键区，导致移动光标需要把右手移开，这一点煞是恼人。最好是将这些导航键映射到右手的核心键区，通过按下`Capslock`键启用，同时需要在移动光标的同时，对文本选取的功能（`Shift`）提供良好支持。
+
+   按下Capslock时，传统的VIM导航键`h,j,k,l`映射为方向键，而将这四个键上方的`u,i,o,p`分别映射为`PageUp`,`Home`, `End`,`PageDown `，提供全局的导航操作。另一方面，因为按下左手需要按下`Capslock`，右手需要控制导航键，都不适合按下两侧的`Shift`键进入文本选择模式，这时候比较好的选择是由左手大拇指同时按下⌘(Mac)或Alt(Win)，将组合键映射为导航键+`Shift`提供文本选取支持。
+
+   这样，vim的导航不仅可以在vim的所有模式中使用，也可以在系统中全局使用了。
+
+3. 删除键
+
+   删除是极其频繁的功能，包括前删（BackSpace）与后删（Delete）。不过Mac和Windows的操作不太一致有些恼人，而且这两个键也都是远离核心键区操作不便。
+
+   将`Capslock`+`nm,.`映射到不同的删除功能上，首先这四个键在`h`,`j`,`k`,`l`正下方，操作非常方便。`Hyper + m`映射为前删`Delete`(Mac)或退格`BackSpace`(Win)，`Hyper+ ,`设计为后删`ForwardDelete`(Mac)或`Delete`(Windows)。同时`n`和`.`则映射为相应的按下`Option`(Mac)或`Ctrl`(Win)的版本，即前删后删一个单词，类似vim的`dw`与`db`，提高长句删除效率。
+
+   这样一来，Mac与Windows的删除行为终于保持一致了，而且删除功能由右手最为灵活的食指和中指负责操作，能大大提高编辑效率。
+
+4. 上档键
+
+   上档是CapsLock的传统功能。但通常Capslock对第二排数字键不起作用，这里不妨反其道行之，将Capslock+数字键映射为对应的上档符号，当然也可以考虑映射为其他的一些命令，例如IDE调试命令，配置切换命令等。同时，一些编程中的高频符号，比如括号，下划线，等于号，也可以从右上角拉下来，放到核心键区。
+
+   比如`CapsLock+; : _` ，`Capslock + ' : =`，`Capslock + [ : (`，`Capslock + ] : )`。这样一来，高频符号下划线和等号就可以方便的录入了，而圆括号映射到方括号这里，让小中大括号一家终于团聚在一起，也减少了输入圆括号的手指位移。
+
+5. 窗口控制
+
+   除了切换应用程序窗口`⌘Tab`(Mac), `Alt+Tab`（Win）外，还有许多经常用到的窗口操作：譬如关闭窗口（关闭应用程序），关闭标签页，切换标签页等。
+
+   CapsLock+Q是Quit，关闭窗口的意思，映射到`⌘Q`(Mac)或`Alt+F4`（Win）。
+
+   CapsLock+W是关闭当前标签，映射到`⌘W`(Mac)或`Ctr+W`(Win)
+
+   CapsLock+S是Switch的意思，切换当前标签页，映射到`^Tab`(Mac & Win)。
+
+   CapsLock+A是两个挨着的键，一起按就是另一个窗口管理软件的Moom的meta-key。可以方便的缩放摆弄窗口，很好用。
+
+   这几个快捷方式非常常用，在IDE或者浏览器里都很方便。
+
+6. Bash控制
+
+   在Bash中，我们习惯Capslock作为Ctrl使用。但是最常用的，必不可少的其实只有几个：
+
+   CapsLock+Z映射到`^Z`，用于发送SIGTSTP挂起作业。
+
+   CapsLock+X映射到`^B`，是终端复用软件Tmux的metakey。
+
+   CapsLock+C映射到`^C`，用于发送SIGINT中断作业。
+
+   CapsLock+V映射到`,`，是Vim的`<Leader> key`,不过也可以作为应用按键
+
+   CapsLock+D映射到`^D`，用于发送`EOF`
+
+   当然，在Windows下面，这些键可以作为传统的编辑键：撤销，剪切，拷贝，粘贴……
+
+7. 媒体控制：
+
+   在没有`Fn`的外接键盘上如何使用Mac的传统功能键？用`Hyper+FX`解忧愁。Capslock+F1就是调低亮度，依此类推。
+
+8. 应用快捷键：
+
+   应用快捷键应当可以用一只手就轻松按出，这也限制了应用快捷键所能使用的键区。基本上适合作为应用快捷键的按键就是左手食指覆盖的键区了。
+
+   这里`ERTYFGB`作为应用快捷键，加上⌘总共可以设置14个高频应用程序的快捷方式。这里是我的设置：
+
+   `Hyper-E： Google Chrome.app`，`Hyper-⌘E: Finder`，E取自Explore的涵义。
+
+   `Hyper-R: iTerm`，`Hyper-⌘R: Ctrl+R (Run)`，R取自Run。
+
+   `Hyper-T： Sublime Text.app`，`Hyper-⌘T: Typora`，T取自Text，放置了常用的文本编辑器。
+
+   `Hyper-F： Dash.app`，`Dictionary`，F取自Find的涵义。最常用的查询软件。
+
+   `Hyper-G： IntelliJ IDEA.app`，`Hyper-⌘G: Clion`，G就是`Great`的意思，所以放了IDE
+
+   `Hyper-B`可以放一些别的东西，目前当做了呼叫Emoji窗口的快捷键(`^⇧Space`)。
+

design.md

@@ -1,45 +1,40 @@
-# CapsLock (karabiner-element)
+# Capslock (Mac OS X) 
 
-* **Good News! [Karabiner-element](https://pqrs.org/osx/karabiner/) now works on MacOS 10.13 High Sierra. ** [Download](https://pqrs.org/osx/karabiner/files/Karabiner-Elements-11.1.0.dmg)
-* I upgrade My [CapsLock](https://github.com/Vonng/Capslock) karabiner configuration to newer `JSON Format`。
 
 
+## Notice
 
-## Install
-
-* You can put the json file into karabiner's config directory manually:
-
-```bash
-mkdir -p "${HOME}/.config/karabiner/assets/complex_modifications/"
-cp ./capslock.json "${HOME}/.config/karabiner/assets/complex_modifications/capslock.json"
-```
+* Capslock for Mac is based on `karabiner` (and `seil`). But Karabiner **does not** work on **macOS Sierra(10.12)** at the moment. 
+* It **works well** on EI Capitan(10.11) and Yosemite(10.10).
 
-* OR you can **[Click Here](karabiner://karabiner/assets/complex_modifications/import?url=https://raw.githubusercontent.com/Vonng/Capslock/master/mac-new/capslock.json) to open Karabiner-Element and auto import it !**。
 
-```
-karabiner://karabiner/assets/complex_modifications/import?url=https://raw.githubusercontent.com/Vonng/Capslock/master/mac-new/capslock.json
-```
 
 
+## Install
 
+* Step 1:   Download [`seil`](https://pqrs.org/osx/karabiner/seil.html.en) and install
+* Step 2:   Download [`karabiner`](https://pqrs.org/osx/karabiner/) and install.
+* Step 3:   Change capslock's keycode to 80 using `seil`
+    ![](images/seil-usage.png)
+* Step 4:   `karabiner`
+    * Switch to `Misc & Uninstall` panel.
+    * Click `Open private.xml` button.
+    * Copy and overwrite file: `private.xml`.
+      ![](images/karabiner-usage.png)
+* Step 5:   
+    * Switch back to `Change Key` panel
+    * Click `Reload XML`
+    * Enable functions you like :)
+      ![](images/karabiner-ui.png)
 
 
-* See [Karabiner-Elements Sample Scripts](https://github.com/pqrs-org/KE-complex_modifications) for instructions:
-  * Open `karabiner-elements`
-  * Select tab `Complex Modification`
-  * Click `Add item` at bottom
-  * Choose function you like.
-  * Remember:  Press CapsLock alone can be mapped to language-switcher(system-default) or escape (vimer-evangel). **But you can not enable both simultaneously.**
+Enjoy~ 😁
 
 
 
 ## Usage
 
-Hold Capslock, it always work as a `Hyper Key`, For single press, you may only choose only one of `Escape` and `Languag-Switcher`.Design and functionality describes [here](https://github.com/Vonng/Capslock)
-
-
-
-![](https://github.com/Vonng/Capslock/raw/master/mac/images/keyboard-layout.png)
+![](images/keyboard-layout.png)
 
 
 
@@ -94,15 +89,16 @@ Hold Capslock, it always work as a `Hyper Key`, For single press, you may only c
 
 Maybe you'd like overwrite these with your own favorite apps.
 
-* `✱E  ↦ Safari`
+* `✱E  ↦ Google Chrome`
 * `✱⌘E ↦ Finder`
 * `✱R  ↦ iTerm`
 * `✱⌘R ↦ ^R (IDE-Run)`
-* `✱T  ↦ Visual Studio Code`
-* `✱⌘T ↦ Typora`
+* `✱T  ↦ Typora`
+* `✱⌘T ↦ MWeb`
 * `✱F  ↦ Dash`
 * `✱⌘F ↦ Dictionary`
 * `✱G  ↦ IntelliJ IDEA`
+* `✱V  ↦ Visual Studio Code`
 
   ​
 
@@ -120,9 +116,6 @@ Maybe you'd like overwrite these with your own favorite apps.
 * `✱F10 ↦  Mute`
 * `✱F11 ↦  VolumeDown`
 * `✱F12 ↦  VolumeUp`
-* `✱F13(PrintScreen)  ↦  MusicPrev`
-* `✱14(ScrollLock)  ↦  MusicNext`
-* `✱F15(Pause)  ↦  MusicPlay`
 
 #### Shifter
 
@@ -140,20 +133,24 @@ Maybe you'd like overwrite these with your own favorite apps.
 * `✱ScrollLock  ↦ VolumeMute` (Mute)
 * `✱Pause       ↦ MusicPlay` (Music play)
 
-#### Misc
+#### Cursors
 
-- `✱⎋  ↦ ⇪`       (Escape turn ✱Hyper backs to ⇪CapsLock)
+* `✱↑ ↦ MouseUp`
 
-- `✱␢   ↦ ⎋`      (Space maps to ⎋ESC)
 
-- `✱\  ↦ ⌃/`       (Back slash maps to comment [IDE shortcut])
-
-- `✱;  ↦ ⇧-  '!' `  (Semicolon to exclamation)
-
-- `✱'  ↦ =`           (Single quote to equal)
 
-- `✱~    ↦ ⌃⇧⌘4`  (tilde to area screenshot to clipboard)
+* `✱↓ ↦ MouseDown`
+* `✱← ↦ MouseLeft`
+* `✱→ ↦ MouseRight`
+* `✱↩ ↦ MouseLButton`
+* `✱\ ↦ MouseRButton`
 
-- `✱⌘ ↦ ⌃⇧4` (ScreenShot by area to desktop picture)
+#### Other
 
-  ​
+- `✱⎋  ↦ ⇪`       (Escape turn ✱Hyper backs to ⇪CapsLock)
+- `✱␢   ↦ ⎋`      (Space maps to ⎋ESC)
+- `✱\  ↦ ⌃/`       (Back slash maps to comment [IDE shortcut])
+- `✱;  ↦ ⇧-  '_' `  (Semicolon to lodash)
+- `✱'  ↦ =`           (Single quote to equal)
+- `✱~    ↦ ⌃⇧⌘4`(tilde to area screenhot)
+- `✱⌘~ ↦ ⌃⇧4`  (⌘tilde to area screenhost to clipboard)

mac-new/setup

@@ -0,0 +1,4 @@
+#!/bin/bash
+
+cp ./private.xml "${HOME}/Library/Application Support/Karabiner/private.xml"
+echo "${HOME}/Library/Application\ Support/Karabiner/private.xml" Done