Archives
/
oh-my-fish
mirror of https://github.com/oh-my-fish/oh-my-fish
2
0
Fork 0
Code Issues Projects Releases Wiki Activity

Translation: Ukrainian version (#464)

Browse Source 
* add ukrainian translation

* fix UA translate in readme

* fix UA translation in faq

* fix UA translation in packages.md

* fix documentation link
pull/468/head
Andrew Komarnitskyi 8 years ago committed by Stephen M. Coakley
parent f7c95e1b6a
commit 0d820b18d7
12 changed files with 306 additions and 1 deletions
Show Stats Download Patch File Download Diff File

1
README.md
Unescape Escape View File

@ -11,6 +11,7 @@ Oh My Fish provides core infrastructure to allow you to install packages which e
> Also in 
> <a href="docs/ru-RU/README.md">🇷🇺</a>
> <a href="docs/zh-CN/README.md">🇨🇳</a>
> <a href="docs/uk-UA/README.md">🇺🇦</a>
<br>

1
docs/en-US/FAQ.md
Unescape Escape View File

@ -6,6 +6,7 @@
> Oh My Fish Documentation&nbsp;&bull;&nbsp;Also in
> <a href="../ru-RU/FAQ.md">🇷🇺</a>
> <a href="../zh-CN/FAQ.md">🇨🇳</a>
> <a href="../uk-UA/FAQ.md">🇺🇦</a>
<br>

3
docs/en-US/Packages.md
Unescape Escape View File

@ -6,6 +6,7 @@
> Oh My Fish Documentation&nbsp;&bull;&nbsp;Also in
> <a href="../ru-RU/Packages.md">🇷🇺</a>
> <a href="../zh-CN/Packages.md">🇨🇳</a>
> <a href="../uk-UA/Packages.md">🇺🇦</a>
<br>
@ -137,4 +138,4 @@ This will add a new entry to your local copy of the registry. Now you just need
[fish-bind]: http://fishshell.com/docs/current/commands.html#bind
[omf-pulls-link]: https://github.com/oh-my-fish/oh-my-fish/pulls
[omf-pulls-link]: https://github.com/oh-my-fish/oh-my-fish/pulls

1
docs/ru-RU/FAQ.md
Unescape Escape View File

@ -6,6 +6,7 @@
> Oh My Fish Documentation&nbsp;&bull;&nbsp;Also in
> <a href="../en-US/FAQ.md">🇺🇸</a>
> <a href="../zh-CN/FAQ.md">🇨🇳</a>
> <a href="../uk-UA/FAQ.md">🇺🇦</a>
<br>

1
docs/ru-RU/Packages.md
Unescape Escape View File

@ -6,6 +6,7 @@
> Oh My Fish Documentation&nbsp;&bull;&nbsp;Also in
> <a href="../en-US/Packages.md">🇺🇸</a>
> <a href="../zh-CN/Packages.md">🇨🇳</a>
> <a href="../uk-UA/Packages.md">🇺🇦</a>
# Создание

1
docs/ru-RU/README.md
Unescape Escape View File

@ -10,6 +10,7 @@ Oh My Fish обеспечивает базовую инфраструктуру,
> Also in&nbsp;
> <a href="../../README.md">🇺🇸</a>
> <a href="../zh-CN/README.md">🇨🇳</a>
> <a href="../uk-UA/README.md">🇺🇦</a>
<br>

89
docs/uk-UA/FAQ.md
Unescape Escape View File

@ -0,0 +1,89 @@
<img src="https://cdn.rawgit.com/oh-my-fish/oh-my-fish/e4f1c2e0219a17e2c748b824004c8d0b38055c16/docs/logo.svg" align="left" width="128px" height="128px"/>
<img align="left" width="0" height="128px"/>
# FAQ
> Oh My Fish Documentation&nbsp;&bull;&nbsp;Also in
> <a href="../en-US/FAQ.md">🇺🇸</a>
> <a href="../zh-CN/FAQ.md">🇨🇳</a>
> <a href="../uk-UA/FAQ.md">🇺🇦</a>
<br>
Дякуємо, що знайшли час прочитати цей FAQ. Не соромтесь створювати новий Issue, якщо Ви не змогли знайти відповідь на своє питання тут.
## Що таке Oh My Fish та для чого він мені потрібен?
Oh My Fish це _фреймворк_ для [Fishshell](http://fishshell.com/). Він допомагає в керуванні Вашими налаштуваннями, темами та пакетами.
## Що мені потрібно знати, для того щоб використовувати Oh My Fish?
_Нічого_. Ви можете встановити Oh My Fish та продовжувати використовувати Fish як зазвичай. Коли Ви захочете дізнатися більше, просто наберіть `omf help`.
## Що таке пакети в Oh My Fish?
Пакети в Oh My Fish - це теми та плагіни, написані на fish, які наслідують базову функціональність Shell, запускають код під час ініціалізації, додають автодоповнення до знайомих утиліт, тощо.
## Які типи пакетів існують в Oh My Fish?
Існує 3 основних типи пакетів:
1. Конфігураційні утиліти. Наприклад, [`pkg-pyenv`](https://github.com/oh-my-fish/pkg-pyenv) перевіряє, чи існує `pyenv` у вашій системі та запускає `(pyenv init - | psub)` для вас при запуску Fish.
2. Теми. Ознайомитися з ними можна [тут](https://github.com/oh-my-fish).
3. Традиційні утиліти оболонки. Наприклад, [`pkg-copy`](https://github.com/oh-my-fish/pkg-copy) — утиліта буферу обміну, сумісна із Linux та OSX.
## Що саме робить Oh My Fish?
+ Запускає `$OMF_CONFIG/before.init.fish`, якщо доступно.
+ Автозавантаження встановлених пакетів та тем із `$OMF_PATH/`.
+ Автозавантаження шляху до вашого конфігу. За замовчуванням це `~/.config/omf`, але його можна налаштувати через `$OMF_CONFIG`.
+ Автозавантаження будь-яких `функцій` із `$OMF_PATH` та `$OMF_CONFIG`
+ Запускає `$OMF_CONFIG/init.fish`, якщо доступно.
## Як я можу оновити поточну версію Oh My Fish?
> :warning: Не забудьте спочатку зробити резервну копію ваших dotfiles та інших важливих данних.
```
curl -L github.com/oh-my-fish/oh-my-fish/raw/master/bin/install | sh
```
Тепер ви можете безпечно видалити `$fish_path`.
```fish
rm -rf "$fish_path"
```
## Як я можу використовувати fish в якості оболонки за замовуванням?
Додайте Fish в `/etc/shells`:
```sh
echo "/usr/local/bin/fish" | sudo tee -a /etc/shells
```
Зробіть Fish вашою оболонкою за замовчуванням:
```sh
chsh -s /usr/local/bin/fish
```
Для того щоб переключитися на іншу оболонку:
> Замініть `/bin/bash` на `/bin/tcsh` або `/bin/zsh` для відповідних оболонок.
```sh
chsh -s /bin/bash
```

90
docs/uk-UA/Packages.md
Unescape Escape View File

@ -0,0 +1,90 @@
<img src="https://cdn.rawgit.com/oh-my-fish/oh-my-fish/e4f1c2e0219a17e2c748b824004c8d0b38055c16/docs/logo.svg" align="left" width="128px" height="128px"/>
<img align="left" width="0" height="128px"/>
# Packages
> Oh My Fish Documentation&nbsp;&bull;&nbsp;Also in
> <a href="../en-US/Packages.md">🇺🇸</a>
> <a href="../zh-CN/Packages.md">🇨🇳</a>
> <a href="../uk-UA/Packages.md">🇺🇦</a>
# Створення
Для того щоб навчитися створювати пакети, давайте створимо новий пакет, який буде виводити команду `hello_world` для вашей оболочки. Імена пакетів можуть містити лише символи нижнього регістру та символ підкреслення для розділення слів.
Oh My Fish може згенерувати структуру пакету для вас. Використовуйте команду `omf new`:
```fish
$ omf new pkg hello_world
```
> Використовуйте `omf new theme my_theme_name` для тем.
Утиліта змінює поточну директорію на щойно створений пакет:
```
$ ls -l
README.md
hello_world.fish
completions/hello_world.fish
```
Завжди описуйте, як працює Ваш пакет в `README.md`. Також почитайте більше про [автодоповнення](http://fishshell.com/docs/current/commands.html#complete) і потурбуйтесь про те, щоб надати його для ваших утиліт, коли це можливо.
`hello_world.fish` визначає одну функцію:
```fish
function hello_world -d "Prints hello world"
echo "Hello World!"
end
```
кожна функція у вашому пакеті повинна бути оголошена в своєму власному файлі. Це вимога механізму автозавантаження fish, який завантажує функції за запитом, уникаючи, таким чином, завантаження непотрібних функцій.
Майте на увазі, що fish не має приватної області видимості, тому якщо вам необхідно розділити пакет на функції, додайте подібний префікс до функцій:
`__hello_world.my_extra_function`. Це допоможе уникнути співпадіння імен та забруднення глобального простору імен.
# Події
Пакети були спроектовані так, щоб використовувати переваги подій fish. На поточний момент існує дві події які Oh My Fish буде передавати вашому пакету:
## Ініціалізація
Якщо ви хочете бути [попереджені](http://fishshell.com/docs/current/commands.html#emit) коли ваш пакет завантажується, оголосіть наступну функцію у вашому `hello_world.fish`:
```fish
function init -a path --on-event init_hello_world
echo "hello_world initialized"
end
```
Використовуйте цю подію, щоб модифікувати оточення, завантажувати ресурси, автоматично завантажувати функції і т.д. Якщо ваш пакет не експортує ніяких функцій, ви все одно можете використовувати цю подію для розширення функціональності пакету.
## Видалення
Oh My Fish генерує подію `uninstall_<pkg>` перед видаленням пакету з допомогою команди `omf remove <pkg>`. Підписники можуть використовувати цю подію, для очищення кастомних ресурсів, тощо.
```fish
function uninstall --on-event uninstall_hello_world
end
```
# Зробіть його публічним
Oh My Fish зберігає реєстр публічних пакетів у `$OMF_PATH/db/`.
Для того щоб додати ваш пакет у реєстр, введіть в консолі:
```fish
# Для пакетів:
omf submit pkg/hello_world .../hello_world.git
# Для тем:
omf submit theme/my_theme .../my_theme_name.git
```
Це додасть нову сутність у ваш локальный реєстр. Тепер вам просто потрібно [надіслати нам PR][omf-pulls-link], щоб оновити глобальний реєстр.
[omf-pulls-link]: https://github.com/oh-my-fish/oh-my-fish/pulls

117
docs/uk-UA/README.md
Unescape Escape View File

@ -0,0 +1,117 @@
<img src="https://cdn.rawgit.com/oh-my-fish/oh-my-fish/e4f1c2e0219a17e2c748b824004c8d0b38055c16/docs/logo.svg" align="left" width="192px" height="192px"/>
<img align="left" width="0" height="192px" hspace="10"/>
> The <a href="http://fishshell.com">Fishshell</a> Framework
[![MIT License](https://img.shields.io/badge/license-MIT-007EC7.svg?style=flat-square)](/LICENSE.md) [![Fish Shell Version](https://img.shields.io/badge/fish-v2.2.0-007EC7.svg?style=flat-square)](http://fishshell.com) [![Travis Build Status](http://img.shields.io/travis/oh-my-fish/oh-my-fish.svg?style=flat-square)](https://travis-ci.org/oh-my-fish/oh-my-fish) [![Slack Status](https://oh-my-fish-slack.herokuapp.com/badge.svg)](https://oh-my-fish-slack.herokuapp.com)
Oh My Fish надає базову інфраструктуру, щоб забезпечити встановлення пакетів які розширюють та модифікують зовнішній вигляд вашої оболонки. Він швидкий, розширюваний та легкий у використанні.
> Also in&nbsp;
> <a href="../../README.md">🇺🇸</a>
> <a href="../zh-CN/README.md">🇨🇳</a>
> <a href="../uk-UA/README.md">🇺🇦</a>
<br>
# Встановлення
```fish
curl -L https://github.com/oh-my-fish/oh-my-fish/raw/master/bin/install | fish
omf help
```
Або _завантажте_ та запустіть власноруч:
```fish
curl -L https://github.com/oh-my-fish/oh-my-fish/raw/master/bin/install > install
fish install
```
# Туторіал
Oh My Fish містить невелику утиліту `omf` для завантаження та встановлення нових пакетів та тем.
#### `omf update`
Оновлює фреймворк та встановлені пакети.
#### `omf install` _`[<name>|<url>]`_
Встановлює один _або більше_ пакетів.
- Ви можете встановити пакети по URL за допомогою команди `omf install URL`
- Коли викликається без аргументів, встановлює відсутні пакети із [bundle](#Файли-конфигурації).
#### `omf list`
Список встановлених пакетів.
#### `omf theme` _`<theme>`_
Задіює тему. Для того щоб отримати список доступних тем, виконайте `omf theme`. Також ви можете попередньо проглянути усі [доступні теми](../Themes.md) перед встановленням.
#### `omf remove` _`<name>`_
Видаляє тему або пакет.
> Пакети, підписані на події `uninstall_<pkg>`, повідомлюються перед тим, як пакет буде видалено, завдяки цьому може бути реалізоване кастомне очищення ресурсів. Читайте детальніше про [видалення](Packages.md#Видалення) пакетів в Oh My Fish.
#### `omf new pkg | theme` _`<name>`_
Генерує новий пакет чи тему.
> Створює нову директорію у `$OMF_CONFIG/{pkg | themes}/` із шаблоном.
#### `omf submit` _`pkg/<name>`_ _`[<url>]`_
Додає новий пакет. Щоб додати тему, використовуйте `omf submit` _`themes/<name>`_ _`<url>`_.
Переконайтесь що [надіслали нам PR][omf-pulls-link], щоб оновити реєстр.
#### `omf doctor`
Використовуйте для усунення проблем перед [створенням нового issue][omf-issues-new].
#### `omf destroy`
Видаляє Oh My Fish.
# Для досвідчених
Встановлювач Oh My Fish поміщає код для стартау у вашому файлі конфігурації (`~/.config/fish/config.fish`).
## Стартап
Кожного разу, кколи ви відкриваєте новий shell, стартап код ініціалізує Oh My Fish шлях встановлення і _конфіг_ шлях (`~/.config/omf` за замовчуванням), потім запускає [`init.fish`](../../init.fish) скрипт, який автоматично завантажує пакети, теми та ваші кастомні init файли. Із деталями можна ознайомитися у [FAQ](FAQ.md#Що саме робить Oh My Fish?).
## Файли конфігурації
Каталог `$OMF_CONFIG` надає стан користувача Oh My Fish, і це чудовий кандидат для додаваняня у ваші dotfiles і/або в систему контролю версій. Тут міститься чотири важливих файли:
- __`theme`__ - Поточна тема
- __`bundle`__ - Список встановлених пакетів/тем
- __`init.fish`__ - Кастомний скрипт, що запускається після запуску shell
- __`before.init.fish`__ - Кастомний скрипт, що запускається перед запуском shell
Наполеглево рекомендується додавати свої стартап команди у файл `init.fish` замість `~/.config/fish/config.fish`, так как як це дозволяє вам тримати весь каталог `$OMF_CONFIG` в системі контролю версій.
Якщо вам потрібно запускати стартап команди *перед* тим, як Oh My Fish почне завантажувати плагіни, помістіть їх в `before.init.fish`. Якщо ви не впевнені, як правило, краще помістити їх в `init.fish`.
### Про `bundle`
Кожного разу, коли пакет/тема встановлюється чи видаляється, `bundle` файл оновлюється. Також ви можете відредагувати його і поітм запустити `omf install` щоб зафіксувати зміни. Будь ласка, зверніть увагу: якщо пакети/теми додані в `bundle`, вони автоматично встановлюються, в той час як пакети/теми, видалені із `bundle` файлу, не видаляються із користувацької папки.
## Створення пакетів
Oh My Fish використовує сучасну та добре виділену архітектуру плагінів для спрощення їх розробки, включаючи події ініціалізації/видалення та функції автозавантаження.
[Дивіться документацію](Packages.md), щоб дізнатися детальніше.
[fishshell]: http://fishshell.com
[contributors]: https://github.com/oh-my-fish/oh-my-fish/graphs/contributors
[omf-pulls-link]: https://github.com/oh-my-fish/oh-my-fish/pulls
[omf-issues-new]: https://github.com/oh-my-fish/oh-my-fish/issues/new

1
docs/zh-CN/FAQ.md
Unescape Escape View File

@ -6,6 +6,7 @@
> Oh My Fish Documentation&nbsp;&bull;&nbsp;Also in
> <a href="../en-US/FAQ.md">🇺🇸</a>
> <a href="../ru-RU/FAQ.md">🇷🇺</a>
> <a href="../uk-UA/FAQ.md">🇺🇦</a>
<br>

1
docs/zh-CN/Packages.md
Unescape Escape View File

@ -6,6 +6,7 @@
> Oh My Fish Documentation&nbsp;&bull;&nbsp;Also in
> <a href="../en-US/Packages.md">🇺🇸</a>
> <a href="../ru-RU/Packages.md">🇷🇺</a>
> <a href="../uk-UA/Packages.md">🇺🇦</a>
<br>

1
docs/zh-CN/README.md
Unescape Escape View File

@ -10,6 +10,7 @@ Oh My Fish 提供核心基础设施的配置，允许每个人可以轻松安装
> Also in&nbsp;
> <a href="../../README.md">🇺🇸</a>
> <a href="../ru-RU/README.md">🇷🇺</a>
> <a href="../uk-UA/README.md">🇺🇦</a>
<br>

Write Preview
Loading…
Cancel
Save