diff --git a/README.asc b/README.asc index 58681955..316cdd9d 100755 --- a/README.asc +++ b/README.asc @@ -2,23 +2,23 @@ image:https://travis-ci.org/progit/progit2-uk.svg?branch=master["Build Status", = Pro Git, друге видання - переклад українською -Щодо допомоги з перекладом дивіться TRANSLATION_NOTES.asc +Щодо допомоги з перекладом дивіться link:TRANSLATION_NOTES.asc[TRANSLATION_NOTES.asc] -Ласкаво запрошуємо до другого видання книги Pro Git. +Ласкаво просимо до другого видання книги Pro Git. Цю книгу можна знайти онлайн за адресою https://git-scm.com/book/uk/v2 Друге видання, так само, як і перше, має відкритий код під ліцензією Creative Commons. Деякі речі є відмінними у відкритому коді цього видання, порівняно з першим. -Перш за все, для тексту книги, ми перейшли від Markdown до неймовірно зручного формату Asciidoc. +Перш за все, для тексту книги ми перейшли від Markdown до неймовірно зручного формату Asciidoc. -Ми також перейшли, від піддиректорій англійського репозиторія, до тримання перекладів по окремих сховищах. -Докладніше -- за посиланням link:TRANSLATING.md[як перкласти]. +Ми також перейшли від піддиректорій англійського репозиторія, до зберігання перекладів в окремих сховищах. +Докладніше -- за посиланням link:TRANSLATING.md[як перекласти]. == Як згенерувати книгу -Ви можете згенерувати файли електронної книжки вручну за допомогою Asciidoctor +Ви можете згенерувати файли електронної книги вручну за допомогою Asciidoctor. Якщо ви виконаєте наступні команди, то _можете_ отримати власне HTML, Epub, Mobi та PDF вихідні файли: ---- @@ -45,7 +45,7 @@ $ asciidoctor-epub3 progit.asc $ asciidoctor-epub3 -a ebook-format=kf8 progit.asc ---- -В обох варіантах використовуються проекти `asciidoctor`, `asciidoctor-pdf` та `asciidoctor-epub`. +В обох варіантах використовуються проєкти `asciidoctor`, `asciidoctor-pdf` та `asciidoctor-epub`. == Повідомлення про проблеми @@ -56,4 +56,4 @@ $ asciidoctor-epub3 -a ebook-format=kf8 progit.asc == Як долучитися -Якщо ви охочі допомогти проекту, вносячи зміни, погляньте на link:CONTRIBUTING.md[інструкцію, як долучитися]. +Якщо ви бажаєте допомогти проєкту, вносячи зміни, перегляньте link:CONTRIBUTING.md[інструкцію, як долучитися]. diff --git a/book/06-github/sections/3-maintaining.asc b/book/06-github/sections/3-maintaining.asc index 20c0f872..ee4852b3 100755 --- a/book/06-github/sections/3-maintaining.asc +++ b/book/06-github/sections/3-maintaining.asc @@ -1,11 +1,11 @@ [[_maintaining_gh_project]] -=== Супроводжування проекту +=== Супроводжування проєкту -Тепер, коли ми знаємо, як робити внески до проектів, поглянемо з іншого боку: створення, супроводжування та адміністрування вашого власного проекту. +Тепер, коли ми знаємо, як робити внески до проєктів, поглянемо з іншого боку: створення, супроводжування та адміністрування вашого власного проєкту. ==== Створення нового сховища -Створимо нове сховище, до якого ми додамо код нашого проекту. +Створимо нове сховище, до якого ми додамо код нашого проєкту. Спочатку натиснемо кнопку ``New repository'' (нове сховище) праворуч панелі керування, чи за допомогою кнопки `+` у верхній панелі інструментів біля вашого імені користувача, як можна побачити в <<_new_repo_dropdown>>. .Область ``Your repositories'' (ваші сховища). @@ -20,28 +20,28 @@ image::images/new-repo.png[``New repository'' (нове сховище) у ви .Форма ``нове сховище''. image::images/newrepoform.png[Форма ``нове сховище''.] -Вам треба лише надати проекту ім’я. Усі інші поля зовсім не обов’язкові. -Зараз просто натисніть на кнопку ``Create Repository'' (створити сховище), і бах – у вас вже є нове сховище на GitHub, під назвою `<ім’я користувача>/<назва проекту>`. +Вам треба лише надати проєкту ім’я. Усі інші поля зовсім не обов’язкові. +Зараз просто натисніть на кнопку ``Create Repository'' (створити сховище), і бах – у вас вже є нове сховище на GitHub, під назвою `<ім’я користувача>/<назва проєкту>`. -Оскільки у вашому проекті наразі нема коду, GitHub покаже вам інструкції щодо створення абсолютно нового сховища Git, або приєднання існуючого проекту Git. +Оскільки у вашому проєкті наразі нема коду, GitHub покаже вам інструкції щодо створення абсолютно нового сховища Git, або приєднання існуючого проєкту Git. Ми не будемо її тут викладати. Якщо вам необхідно щось з цього пригадати, дивіться <>. -Тепер у вас є проект на GitHub, ви можете дати URL будь-кому, з ким хочете поділитись своїм проектом. -Кожен проект на GitHub є доступним через HTTPS за адресою `https://github.com//`, та через SSH за адресою `git@github.com:/`. +Тепер у вас є проєкт на GitHub, ви можете дати URL будь-кому, з ким хочете поділитись своїм проєктом. +Кожен проєкт на GitHub є доступним через HTTPS за адресою `\https://github.com//`, та через SSH за адресою `git@github.com:/`. Git може отримувати та викладати зміни користуючись обома URL, проте вони мають контроль доступу, що базується на запиті ім’я/паролю користувача. [NOTE] ==== -Часто більш бажано поширювати HTTPS URL публічного проекту, адже тоді користувачу не доведеться мати обліковий запис GitHub щоб зробити клон проекту. -Користувачам доведеться мати обліковий запис та відвантажений SSH ключ щоб мати доступ до вашого проекту через SSH. -Посилання HTTPS ще можна просто вставити до вашого веб-оглядача, щоб побачити там ваш проект. +Часто більш бажано поширювати HTTPS URL публічного проєкту, адже тоді користувачу не доведеться мати обліковий запис GitHub щоб зробити клон проєкту. +Користувачам доведеться мати обліковий запис та відвантажений SSH ключ щоб мати доступ до вашого проєкту через SSH. +Посилання HTTPS ще можна просто вставити до вашого веб-оглядача, щоб побачити там ваш проєкт. ==== ==== Додавання співпрацівників Якщо ви працюєте з іншими людьми, та бажаєте надати їм право робити коміти, ви маєте додати їх до ``співпрацівників'' (`collaborators`). -Якщо Бен, Джефф та Луїза усі мають облікові записи на GitHub, та ви бажаєте надати їм доступ на запис до вашого сховища, ви можете додати їх до свого проекту. -Це надасть їм можливість робити ``push'', тобто вони матимуть доступ і на читання, і на запис до проекту та сховища Git. +Якщо Бен, Джефф та Луїза усі мають облікові записи на GitHub, та ви бажаєте надати їм доступ на запис до вашого сховища, ви можете додати їх до свого проєкту. +Це надасть їм можливість робити ``push'', тобто вони матимуть доступ і на читання, і на запис до проєкту та сховища Git. Натисніть на посилання ``Settings'' (налаштування) знизу бокової панелі праворуч. @@ -58,12 +58,12 @@ image::images/collaborators.png[Співпрацівники сховища.] ==== Керування Запитами на Пул (Pull Requests) -Тепер у вас є проект з якимось кодом та можливо навіть декілька співпрацівників з доступом на запис, розгляньмо що робити, якщо хтось направив вам Запит на Пул. +Тепер у вас є проєкт з якимось кодом та можливо навіть декілька співпрацівників з доступом на запис, розгляньмо що робити, якщо хтось направив вам Запит на Пул. Запити на пул можуть надходити або з гілки у форку вашого сховища, або просто з іншої гілки вашого сховища. Єдина різниця, що якщо він з форку, то зазвичай від людей, до гілки яких ви не маєте права викладати зміни та вони не мають права викладати зміни до вашої, а в разі внутрішнього Запиту на Злиття зазвичай обидві сторони мають на це право. -Для наступних прикладів, припустімо, що ви ``tonychacon'', та ви створили новий проект Arduino під назвою ``fade''. +Для наступних прикладів, припустімо, що ви ``tonychacon'', та ви створили новий проєкт Arduino під назвою ``fade''. [[_email_notifications]] ===== Повідомлення електронною поштою @@ -233,13 +233,13 @@ Switched to a new branch 'pr/2' .Вручну змінюємо цільову гілку та форк Запиту на Пул. image::images/maint-04-target.png[Ціль Запиту на Пул] -Як бачите, доволі просто запросити зливання вашої нової гілки до іншого Запиту на Пул або до іншого форку проекту. +Як бачите, доволі просто запросити зливання вашої нової гілки до іншого Запиту на Пул або до іншого форку проєкту. ==== Згадки та повідомлення У GitHub також є доволі гарна вбудована система повідомлень, яка може бути доречною, якщо у вас є питання чи вам потрібна допомога від конкретних людей чи команд. -У кожному коментарі ви можете набрати символ `@` та він почне автодоповнювання імен та імен користувачів людей, що є співпрацівниками цього проекту, чи просто робили до нього внески. +У кожному коментарі ви можете набрати символ `@` та він почне автодоповнювання імен та імен користувачів людей, що є співпрацівниками цього проєкту, чи просто робили до нього внески. .Починаємо набирати символ @ щоб когось згадати. image::images/maint-05-mentions.png[Згадки] @@ -276,9 +276,9 @@ image::images/maint-07-notifications.png[Центр повідомлень] .Центр повідомлень image::images/maint-08-notifications-page.png[Центр повідомлень] -Якщо ви на неї натиснете, то побачите список усіх ваших повідомлень, згрупованих по проектам. -Ви можете фільтрувати повідомлення за проектом, якщо натиснете на його назву в панелі ліворуч. -Також ви можете підтвердити повідомлення, якщо натиснете на пташку (`checkmark`) біля повідомлення, або підтвердити _всі_ повідомлення проекту, якщо натиснете на пташку зверху групи. +Якщо ви на неї натиснете, то побачите список усіх ваших повідомлень, згрупованих по проєктам. +Ви можете фільтрувати повідомлення за проєктом, якщо натиснете на його назву в панелі ліворуч. +Також ви можете підтвердити повідомлення, якщо натиснете на пташку (`checkmark`) біля повідомлення, або підтвердити _всі_ повідомлення проєкту, якщо натиснете на пташку зверху групи. Також є кнопка приглушення біля кожної пташки, якщо ви на неї натиснете, ви більше не будете отримувати повідомлень про цю тему. Усі ці інструменти дуже корисні для роботи з великою кількістю повідомлень. @@ -309,7 +309,7 @@ X-GitHub-Recipient-Address: tchacon@example.com ---- Тут є декілька цікавих рядків. -Якщо ви бажаєте обрати або направити всі листи цього проекту, або тільки цього Запиту на Пул, для цього достатньо даних у `Message-ID`: цей заголовок має формат `<користувач>/<проект>/<тип>/`. +Якщо ви бажаєте обрати або направити всі листи цього проєкту, або тільки цього Запиту на Пул, для цього достатньо даних у `Message-ID`: цей заголовок має формат `<користувач>/<проєкт>/<тип>/`. Якби б це було, наприклад, завдання, `<тип>` був би ``issues'' замість ``pull''. Поля `List-Post` та `List-Unsubscribe` означають, що, якщо ваш поштовий клієнт їх підтримує, ви легко можете написати (`post`) до списку, або відписатись (`unsubscribe`) від розсилки. @@ -325,15 +325,15 @@ X-GitHub-Recipient-Address: tchacon@example.com Першим є файл `README`, який може бути майже будь-якого формату, який GitHub сприймає як текст. Наприклад, це може бути `README`, `README.md`, `README.asciidoc` тощо. -Якщо GitHub побачить файл README у вашому коді, він відобразить його на головній сторінці вашого проекту. +Якщо GitHub побачить файл README у вашому коді, він відобразить його на головній сторінці вашого проєкту. -Багато команд використовують цей файл для зберігання всієї інформації, яка доречна для когось незнайомого зі сховищем або проектом. +Багато команд використовують цей файл для зберігання всієї інформації, яка доречна для когось незнайомого зі сховищем або проєктом. Зазвичай це такі речі як: -* Для чого цей проект +* Для чого цей проєкт * Як його конфігурувати та інсталювати * Приклад його використання або запуску -* Ліцензія проекту +* Ліцензія проєкту * Як зробити внесок до нього Оскільки GitHub буде відображати цей файл, ви можете додати до нього зображення або посилання щоб полегшати його читання. @@ -345,34 +345,34 @@ X-GitHub-Recipient-Address: tchacon@example.com [[_contrib_file]] .Відкриття Запиту на Пул, якщо існує файл CONTRIBUTING. -image::images/maint-09-contrib.png[Повідомлення про інструкцію по взаємодії з проектом] +image::images/maint-09-contrib.png[Повідомлення про інструкцію по взаємодії з проєктом] -Це зроблено задля того, щоб ви могли вказати що саме ви хочете чи не хочете бачити в Запиті на Пул, який направляють до вашого проекту. +Це зроблено задля того, щоб ви могли вказати що саме ви хочете чи не хочете бачити в Запиті на Пул, який направляють до вашого проєкту. Таким чином люди можуть прочитати ці інструкції до відкриття Запиту на Пул. ==== Адміністрування Проекту -Взагалі-то на GitHub небагато інструментів адміністрування проекту, проте деякі з них можуть бути корисними. +Взагалі-то на GitHub небагато інструментів адміністрування проєкту, проте деякі з них можуть бути корисними. ===== Зміна типової гілки Якщо ви використовуєте не гілку ``master'' як головну, тобто гілку, до якої ви бажаєте щоб люди відкривали Запити на Пул, ви можете це змінити на сторінці налаштуваньсвого сховища на вкладці ``Options'' (опції). [[_default_branch]] -.Зміна типової гілки проекту. +.Зміна типової гілки проєкту. image::images/maint-10-default-branch.png[Типова гілка] Просто змініть типову гілку в випадному віконці та без окремої вказівки всі головні операції будуть відбуватися над нею, зокрема яку гілку буде отримувати сховище при клонуванні. -===== Передача проекту +===== Передача проєкту -Якщо ви бажаєте передати проект іншому користувачу або організації на GitHub, для цього є опція ``Transfer ownership'' (передача власності) наприкінці тої самої вкладки ``Options'' на сторінці налаштувань вашого сховища. +Якщо ви бажаєте передати проєкт іншому користувачу або організації на GitHub, для цього є опція ``Transfer ownership'' (передача власності) наприкінці тої самої вкладки ``Options'' на сторінці налаштувань вашого сховища. [[_transfer_project]] -.Передача проекту іншому користувачу або організації GitHub. +.Передача проєкту іншому користувачу або організації GitHub. image::images/maint-11-transfer.png[Передача] -Це корисно якщо ви покидаєте проект та хтось бажає його продовжити, або якщо ваш проект стає більшим і ви бажаєте перемістити його до організації. +Це корисно якщо ви покидаєте проєкт та хтось бажає його продовжити, або якщо ваш проєкт стає більшим і ви бажаєте перемістити його до організації. Це не тільки переміщує сховище разом з усіма глядачами (`watcher`) та зірками до іншого місця, а ще й налаштує перенаправлення з вашого URL до нового місця. Також будуть перенаправлені клонування та отримання змін з Git -- не тільки веб запити.