Category Archives: docbook

>Flexing the Vex editor

Posted on March 28, 2010 by kingargyle

>I’ve been doing more writing lately besides just blog posting. One of the problems I have with tools like Microsoft Office and Open Office is that it is very easy to mess up the presentation side of things. Especially when … Continue reading →

Posted in css, dita, docbook, documentation, eclipse, wiki, xml | 5 Comments

>VEX (Visual Editor for XML) gets some life

Posted on October 28, 2009 by kingargyle

>It has been way to long since I reported anything meaningful on VEX, a WYSIWYG editor for XML files. It originally resided on SourceForge but has since migrated to eclipse in the WTP Incubator. Thanks to some community contributions we … Continue reading →

Posted in dita, docbook, eclipse, xml | Leave a comment

>Standards, Documentation, Single Sourcing, and Continuous Integration

Posted on September 15, 2009 by kingargyle

>Over the last several years I’ve had the pleasure of working with many standard organizations. Many are trying to improve their development processes to meet the membership and the communities needs sooner. However, almost all have one area that still … Continue reading →

Posted in agile, docbook, documentation, standards | Leave a comment

>WikiText and DocBook almost valid/well-formed

Posted on August 15, 2009 by kingargyle

>If most of your information is going to be output into HTML and you like the default format that the Mylyn WikiText produces, then you do not need to read any further. However if you are a big fan of … Continue reading →

Posted in docbook, documentation, eclipse | 3 Comments

>Single Sourcing from a Wiki

Posted on August 11, 2009 by kingargyle

>There is a movement on in eclipse land to migrate to the Wiki for some of the end user documentation. I’ve been slowly moving the PsychoPath XPath 2.0 processor documentation over to the wiki as well. What I’ve found is … Continue reading →

Posted in docbook, documentation, eclipse | Leave a comment

>PsychoPath 1.1 User Manual

Posted on August 9, 2009 by kingargyle

>I’ve put the first cut at taking the old PsychoPath user manual that was written in TeX and put it on the Eclipse Wikipedia. The idea is to take advantage of the Crowd Sourcing abilities, and eventually use something like … Continue reading →

Posted in docbook, eclipse, mylyn, xml, xpath | Leave a comment

>Highlighting Changes when Single Sourcing

Posted on July 29, 2009 by kingargyle

>I’m a big proponent that documentation should be singled sourced. The same information should be generated into multiple formats from one common source. I personally don’t think ODT, Word, or some of the more traditional tools used for writing documentation … Continue reading →

Posted in docbook, eclipse, xml | 2 Comments

>WYSIWYG XML Editting

Posted on July 15, 2009 by kingargyle

>Chris has started discussion on ways to make it easier for eclipse documentation to be updated. He has rightly stated that the state of eclipse documentation leads a lot to be desired. The docs are stored in a variety of … Continue reading →

Posted in dita, docbook, eclipse, xml | 10 Comments

>Agile Documentation Revisited

Posted on May 20, 2009 by kingargyle

>A while ago, I wrote an entry called Agile Documentation, in which the development of documentation or any particular writing and publishing process can be made agile. This was driven home recently with some changes at work. We publish a … Continue reading →

Posted in agile, docbook, documentation, eclipse, xml | 1 Comment

>Inconceivable!

Posted on May 14, 2009 by kingargyle

>Updated 2009-05-15: Correction on some WikiText conversion. I’ve spent most of the day the last two days taking some legacy Word documents and converting them into nicely formatted, semantically marked up DocBook files. I hear some kringing already. The WikiText … Continue reading →

Posted in docbook, documentation, eclipse, xml | 9 Comments