fisher/docs/jp-JA
Jorge Bucaran 9047bde4ac
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
..
README.md Remove fish install instructions from FAQ. 2016-04-23 14:23:30 +09:00

Build Status Slack

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. プラグインとは?

プラグインとは

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

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

  3. スニペット。つまり、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を作って頂いて、英語でも、日本語でも対応しております。