Reviews Archive

July 2, 2007

ReadSpeaker - speech enabling Revish

@ 7:18 PM

Disclosure: This is a sponsored review, I got a free licence for ReadSpeaker SayIt for Revish in return for writing this review. ReadSpeaker have had no influence on the tone or content of this review.

Early on in the development of Revish (external link) I had the idea that offering the option to listen to a review would be a nice feature to have. Even better if you could download an mp3 of reviews and listen to them at your leisure, maybe on the move. At some point in the future there will be a Revish podcast, hopefully with reviews read by the users who wrote them, but what I needed in the short term was a text to speech technical solution.

There are basically two camps in the speech-enablement business: server-side and client-side, and within those camps (in the UK at least) two market leaders, ReadSpeaker (external link) and Browsealoud (external link) respectively. The fundamental difference between them is the requirement to install a plug-in for client-side processing. My preference is for as few barriers to access as possible: asking a user to download and install a specific plug-in for speech enablement just doesn't fit with my attitude to the web.

As an aside, out of curiousity I did download and install Browsealoud, but couldn't get it to work, even on the Browsealoud site. The software replaces your mouse pointer with a branded pointer, but it just displayed a red cross for me, and I couldn't get speech out of it whatever I did. This merely confirmed my decision to go with ReadSpeaker.

I contacted ReadSpeaker, explained my needs and they recommended ReadSpeaker SayIt, and even better for me offered a free licence in exchange for this review. How could I refuse?


I duly received a welcome email, with my account details and comprehensive implementation instructions. Being a hosted solution the installation is all about determining the best approach for your site, then familiarising yourself with the many configuration options the service offers.

For Revish I opted for the ReadSpeaker Flash player, with a fallback of a straightforward text link to listen to a review should javascript not be available. This is one of the great things about the product - there are options to suit almost every technical situation, and you can use standard web development techniques to provide graded access to its functions based on the user's platform. So visitors to Revish with javascript and Flash (~85%) will get the full-fat Flash player, while the rest will get a text link which will be functional on just about any platform with a media player.

I'll also add an account option to allow registered users to choose the text link over the Flash player - on initial testing it isn't keyboard friendly.

There are some problems with the ReadSpeaker documentation - it presents a lot of configuration options, but doesn't make it clear how or where to implement them all. For example some can be set in your HTML to be processed by ReadSpeaker at runtime (for example elements to be ignored) while others require to be set by ReadSpeaker themselves at their servers (for example in my case I didn't want speech to start automatically when the page loaded, and with the Flash player I was unable to do this myself). While this is a little frustrating, the response from ReadSpeaker support was extremely quick, and consistently helpful and accurate.

Some of the technical examples have critical typos - for example a misplaced single quote resulted in me spending too much time working out why the vanilla Flash player example from the documentation wasn't working.

On a positive note ReadSpeaker have committed to improving the documentation, and correcting the errors I found. Another example of a great support ethos that seems to pervade the company.

Voice quality and features

Ultimately the most important factor in speech-enabling a website is the quality of the voice - if the service fails to produce clear, understandable output it's a complete loss.

I chose the female Scottish ReadSpeaker voice, not just because I live in Scotland and my company is based here, but because I find it easier on the ear than the standard female voice. This is a personal preference, and I'm not sufficiently familiar with the product yet to know if I will be able to offer visitors to Revish a choice of voices - it would be a nice touch. So I'm keen to hear what others think of the voice on Revish - understandable, or a bit Rab C (external link)?

Given the immense complexity of the english language it's inevitable that there will be some words, phrases and constructs that any text to speech service will struggle with, and some misuses of punctuation that a reader will understand, but that cannot be interpreted by software. In ReadSpeaker's case I am extremely impressed with the way it copes with most things thrown at it on Revish - the issues I've seen so far are limited to the use by reviewers of characters like asterisks to indicate emphasis, and ReadSpeaker reading them literally as "asterisk", and some mis-pronunciation of words, for example "thyme" being spoken with a soft "th". Once again though the company are very happy to receive feedback on these sorts of issues, and commit to make adjustments to the software to correct them.

On the whole I'm very pleased with the all-round performance - speech starts within no more than a few seconds of clicking the "play" button, and the option to download the spoken review as an mp3 file is a nice feature.

