Перевод Snipp

Snipp переводится его сообществом, и мы будем рады вашей помощи. Если вы свободно владеете другим языком, вы можете улучшить существующие переводы или помочь добавить новый язык. Это руководство охватывает всё, что вам нужно.

Награды

  • За значимый вклад вы получаете эксклюзивный значок «Переводчик» в своём профиле Snipp.

  • Вы также получите роль «Переводчик» на нашем сервере Discord.

  • Самые активные участники могут получить Snipp PLUS в качестве благодарности.

С чего начать

Лучше всего начать с нашего сервера Discord где переводчики координируют работу, закрепляют за собой языки и получают помощь. Сообщите нам, над каким языком вы хотели бы работать, чтобы избежать дублирования усилий.

Два способа перевода

Есть два способа внести вклад в переводы. Выберите тот, который вам подходит, использовать оба не обязательно.

Crowdin

Самый простой вариант. Переводите прямо в браузере без знания JSON или Git. Crowdin показывает каждую строку в контексте и берёт форматирование на себя. Рекомендуется большинству переводчиков.

Открыть Crowdin

GitHub

Для разработчиков, знакомых с Git. Редактируйте файлы JSON напрямую и открывайте pull request. Лучший вариант, если вам нужен полный контроль или вы добавляете новый язык.

Открыть репозиторий

Как устроены файлы

Каждый язык — это плоский файл JSON. Ключ является стабильным идентификатором и никогда не меняется. Значение — это текст, который видят пользователи, и именно его вы переводите:

{
  "SETTINGS_PREFS_AUTO_COMPRESSION_LABEL": "Automatic Compression",
  "SETTINGS_PREFS_PARTY_MODE_LABEL": "Party Mode"
}

Английский файл является источником истины. У всех остальных языков точно такой же набор ключей, поэтому вы меняете только значения.

Правила

  • Никогда не добавляйте, не удаляйте и не переименовывайте ключи. Новые ключи поступают из исходного кода Snipp. Если ключ отсутствует в вашем языке, сайт использует английский вариант.

  • Сохраняйте подстановки без изменений. Текст вроде {count} или {username} заменяется во время выполнения. Сохраняйте точно те же подстановки, хотя вы можете перемещать их в соответствии с порядком слов вашего языка.

  • Соблюдайте правила регистра. Короткие подписи интерфейса используют Заглавные Буквы В Каждом Слове на всех языках. Полные предложения используют обычный регистр предложений вашего языка.

  • Не переводите названия брендов и технические термины. Оставляйте Snipp, Discord, ShareX, URL, API, PLUS и расширения файлов как есть.

  • Сохраняйте корректность JSON. Используйте двойные кавычки, запятую после каждой записи кроме последней и не оставляйте завершающих запятых.

  • Сохраняйте начальные и конечные пробелы, если они есть в значении. Они добавлены намеренно и используются для соединения предложений.

Отправка через GitHub

Если вы выбрали путь через GitHub, вот порядок действий. Переводчики Crowdin могут пропустить этот раздел: ваши изменения отправляются прямо из Crowdin.

Переводы отправляются через репозиторий i18n на GitHub используя стандартный процесс fork и pull request:

  • Сделайте форк репозитория, затем клонируйте свой форк и создайте новую ветку для вашего изменения.

  • Отредактируйте файл вашего языка и переведите значения, которые хотите улучшить.

  • Запустите скрипт проверки из корня репозитория и исправьте всё, на что он укажет, перед отправкой.

  • Сделайте коммит, отправьте изменения в свой форк и откройте pull request в основную ветку. Сопровождающий проверит и выполнит слияние.

Предпочитаете не использовать командную строку? Веб-редактор GitHub тоже подойдёт. Откройте файл языка, нажмите на значок карандаша, отредактируйте и предложите свои изменения.

Добавление нового языка

Snipp ещё не поддерживает ваш язык? Откройте issue на GitHub с предложением языка и его кода локали, скопируйте английский исходный файл как отправную точку, переведите все значения и откройте pull request. Сопровождающий зарегистрирует новую локаль на сайте.

Готовы помочь?

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

Больше статей