Wouldn’t it be great if there was an easy way to access php.net or other documentation offline or on a plane?
UPDATE: Sadly, as this blog post went to press, two important updates came out that change the usefulness of this blog post. Dash is now ad-supported, and secondly, it ships with a Drupal DocSet available for download, so that’s one fewer step you have to perform to have all the docs that matter to you in Dash.
There’s a free as in beer application called Dash (available on the Mac App Store at http://itunes.apple.com/us/app/dash/id458034879?ls=1&mt=12) available for Mac OS X. Dash is a nice-looking documentation browser featuring several useful features, such as the ability to query it with a custom URL string (dash://YOURQUERY), which lends itself for use in tools like Alfred.
Dash can also download additional documentation sets for many open source technologies, including MySQL, PHP, and jQuery. It can be handy to search through the latest PHP API documentation no matter what kind of connection you’re on, like so:
In addition, Dash also has the ability to browse any API documentation that you have installed through XCode onto your system. (In fact, any files in DocSet format that are located inside the ~/Library/Developer/Shared/Documentation/DocSets directory can be read by Dash.)
In addition to the freely available DocSets that are available for major open-source technologies, it’s easy to make your own DocSets using doxygen. I went ahead and made a DocSet for Drupal 7.x using doxygen. Not every method that’s available at api.drupal.org is here, but it’s a great start, especially if you want a single offline app where you can query offline documentation.
To start using the Drupal DocSet, download the .tgz file from https://github.com/phase2/drupal-docset/zipball/master. To use it:
- Unzip the file
- Move org.drupal.docset to ~/Library/Developer/Shared/Documentation/DocSets/
- Launch Dash and start searching, like so.