Coming soon

At the moment I haven't implemented ReadSpeaker fully into Revish - it will be later this week, but in the meantime you can see and hear how it works by appending ?rs=1 to any review, for example: (external link)


A speech enabled website can help many people - those with low literacy skills, those with dyslexia, those with some visual impairments - and ReadSpeaker makes it incredibly easy for site owners like myself to offer that help. As with any emerging technology it's not perfect, and there is plenty of room for improvement. But 'm still blown away by the way it works: people from all over the world write book reviews at Revish, and this incredibly clever software translates the diverse writing styles and vocabularies used by them into speech, over the internet.

The highest recommendation I can give is to say that ReadSpeaker will be a permanent part of Revish. As I refine the Revish implementation and learn more about the possibilities I'll post information here.

If you're interested in learning more about ReadSpeaker or buying a licence please visit their website at (external link) (and no, I'm not on commission).

May 20, 2007

Review: RiverDocs Converter

@ 1:14 PM

Disclosure: This is a paid review. RiverDocs Limited have had no influence on the tone or content of this review.


An essential tool for any organisation which publishes Microsoft Word or PDF files online, RiverDocs Converter is vastly superior to any other conversion software currently available. There's now no reason for publishers not to offer accessible, high quality HTML versions of documents previously published only in proprietary formats. The parser even compensates for poorly authored source documents, previously a significant barrier to producing accessible, semantic HTML versions of Word and PDF documents.

It's not a magic bullet though - every conversion requires human-checking, and documents with any degree of complexity require a degree of input from an experienced web editor - but despite a slightly weak editor it's still well worth the price and will only get better in future versions given the publisher's focus on research and development.


RiverDocs Converter is a software package for the Microsoft Windows operating system which claims to convert documents designed for print into structured, accessible HTML documents for online delivery. In short this means it'll take PDFs and Microsoft Word files and attempt to convert them into a format more suitable for delivery and consumption over the web.

PDF and MS Word are beloved of government and corporations who often need to publish large documents quickly, but these formats are primarily designed for printing, not for delivery online, and have serious accessibility issues associated with them. So the potential benefits from effective conversion software are enormous - being able to offer HTML versions of these documents cost effectively is something that hasn't been possible before.


Installation was straightforward, taking a couple of minutes on my workhorse desktop PC.

RiverDocs Installation

The software does require the latest version of the Microsoft .NET 2.0 Framework, if this isn't already installed and available you will be prompted to download and install it.

Getting started

Starting the software for the first time you are presented with a quick guide to converting your first document, and the clean, functional RiverDocs interface.

RiverDocs interface

Test 1 - my first conversion

To test the software for the first time I used a PDF document regarding chimney stack removal I found on Cambridge City Council's website at:

It's a 4 page document containing a cover sheet, and a mix of different levels of heading, bullets and images. The PDF document was not tagged.

Opening the file displays it in the main RiverDocs window:

RiverDocs showing PDF file

Clicking the Convert button started the conversion, which took less than a second using the default settings. The interface changes to a split-screen affair, with the original document in the left pane, and the converted document in the right pane:

RiverDocs PDF / HTML conversion split panes

To give an idea of the quality of conversion and mark-up the software can produce automatically I wanted to save the document immediately. Admittedly this is not intended real-world usage of the product, but does provide an idea of quality of the baseline conversion prior to manual editing.

Big River had provided me with a one page crib-sheet covering the major interface elements, so I knew that the Save function was for saving a RiverDocs project, and the Publish function was for saving the converted document as HTML, CSS and images.

Clicking the Publish button presents the Publish dialogue box:

RiverDocs publish dialogue box

In addition to publishing as HTML, the software also supports output in CHM (Microsoft Compiled HTML Help) format.

To keep things tidy I wanted to publish this version into a new folder, but this is not a standard Windows file dialogue box, and doesn't provide the facility to create a new folder, so I had to switch out to Windows Explorer to do this before publishing the document in RiverDocs.

But, it turns out the file name entered into this dialogue box is actually used as a folder name, which will be created for you and into which the document is published. These sorts of interface issues are symptomatic of the software's relative youth, and will no doubt be ironed out as the product matures.

The publishing of this document took less than a second, here are the results:

