diff --git a/lib/locale-uk-UA.json b/lib/locale-uk-UA.json new file mode 100644 index 0000000000..06b40437db --- /dev/null +++ b/lib/locale-uk-UA.json @@ -0,0 +1,8 @@ +{ + "n": { + }, + "v": { + }, + "adj": { + } +} \ No newline at end of file diff --git a/lib/locale.js b/lib/locale.js index 434fc5b8b7..eacde7462b 100644 --- a/lib/locale.js +++ b/lib/locale.js @@ -11,7 +11,8 @@ var available = { 'ja-JP': '日本語', 'zh-TW': '中文(臺灣)', 'ko-KR': '한국어', - 'pt-BR': 'Português Brasileiro' + 'pt-BR': 'Português Brasileiro', + 'uk-UA': 'Українська' } /** @@ -24,7 +25,8 @@ var aliases = { 'ja': 'ja-JP', 'zh': 'zh-TW', 'kr': 'ko-KR', - 'br': 'pt-BR' + 'br': 'pt-BR', + 'uk': 'uk-UA' } /** diff --git a/resources/contents/uk-UA/challenges/10_requesting_you_pull_please.html b/resources/contents/uk-UA/challenges/10_requesting_you_pull_please.html new file mode 100644 index 0000000000..7d71e1e4dd --- /dev/null +++ b/resources/contents/uk-UA/challenges/10_requesting_you_pull_please.html @@ -0,0 +1,57 @@ + +
+

Надішліть Pull Request до оригінального Patchwork репозиторію.

+
+ +
+

Pull реквести

+

Часто, коли ви робите зміни до проекту над яким ви працюєте (forked), ви хочете надіслати ці зміни до + упорядника проекту і зробити запит, щоб вони могли затягнути ваші зміни до віддаленого + репозиторію, таким чином будь-хто може скористатися оновленнями які ви внесли - це pull request.

+ +

Ми хочемо додати вас до списку тих хто завершив воркшоп, будь ласка, зробіть pull request щоб додати + ваш файл з іменем до першоджерела: github.com/jlord/patchwork.

+ + An illustration showing two options. The latter option contains more of the alphabet than the first and is asking the first to accept its work so that the alapabet is complete. +
+ +
+

Створення pull request

+

Відвідайте початковий репозиторій який ви (forked) на GitHub, в нашому випадку це http://github.com/jlord/patchwork. +

+ +

Часто GitHub буде відслідковувати чи ви викладали гілку до віддаленого репозиторію і показувати її в верхній частині веб-сайту. + Якщо гілка з назвою 'add-username' присутня, ви можете створити Pull Request натиснувшити на неї. Якщо ні: +

+ + + +

Тепер ви зможете побачити сторінку з деталями про pull request який зараз знаходиться у процесі надсилання. + Ця сторінка показує комміти та зміни, у вигляді схеми, повязаними з вашим pull request і в порівнянні з 'gh-pages' + гілкою з початкового репозиторію.

+ +

Якщо початковий репозиторій має contribution documentation, GitHub вкаже посилання на неї. + Це документація від власників репозиторію, яка описує як робити зміни в цей проект і якшо ви хочете, щоб ваші зміни + були додані, варто звернути на неї увагу.

+ +

Якщо все на сторінці виглядає так як ви очікуєте:

+ + + +

Бінго! Ви додали pull request - зупиніться на хвильку і насолодіться моментом. + +

Якщо все добре з вашим pull request, він буде злитий протягом декількох секунд. Якщо він не був автоматично злитий + протягом декількох хвилин, скоріше за все ви отримаєте коментарі від @reporobot чому злиття не пройшло вдало. + Якщо такі коментарі присутні, закрийте pull request на GitHub, внесіть необхідні зміни до вашої гілки, надішліть зміни + до репозиторію та перевідкрийте ваш pull request, що в свою чергу змусить @reporobot переглянути їх знову.

+
+ +{{{ verify_button }}} diff --git a/resources/contents/uk-UA/challenges/11_merge_tada.html b/resources/contents/uk-UA/challenges/11_merge_tada.html new file mode 100644 index 0000000000..9da8298631 --- /dev/null +++ b/resources/contents/uk-UA/challenges/11_merge_tada.html @@ -0,0 +1,66 @@ +
+

Мердж гілки локально, видалення гілки зтягнення з upstream.

+
+ +
+

Очищення

+ +

Якщо гілки більше не потрібні, ви можете видалити їх локально і віддалено. Вчасне видалення - + зручний спосіб підтримання чистоти і зручної структурованості репозиторію.

+
+ +
+

Локальний мердж

+

Ваш pull request був злитий. Ваша гілка була злита в гілку 'gh-pages' оригінального репозиторію на GitHub. + Ви можете злити вашу гілку також локально.

+ +

Для початку, перемістіться у гілку в яку ви хочете змерджити, в нашому випадку це буде гілка 'gh-pages'.

+

git checkout gh-pages

+ +

Тепер вкажіть яку саме гілку ви хочете сюди змерджити. В цьому випадку, ваша гілку яка починається з "add-".

+

git merge <BRANCHNAME>

+ +

Очистіть репозиторій за рахунок видалення цієї гілки. Тепер коли вона вже була злита вам вона вже не потрібна тут.

+

git branch -d <BRANCHNAME>

+ +

Ви також можете видалити цю гілку з віддаленого репозиторію на GitHub:

+

git push <REMOTENAME> --delete <BRANCHNAME>

+
+ +
+

Затягнення з Upstream

+

І останній пункт, який також є дуже важливим, початковий репозиторій був змінений коли ваш pull request був злитий. + Reporobot додав ваше імя на веб-сайті. Якщо ви затягнете ці зміни з upstream, ви отримаєте зміни які є в тій версії також. + Ви можете переглянути їх в: yourusername.github.io/patchwork.

+ +

Щоб затягнути з original upstream:

+

git pull upstream gh-pages

+
+ +
+

Вітаємо!

+

Ви створили локальний репозиторій, віддалений репозиторій, попрацювали в парі, викладали, затягували і долучились + до міліонів інших розробників який розвивають та насичують open source!

+ +

Відвідайте jlord.github.io/patchwork щоб побачити своє ім'я! Думаєте що далі? Гляньте сюди.

+
+ +{{{ verify_directory_button }}} + +
+ +
+ + + diff --git a/resources/contents/uk-UA/challenges/1_get_git.html b/resources/contents/uk-UA/challenges/1_get_git.html new file mode 100644 index 0000000000..fca79a1cea --- /dev/null +++ b/resources/contents/uk-UA/challenges/1_get_git.html @@ -0,0 +1,63 @@ +
+

Встановіть Git на ваш комп'ютер та налаштуйте своє ім'я та email.

+
+ +
+

Git

+

Git - безкоштовний,(програмне забезпечення із відкритим вихідним кодом) створений Лінусом Торвальдом, який також написав операційну систему Linux.

+

Git - це програма відслідковування змін в проекті протягом розробки, відома в програмуванні як система контролю версій. + Якщо ви використовуєте функцію відслудковування змін у своєму текстовому редакторі чи IDE, ви уже знайомі із ідеєю контролю версій! +

+
+ +
+

Встановлення Git

+

Ми рекомендуємо встановлювати Git встановивши додаток GitHub + Desktop. Ми не використовуємо додаток у Git-it (ми вивчаємо термінал!) але він містить у собі Git і простий у встановленні для будь-якої операційної системи.

+ + + +

Уже маєте Git або не впевнені? Виконайте git --version у вашому терміналі, і якщо у відповідь отримаєте версію вище 1.7.10, тоді усе готово! Щоб отримати більше інформації, відвідайте Git + website.

+
+ +
+

Git Software

+

Додаток GitHub Desktop може робити багато речей з Git, але не все, тому вивчення терміналу є +          важливим. Але після вивчення роботи із Git через термінал, буде зручно перейти на Git Desktop App, через те що він уміє більш наочно показати інформацію.

+ +

Git не схожий на інші ваші програми, швидше за все ви не побачите його іконки на робочому столі, проте він завжди буде доступний у терміналі, або у графічному інтерфейсі Git Desktop App.

+
+ +
+

Конфігурація Git

+

Коли GitHub Desktop (і відповідно Git) буде встановлено, відкрийте свій термінал. + Ви можете перевірити Git просто ввівши:

+ +

git --version

+ +

Це перевне версію Git що встановлено на комп'юері, виглядатиме наступним чином:

+ +

git version 1.9.1

+ +

Далі, налаштуйте Git щоб він знав, із ким асоціювати те що ви робите:

+

Set your name:

+

git config --global user.name "Your Name"

+

Now set your email:

+

git config --global user.email "youremail@example.com"

+ +

Ви виконали перше завдання! Натисність кнопку 'Перевірити' щоб перевірити завдання.

+
+ +{{{ verify_button }}} + +
+

Символ долара в документації

+

Символ $ часто зустрічається в документації, щоб позначити що рядок відповідає коду командного рядка. Вам не потрібно вводити символ $ + , а лише те що слідує за ним.

+
diff --git a/resources/contents/uk-UA/challenges/2_repository.html b/resources/contents/uk-UA/challenges/2_repository.html new file mode 100644 index 0000000000..f649d9ae9f --- /dev/null +++ b/resources/contents/uk-UA/challenges/2_repository.html @@ -0,0 +1,65 @@ +
+

Створити новий репозиторій на вашому комп'ютері.

+
+ +
+

Репозиторії

+

Репозиторій це колекція схожих матеріалів. У нашому випадку, при написанні програмного забезпечення, це колекція файлів які відносяться до проекту. Ви можете уявити це як папку із файлами. Насправді, це так і виглядатиме на вашому комп'ютері. Інколи їх називають + "repos", так коротше.

+ + A drawing of four file folders + +

Ви кажете Git де знаходиться ваш проект та Git почне відслідковувати всі зміни всередині неї. Це зробить + Git репозиторій: папка, зміни в якій відслідковує Git. Git відслідковує коли файли були додані, видалені, або були внесені зміни всередині. Все це, а також те, хто вносив зміни, відслідковує Git. У розробці програмного забезпечення, + подібні відслідковування називається контролем версій.

+ +

Використання терміналу

+

Термінал (або Bash) спосіб задання команд вашому комп'ютеру, швидше ніж кліки мишкою. Ви можете перейменувати файли, відкрити, створити нові папки, + переміщатися між папками та багато іншого за допомогою введення команд. Ви можете навіть використовувати текстовий редактор в терміналі! (наприклад Vim)

+ +

Окрім навігації по комп'ютеру, ви можете використовувати у терміналі програми які мають command-line + interface (CLI), що означає, що вони мають можливість керуватися командами із терміналу. Git — одна із них. Перша частина + команди дає знати що ви звертаєтеся саме до Git. Все те що слідує за нею - різні команди і опції які повинен виконати Git.

+ +

У Git-it ви навчитеся деяким базовим діям використовуючи командний рядок для навігації по вашиму комп'ютері;

+
+ +
+

Створення репозиторія

+

Ви збираєтеся творити нову папку проекта та ініціалізувати у ній Git репозиторій. Назвемо папку 'hello-world', але ви можете вибрати будь-яке інше ім'я, якщо у вас уже є папка із такою назвою.

+ +

Час відкрити ваш термінал! +

+ +

У вікні вашого терміналу, введіть ці команди, по одній за раз, натисніть enter/return після кожної.

+ +

Перше, створимо нову папку:
Підказка: mkdir використовується для створення папки

+ mkdir hello-world + +

Далі, перейдіть до цієї папки:
Підказка: cd використовується для зміни папки

+ cd hello-world + +

Останнє, скажіть Git щоб він ініціалізувався (почав відслідковувати) у папці де ви зараз знаходитеся:

+ git init + +

Остання команда повинна повернути повідомлення що починається із "Initialized empty Git repository". Інші команди не повертають нічогою

+ +

Ви зробили це! Якщо ви хочете ще раз перевірити чи це Git репозиторій, введіть git status + і якщо ви не побачите 'fatal: Not a git repository...', у вас все вийшло!

+
+ +{{{ verify_directory_button }}} + +
+ +
diff --git a/resources/contents/uk-UA/challenges/3_commit_to_it.html b/resources/contents/uk-UA/challenges/3_commit_to_it.html new file mode 100644 index 0000000000..eb39fb1e46 --- /dev/null +++ b/resources/contents/uk-UA/challenges/3_commit_to_it.html @@ -0,0 +1,70 @@ +
+

Створіть файл у вашому новому репозиторії, додайте щось у файл та закомітьте за допомогою Git.

+
+ +
+

Коміти

+

Коміти - це основа роботи із Git. Це моменти у які ви зберігаєте та описуєте повідомленням, те що зробили. Це + точки у таймлайні історії вашого проекту.

+
+ +
+

Створення нового файлу

+

Тепер, коли у вас є репозиторій, додамо у нього файл.

+

Відкрийте свій текстовий редактор та створіть навий порожній файл. Тепер напишіть щось у ньому, наприклад + "Hello!", та + збережіть цей файл як 'readme.txt' у папці 'hello-world', яку ви створили у попередньому завданні.

+
+ +
+

Первірка статусу + Додавання та Фіксація змін

+

Далі, перевірте статус вашого репозиторія, щоб дізнатися які були внесені зміни. Ви знаєте що + внесли зміни, але чи знає Git?

+ +

Переконайтесь що ви знаходитесь всередині папки 'hello-world' коли виконуєте команди. Використайте Git щоб + побачити які зміни були здійснені у репозиторії:

+ +

Спершу, перевірте статус:

+

git status

+

Git повинен показати що був доданий новий файл.

+ +

Далі додайте щойно створений файл, щоб він був частиною змін, які ви зараз + зафіксуєте + (aka закомітите) використовуючи Git:

+

git add readme.txt

+ +

І останнє, зафіксуйте зміни в історії репозиторія, додавши короткий опис того, що ви зробили. +

+

git commit -m "Created readme"

+
+ +
+

Step: Зробіть більше змін

+

Тепер додайте ще одлин рядок до файлу 'readme.txt' і збережіть файл знову.

+ +

У терміналі ви зможете побачити різницю між станом файлу зараз, та станом із попереднього + коміту.

+ +

Введіть команду, щоб Git показав різницю:

+

git diff

+ +

Тепер ви можете закомітити свої нові зміни.

+
+ +{{{ verify_directory_button }}} + +
+ +
diff --git a/resources/contents/uk-UA/challenges/4_githubbin.html b/resources/contents/uk-UA/challenges/4_githubbin.html new file mode 100644 index 0000000000..72cff7a712 --- /dev/null +++ b/resources/contents/uk-UA/challenges/4_githubbin.html @@ -0,0 +1,47 @@ +
+

Створення GitHub аккаунту та прикріплення вашого юзернейма до Git параметрів.

+
+ +
+

Працюємо ефективніше, разом

+ +

Репозиторій, який ви створили покищо існує лише на вашому комп'ютері, що дуже зручно, але складно ділитися та працювати над проектом разом з іншими розробниками. Не хвилюйтеся, для цього існує GitHub!

+ +

GitHub це сайт який дозволяє людям із будь-якого куточку світу, завантажувати те над чим вони працюють використовуючи Git, саме тому будь-хто може приєнатися до роботи над проектом. + GitHub виступає у ролі цетралізованого сховища репозиторіїв для вас та будь кого іншого, хто хоче ділитися своїм кодом. Ви надсилаєте зміни що вносите в репозиторій, а також завантажуєте зміни які зробили інші розробники.

+
+ +
+

Створення GitHub Аккаунту

+ +

Відвідайте github.com та зареєструйте аккаунт, це безкоштовно.

+
+ +
+

Додавання GitHub юзернейма до Git

+

Додайте свій GitHub юзернейм до вашої Git конфігурації. Зробимо це лише заради Git-it; це зробить простішою перевірку наступних завдань. Збережіть юзернейм саме так як створювали на GitHub, враховуючи регістр. Note, you don't need to enter the "<" and ">".

+ +

Додайте свій GitHub юзернейм до вашої Git конфігурації:

+ git config --global user.username <USerNamE> + +

Ви можете перевірити чи додали у Git конфіг юзернейм, просто ввівши:

+ git config --global user.username +
+ +{{{ verify_button }}} + +
+

Переконайтесь що ви ввели саме "user.username" у коді вище, а не "user.name", що може перезаписати те, що ви робили + у першому завданні а також залишить вас без встановленого юзернейма! Якщо ви все ж зробили неправильно, нічого страшного, + просто повторіть кроки із першого завдання, а тоді повертайтеся сюди.

+
+ +
+

GitHub & Git конфігурації юзернеймів не співпадають

+ +

Поширена помилка полягає в тому, що GitHub юзернейм чутливий до регістру. + Наприклад, 'JLord' це не те ж саме що й 'jlord'

+

Щоб змінити юзернейм який ви задали у Git конфіг, просто повторіть ту ж команду що виконували раніше, але враховуйте регістр:

+

git config --global user.username <USerNamE>

+

Коли ви зробили зміни, запустіть перевірку знову!

+
diff --git a/resources/contents/uk-UA/challenges/5_remote_control.html b/resources/contents/uk-UA/challenges/5_remote_control.html new file mode 100644 index 0000000000..4131b44875 --- /dev/null +++ b/resources/contents/uk-UA/challenges/5_remote_control.html @@ -0,0 +1,99 @@ +
+

З'єднання вашого локального репозиторія із віддаленим, надсилання данних до нього.

+
+ +
+

Віддалені репозиторії

+ +

Коли ви кладете щось на GitHub, його копія існує на одному із серверів GitHub'у. Це робить його + віддаленим (remote) репоиторієм, тому що він знаходиться не локально на вашому комп'ютері, а на сервері. Надсилаючи (push) ваші локальні (ті що знаходяться на комп'ютері) зміни до віддаленого репозиторія, ви тримаєте його актуальним.

+ +

Інші бажаючі можуть в будь який момент отримати актуальний стан репозиторя стягнувши (pull) ваші зміни із + віддаленого репозиторія (на свій комп'ютер). Саме так, будь-хто, може працювати із вашим проектом не маючи безпосереднього доступу до вашого комп'ютера, та власне вашої локальної копії.

+ + Діаграма показує GitHub як центральний сервер що створює GitHub.com сайт. Два комп'ютери, по обидва боки, роблять push та pull з GitHub. +
+ +
+

Створення віддаленого репозиторія

+

Ви хочете синхронізувати вашу локальну версію із тією, що знаходиться на GitHub.com. Спершу потрібно створити новий віддалений (remote) + репозиторій на GitHub.com.

+ + +
+ +
+

Readme, .gitignore and Ліцензії

+

Це загальні файли для open source проектів, саме тому, для швидкого старту проекту, GitHub надає можливість створити ці файли для вас.

+

Readme описує проект в загальному, як запустити, як контрибютити (інколи це описує спеціальний файл, 'CONTRIBUTING.md').

+

.gitignore це список файлів всередині репозиторія, зміни яких Git не повинен відслідковувати, наприклад, + наприклад, файли із паролями!

+

license - це файл ліцензії, під якою ви розповсюджуєте проект. Завдяки цьому, інші будуть знати, яким чином вони можуть використовувати ваш проект. Інформація про ліцензії: choosealicense.com. +

+
+ +
+

З'єднання локального репозиторія з віддаленим

+

Зараз ви маєте порожній репозиторій, створений на GitHub.com. Зверху ви побачите 'Quick Setup', впевніться що кнопка + 'HTTPS' вибрана та скопіюйте адресу — це буде адреса вашого репозиторія на сервері GitHub'у.

+ +

Поверніться у ваш термінал, та всередині папки 'hello-world' яку ви ініціалізували як Git репозиторій у попередньому завданні, вам потрібно сказати Git'у щоб він запам'ятав віддалену версію проекту що знаходиться на GitHub'і. Ви + можете вказати декілька віддалених репозиторії, але кожен із них потребує власного імені. Основний віддалений репозиторій зазвичай називається origin. +

+ +

Щоб додати віддалений репозиторій 'origin' до вашого репозиторія:

+ git remote add origin <URLFROMGITHUB> + +

Ваш локальний репозиторій тепер знає де ваш віддалений (remote) репозиторій, що називається 'origin', + і живе на сервері GitHub'у.

+ +
+

Для користувачів Windows:

+

Якщо у вас є GitHub Desktop встановлений на комп'ютері, віддалений репозиторій із іменем 'origin' автоматично створюється у вашому репозиторії. У цьому випадку, вам лише потрібно вказати із яким URL асоціювати + 'origin'. Використовуйте наступну команду, замість 'add':

+ + git remote set-url origin <URLFROMGITHUB> +
+
+ +
+

Надсилання змін на ваш віддалений репозиторій

+

Далі вам потрібно виконати надсилання (push) всього що ви зробили локально, у ваш віддалений репозиторій на GitHub. + Це те що ви будете робити часто, для того щоб віддалений репозиторій відображав актуальний стан вашого локального репозиторія.

+ +

Git має систему віткування, тобто ви можете працювати над різними частинами проекту у різні моменти часу. Ми розберемо це пізніше, але за замовчуванням, перша вітка називається 'master'. Коли ви надсилаєте (push) зміни (або отримуєте (pull)) + зміни з проекту, ви вказуєте Git'у ім'я вітки в яку зміни будуть записані на віддалений репозиторій.

+ +

У цьому випадку, ми надішлемо нашу вітку що називаєтсья 'master' до нашого віддаленого репозиторія на GitHub що збережений як 'origin'.

+ git push origin master + +

Тепер перейдіть на GitHub.com на сторінку вашого репозиторія та оновіть сторінку. Чудово! Всі зміни із вашого локального репозиторія тепер є і на віддаленому!

+
+ +{{{ verify_directory_button }}} + +
+ +
diff --git a/resources/contents/uk-UA/challenges/6_forks_and_clones.html b/resources/contents/uk-UA/challenges/6_forks_and_clones.html new file mode 100644 index 0000000000..801bcc8a65 --- /dev/null +++ b/resources/contents/uk-UA/challenges/6_forks_and_clones.html @@ -0,0 +1,77 @@ +
+

Форк проекта із GitHub.com та його клонування на комп'ютер.

+
+ +
+

Форки

+

Раніше ви створили свій репозиторій та завантажили ойго на GitHub, але це лише частина веселощів! Інша частина + полягає у роботі над проектами інших людей.

+ +

Коли ви робите форк (fork) реозиторія, ви створюєте його копію на власному GitHub аккаунті. Ваша + форкнута копія починає свій шлях як віддалений (remote) репозиторій — він існує лише на вашому + GitHub аккаунті, + а не на вашому комп'ютері. Форки використовуються для створення вашої власної версії проекту (це схоже на + розгалуження доріг) або контрибютинг власних змін (наприклад виправлення багів, новий функціонал) + в оригінальний проект.

+ +

Щоб отримати форкнутий репозиторій із вашого GitHub аккаунту на ваш комп'ютер просто клонуйте (clone) його. Ця команда завантажить репозиторій на ваш комп'ютер, щоб ви могли працювати над ним локально.

+ + Діаграма показує репозиторій із GitHub скопійований на ваш GitHub аккаунт і звідти уже скопійована на ваш комп'ютер. +
+ +
+

Форк Patchwork репозиторія

+

Проект, із якого потрібно зробити форк github.com/jlord/patchwork. + Перейдіть на цю сторінку та натисніть 'Fork' зверху справа. Після завершення процесу копіювання репозиторія, ви отримаєте копію проекта на своєму аккаунті. Скопіюйте HTTP URL вашого форку із адресного рядка вашого браузера, + це ареса вашого форку на сервері GitHub.

+ +
+ +
+

Клонування вашого форку

+

Тепер, у терміналі, вам потрібно скопіювати репозиторій на ваш комп'ютер. Автоматично створиться нова папка дял вашого проекту, тому не потрібно створювати її власноруч. Але переконайтесь що ви не клонуєте його всередині іншого Git репозиторія!

+ +

Впевніться що не всередині папки 'hello-world' із попереднього завдання. Для того щоб повернутися назад та можна було клонувати репозиторій, потрібно виконати наступні команди:

+ +

Перейти на 1 рівень вверх відносно папки 'hello-world':
Підказка: дві крапки означають те що ви підніметеся на один рівень вище відносно поточного розсташування +

+

cd ..

+ +

Тепер, коли ви не всередині іншого репозиторія, потрібно виконати наступну команду:

+

git clone <URLFROMGITHUB>

+ +

Перейдіть у папку із вашою локальною копією проекту в нашому випадку вона називається 'patchwork').

+

cd patchwork

+ +

Ви щойно отримали локальну копію репозиторія яка автоматично приєнана до вашого віддаленого репозиторія (вашої форкнутої копії) на вашому GitHub аккаунті. Введіть git remote -v + щоб переконатися що адреса дійсно вказує на ваш форк.

+
+ +
+

Приєднання до оригінального репозиторія

+ +

А що якщо оригінальний репозиторій, із якого ви зробили свій форк зміниться? Ви захочете отримати (pull) зміни що були зроблені. Тому давайте додамо ще одне віддалене з'єднання, цьог оразу воно вказуватиме на оригінал, github.com/jlord/patchwork, із наступним URL.

+ +

Ви можете дати йому будь-яку назву, проте зазвичай використовується ім'я 'upstream'; давайте і ми його використаємо.

+ +

git remote add upstream https://github.com/jlord/patchwork.git

+ +

Щоб переконатися що під'єднані правильні віддалені сервери, введіть git remote -v щоб побачити збережені вами адреси. У Вас повинен бути 'origin' із адрусоювашого форку та 'upstream' + із URL оригінального репозиторія.

+
+ +{{{ verify_directory_button }}} + +
+ +
diff --git a/resources/contents/uk-UA/challenges/7_branches_arent_just_for_birds.html b/resources/contents/uk-UA/challenges/7_branches_arent_just_for_birds.html new file mode 100644 index 0000000000..1c7424233a --- /dev/null +++ b/resources/contents/uk-UA/challenges/7_branches_arent_just_for_birds.html @@ -0,0 +1,121 @@ +
+

Створення гілки, локально, у вашому форкнутому репозиторії, для роботи над вашими змінами.

+
+ +
+

Гілки (Branches)

+

Git репозиторії використовують гілки для ізоляції роботи над певною частиною проекту, за потребою. + Це загальна практика, коли ви працюєте самі, або із іншими людьми над проектом, ізолювати свої зміни у власній + гілці. Це спосіб працювати над своїми функціоналом, в той час, + коли на гілці master залишається стабільна версія проекту. Коли робота у вашій гілці завершена, її можна + змерджити у гілку "master".

+

Діаграма що наведена нижче показує, як ви можете перейти на іншу гілку із 'master', зробити свою роботу та + змерджити зміни назад у 'master' + Також ви можете зробити гілку не лише із 'master' а із будь-якої іншої гілки.

+ + Діаграма показує горизонтальну лінію, що показує гілку master, із іншою гілкою із неї, яка потім знову зливається із 'master'. Інша гілка відгалужуєтсья від 'master' знизу, і із неї відгалужується ще одна гілка. Потім обидві гілки також повертаються у гілку 'master' + +

Для кращого розуміння того .як працюють гілки, дивіться GitHub Guide: guides.github.com/overviews/flow

+ +

GitHub Сторінки

+

GitHub буде автоматично слідкувати та хостити статичні вебсайти із файлів у гілці 'gh-pages'. Цей безкоштовний сервіс називається GitHub Pages. Так як проект який ви форкаєте створює вебсайт, + його головна гілка називаєтсья 'gh-pages' а не 'master'. Всі репозиторії що мають гілку 'gh-pages'із файлами вебсайту + , можна побачити онлайн, використавши маску URL:

+ + http://githubusername.github.io/repositoryname +
+ +
+

Створення гілки

+

Коли ви створюєте гілку, Git копіює все із вашої поточної гілки і кладе це у гілку що ви хочете створити.

+ +

Доки ви всередині репозиторія 'patchwork', введіть git status щоб побачити гілку в якій ви зараз знаходитесь. + Git повинен відповісти що ви зараз у гілці 'gh-pages'.

+ +

Тепер створіть нову гілку та назвіть її "add-<username>", де 'username' це ваш юзернейм. Наприклад, + "add-jlord". Не забувайте про те що гілки чутливі до регістру .

+ +

git branch <BRANCHNAME>

+ +

Тепер у вас є гілка, яка ідентична гілці 'gh-pages'.

+ +

Щоб перейти у цю гілку та почати у ній працювати, потрібно зробити checkout гілки:

+ +

git checkout <BRANCHNAME>

+
+ +
+

Крок: Створення нового файлу

+

Поверніться у ваш текстовий редактор:

+ +
+ +
+

Внесення змін

+

Пройдіть ці кроки для внесення змін у проект

+ +

git status

+

git add <contributors/FILENAME>

+

git commit -m "commit message"

+ +

Тепер надішліть (push) ваші зміни до вашого форку, 'origin', on GitHub:

+

git push origin <BRANCHNAME>

+
+ +{{{ verify_directory_button }}} + +
+

Permission denied...error: 403

+

Ви надсилаєте зміни до репозиторію, до якого немаєте прав на запис. В цьому випадку, ви напевне надсилаєте зміни до оригінального 'jlord/patchwork'. Переконайтесь, що ви надсилаєте зміни до 'origin' і він вказує на ваш репозиторій + на GitHub. Для того щоб це перевірити виконайте git remote -v. + Ви повинні отримати 'upstream' що вказує на 'jlord/patchwork' та 'origin' що вказує на 'yourusername/patchwork'. + +

Щоб виправити цю пробелму потрібно перезаписати url: git remote set-url origin + + . + +

Authentication failed...error: 401

+

Ви не розпізнані. У вас повинна бути увімкнена 2FA (Two Factor Authentication), для того щоб підтверджувати свої дії унікальним токеном, таким як пароль. Ви можете згенерувати його слідуючи цим інструкціям. Вам потрібно зберегти його, та використовувати як пароль. Також ви можете + зберегти цей ключ доступу на + вашому комп'ютері і відпаде потреба його вводити кожного разу.

+ +

Файл НЕ в папці contributors

+

Файл що ви створили повинен знаходитися всередині папки 'contributors' у репозиторії Patchwork. якщо ви поклали його в іншому місці, просто використайте Finder чи Windows Explorer (Провідник) щоб перенести його у правильну папку. + Ви можете перевірити git status знову і побачите свої зміни. Застейджіть а тоді commit "all" (-A) цих змін, за допомогою команд що наведені нижче

+

git add -A

+

git commit -m "move file into contributors folder"

+ +

Branch name expected: _____

+

Назва гілки повинна містити саме ваш юзернейм. Для зміни назви гілки, використайте:

+

git branch -m <NEWBRANCHNAME>

+

Після внесення змін, зробіть перевірку.

+
+ +
+ +
diff --git a/resources/contents/uk-UA/challenges/8_its_a_small_world.html b/resources/contents/uk-UA/challenges/8_its_a_small_world.html new file mode 100644 index 0000000000..968cb354f9 --- /dev/null +++ b/resources/contents/uk-UA/challenges/8_its_a_small_world.html @@ -0,0 +1,34 @@ +
+

Додайте коллаборатора до вашого проекту.

+ +
+ +
+

Соціальний Кодінг

+

Можливість працювати разом з іншими це одна з найкращих можливостей, які надає GitHub, тому що спрощує роботу + з будь-якого місця чи часового поясу разом з іншими людьми.

+ +

Коллаборатори це інші GitHub юзери, яким надано право вносити зміни до репозиторію, + який належить комусь іншому. Ви також напевно чули термін contributors, + він обозначає іншого GitHub юзера який зробив внесок до проекту за допомогою форку та пул реквесту.

+ + A photo of a cat with a space helment drawn on. This is Reporobot the cat and your collaborator + @reporobot + це робот з космосу, який любить співпрацювати в роботі на репозиторіями. + +
+ +
+

Привіт, Repo Robot!

+

Для того щоб додати колаборатора до одного з ваших проектів, відвідайте сторінку репозиторія на вашому + GitHub аккаунті і натисніть 'Settings' в меню, яке розташоване в верхній частині сторінки. Потім виберіть + опцію 'Collaborators'. Наберіть імя юзера в текстовому полі і натисніть 'Add'.

+ +

Переїдіть до сторінки Patchwork репозиторію на GitHub і додайте 'reporobot' в якості коллаборатора. + URL повинен виглядати як наведений нижче, але в з вашим іменем користувача.

+ + github.com/YOURUSERNAME/patchwork/settings/collaboration +
+ +{{{ verify_button }}} diff --git a/resources/contents/uk-UA/challenges/9_pull_never_out_of_date.html b/resources/contents/uk-UA/challenges/9_pull_never_out_of_date.html new file mode 100644 index 0000000000..00b35dacff --- /dev/null +++ b/resources/contents/uk-UA/challenges/9_pull_never_out_of_date.html @@ -0,0 +1,41 @@ + +
+

Оновлення версії вашого файлу за домопогою отримання (pull) змін, зроблених іншими коллабораторам..

+
+ +
+

Затягування з віддаленого репозиторію.

+

Якщо ви працюєте над чимось разом із іншими, вам необхіодно завжди синхронізувати вашу версію файлів з останніми змінами + Таким чином вам знадобиться зробити pull щоб отримати будь-які зміни, які були внесені до центрального + GitHub репозиторію.

+ + A diagram shows a computer pulling information down from a repository's website +
+ +
+

Чим займався Reporobot?

+

Подивіться чи Reporobot зробив якісь зміни до вашої гілки за допомогою затягування змін з віддаленого репозиторію з назвою + 'origin' на GitHub:

+ +

git pull <REMOTENAME> <BRANCHNAME>

+ +

Якщо нічого не змінилось, ви отримаєте повідомлення 'Already up-to-date'. Якщо зміни є, Git злиє ці зміни у вашу локальну версію. +

+ +

Чи зробив Reporobot зміни? Git вказує де зміни були внесені. Ви можете відкрити той файл і побачити зміни зроблені Reporobot. + Сюрприз, Reporobot - артист!

+
+ +{{{ verify_directory_button }}} + +
+ +
\ No newline at end of file diff --git a/resources/contents/uk-UA/pages/about.html b/resources/contents/uk-UA/pages/about.html new file mode 100644 index 0000000000..a629ebdd72 --- /dev/null +++ b/resources/contents/uk-UA/pages/about.html @@ -0,0 +1,12 @@ +

Про Git-it

+

Git-it навчає основам, Git команди які розробники використовують кожного дня

+ +

Деякі завдання потребують з’єднання із інтернетом, тому вам потрібно бути в мережі, щоб завершити Git-it. Проте, ви можете в будь-який момент відкрити додаток офлайн щоб подивитися завдання.

+ +

Справжнє робоче оточення

+ +

Git-it використовує справжній термінал, Git та GitHub (замість того щоб емулювати їх). Після закінчення воркшопу у вас будуть справжні репозиторії на GitHub аккаунті та відмітки на графіку комітів.

+ +

The Code that Made Git-it

+ +

Додаток зроблений на HTML, CSS та JS та використовує Electron. Весь код Git-it знаходиться на GitHub. Git-it зроблено із ❤ @jlord та контрибюторами.

diff --git a/resources/contents/uk-UA/pages/dictionary.html b/resources/contents/uk-UA/pages/dictionary.html new file mode 100644 index 0000000000..d99b5a4e2a --- /dev/null +++ b/resources/contents/uk-UA/pages/dictionary.html @@ -0,0 +1,108 @@ +

Нижче наведено команди Git та терміналу які використовуються у Git-it завданнях.

+ +

Bash/Terminal Основи

+
+ +
+ +

Налаштування Git

+
+ +
+ +

Основи Git

+
+ +
+ +

Вітки Git

+
+ +
+ +

Git Remotes

+
+ +
+ +

Отримання змін Git

+
+ +
+ +

Push & Merge у Git

+
+ +
+ +

Видалення віддалених репозиторіїв та віток у Git

+
+ +
diff --git a/resources/contents/uk-UA/pages/index.html b/resources/contents/uk-UA/pages/index.html new file mode 100644 index 0000000000..8282f2f154 --- /dev/null +++ b/resources/contents/uk-UA/pages/index.html @@ -0,0 +1,117 @@ + + + + + Git-it + + + + + + + + + + + +
+
+ Виконані завдання: + +
+
+
+
+
+
+
+
+
+
+
+
+ +
+ +
+

Привіт!

+

Git-it навчає основам використання Git і GitHub. Ці навички ви будете використовувати постійно у своїй роботі, як над власними проектами, так і вкладаючи свою частку у

+ +
+

Але це ще не все

+

Ви також можете пройти Git-it на Традиційній Китайській чи Японській, + просто оберіть мову яку ви хочете у лівому верхньому меню

+ +

Ви можете перейти до сторінок Словник, Ресурси та Про воркшоп

+
+ + + + +
+ +
+ +

On your way!

+

Ви на шляху до успіху, продовжуйте в тому ж дусі! Можете глянути де ви зупинилися

+ + + +
+ +
+ +

Вітання!

+

Ви закінчили усі завдання, тепер можна приступати до

+ + + + +
+ +
+ + + diff --git a/resources/contents/uk-UA/pages/resources.html b/resources/contents/uk-UA/pages/resources.html new file mode 100644 index 0000000000..887e1d9bd4 --- /dev/null +++ b/resources/contents/uk-UA/pages/resources.html @@ -0,0 +1,47 @@ +

Ресурси

+

Для того, щоб зміцнити те, що ви тільки що дізналися, або спробувати інший спосіб, тут зібрані посилання на інші інструкції та підручники.

+

Якщо ви уже готові до справжнього проекту, перейдіть до проектів для початківців.

+ +
+

Інтерактивний підручник

+ + +

Інструкції, книги та шпаргалки

+ + +

GitHub Desktop

+

Напевне, ви уже встановили це, перш ніж взятися за Git-it але якщо ні, ось посилання.

+

GitHub Desktop дозволяє робити майже все що ви робите через термінал (але не все) значно простіше. Наприклад, я використовую його для буль зручного переглядудіфів.

+ +
+ +

Що далі?

+
+

Тепер, коли ви вже впевнено почуваєте себе із Git, ось кілька ідей для початківців:

+ +
diff --git a/resources/contents/uk-UA/partials/chal-footer.html b/resources/contents/uk-UA/partials/chal-footer.html new file mode 100644 index 0000000000..463843787a --- /dev/null +++ b/resources/contents/uk-UA/partials/chal-footer.html @@ -0,0 +1,30 @@ +
+
+ {{ prename }} +
+
+
+
+ {{ nextname }} +
+
+
+
+ + diff --git a/resources/contents/uk-UA/partials/chal-header.html b/resources/contents/uk-UA/partials/chal-header.html new file mode 100644 index 0000000000..3338b1ad6d --- /dev/null +++ b/resources/contents/uk-UA/partials/chal-header.html @@ -0,0 +1,16 @@ + + + \ No newline at end of file diff --git a/resources/contents/uk-UA/partials/chal-sidebar.html b/resources/contents/uk-UA/partials/chal-sidebar.html new file mode 100644 index 0000000000..db6c8ae163 --- /dev/null +++ b/resources/contents/uk-UA/partials/chal-sidebar.html @@ -0,0 +1,15 @@ + diff --git a/resources/contents/uk-UA/partials/footer.html b/resources/contents/uk-UA/partials/footer.html new file mode 100644 index 0000000000..8922caf2cd --- /dev/null +++ b/resources/contents/uk-UA/partials/footer.html @@ -0,0 +1,11 @@ + diff --git a/resources/contents/uk-UA/partials/header.html b/resources/contents/uk-UA/partials/header.html new file mode 100644 index 0000000000..31b907e85c --- /dev/null +++ b/resources/contents/uk-UA/partials/header.html @@ -0,0 +1,17 @@ + + + + \ No newline at end of file diff --git a/resources/contents/uk-UA/partials/verify-button.html b/resources/contents/uk-UA/partials/verify-button.html new file mode 100644 index 0000000000..65a2e2f18c --- /dev/null +++ b/resources/contents/uk-UA/partials/verify-button.html @@ -0,0 +1,10 @@ +
+ +
+
+
+
+ + +
diff --git a/resources/contents/uk-UA/partials/verify-directory-button.html b/resources/contents/uk-UA/partials/verify-directory-button.html new file mode 100644 index 0000000000..09a2c4c0f2 --- /dev/null +++ b/resources/contents/uk-UA/partials/verify-directory-button.html @@ -0,0 +1,13 @@ +
+ + +
+
+
+
+ Оберіть директорію репозиторія. + + + +