沒穿方服

目前看到兩個插件 hypergit、vcscommand 都可以在 Vim 裡直接顯示 diff 結果，前者是 git-diff 型式，後者是 vimdiff 型式（取出舊版內容，再切割視窗作 vimdiff）。我的需求比較接近後者，但又不想裝整支 vcscommand，於是擅自取出原始碼，改寫進 vimrc。

用到的 git 指令

• git rev-parse --show-prefix
  若指令來自 git 的子目錄，輸出該目錄對 .git 的相對路徑。
• git log -1 --format=format:%s\ %n%h' -- '%an' -- '%ai\ '('%ar') HEAD
  顯示 HEAD 所在的一條 log，輸出格式為 [主題] \n[hash 縮寫] -- [作者] -- [日期] ([相對日期])，
  例如 fefe3c8 -- bootleq -- 2010-08-30 18:14:37 +0800 (13 hours ago)
• git show HEAD:some_path/some_file
  顯示 HEAD 中 some_file 的檔案內容。

原始碼

gist: 558647 - [.vimrc] git diff.

功能說明

• GitDiff 指令

  輸入 :GitDiff 即可切割視窗顯示目前檔案的 HEAD 版本，可加一個參數指定更早的 HEAD，例如 :GitDiff 99 取得 HEAD~99 版本。顯示後會進入 diff 模式。另外可用 echo t:git_diff_info 顯示該 commit 的簡易資訊。
  
  註：指令取的 HEAD~ 並無限制「有變更當前檔案」所以可能往前跳好幾個 HEAD 也看不出變化。

• MyDiffOff 指令

  因為預設的 :diffoff 指令可能會把本來的 foldmethod 等 diff 相關選項蓋掉，所以改用 :MyDiffOff 來關閉 diff。
  不過也只是設回我的預設值，沒有真的建立暫存／重設機制。

• GitDiffOff 指令

  進入 :GitDiff 後，用 :GitDiffOff 快速恢復到原始狀態。（目前只支援從兩視窗的狀態復原）

let maplocalleader = ","
noremap  <LocalLeader>, <C-\><C-N>
noremap! <LocalLeader>, <C-\><C-N>

---

早裝早輕鬆的插件

GSession 配合 git branch（不過 Windows 下比較難使用 git）是管理 session 的快樂方案。參考 Vim-Taiwan 上的討論串。
因為多檔編輯需求大，但 session 操作繁瑣，所以認定首要插件就此一支。

---

學會查 help

大量招式（睇 :help quickref）不是單純常用就能學會的，已知指令也值得翻文複習。畢竟軟體演變下來，誰比較懂得善用靠的還是知識。

• 更新 help

  如果 Vim 版本很舊，可考慮更新整個 $VIMRUNTIME（包含 help 以外的各種檔案，所以會花點時間）。
  以下為系統有 aap 支援的情形：

  :!cd $VIMRUNTIME
  :!aap -f ftp://ftp.vim.org/pub/vim/runtime/main.aap fetch

  另外安裝插件等操作動到 doc 檔案時，也需要重建一下 tag（讀 help 時用來 jump 的、類似超連結的東西）

  :helptags ~/.vim/doc

  （其中 ~/.vim/doc 可能是其他位置，即放說明文件的地方）

• 益於求助的 map

  預設 <F1> 等同於 :help 其實不易利用，可改為：

  • 於 normal mode 查詢游標所在單字的說明。
  • 於 visual mode 查詢選取文字的說明，對付 'sb' 這般有引號的項目較方便。
  • 以上若先按 <LocalLeader> 則將說明開在新分頁。

  map  <F1> :help <C-R>=expand('<cword>')<CR><CR>
  map  <LocalLeader><F1> :tab help <C-R>=expand('<cword>')<CR><CR>
  xmap <F1> :<C-U>call RegStash(1)<CR>gvy:let b:tempReg=@"<CR>:call RegStash()<CR>:help <C-R>=b:tempReg<CR><CR>
  xmap <LocalLeader><F1> :<C-U>call RegStash(1)<CR>gvy:let b:tempReg=@"<CR>:call RegStash()<CR>:help <C-R>=b:tempReg<CR><CR>

  （其中 RegStash 來自暫存與還原 register 的 function，也可移掉）

  在 help 文件中，預設可用 <C-]> 跳到游標所在單字的說明（類似超連結），按 <C-O> 和 <C-I> 則是在次次跳轉的位置來回（類似上一頁、下一頁），這裡也可稍微 map：

  • 若檔案唯讀（help 文件皆唯讀），就讓 Enter 也可跳進 tag、BS 也可回上一頁。
  • Alt-Left、Alt-Right 當成上一頁、下一頁使用。

  nnoremap <expr> <CR> &modifiable ? "i<CR><C-\><C-N>" : "<C-]>"
  nnoremap <expr> <BS> &modifiable ? "i<C-W><C-\><C-N>" : "<C-O>"
  nnoremap <M-Left> <C-O>
  nnoremap <M-Right> <C-I>

註：以上只是讓動作變簡單，要真正愛用 help，還是要親身體會、自求多福～

原始碼

gist: 555806 - [.vimrc] simple functions to save/restore position, register or mark.

使用例

:call PosStash(1)   " 暫存目前游標位置
:call PosStash()    " 還原游標位置
:call RegStash(1)   " 暫存目前 register
:call RegStash()    " 還原 register
:call MarkStash(1)  " 暫存目前 mark
:call MarkStash()   " 還原 mark

以下簡陋模擬一個註解用的 text object，方便在 normal mode 按 vac 選取整塊註解（不含空行）；同樣按 dac 刪除、yac 複製。

gist: 554634 - [.vimrc] Simple text object for continuous comment

實作上只判斷每行的第一個非空白字元是否被 syntax highlight 為 Comment，所以並不十分可靠，也僅能做 linewise 的選取。若要改善功能，可考慮導入 'comments'、'commentstring'、'filetype' 等選項（參考 EnhancedCommentify 和 tComment 的做法），不過複雜度的增加也令人卻步。

附 tComment 用的 map，若游標在註解區就反轉整塊註解，否則照常 :TComment。

map <silent><expr> <LocalLeader>ca IsInComment() ? "vac:TComment<CR>" : ":TComment<CR>"