Rendered version available at https://icex2.github.io/
- Use GitHub's pages feature
- Use jekyll for a simple and static blogging framework
- Local development uses the Jekyll Docker image, pinned to version 4.4.1 and an image digest in the Makefile.
- Use the Makefile for common development commands
Local commands require Make and Docker. Run make or make help to list all
targets. Use make build to build the site into _site/ and make clean to
remove build output and the Jekyll cache. The make new target is retained for
initializing a new site; do not run it against this existing site.
Run make install to install the locked Ruby dependencies into the ignored
vendor/bundle/ directory. Build and preview commands also install missing
dependencies automatically and use bundle exec to respect Gemfile.lock.
Routine commands keep the lockfile frozen and fail if it no longer matches
the Gemfile rather than silently changing dependency versions.
The first run downloads the container image and gems; later runs reuse them.
No host Ruby installation is required.
This upgrade applies only to local tooling. It does not change publishing or GitHub Pages settings. GitHub Pages' built-in Jekyll builder uses its own dependency versions, not this local pin.
make serveOpen http://localhost:4000/ and press Ctrl-C to stop the preview. Restart it
after changing _config.yml. Generated files use the caller's UID/GID on
rootful Docker; rootless Docker uses its default user mapping.
- Convert images to jpg
- Reasonable size for fast loading times and less asset bloat
- For detailed pictures, keep original size
- Remove any EXIF metadata before uploading
- 1500x seems to be a reasonable size for most images can still contain visible details but are ok file size wise (< 500 kb per image)
for i in *.jpg; do convert $i -strip -resize 1500x out-$i; done