Github для переводчиков модов

Практическое применение Github для переводчиков модов.
Все примеры разобраны из личного опыта. Вариантов работы с Github гораздо больше, я лишь описал некоторые.

Что такое Github и для чего он нужен?

Github - это платформа для разработки и хранения кода, но ее также могут использовать переводчики модов.

Вот несколько способов, как Github может быть полезен для переводчиков модов:

• Централизованное хранение переводов.
  Github позволяет создавать репозитории, где перевод может быть хранен в централизованном месте. Это позволяет переводчикам сосредоточиться на обновлении только одного файла, вместо того, чтобы отслеживать изменения во всех файлах мода.
  
  
• Коллаборация с другими переводчиками (совместная работа в команде переводчиков)
  Github позволяет создавать ветки, где каждый переводчик может работать на отдельной ветке и потом объединять свои изменения в одном месте. Это способствует коллаборации и используется многими командами переводчиков для координирования своей работы.
  
  
• Отслеживание изменений в оригинальном моде.
  Github позволяет отслеживать изменения в оригинальном моде и своевременно вносить необходимые изменения в перевод. Если оригинальный мод обновляется, переводчик может обновить только те файлы, которые изменились, вместо того, чтобы обновлять весь перевод.

Таким образом, Github может быть полезен для переводчиков модов, ускоряя и упрощая процесс перевода и содействуя коллаборации с другими переводчиками.

Словарь терминов для Git и GitHub

• GitHub или Гитхаб — веб-сервис для размещения репозиториев и совместной разработки проектов.
  
• Репозиторий Git — каталог файловой системы, в котором находятся: файлы конфигурации, файлы журналов операций, выполняемых над репозиторием, индекс
  
• расположения файлов и хранилище, содержащее сами контролируемые файлы.
  
• Локальный репозиторий — репозиторий, расположенный на локальном компьютере разработчика в каталоге. Именно в нём происходит разработка и фиксация
  
• изменений, которые отправляются на удалённый репозиторий.
  
• Удалённый репозиторий — репозиторий, находящийся на удалённом сервере. Это общий репозиторий, в который приходят все изменения и из которого
  
• забираются все обновления.
  
• Форк (Fork) — копия репозитория. Его также можно рассматривать как внешнюю ветку для текущего репозитория. Копия вашего открытого репозитория
  
• на Гитхабе может быть сделана любым пользователем, после чего он может прислать изменения в ваш репозиторий через пулреквест.
  
• Обновиться из апстрима — обновить свою локальную версию форка до последней версии основного репозитория, от которого сделан форк.
  
• Обновиться из ориджина — обновить свою локальную версию репозитория до последней удалённой версии этого репозитория.
  
• Клонирование (Clone) — скачивание репозитория с удалённого сервера на локальный компьютер в определённый каталог для дальнейшей работы с этим
  
• каталогом как с репозиторием.
  
• Ветка (Branch) — это параллельная версия репозитория. Она включена в этот репозиторий, но не влияет на главную версию, тем самым позволяя свободно
  
• работать в параллельной. Когда вы внесли нужные изменения, то вы можете объединить их с главной версией.
  
• Мастер (Master) — главная или основная ветка репозитория.
  
• Коммит (Commit) — фиксация изменений или запись изменений в репозиторий. Коммит происходит на локальной машине.
  
• Пул (Pull) — получение последних изменений с удалённого сервера репозитория.
  
• Пуш (Push) — отправка всех неотправленных коммитов на удалённый сервер репозитория.
  
• Пулреквест (Pull Request) — запрос на слияние форка репозитория с основным репозиторием. Пулреквест может быть принят или отклонён вами, как
  
• владельцем репозитория.
  
• Мёрдж (Merge) — слияние изменений из какой-либо ветки репозитория с любой веткой этого же репозитория. Чаще всего слияние изменений из ветки
  
• репозитория с основной веткой репозитория.
  
• Кодревью — процесс проверки кода на соответствие определённым требованиям, задачам и внешнему виду.

Рабочее окно GitHub Desktop

Часть 1. Знакомство с GitHub

