[docbook] Best wiki engines or tools for wiki-to-docbook conversions?

COUTHURES Alain alain.couthures at agencexml.com
Thu Apr 30 17:14:50 UTC 2009

Hello Jim,
> The project's current documentation is written in docbook, but as part 
> of this effort, we want to make it easier for new contributors to 
> write documentation without overwhelming them with the details of docbook.
Yes, it's important for new contributors and my current project 
(XSLTForms) has now a documentation in wiki format even though I would 
prefer an XML notation such as Docbook.
> With that in mind, in your experience, what open-source wiki engines 
> (if any) provide the best output to docbook? If you can't think of 
> any, what tools may provide the best means of converting wiki text to 
> docbook?
I would seriously consider using an XSLT stylesheet. With just adding a 
document element, even XSLT 1.0 can parse text in wiki format. It might 
sound weird but I have already parsed CSS stylesheets and XPath 
expressions with XSLT 1.0 only. Today, XSLT 1.0 is well supported by 
almost any environment, at client-side and at server-side.

My current project is an XForms implementation at client-side 
(http://www.agencexml.com/xsltforms). I have already thought of a wiki 
editor being integrated in a form in place of a textarea control and an 
extension function could, even, locally perform the XSLT transformation 
to DocBook notation before submitting it !

What do you think of this ?

Best regards,

Alain Couthures
Bordeaux, France

More information about the ubuntu-doc mailing list