Somehow it’s been a couple years since I wrote about “using VoodooPad for authoring help”:http://www.manton.org/2007/01/falling_in_love.html. I always meant to update the post with more information, and I still receive occasional follow-up emails from developers who are trying this for themselves. My workflow is virtually unchanged since then, and the help for “Clipstart”:http://www.riverfold.com/software/clipstart/ is built the same way.
Here is the Clipstart VoodooPad document in case it’s helpful to other developers: “Clipstart_Help.vpdoc.zip”:http://manton.org/misc/Clipstart_Help.vpdoc.zip. The important parts are the special pages WebExportPostflightScript and WebExportPageTemplate.
Meanwhile, “Philippe Casgrain wrote a great blog post”:http://developer.casgrain.com/?p=16 that is nearly identical to what I do, but with more detail and steps for triggering an export from Xcode. Lately I’ve been pointing people to his post since it’s more technical than mine was.
“Mark Dalrymple also posted”:http://borkwarellc.wordpress.com/2009/09/07/voodoopad-and-subversion/ a time-saving SVN script for VoodooPad today. I’ve been needing this!
VoodooPad is just a really good fit for this stuff. (Also see “Macworld’s 4-mice review”:http://www.macworld.com/article/141473/2009/07/voodoopad41.html for VoodooPad 4.1.) Or if you are more of an OmniOutliner kind of person, check out “Omni’s Helpify tool”:http://blog.omnigroup.com/2008/10/02/helpify-the-omni-help-emitter/ for converting outlines to an Apple help book.