mirror of https://github.com/jorgebucaran/fisher synced 2024-11-19 09:25:40 +00:00

Remove fish install instructions from FAQ.

It's too difficult to maintain install instructions in the FAQ
and possibly out of the scope of the project.

Also make it obvious that fisherman is designed for fish >= 2.3.0
and that users using fish 2.2.0 need to add conf.d support to their
~/.config/fish/config.fish for snippet support.

2016-04-23 14:23:30 +09:00

6.2 KiB

Raw Blame History

fisherman - fish shell plugin manager

fishermanとは、フィッシュシェルのための並列処理パッケージマネージャーである。fishermanには設定は必要ではない。

翻訳: English, Español, 简体中文.

理由

簡単
設定なし
依存性なし
フィッシュシェルのスタート時間に関係ない
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を入力すると、インストールされる。

fishfileとは？

$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を作って頂いて、英語でも、日本語でも対応しております。

https://github.com/fisherman/fisherman/issues

6.2 KiB Raw Blame History Unescape Escape