Website redesign using Markdown & VitePress default theme

[jcbhmr]

Formal PR to close #20

interesting reading on documentation design https://diataxis.fr/

PREVIEW IT HERE

These PRs should be merged first:

• Create a searchable website of formulas similar to Homebew formulas#174
• Host fontist documentation in-repo instead of in fontist/fontist.github.io fontist#358

---

This PR would:

• revamp the website to be an index site (with a blog tacked on)
• have a dark mode
• support syntax highlighting (in the blog)
• REMOVE docs for https://github.com/fontist/fontist and expect them to be hosted via https://fontist.org/fontist/ via GitHub Pages from https://github.com/fontist/fontist

Advantages of VitePress over current Jekyll theme:

• uses Markdown -- MUCH more popular (~83x more popular to be exact md vs adoc)
• no layouts; using premade theme
• syntax highlighting

Disadvantages of VitePress over current Jekyll theme:

• might not match the bland plain look of other https://open.ribose.com/ stuff
• built more for docs, less for blogs 🤷‍♂️ (at least what's included by default; there are plugins/themes/scripts/etc)

Advantages of using in-repo GitHub Pages sites:

• strong coupling of behaviour to docs (they're in the same repo VS in separate repos)
• makes it wayyy easier too manage changes to the docs & code in one PR vs two prs on separate repos

---

Depending on whether or not you care about maintaining link-compatibility with the old site you could simplify things a bit more and get rid of all the files that are essentially just this (ripped from the Rollup.js website https://github.com/rollup/rollup/blob/master/docs/guide/en.md?plain=1)

Redirecting...

<script setup>
import { useRouter } from "vitepress"; 

if (typeof window !== "undefined") {
  const { go } = useRouter();
  go(`/guide/en/${location.hash}`);
  // OR
  location.replace("https://fontist.org/other-project/sub-page.html");
}
</script>

---

Depending on how much complexity you want, there are other fancier ways to do a VitePress blog to varying degrees of "bloggy-ness" (vs just page-ness)

• (current) manually add entries to index page (ok for very small very sparse blogs like this one)
• https://vitejs.dev/blog basic build script https://github.com/vitejs/vite/blob/main/docs/.vitepress/buildEnd.config.ts 👈 this is what I'd recommend if you realllllly want a bloggy blog
• https://vitepressblog.dev/ complex theme

Given how sparse the current blog is I'd just rely on manual editing until/unless you really get blogging. Right now there is one post lol 😂

_{pssst! "Allow edits by maintainers" is checked; feel free to edit}

open and edit in Codeflow (in browser Node.js IDE) https://pr.new/https://github.com/jcbhmr/fontist.github.io

[ronaldtse]

Depending on whether or not you care about maintaining link-compatibility with the old site

No, we don't really care at this point...

[ronaldtse]

@jcbhmr The PRs have been merged and now deployed! Thank you for the amazing work!