[Openstack-docs] Markdown conversion challenges

Andreas Jaeger aj at suse.com
Wed Feb 26 18:28:45 UTC 2014


On 02/26/2014 07:12 PM, Andreas Jaeger wrote:
> On 02/26/2014 06:32 PM, Sam Harwell wrote:
>> Hi Andreas,
>>
>> I was suggesting that the toolchain could be updated to recognize a comment in the Markdown file having that format. Until the toolchain supports this special syntax, it will treat it like any other XML comment (i.e. ignored).
>>
>> David Cramer could create an appropriate patch to detect and translate an XML comment having that specific syntax at the beginning of the file.
>>
> 
> I'm experimenting with the toolchain now to do some replacement...

I've fixed now our markdown script to add the first line of the document
as title:
https://review.openstack.org/76608

This means we don't need to touch the markdown files at all. This looks
fine enough for both image-api v2 and identity-api v3 docbooks.

Andreas
-- 
 Andreas Jaeger aj@{suse.com,opensuse.org} Twitter/Identica: jaegerandi
  SUSE LINUX Products GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany
   GF: Jeff Hawn,Jennifer Guild,Felix Imendörffer,HRB16746 (AG Nürnberg)
    GPG fingerprint = 93A3 365E CE47 B889 DF7F  FED1 389A 563C C272 A126



More information about the Openstack-docs mailing list