The default settings produce HTML documents with an XHTML 1.0 Transitional doctype, generating a separate HTML file for each page of the source PDF, an index HTML document containing a generated table of contents, a single CSS file and an images folder containing converted images. The CSS is valid, and attempts to mimic the style of the original document as closely as possible.

As a comparison I ran the same file through Abbyy's PDF Transformer, another PDF to HTML conversion tool. The results were much vastly less impressive:

The Abbyy software makes no attempt to produce structured HTML, instead presenting every single line in the document as a paragraph and styling them to appear as closely as possible to the original PDF.

In general the quality of the default output from RiverDocs is extremely impressive. In this case there were just two validation problems: an unclosed list item in the generated table of contents, and missing alt attributes for the images on the final page. Since the default output is "section based" the parser moved the words "GUIDANCE NOTES" onto a page by itself despite displaying it as part of the title page in the preview pane, which was the only deviation from the page layout of the original.

But this isn't a fair test of the software which wasn't designed to be operated in this manner. While the results are good, they aren't good enough to publish without manual editing, so let's try again, only this time using some good old human judgement.

Test 2 - getting serious

For the second test I wanted to take the same document but publish it to a single HTML document of the highest quality as close to the original format as possible. The process is the same - open the file to be converted, and click Convert.


Before getting stuck into the document itself I wanted to specify some metadata for it. Fortunately RiverDocs make this very easy to do (just click the Metadata button), and provides a default set of Dublin Core elements for completion:

Metadata editor

It appears that additional user-defined elements can be created, so publishers in UK government for example can easily add eGMS metadata to converted documents:

eGMS metatdata entry

Unfortunately these additional elements didn't make it to my published document, a bug I've reported to Big River.


RiverDocs optionsRiverDocs offers a number of options to customise the output of the converted document. The most important are:

The editor

For many users the area of the application where most time will be spent is the HTML editor, where the converted output can be modified and fine-tuned. In most cases this will be to either match the original document or to conform to a house web publishing style.

The editor always presents the output document in a page-by-page format, regardless of the publish mode that's currently set. It would be nice to be able to preview the single page and section-based options.

The editor can be used visually in preview mode, or in source mode which provides a simple text editor view of the document page you're working on. As I wanted a single file output and had set the options accordingly there was something of a disconnection between working on a separate HTML file for each page, and the intended output. As far as I can see there is no way to preview the single file output prior to publishing.

RiverDocs toolbar

The toolbar provides standard editing tools you'd expect to find available on a simple HTML editor. These generally work as expected, although there are some quirks - for example undo will only remember changes you've made until you switch to source mode: so if you make change, switch to source mode and back to visual mode you'll need to correct any errors manually in source mode.

Once you've got used to the way the editor functions it's a reasonably comfortable working environment, but don't expect it have the functionality of DreamWeaver. I can foresee many users doing the initial conversion in RiverDocs and taking the published output into the editor of their choice to complete the process: indeed if I was using RiverDocs on a daily basis to convert a large number of files this is the way I'd work - the software's value lies in its conversion capabilities, not its editing capabilities.

One of the most common problems that will arise from automatic conversion is that of images and appropriate alt attributes. Editing images is easy - select the image in the editor, and click the image icon:

Editing image properties

The id is a temporary value used by the software during conversion and editing, and is removed on publishing.

Screen capture

One very nice feature of RiverDocs is the screen capture tool. On the final page of the original PDF is a diagram showing a cross-section of a wall, with some labels indicating particular features of the diagram. Since the PDF was generated from Adobe Pagemaker, the diagram consists of an image object and a series of text objects for the labels. In the automatic conversion RiverDocs quite rightly converted these separately, which can be seen on the last page of the output of test 1.

In my final version I want the image and labels as a single image, and this is where the screen capture tool comes in:

Screen capture tool in action

It operates like any screen capture tool you've used before - highlight the area to be captured and click an icon. In RiverDocs the highlighted area will be inserted into your HTML document as an image.

You've got issues

Issues icon The software provides assistance to help you identify and correct potential issues with the converted document. The Issues icon gives a quick idea of the number of issues identified by the software at any stage after automatic conversion. Clicking the icon opens a third pane with details of the issues:

Three pane view - original version, conversion and issues

