Note: This article is marked deprecated. It means that it might contain old and/or outdated information that is no longer accurate or even relevant.


Middlemac 2.0 is huge improvement

Middlemac version 2.0 is available now, and offers these new reasons to use Middlemac to build your Mac OS X help documentation:

  • Now packaged as a proper Ruby gem, you can gem install Middlemac and its dependencies without complications.
  • Its features have been broken up into separate Ruby gems. Is there something that Middlemac does that you’d like to use on your own site? Install the gem that offers that feature.
  • All new, task-based documentation makes it easier to understand how to best use Middlemac.
  • Uses the latest and greatest Middlemac version 4.1.
  • Now processes a lot of the Mac OS X specific files as a natural part of the build process rather than awkward pre- and post-build phases.

What is Middlemac?

It’s a help building system for Mac OS X applications. It takes all of the frustration out of configuring Apple Helpbooks so that they work properly with your Mac applications, and features multiple target and multiple features support so that a single help codebase can be used to target multiple versions of your Mac application.

As easy as…

middleman build_all

That one terminal command can build all of your help targets, put them into the right Xcode project directory, and make them ready for Xcode to build into your application.


Although you have to be on a Mac to build the final product so that the Apple help indexer can run, you can do the bulk of your help file development on both Mac and Linux.

Uses Proven Technology

Middlemac is powered by Middleman, the static website generator behind hundreds of websites and blogs. Middlemac extends its functionality to bring you a tool uniquely suitable for creating Mac OS X .help bundles. It will increase your productivity whether you are targeting a single version of your application or a hundred.

Production Ready

Middlemac was developed to build the help system for all three versions of Balthisar Tidy.

Get it now

Middlemac is available from its github project page.

comments powered by Disqus