uazhlt website

Content

Pages can be written in markdown with frontmatter:

---
title: "UA HLT Program"
slug: "/"
---

Where slug denotes the desired URL for the page. Pages are written in markdown (mdx) and live (mostly) under content/pages.

Develop

The site can be developed using either 1) docker or 2) Node JS (>= v12).

Commits that end up in main trigger an automated deployment to the gh-pages branch.

Option 1: Docker-based method

Pull the docker image:

docker pull "parsertongue/gatsby-dev:latest"

Launch the site in development mode on port 8881:

docker run -it -p "8881:8000" -v "$PWD:/app" "parsertongue/gatsby-dev:latest"

Notes

If you install new dependencies/alter package.json, you'll need to rebuild the docker image:

docker build -f Dockerfile -t "parsertongue/gatsby-dev:latest" .

Option 2: Node JS

You'll need to install Node (>= v12) and yarn. I recommend using nvm to install node:

# node JS v12.x
nvm install --lts="Erbium"
nvm alias default 'lts/Erbium'
npm install -g npm
npm install -g gatsby-cli
npm install -g yarn

Next, install site dependencies:

yarn install .

Now you should be able to launch the site in development mode:

yarn run develop

Theme

See https://github.com/LekoArts/gatsby-themes/tree/master/themes/gatsby-theme-minimal-blog for override options.