My personal website based on the academic pages website template. Please see that repository for more details on setup and configuration.

Setup:

1. If you want to host on github, fork repo and name it <your username>.github.io
2. Clone the repository
3. Make sure you have ruby-dev, bundler, and nodejs installed: sudo apt install ruby-dev ruby-bundler nodejs (on mac gem install bundler)
4. Run bundle clean to clean up the directory (no need to run --force)
5. Run bundle install to install ruby dependencies. If you get errors, delete Gemfile.lock and try again.

Usage:

1. Run make to clean and regenerate the site in _site
2. Run make serve to continuously rebuild and serve at http://localhost:4000/
3. Alternately make watch to continuously rebuild without running a server, or just make to build once
4. If you are hosting the site from a non github server, just copy the contents of _site to that server after building. Alternately, you can overwrite the make deploy rule in the Makefile to deploy to that server after rebuilding
5. Run make clean to delete the built site