GitHub Desktop

Ця стаття є продовженням основого посібника і описує роботу з GitHub Desktop. Крім нього, ви можете використовувати і інші клієнти Git. Тим не менш, вам потрібно буде зайти на GitHub для створення пулл-реквестів та публікації своїх змін.

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

1. Скачайте та встановіть GitHub Desktop.
2. Після завершення установки, коли GitHub Desktop попросить залогінитись, натисніть на посилання Sign in to GiHub.com.
3. Заповніть всі необхідні поля.
4. Перейдіть до клонування репозиторію.

Клонування

1. Натисніть на кнопку Clone a repository.

2. В списку, у якому належать вам репозиторії, виберіть osu-wiki.

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

   

4. Натисніть на кнопку Clone та почекайте, поки репозиторій склонується.

5. Перейдіть до створенню нової гілки.

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

Кожна зміна (наприклад, переклад однієї статті або дрібні одинакові правки в декількох статтях) варто розробляти в окремій гілці. У цього підходу є декілька важливих переваг:

• Різні по сенсу зміни ізольовані один від одного;
• При включенні змін в основний репозиторій, а також при оновленні вашої гілки, ви будете набагато рідше стикатися з конфліктами.

1. Натисніть на пункт Current branch в верхньому меню.

2. Придумайте назву для нової гілки. Рекомендується вибирати назву, виходячи з суті змін; наприклад, гілку, де ви перекладаєте критерії ранкінга, можна назвати uk-ranking-criteria-1.

   

3. Переходьте до редагування.

Редагування

1. Відкрийте директорію, куди ви склонували репозиторій, і перейдіть до файлу, який хочете відредагувати. Файли згруповані наступним образом: назва директорії означає назву статті, до якої відноситься вміст, а всередині розташовані переклади на різні мови, які мають розширення .md.
2. Відкрийте потрібний файл в вашому улюбленому текстовому редакторі.
3. При внесенні правок слідкуйте критеріям оформлення статей, наскільки це можливо.
4. Зробіть комміт, щоб зберегти зміни.

Переміщення файлів

1. Переносіть та перейменовуйте файли, як ви це звичайно робите.
2. Зробіть комміт, щоб зберегти зміни.

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

Увага: якщо ви створюєте файли через Провідник Windows, увімкніть відображення файлів.

1. В залежності від типу файла, використовуйте зручний вам інструмент: Провідник Windows, текстовий або графічний редактор. При створенні перекладу статті використовуйте для імені файла скорочену назву локалі (uk для української мови).
2. Зробіть комміт, щоб зберегти зміни.

Видалення файлів

1. Видаляйте файл(и) через Провідник Windows.
2. Зробіть комміт, щоб зберегти зміни.

Комміт та вивантаження змін

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

1. Відкрийте GitHub Desktop. Його вікно буде виглядати приблизно так:

   Деталі можуть незначно відрізнятись.

2. Зазвичай, GitHub Desktop пропонує зробити комміт зі всіма змінами.

3. Якщо у вас є декілька змін, різних по сенсу, то рекомендується зробити по комміту на кожний.

Так, на скріншоті вище pippi додала зображення, включила його в en.md і помітила переклади, як застарілі. Ці дії можна розділити на два комміта: перший - з додаванням зображення і правкою en.md, друший - з поміткою переводів.

4. Виберіть файли, які попадуть в комміт.

5. Придумайте для комміта короткий заголовок на англійській мові не довше 72 символа.

6. До комміта також можна по бажанню додати більш докладніший опис, його довжина не обмежена, як мова, в якій ви будете описувати зміни.

   Перший комміт

7. Натисніть на синю кнопку Commit to і, якщо потрібно, зробіть комміти, що залишились (кроки 4–7).

   Другий комміт

8. Коли всі зміни закоммічені, натисніть на кнопку Publish branch, котра розташована зверху.

   

9. Перейдіть до публікації змін.