Керування версіями

Maintain an agile localization process and avoid translation delays for added texts or new product features. Інтегрує гілки вашого проекту в Crowdin і дозволяє перекладачам миттєво отримувати доступ до всіх нових текстів.

Гілки

Коли над розробкою продуктів працюють кілька людей, галузі допомагають керувати різними версіями вмісту. Якщо ваш проект є безперервним, ви можете додати гілки проектів до Crowdin і дати перекладачам право перекладати тексти паралельно з розробкою, щоб уникнути затримок з розгортанням.

Гілка Crowdin виглядає як звичайна папка, позначена спеціальним значком, з певною поведінкою щодо дублюючих рядків.
Приклад структури файлів у системі управління версіями (VCS) та Crowdin:

Створення галузі

Увага! Перші файли, які ви завантажуєте в проект Crowdin, повинні містити всі початкові рядки та розташовуватися у відповідній області. Для всіх зразкових статей гілка з оригінальними текстами має заголовок Master.

Існує кілька способів додати гілки до Crowdin:

  • Інтегруйте проекти Crowdin з GitLab, GitHub або Bitbucket. Це рекомендований варіант, оскільки гілки, обрані для локалізації у вашій системі управління версіями (VCS), будуть створені в Crowdin автоматично
  • Використовуйте CLI або API, додати нові гілки
  • Створіть гілки вручну, перейшовши до Налаштування проекту > Файли > Нова версія гілки
Створіть гілку за допомогою API

Щоб створити гілку через API, використовуйте метод Add Directory з параметром * is_branch = 1*:

POST https://api.crowdin.com/api/project/{project-identifier}/add-directory?key={project-key}&name={branch_name}&is_branch=1

Додати файл, Оновіть файл, Завантажте переклади та інші методи управління файлами та папками працюють з параметром branch={branch_name}.

Управління галуззю через CLI

Немає необхідності запускати певну команду для створення гілок версій, якщо використовується інструмент синхронізації. Гілка версії буде створена автоматично при завантаженні файлів. Приклад завантаження вихідних файлів/перекладів в зазначену гілку версії:

$ crowdin upload sources -b branch_name

$ crowdin upload translations -b branch_name

Дублікати

Через те, що гілки є різними версіями одного продукту, зміст локалізації в них зазвичай дублюється. Щоб допомогти перекладачам послідовно перекладати версії та уникати зайвих витрат на переклад, у нас є спеціальний варіант, який дозволяє приховати повторювані рядки лише між версіями. Якщо цей параметр обраний, слід перекладати лише початкові рядки, які були завантажені вперше. Усі дубльовані рядки автоматично отримують переклади з оригінальних рядків.

Дублікати

Запропонований робочий процес

Щоб переконатися, що версії вашого проекту Crowdin працюють безперебійно, рекомендуємо наступний робочий процес:

  1. Завантажте проектні файли в Crowdin, використовуючи один з доступних методів.
  2. Перейдіть до Налаштування проекту > Переклади > Дублікати і виберіть варіант, рекомендований для версій.

На екрані нижче показано, як працює робочий процес на практиці. Усі тексти з гілок Master, Branch 1 і Branch 2 передається на сервер перекладу відразу після їх появи, навіть якщо гілки ще не об’єднані в цій гілці Master.

Експорт перекладів

Переклади з усіх гілок версій зберігаються в одному архіві ZIP при завантаженні через веб-інтерфейс. Використовуйте інструмент або API Sync для завантаження перекладів для кожної гілки окремо.

Експортуйте переклади за допомогою API

Щоб експортувати переклади з вказаною версії гілки:

GET https://api.crowdin.com/api/project/{project-identifier}/export?key={project-key}&branch={branch_name}

Завантажити переклади з вказаної гілки версії:

GET https://api.crowdin.com/api/project/{project-identifier}/download/{package}.zip?key={project-key}&branch={branch_name}
Експортуйте переклади за допомогою CLI

Завантажити переклади з вказаної гілки версії:

$ crowdin download -b branch_name

Злиття гілок

Гілка Master буде містити нові тексти з гілок Feature як тільки вони поєднуються. Під час синхронізації з Crowdin всі тексти в області Master будуть доповнені перекладами з відповідної галузі.

Після синхронізації оновленої гілки Master з Crowdin, гілку Feature можна видалити з Crowdin. Усі переклади зберігатимуться в цій гілці Master.

Підтвердження перекладу гілки

You can verify translations on production using only Feature branch before changes are merged with your Master branch. Such Test Deploy gives you an option of quick revert to the original Master branch version if needed.

Дивись також

Ця стаття була корисною?