Foul Writer’s World

So I have been busy lately. Hence the lack of posts.

But I thought I would write a short post on a project I am currently working on. It is the deployment of an online multi-lingual help system. The company I work for, Questionmark, are moving towards a Software As A Service methodology. We have several applications out, or in the pipeline, that are designed to be multi-lingual. Questionmark Live, is a perfect example. It allows Subject Matter Experts to easily create questions using a web based interface that can then be uploaded to Questionmark Perception for delivery to students in an exam or assessment.

The current help system employed by Questionmark Live is basic, so I have been looking at ways we could improve this. Essentially I needed a system that could be:

• Used to create help pages
• Able to display images
• Translatable
• Language aware
• Able to provide direct links to pages in an easily identifiable manner

I checked all our existing systems and tools (Madcap Flare, RoboHelp, WikiSpaces, Contribute) but none really did what I needed them to do. I then started checking out other specific Help and Knowledge Base system and I came to the conclusion that they were either really good at organising and displaying information or being multi-lingual aware, but finding a system that could do both really well was impossible.

I decided to start looking outside the box and came across Joomla!. Joomla! is an open source Content Management System, in the same vain as Drupal. However, Joomla on its own isn’t language aware but there a are a multitude of add-ons and extensions that make pretty much anything possible.

My current line of thought for the new help system includes a deployment of Joomla!, with an extension called Joom!Fish. Joom!Fish provides Joomla with a whole translation workflow and makes the software language aware. Also the way that Joomla indexes pages makes it easy for our developers to call specific pages stored on the Joomla system in the language needed quickly and easily.

Each piece of content stored in Joomla is tagged with an ID. Any translations of the content is stored with the same ID so translations are actually part of the same piece of content rather than a seperate piece of content written in a different language. Perfect!

For example to call the help I would need to pass something similar to the following URL (simplified for the sake of this blog post):

index.php?contentid=38Lang=en

If I wanted to call a different page the URL would simply change to:

index.php?contentid=41Lang=en

If I then wanted to present a translated version of the above page I would just need to change the identified Lang parameter, like so:

index.php?contentid=41Lang=es <- To display a Spanish translation of the page

Now this is all pretty easy for our developers to arrange. Each Help button would be associated with a contentid and depending on the language version of the software the user was using the Lang parameter would also be passed to open the appropriate page in the required language. The Joomla and Joom!Fish combination is also clever enough to understand that if a translation of the selected page isn’t available it will show the predetermined base (original) language, which in most cases will actually be English. It can also be configured to work with language cultures like en-US and en-UK.

Another really cool thing that I like about the Joomla system is that I can change the look and feel of the page being called by simply modifying the URL slightly. For example calling the following URL would open the page with the full template and menu system:

index.php?contentid=38Lang=en

But calling the following URL would open the content without any distractions, no template, headers or menu, and display just the article:

index2.php?contentid=38Lang=en

This makes it perfect to open help pages directly from the application, while still giving me the control to allow users to open the help as a help centre with full navigation and searching capabilities. I’m hoping to finish off my proposal for the system in the next few days and get buy-in from various stake holders. So far all the developers I have shown it to love the solution. It makes life easier for them and everyone has agreed that it will make the content more meaningful, relevant and easier to maintain.

I’ll keep you all posted as the project progresses. If anyone else has any thoughts or comments feel free to let me know in the comments section.

Update

I thought I’d include some links to a demo system I have setup.

Here is a link to a sample help page:

www.foulwritersworld.net/joomla/index.php?option=com_content&view=article&id=46&&lang=en

The same page in Spanish:

www.foulwritersworld.net/joomla/index.php?option=com_content&view=article&id=46&&lang=es

With the menu and navigation turned off:

www.foulwritersworld.net/joomla/index2.php?option=com_content&view=article&id=46&&lang=en

This is a test post from my Android phone. As you can probably guess I’ve finally managed to get rid of my iPhone 3GS and get a propper geek phone in the HTC Desire.

So far I am loving it. It’s fast, efficient and oh so cool. Shame the battery life isn’t great, but the iPhone wasn’t much better.

So Microsoft have finally released Windows 7. First counts have shown that the demand for Windows 7 is high. Many have put of upgrading to Vista and skipped straight to WIndows 7 from XP. While others have been deperate to get rid of VIsta and move on to something that works.

So far it looks like WIndows 7 is a big hit. I haven’t seen any over negative blogs about. Howver, the proof of the pudding will come from how quickly corporate users upgrade.

The truth is I have been using Windows 7 (64-bit) ever since its MSDN release and I have been pleasantly surprised. I like:

The snap to screen (however, annoyingly it doesn’t support multi-monitor displays properly)

The battery management options

The improved load times and system messaging

After some getting used to, the new task bar is intuitive and easy to use

Overall look and feel

UAC improvements

What do others think/like about Windows 7?

I am not looking forward to having to update all my installer docs with the new OS. But, I suppose it needs to be done.

Ever wondered why Web Analytics was important. Or hand a hard time understanding they work. Take a look at:

Analytics According to Captain Kirk by Matt Bailey

He makes it sound so simple yet fun. Well, maybe only if you are a Star Trek fan.

My favorite browser has been upgraded. If you want to see what other browsers should be doing you can go a download a copy of Opera 10 from:

www.opera.com

The new “Turbo” feature really does seem to speed things up. It looks like Google Gears finally has some competition.