Skip to main content

docusaurus

That's what this site is built on, dude/dudette!

Install pre-reqs

sudo apt install npm -y

Get a docusaurus instance installed

npx create-docusaurus@latest name-of-site classic

Launch the instance while listening on ALL network interfaces

npm run start -- --host 0.0.0.0 --port 1234

Configure for Git Pages

Edit the docusaurus.config.js and follow the deployment instructions.

Push to Git

I use a simple script to push my docusaurus to Git Pages (prod)

export GIT_USER_EMAIL=my@email.com
export GIT_USER=MyGitUserName
export GIT_PASS=MY-GIT-TOKEN
npx docusaurus deploy

Setup GitHub tokens here.

Adding a second blog

This site was beautifully elegant. Showed me how to get a second blog up and going in about 5 minutes.