Announcing DocsGlue


mw-render replacement signMany 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.

DocsGlue notesThis 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.

About these ads
  1. No comments yet.
  1. No trackbacks yet.

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s

Follow

Get every new post delivered to your Inbox.

Join 202 other followers