Skip to content

Latest commit

 

History

History
25 lines (16 loc) · 1.33 KB

README.md

File metadata and controls

25 lines (16 loc) · 1.33 KB

Description

This package is used to generate the static files for kevingal.com, which are then served by GitHub Pages from the GitHub repository kevinpgalligan.github.io.

It comes with a number of scripts to automate the whole process:

  • generating the static files.
  • moving them to the local copy of the kevinpgalligan.github.io repository.
  • displaying a diff to the user.
  • pushing to the remote repository, where the files are served by GitHub Pages.

Instructions

All scripts executed from the base directory. Requires Python3.

Execute ./setup.sh once. Installs dependencies, sets up Python venv, and so on.

Execute ./run.sh to start Flask webserver. Allows local testing before pushing a change.

Execute ./build.sh --all to build static copy of site in build folder. Not so useful in itself.

Execute ./deploy.sh /path/to/kevinpgalligan.github.io/repo --all to generate static files and push them to the kevinpgalligan.github.io repository. Shows a diff before pushing.

The --all flag can be swapped out if you want to e.g. only regenerate files that have changed, or regenerate a single file! See app.py for how that works.

Requirements

python3, pip3, setuptools (install through pip3). Maybe some other stuff, the setup script isn't as bulletproof as I would like.