Translation: Ukrainian version (#464)

* add ukrainian translation * fix UA translate in readme * fix UA translation in faq * fix UA translation in packages.md * fix documentation link
2024-11-22 10:59:45 +08:00 · 2017-01-04 21:57:32 +02:00 · 2017-01-04 21:57:32 +02:00 · 0d820b18d7
commit 0d820b18d7
parent f7c95e1b6a
12 changed files with 306 additions and 1 deletions
--- a/README.md
+++ b/README.md
@ -11,6 +11,7 @@ Oh My Fish provides core infrastructure to allow you to install packages which e
 > Also in&nbsp;
 > <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>

--- a/docs/en-US/FAQ.md
+++ b/docs/en-US/FAQ.md
@ -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>

--- a/docs/en-US/Packages.md
+++ b/docs/en-US/Packages.md
@ -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
--- a/docs/ru-RU/FAQ.md
+++ b/docs/ru-RU/FAQ.md
@ -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>

--- a/docs/ru-RU/Packages.md
+++ b/docs/ru-RU/Packages.md
@ -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>

 # Создание

--- a/docs/ru-RU/README.md
+++ b/docs/ru-RU/README.md
@ -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>

--- a/docs/uk-UA/FAQ.md
+++ b/docs/uk-UA/FAQ.md
@ -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
+```
--- a/docs/uk-UA/Packages.md
+++ b/docs/uk-UA/Packages.md
@ -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
--- a/docs/uk-UA/README.md
+++ b/docs/uk-UA/README.md
@ -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
--- a/docs/zh-CN/FAQ.md
+++ b/docs/zh-CN/FAQ.md
@ -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>

--- a/docs/zh-CN/Packages.md
+++ b/docs/zh-CN/Packages.md
@ -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>

--- a/docs/zh-CN/README.md
+++ b/docs/zh-CN/README.md
@ -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>