Automatically Index your Help Book with Xcode

A simple way to improve your workflow and minimize human error while authoring your application’s help book is to automate the indexing of your help pages.

Xcode provides a simple way to add automated steps to your build process with shell scripts. The Help Indexer tool can be called with command line arguments via a shell script. Add these two together and you have automated help indexing as part of your normal build process.

Here is how to set this up:

1. First, find your projects build target and expand the build steps:

2. Then Control-Click on the Target and select the New Run Script Build Phase menu item.

3. In the Script Phase Editor window type the following, replacing your root help path in the script:

/Developer/Applications/Utilities/Help Indexer ~/WorkSpace/LicenseKeeper/trunk/English.lproj/LicenseKeeperHelp/

Make sure there is a space between “Help Indexer” and your help project path.

4. Close the editor, rename your new build phase to something like “Index Help” and drag it to the top of the build phase list or other appropriate spot.

5. There is no step 5.

Now whenever you build your project, your help files will be automatically indexed for use in Apple’s Help Viewer.

2 thoughts on “Automatically Index your Help Book with Xcode

Comments are closed.