fisher/docs/jp-JA
Jorge Bucaran 59000414e8
Docs.
2016-05-14 14:17:27 +09:00
..
README.md Docs. 2016-05-14 14:17:27 +09:00

Build Status Slack

fisherman

fisherman とは fishのための並列処理パッケージマネージャーです。

理由

  • 設定なし

  • 依存性なし

  • フィッシュシェルのスタート時間に関係ない

  • cli から利用可能であり、vundle のようにも使える

  • 基本のコマンドは install、update、remove、list と help だけ

インストール

curl:

curl -Lo ~/.config/fish/functions/fisher.fish --create-dirs git.io/fisherman

使い方

プラグインをインストール:

fisher real

様々な所からもインストール:

fisher z fzf edc/bass omf/thefuck

URL からインストール:

fisher https://github.com/edc/bass

Gist をインストール:

fisher https://gist.github.com/username/1f40e1c6e0551b2666b2

ディレクトリをインストール:

fisher ~/plugin

vundleのように 「fishfile」というファイルにプラグインたちを追加して fisher でインストール:

fishfileとは

$EDITOR fishfile # プラグイン追加
fisher

インストールされるプラグイン表示:

fisher ls
@ plugin    # ローカルディレクトリ
* real        # 現在のテーマ
  bass
  fzf
  grc
  thefuck
  z

すべてのプラグインをアップデート:

fisher up

いくつかのプラグインをアップデート:

fisher up bass z fzf thefuck

プラグインを削除:

fisher rm thefuck

すべてのプラグインを削除:

fisher ls | fisher rm

ドキュメントを表示:

fisher help z

FAQ

fishの必要なバージョンとは

fish >= 2.3.0 が必要です。まだ 2.2.0 を使っているのならば snippets の対応のため次のコードを ~/.config/fish/config.fish に追記してください。

for file in ~/.config/fish/conf.d/*.fish
    source $file
end

フィッシュシェルをデフォルトのシェルにするには?

システムの /etc/shells ファイルに、fish を追加:

echo "/usr/local/bin/fish" | sudo tee -a /etc/shells
chsh -s /usr/local/bin/fish

fishermanを削除する方法とは

fisher self-uninstall

もしくは

npm un -g fisherman

oh-my-fishのプラグインとテーマに対応ですか

対応してます

fishermanのファイル等は、どこに保存されますか

fisherman 自体は ~/.config/fish/functions/fisher.fish に作成されます。そしてキャシュは*~/.cache/fishermanに、コンフィグディレクトリは ~/.config/fisherman に。fishfileは~/.config/fish/fishfile*に保存されます

fishfileとは

fishfile~/.config/fish/fishfile)に現在インストールされているプラグインが書かれています。

fisherman で自動的にこのファイルを更新するか、手動でプラグインを追加して fisherを入力してインストールすることも可能です。

fisherman/real
fisherman/z
omf/thefuck
omf/grc

この仕組はプラグインと、そのプラグインが依存しているものをインストールすることができます。プラグインを削除するために、fisher rmを使ってください。

フィッシュシェルのプラグインはどこにありますか?

fisherman の organizationウェブサイト 等で、プラグインを検索できます。

プラグインとは?

プラグインとは

  1. 普通のディレクトリや、gitレポジトリのrootに、.fishファイルの関数、それか、functionsディレクトリに。

  2. テーマ。つまり、fish_prompt.fishfish_right_prompt.fishか両方。

  3. スニペット。つまり、1以上の*.fishファイルをconf.d*といディレクトリに。こちらのファイルがフィッシュシェルがスタートする際に実行されます。

自分のプラグインを、他のプラグインのデペンデンシーにしたい場合は?

プラグイン root ディレクトリの fishfile 編集してそのプラグインを追加してください。

owner/repo
https://github.com/owner/repo
https://gist.github.com/owner/c256586044fea832e62f02bc6f6daf32