fc0676d4e1
Installing with npm works 9 out of 10 times. This may be due to the post-install hook hack set in order to move fisher.fish into the user functions directory. The simplest and best way to install fisherman is by putting the fisher.fish file in your functions directory. |
||
---|---|---|
.. | ||
README.md |
fisherman - fish shell plugin manager
fisherman это параллельный менеджер плагинов для fish shell.
Прочитать этот документ на другом языке: English, Español, 日本語, 简体中文, 한국어, Català.
Достоинства fisherman
-
Не нужно настраивать
-
Нет внешних зависимостей
-
Не влияет на время запуска оболочки
-
Можно использовать в интерактивном режиме или а-ля vundle
-
Только необходимые функции: установка, обновление, удаление, список установленного и справка
Установка
Используя curl:
curl -Lo ~/.config/fish/functions/fisher.fish --create-dirs git.io/fisherman
Если вы ещё используете версию 1.5 и хотите обновиться до >2.0 без особых хлопот:
curl -L git.io/fisher-up-me | fish
Использование
Установка отдельного плагина.
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
Использование в интерактивном-режиме. Отредактируйте fishfile и запустите fisher
, чтобы изменения вступили в силу.
$EDITOR fishfile # добавьте плагины
fisher
Просмотр установленных плагинов.
fisher ls
@ my_aliases # этот плагин представляет собой локальный каталог
* simple # этот плагин является текущим оформлением командной строки
bass
fzf
grc
thefuck
z
Обновление всего сразу.
fisher up
Обновление отдельных плагинов.
fisher up bass z fzf thefuck
Удаление плагинов.
fisher rm simple
Удаление всех плагинов.
fisher ls | fisher rm
Справка по плагину.
fisher help z
Часто задаваемые вопросы
1. Какая версия fish необходима?
fisherman был разработан для fish >= 2.3.0. Если вы используете 2.2.0, добавьте следующий код в ваш ~/.config/fish/config.fish
для поддержки cниппетов.
for file in ~/.config/fish/conf.d/*.fish
source $file
end
2. Как сделать fish основной командной оболочкой?
Добавьте fish в список командных оболочек /etc/shells
и сделайте её оболочкой по умолчанию.
echo "/usr/local/bin/fish" | sudo tee -a /etc/shells
chsh -s /usr/local/bin/fish
3. Как мне удалить fisherman?
fisher self-uninstall
или
npm un -g fisherman
4. Совместим ли fisherman с темами и плагинами oh my fish?
Да.
5. Где fisherman хранит данные?
Скрипт fisherman находится в ~/.config/fish/functions/fisher.fish
.
Кэш и настройки плагинов создаются в ~/.cache/fisherman
и ~/.config/fisherman
соответственно.
fishfile сохраняется в ~/.config/fish/fishfile
.
6. Что такое fishfile и как я могу его использовать?
В ~/.config/fish/fishfile
хранится список всех установленных плагинов.
fisherman обновляет этот файл автоматически, но вы также можете добавить плагины в список вручную и запустить fisher
, чтобы эти изменения вступили в силу.
fisherman/simple
fisherman/z
omf/thefuck
omf/grc
Этот механизм только устанавливает плагины и отсутствующие зависимости. Чтобы удалить плагин, используйте fisher rm
.
7. Где я могу найти список плагинов для fish?
Используйте поиск по Github организации или онлайн поиск на сайте.
8. Что такое плагин?
Плагином является:
-
каталог или git репозиторий с файлом
.fish
либо на корневом уровне проекта, либо в директорииfunctions
-
тема или оформление командной строки, т.е.
fish_prompt.fish
,fish_right_prompt.fish
или оба файла -
сниппет, т.е. один или несколько
.fish
файлов в директорииconf.d
, которые fish читает при запуске
9. Как я могу объявить зависимости моего плагина?
Создайте новый fishfile
в корне вашего проекта со списком зависимостей.
owner/repo
https://github.com/dude/sweet
https://gist.github.com/bucaran/c256586044fea832e62f02bc6f6daf32