<html><body>
<p><font size="2" face="sans-serif">Anne,</font><br>
<br>
<font size="2" face="sans-serif">I would take a look at this new format, and see how it could fit to our translation process.</font><br>
<font size="2" face="sans-serif">Thank you for postpone the publish till the agreement on translation toolchain.</font><br>
<br>
<font size="2" face="sans-serif">Best regards<br>
Ying Chun Guo (Daisy)<br>
</font><br>
<br>
<img width="16" height="16" src="cid:1__=C7BBF772DFDD2B6D8f9e8a93df938@cn.ibm.com" border="0" alt="Inactive hide details for Anne Gentle ---2015/02/02 22:06:25---Hi all, We're preparing to migrate user guides to RST to improve"><font size="2" color="#424282" face="sans-serif">Anne Gentle ---2015/02/02 22:06:25---Hi all, We're preparing to migrate user guides to RST to improve ease of authoring</font><br>
<br>
<font size="1" color="#5F5F5F" face="sans-serif">From: </font><font size="1" face="sans-serif">Anne Gentle <annegentle@justwriteclick.com></font><br>
<font size="1" color="#5F5F5F" face="sans-serif">To: </font><font size="1" face="sans-serif">"openstack-i18n@lists.openstack.org" <openstack-i18n@lists.openstack.org>, "openstack-docs@lists.openstack.org" <openstack-docs@lists.openstack.org></font><br>
<font size="1" color="#5F5F5F" face="sans-serif">Date: </font><font size="1" face="sans-serif">2015/02/02 22:06</font><br>
<font size="1" color="#5F5F5F" face="sans-serif">Subject: </font><font size="1" face="sans-serif">[Openstack-i18n] Translating RST source with Sphinx builds</font><br>
<hr width="100%" size="2" align="left" noshade style="color:#8091A5; "><br>
<br>
<br>
<font size="3" face="serif">Hi all,</font><br>
<br>
<font size="3" face="serif">We're preparing to migrate user guides to RST to improve ease of authoring for documentation. The spec [1] is now published, and we've got a research item for a toolchain that can "slice" RST similar to the DocBook slicing we do now.</font><br>
<br>
<font size="3" face="serif">Reading the Sphinx documentation, it seems that you can run sphinx-build -b get-text to extract translatable strings to get a collection of .po files. </font><br>
<br>
<font size="3" face="serif">This seems very similar to our current docbook slicing script. Does anyone have time this release to go through the RST files we're creating with the Sphinx workflow and analyze the results?</font><br>
<br>
<font size="3" face="serif">I don't intend to publish the RST-based user guides until we have agreement on the translation toolchain, so we have until April 9, but ideally we'll have answers this month -- originally on the spec I wanted answers by last month, but without a lot of complex RST to test there wasn't a great way to research. Now that we are getting more RST files in openstack/openstack-manuals/doc/playground-user-guide [3] I would appreciate help here.</font><br>
<br>
<font size="3" face="serif">Thanks,</font><br>
<font size="3" face="serif">Anne</font><br>
<br>
<font size="3" face="serif">1. </font><a href="http://specs.openstack.org/openstack/docs-specs/specs/kilo/migrate-to-new-web-design.html"><font size="3" color="#0000FF" face="serif"><u>http://specs.openstack.org/openstack/docs-specs/specs/kilo/migrate-to-new-web-design.html</u></font></a><br>
<font size="3" face="serif">2. </font><a href="http://sphinx-doc.org/latest/intl.html"><font size="3" color="#0000FF" face="serif"><u>http://sphinx-doc.org/latest/intl.html</u></font></a><br>
<br>
<tt><font size="2">_______________________________________________<br>
Openstack-i18n mailing list<br>
Openstack-i18n@lists.openstack.org<br>
</font></tt><tt><font size="2"><a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-i18n">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-i18n</a></font></tt><tt><font size="2"><br>
</font></tt><br>
</body></html>