fisher/docs/jp-JA/README.md

201 lines
4.8 KiB
Markdown
Raw Normal View History

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 17:34:06 +02:00
[slack-link]: https://fisherman-wharf.herokuapp.com/
2016-04-23 19:24:39 +02:00
[slack-badge]: https://fisherman-wharf.herokuapp.com/badge.svg
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 17:34:06 +02:00
[travis-link]: https://travis-ci.org/fisherman/fisherman
2016-04-23 19:32:07 +02:00
[travis-badge]: https://img.shields.io/travis/fisherman/fisherman.svg
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 17:34:06 +02:00
[organization]: https://github.com/fisherman
2016-05-14 07:17:27 +02:00
[fish]: https://github.com/fish-shell/fish-shell
2016-04-22 07:21:31 +02:00
[fisherman]: http://fisherman.sh
2016-04-22 17:40:52 +02: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 17:34:06 +02:00
2016-04-22 07:21:31 +02:00
[![Build Status][travis-badge]][travis-link]
[![Slack][slack-badge]][slack-link]
2016-05-14 07:17:27 +02:00
# [fisherman]
2016-04-22 17:40:52 +02:00
2016-05-14 07:17:27 +02:00
fisherman とは [fish]のための並列処理パッケージマネージャーです。
2016-04-22 17:40:52 +02:00
## 理由
* 設定なし
* 依存性なし
* フィッシュシェルのスタート時間に関係ない
2016-04-24 07:04:21 +02:00
* cli から利用可能であり、vundle のようにも使える
2016-04-22 17:40:52 +02:00
2016-04-24 07:04:21 +02:00
* 基本のコマンドは install、update、remove、list と help だけ
2016-04-22 17:40:52 +02:00
## インストール
2016-04-24 07:04:21 +02:00
curl:
2016-04-22 17:40:52 +02:00
```sh
curl -Lo ~/.config/fish/functions/fisher.fish --create-dirs git.io/fisherman
```
## 使い方
2016-04-24 07:04:21 +02:00
プラグインをインストール:
2016-04-22 17:40:52 +02:00
```
2016-05-17 19:48:02 +02:00
fisher sol
2016-04-22 17:40:52 +02:00
```
2016-04-24 07:04:21 +02:00
様々な所からもインストール:
2016-04-22 17:40:52 +02:00
```
2016-05-14 07:17:27 +02:00
fisher z fzf edc/bass omf/thefuck
2016-04-22 17:40:52 +02:00
```
2016-04-24 07:04:21 +02:00
URL からインストール:
2016-04-22 17:40:52 +02:00
```
fisher https://github.com/edc/bass
```
2016-04-24 07:04:21 +02:00
Gist をインストール:
2016-04-22 17:40:52 +02:00
```
fisher https://gist.github.com/username/1f40e1c6e0551b2666b2
```
2016-04-24 07:04:21 +02:00
ディレクトリをインストール:
2016-04-22 17:40:52 +02:00
```sh
2016-05-14 07:17:27 +02:00
fisher ~/plugin
2016-04-22 17:40:52 +02:00
```
2016-04-24 07:04:21 +02:00
vundleのように 「fishfile」というファイルにプラグインたちを追加して `fisher` でインストール:
2016-04-22 17:40:52 +02:00
> [fishfileとは](#6-fishfileとは)
2016-04-22 17:40:52 +02:00
```sh
2016-04-24 07:04:21 +02:00
$EDITOR fishfile # プラグイン追加
2016-04-22 17:40:52 +02:00
fisher
```
2016-04-24 07:04:21 +02:00
インストールされるプラグイン表示:
2016-04-22 17:40:52 +02:00
2016-04-27 18:11:48 +02:00
```ApacheConf
2016-04-22 17:40:52 +02:00
fisher ls
2016-05-14 07:17:27 +02:00
@ plugin # ローカルディレクトリ
2016-05-17 19:48:02 +02:00
* sol # 現在のテーマ
2016-04-22 17:40:52 +02:00
bass
fzf
grc
thefuck
z
```
2016-04-24 07:04:21 +02:00
すべてのプラグインをアップデート:
2016-04-22 17:40:52 +02:00
```
fisher up
```
2016-04-24 07:04:21 +02:00
いくつかのプラグインをアップデート:
2016-04-22 17:40:52 +02:00
```
fisher up bass z fzf thefuck
```
2016-04-24 07:04:21 +02:00
プラグインを削除:
2016-04-22 17:40:52 +02:00
```
2016-05-14 07:17:27 +02:00
fisher rm thefuck
2016-04-22 17:40:52 +02:00
```
2016-04-24 07:04:21 +02:00
すべてのプラグインを削除:
2016-04-22 17:40:52 +02:00
```
fisher ls | fisher rm
```
2016-04-24 07:04:21 +02:00
ドキュメントを表示:
2016-04-22 17:40:52 +02:00
```
fisher help z
```
## FAQ
2016-05-14 07:17:27 +02:00
### fishの必要なバージョンとは
2016-04-22 17:40:52 +02:00
2016-04-24 07:04:21 +02:00
fish >= 2.3.0 が必要です。まだ 2.2.0 を使っているのならば [snippets](#8-プラグインとは) の対応のため次のコードを `~/.config/fish/config.fish` に追記してください。
2016-04-22 17:40:52 +02:00
```fish
for file in ~/.config/fish/conf.d/*.fish
source $file
end
```
2016-05-14 07:17:27 +02:00
### フィッシュシェルをデフォルトのシェルにするには?
2016-04-22 17:40:52 +02:00
2016-05-05 18:22:24 +02:00
システムの */etc/shells* ファイルに、fish を追加:
2016-04-22 17:40:52 +02:00
```sh
echo "/usr/local/bin/fish" | sudo tee -a /etc/shells
chsh -s /usr/local/bin/fish
```
2016-05-14 07:17:27 +02:00
### fishermanを削除する方法とは
2016-04-22 17:40:52 +02:00
```fish
fisher self-uninstall
```
もしくは
```fish
npm un -g fisherman
```
2016-05-14 07:17:27 +02:00
### oh-my-fishのプラグインとテーマに対応ですか
2016-04-22 17:40:52 +02:00
2016-04-24 07:04:21 +02:00
対応してます
2016-04-22 17:40:52 +02:00
2016-05-14 07:17:27 +02:00
### fishermanのファイル等は、どこに保存されますか
2016-04-22 17:40:52 +02:00
2016-05-05 18:22:24 +02:00
fisherman 自体は *~/.config/fish/functions/fisher.fish* に作成されます。そしてキャシュは*~/.cache/fisherman*に、コンフィグディレクトリは *~/.config/fisherman* に。fishfileは*~/.config/fish/fishfile*に保存されます
2016-04-22 17:40:52 +02:00
2016-05-14 07:17:27 +02:00
### fishfileとは
2016-04-22 17:40:52 +02:00
2016-05-05 18:22:24 +02:00
fishfile*~/.config/fish/fishfile*)に現在インストールされているプラグインが書かれています。
2016-04-22 17:40:52 +02:00
2016-04-24 07:04:21 +02:00
fisherman で自動的にこのファイルを更新するか、手動でプラグインを追加して `fisher`を入力してインストールすることも可能です。
2016-04-22 17:40:52 +02:00
```
2016-05-17 19:48:02 +02:00
fisherman/sol
2016-04-22 17:40:52 +02:00
fisherman/z
omf/thefuck
omf/grc
```
2016-04-24 07:04:21 +02:00
この仕組はプラグインと、そのプラグインが依存しているものをインストールすることができます。プラグインを削除するために、`fisher rm`を使ってください。
2016-04-22 17:40:52 +02:00
2016-05-14 07:17:27 +02:00
### フィッシュシェルのプラグインはどこにありますか?
2016-04-22 17:40:52 +02:00
2016-04-24 07:04:21 +02:00
fisherman の [organization] や [ウェブサイト] 等で、プラグインを検索できます。
2016-04-22 17:40:52 +02:00
2016-05-14 07:17:27 +02:00
### プラグインとは?
2016-04-22 17:40:52 +02:00
プラグインとは
2016-05-05 18:22:24 +02:00
1. 普通のディレクトリや、gitレポジトリのrootに、*.fish*ファイルの関数、それか、*functions*ディレクトリに。
2016-04-22 17:40:52 +02:00
2016-05-05 18:22:24 +02:00
2. テーマ。つまり、*fish_prompt.fish*か*fish_right_prompt.fish*か両方。
2016-04-22 17:40:52 +02:00
2016-05-05 18:22:24 +02:00
3. スニペット。つまり、1以上の*.fish*ファイルを*conf.d*といディレクトリに。こちらのファイルがフィッシュシェルがスタートする際に実行されます。
2016-04-22 17:40:52 +02:00
2016-05-14 07:17:27 +02:00
### 自分のプラグインを、他のプラグインのデペンデンシーにしたい場合は?
2016-04-22 17:40:52 +02:00
2016-05-05 18:22:24 +02:00
プラグイン root ディレクトリの *fishfile* 編集してそのプラグインを追加してください。
2016-04-22 17:40:52 +02:00
```fish
owner/repo
2016-05-02 20:02:48 +02:00
https://github.com/owner/repo
2016-05-05 18:22:24 +02:00
https://gist.github.com/owner/c256586044fea832e62f02bc6f6daf32
2016-04-22 17:40:52 +02:00
```