Antigenを使おう

1. Antigenを使おう2015/05/04
三宅 英明(mollifier)

2. 自己紹介
名前: 三宅 英明
Twitter: @mollifier
はてなID: mollifier
神戸のプログラマ

3. 好きなもの
zsh
vim
vimperator

4. ブログとか
はてなブログ
http://mollifier.hatenablog.com/
Twitter
http://twitter.com/mollifier
Qiita
http://qiita.com/mollifier

5. Antigenを使おう
Antigenとは
Antigenをインストールする
Antigenを使ってプラグインをインス
トールする
ちょっと注意

6. Antigenを使おう
Antigenとは
Antigenをインストールする
Antigenを使ってプラグインをインス
トールする
ちょっと注意

7. Antigenとは
Antigenとは、zshのプラグインを管
理するやつ
https://github.com/zsh-users/
antigen

8. Antigenとは
zshプラグインのインストール、更新
ができる
VimのNeoBundleみたいなやつ

9. ありがちなパターン
「zshを使ってる人は、これを入れる
と便利だよ!」
「ほうほう、試してみるか」

10. ありがちなパターン
GitHubからリポジトリをクローンし
て…
% mkdir ~/.zsh
% cd ~/.zsh
% git clone https://github.com/mollifier/cd-gitroot.git

11. ありがちなパターン
~/.zshrcに追記して…
fpath=(~/.zsh/cd-gitroot(N-/) $fpath)
autoload -Uz cd-gitroot

12. ありがちなパターン
めんどくさい
特に、複数のマシンを使ってるとき
は、それぞれでこの作業をする必要
がある

13. ありがちなパターン
久しぶりにノートマシンを使った
ら…「あれ、XXXが入ってないぞ?」

14. ありがちなパターン
どこに何をインストールしたのかを
忘れる
新しいバージョンに更新するのも大
変

15. ありがちなパターン
そんなときはAntigenを使いましょう

16. Antigenを使おう
Antigenとは
Antigenをインストールする
Antigenを使ってプラグインをインス
トールする
ちょっと注意

17. Antigenをインストールする
~/.zshの下にインストールする場合の
例
% mkdir ~/.zsh
% cd ~/.zsh
% git clone git@github.com:zsh-users/antigen.git

18. Antigenをインストールする
その後~/.zshrcにこれを追加する
if [[ -f ~/.zsh/antigen/antigen.zsh ]]; then
source ~/.zsh/antigen/antigen.zsh
antigen apply
fi

19. Antigenを使おう
Antigenとは
Antigenをインストールする
Antigenを使ってプラグインをインス
トールする
ちょっと注意

20. Antigenを使ってプラグインをイ
ンストールする
さっそくzshのプラグインをインスト
ールしてみましょう

21. Antigenを使ってプラグインをイ
ンストールする
antigenの書式
antigen bundle <GitリポジトリのURL>

22. Antigenを使ってプラグインをイ
ンストールする
これをsourceとantigen applyの間に
書く
if [[ -f ~/.zsh/antigen/antigen.zsh ]]; then
source ~/.zsh/antigen/antigen.zsh
antigen bundle https://github.com/mollifier/cd-gitroot.git
antigen apply
fi

23. Antigenを使ってプラグインをイ
ンストールする
ただし、リポジトリがGitHubにある場
合はURLを省略して <ユーザ名/リポ
ジトリ名> と書ける
if [[ -f ~/.zsh/antigen/antigen.zsh ]]; then
source ~/.zsh/antigen/antigen.zsh
antigen bundle mollifier/cd-gitroot
antigen apply
fi

24. Antigenを使ってプラグインをイ
ンストールする
これでsource ~/.zshrcすると、イン
ストール、初期設定をやってくれる

25. Antigenを使ってプラグインをイ
ンストールする
つまり、さっき手でやっていたgit
cloneと、~/.zshrcに追記していた
やつをAntigenが代わりにやってく
れる

26. Antigenを使ってプラグインをイ
ンストールする
あとは、基本的なAntigenのコマンド
# Antigenで管理しているプラグインを一覧表示する
antigen list

27. Antigenを使ってプラグインをイ
ンストールする
# Antigenで管理しているプラグインをすべて更新する
antigen update

28. Antigenを使ってプラグインをイ
ンストールする
# Antigen本体を更新する
antigen selfupdate

29. Antigenを使ってプラグインをイ
ンストールする
これが基本的な使い方

30. Antigenを使おう
Antigenとは
Antigenをインストールする
Antigenを使ってプラグインをインス
トールする
ちょっと注意

31. ちょっと注意
Antigenにはいくつか注意しないと
いけないポイントがある

32. 注意点その1
Antigenでインストールできないプ
ラグインがある

33. 注意点その1
Antigenは万能ではない
基本的には、プラグインの作者が
Antigenに対応した形式で書いて
いるやつだけ使える

34. 注意点その1
対応しているかどうかの見方

35. 注意点その1
リポジトリに「*.plugin.zsh」または
「init.zsh」のどちらかのファイルが
ある
インストールするファイルが、zshの
補完ファイルである
基本的には、この2つのどちらかだ
ったらOK

36. 注意点その1
それ以外は「Antigenで使えること
もある」
使えないこともある
ソースを見ないと、はっきりとは分か
らない

37. 注意点その1
ちゃんとしたプラグインなら
READMEとかに「Antigenでインス
トールするときは…」とか書いてある
ので、それを目安にする

38. 注意点その2
lsにaliasを設定していると、
Antigen本体が正しく動作しないこ
とがある

39. 注意点その2
だめな例
alias ls='ls -F'
けっこうよく使われるalias

40. 注意点その2
対策としては、~/.zshrcの中で順番に
気をつける
if [[ -f ~/.zsh/antigen/antigen.zsh ]]; then
source ~/.zsh/antigen/antigen.zsh
antigen apply
fi
# これなら大丈夫
alias ls='ls -F'

41. 注意点その2
根本的な対策としては、Antigen本
体の方を直す
aliasの設定によって動かなくなるの
は、おかしいでしょう

42. 注意点その2
というわけで、はっきり言って
Antigenの品質は低い
他にもバグがあるかも…

43. 注意点その2
なんかおかしかったら、~/.zshrcか
らAntigen以外の設定を消して試し
てみましょう
それでなおったら、~/.zshrcの中で
書く順番を変えて、なんとかする

44. Antigenを使おう
というわけで、若干使いにくいところ
はあるけど、zshのプラグイン管理は
現状これしかない
手動で管理するよりは便利

45. Antigenを使おう
ぜひ使ってみてください

46. Antigenを使おう
ありがとうございました