Open Stack

Good question. The immediate need is for the associate guide that we are working on right now.


Sean Roberts
Infrastructure Strategy
seanrob at yahoo-inc.com<mailto:seanrob at yahoo-inc.com> (925) 980-4729

On Oct 9, 2013, at 7:54 PM, Tom Fifield <tom at openstack.org<mailto:tom at openstack.org>>
 wrote:

Hi Sean,

Just wondering - is this mainly for the "Developer Training Guide" ?

Regards,


Tom

On 10/10/13 11:48, Sean Roberts wrote:
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<mailto: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


_______________________________________________
Openstack-docs mailing list
Openstack-docs at lists.openstack.org<mailto:Openstack-docs at lists.openstack.org>
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs



_______________________________________________
Openstack-docs mailing list
Openstack-docs at lists.openstack.org<mailto:Openstack-docs at lists.openstack.org>
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-docs/attachments/20131010/81de0621/attachment.html>