I've been an admin and promoter of MoinMoin in the past and currently use a MoinMoin wiki as part of the OpenStack project. I'm also involved with DocBook.

<dcramer AT thingbag DOT net>

/DocBookToMoinMoin

Messages to me

Welcome, David!

About DocBook and moin: we have some docbook related code in moin, but no moin developer uses / maintains it.

-- ThomasWaldmann 2008-12-25 11:01:49

The "Render as DocBook" feature is very impressive and meets a longstanding need for pubs groups that use DocBook or other XML formats. Now we can have developers write up content in the wiki and do a quick conversion to our format, DocBook, for further editing. The tedious application of markup is mostly gone and we can focus on adding value to the content. Once we run it though our xsls and fo renderer, the html and pdf output has the right look and feel just like all our other content. I had investigated "Render as DocBook" when I was at 1.5.x, but the DocBook it produced was broken in ways I couldn't easily fix with xslt post processing. Now it produces very clean DocBook.

Another direction I would like to see this taken is to add actions/formatters to generate the DocBook and further process it into other outputs. I can do this right now just by having my doc build script grab the docbook verison of the page and xslt it to my liking, but having it integrated into the wiki as an action would improve the usabiity.

I have one problem. For me, Render as DocBook fails if the Include() macro is used, even in a very simple test. I notice that "Render as DocBook" does fine on the moinmoin.in wiki. I did see this bug, MoinMoinBugs/RenderAsDocbookFailedForPageWithTitlesonlyIncludeMacro, but it doesn't apply to my situation. I'm not using titlesonly. I've attached TestPage.html to show what happens when I Render as DocBook a page with includes.

I have one thing I'm going to try before I post a question about this to the list. I saw some weird stuff after I installed 4suite and I want to have our IT guy look into that.

-- DavidCramer 2008-12-26 18:10:16


Test that proves "Render as DocBook" works with Include on this wiki:

Another test:

A list

MoinMoin: DavidCramer (last edited 2012-03-19 02:25:17 by DavidCramer)