[WIP] Big Docs Update™

[resir014]

Closes #473.

TODO

• Ditched Sphinx and replaced with Docusaurus
• Convert docs pages from .rst to .md (Some Sphinx-related components are converted to raw HTML).
• Convert any old codedoc-based documentation blocks into valid JSDoc.
• Update any possibly-outdated bits in the documentation.
• Add custom styles for Docusaurus site

[resir014]

@dtinth It seems like overriding the Docusaurus CSS is quite simple to do. Will look more into it tomorrow, it's way past midnight here.

[dtinth]

This is looking great! Thanks so much for your effort.

[dtinth]

By the way, should we make package.json a Yarn workspace?

This allows the deps for both the main project and website to be installed in one go. Additionally, it will pave the way for us to centralize the build and publishing system for Bemuse-related packages (for example, the bms, bmson, bemuse-notechart, bemuse-indexer and bemuse-tools packages can be centralized into this monorepo and benefit from the main project’s build (and documentation) system. Furthermore, general-purpose packages such as impure-react, omni-input, sampling-master and scintillator can be turned into npm packages without the overhead of separating projects.)

[resir014]

@dtinth Yeah, sure!

[resir014]

Also, another thing that I forgot to add with the Docusaurus conversion is that MathJax parsing no longer works. Will have to convert them to images or inlined in code blocks

[dtinth]

That’s fine, we can add MathJax script (or KaTeX) to the page as well.

[resir014]

@dtinth Alright, I've added the MathJax scripts on the Docusaurus config. It now works normally again.

[resir014]

Current progress:

We still need to change the placeholder images (e.g. header, footer logo) when I've finished doing my thing with the styles

[resir014]

@dtinth Ready for initial design feedback. After that, I'll do some quick cleanup, then it's up to you to fill up/update the contents and replace the placeholder images.

[dtinth]

I have set up Yarn workspace and set up the build process to also generate the documentation site.

For this PR, the result can be previewed at: https://deploy-preview-479--bemuse.netlify.com/project/

When deployed to production, the URL will be https://bemuse.ninja/project/

The pathname /project/ is up to discussion, but I think it makes more sense than https://bemuse.ninja/bemuse/. Since bemusic.github.io has been aliased to bemuse.ninja, they are the same domain and bemusic.github.io cannot be used separately...

---

The design looks great! While I preview, I think the logo is the wrong variant? (There is a variant for use on Dark background and Light background.)

Also, I prefer the navbar color to be a bit more saturated, e.g. rgb(227, 78, 122).

Thanks!

[dtinth]

I added a list of colors here:

https://deploy-preview-479--bemuse.netlify.com/project/docs/developers-colors.html

[resir014]

@dtinth Yeah, we can definitely merge some content from the wiki to the new docs site! After the merging, we can simply disable the wiki.

[resir014]

Alright, I've attempted merging contents for the music server guide from the wiki to the docs page.

Anyways, once this is finished, I might create a PR on the Docusaurus repo to have this project included on their showcase. :D

[dtinth]

I think this is ready to merge. Thanks for your help pushing the new documentation website! ^_^