On Thu, Aug 16, 2012 at 04:05:08AM -0700, Jessica Tomechak wrote: > A subset of the existing documentation for CloudStack has appeared in the > /docs directory of our repo. The need for the rest of it to follow suit is > well known and tracked here: > > http://bugs.cloudstack.org/browse/CS-15604 > > Radhika PC and I have been working on this doc forklift from Microsoft Word > to docbook. I searched for a conversion tool for quite awhile before > beginning this task, and I did not find anything remotely near good enough.
So, in a discussion last week[1] we'd talked about putting up the Word Doc and/or PDF for other folks to help with this - what happened with that? The DocBook Wiki[2] has some tools to convert from Word to DocBook, but I'm not sure how well any of them work. Note that some that say "word" really mean RTF, which isn't really going to help here. I did try converting some of the existing PDFs to text with pdftotext and converting to HTML with pdftohtml on Fedora. The results are messy, but *might* be better than just copy & pasting into Publican. Unfortunately, pdftohtml didn't do a very good job at grabbing images. > Has anyone here ever used a fantastic Word to docbook tool? Or would anyone > here like to write a functioning Word to docbook tool, for which every tech > writer in open source (and beyond) would be thankful? I think the scope of writing a reliable Word -> DocBook tool might be a wee bit much, especially before hitting the release deadlines we have for 4.0. Or 5.0... ;-) [1]: http://markmail.org/thread/5bogizbckpbdact2 [2]: http://wiki.docbook.org/DocBookTools -- Joe Brockmeier http://dissociatedpress.net/ Twitter: @jzb
