Support relative links in included files

[damithc]

If a file root/aaa/bbb/page.md contains a link [details](details.md)
and it was included in root/toc.md
the generated link in toc.html should be aaa/bbb/details.html?

[Gisonrg]

I guess so for now. It is a feature on my list but haven't start looking at it yet (because we have to resolve the relative link in both runtime and build time because of we have dynamic include, build is easier to fix). I'll think about it over the weekend.

[Gisonrg]

Relative path should affect non-included contents only since relative include are well-handled. A.k.a path that are not used in "include" stage, such as images, links, etc.

It's a little tricky for the relative path. Here are my (non-verified) thinkings for solving it:

In build time, at include stage, path in markdown are still in markdown format such as . We need to collect all relative path that is not used for an expanded content (panel/morph), e.g. path in images and anchor links, and change them into a path that is relative to the root file being parsed.
This requires us to find out all possible patterns for a link that we want to change, for example, img usually has a src attribute, markdown usually use []() format for a link. It may take some time to conclude them. Regular expression could be use as well.

It seems quite complicated, and I don't feel there is an existing good solution for it (this is more like a HTML issue). Let me think it over to see if I could solve it.

[damithc]

Yes, it's not going to be easy. But it is also critical to support this as it a basic requirement for reusability.

[damithc]

Case 1:

• file folder1/file1.mbd contains a relative link [link](target.html)
• when file1.mbd is included in folder2/file2.mbd, the link will point to folder2/target.html.

Case 2:

• file folder1/file1.mbd contains an absolute link [link]({{ baseUrl }}/folder1/target.html)
• when file1.mbd is included in folder2/file2.mbd, the link will point to folder1/target1.html.

I think this behavior is fine. i.e., if the link is supposed to point to the same target no matter from where the file is included, it should be made an absolute link by using {{ baseUrl }}