Documentation about hiei.js HOT 5 CLOSED

Here are some solutions I'm looking at:

• Spacebook
• Docusaurus
• Gitbook
• Astro

from hiei.js.

Notes for Spacebook

The instructions, as written here, don't work on Windows. Here's what I had to do:

• git clone https://github.com/broeker/spacebook
• cd spacebook
• npm install
• Add cross-env as a dev dependency npm install -D cross-env
• Edit the build script to use cross-env and npx: cross-env ELEVENTY_PRODUCTION=true eleventy && cross-env NODE_ENV=production postcss styles/tailwind.css --o _site/style.css && npx cleancss -o _site/style.css _site/style.css
• npm run build

from hiei.js.

Notes for Astro

Astro is simpler to set up than Spacebook, but there's a bug in the dev script. Uninstalling/reinstalling the @docsearch/react dependency fixed the bug for me.

from hiei.js.

I decided to go with Astro. It was very easy to set up, is well documented, and seems easy to use. I've been curious to try it for a while now, so this seems like a great excuse to do it.

I also decided to host on Cloudflare Pages. The js.org domain would be nice, but it requires hosting on GitHub Pages. Not that there's anything particular bad about GitHub Pages; I've just been anxious to try Cloudflare Pages. Plus, I'll get the domain hiei.pages.dev for free, which seems fine to me.

from hiei.js.

The documentation for Hiei 0.1 is up at https://hiei.pages.dev. It's very basic for now, but I'm including a disclaimer in the README for Hiei that this is WIP pre-release stuff so people aren't surprised.

from hiei.js.