When an MKDoc document has child documents, the titles of those child documents are magically linked within the text of the parent document.
This is a very useful feature, but it should be configurable to increase the range of covered documents:
The default range should be increased to include the parent of the current document by default
Optionally siblings can be magically hyperlinked
Optionally uncle/aunt documents can be magically hyperlinked (drop this suggestion?)
Optionally all documents can be magically hyperlinked (drop this suggestion?)
This would make an MKDoc document much more similar to a wiki document, something else we can do to make MKDoc more wiki-like would be to automatically link to any document on the site when the text [[has double-brackets]] like so.
Ideally there should be a web interface for configuring this.
At the moment if there are two child documents with the same title the first one is linked to, this same method should be used where by the closest document is linked to.
The order to link when titles are the same:
Home page
Children of the home page
Grandparent document
Parent document
Sibling documents
Child document
Grandchildren documents
These should all be able to be turned on and off with env vars, eg the MKDoc 1.6 default:
SetEnv LINK_ROOT false SetEnv LINK_ROOT_CHILDREN false SetEnv LINK_GRANDPARENTS false SetEnv LINK_PARENTS false SetEnv LINK_SIBLINGS false SetEnv LINK_CHILDREN true SetEnv LINK_GRANDCHILDREN false