GitHub для самых маленьких #1 | Основы
https://www.youtube.com/watch?v=Rke_Z1-nvUM
Github для самых маленьких #2 | Практика – GitHub Desktop | Приложение Гитхаб для компьютера
https://www.youtube.com/watch?v=hyUBMmL0WtA
GitHub Desktop - основы контроля версий
Основы работы в GitHub Desktop, разбор вопросов о создании, клонировании и публикации кода.
https://www.youtube.com/watch?v=7aBx57MbSCE

Часть 2. Создание репозитария на Github через GitHub Desktop

Как загрузить проект в GitHub через GitHub DeskTop | Полный Гайд
https://www.youtube.com/watch?v=TOpE48e5zK8

Создание репозитария, добавление участников и создание бранчей, загрузка исходных файлов.

1.Нажимаем создать новый репозитарий локально на компе


2.Даем название и создаем


3.Кидаем файлы локализации в папку


4.Заполняем требуемую инфу и публикуем репозитарий на Github в облако


5. Заходим в настройки и добавляем коллаборатов ( переводчиков, если будете не самостоятельно переводить мод)


6. Через поиск находим коллаборатора и добавляем


7. Создаем отдельный бранч в GitHub Desktop как рабочее место для переводчика


8. Настройки смены видимости для репозитария - ставить публичную видимость

Часть 3. Защита основного бранча в Github от свободного редактирования

1. Заходим в настройки на сайте Github для репозитария


2. Выбираем бранч основной и ставим эти настройки


3. Варианты разных правил


4. Рекомендуемые минимальные правила без заморочек

Часть 4. Создание сабмода через лаунчер и синхронизация с репо

Создание сабмода через лаунчер, чтобы иметь синхронизацию с репозитарим с гитхаба, а так же тестировать перевод в самой игре.
Разобран пример для мода Elder Kings 2 для Crusader Kings 3

Часть 5. Работа с GitHub Desktop

Часть 6. Как создать pullrequest слияние изменений в основою ветку в Github

1. В GitHub Desktop в выбранном бранче нажимаем create pullrequest


2. Перекидывает на сайт GitHub и там надо подтвердить create pullrequest, а так же добавить описание


3. Выполнить действия слияния с основной веткой как на скриншоте


4. Выполнить действия слияния с основной веткой как на скриншоте


5. Успешный результат

Часть 7. Обновление бранча с основной ветки main

Помогает поддерживать в актуальном состояние другие бранчи ( по началу можно делать копии файлов перед этим действием на всякий случай)

Часть 8. Простой способ контроля новых строк с выходом обновлений мода

Вариант 1

1.Создаем новый репо



2.Создаем бранч с текущим обновлением ( Желательно подробно указывать название,номер версии и дату выхода)


3.Кидаем с основы мода папку localisation


4.Загружаем файлы


5.С выходом новой версии, копируем и вставляем папку с заменой файлов



6.Вот такой результат


7.Создаем новый бран под обновление




8.Публикуем его


9.Текущие бранчи


10.Заходим в гитхаб и выбираем бранчи для сравнения


11. Результат сравнения и прекрасно видно изменения


12. Так же можно увидеть результат и в Github Desktop (по мне самый удобный вариант)



Вариант 2 (более упрощенный)

1. Загрузка текущей версии


2. С выходом новой версии замена файлов в папке


3. Заполняем инфу о новой версии и нажимаем коммит и фетч орижин


4. Открываем историю и видим результат


5. Так же можно проверить на сайте Github


6. Результат изменения в файлах локализации

Часть 9. Плагины для удобства

GitZip for github
Плагин на браузер, чтобы скачать отдельные файлы с гитхаб, а не все архивом

Другие полезные руководства для переводчиков

Полезный софт и рекомендации для переводчиков модов
https://steamcommunity.com/sharedfiles/filedetails/?id=2986074766
Руководства для перевода модов игры Stellaris
https://steamcommunity.com/sharedfiles/filedetails/?id=2986100584
Руководства для перевода модов игры Hearts of Iron IV
https://steamcommunity.com/sharedfiles/filedetails/?id=2986098717
Руководства для перевода модов игры Crusader Kings III
https://steamcommunity.com/sharedfiles/filedetails/?id=2986093729

[divann.2]

как то много картинок и кажется длинным из за этого
гитхаб достаточно интуитивно понятен даже для человека который вообще ранее не был знаком с работой с ним (мой друг и он быстро всё понял без гайдов даже)