Use itstool for docs translation

Registered by Shaun McCance on 2014-04-30

openstack-manuals, api-site, and operations-guide currently use a custom xml2po-based script to extract POT files from DocBook and to merge the translations back to DocBook. xml2po is not designed to work like this, and the generatepot/generatedocbook scripts override xml2po internals to provide custom behavior. itstool is a successor to xml2po, and is designed to allow local overrides using standard W3C Internationalization Tag Set (ITS) rules. We should switch these and any other modules using xml2po.

Blueprint information

Status:
Complete
Approver:
Ying Chun Guo
Priority:
Low
Drafter:
Shaun McCance
Direction:
Approved
Assignee:
Shaun McCance
Definition:
Obsolete
Series goal:
Accepted for kilo
Implementation:
Informational Informational
Milestone target:
milestone icon kilo
Completed by
Tom Fifield on 2015-02-27

Related branches

Sprints

Whiteboard

Gerrit topic: https://review.openstack.org/#q,topic:bp/itstool-for-docs,n,z

Addressed by: https://review.openstack.org/91869
    Switch to itstool from custom xml2po code for docs translation

Addressed by: https://review.openstack.org/91873
    Add some local ITS markup for better translation

(?)

Work Items

This blueprint contains Public information 
Everyone can see this information.