wp-SwimTeam » DocBook http://www.wp-swimteam.org A WordPress plugin for swim team management Tue, 24 Jan 2012 22:21:56 +0000 en hourly 1 http://wordpress.org/?v=3.3.1 DocBook to PDF? http://www.wp-swimteam.org/2010/04/29/docbook-to-pdf/ http://www.wp-swimteam.org/2010/04/29/docbook-to-pdf/#comments Fri, 30 Apr 2010 03:00:10 +0000 Mike Walsh http://www.wp-swimteam.org/?p=336 I spent some time this afternoon writing some content in DocBook format using a tool called XMLmind XML Editor. I am using the free Personal Edition. I like the editor, it was quick to learn and works as advertized. After writing a couple pages I decided to see how it looked as a PDF file.

It turns out that turning DocBook into PDF isn’t as easy as I thought it would be.  I have yet to find a good solution.  I may have to buy the full version of XMLeditor.

]]> http://www.wp-swimteam.org/2010/04/29/docbook-to-pdf/feed/ 5 wp-SwimTeam documentation? http://www.wp-swimteam.org/2010/04/29/wp-swimteam-documentation/ http://www.wp-swimteam.org/2010/04/29/wp-swimteam-documentation/#comments Thu, 29 Apr 2010 19:42:01 +0000 Mike Walsh http://www.wp-swimteam.org/2010/04/29/wp-swimteam-documentation/ Like a lot of projects, documentation for wp-SwimTeam is severely lacking.  It has been on my to-do list for a long time and I have been thinking about it recently.  I was heading down the Wiki route recently and actually got one set up.  I’ve never been a big Wiki fan but I do see their attraction for certain types of projects.

I personally prefer “real” documentation and by “real” I mean something you can print and read away from the computer.  I’ve always like the model that used by Version Control with Subversion has used.  The source is in DocBook format which means it can easily be produced as web pages, a PDF file, or an actual book.

Right now I am leaning toward using the DocBook format.  At a minimum I am going to try it and see how it goes.  Stay tuned!

]]> http://www.wp-swimteam.org/2010/04/29/wp-swimteam-documentation/feed/ 0