.. | ||
README.md |
fisherman - fish shell plugin manager
fishermanとは、フィッシュシェルのための並列処理パッケージマネージャーである。fishermanには設定は必要ではない。
理由
-
簡単
-
設定なし
-
依存性なし
-
フィッシュシェルのスタート時間に関係ない
-
cliから利用可能であり、vundleのようにも使える
-
基本のコマンド、install、update、remove、listとhelpだけである
インストール
fisher.fish
を~/.config/fish/functions
に。
curl -Lo ~/.config/fish/functions/fisher.fish --create-dirs git.io/fisherman
使い方
プラグインをインストール。
fisher simple
様々な所からもインストール。
fisher z fzf omf/{grc,thefuck}
URLからインストール。
fisher https://github.com/edc/bass
Gistをインストール。
fisher https://gist.github.com/username/1f40e1c6e0551b2666b2
ディレクトリをインストール。
fisher ~/my_aliases
vundleのように、「fishfile」というファイルに、プラグインたちを打って、fisher
を入力すると、インストールされる。
$EDITOR fishfile # プラグインを入れる
fisher
インストールされるプラグインを表示する。
fisher ls
@ my_aliases # este paquete es un directorio
* simple # este paquete es el tema actual
bass
fzf
grc
thefuck
z
全部をアップデート。
fisher up
いくつかのプラグインをアップデート。
fisher up bass z fzf thefuck
プラグインを削除。
fisher rm simple
全部のプラグインを削除。
fisher ls | fisher rm
ドキュを表示。
fisher help z
FAQ
1. fishの必要なバージョンとは?
fish >= 2.3.0は必要です。まだ2.2.0を利用中であれば、snippetsの対応のため、次のコードを~/.config/fish/config.fish
に書いてください。
for file in ~/.config/fish/conf.d/*.fish
source $file
end
2. フィッシュシェルをデフォルトのシェルにするには?
システムの/etc/shells
ファイルに、fishを追加して下さい。
echo "/usr/local/bin/fish" | sudo tee -a /etc/shells
chsh -s /usr/local/bin/fish
3. fishermanを削除する方法とは?
はい。
fisher self-uninstall
4. oh-my-fishのプラグインとテーマに対応ですか?
対応です。
5. なぜfisherman?
-
小さくて一つのファイルでOK
-
フィッシュシェルのスタート時間に関係ない
-
インストールも、アップグレードも、削除も簡単で、素早い
-
フィッシュシェルの設定に関係ない
-
XDGディレクトリ方針を従う
6. fishermanのファイル等は、どこに保存されますか?
fisherman自体は~/.config/fish/functions/fisher.fish
に。
キャシュは~/.cache/fisherman
に、コンフィグディレクトリは~/.config/fisherman
に。
fishfileは~/.config/fish/fishfile
に。
7. fishfileとは?
fishfile(~/.config/fish/fishfile
)に現在インストールされているプラグインを記入してあります。
fishermanに任せて、このファイルを自動的に扱って頂けるか、自分で手に入れたいプラグインを入れて、fisher
を入力すると、インストールも可能です。
fisherman/simple
fisherman/z
omf/thefuck
omf/grc
この仕組はプラグインと、そのプラグインのデペンデンシーをインストールすることができます。プラグインを削除するために、fisher rm
を使ってください。
8. フィッシュシェルのプラグインはどこにありますか?
fishermanのorganizationや、ウェブサイト等で、プラグインを検索できます。
9. 他のシステムからのアップグレード方法とは?
fishermanは他のフィッシュシェルフレームワーク等に関係ないです。もし、oh-my-fish等をアンインストールしたい場合、あちらのドキュメンテーションを参考してください。
10. プラグインとは?
プラグインとは
-
普通のディレクトリや、gitレポジトリのrootに、
.fish
ファイルの関数、それか、functions
ディレクトリに。 -
テーマ。つまり、
fish_prompt.fish
かfish_right_prompt.fish
か両方。 -
スニペット。つまり、1以上の
.fish
ファイルをconf.d
といディレクトリに。こちらのファイルがフィッシュシェルがスタートする際に実行されます。
11. 自分のプラグインを、他のプラグインのデペンデンシーにしたい場合は?
プラグインのrootディレクトリにfishfile
編集して、そのプラグインを打ってください。
owner/repo
https://github.com/dude/sweet
https://gist.github.com/bucaran/c256586044fea832e62f02bc6f6daf32
12. fundleはどう?
fundleを参考しながら、vundleのようにfishfileを使いたいと思いましたが、fundle自体はまだ特徴はすくないですし、フィッシュシェルの設定をいじることは必要です。
13. 質問がありますが、どこに書いたらいいですか?
新しいissueを作って頂いて、英語でも、日本語でも対応しております。