Update instructions for working with translations

This commit is contained in:
Vit Mojzis 2022-01-13 13:57:27 +01:00
parent 46d862d45c
commit 38d9ec3188
1 changed files with 37 additions and 19 deletions

View File

@ -1,29 +1,47 @@
Setroubleshoot translations currently live in the following locations:
- https://fedora.zanata.org/project/view/setroubleshoot
- contains translations for both stable (RHEL) and master (Fedora) branches
- https://translate.fedoraproject.org/projects/setroubleshoot/
- contains translations for both stable (rhel8) and main (Fedora) branches
- maintains large number of languages (several of which do not actually contain any translated strings)
- updated by community and partially by RH localization effort
- setroubleshoot source repositories (https://pagure.io/setroubleshoot and https://github.com/fedora-selinux/setroubleshoot)
- is kept up-to-date with fedora.zanata
- setroubleshoot source repositories
- https://gitlab.com/setroubleshoot
- used for development
- separate repos for plugins and framework
- https://pagure.io/setroubleshoot and https://github.com/fedora-selinux/setroubleshoot
- no longer updated
- plugins and framework in the same repo
How to update source files on fedora.zanata:
$ git clone git@github.com:fedora-selinux/setroubleshoot.git
$ cd setroubleshoot/framework
# Update Makefile
How to update source files on weblate:
# install dependencies
$ sudo dnf install automake autoconf inittool gettext glib2-devel dbus-devel libnotify-devel gtk3-devel audit-libs-devel
$ git clone git@gitlab.com:setroubleshoot/framework.git
$ git clone git@gitlab.com:setroubleshoot/plugins.git
$ cd framework
# Update Makefile
$ ./autogen.sh
# generate new potfile
# generate new potfile
$ cd po
$ make setroubleshoot.pot
# Repeat the process for plugins
# Push potfiles to zanata
$ zanata-cli push --push-type source
# https://translate.fedoraproject.org/projects/setroubleshoot/setroubleshoot/en/
# Files -> Upload translations
# Repeat the process for plugins
# https://translate.fedoraproject.org/projects/setroubleshoot/plugins/en/
# Files -> Upload translations
# or use weblate command line tool:
$ wlc --key <API key> --url https://translate.fedoraproject.org/api/ upload --input framework/po/setroubleshoot.pot setroubleshoot/setroubleshoot/en
$ wlc --key <API key> --url https://translate.fedoraproject.org/api/ upload --input plugins/po/setroubleshoot.pot setroubleshoot/plugins/en/
How to pull new translations from zanata
$ git clone git@github.com:fedora-selinux/setroubleshoot.git
$ cd setroubleshoot
# Make sure "zanata.xml" file pointing to corresponding translations branch is present
# Optionally update source files on zanata
# Pull new translations from zanata
$ zanata-cli -e pull --pull-type trans
How to pull new translations from weblate
$ git clone git@gitlab.com:setroubleshoot/framework.git
$ git clone git@gitlab.com:setroubleshoot/plugins.git
# https://translate.fedoraproject.org/projects/setroubleshoot/setroubleshoot
# Files -> Download translation files as ZIP file
# https://translate.fedoraproject.org/projects/setroubleshoot/plugins/
# Files -> Download translation files as ZIP file
$ unzip setroubleshoot-setroubleshoot.zip
$ cp setroubleshoot/setroubleshoot/framework/po/*.po /framework/po
$ unzip setroubleshoot-plugins.zip
$ cp setroubleshoot/plugins/plugins/po/*.po /plugins/po
# wlc doesn't support batch download yet https://github.com/WeblateOrg/wlc/issues/17