Add Mermaid Chart Support

[leogdion]

from GitHub brightdigit/SublimationBonjour Repo

Mermaid is supported by Github Markdown...

From Swift Package Index brightidigt/SublimationBonjour Page

... but not the Swift Package Index site.

It seems that the javascript needs to be added to automatically parse these pre tags.

I'd love to help add support to this if needed.

[heckj]

FWIW, it's also not supported in DocC - swiftlang/swift-docc-render#413

[leogdion]

YES but the swift-package-index uses the README.md not the DocC so it's not necessarily out of ordinary.

[daveverwer]

What package is this from? I'll take a look.

[leogdion]

Apologies, I added links to the brightdigit/SublimationBonjour repo

[daveverwer]

I took a look and I think this would be a good addition to the site if you wanted to work on it, Leo.

You’ll already find a ReadmeController in readme_controller.js and you’ll probably need to add a connect function to initialise the Mermaid rendering there. Looks like there’s a standard package for rendering, so let’s use that. If you need to pre-process the HTML (which I don’t think will be necessary), we mainly do that in Swift in PackageReadme+Model.swift.

You can also find any readme-specific styles that you might need in readme.scss.

It should be a nicely self-contained bit of functionality. 👍

I’ll convert this into an issue now so we can track it and for any further discussion. I’m also happy to help out if you need any help getting up and running with the front-end development environment or with anything to do with the changes.

[daveverwer]

Tracked in #3348