Update to bootstrap 5.

[nojaf]

This PR gives the default template a facelift with Bootstrap 5. This update makes it smoother to switch between light and dark modes, thanks to Bootstrap v5.3.

I also borrowed some ideas from Jimmy, which you can check out in this comment.

Take a peek at the new look:

Now, I'm wondering if it's time to rethink our reliance on Bootstrap. Maybe it's more convenient to start fresh with a custom CSS theme using CSS variables for just about everything. This way, we can effortlessly handle light and dark modes from the get-go and maintain it easily. If we decide to tweak the default theme, users can do so by overriding a bunch of CSS variables.

Let's chat about this! Tagging some folks who know this repo: @dsyme, @nhirschey, @baronfel, @kMutagene, and @theAngryByrd.

[kMutagene]

The dark theme looks really good!

Maybe it's more convenient to start fresh with a custom CSS theme using CSS variables for just about everything

I actually started something similar a while back on https://github.com/fslaborg/docs-template. the gist is that i used Bulma instead of bootstrap, which is a css only framework and can be customized via sass and variables. It is distributed as dotnet new template. However that approach has huge problems when the fsdocs tool receives updates.

If any css variable-based customization would find its way directly into this library, i think that would be the starting point for an actual templating system. That can be installed directly via fsdocs, e.g. a cli command fsdocs template install <name>, which then downloads a css file from an npm package. Wether you'd want to switch to bulma or do something completely from scratch does not matter too much i think.

[nhirschey]

I built a site with the new template and it generally looks good. I have no opinion on css vs. bootstrap.

Regarding the dark theme, I think the blue used for open/let/for/in keywords is too close to the background color. I cannot easily read these keywords in the below dark mode screenshot.

[TheAngryByrd]

I built a site with the new template and it generally looks good. I have no opinion on css vs. bootstrap.

Regarding the dark theme, I think the blue used for open/let/for/in keywords is too close to the background color. I cannot easily read these keywords in the below dark mode screenshot.

I wonder if we should consider "outsourcing" code syntax to something like highlight.js (This is more future work, shouldn't block merging this tho)

[dsyme]

I'm ok with this!

[nojaf]

Thanks all for the feedback. I'm still on the fence about using bootstrap or not. I'm currently not using it for the new Ionide analyzers website and I think it might be reasonable to rewrite the default theme here from scratch. The CSS variable approach is working out quite well.

It could make things easier to theme, have fewer dependencies and foresee the light/dark from the start.

[nojaf]

Hi @freymaurer

[nojaf]

Closing in favour of https://github.com/fsprojects/FSharp.Formatting/pull/861