Vimをちゃんと知りたい！だからHelpを日本語化する！

Qiita初投稿です！ [ガイドライン](https://help.qiita.com/ja/articles/qiita-article-guideline) を見ながらやってみようの精神。

# はじめに
Vimを使い始めたのは「どんなサーバーでもだいたい入ってるから」という程度で、かなり安易なものでした。最初は「なんだこれ？」って思っていたキーバインドもすぐに馴染んで、今ではJetbrainsのIDEでもVimのキーバインドを適用しているほど気に入っています。
とはいえ、今までなんとなくVimを使い、なんとなくvimrcを書いていたところがありました。そして気が付きました。**Vimのことを全然知らないということを。。。**

よし！じゃあVimのことを知りましょう！
ということで、この記事では僕がVimを知るためにやったことをメモします。
また、VimのHelpを読み進めるのにあたり日本語化したくなったので、その方法についても記載します。
上述のように**なんとなくでVimを使っていた人**、Vimを使い始めたけど**使い方がよく分からんって思っている人**、**ちょっと興味あるんだけどVimってなに？っていう人**の目に留まればと思います。

# Vimを知る
Vimを知るためには、実際にVimと触れ合うことが大切です。
僕もPC(MacOSX High Sierra:10.13.6)からVimを立ち上げ、を触ってみることにしました。

## まずやること
まずはVimを立ち上げましょう。コマンドラインで`vim`と打ちます。
ちなみに僕のVimバージョンは以下でした。

```terminal
$ vim --version
VIM - Vi IMproved 8.1 (2018 May 18, compiled Oct 29 2018 06:56:05)
macOS version
Included patches: 1-500
Compiled by Homebrew
```

Vimが立ち上がったら、次のように表示されます。
![Vimのファーストビュー](https://qiita-image-store.s3.amazonaws.com/0/280803/0283ae2b-a0d5-e2ee-a361-e37a2b830838.png)
この時点で、Vimは僕らに道を指し示してくれています。さぁ、キーボードで`:help`と入力しましょう！
![help画面:冒頭](https://qiita-image-store.s3.amazonaws.com/0/280803/0b766317-616f-a574-f9c8-49ca02a7d422.png)
英語のヘルプ画面が現れました。まずは操作説明から！
良いですね！僕はやる気に満ち溢れています。どんどん進めていきますよ！
![help画面:ドキュメントリスト1](https://qiita-image-store.s3.amazonaws.com/0/280803/a46e5f0a-d69e-21fb-034b-44493c157e43.png)
ふむふむ、チュートリアルもあるんですね！30分コースですか！良いでしょう！！
`tutor`にカーソルをあわせて`CTRL-]`で飛びます！！
さっそく`CTRL-]`を使えたぞ！楽しい！意味もなく`CTRL-O`で戻ってみたりなんかしちゃいます！！
![tutor画面:冒頭](https://qiita-image-store.s3.amazonaws.com/0/280803/4c486694-feff-d3b6-c421-09ac9e1f62e3.png)
なるほど。この画面ではなく別途`vimtutor`というコマンドがあって、そちらにチュートリアルがあるんですね！

## Vimのチュートリアルを一巡してみる
一旦Vimを`:q!`で閉じ、コマンドラインで`vimtutor`と打ってみましょう。
![スクリーンショット 2019-01-04 3.14.15.png](https://qiita-image-store.s3.amazonaws.com/0/280803/3f89fa31-df51-5ec4-1804-21894c81fe90.png)
おぉ！今度は日本語で表示されました。これは嬉しい誤算！！
※もし日本語で表示されなければコマンドラインを打つ際に`vimtutor ja`と入力してみてください。日本語で表示されるはずです。

`vimtutor`すごく良いですね！！
> このチュートリアルが、使うことで覚えられる仕組みになっていることを、心しておかなければなりません。正しく学習するにはコマンドを実際に試さなければならないのです。文章を読んだだけならば、きっと忘れてしまいます!

と記載がある通り、実際に手を動かして学習することができます。
新しいことを知るって楽しい！！

## チュートリアル完了から新たな一歩を踏み出す
さて、お次は何をすれば良いのか。見てみましょう。
Vimを立ち上げ、`:help`から先程の画面の続きを見てみます。
![help画面:ドキュメントリスト2](https://qiita-image-store.s3.amazonaws.com/0/280803/dbe2fa21-ceea-08ef-30e1-aa6d731fb0ca.png)
ふむふむ。
![help画面:ドキュメントリスト3](https://qiita-image-store.s3.amazonaws.com/0/280803/8c3a603a-6860-5e5f-4100-a7ba2c6eca68.png)
ほうほう。。。
![help画面:ドキュメントリスト4](https://qiita-image-store.s3.amazonaws.com/0/280803/3db79516-5e71-6efa-ba13-43e7d425bd02.png)
。。。

なかなかボリュームがありますね！（1つ1つのドキュメントもなかなか。。。
そして僕は英語力があまり高くないです！

# 日本語化されたVimのHelpを読もう！
英語で全部読むのはちょっと辛いな〜と思ったところで[vim-jp][1]にたどり着きました！
これは良いな！と思い早速[マニュアルのページ](https://vim-jp.org/vimdoc-ja/)を開くことに。
なにやら見たことのある内容ですね！！~~失った~~やる気も上り調子です！！

## vim-jpでhelpを読み始める
英語版で習ったことの確認もしたいので、vim-jpの冒頭から軽く流してみます。
するとあることを思い立ちました。**このサイトVimで開きたいな**と。
実際helpを読み進めるのにVimで開いたほうが都合がいいですし、将来的にもVimを操作している時にサッと日本語化されたhelpを開きたくなるはず。

## Vim上で日本語化されたhelpを開きたい
Vim上で日本語化されたhelpを開く方法を調べてみました。
[Vimヘルプを日本語化！][2]の記事が参考になります。
まずは[vim-plug](https://github.com/junegunn/vim-plug)を入れます。[Installation](https://github.com/junegunn/vim-plug#installation)に記載の内容をもとに、コマンドライン上で以下を実行します。

```terminal
curl -fLo ~/.vim/autoload/plug.vim --create-dirs \
    https://raw.githubusercontent.com/junegunn/vim-plug/master/plug.vim
```

つぎに、[Usage](https://github.com/junegunn/vim-plug#usage)を参考にPluginの設定を書きます。ここでは日本語化したいだけなので、最低限の`Plug`を`~/.vimrc`ファイルに追記します。

```vim:.vimrc
call plug#begin('~/.vim/plugged')
" A project which translate Vim documents into Japanese.
Plug 'vim-jp/vimdoc-ja'
call plug#end()

set helplang=ja,en
```

`set helplang=ja,en`については[vim-jaのwiki](https://github.com/vim-jp/vimdoc-ja/wiki)に以下の記載があります。
> `:help` コマンドで英語のヘルプが表示される場合は日本語の優先順位をあげてください。vimrc に以下を追記します。

vimrcへの設定が完了したら、仕上げです。Vimを立ち上げて`:PlugInstall`と入力しましょう。するとPluginのインストールが始まります。
これで準備は完了です。さぁ`:help`と入力してみましょう！
![日本語化されたHelp画面](https://qiita-image-store.s3.amazonaws.com/0/280803/d214c62b-8add-f80e-860d-37eb130ccedd.png)
日本語化されたHelpが表示されました！皆さんの環境ではどうでしょうか？
これならある程度のボリュームがあっても読み進められそうです。

# おわりに
これでHelpを読むハードルは下がりました。あとはじっくりHelpを読んで、Vimを知っていきたいと思います。
ちなみに僕は上級編あたりまでは読みたいなと考えています。それ以上は必要に応じて。。。

[1]:https://vim-jp.org/
[2]:https://qiita.com/KeitaNakamura/items/b87322d38fef4da3bac5