From 9c1464fdb038179085e00edce2d5767889d64c74 Mon Sep 17 00:00:00 2001 From: Denis Denisov Date: Sat, 23 Apr 2016 11:34:24 +0300 Subject: [PATCH] Add Russian docs for 2.0 (#209) --- README.md | 3 +- docs/ru-RU/README.md | 214 +++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 216 insertions(+), 1 deletion(-) create mode 100644 docs/ru-RU/README.md diff --git a/README.md b/README.md index dc4787a..4d06d42 100644 --- a/README.md +++ b/README.md @@ -11,6 +11,7 @@ [Español]: docs/es-ES [简体中文]: docs/zh-CN [日本語]: docs/jp-JA +[Русский]: docs/ru-RU [![Build Status][travis-badge]][travis-link] [![Slack][slack-badge]][slack-link] @@ -19,7 +20,7 @@ fisherman is a concurrent plugin manager for the [fish shell]. -Read this document in another language: [Español], [日本語], [简体中文]. +Read this document in another language: [Español], [日本語], [简体中文], [Русский]. ## Why? diff --git a/docs/ru-RU/README.md b/docs/ru-RU/README.md new file mode 100644 index 0000000..7bd9d54 --- /dev/null +++ b/docs/ru-RU/README.md @@ -0,0 +1,214 @@ +[slack-link]: https://fisherman-wharf.herokuapp.com/ +[slack-badge]: https://img.shields.io/badge/slack-join%20the%20chat-00B9FF.svg?style=flat-square +[travis-link]: https://travis-ci.org/fisherman/fisherman +[travis-badge]: https://img.shields.io/travis/fisherman/fisherman.svg?style=flat-square + +[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]: docs/es-ES +[简体中文]: docs/zh-CN +[日本語]: docs/jp-JA +[Русский]: docs/ru-RU + +[![Build Status][travis-badge]][travis-link] +[![Slack][slack-badge]][slack-link] + +# [fisherman] - fish shell plugin manager + +fisherman это параллельный менеджер плагинов для [fish shell]. + +Прочитать этот документ на другом языке: [English], [Español], [日本語], [简体中文]. + +## Почему? + +* Простой + +* Нет конфигурации + +* Нет внешних зависимостей + +* Не влияет на время старта оболочки + +* Использовать его в интерактивном режиме или _a la_ vundle + +* Только самое необходимое: установить, обновить, удалить, список и помощь + +## Установка + +Скопируйте `fisher.fish` в `~/.config/fish/functions` каталог и все. + +```sh +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 +``` + +Установить из локального каталога. + +```sh +fisher ~/my_aliases +``` + +Использовать в интерактивном-режиме. Редактировать fishfile и запустить `fisher`, чтобы удовлетворить изменения. + +> [Что такое fishfile и как я могу его использовать?](#6-what-is-a-fishfile-and-how-do-i-use-it) + +```sh +$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` для [сниппет](#8-what-is-a-plugin) поддержки. + +```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. + +```sh +echo "/usr/local/bin/fish" | sudo tee -a /etc/shells +chsh -s /usr/local/bin/fish +``` + +### 3. Как мне удалить fisherman? + +Запустить + +```fish +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. Что такое плагин? + +Плагин является: + +1. каталог или git repo с функцией `.fish` файл либо на корневом уровне проекта или внутри `functions` директории + +2. тема или приглашение, т.е., `fish_prompt.fish`, `fish_right_prompt.fish` или оба файла + +3. фрагмент, т.е., один или более `.fish` файлов внутри папки по имени `conf.d` которые оцениваются fish при запуске оболочки + +### 9. Как я могу получит список плагинов в качестве зависимостей для моего плагина? + +Создать новый файл `fishfile` в корневом каталоге вашего проекта и записи в зависимости плагин. + +```fish +owner/repo +https://github.com/dude/sweet +https://gist.github.com/bucaran/c256586044fea832e62f02bc6f6daf32 +``` + +### 10. Что насчет fundle? + +fundle вдохновил меня, чтобы использовать пакет-файлы, но он имеет ограниченные возможностей и требует, чтобы вы изменили конфигурацию вашего fish.