The potential issues highlighted include missing alt attributes on images. I was disappointed to note that alt text from objects in tagged PDFs wasn't carried across to the converted HTML document. Otherwise the guidance provided by the issues is sound, based as it is on HTML Tidy - those of you familiar with the Tidy extension for Firefox will know what to expect.

For non-expert users this provides an extremely useful indication of where there are potential problems in the converted document, and the separation of current page issues and whole document issues guides such users through the document with ease. Personally I was more comfortable editing the document first before using the issues tool - picking up the issues I could see, modifying structure, adding or correcting alt attributes, generally tidying the document up - but that's probably no more than a reflection of my workflow habits.

Test 2 results

Here's the output:

It took 10 minutes from opening the original PDF to publishing this version - very impressive results in such a short space of time.

Test 3 - getting more complex

To really test the software we need something a little more complex than a single-column, text and images document. On the Clackmannanshire Council website I found a 24 page consultation document laid out in 2 columns, which included multiple levels of headings and a data table:

The untouched output from RiverDocs shows its limitations, but is still an impressive result:

It took me about 30 minutes to tidy the document up in RiverDocs, but I was still left with a lot of redundant classes with names like "font19" and all those named anchors generated for the table of contents. Cleaning up the mark-up in RiverDocs proved to be a bit of a chore, so I tried again, this time dumping the output immediately into DreamWeaver.

15 minutes later I had this clean, structured version of the PDF:

My conclusion - if your document is anything more complex than single-column text then forego the RiverDocs editor for your favourite HTML editor.

Test 5 - Microsoft Word

So what about Microsoft Word conversion? Well, this review was produced in a simple Word document, so I ran it through the RiverDocs Converter for publishing online. Here is the untouched conversion:

This was a 12 page Word document, and conversion took noticeably longer than PDF conversion, at about 20 seconds. The only real issues with the conversion were the failure to convert Word bullets to HTML lists and the failure to pick up alternative text on images. Other than this the structure was accurately represented and the images correctly positioned.

The converter doesn't appear to parse the styles used in Word documents - I converted a test document which was styled throughout as paragraphs, but with headings made bold with larger font sizes. RiverDocs therefore accommodates poorly authored, unstructured source documents, by analysing the font size and weight and assigning heading levels accordingly. This is a great feature given the preponderance of incorrectly produced Word documents in many organisations.


Given the immaturity of the package there are some inevitable annoyances with the interface and output:

possible in source mode. In a long document this can quickly become tedious. It would also be an improvement if the TOC used ids rather than named anchors.

<p class="font9"><span class="font9"><strong>NOTE: Some chimneys act as a buttress and provide support to long walls.</strong></span> <strong>Please check with Building Control or a structural engineer</strong><span class="font9"><strong>, before</strong></span> <span class="font9"><strong>proceeding, to determine if this is the case.</strong></span></p>

None of these are major problems though, and I would expect the interface to improve as the software is developed further. The key feature of the product is the conversion algorithm, which is extremely impressive.


RiverDocs is an impressive product and an essential tool for any organisation which has a need to publish more than a small number of PDF and Word documents online. Simple documents take no time at all to convert and tidy using the RiverDocs editor, while I found more complex documents are best converted in RiverDocs and then edited in a more powerful and functional dedicated HTML editor such as DreamWeaver.

The true value of RiverDocs lies in its ability to turn unstructured, multi-column PDF documents into structured HTML documents, whilst maintaining the correct reading order. Critically, the intelligent parsing engine compensates for low-quality source documents, previously a real barrier to producing HTML versions of PDF and Word documents.

Future versions of RiverDocs are very likely to offer significant improvements, both in terms of quality of conversion and the application interface. Apart from being a single-product company, concentrating solely on the development of the RiverDocs Converter, they also fund applied research at Queens University Belfast as well as other universities engaged in the fields of accessibility, artificial intelligence and character recognition.

About the reviewer

Dan Champion has worked in the web industry since 1995 through his company Champion Internet Solutions Limited, with clients in the private and public sectors. Between 1999 and 2007 he was responsible for Clackmannanshire Council's multi-award winning websites.

He is a regular speaker on the subjects of web accessibility, web standards and web strategy at conferences and workshops throughout the UK, has written on the subjects of e-government and web accessibility for the Guardian, and featured on national BBC Radio in various guises.