Alternative Jekyll theme for cleaner code

[snomos]

The present Jekyll theme has several shortcomings:

• no sitemap/overview of available pages
• the page TOC to the left is really a hack
• does not play well with smaller screen sizes
• no dark mode
• not easily exentable
• inline code is not clearly separated from the surrounding text
• search results are still lousy

What is good about it is:

• mostly good layout and typography = easy to read
• relatively modern design

I would thus like to replace the current theme with something else. The requirement are:

• Page TOC
• Site map/view
• builtin support for Mermaid, math (not important), charts (=no hacks to make it work)
• responsive design
• light and dark mode, both manual and automatic (= follows system)
• easily extendable in config file or document config headers
• better code & syntax formatting
• preferably active community & development work
• anonymised analytics
• better search

Some candidates:

• https://kitian616.github.io/jekyll-TeXt-theme/
• https://just-the-docs.github.io/just-the-docs/

This issue is filed under giellalt.github.io, and obviously applies to that site. In addition it should also apply to most subsites (all language models, keyboard repos, dictionary repos, etc).

I am not too happy about the candidates, but they are so far the best I have found. Do you have any better suggestions @albbas and @flammie and @Phaqui ?

[flammie]

I have no strong opinions, but this: https://github.com/topics/jekyll-theme is a list of themes ordered by popularity, one of the ones high up could be good. I always jsut used ones in the dropdown menu on github pages settings :-)

[snomos]

Thanks for the link!

[snomos]

Both themes that I had found are high up on the list, and https://github.com/kitian616/jekyll-TeXt-theme is the one coming closest to my requirements. Unfortunately development has stopped a year ago it seems.

[snomos]

What about this one?

[albbas]

Looks nice

[snomos]

It is nice, but seems to require a blog style documentation - not fit at all for our documents.