|
|
|
|
|
# For those who manage the translation process
|
|
|
|
|
|
[[_TOC_]]
|
|
|
|
|
|
# How to add a new translation resource
|
|
|
|
|
|
To add a new translation resource, you will need three things: admin access on Transifex to add the new resource, access to Tor's translation server, and permission to push to [translation-tools.git](htt
|
|
|
ps://gitweb.torproject.org/translation-tools.git) and [translation.git](https://gitweb.torproject.org/translation.git). The rest of this section will assume that you are adding the The Metadata Anonymiza
|
|
|
tion Toolkit to Transifex ([#7892](https://trac.torproject.org/projects/tor/ticket/7892)).
|
... | ... | @@ -150,4 +155,52 @@ Do this for both resources you're creating. |
|
|
```
|
|
|
cd /srv/translation.torproject.org/tools
|
|
|
git pull
|
|
|
``` |
|
|
\ No newline at end of file |
|
|
```
|
|
|
|
|
|
# How to retire a localization resource
|
|
|
|
|
|
When we make sure that we are not going to need more translations we need to retire a resource. It is important to not keep for translations documents we don't use anymore.
|
|
|
|
|
|
We retire the repository branches to the attic. In this way, we can keep the strings our volunteers translated from us, and we can recover them if we use them again.
|
|
|
|
|
|
`export project='tba-torbrowserstringsdtd'`
|
|
|
|
|
|
On your translation-tools repository, remove the line with the resource so the translation bot will not try to get updates, and push the changes:
|
|
|
|
|
|
`vim config` - remove the string
|
|
|
`git add config`
|
|
|
`git commit -m 'retire $project'`
|
|
|
|
|
|
Then, login to majus and pull the change:
|
|
|
|
|
|
`ssh majus`
|
|
|
`sudo -u translation bash`
|
|
|
`cd /srv/translation.torproject.org/tools`
|
|
|
`git pull`
|
|
|
`cd /srv/translation.torproject.org/translations`
|
|
|
`rm -rf $project`
|
|
|
`rm -rf $project\_completed`
|
|
|
|
|
|
Then, you need to remove the project in Transifex through the web interface.
|
|
|
|
|
|
- Go to the settings for the resource and click on the bottom: Delete this resource
|
|
|
|
|
|
Then, you need to push the branch to the attic, and remove it from the translation.git remote repo. In a local copy of the [translation.git](https://git.torproject.org/translation.git) repo, checkout the branch:
|
|
|
|
|
|
`git checkout $project`
|
|
|
`git pull`
|
|
|
|
|
|
(if you do this for the first time, do:
|
|
|
`git remote add attic ssh://git@git-rw.torproject.org/translation-attic.git` )
|
|
|
`git push attic`
|
|
|
|
|
|
The branch $project\_completed is only a subset of this branch, so we don't save it on the attic to save space.
|
|
|
|
|
|
Now, we need to remove the branches from the translation.git repository, to prevent confusion and keep it easier to use. Please make sure to upload to the attic before this step:
|
|
|
|
|
|
`git push origin --delete $project`
|
|
|
`git push origin --delete $project\_completed`
|
|
|
|
|
|
Make sure you update arthuredelstein if this change affects the [Stats for Tor Project Localization](https://torpat.ch/) he so kindly maintains.
|
|
|
|
|
|
You are done! |