Vimのヘルプを日本語化 - Debug Your Life // 暮らしをデバッグする。

Vimのhelpって全部英語だから読むのに時間かかるんですよね。

ある程度Vimに慣れるまではヘルプ読む癖をつけるために楽したいなと思ってたらどうやら日本語化できるみたいです。作業に付随して色々と調べたので、メモしておこうかなと。

f:id:debug-your-life:20171225205543p:plain

https://github.com/vim-jp/vimdoc-jaにアクセスして、Clone or downloadってボタンを押すとダウンロード用のリンクが表示されます。 f:id:debug-your-life:20171217120857p:plain gitコマンド用のURLがhttps://github.com/vim-jp/vimdoc-ja.gitだと分かりました。

$ git clone --depth 1 https://github.com/vim-jp/vimdoc-ja.git でvimdoc-jaディレクトリをカレントディレクトリへとダウンロードできます。

Macでは~/.vim以下がデフォルトのVim用ディレクトリらしいです。

一応確認しておきましょう。$ vimでVimを起動した後、:set runtimepath?でruntimepathを表示できます。

runtimepath=~/.vim,/usr/share/vim/vimfiles,/usr/share/vim/vim80,/usr/share/vim/vimfiles/after,~/.vim/after

と表示されましたので、安心して~/.vimをVim用ディレクトリとすることができます。

Vim用ディレクトリを作るのが初めてなので、以下の操作で必要なディレクトリを作成しておきました。

$ mkdir ~/.vim
$ mkdir ~/.vim/doc
$ mkdir ~/.vim/syntax

ダウンロードしてきたvimdoc-jaディレクトリのうち、docディレクトリの中身を~/.vim/docへ、syntaxディレクトリの中身を~/.vim/syntaxへと移動させます。

$ vimでVimを起動した後、:helptags ~/.vim/docでヘルプファイルの更新を行います。

注）:helptagsの取り消しにあたるようなコマンドは見つからなかったことと、~/.vim/docを消したときの挙動から、環境変数などを元に戻したりする手間は発生しづらそうな気がしました。

ヘルプの言語の優先順位を設定します。~/.vimrcにset helplang=ja,enと記述して日本語ヘルプファイルを優先すること、あるいはset helplang=en,jaと記述して英語ヘルプファイルを優先することを明示しておきます。

また、:help@jaのようにすれば、~/.vimrcの記述に関わらず指定した言語でヘルプが表示できます。

Vimのプラグインを管理するためのプラグインマネージャーとやらを導入すると、ディレクトリの構成とか考えなくて済みそうな予感です。

Debug your life!