multiple pages?

[lookfirst]

This looks great, but I organize my documentation across multiple pages. I don't want to stick everything in a single file. Anyway that you can support that in the future?

[jeromegn]

Yes most likely. I'm already developing new features and enhancements.

[neerajsingh0101]

Multi page support will be awesome. Thanks for great work .

[alganet]

It would be awesome if multi-page support included GitHub wiki pages as well.

[taylorotwell]

+1 for this. Any ETA? If it helps I would be willing to throw in a donation for this.

[jeromegn]

Here's my thought on this: You could "mount" pages.

Definitely would be in the documentup.json config, maybe like so:

{
  "mount": [
    "/api": "/docs/api.md",
    "/man-pages": "/docs/man.md"
  ]
}

Thoughts?

The only reason this isn't "automatic" (eg: visiting /something would look for something.md or /something/readme.md) is because it would be harder to know when to recompile. I'd have to poll Github for changes every x times. With the config I just know exactly when to recompile the pages. (if you have a post-receive hook installed, which you should!)

[fd]

+1

[neerajsingh0101]

+1 looks awesome

[taylorotwell]

The "mount" option looks good! I take it the "value" side (/docs/api.md) would correspond to the path within the Github repo?

Might also need a way to mount the sidebar to a specific file or something too?

[jeromegn]

Yes, need to think about this.

Also have to keep almost the same UX for repos that don't have multiple pages of docs.

[chadyj]

+1
Would love to see this for our docs at https://github.com/Sendicate/sendicate-docs

[jeromegn]

If anybody is still watching this: technically you can now point to subpages and it will render them. Not sure how well though, still a work in progress.

[brylie]

Is there an example of adding sub-page links to the navigation menu?