Website translation support for

by Runa | September 20, 2009

This summer I was working on a set of scripts that would make it possible to translate the Tor Project website via Pootle on The website is based on a set of .wml files, but Pootle only takes files in the .pot and po format. The goal was to find a solution that would make it easy to not only translate from .wml to .po and back, but enable us to convert and keep the already translated documents.

The solution that I chose was to use the po4a framework in a set of scripts. The first script,, converts from .wml to .po and adds the correct charset, encoding and copyright holder. The script also checks to see which .po files need to be updated and which don't. The second script, writes the translated documents, i.e. converts from .po back to .wml. I also documented the things one would need to know before using the scripts, as well as the process of converting already translated documents. See the howto and the readme.

The project did not come without its challenges, and it took time before I got on the right track and found a solution that everyone was happy with. I looked at different scripts and SVN hooks before I settled on having two scripts that can be run at any time by anyone. In addition to that, my mentor was travelling a lot and communication was not very frequent. However, I do feel that I learned a lot and, at the same time, the communication with other GSoC students was a great help.

Overall, I'm pleased with how GSoC turned out. I am looking forward to seeing my code be put to use and to start working on other projects for Tor.


Please note that the comment area below has been archived.

January 24, 2010


Interesting project.currently i am very busy but want to take part in this project in the future. good luck!!

Omidiu, part of the Traduceri team.