# 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](https://docusaurus.io/docs/deployment).  

## 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](https://github.com/settings/tokens).

## Adding a second blog
[This site](https://dev.to/dreamlogic/how-to-use-the-multi-blog-plugin-for-docusaurus-32a2#step-3-add-the-second-blogs-folder-and-file) was beautifully elegant.  Showed me how to get a second blog up and going in about 5 minutes.