Many Fedora Docs project contributors enjoy writing on the wiki using the WYSIWYG editor that is provided by MediaWiki. This is great for contributors but not so much when we are trying to pull all this information into DocBook for formal release. The solution was simple: Ian had to fix mw-render.
This all went down at FUDCon Blacksburg, just a couple weeks ago. Ian and John got together to break, fix, or eliminate the tool we once used to do the conversion of MediaWiki text to DocBook. Ian worked for several hours trying to piece code together to make mw-render work. It did not, however, ever get off the ground despite his best efforts. Several releases prior to the current version of mw-render the DocBook functionality was removed leaving it no longer useful for our needs.
Once it sunk in that mw-render was dead to us, we started looking for an existing solution. We found many but none that would do exactly what we wanted. Ian started drawing up plans for a replacement and we decided that if we were going to do the work to build a tool to do the conversions that we should really do it up right.
This brings us to the project of DocsGlue. The current vision of DocsGlue is a program that will take MediaWiki text, turn it into DocBook XML, then open a ticket in Red Hat’s Bugzilla instance for a certain guide and add the DocBook XML text as an attachment. The guide owner can then easily use the attached file as source for a guide that can then be translated and published.
DocsGlue will be usable from both the command line and the GUI. This will make it easy for anyone to use no matter how they like to operate.
This will hopefully reduce the amount of time spent on moving data from the wiki into our guides and also make this information a lot more useful for users looking for answers.
Currently the project is hosted on Fedora Hosted where all the source code will be available.