SSG (Static Site Generation)

[NullVoxPopuli]

It should be possible, once migrated to Vite, to statically generate most of the docs for most pages.

The only exception is going to be when there is a live tag on a codefence AND that output code has interactivity (a, button, input, etc).
That bit will still require javascript, but most live codefences should even be able to be statically burned in to the page.

Todos:

• Runtime traversal utils for browser usage TypeStrong/typedoc#2528
• Need to figure out a strategy for Vite #40
• A Vitepress plugin?
  • Customizable live demos (renderers?) via codefences with "meta" tags vuejs/vitepress#3676 (comment)

Alternatives / partial implementation:

• The Docfy approach -- except only during a production build and actually emit all the pages to hand off to a static renderer (vite-ssr?)
  This would likely require being opt-in, because it is a tradeoff with the low-build time approach currently implemented

References

• https://vitejs.dev/guide/ssr