Hello i18n team,
OpenStack's current translation platform(translation.openstack.org) is
based on Zanata, which is no longer maintained. To ensure a sustainable
translation workflow, the i18n team has been migrating from Zanata to
Weblate.
This work officially started following the CMU Summer semester mentoring
shared by Kendall Nelson in May (link), and has since been moving forward
in collaboration with the Korea User Group and mentees participating in the
government-sponsored Open Source Contribution Academy program.
1. Migration progress
Migration scope:
- Download translated .po files from Zanata and upload them to Weblate
- The same language set configured in Zanata is also applied in Weblate.
Branches:
- Currently, only the master branch is being migrated.
- We are exploring ways to support stable branches in the future.
Migration Contents:
- At this stage, the migration targets strings inside source code and
release notes.
- We are in the process of expanding this to include documentation as
well.
We started with Horizon and its plugins, and the following projects have
already been successfully migrated to Weblate:
• cloudkitty-dashboard
• designate-dashboard
• freezer-web-ui
• heat-dashboard
• horizon
• ironic-ui
• magnum-ui
• manila-ui
• networking-bgpvpn
• neutron-fwaas-dashboard
• neutron-vpnaas-dashboard
• octavia-dashboard
• trove-dashboard
• zaqar-ui
• zun-ui
2. New Zuul jobs for Weblate
To replicate the existing Zanata-based Zuul workflow, we are adding new
Weblate jobs.
• Patch: https://review.opendev.org/c/openstack/openstack-zuul-jobs/+/921878
We plan to reuse the translation-jobs-master-only Zuul templates and update
the following playbooks to run both Zanata and Weblate tasks:
•
https://opendev.org/openstack/project-config/src/branch/master/playbooks/tr…
•
https://opendev.org/openstack/project-config/src/branch/master/playbooks/tr…
• Patch: https://review.opendev.org/c/openstack/project-config/+/961499
3. Migration scripts
Although they are one-off scripts, we are adding them to the i18n
repository to document how we migrated from Zanata to Weblate.
• Language sync tool: https://review.opendev.org/c/openstack/i18n/+/961371
• Zanata-to-Weblate migration tool:
https://review.opendev.org/c/openstack/i18n/+/961075
4. Next steps for migration
We have implemented everything needed to replace the Zanata-based jobs with
Weblate. Once the Zuul job patches are merged, we will verify the upstream
pipeline.
Our goal is to migrate all projects from Zanata to Weblate by October.
After verifying the pipeline, we plan to shut down Zanata.
5. Future plans
Beyond this migration, we plan to expand translation targets — including
OpenStack governance documents and the docs/ directories of many projects —
to provide broader translation opportunities.
Anyone interested in contributing is warmly welcome to join us in the
#openstack-i18n IRC channel and say hello!
Thanks,
Best Regards
Seongsoo Cho
--
Seongsoo Cho
OpenStack Korea User Group / Community Leader
IRC #seongsoocho