Typepad to WordPress

December 26th, 2008

My subscription on typepad was coming due and with the small amount of blogging I do, I could not justfied the cost.   Decided to move to wordpress 2.6 and the process was faily painless.  After installing WordPress 2.6, I exported my posts from Typepad using their standard features and then uploaded to WordPress.  As images were not transfered, I had to upload them into WordPress.  Since I had all the originals on my computer I did not bother with exporting the images from Typepad.  Next I did some minor corrections on some internal links that still referenced the old site.   Once done and validated, I switched the DNS and my new WordPress site appeared.    While WordPress has many plugs-in and themes, I tried to keep the two sites the same for now, including adding my Recommended Reading list using the Amazon Showcase plugin.  Also matched the Google Adsense and Analytics.  If I begin to blog more again, then I may update the theme and look for additional plug-ins!

Oh – as soon as I was done, WordPress 2.7 was released and I went ahead and upgraded.  No problems there either!

Happy  New Year!

Obama, Clinton and me

January 15th, 2008
Obama, Clinton and Me

Obama, Clinton and Me

While at the American Library Association Midwinter Conference in Philadelphia, AP photographer Mike Rourke captured me with cardboard cutouts of Hilary Clinton and Barack Obama. Google and Yahoo searches this morning – provide some great search results.

Google Results Obama and Klemow

Google Results Obama and Klemow

Intalio|BPMS 5.0,

September 25th, 2007

A big congratulation is due to Ismael Ghalimi and the Intalio team on the delivery of BPMS 5.0. Ismael recounted a portion of the 8 year (and $6 million plus) road to delivery an open source BPM platform in From Vision to Execution. I am not sure where Ismael is finding the time just finishing up the Office 2.0 conference and designing the Redux Model 1.0 an open source version of the Apple iPhone.

Return of the Blog

September 25th, 2007

I have been extremely busy the last few months and my blog was placed on the very back burner. I hope to post more regular in the future on BPM, our open source Robohelp2Wiki software, some recent projects, and new ventures.

BPM + SaaS

February 12th, 2007

I am very excited to see the SaaS based BPM offerings from Appian and Lombardi as reported by Sandy Kemsley today in her Column 2 blog.  Her postings can be found here Appian also offering on-demand BPM and here Naked Process Modelling with Lombardi

The Lombardi screenshots look very close to my “process wiki” which uses more standard tools (Visio, DreamWeaver, and RoboHelp) then converted to MediaWiki.  Maybe with these new services, I will be able to automate the work required to produce my Product Design documents.  This would be a tremendous time saver.

MediaWiki 2 for Printing and Documentation

February 2nd, 2007

When we create Product Design documents we include descriptions, requirements, test scripts, GUI mockups, and help text for each process step. We use RoboHelp conditional tags for each section, so the right information is outputted at the right time for the right audience. When we converted the RoboHelp files to MediaWiki with our RoboHelp2Wiki extension these sections become sub-headings on each article page. While we gained many benefits moving to a Wiki one important item was lost, the ability to output documentation. Printed documentation is still important for manuals, training materials, and sign-offs. Additionally, it would be very helpful to generate a hard-copy of the updated Product Design Document.

To solve these issues, I would need to convert over hundreds of Wiki articles into another format. Unfortunately, I have not found any good solutions for these conversions or the printing of Wikis in general. I have looked at the wiki2PDF scripts where user enters a list of articles and the script makes a single PDF file. However, it is based on the assumption I want to directly output the list of articles for final printing, which is not the case.

The ideal solution would be a new type of Wiki where the stored format can be used for multiple sources. A DITA based Wiki idea was floated and attributed to Paul Prescod, Group Program Manager, XMetaL in Crystal Ball: A DITA Wiki by The Content Wrangler and elaborated on by Anne Gentle in Document Actions Darwin Information Typing Architecture, meet Wiki. However, no such product yet exists.

Therefore, we are looking at reversing our RoboHelp2Wiki conversion tool to roundtrip the data back to RoboHelp. An advantage of this method is the ability to leverage the independent table of contents capability found in RoboHelp and other help authoring tools (HATs). Wikis and HATs have a natural connection between the HATs topics and Wiki articles. The power of HATs is the ability to organize the topics to best present the data. Organization is through table of contents hierarchies.

As part of the RoboHelp2Wiki conversion process the RoboHelp table of content hierarchy creates a MediaWiki conversion article. To roundtrip the information from MediaWiki back to RoboHelp, we simple need to create a MediaWiki article with the desired table of contents listing all the article pages and the order to present the information. On conversion, the tool would read this Table of Contents article and create the matching Table of Contents in RoboHelp and convert each article page listed.

