fisher/docs/jp-JA/README.md
2016-04-23 14:32:01 +09:00

6.2 KiB
Raw Blame History

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