Automating Content Translation Workflow with Transifex
•
0 likes•2,997 views
This document discusses automating content translation for Apache CloudStack documentation using Transifex. It provides an overview of ACS documentation, translation concepts and process, using the Transifex website, and using the Transifex client. Key steps include signing up on Transifex, finding and translating ACS project resources, and pushing translations. Translations can then be pulled directly into the codebase and documentation built in other languages. The community is encouraged to get involved in translations.
Report
Share
Automating Content Translation Workflow with Transifex
- 1. @radhikapc Automating Content Translation Workflow with Transifex For Apache CloudStack (ACS)
- 2. Credits • Sebastien Goasguen • David Nalley • Apache CloudStack Community • Dimitris Glezos • Fuel Gilt
- 3. Agenda •ACS Documentation Overview •ACS Translation Concepts and Process •Using Transifex Website •Using Transifex Client
- 4. •ACS Documentation Overview •ACS Translation Concepts and Process •Using Transifex Website •Using Transifex Client
- 6. The Apache Documentation Process • Functional Spec discussions on dev@cloudstack.apache.org • Sign up for a feature • Documentation Reviews through Apache Review Board— https://reviews.apache.org/ • Defects are filed at https://issues.apache.org/jira/browse/CLOUDSTACK
- 7. Apache Review Board 7 Submit a Jira Ticket Clone Git Ship it! Submit a Patch
- 8. •ACS Documentation Overview •ACS Translation Concepts and Process •Using Transifex Website •Using Transifex Client
- 9. Translation Concepts • Publican Builds Documentation in Different Languages • Generates .po Files for Translators • Translate Every String • Anyone can Translate Strings • No Need of Working with the Source Code • Transifex http://rlandmann.fedorapeople.org/pug/sect-Users_Guide-Preparing_a_document_for_translation.html
- 10. •ACS Documentation Overview •ACS Translation Concepts and Process •Using Transifex Website •Using Transifex Client
- 11. Sign Up
- 12. Dashboard
- 13. Search for ACS Projects
- 14. Pick Up an ACS Project
- 20. •ACS Documentation Overview •ACS Translation Concepts and Process •Using Transifex Website •Using Transifex Client
- 21. Transifex Client (tx) • Sign up on the Website • Use Command Line pip install transifex-client
- 22. Setup a Project Initialize a transifex project on your computer: $ mkdir txproject $ cd txproject $ tx init
- 23. Linking to ACS Transifex Project Main Documentation: $ tx set --auto-remote https://www.transifex.com/projects/p/ACS_DOCS/ Pull all resources for the project $ tx pull –s Pull existing translations: $ tx pull –a
- 24. Translate Pick a resource and make a copy with the language code of your target language, for example: $ cp translations/ACS_DOCS.pod-add/en.po translations/ACS_DOCS.pod-add/ml_IN.po Enter your translation in the msgstr lines: $ vi translations/ACS_DOCS.pod-add/ml_IN.po Push your translation $ tx push -l ml_IN -r ACS_DOCS.pod-add -t (replace the language code and the resource name with yours)
- 25. Building the Final Documentation • Pull the Strings Directly to the Source Code (ACS committers) • Build the Guides $ publican build --format=pdf --langs=ml_IN --config=publican- adminguide.cfg
- 26. Join the Community…. • Check us out @ ᵒ cwiki.apache.org/confluence/display/CLOUDSTACK/Index ᵒ http://cloudstack.org • IRC: #cloudstack on irc.freenode.net • Forums: http://cloudstack.org/forum/ • Subscribe to Mailing Lists @ dev@cloudstack.apache.org users@cloudstack.apache.org • Join Apache CloudStack Bangalore Meetup Group http://www.meetup.com/CloudStack-Bangalore-Group/ • Join Apache CloudStack Facebook Group https://www.facebook.com/groups/cloudstack/
- 27. Q & A