6.5 KiB
fisherman - fish shell plugin manager
fisherman это параллельный менеджер плагинов для fish shell.
Прочитать этот документ на другом языке: English, Español, 日本語, 简体中文.
Почему?
-
Простой
-
Нет конфигурации
-
Нет внешних зависимостей
-
Не влияет на время старта оболочки
-
Использовать его в интерактивном режиме или a la vundle
-
Только самое необходимое: установить, обновить, удалить, список и помощь
Установка
Скопируйте 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
Использовать в интерактивном-режиме. Редактировать 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 был построен для рыб >= 2.3.0. Если вы используете 2.2.0, добавьте следующий код в ваш ~/.config/fish/config.fish
для сниппет поддержки.
for file in ~/.config/fish/conf.d/*.fish
source $file
end
2. Как мне установить fish на ОС х?
Add fish to the list of login shells in /etc/shells
and make it your default shell.
echo "/usr/local/bin/fish" | sudo tee -a /etc/shells
chsh -s /usr/local/bin/fish
3. Как мне удалить fisherman?
Запустить
fisher self-uninstall
4. Совместим fisherman с oh my fish темами и плагины?
Да.
5. Почему так положил fisherman данные?
fisherman уходит в ~/.config/fish/functions/fisher.fish
.
Кэш и настройки плагина создается в ~/.cache/fisherman
и ~/.config/fisherman
соответственно.
В fishfile сохраняется в ~/.config/fish/fishfile
.
6. Что такое fishfile и как я могу его использовать?
В fishfile ~/.config/fish/fishfile
выводит список всех установленных плагинов.
Вы можете позволить fisherman сохранить этот файл для вас автоматически, или оставить в плагины и запустить fisher
, чтобы удовлетворить эти изменения.
fisherman/simple
fisherman/z
omf/thefuck
omf/grc
Этот механизм устанавливает только плагины и отсутствующие зависимости. Чтобы удалить плагин, используйте fisher rm
вместо этого.
7. Где я могу найти список fish плагинов?
Используя поиск в организации или онлайн поиск для изучения содержимого.
8. Что такое плагин?
Плагин является:
-
каталог или git repo с функцией
.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
10. Что насчет fundle?
fundle вдохновил меня, чтобы использовать пакет-файлы, но он имеет ограниченные возможностей и требует, чтобы вы изменили конфигурацию вашего fish.