raxod502 / intuitive-explanations

📚 Understand, don't memorize.

Intuitive Explanations

This is the home of my personal website. Most of it is open-source, there are just one or two small pieces which are kept in private submodules (such as my resume) to which the deploy system has access. You can build the website yourself without these components.

Development

Install:

• Git
• Make
• Docker

Clone this repository and run:

$ make docker

At this point you will be in a shell with all the dependencies installed. Run:

$ make help
usage:
  make help         Show this message
  make all          Fully build website
  make dev          Fully build website and then run dev server
  make serve        Run developer server
  make build        Build main website content
  make tex          Compile LaTeX
  make placeholder  Compile placeholder document
  make resume       Compile resume
  make stories      Compile Fiction Writing stories
  make checklinks   Check link anchors in Markdown files
  make clean        Remove build artifacts
  make deploy       Deploy website to Netlify
  make docker       Start a Docker shell

When a commit is pushed to main, it is deployed automatically by GitHub Actions to Netlify after about ten minutes.