The Blog

Helpify 1.5: Help Us Help You Help Users

by Bill Van Hecke on December 21, 2009

Hello! It's kind of strange to think that it's been over a year since I first posted Helpify. If you haven't met it, Helpify is a tool for Mac developers to generate Apple Help Books for their software. We use it here, of course, and it has seen a bit of popularity outside of Omni too.

Version 1.5 incorporates a lot of improvements that were suggested (or written!) by kind folks in the Mac community. This time around, Daniel Jalkut of Red Sweater Software was especially helpful in making sure our indexing process works equally well on Snow Leopard and earlier versions of Mac OS X.

And thanks to Automator, Helpify is now an applet, not just a command-line script. You can drop your source outline right on it. Other new niceties include variables stored inside the source outline instead of inside the script, and better handling of anchors that appear at the top of a page.

I hope you find this new version of Helpify useful. Please let us know what you think!

Update: Version 1.5.1 fixes a problem parsing the special Variables section. Thanks to John Alexander for pointing it out.

Update: Version 1.5.2 fixes a problem with setting up the Box style and with a bogus link to a Variables page on the last page. Thanks to Nicholas Riley.

Download Helpify 1.5.2

Comments

[...] Version 1.5 was uploaded December 21, 2009. See the new blog post for [...]

The Omni Mouth » Helpify, the Omni Help Emit

12.21.09 11:41 AM

Sweet! I love Helpify. It makes creating help files so much easier.

Matt

12.21.09 2:49 PM

I downloaded the zip, unzipped it, ran the program and I got this error:  “The action 'Run Shell Script' encountered an error. Check the action's properties and try running the workflow again.”

Christine

12.29.09 3:03 AM

Hi Christine,


Did you check out the documentation outline? Helpify won't run if you just double-click it; you need to drag a properly formatted OmniOutliner document onto it. The help outline should walk you through it.


If any Automator experts out there know how to handle the case when somebody double-clicks the applet instead of giving it a file, please let me know!


If you need any further help, feel free to use the email address in the Helpify Help outline.

wvh

12.30.09 6:31 AM
Commenting is not available in this channel entry.