Rahti preview does not handle absolute html links correctly

[Nortamo]

Absolute html links of the form /img/cyberduck_connect.PNG start from the root of the webpage, so basicly the site folder.

So in docs.csc.fi, the link /img/cyberduck_connect.PNG would resolve to
docs.csc.fi/img/cyberduck_connect.PNG and it works.

However, in the preview (csc-guide-preview.rahtiapp.fi/origin/name-of-branch) the same link
will resolve to csc-guide-preview.rahtiapp.fi/img/cyberduck_connect.PNG
which is not a valid path and no picture will be shown

No that critical, but just keep in mind that the preview might not display all images if they are using absolute paths. Quick fix is to just use relative paths for images.

[joonas-somero]

It is stated in the documentation for MkDocs, that

[...] as all raw HTML is ignored by the Markdown parser, MkDocs is not able to validate or convert links contained in raw HTML. [...]

Absolute Markdown links are not supported in MkDocs. There is a 'Warning' on the same page.

There is the setting site_url that could be used to mimic the Rahti preview when running the development server locally. Done either by editing mkdocs.yml or, after we've updated MkDocs to >=1.5, by starting the server with

echo '{INHERIT: mkdocs.yml, site_url: "https://csc-guide-preview.rahtiapp.fi/origin/"}' | mkdocs serve -f -

Of course it doesn't make much sense to mimic preview, when we're aiming for links to work in production, but this could perhaps be used in debugging, i.e. as a quick way to locally check if some issue arises from the difference in the path.