Archives/fisher

Fork 0

mirror of https://github.com/jorgebucaran/fisher synced 2024-11-05 12:00:17 +00:00

Jorge Bucaran 59000414e8

Docs.

2016-05-14 14:17:27 +09:00

5.4 KiB

Raw Blame History

fisherman

fisherman это параллельный менеджер плагинов для fish.

Установка

Используя curl:

curl -Lo ~/.config/fish/functions/fisher.fish --create-dirs git.io/fisherman

Использование

Установка отдельного плагина.

fisher real

Установка из нескольких источников.

fisher z fzf edc/bass omf/thefuck

Установка по ссылке URL.

fisher https://github.com/edc/bass

Установка из gist.

fisher https://gist.github.com/username/1f40e1c6e0551b2666b2

Установка из локального каталога.

fisher ~/plugin

Отредактируйте fishfile и запустите fisher, чтобы изменения вступили в силу.

$EDITOR fishfile # добавьте плагины
fisher

Список установленных плагинов.

fisher ls
@ plugin      # этот плагин представляет собой локальный каталог
* real        # этот плагин является текущим оформлением командной строки
  bass
  fzf
  grc
  thefuck
  z

Список доступных плагинов.

fisher ls-remote

Обновление всего сразу.

fisher up

Обновление отдельных плагинов.

fisher up bass z fzf thefuck

Удаление плагинов.

fisher rm thefuck

Удаление всех плагинов.

fisher ls | fisher rm

Справка по плагину.

fisher help z

Часто задаваемые вопросы

Какая версия 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

Как сделать fish основной командной оболочкой?

Добавьте fish в список командных оболочек /etc/shells и сделайте её оболочкой по умолчанию.

echo "/usr/local/bin/fish" | sudo tee -a /etc/shells
chsh -s /usr/local/bin/fish

Как мне удалить fisherman?

fisher self-uninstall

Совместим ли fisherman с темами и плагинами oh my fish?

Да.

Где fisherman хранит данные?

Скрипт fisherman находится в ~/.config/fish/functions/fisher.fish.

Кэш и настройки плагинов создаются в ~/.cache/fisherman и ~/.config/fisherman соответственно.

fishfile сохраняется в ~/.config/fish/fishfile.

Что такое fishfile и как я могу его использовать?

В ~/.config/fish/fishfile хранится список всех установленных плагинов.

fisherman обновляет этот файл автоматически, но вы также можете добавить плагины в список вручную и запустить fisher, чтобы эти изменения вступили в силу.

fisherman/real
fisherman/z
omf/thefuck
omf/grc

Этот механизм только устанавливает плагины и отсутствующие зависимости. Чтобы удалить плагин, используйте fisher rm.

Где я могу найти список плагинов для fish?

Используйте поиск по Github организации или онлайн поиск на сайте.

Что такое плагин?

Плагином является:

каталог или git репозиторий с файлом .fish либо на корневом уровне проекта, либо в директории functions
тема или оформление командной строки, т.е. fish_prompt.fish, fish_right_prompt.fish или оба файла
сниппет, т.е. один или несколько .fish файлов в директории conf.d, которые загружаются при запуске fish

Как я могу объявить зависимости моего плагина?

Создайте новый fishfile в корне вашего проекта со списком зависимостей.

owner/repo
https://github.com/owner/repo
https://gist.github.com/owner/c256586044fea832e62f02bc6f6daf32

5.4 KiB Raw Blame History Unescape Escape