In truth, we have been thinking about the above since before we created RoboHelp2Wiki, however, we did not want to commit resources until RoboHelp Version 6 was released. We were hoping that version 6 would be XML based without RoboHelp’s priority tags (‘kadov’ tags). This is not the case.

So, before committing to a Wiki2RoboHelp strategy, we decided to look into creating the conversion tool to another HAT or editing tool. We plan to review Flare from MadCapSoftware and some of the DITA tools. We will also review the OpenDocument and Office Open XML. The minimum requirements would be ability to support an independent table of contents and the ability to round trip basic formatting, including tables. A nice to have would be the ability to round trip conditional tags.

RoboHelp2Wiki Version 0.9 working with Robohelp Version 6

January 29th, 2007

Adobe has released Robohelp Version 6.  Not too many changes in the product which has caused a lot of debate (con) rebutal (pro).

The GUI is the same, only a few new features and most important to us (at this time) is the XML Output files are the same. As far as we can tell there were no changes to the XML tags or the directory structures. The project meta data in the project files are also practically the same. I did test the new user defined global variables feature worked and they worked and converted correctly to MediaWiki.  See the diff file after conversion below.

Mediawiki Diff Example

Mediawiki Diff Example

Batch Upload Images to MediaWiki

January 14th, 2007

I learned last week on the MediaWiki message board that several people have requested help with uploading images to MediaWiki. 

When Ted designed our RoboHelp2Wiki extension he used a separate option to upload images primarily to save testing time and possible some bandwidth.  I validated the separate option and was able to upload 500 test images (various sizes) in a few minutes. Your speed will vary!

To duplicate:   

1. Download the RoboHelp2Wiki MediaWiki extension
2. Make sure all images have unique names.
3. Place all image files in a single sub-directory under the working directory named images
4. At the command line type:   java -jar RoboHelp2Wiki.jar <workingDirectory> image

RoboHelp2Wiki History

December 24th, 2006

On Friday, we released our RoboHelp to MediaWiki conversion tool. I thought I would provide some history on why we created it and some possible next steps.

In my RoboHelp and MediaWiki post, I explained why we use RoboHelp for Business Process Management design documents and the reason we are moving to MediaWiki once the documents were completed or at least signed-off. As I did not want to have to copy and paste the 400 topics from RoboHelp to MediaWiki, I began researching existing conversions tools. It seem there are only two primary conversions tools available: HTML2Wiki and Word2MediaWiki.  However, both of these tools are targeted for single uploads, not batch uploads.  Nor did they handle images. To me, using these tools would almost be the same as copy and paste. Matt Hart also started a RoboHelp to MediaWiki converter; however, it did not meet all of our needs. He did kindly let us review the code as our starting point. (Thanks Matt!)

So in the end, we built the RoboHelp2Wiki tool ( Thanks Ted!). I believe there is a small market for this tool, so we published the tool and the source code, under a GNU license. Our primary requirements included: (1) Create a new page if one did not exist, (2) Overwrite an existing page if a page already existed, (3) upload all images linked on any RoboHelp topic page, (4) Convert most common mark-up from RoboHelp/HTML markup to MediaWiki, (5) Covert the RoboHelp Topic Name to the MediaWiki topic Name, and (6) Create a upload history file within MediaWiki. With respect to #2 overwriting of existing pages, this was a special case for our needs. Our Requirements document already had four reviews completed and I wanted to capture these changes in MediaWiki. So, during the conversion process I generated 4 RoboHelp output files and upload each one in order using a different MediaWiki user name corresponding to the published Version. (Blueprint Version 1, Blueprint Version 2, etc.) Now we can see the full history of the drafts from pre-MediaWiki usage to post-conversion within The MediaWiki history files.

Next steps, if there is interest we would like to provide a GUI interface that is more configurable and provide some more precision on the markup handling. Also, some Version control in case the Wiki is changed between RoboHelp uploads.

RoboHelp 2 MediaWiki Conversion Tool

December 22nd, 2006

We have published our RoboHelp 2 Media Wiki conversion tool (RoboHelp2Wiki) as a MediaWiki extension.

Click Here to request a copy of the tool and source code.

RoboHelp2Wiki V 0.9 converts Macromedia RoboHelp Topics to MediaWiki pages. For this release, most of the structural and object elements are converted to proper wiki counterparts. Stylesheets and javascripts are mostly discarded. Display related markups, such as font size, colors, appearances, are not retained in most cases.

RoboHelp2Wiki is a product of The JK Group, Inc. released under GNU General Public License 2.0.
Requires Java Runtime Environment (JRE) 5.0 or later, RoboHelp HTML X5.0.2 Build 801, and MediaWiki Version 1.7 or 1.8.

RoboHelp is a product of Adobe Systems Incorporated.,
Mediawiki
is a wiki engine released by Mediawiki.org,
Java Runtime Environment
(JRE) 5.0 is a product of Sun Microsystems