fisher/docs/ru-RU/README.md

227 lines
6.6 KiB
Markdown
Raw Normal View History

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
[fish shell]: https://github.com/fish-shell/fish-shell
[fisherman]: https://github.com/fisherman.sh
[организации]: https://github.com/fisherman
[онлайн]: http://fisherman.sh/#search
[English]: ../../README.md
[Español]: ../es-ES
[简体中文]: ../zh-CN
[日本語]: ../jp-JA
[Русский]: ../ru-RU
2016-04-25 09:53:04 +02:00
[한국어]: ../ko-KR
2016-04-25 20:28:36 +02:00
[Català]: ../ca-ES
2016-04-23 10:34:24 +02:00
[![Build Status][travis-badge]][travis-link]
[![Slack][slack-badge]][slack-link]
# [fisherman] - fish shell plugin manager
fisherman это параллельный менеджер плагинов для [fish shell].
2016-04-25 20:28:36 +02:00
Прочитать этот документ на другом языке: [English], [Español], [日本語], [简体中文], [한국어], [Català].
2016-04-23 10:34:24 +02:00
## Достоинства fisherman
2016-04-23 10:34:24 +02:00
* Не нужно настраивать
2016-04-23 10:34:24 +02:00
* Нет внешних зависимостей
* Не влияет на время запуска оболочки
2016-04-23 10:34:24 +02:00
* Можно использовать в интерактивном режиме или а-ля vundle
2016-04-23 10:34:24 +02:00
* Только необходимые функции: установка, обновление, удаление, список установленного и справка
2016-04-23 10:34:24 +02:00
## Установка
Используя curl:
2016-04-23 10:34:24 +02:00
```sh
curl -Lo ~/.config/fish/functions/fisher.fish --create-dirs git.io/fisherman
```
Используя npm:
```sh
npm i -g fisherman
```
Если вы ещё используете версию 1.5 и хотите обновиться до >2.0 без особых хлопот:
```
curl -L git.io/fisher-up-me | fish
```
2016-04-23 10:34:24 +02:00
## Использование
Установка отдельного плагина.
2016-04-23 10:34:24 +02:00
```
fisher simple
```
Установка из нескольких источников.
```
fisher z fzf omf/{grc,thefuck}
```
Установка по ссылке URL.
2016-04-23 10:34:24 +02:00
```
fisher https://github.com/edc/bass
```
Установка из gist.
2016-04-23 10:34:24 +02:00
```
fisher https://gist.github.com/username/1f40e1c6e0551b2666b2
```
Установка из локального каталога.
2016-04-23 10:34:24 +02:00
```sh
fisher ~/my_aliases
```
Использование в интерактивном-режиме. Отредактируйте fishfile и запустите `fisher`, чтобы изменения вступили в силу.
2016-04-23 10:34:24 +02:00
> [Что такое fishfile и как я могу его использовать?](#6-Что-такое-fishfile-и-как-я-могу-его-использовать)
2016-04-23 10:34:24 +02:00
```sh
$EDITOR fishfile # добавьте плагины
2016-04-23 10:34:24 +02:00
fisher
```
Просмотр установленных плагинов.
2016-04-23 10:34:24 +02:00
```
fisher ls
@ my_aliases # этот плагин представляет собой локальный каталог
* simple # этот плагин является текущим оформлением командной строки
2016-04-23 10:34:24 +02:00
bass
fzf
grc
thefuck
z
```
Обновление всего сразу.
2016-04-23 10:34:24 +02:00
```
fisher up
```
Обновление отдельных плагинов.
2016-04-23 10:34:24 +02:00
```
fisher up bass z fzf thefuck
```
Удаление плагинов.
2016-04-23 10:34:24 +02:00
```
fisher rm simple
```
Удаление всех плагинов.
2016-04-23 10:34:24 +02:00
```
fisher ls | fisher rm
```
Справка по плагину.
2016-04-23 10:34:24 +02:00
```
fisher help z
```
## Часто задаваемые вопросы
### 1. Какая версия fish необходима?
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
```
### 2. Как сделать fish основной командной оболочкой?
2016-04-23 10:34: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
```
### 3. Как мне удалить fisherman?
```fish
fisher self-uninstall
```
или
```fish
npm un -g fisherman
```
### 4. Совместим ли fisherman с темами и плагинами oh my fish?
2016-04-23 10:34:24 +02:00
Да.
### 5. Где fisherman хранит данные?
2016-04-23 10:34:24 +02:00
Скрипт fisherman находится в `~/.config/fish/functions/fisher.fish`.
2016-04-23 10:34:24 +02:00
Кэш и настройки плагинов создаются в `~/.cache/fisherman` и `~/.config/fisherman` соответственно.
2016-04-23 10:34:24 +02:00
fishfile сохраняется в `~/.config/fish/fishfile`.
2016-04-23 10:34:24 +02:00
### 6. Что такое fishfile и как я могу его использовать?
В `~/.config/fish/fishfile` хранится список всех установленных плагинов.
2016-04-23 10:34:24 +02:00
fisherman обновляет этот файл автоматически, но вы также можете добавить плагины в список вручную и запустить `fisher`, чтобы эти изменения вступили в силу.
2016-04-23 10:34:24 +02:00
```
fisherman/simple
fisherman/z
omf/thefuck
omf/grc
```
Этот механизм только устанавливает плагины и отсутствующие зависимости. Чтобы удалить плагин, используйте `fisher rm`.
2016-04-23 10:34:24 +02:00
### 7. Где я могу найти список плагинов для fish?
2016-04-23 10:34:24 +02:00
Используйте поиск по Github [организации] или [онлайн] поиск на сайте.
2016-04-23 10:34:24 +02:00
### 8. Что такое плагин?
Плагином является:
2016-04-23 10:34:24 +02:00
1. каталог или git репозиторий с файлом `.fish` либо на корневом уровне проекта, либо в директории `functions`
2016-04-23 10:34:24 +02:00
2. тема или оформление командной строки, т.е. `fish_prompt.fish`, `fish_right_prompt.fish` или оба файла
2016-04-23 10:34:24 +02:00
3. сниппет, т.е. один или несколько `.fish` файлов в директории `conf.d`, которые fish читает при запуске
2016-04-23 10:34:24 +02:00
### 9. Как я могу объявить зависимости моего плагина?
2016-04-23 10:34:24 +02:00
Создайте новый `fishfile` в корне вашего проекта со списком зависимостей.
2016-04-23 10:34:24 +02:00
```fish
owner/repo
https://github.com/dude/sweet
https://gist.github.com/bucaran/c256586044fea832e62f02bc6f6daf32
```