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

Tom Fifield tom at openstack.org
Thu Oct 10 02:54:35 UTC 2013


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> 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
> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs
>




More information about the Openstack-docs mailing list