Wikifying DocBook

Jurjen Bokma

December 2009

For serious documentation, I like DocBook. (For more info on how I create the AppNotes, see .) If other people need to be able to edit my docs, a Wiki is nice, like the LWP Wiki. Here's how to bridge the gap between the two.


Mind you , the gap can be bridged from Docbook to Wiki, but there's loss of information, so the other way around is impossible

  1. That's described in .

  2. We need the html2wiki converter. Under Debian, it can be installed with sudo apt-get install libhtml-wikiconverter-mediawiki-perl. Now browse to where your XHTML is online, e.g. Copy that URL, and then run the command:

    html2wiki --dialect=MediaWiki --base-uri= --wiki-uri= ~/doc/generated/xhtml/ApprenticesNotes/ch26s09.html > /tmp/

  3. First view the Wikified text with your favourite pager (less in my case), then copy the content, and paste it into the Wiki.

  4. You may want to clean a few broken links to nonexistent images off the page. Or then again you may not.