[Openstack-docs] proposed rst-xml automation openstack-manuals blueprint

David Cramer david.cramer at rackspace.com
Thu Oct 10 00:00:03 UTC 2013


Hi Sean,
xslt would be well-suited to cleaning up the output of pandoc and
converting it to DocBook 5.x. This could be invoked from your python script:

https://svn.code.sf.net/p/docbook/code/trunk/docbook/relaxng/tools/db4-upgrade.xsl

If you have other cleanup to perform, we could add the necessary logic
to the db4-upgrade.xsl.

I'll be happy to help with the xslt and I think the result would be more
robust.

Regards,
David

On 10/09/2013 06:37 PM, Sean Roberts wrote:
> The training-manuals team is proposing a blueprint to implement rst to
> xml conversion script. This code is used to convert devref project rst
> documentation into xml that the openstack manuals project can use. The
> Training-manuals sub-project will use xi:include statements so the
> converted xml becomes part of the training guides during build. The
> conversion script will live in the ./training-guide/sources sub
> directory of the training-manuals sub-project. The converted xml gets
> placed within ./training-guide/sources/<project> directories. The
> conversion script will be run at the same time as when the
> openstack-manuals repo updates are pulled. This will allow the training
> manuals team to find xml content and include it with the training
> guides. If the source RST has a bug, then the RST source will be
> patched, and the XML will get the bug fix through the next run of the
> conversion script.
> 
> Blueprint
> here https://blueprints.launchpad.net/openstack-manuals/+spec/rst-xml-conversion
> Wiki details
> here https://wiki.openstack.org/wiki/Training-manuals#RST-XML_Conversion_automation
> 
> Sean Roberts
> Infrastructure Strategy
> seanrob at yahoo-inc.com <mailto:seanrob at yahoo-inc.com> (925) 980-4729
> 
> 
> 
> _______________________________________________
> Openstack-docs mailing list
> Openstack-docs at lists.openstack.org
> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs
> 




More information about the Openstack-docs mailing list