@radhikapc

Automating Content Translation Workflow with Transifex

For Apache CloudStack (ACS)

Credits

• Sebastien Goasguen

• David Nalley

• Apache CloudStack Community

• Dimitris Glezos

• Fuel Gilt

Agenda

•ACS Documentation Overview

•ACS Translation Concepts and Process

•Using Transifex Website

•Using Transifex Client

•ACS Documentation Overview

•ACS Translation Concepts and Process

•Using Transifex Website

•Using Transifex Client

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

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

Apache Review Board

7

Submit a Jira Ticket

Clone Git

Ship it!

Submit a Patch

•ACS Documentation Overview

•ACS Translation Concepts and Process

•Using Transifex Website

•Using Transifex Client

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

•ACS Documentation Overview

•ACS Translation Concepts and Process

•Using Transifex Website

•Using Transifex Client

Sign Up

Dashboard

Search for ACS Projects

Pick Up an ACS Project

Check the Resources

Pick One Resource

Check the Languages

Translate Strings

View the Progress

•ACS Documentation Overview

•ACS Translation Concepts and Process

•Using Transifex Website

•Using Transifex Client

Transifex Client (tx)

• Sign up on the Website

• Use Command Line

pip install transifex-client

Setup a Project

Initialize a transifex project on your computer: $ mkdir txproject

$ cd txproject

$ tx init

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

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)

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

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/

Q & A