Useful Tools and Links

What's covered?

Links that I have found particularly useful.

 

Site / Tool

Content

AbleStable An interesting site from Mike de Sousa, one of the guys behind SyncBack referred to below. Includes links to a range of useful freeware including ColorCop, great for getting the colour values of anything you see on screen.
BK ReplaceEm A multi-file find and replace tool. I prefer FAR (see below) but this one has the advantage that it is free! FAR has, in my opinion, better functionality and a better interface to justify the low cost.
Copperfield Publishing

A great source of help for technical authors. Lots of examples, tips and a guide to useful software.

You can also see how users can add their own annotations to webhelp. Click on the C-note link.

Cerebral Synergy

The downloads include Batch File Renamer. This is the best utility I have found with options to:

  • Add prefixes and suffixes
  • Change the case
  • Fill blanks with underscores
  • etc.

You can also get it from Freeware Files, see below.

Downloads Good source of freeware and shareware files including many useful utilities.
Edit Pad Pro An excellent text editor. There's also a free version but the Pro version is worth the price.
FAR

An excellent find and replace tool with many other useful authoring tools built in.

It's also an excellent launch pad to a whole host of useful stuff.

Folder Content Compare

The free version of Vice Versa's excellent tool to compare the contents of a folder and report the differences. Can be set to compare just the file size and date for speed. The CRC method also checks content. Use the "both" for a complete check.

If you have two copies of a project and are not sure what the differences are, or even if there are any differences, this will resolve the problem.

Frank Palinkas A Microsoft MVP guy with some useful stuff.
Freeware Files Good source of freeware files including many useful utilities.
Help-Info Useful site including some clear information on the future of WinHelp plus other topics.

HTML Entity Lookup

Firefox Addin

 

Two links here.

The first takes you to a webpage where you can enter something like "arrow" in a field and the page will show you all the arrow symbols that can be created using entities, there are more than shown here. You can click the clipboard symbol to add the html code to your clipboard. Great for finding the more obscure entities without scrolling through a list of all of them.

 

The second link takes you to a Firefox add in that is based on the same code.

Click the install icon and download the XPI file to your PC. Go to the XPI file in Windows Explorer and drag it to a Firefox window and release it to install.

Ignore the Dashboard Widget you see unless you are running an Apple Mac.

HTML Kit A free HTML editor with a great tool for cleaning the extra lines of code that Word puts into the html version of a document.
HyperSnap

RoboScreenCapture is my favourite tool for capturing windows, regions, buttons and so on. It was produced under licence from Hyperionics but it was discontinued in December 2004.

Hyperionics own tool has some extra features so you might want to try it as an alternative.

Hypertexas John Daigle is a certified RoboHelp and Captivate trainer. His site covers various areas and has some very useful links including to his topics on context sensitive help and source control.
Macro Express

Write macros that work with any application.

  • Link it to RoboHelp so that you can have shortcuts to change styles in the same way as in Word.
  • Hold text that you repeat throughout your help so that you always get it word perfect.
  • Insert tables with all the formatting you like.

It's low cost and you will wonder how you survived without it.

Notepad ++ This is a free text editor with excellent colour schemes for HTML and JS files. It really is very good and it integrates with the context menu in Windows Explorer so that you can open any file using this tool. Many RoboHelp files can be edited in this way.
OverLIB For those of you up to speed with javascript, this site has scripts that enable you to provide bubble text information while hovering over text.
PowerGrep If you need to search and replace across large numbers of text or html files without opening them, this is the tool. The search can be text based or a regular expression.
Regular Expressions Info A site devoted to writing regular expressions. Includes a tutorial.
Regular Expressions by Rob Christenson Written for Dreamweaver MX2004 but still good. Explains the concept well.
Rick Stone's Site A major source of help for technical authors. Lots of "how to" stuff and workarounds.
RoboHelp Links

Feature request / Bug report

RoboHelp Training

If you are looking for online training, Rick Stone (RoboWizard) is one of the world's most experienced RoboHelp users and he provides training through one of his sites.

www.showmesolutions.com

SyncBack A great program that automatically backs up files for you or synchronises folders. You can use it to upload your webhelp to the server and keep the server free of files that are no longer used. See Publishing WebHelp
Techwrite Tips A growing list of tips on various aspects of technical writing.
Visual Web Developer - Free HTML editor

Try Microsoft's Visual Web Developer if you need a free HTML editor. Naturally there are some Microsoft centric features but it is a good editor and, like I said, it's free.

w3schools.com An excellent source of "how to" for html, css and so on. As well as the tutorials for newbies, it has some excellent reference topics for the old stagers. A 'must visit' site.
Winwriters Loads of articles and a useful archive.
Word 2007 Ribbon Customiser

Maybe you don't like the new Ribbon and the Tabs being locked down so that you cannot get the layout you want.

Click the link and take a look at Paul Schmid's blog where he argues for a half-way house. The Ribbon plus your own tab that you can customise.

If you like what you see, there's a free version and a "let's get serious" version at a very reasonable price.

I have read good things about it and intend to give it a try soon. I have too many macros to which I need better access than Microsoft provide.

Xenu

An excellent freeware link checker. If you have merged webhelp, RoboHelp does not report broken links across projects so you need a utility to do this. Dreamweaver and FrontPage have such functions but see how quick this one is.

Thanks to Roger Nilsson of Copperfield Publishing for this link.

 

Date

Changes to this page

21 Jun 2008 Microsoft Visual Web Developer added.
12 Apr 2008 Link to Rob Christensen's Regular Expressions article added.
24 Mar 2008

Books section removed - referred to manuals intended for delivery by qualified trainers.

Showmesolutions site added for online training.

25 Nov 2007 Word 2007 Ribbon Customiser added.
24 Oct 2007 HTML Entities added.
10 Jul 2006 Link to Techwrite Tips added.
22 Jun 2006 Link to Frank Palinkas' page added.

02 May 2005

Link to Hyperionics added.

24 Nov 2004

Link to Vice Versa's free folder compare tool added.

20 Nov 2004

Link to HTML Kit added.

20 Aug 2004

Link to Xenu added for link checking.

24 Jul 2004

Links to Cerebral Synergy, Downloads and Freeware Files added.

23 Jun 2004

Link to RoboHelp Help Community added.

09 Jun 2004

Link to topic that includes creating tables using Macro Express added.