Support MediaWiki-style links, includes?

's Avatar

john

05 Nov, 2013 04:46 PM

Increasingly I find I want to look at a document that is used for the Gollum (Github) wiki software and in Marked.

So . . .

Gollum can support MediaWiki style links:

https://github.com/gollum/gollum/wiki#bracket-tags

(The doc here is kind of a mess, but it seems that for Markdown, it is always [[Title|page]] - if "page" is "page.md" they will find it -- and no matter where it is in the directory hierarchy.)

My impression is that they now recommend this link structure because Github makes the base URI something like "wiki/" and it is hard to get pages that work both locally and on Github.

The other thing they support is includes;

https://github.com/gollum/gollum/wiki#include-other-pages

(The includes only work when you host your own Gollum - the include links don't work on the wikis supported at Github.)

To sum it up:

(1) Provide for MediaWiki style bracketed links, where the page element is found in (probably) a breadth-first search of the directory structure (top-level would probably be good enough);

(2) Provide for includes.

  1. Support Staff 1 Posted by Brett on 05 Nov, 2013 04:54 PM

    Brett's Avatar

    Given that Marked doesn't really have support for page navigation, it
    would be fruitless to implement this as a default feature. You can,
    however, do a decent job of replicating it with a custom pre-processor
    that does a file scan and generates standard Markdown links before
    passing it back to the main processor.

Reply to this discussion

Internal reply

Formatting help / Preview (switch to plain text) No formatting (switch to Markdown)

Attaching KB article:

»

Attached Files

You can attach files up to 10MB

If you don't have an account yet, we need to confirm you're human and not a machine trying to post spam.

Keyboard shortcuts

Generic

? Show this help
ESC Blurs the current field

Comment Form

r Focus the comment reply box
^ + ↩ Submit the comment

You can use Command ⌘ instead of Control ^ on Mac