Support links between ADR's

[dirkgroot]

When importing ADR's, Structurizr automatically transforms links to other ADR's. This PR adds functionality to transform these transformed links into links that correctly link to the corresponding ADR.

Fixes #260.

Example

Assuming an existing ADR file named 0001-first-adr.md, an ADR like this:

# 2. Some ADR

[link to ADR 1](0001-first-adr.md)

will be transformed by Structurizr to:

# 2. Some ADR

[link to ADR 1](#1)

The new functionality from this PR will in turn transfer this to the following in case of a workspace-level ADR:

# 2. Some ADR

[link to ADR 1](decisions/1)

and to the following in case of an ADR for a software system named "Software System":

# 2. Some ADR

[link to ADR 1](software-system/decisions/1)

[dirkgroot]

@jp7677 This is what I came up with to fix #260. Could you review this?

[jp7677]

Cool to have this fixed.
Using regex for preprocessing looks simple and effective, that said, we already have a place for link transformation. We could explore to transform the ADR links there as well.
(https://github.com/avisi-cloud/structurizr-site-generatr/blob/main/src/main/kotlin/nl/avisi/structurizr/site/generatr/site/model/MarkdownToHtml.kt#L35)

[dirkgroot]

Cool to have this fixed. Using regex for preprocessing looks simple and effective, that said, we already have a place for link transformation. We could explore to transform the ADR links there as well. (https://github.com/avisi-cloud/structurizr-site-generatr/blob/main/src/main/kotlin/nl/avisi/structurizr/site/generatr/site/model/MarkdownToHtml.kt#L35)

I prefer having the transformation logic close to the code where it's needed, preferrably within the context where it's applicable. I'm going to leave it like this. Thanks!