Allow a hierarchical page namespace

[cubranic]

There is a disconnect between the file and wiki page namespaces: files can be placed into a hierarchy of directories, but when Gollum processes them into wiki pages, they are flattened and the hierarchical organization is lost.

Is this considered a feature and unlikely to change, or just a temporary limitation of the current implementation?

[technoweenie]

This is by design. Wikis pages are on a flat namespace.

[cubranic]

That's too bad, but I can see why you wouldn't want to change it.

[technoweenie]

We wanted the wiki to be SIMPLE (though, the code to look up subdirectories ends up being more complex). A flat namespace works well enough for wikipedia, so why not :)

I understand people have more specific needs, such as hierarchical knowledge bases and CMS stuff. I'd recommend forking Gollum. Maybe there's some way you can start a similar project that just used similar bits in Gollum. I'm happy to help refactor that stuff to make things easier... or maybe it's better off in its own separate project?

[cubranic]

Fair enough. Although, encyclopedias and dictionaries always use a flat list of terms, while most technical documentation that I've seen is organized into a hierarchy of sections. (Cf. man 1 open and man 2 open.)

[nyerup]

I've made a fork with a proof of concept of a hierarchical namespace, based on the folder structure of the repo. This is available here, and I'll appreciate comments and bug reports.

This is just a quick hack, enabling me to test Gollum for a specific documentation project, and needless to say, this will need to be implemented better if the codebase actually is to be maintained.

[technoweenie]

This is a specific thing we designed against, actually. I don't think
we'll be adding it any time soon. You're more than welcome to
maintain a fork of course (though we'd appreciate it if you changed
the name for releases to avoid confusion).

[chhabrakadabra]

Why not have some sort of a flag that can be turned on by people who want hierarchical structure. Let the default behavior be a simple flat structure (in line with keeping it SIMPLE) but let people who like structure have it.

[bootstraponline]

@chhabrakadabra The gollum gem has supported directories for a while.

[chhabrakadabra]

@bootstraponline is Github running an older version maybe? I have wiki pages arranged in a heirarchy, but their urls are all of the format ".../wiki/page-name.md" instead of ".../wiki/path/to/directory/page-name.md".

[davispuh]

yes, Github wiki isn't up-to-date and have issues look #380