tomaz/appledoc — Issue #188: Custom pages such as "guides" are not listed in the Xcode sidebar
Author: bengotow
Created: 2012-02-23 19:34:49+00:00
State: open

I'm using AppleDoc to document an iOS SDK. The SDK includes an integration guide that explains how to tie it into an existing app as well as all your traditional class-level documentation. In most of Apple's documentation sets integration guides, summary pages, etc.. are listed in the Organizer's sidebar along with the classes. For example, this screenshot shows part of the iOS 5.0 Library:

http://dl.dropbox.com/u/4803975/xcode%20sidebar%20with%20guides.png

I'd really like to do that, since it's hard to navigate to custom guide pages if they're just linked to from the index page. I've used the --include and --index-desc options to get custom pages and a custom index page, so this sidebar is really my last issue!

If this isn't possible yet, I'd love to know what files need to be hacked or edited to get things into that sidebar. I'd also love to contribute back to the AppleDoc project if it's possible for me to add this feature.

- Ben