これはVim Advent Calendar 2018 その2の１４日目の記事です。
この記事の概要
まずは一句。
ビムヘルプ
使ってみると
あら便利
vimの:helpがよくできていることに最近、今更ながらに気づきました(おそすぎる)。
この記事は私と同じように、まだ:helpを読んでいなかった方の、その背中を押すような内容となります。
というわけで、まずはVimの:helpのどこがよくできるかについて三点、簡潔に書いていきます。
(本当はもっとありますが)
vim :helpがユニークな3つのポイント
1. 基本的に両手をキーボードから離さずにドキュメントを読み進められる
両手をキーボードに置いたまま、ドキュメントを自由に読み進めていけるのは本当に素晴らしい体験です。そして、vimを使う楽しさも併せて感じさせてくれます。
ドキュメントを読み進めていくうちに、操作にも慣れてきて、さらに素早くドキュメントの中を駆け回れるようになる...するともっと楽しくなって、気づくと、もうvimの虜
2. ページ間の移動が爆速(ローディング時間なし)で、ストレスフリー
ドキュメント自体がローカルにあるというのが要因なのですが、待ち時間なしでドキュメント内を移動できるというのは本当に素晴らしい体験だということを改めて感じさせてくれるのが、このvimの:helpの素晴らしいところ。
気になる事柄を瞬時に検索できます。
3. 読んだ傍から実践できる
ドキュメントを見たそばから学んだことを実践できるなんて、そんな素晴らしいことがあるでしょうか！?vimを深く知ろうと思うモチベーションにもなりますし、vimのドキュメントはそういう意味からもよく考えられているなと思った次第。
:helpの歩き方
では早速実践。
:help、:hでヘルプが起動します。
また、:h terminalなどで知りたい内容についてのhelpを直接開けます。:h | onlyと打つことで最初から画面を分割せずにヘルプを開けます。
後述しますがfzf.vimのセットアップが完了していれば:Helptagsと打つと、いい感じにvimで:help内のコンテンツを検索できます。
:helpの使い方についてはhelpのトップによく書かれているので、これを読み込んでおけばまず問題ないと思います。
と、これだけだと、流石に味気ないので、よく使うことコマンドと用途を下に書きます。
まずはこれだけ認識して、ひとまずヘルプの中を歩き回ってみると楽しい気分になれます。
よく使うコマンド
文字通り項目ジャンプ
* Ctrl+] -> 項目へジャンプ
* Ctrl+T, Ctrl+O -> 元の場所へ戻る
ジャンプしたい項目のタグへ移動するために
* W(Shiftありなし、どちらも) -> 次の単語の先頭にジャンプ
* B(Shiftありなし、どちらも) -> 直前の単語の先頭にジャンプ
サクサクーっと流し読み用途で主に使う
* Ctrl+D -> 半画面下へ移動
* Ctrl+U -> 半画面上へ移動
気になるワードは検索かけて調べる。検索もキーボードから手を離さなくて良いので便利
* /{検索ワード} -> 文字通り検索
以上のようなコマンドを主に使いながら、気になる項目のタグ上で(※)、Ctrl+]を押してその項目に飛び、そこから説明を読み進めて、また気になるタグがあればさらに飛んで...という形で際限なく読み進めていくことができます。
(※実際に見てみると分かりますが、タグはそれと分かるように文字の色が変わっています)
先ほども書きましたが。help自体の動作も軽く、Ctrl+]打つと瞬時に項目へジャンプが完了するので、結構サクサク読み進められて、それがまた快感だったりします。
ある種の読書体験として非常にクオリティの高いものを提供しているのではないでしょうか？
ウィンドウ分割して、複数の内容を一度に参照できるのも便利です。
vim :helpを読むための敷居を下げる3つの事柄
ここまでで、今まで:helpを読んだことのない方にも、少しはvim :helpに興味を持っていただけたのではないでしょうか？
ここから、より:helpを読んでみようと思えるかもしれない事柄を3つ書いていきます。
1. Docker上に最新のVimを構築し、:helpを日本語で読んでいく
せっかく:helpを読んでいくなら、最新のvimをビルドしたてで読んでいきたいですよね。
ただこの場合、:helpは英語となっています。
でも、日本語で読みたい方も多いですよね。
というわけで、最新のVim環境をローカルに構築し、日本語ドキュメントを表示させる方法を下に記載していきます。
手頃に試せるvim環境がない方、vimに興味なかったけど...なんか試してみようかなって方は、下記のリポジトリを参照することで、環境を汚さずに気軽にローカルのdocker上で最新のvim環境を試すことが可能です。
(ただしDocker環境は必要ですがね。また、dockerのインストールについてはここでは触れません。)
このリポジトリ自体は、元は自身が最新のvim環境で色々と気軽に試せるように作ったものです。
最新のvimのみをインストールしたdocker imageが出来上がります。
https://github.com/shinshin86/vimrc-dev-starter-kit-at-docker
# セットアップ
git clone https://github.com/shinshin86/vimrc-dev-starter-kit-at-docker.git
cd vimrc-dev-starter-kit-at-docker
docker build -t vimrc-dev .
docker run -it--rm--name vimrc-dev-01 vimrc-dev /bin/bash
上記手順を行った後、vimと打つと最新のVimが立ち上がるかと思います。
(ちなみにmac上でしか動作検証していないので、もし動かないなどあればコメントかgithubにissue飛ばしてもらえると幸いです。)
ちなみにこの状態でvimから:helpと打つと英語のhelpが立ち上がるかと思います。
ここから:helpの日本語化を行っていきます。
日本語で表示するためのプラグインを使います。
プラグイン管理にはvim-plugを使うことにします。理由は特にありません。
https://github.com/junegunn/vim-plug
# curlインストール
apt-get install-y curl
# vim-plugインストール
curl -fLo ~/.vim/autoload/plug.vim --create-dirs\
https://raw.githubusercontent.com/junegunn/vim-plug/master/plug.vim
次に~/.vimrcに下記の内容をコピペします。
""""""""""""""""""""""""""""""" プラグインセットアップ""""""""""""""""""""""""""""""call plug#begin('~/.vim/plugged')" 日本語help
Plug 'vim-jp/vimdoc-ja'call plug#end()""""""""""""""""""""""""""""""set encoding=utf-8set helplang=ja,enあとはvimを起動させてから:PlugInstallと打てば、セットアップ完了です。:hと打って日本語のhelpが表示されることを確認してください。
2. fxf.vimを使って、より本能的に:helpの中を駆け回る
より高速に:helpを駆け回るために、fzfを使用してみようと思います。
fzfの説明はたくさん出ているので、検索してみてください。
例えば下記の記事など(実体験談)
https://qiita.com/kamykn/items/aa9920f07487559c0c7e
では、先ほどのDocker内で作業していきます。
# fzfをインストール
git clone --depth 1 https://github.com/junegunn/fzf.git ~/.fzf
~/.fzf/install
source ~/.bashrc
fzfをvimから使うために、fzf.vimをvim-plugにてインストールします
Plug 'junegunn/fzf',{'dir':'~/.fzf','do':'./install --all'}
Plug 'junegunn/fzf.vim'再びvimを起動して、:PlugInstallでfzf.vimの設定が完了します。
そして:helpを開き、:Helptagsと打つことで、より効率的にHelp内のtagsを検索できるようになります。
(別に:helpを開いていなくとも、:Helptagsで開けるので困ったときにも便利。)
例えばchannelの何かしらについて知りたいと思ったら、:Helptagsと打ち、channelと打ったあたりで候補がずらずらと出てきます。
目的もなく見ているだけでも結構楽しめます。
3. vim - help関連の面白そうな記事を読んで、いろんな楽しみ方を知る。
今回アドベントカレンダーで:help関連のことを書こうと思ったとき、試しにvim helpで検索をしてみたら、素晴らしいhelp関連の記事がたくさん見つかりました。
(それはもう、helpのポストをやめようと思うぐらいに素晴らしい記事が沢山...)
その中でいくつかの興味深い記事をこちらに貼ります。これを見ると、:helpを読むためのモチベーションがさらにアップするでしょう。
http://haya14busa.com/reading-vim-help/
http://nanasi.jp/articles/howto/help/vim_help.html
http://blog.textfile.org/20140228/vim/
https://qiita.com/from_kyushu/items/b3cb5c721b2ab5e029c4
最後に
駆け足ですが、vimの:helpの面白いところ・興味深いところについて好き勝手に書かせてもらいました。
上に載せたDocker imageですが、失敗しても気軽に構築できる点を利用して、vimrcをいろいろいじりながら:helpを開いてみるのも面白いかもしれません。
というわけで、皆様、年末も良いVimライフを!