openstack-manuals

Use itstool for docs translation

Registered by Shaun McCance

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

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

Nearby

This blueprint contains Public information 
Everyone can see this information.