simpletest icon indicating copy to clipboard operation
simpletest copied to clipboard

Documentation translation

Open peter279k opened this issue 8 years ago • 5 comments

Firstly, thank you for providing this project to make the PHP unit testing easily. When I refer the documentation, it only has the English version now. If possible, I can provide the traditional Chinese version for this project. I will also publish the tutorial post on my blog. How can I contribute the documentation? Thanks.

peter279k avatar Aug 31 '17 21:08 peter279k

Hey Peter!

You can find the XML files for the documentation in the following folder: https://github.com/simpletest/simpletest/tree/master/docs/source The documentation is available in english, french and italian language. You could start a new translation by copying from one of the existing folders, e.g. copy "en" to "cn". And then start translating by editing the xml files.

(I'm thinking about exporting the XML to markdown to make the process easier. That would remove the need to transform the XML to webpages and enable easier editing via Github.)

Thank you in advance for contributing, Jens

jakoch avatar Aug 31 '17 22:08 jakoch

Hi @jakoch, thank you for your reply. The markdown is easier than XML to make this process. But at this time, I will use the XML to do the new translation is fine. Maybe this will be the other feature.

Thanks.

peter279k avatar Aug 31 '17 23:08 peter279k

And when you'll be ready, I should be able to put them online. It will find the english (http://simpletest.org/en/start-testing.html), french (http://simpletest.org/fr/start-testing.html) and italian version (http://simpletest.org/it/start-testing.html) !

Yours.

perrick avatar Sep 01 '17 07:09 perrick

And by the way, the script used to "build" the web site is based on the XML version. It will need a big update if we go through a markdown migration.

perrick avatar Sep 01 '17 07:09 perrick

Hi @perrick, thank you for your reply. If we go through the markdown migration, I will make them to export to the markdown.

Thanks.

peter279k avatar Sep 01 '17 11:09 peter279k