automating content translation workflow with transifex
DESCRIPTION
A session given at FUEL GILT Conference 2013TRANSCRIPT
![Page 1: Automating Content Translation Workflow with Transifex](https://reader033.vdocuments.net/reader033/viewer/2022051514/54c2094c4a79598f198b4590/html5/thumbnails/1.jpg)
@radhikapc
Automating Content Translation Workflow with Transifex
For Apache CloudStack (ACS)
![Page 2: Automating Content Translation Workflow with Transifex](https://reader033.vdocuments.net/reader033/viewer/2022051514/54c2094c4a79598f198b4590/html5/thumbnails/2.jpg)
Credits
• Sebastien Goasguen
• David Nalley
• Apache CloudStack Community
• Dimitris Glezos
• Fuel Gilt
![Page 3: Automating Content Translation Workflow with Transifex](https://reader033.vdocuments.net/reader033/viewer/2022051514/54c2094c4a79598f198b4590/html5/thumbnails/3.jpg)
Agenda
•ACS Documentation Overview
•ACS Translation Concepts and Process
•Using Transifex Website
•Using Transifex Client
![Page 4: Automating Content Translation Workflow with Transifex](https://reader033.vdocuments.net/reader033/viewer/2022051514/54c2094c4a79598f198b4590/html5/thumbnails/4.jpg)
•ACS Documentation Overview
•ACS Translation Concepts and Process
•Using Transifex Website
•Using Transifex Client
![Page 5: Automating Content Translation Workflow with Transifex](https://reader033.vdocuments.net/reader033/viewer/2022051514/54c2094c4a79598f198b4590/html5/thumbnails/5.jpg)
ACS Documentation
http://docbook.org/ http://jfearn.fedorapeople.org/en-US/Publican/3.2/html/Users_Guide/index.html https://git-wip-us.apache.org/repos/asf?p=cloudstack.git
![Page 6: Automating Content Translation Workflow with Transifex](https://reader033.vdocuments.net/reader033/viewer/2022051514/54c2094c4a79598f198b4590/html5/thumbnails/6.jpg)
The Apache Documentation
Process
• Functional Spec discussions on [email protected]
• 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
![Page 7: Automating Content Translation Workflow with Transifex](https://reader033.vdocuments.net/reader033/viewer/2022051514/54c2094c4a79598f198b4590/html5/thumbnails/7.jpg)
Apache Review Board
7
Submit a Jira Ticket
Clone Git
Ship it!
Submit a Patch
![Page 8: Automating Content Translation Workflow with Transifex](https://reader033.vdocuments.net/reader033/viewer/2022051514/54c2094c4a79598f198b4590/html5/thumbnails/8.jpg)
•ACS Documentation Overview
•ACS Translation Concepts and Process
•Using Transifex Website
•Using Transifex Client
![Page 9: Automating Content Translation Workflow with Transifex](https://reader033.vdocuments.net/reader033/viewer/2022051514/54c2094c4a79598f198b4590/html5/thumbnails/9.jpg)
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
![Page 10: Automating Content Translation Workflow with Transifex](https://reader033.vdocuments.net/reader033/viewer/2022051514/54c2094c4a79598f198b4590/html5/thumbnails/10.jpg)
•ACS Documentation Overview
•ACS Translation Concepts and Process
•Using Transifex Website
•Using Transifex Client
![Page 11: Automating Content Translation Workflow with Transifex](https://reader033.vdocuments.net/reader033/viewer/2022051514/54c2094c4a79598f198b4590/html5/thumbnails/11.jpg)
Sign Up
![Page 12: Automating Content Translation Workflow with Transifex](https://reader033.vdocuments.net/reader033/viewer/2022051514/54c2094c4a79598f198b4590/html5/thumbnails/12.jpg)
Dashboard
![Page 13: Automating Content Translation Workflow with Transifex](https://reader033.vdocuments.net/reader033/viewer/2022051514/54c2094c4a79598f198b4590/html5/thumbnails/13.jpg)
Search for ACS Projects
![Page 14: Automating Content Translation Workflow with Transifex](https://reader033.vdocuments.net/reader033/viewer/2022051514/54c2094c4a79598f198b4590/html5/thumbnails/14.jpg)
Pick Up an ACS Project
![Page 15: Automating Content Translation Workflow with Transifex](https://reader033.vdocuments.net/reader033/viewer/2022051514/54c2094c4a79598f198b4590/html5/thumbnails/15.jpg)
Check the Resources
![Page 16: Automating Content Translation Workflow with Transifex](https://reader033.vdocuments.net/reader033/viewer/2022051514/54c2094c4a79598f198b4590/html5/thumbnails/16.jpg)
Pick One Resource
![Page 17: Automating Content Translation Workflow with Transifex](https://reader033.vdocuments.net/reader033/viewer/2022051514/54c2094c4a79598f198b4590/html5/thumbnails/17.jpg)
Check the Languages
![Page 18: Automating Content Translation Workflow with Transifex](https://reader033.vdocuments.net/reader033/viewer/2022051514/54c2094c4a79598f198b4590/html5/thumbnails/18.jpg)
Translate Strings
![Page 19: Automating Content Translation Workflow with Transifex](https://reader033.vdocuments.net/reader033/viewer/2022051514/54c2094c4a79598f198b4590/html5/thumbnails/19.jpg)
View the Progress
![Page 20: Automating Content Translation Workflow with Transifex](https://reader033.vdocuments.net/reader033/viewer/2022051514/54c2094c4a79598f198b4590/html5/thumbnails/20.jpg)
•ACS Documentation Overview
•ACS Translation Concepts and Process
•Using Transifex Website
•Using Transifex Client
![Page 21: Automating Content Translation Workflow with Transifex](https://reader033.vdocuments.net/reader033/viewer/2022051514/54c2094c4a79598f198b4590/html5/thumbnails/21.jpg)
Transifex Client (tx)
• Sign up on the Website
• Use Command Line
pip install transifex-client
![Page 22: Automating Content Translation Workflow with Transifex](https://reader033.vdocuments.net/reader033/viewer/2022051514/54c2094c4a79598f198b4590/html5/thumbnails/22.jpg)
Setup a Project
Initialize a transifex project on your computer: $ mkdir txproject
$ cd txproject
$ tx init
![Page 23: Automating Content Translation Workflow with Transifex](https://reader033.vdocuments.net/reader033/viewer/2022051514/54c2094c4a79598f198b4590/html5/thumbnails/23.jpg)
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
![Page 24: Automating Content Translation Workflow with Transifex](https://reader033.vdocuments.net/reader033/viewer/2022051514/54c2094c4a79598f198b4590/html5/thumbnails/24.jpg)
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)
![Page 25: Automating Content Translation Workflow with Transifex](https://reader033.vdocuments.net/reader033/viewer/2022051514/54c2094c4a79598f198b4590/html5/thumbnails/25.jpg)
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
![Page 26: Automating Content Translation Workflow with Transifex](https://reader033.vdocuments.net/reader033/viewer/2022051514/54c2094c4a79598f198b4590/html5/thumbnails/26.jpg)
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 @ [email protected] [email protected]
• Join Apache CloudStack Bangalore Meetup Group http://www.meetup.com/CloudStack-Bangalore-Group/
• Join Apache CloudStack Facebook Group https://www.facebook.com/groups/cloudstack/
![Page 27: Automating Content Translation Workflow with Transifex](https://reader033.vdocuments.net/reader033/viewer/2022051514/54c2094c4a79598f198b4590/html5/thumbnails/27.jpg)
Q & A