INSTALL

+-----------+
|   NOTE    |
+-----------+
從 6.3 版開始，Vim 加入了對翻譯文檔的支持。本文件所講述的自動安裝
程序僅適用於 Vim 6.3 及以後的版本。如果你使用的是 Vim 6.2 或以前
的版本，建議升級到 6.3 或更高版本。當然，所有翻譯和未翻譯的文件都
是純文本文件，所以你也可以簡單的覆蓋原幫助文件。請參閱下面的
'vim 6.2'一節。


+-----------+
|  UPDATE   |
+-----------+

1.9.0：更新到 Vim 7.4，
1.8.0：更新到 Vim 7.3，
1.7.0：更新到 Vim 7.2，新增 vimcdoc.vim 插件。
1.6.0：更新到 Vim 7.1。
1.5.0：更新到 Vim 7.0。
1.0：  完成 Vim 6.4 全部文檔。


+-----------+
|  INSTALL  |
+-----------+
Linux：
下載的 tar.gz 包括所有翻譯過的 vim 文檔 (.cnx 文件)。
先將其解壓縮：
    tar zxvf vimcdoc-<version>.tar.gz
然後進入 vimcdoc-<version> 目錄並執行
    ./vimcdoc.sh -i
就可以了。該安裝程序會自動識別 Vim 的安裝路徑，將中文的文檔拷貝
到相應的地方。原有的英文文檔不受影響。

這種方法對 root 和非 root 用戶都適用。但建議以 root 身份安裝。
當以 root 身份安裝時，文件會被拷貝至 /usr/share/vim/vimfiles/doc
下。因此所有系統的用戶都可以使用中文文檔。如果你的 vim 是安裝
在 /usr/local 下的話，你需要這樣設定 vim 的 runtimepath 選項：
	:set rtp+=/usr/share/vim/vimfiles
你可以將上面的設定加入到你的 vimrc 文件中以便每次啓動 vim 都生效。
當以普通用戶安裝時，所有文件會被拷貝至 ~/.vim/doc 下，所以僅對該用
戶有效。

Win32：
建議使用已經做好的自動安裝程序。該程序不寫註冊表，不建立程序組，
不覆蓋任何 Vim 原有文件。所以可以放心使用。

你也可以自己動手來安裝：只要把所有的中文文檔以及 tags-cn 文件拷貝
到 runtimepath 之一的 doc 子目錄下就行了。runtimepath 可用在 vim
內用 :set rtp? 命令來得到。比如在 vimcdoc-<version> 目錄中，可以
執行以下命令：
	cp -R doc /usr/share/vim/vimfiles/doc
這種方法對 Linux 和 Win32 都有效。

現在啓動 vim/gvim, 鍵入 :help 看看吧！


+-----------+
|    TIPS   |
+-----------+
缺省同時安裝 vimcdoc.vim 全局插件，該插件設置缺省編碼爲 utf-8，並使得每次使用
:help 命令時都優先使用中文的幫助文檔，

有些用戶不願意缺省使用 utf-8 編碼，爲此可以在安裝時跳過 vimcdoc.vim 插件。
Linux 可用以下的安裝命令代替：
    ./vimcdoc.sh -I

Win32 的安裝程序也有選項來關閉該插件的安裝。

如果不安裝 vimcdoc.vim 插件：
爲了每次使用 :help 命令時都優先使用中文的幫助文檔，可以將下面這樣幾行加入到你
的 vimrc 文件中：
	if version >= 603
		set helplang=cn
	endif

也需要注意的是，你的 'encoding' 設置及字體必須支持中文顯示。對於使用非 utf-8
中文環境的用戶，在瀏覽某些幫助文件的時候可能會遇到麻煩。這是因爲那些文件包含
無法在 gbk, gb2312 等編碼方式下顯示的字符。遇到這種情況，有以下幾種解決方案：

1. 使用 utf-8 中文環境。例如，將 LC_ALL 設定爲 zh_CN.UTF-8
2. 強制 vim 使用 utf-8 編碼。做法是 :set enc=utf-8
3. 如果你的系統有 GB18030 支持，可以讓 vim 使用 GB18030 編碼，因爲
   GB18030 對非中文字符也能進行適當的處理。方法是
   :set enc=2byte-gb18030
   這時，Vim 會正確地進行轉換。注意這裏不能通過設置 LC_ALL 來完成。

如果使用 2 或 3，建議把 vim 設置寫入你的個人 .vimrc 設置文件，避免每
次都要輸入命令的麻煩。

備註：如果 set enc=utf-8 時，使用的中文消息出現亂碼，可以同時設置
  :language message zh_CN.UTF-8


+------------+
|  UNINSTALL  |
+------------+
Linux：
如果你是使用的自動安裝腳本安裝的話，只要運行：
    ./vimcdoc.sh -u
即可。但必須用與安裝時同樣的用戶名 (root 用戶安裝程序會在
/usr/share/doc/vimcdoc 下安裝該文件)。

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


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


+---------+
|   CVS   |
+---------+
不建議用戶直接使用 CVS 來安裝 vim 中文文檔。因此，這裏也不
提供任何提示。