docs: migrate to VitePress from VuePress

[jthegedus]

Summary

Migrate to Vitepress v1 beta from Vuepress v2 beta.

Fixes: #1558

Details

Vuepress has a lot more dependencies, requires more configuration and the breaking changes during the Beta of v2 were becoming cumbersome to resolve. Dependabot got annoying quick.

Vitepress v1 was on the horizon, so I just waited until that hit a stable version to migrate the site across.

URLs should remain the same as the current deployed Vuepress, so existing links should continue to work.

Happily Vitepress also adds copy-to-clipboard buttons on code snippets which was requested recently in #1558

Vitepress also follows more modern design principles, eg:

• the navigation is handled mostly through the left side-pane instead of dropdown menus in the top navbar
• the headings for the current page are listed on the right-side, not nested on the left
• search is much nicer and even local to the selected language

Vitepress does:

• have a different API for importing other files
• the default behaviour for line-numbers on code snippets is the inverse
• it checks for broken or dead links within the site on build
  amongst many other useful things.

Other Information

We may wish to reconfigure the pages in future to take better advantage of the layout/navigation changes, but for today we're just doing a straight migration.

I did my best with the translations for minor wording changes to navigation items. Hopefully people will come and correct them in future.

Homepage comparison

NEW:

OLD:

Documentation page comparison

NEW:

OLD:

[jthegedus]

@Stratus3D The idea here was to migrate to a more modern tool and then introduce a blog/ section so we can comment on the major changes released in 0.12.0.

Might be good to start posting in our documentation site about how we approach version pinning, reproducibility over ergonomics etc.

[jthegedus]

Merging to test the deployment

[hyperupcall]

It looks like this broke https://asdf-vm.com

[jthegedus]

It looks like this broke asdf-vm.com

That may be because of the registrar migration for the domain. Please try again and share the result. I have had no issues testing on my devices.

[hyperupcall]

We were hit by Google Domains too? 😅

Hopefully, its just an issue with my computer - this is what I get - after erasing cookies. I'll try again in several hours and update if anything has changed

[jthegedus]

We were hit by Google Domains too? sweat_smile

Yes, yes we were.

I see, I will investigate further.

EDIT:

Ah, this is probably it.

---

I'll continue to observe.

Not sure why clearing cache and cookies on my machine doesn't show this error 😕

[jthegedus]

Not sure what the problem is with the TLS cert taking so long.

[jthegedus]

Okay, should be good now.

[hyperupcall]

Yup, works for me now 😅

[hyperupcall]

TLS really be taking a day off today

[Stratus3D]

Seems good to me. Thanks @jthegedus !