2016-04-23 10:34:24 +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
2016-04-23 10:34:24 +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
2016-04-23 10:34:24 +02:00
2016-05-14 07:17:27 +02:00
[fish]: https://github.com/fish-shell/fish-shell
2016-04-23 10:34:24 +02:00
[fisherman]: https://github.com/fisherman.sh
2016-04-29 13:40:41 +02:00
[fishfile]: #6 -Что-такое-fishfile-и-как-я-могу-е г о -использовать
2016-04-23 10:34:24 +02:00
[организации]: https://github.com/fisherman
[онлайн]: http://fisherman.sh/#search
[![Build Status][travis-badge]][travis-link]
[![Slack][slack-badge]][slack-link]
2016-05-14 07:17:27 +02:00
# [fisherman]
2016-04-23 10:34:24 +02:00
2016-05-14 07:17:27 +02:00
fisherman это параллельный менеджер плагинов для [fish].
2016-04-23 10:34:24 +02:00
## Установка
2016-04-26 14:50:26 +02:00
Используя curl:
2016-04-23 10:34:24 +02:00
```sh
curl -Lo ~/.config/fish/functions/fisher.fish --create-dirs git.io/fisherman
```
## Использование
2016-04-26 14:50:26 +02:00
Установка отдельного плагина.
2016-04-23 10:34:24 +02:00
```
2016-05-14 07:17:27 +02:00
fisher real
2016-04-23 10:34:24 +02:00
```
Установка из нескольких источников.
```
2016-05-14 07:17:27 +02:00
fisher z fzf edc/bass omf/thefuck
2016-04-23 10:34:24 +02:00
```
2016-04-26 14:50:26 +02:00
Установка по ссылке URL.
2016-04-23 10:34:24 +02:00
```
fisher https://github.com/edc/bass
```
2016-04-26 14:50:26 +02:00
Установка из gist.
2016-04-23 10:34:24 +02:00
```
fisher https://gist.github.com/username/1f40e1c6e0551b2666b2
```
2016-04-26 14:50:26 +02:00
Установка из локального каталога.
2016-04-23 10:34:24 +02:00
```sh
2016-05-14 07:17:27 +02:00
fisher ~/plugin
2016-04-23 10:34:24 +02:00
```
2016-04-29 13:40:41 +02:00
Отредактируйте [fishfile] и запустите `fisher` , чтобы изменения вступили в силу.
2016-04-23 10:34:24 +02:00
```sh
2016-04-26 14:50:26 +02:00
$EDITOR fishfile # добавьте плагины
2016-04-23 10:34:24 +02:00
fisher
```
2016-04-29 13:40:41 +02:00
Список установленных плагинов.
2016-04-23 10:34:24 +02:00
2016-04-27 18:11:48 +02:00
```ApacheConf
2016-04-23 10:34:24 +02:00
fisher ls
2016-05-14 07:17:27 +02:00
@ plugin # этот плагин представляет собой локальный каталог
* real # этот плагин является текущим оформлением командной строки
2016-04-23 10:34:24 +02:00
bass
fzf
grc
thefuck
z
```
2016-04-29 13:40:41 +02:00
Список доступных плагинов.
```
fisher ls-remote
```
2016-04-26 14:50:26 +02:00
Обновление всего сразу.
2016-04-23 10:34:24 +02:00
```
fisher up
```
2016-04-26 14:50:26 +02:00
Обновление отдельных плагинов.
2016-04-23 10:34:24 +02:00
```
fisher up bass z fzf thefuck
```
2016-04-26 14:50:26 +02:00
Удаление плагинов.
2016-04-23 10:34:24 +02:00
```
2016-05-14 07:17:27 +02:00
fisher rm thefuck
2016-04-23 10:34:24 +02:00
```
2016-04-26 14:50:26 +02:00
Удаление всех плагинов.
2016-04-23 10:34:24 +02:00
```
fisher ls | fisher rm
```
2016-04-26 14:50:26 +02:00
Справка по плагину.
2016-04-23 10:34:24 +02:00
```
fisher help z
```
## Часто задаваемые вопросы
2016-05-14 07:17:27 +02:00
### Какая версия fish необходима?
2016-04-23 10:34:24 +02:00
2016-04-26 14:50:26 +02:00
fisherman был разработан для fish >= 2.3.0. Если вы используете 2.2.0, добавьте следующий код в ваш `~/.config/fish/config.fish` для поддержки [cниппе то в ](#8-Что-такое-плагин ).
2016-04-23 10:34:24 +02:00
```fish
for file in ~/.config/fish/conf.d/*.fish
source $file
end
```
2016-05-14 07:17:27 +02:00
### Как сделать fish основной командной оболочкой?
2016-04-23 10:34:24 +02:00
2016-05-05 18:22:24 +02:00
Добавьте fish в список командных оболочек */etc/shells* и сделайте её оболочкой по умолчанию.
2016-04-23 10:34:24 +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-23 10:34:24 +02:00
```fish
fisher self-uninstall
```
2016-05-14 07:17:27 +02:00
### Совместим ли fisherman с темами и плагинами oh my fish?
2016-04-23 10:34:24 +02:00
Да.
2016-05-14 07:17:27 +02:00
### Где fisherman хранит данные?
2016-04-23 10:34:24 +02:00
2016-05-05 18:22:24 +02:00
Скрипт fisherman находится в *~/.config/fish/functions/fisher.fish* .
2016-04-23 10:34:24 +02:00
2016-05-05 18:22:24 +02:00
Кэш и настройки плагинов создаются в *~/.cache/fisherman* и *~/.config/fisherman* соответственно.
2016-04-23 10:34:24 +02:00
2016-05-05 18:22:24 +02:00
fishfile сохраняется в *~/.config/fish/fishfile* .
2016-04-23 10:34:24 +02:00
2016-05-14 07:17:27 +02:00
### Что такое fishfile и как я могу е г о использовать?
2016-04-23 10:34:24 +02:00
2016-05-05 18:22:24 +02:00
В *~/.config/fish/fishfile* хранится список всех установленных плагинов.
2016-04-23 10:34:24 +02:00
2016-04-26 14:50:26 +02:00
fisherman обновляет этот файл автоматически, но вы также можете добавить плагины в список вручную и запустить `fisher` , чтобы эти изменения вступили в силу.
2016-04-23 10:34:24 +02:00
```
2016-05-14 07:17:27 +02:00
fisherman/real
2016-04-23 10:34:24 +02:00
fisherman/z
omf/thefuck
omf/grc
```
2016-04-26 14:50:26 +02:00
Этот механизм только устанавливает плагины и отсутствующие зависимости. Чтобы удалить плагин, используйте `fisher rm` .
2016-04-23 10:34:24 +02:00
2016-05-14 07:17:27 +02:00
### Где я могу найти список плагинов для fish?
2016-04-23 10:34:24 +02:00
2016-04-26 14:50:26 +02:00
Используйте поиск по Github [организации] или [онлайн] поиск на сайте.
2016-04-23 10:34:24 +02:00
2016-05-14 07:17:27 +02:00
### Что такое плагин?
2016-04-23 10:34:24 +02:00
2016-04-26 14:50:26 +02:00
Плагином является:
2016-04-23 10:34:24 +02:00
2016-05-05 18:22:24 +02:00
1. каталог или git репозиторий с файлом *.fish* либо на корневом уровне проекта, либо в директории *functions*
2016-04-23 10:34:24 +02:00
2016-05-05 18:22:24 +02:00
2. тема или оформление командной строки, т.е . *fish_prompt.fish* , *fish_right_prompt.fish* или о б а файла
2016-04-23 10:34:24 +02:00
2016-05-05 18:22:24 +02:00
3. сниппет, т.е . один или несколько *.fish* файлов в директории *conf.d* , которые загружаются при запуске fish
2016-04-23 10:34:24 +02:00
2016-05-14 07:17:27 +02:00
### Как я могу объявить зависимости моего плагина?
2016-04-23 10:34:24 +02:00
2016-05-05 18:22:24 +02:00
Создайте новый *fishfile* в корне вашего проекта с о списком зависимостей.
2016-04-23 10:34:24 +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-23 10:34:24 +02:00
```