At the ripe old age of 24, Robohelp is the granddaddy of online help and looks it. The familiar layout of folders on the left and topic pages on the right hasn’t changed much over time and appears particularly dated in an era of touchscreens, responsive web pages, and mobile apps.
However, you might be in a situation where Robohelp is the only tool available. It’s possible to tweak Robohelp layouts so that topic pages look clean and professional. For this article, I’ll assume you are familiar with using Robohelp, including the Header Template file that controls the look and feel of all topic pages.
Here’s a topic page layout I did recently for a client using Robohelp 11, with the output to be viewed by staff on desktop monitors:
Note this layout is not designed for tablet or smartphone viewing. Topic pages are set up as a three-column grid, with procedures running over two columns on the left side, and business rules running in a shaded column on the right.
A graphic banner anchors the top of the page, and a Robohelp-supplied “redheader.jpg” graphic defines the bottom of the procedure section, after the “Related Topics” section.
This layout requires tables, which give you control over the line length in the procedure section. Unfortunately online help is often laid out so that text lines can run the full width of the browser window, making the page virtually unreadable on the typical desktop monitor.
I usually set a paragraph left and right indent as well, to create white space around the text blocks. I set 0 pt above, and 6 pt below to set spacing between paragraphs. I set leading as 12/14 or 12/16 to open up the text lines a bit.
Here are the key steps to set up the master page for this layout in Robohelp 11. Make any appropriate adjustments for the version you’re using.
Step one: open the Robohelp Header Template
The Header Template displays on the right.
Step two: set up the tables in the header and footer
Step three: apply formatting to the body of the Header Template
Stephen is a senior technical writer with more than 20 years experience writing for corporate and hi-tech clients in Vancouver and Toronto. He is the past president of the STC Canada West Coast chapter.