1. 程式人生 > >Vim中文幫助文件安裝

Vim中文幫助文件安裝

vim自帶的幫助手冊是英文的, 對平時程式設計的人來說沒有多大閱讀困難, 何況還有"星級譯王"呢, 可偏偏有一幫人將其翻譯成了中文, 可偏偏我又擋不住誘惑將它安裝了, 唉.......又痛失一個學習英文的好機會, 下不為例.

下載的檔案包應該是類似這樣的: vimcdoc-x.x.x.tar.gz
解壓後其中有個doc資料夾, 將其中的內容全部複製到~/.vim/doc, 或者vim安裝目錄下的doc目錄中, 此時vim中的help資訊已經是中文的了.
注意:
a. 如果無法顯示中文, 在~/.vimrc中增加下面這句試試:
   set helplang=cn
b. 幫助檔案的文字是utf-8編碼的, 如果想用vim直接檢視, 需要在~/.vimrc中設定:
   set encoding=utf-8

詳細安裝方法:

1).安裝:

Linux:
下載的 tar.gz 包括所有翻譯過的 vim 文件 (.cnx 檔案)。
先將其解壓縮:

  1. tar zxvf vimcdoc-<version>.tar.gz  
然後進入 vimcdoc-<version> 目錄並執行
  1. ./vimcdoc.sh -i  
就可以了。該安裝程式會自動識別 Vim 的安裝路徑,將中文的文件拷貝到相應的地方。原有的英文文件不受影響。

這種方法對 root 和非 root 使用者都適用。但建議以 root 身份安裝。
當以 root 身份安裝時,檔案會被拷貝至 /usr/share/vim/vimfiles/doc下。因此所有系統的使用者都可以使用中文文件。如果你的 vim 是安裝在 /usr/local 下的話,你需要這樣設定 vim 的 runtimepath 選項:

  1. :set rtp+=/usr/share/vim/vimfiles  
你可以將上面的設定加入到你的 vimrc 檔案中以便每次啟動 vim 都生效。
當以普通使用者安裝時,所有檔案會被拷貝至 ~/.vim/doc 下,所以僅對該使用者有效。

Win32:
建議使用已經做好的自動安裝程式。該程式不寫登錄檔,不建立程式組,不覆蓋任何 Vim 原有檔案。所以可以放心使用。

你也可以自己動手來安裝:只要把所有的中文文件以及 tags-cn 檔案拷貝到 runtimepath 之一的 doc 子目錄下就行了。runtimepath 可用在 vim內用
  1. :set rtp?   
命令來得到。比如在 vimcdoc-<version> 目錄中,可以

執行以下命令:
  1. cp -R doc /usr/share/vim/vimfiles/doc  
這種方法對 Linux 和 Win32 都有效。

現在啟動 vim/gvim, 鍵入 :help 看看吧!

2).TIPS:
預設同時安裝 vimcdoc.vim 全域性外掛,該外掛設定預設編碼為 utf-8,並使得每次使用:help 命令時都優先使用中文的幫助文件,有些使用者不願意預設使用 utf-8 編碼,為此可以在安裝時跳過 vimcdoc.vim 外掛。
Linux 可用以下的安裝命令代替:
  1. ./vimcdoc.sh -I  
Win32 的安裝程式也有選項來關閉該外掛的安裝。

如果不安裝 vimcdoc.vim 外掛:
為了每次使用 :help 命令時都優先使用中文的幫助文件,可以將下面這樣幾行加入到你的 vimrc 檔案中:
  1. if version >= 603  
  2.     set helplang=cn  
  3. endif  
也需要注意的是,你的 'encoding' 設定及字型必須支援中文顯示。對於使用非 utf-8中文環境的使用者,在瀏覽某些幫助檔案的時候可能會遇到麻煩。這是因為那些檔案包含無法在 gbk, gb2312 等編碼方式下顯示的字元。遇到這種情況,有以下幾種解決方案:
1. 使用 utf-8 中文環境。例如,將 LC_ALL 設定為 zh_CN.UTF-8
2. 強制 vim 使用 utf-8 編碼。做法是
  1. :set enc=utf-8  
3. 如果你的系統有 GB18030 支援,可以讓 vim 使用 GB18030 編碼,因為 GB18030 對非中文字元也能進行適當的處理。方法是
  1. :set enc=2byte-gb18030  
這時,Vim 會正確地進行轉換。注意這裡不能通過設定 LC_ALL 來完成。
如果使用 2 或 3,建議把 vim 設定寫入你的個人 .vimrc 設定檔案,避免每次都要輸入命令的麻煩。
備註:如果 set enc=utf-8 時,使用的中文訊息出現亂碼,可以同時設定
  1. :language message zh_CN.UTF-8  

3).解除安裝:
Linux:
如果你是使用的自動安裝指令碼安裝的話,只要執行:
  1. ./vimcdoc.sh -u  
即可。但必須用與安裝時同樣的使用者名稱 (root 使用者安裝程式會在/usr/share/doc/vimcdoc 下安裝該檔案)。

Win32:
假定你的 Vim 安裝在 c:\vim 下,在 c:\vim\vimfiles\doc\ 目錄內會有一個 vimcdoc-Uninst.exe,只要執行它就可以了。

4).對於 Vim 6.2及以前版本
對於 Vim 6.2 及以前版本的可以這樣手動安裝中文文件:
1. 下載 vimcdoc-<version>.tar.gz。Win32 的自動安裝程式無效。
2. 解壓縮
3. 將 vimcdoc-<version>/data/doc 下的所有 .cnx 檔案改名為 .txt。
4. 將所有改名後的 .txt 檔案拷貝並覆蓋原有的英文文件。建議先備分原檔案。

5).對於CVS 
不建議使用者直接使用 CVS 來安裝 vim 中文文件。因此,這裡也不提供任何提示。