Все файлы локализации Сёрфа хранятся на GitHub. Для доступа к ним вам нужна учетная запись GitHub. Если вы ранее не использовали GitHub, пожалуйста, создайте ее.
Все изменения строк вносятся в файлы в вашем репозитории, чтобы не затрагивать исходный репозиторий TON-Surf-Localization.
- Перейдите в репозиторий локализации TON-Surf-Localization.
- В правом верхнем углу нажмите на кнопку Fork.
- Выберите, куда GitHub скопирует репозиторий локализации TON-SURF.
Теперь у вас есть копия репозитория, и вы можете вносить изменения в строки локализации.
Вы можете отредактировать файлы прямо в GitHub или скачать их на свой компьютер и редактировать локально.
- Нажмите на файл, который вы хотите отредактировать.
- Нажмите на значок карандаша.
Файл откроется во встроенном редакторе GitHub.
- Нажмите на файл, который вы хотите отредактировать.
- Щелкните правой кнопкой мыши по кнопке Raw и выберите Загрузить связанный файл.
Название контекстного меню зависит от используемого вами браузера.
Файл загрузится на ваш компьютер. Теперь вы можете открыть его в любом редакторе, поддерживающем формат JSON.
Иногда разные строки могут иметь один и тот же перевод. Чтобы точно знать, какую в какую строку вы вносите изменения, вы можете включить Помощника по локализации в приложении Surf.
- Откройте Surf for Translators.
- В левом верхнем углу нажмите на значок Сёрфа.
- Выберите Дополнительные настройки.
- Выберите Язык.
- Нажмите Включить помощника по локализации.
Теперь, когда вы помещаете курсор на строку, ее идентификатор будет отображаться в верхней части экрана.
Как только вы закончите вносить изменения, их нужно будет сохранить в вашем репозитории. Оттуда они попадут в репозиторий локализации TON-SURF.
- Прокрутите страницу вниз до конца
- Нажмите на кнопку Commit changes.
Если вы исправляли строки локально, скопируйте их. Затем откройте файл для редактирования в GitHub и вставьте туда изменения.
Запрос на слияние (Pull Request) позволяет перенести изменения из вашего репозитория в репозиторий локализации TON-Surf-Localization. При создании запроса следуйте этим правилам:
- Создавайте один запрос для одного языка. Если вы редактируете два или более языков, создайте отдельные запросы для каждого.
- Запросы принимаются только для последней версии файлов.
- Перейдите на вкладку Pull Request.
- Нажмите New pull request.
- Нажмите Create pull request.
- Введите название и опишите изменения.
- Отметьте людей, которые должны подтвердить ваши изменения. Список ревьюиров вы можете посмотреть здесь.
- Нажмите Create pull request.
Поскольку вы не являетесь членом Team Surf, после создания запросы вы увидите следующее сообщение:
Все в порядке. Пользователи, которых вы отметили, получат уведомления об изменениях, внесенных вами.
Изменения появятся в приложении через несколько недель после подтверждения запроса на слияние.
Чтобы вовремя получать уведомления об измененных строках и принимать участие в ревью переводов, вам нужно настроить Participating уведомления в GitHub.
- В правом верхнем углу страницы нажмите на фото профиля и выберите Settings.
- В меню Account settings выберите Notifications.
- В блоке Participating выберите, как вы хотите получать уведомления: Email или Web and Mobile.
Теперь вы точно не пропустите изменений, требующих вашего внимания. Когда кто-то отметит вас по имени пользователя, вы сразу получите уведомление.
Когда вас просят поучаствовать в ревью переводов, от вас зависит дать изменениям "зеленый свет" или попросить их автора что-то еще поправить.
- Откройте уведомление, в котором вас отметили в качестве ревьюера.
- Перейдите на закладку Files changed.
- Просмотрите измененные строчки. Если у вас возникли вопросы по переводу или вы нашли ошибку в тексте, вы можете оставить комментарий к строке следующим образом:
a) Справа от номера строки нажмите +.
b) Укажите свой комментарий и нажмите Add single comment.
- Когда все замечания будут учтены, а ошибки исправлены, нажмите Review changes.
- Выберите Approve и нажмите Submit review.
