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

Sean Roberts seanrob at yahoo-inc.com
Thu Oct 10 00:48:17 UTC 2013


Sounds great. I'll post my latest code to my repo and share. 

~sean

> On Oct 9, 2013, at 17:00, "David Cramer" <david.cramer at rackspace.com> wrote:
> 
> 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