Ahoy my mateys! fisherman 2.0.0 (beta) is here.
A lot has changed, in fact, fisherman as you knew it, is
no longer with us. Let me explain. The new fisherman, is
in fact a rewired clone of ``fin´´, a short-lived 2 week
experiment that started because it was easier to rewrite
everything than moving fisherman forward.
Let me explain. I was longing for a lightweight, simpler
fisherman with minimal maintanance cost. This fin lad is
one of the most pragmatic pieces of code I've ever written,
but attempting to maintain two drastically different plugin
managers was not a sane decision. fin's goal was to get out
of my way and let me be productive with fish and it did.
Now fin is fisherman and fisherman is fin. The most notable
change is that fisherman no longer depends on an index, so
like fin, it's neutral and agnostic to what plugins you use.
No index means fisherman completions are no longer as clever
as to show you description of plugins, but you will still get
enough information to know whether the plugin is a theme or not.
I hope you always check the plugin's README / online docs before
installing anything anyway.
With the index gone, we had no use for ``search``, so this command
is also gone.
If you were using search often or depended on the removed features
above, I am afraid they are gone *gone*, but trust me it's all for
the very best.
Now, with this out of the way, it's all unicorns and dartfish. Almost.
To upgrade to fisherman 2.0.0 you need to REMOVE your current version
of fisherman:
1. ```rm -rf "$fisher_home" "$fisher_config"```
2. Open your config.fish and remove the fisherman initialization code.
3. ```exec fish < /dev/tty``` to reload the session.
4. Run `curl -Lo ~/.config/fish/functions/fisher.fish --create-dirs git.io/fisherman`
That's it. Probably.
The new fisherman brings a lot more stability and maturity to the
project and we need this change in order to move forward. I will
be actively fixing any bugs that may have sneaked in during the
```fin->fisherman``` rewiring, but please do ping me:
@bucaran on GitHub or directly to my email j@bucaran.me
if you find anything out of place. Feel free and invited to go
wild with issues in order to get this into shape ASAP.
Cheers!
2016-04-21 15:34:06 +00:00
|
|
|
|
[slack-link]: https://fisherman-wharf.herokuapp.com/
|
|
|
|
|
|
[slack-badge]: https://img.shields.io/badge/slack-join%20the%20chat-00B9FF.svg?style=flat-square
|
|
|
|
|
|
[travis-link]: https://travis-ci.org/fisherman/fisherman
|
|
|
|
|
|
[travis-badge]: https://img.shields.io/travis/fisherman/fisherman.svg?style=flat-square
|
|
|
|
|
|
|
|
|
|
|
|
[organization]: https://github.com/fisherman
|
2016-04-22 05:21:31 +00:00
|
|
|
|
[fish shell]: https://github.com/fish-shell/fish-shell
|
|
|
|
|
|
[fisherman]: http://fisherman.sh
|
2016-04-22 15:40:52 +00:00
|
|
|
|
[ウェブサイト]: http://fisherman.sh/#search
|
Ahoy my mateys! fisherman 2.0.0 (beta) is here.
A lot has changed, in fact, fisherman as you knew it, is
no longer with us. Let me explain. The new fisherman, is
in fact a rewired clone of ``fin´´, a short-lived 2 week
experiment that started because it was easier to rewrite
everything than moving fisherman forward.
Let me explain. I was longing for a lightweight, simpler
fisherman with minimal maintanance cost. This fin lad is
one of the most pragmatic pieces of code I've ever written,
but attempting to maintain two drastically different plugin
managers was not a sane decision. fin's goal was to get out
of my way and let me be productive with fish and it did.
Now fin is fisherman and fisherman is fin. The most notable
change is that fisherman no longer depends on an index, so
like fin, it's neutral and agnostic to what plugins you use.
No index means fisherman completions are no longer as clever
as to show you description of plugins, but you will still get
enough information to know whether the plugin is a theme or not.
I hope you always check the plugin's README / online docs before
installing anything anyway.
With the index gone, we had no use for ``search``, so this command
is also gone.
If you were using search often or depended on the removed features
above, I am afraid they are gone *gone*, but trust me it's all for
the very best.
Now, with this out of the way, it's all unicorns and dartfish. Almost.
To upgrade to fisherman 2.0.0 you need to REMOVE your current version
of fisherman:
1. ```rm -rf "$fisher_home" "$fisher_config"```
2. Open your config.fish and remove the fisherman initialization code.
3. ```exec fish < /dev/tty``` to reload the session.
4. Run `curl -Lo ~/.config/fish/functions/fisher.fish --create-dirs git.io/fisherman`
That's it. Probably.
The new fisherman brings a lot more stability and maturity to the
project and we need this change in order to move forward. I will
be actively fixing any bugs that may have sneaked in during the
```fin->fisherman``` rewiring, but please do ping me:
@bucaran on GitHub or directly to my email j@bucaran.me
if you find anything out of place. Feel free and invited to go
wild with issues in order to get this into shape ASAP.
Cheers!
2016-04-21 15:34:06 +00:00
|
|
|
|
|
|
|
|
|
|
[English]: ../../README.md
|
2016-04-21 15:57:11 +00:00
|
|
|
|
[Español]: ../es-ES
|
|
|
|
|
|
[简体中文]: ../zh-CN
|
2016-04-22 05:21:31 +00:00
|
|
|
|
|
|
|
|
|
|
[![Build Status][travis-badge]][travis-link]
|
|
|
|
|
|
[![Slack][slack-badge]][slack-link]
|
|
|
|
|
|
|
|
|
|
|
|
# [fisherman] - fish shell plugin manager
|
2016-04-22 15:40:52 +00:00
|
|
|
|
|
|
|
|
|
|
fishermanとは、フィッシュシェルのための並列処理パッケージマネージャーである。fishermanには設定は必要ではない。
|
|
|
|
|
|
|
|
|
|
|
|
翻訳: [English], [Español], [简体中文].
|
|
|
|
|
|
|
|
|
|
|
|
## 理由
|
|
|
|
|
|
|
|
|
|
|
|
* 簡単
|
|
|
|
|
|
|
|
|
|
|
|
* 設定なし
|
|
|
|
|
|
|
|
|
|
|
|
* 依存性なし
|
|
|
|
|
|
|
|
|
|
|
|
* フィッシュシェルのスタート時間に関係ない
|
|
|
|
|
|
|
|
|
|
|
|
* cliから利用可能であり、vundleのようにも使える
|
|
|
|
|
|
|
|
|
|
|
|
* 基本のコマンド、install、update、remove、listとhelpだけである
|
|
|
|
|
|
|
|
|
|
|
|
## インストール
|
|
|
|
|
|
|
|
|
|
|
|
`fisher.fish`を`~/.config/fish/functions`に。
|
|
|
|
|
|
|
|
|
|
|
|
```sh
|
|
|
|
|
|
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
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
ディレクトリをインストール。
|
|
|
|
|
|
|
|
|
|
|
|
```sh
|
|
|
|
|
|
fisher ~/my_aliases
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
vundleのように、「fishfile」というファイルに、プラグインたちを打って、`fisher`を入力すると、インストールされる。
|
|
|
|
|
|
|
|
|
|
|
|
> [fishfileとは？](#9-fishfileとは？)
|
|
|
|
|
|
|
|
|
|
|
|
```sh
|
|
|
|
|
|
$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の必要なバージョンとは？
|
|
|
|
|
|
|
2016-04-23 05:23:30 +00:00
|
|
|
|
fish >= 2.3.0は必要です。まだ2.2.0を利用中であれば、[snippets](#13-プラグインとは？)の対応のため、次のコードを`~/.config/fish/config.fish`に書いてください。
|
2016-04-22 15:40:52 +00:00
|
|
|
|
|
|
|
|
|
|
```fish
|
|
|
|
|
|
for file in ~/.config/fish/conf.d/*.fish
|
|
|
|
|
|
source $file
|
|
|
|
|
|
end
|
|
|
|
|
|
```
|
|
|
|
|
|
|
2016-04-23 05:23:30 +00:00
|
|
|
|
### 2. フィッシュシェルをデフォルトのシェルにするには？
|
2016-04-22 15:40:52 +00:00
|
|
|
|
|
|
|
|
|
|
システムの`/etc/shells`ファイルに、fishを追加して下さい。
|
|
|
|
|
|
|
|
|
|
|
|
```sh
|
|
|
|
|
|
echo "/usr/local/bin/fish" | sudo tee -a /etc/shells
|
|
|
|
|
|
chsh -s /usr/local/bin/fish
|
|
|
|
|
|
```
|
|
|
|
|
|
|
2016-04-23 05:23:30 +00:00
|
|
|
|
### 3. fishermanを削除する方法とは？
|
2016-04-22 15:40:52 +00:00
|
|
|
|
|
|
|
|
|
|
はい。
|
|
|
|
|
|
|
|
|
|
|
|
```fish
|
|
|
|
|
|
fisher self-uninstall
|
|
|
|
|
|
```
|
|
|
|
|
|
|
2016-04-23 05:23:30 +00:00
|
|
|
|
### 4. oh-my-fishのプラグインとテーマに対応ですか？
|
2016-04-22 15:40:52 +00:00
|
|
|
|
|
|
|
|
|
|
対応です。
|
|
|
|
|
|
|
2016-04-23 05:23:30 +00:00
|
|
|
|
### 5. なぜfisherman?
|
2016-04-22 15:40:52 +00:00
|
|
|
|
|
|
|
|
|
|
* 小さくて一つのファイルでOK
|
|
|
|
|
|
|
|
|
|
|
|
* フィッシュシェルのスタート時間に関係ない
|
|
|
|
|
|
|
|
|
|
|
|
* インストールも、アップグレードも、削除も簡単で、素早い
|
|
|
|
|
|
|
|
|
|
|
|
* フィッシュシェルの設定に関係ない
|
|
|
|
|
|
|
|
|
|
|
|
* XDGディレクトリ方針を従う
|
|
|
|
|
|
|
2016-04-23 05:23:30 +00:00
|
|
|
|
### 6. fishermanのファイル等は、どこに保存されますか？
|
2016-04-22 15:40:52 +00:00
|
|
|
|
|
|
|
|
|
|
fisherman自体は`~/.config/fish/functions/fisher.fish`に。
|
|
|
|
|
|
|
|
|
|
|
|
キャシュは`~/.cache/fisherman`に、コンフィグディレクトリは`~/.config/fisherman`に。
|
|
|
|
|
|
|
|
|
|
|
|
fishfileは`~/.config/fish/fishfile`に。
|
|
|
|
|
|
|
2016-04-23 05:23:30 +00:00
|
|
|
|
### 7. fishfileとは？
|
2016-04-22 15:40:52 +00:00
|
|
|
|
|
|
|
|
|
|
fishfile（`~/.config/fish/fishfile`）に現在インストールされているプラグインを記入してあります。
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
fishermanに任せて、このファイルを自動的に扱って頂けるか、自分で手に入れたいプラグインを入れて、`fisher`を入力すると、インストールも可能です。
|
|
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
|
fisherman/simple
|
|
|
|
|
|
fisherman/z
|
|
|
|
|
|
omf/thefuck
|
|
|
|
|
|
omf/grc
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
この仕組はプラグインと、そのプラグインのデペンデンシーをインストールすることができます。プラグインを削除するために、`fisher rm`を使ってください。
|
|
|
|
|
|
|
2016-04-23 05:23:30 +00:00
|
|
|
|
### 8. フィッシュシェルのプラグインはどこにありますか？
|
2016-04-22 15:40:52 +00:00
|
|
|
|
|
|
|
|
|
|
fishermanの[organization]や、[ウェブサイト]等で、プラグインを検索できます。
|
|
|
|
|
|
|
2016-04-23 05:23:30 +00:00
|
|
|
|
### 9. 他のシステムからのアップグレード方法とは？
|
2016-04-22 15:40:52 +00:00
|
|
|
|
|
|
|
|
|
|
fishermanは他のフィッシュシェルフレームワーク等に関係ないです。もし、oh-my-fish等をアンインストールしたい場合、あちらのドキュメンテーションを参考してください。
|
|
|
|
|
|
|
2016-04-23 05:23:30 +00:00
|
|
|
|
### 10. プラグインとは？
|
2016-04-22 15:40:52 +00:00
|
|
|
|
|
|
|
|
|
|
プラグインとは
|
|
|
|
|
|
|
|
|
|
|
|
1. 普通のディレクトリや、gitレポジトリのrootに、`.fish`ファイルの関数、それか、`functions`ディレクトリに。
|
|
|
|
|
|
|
|
|
|
|
|
2. テーマ。つまり、`fish_prompt.fish`か`fish_right_prompt.fish`か両方。
|
|
|
|
|
|
|
|
|
|
|
|
3. スニペット。つまり、1以上の`.fish`ファイルを`conf.d`といディレクトリに。こちらのファイルがフィッシュシェルがスタートする際に実行されます。
|
|
|
|
|
|
|
2016-04-23 05:23:30 +00:00
|
|
|
|
### 11. 自分のプラグインを、他のプラグインのデペンデンシーにしたい場合は？
|
2016-04-22 15:40:52 +00:00
|
|
|
|
|
|
|
|
|
|
プラグインのrootディレクトリに`fishfile`編集して、そのプラグインを打ってください。
|
|
|
|
|
|
|
|
|
|
|
|
```fish
|
|
|
|
|
|
owner/repo
|
|
|
|
|
|
https://github.com/dude/sweet
|
|
|
|
|
|
https://gist.github.com/bucaran/c256586044fea832e62f02bc6f6daf32
|
|
|
|
|
|
```
|
|
|
|
|
|
|
2016-04-23 05:23:30 +00:00
|
|
|
|
### 12. fundleはどう？
|
2016-04-22 15:40:52 +00:00
|
|
|
|
|
|
|
|
|
|
fundleを参考しながら、vundleのようにfishfileを使いたいと思いましたが、fundle自体はまだ特徴はすくないですし、フィッシュシェルの設定をいじることは必要です。
|
|
|
|
|
|
|
2016-04-23 05:23:30 +00:00
|
|
|
|
### 13. 質問がありますが、どこに書いたらいいですか？
|
2016-04-22 15:40:52 +00:00
|
|
|
|
|
|
|
|
|
|
新しいissueを作って頂いて、英語でも、日本語でも対応しております。
|
|
|
|
|
|
|
|
|
|
|
|
* https://github.com/fisherman/fisherman/issues
|