appledoc icon indicating copy to clipboard operation
appledoc copied to clipboard

Table of Contents for Programming Guides

Open chris838 opened this issue 12 years ago • 3 comments

It would be great if we could generate programming guides using markdown template files which have a Table of Contents in the sidebar, just like Apple programming guides. Example: https://developer.apple.com/library/ios/#documentation/Cocoa/Conceptual/ProgrammingWithObjectiveC/Introduction/Introduction.html%23//apple_ref/doc/uid/TP40011210

chris838 avatar Feb 25 '13 18:02 chris838

This is somewhat related to #188.

On 25. feb. 2013, at 19:22, chris838 [email protected] wrote:

It would be great if we could generate programming guides using markdown template files which have a Table of Contents in the sidebar, just like Apple programming guides. Example: https://developer.apple.com/library/ios/#documentation/Cocoa/Conceptual/ProgrammingWithObjectiveC/Introduction/Introduction.html%23//apple_ref/doc/uid/TP40011210

— Reply to this email directly or view it on GitHub.

tomaz avatar Feb 26 '13 16:02 tomaz

I've made a start by editing document-template.html. I can generate guides with all the required HTML structure, the sidebar and title etc.

Can you give me a pointer as to which files I need to start editing to generate the ToC? And do you have any suggestions as to what markup to use to denote the ToC within the markdown file?

Also - document-template.html now contains references to the index page and hierarchy page. Any suggestions on how to make these work? I have fixed them manually for now but this will break if the guides are stored in subdirectories.

chris838 avatar Feb 26 '13 18:02 chris838

+1

mralexgray avatar Apr 25 '15 13:04 mralexgray