mzaran.com

Personal site and blog, built with Jekyll and hosted on GitHub Pages.

E-ink terminal aesthetic with a tree-style post listing, IBM Plex Mono typography, and scroll-aware navigation.

Local development

Requires Podman (installed by default on Fedora):

./bin/dev          # build image if needed, serve at localhost:4000
./bin/dev --build  # force rebuild (after Gemfile changes)
podman stop mzaran-dev  # stop dev server

To validate CI locally before pushing (requires act):

./bin/ci

Or natively with Ruby 3.4+ and Bundler:

bundle install
bundle exec jekyll serve

Writing posts

Create _posts/YYYY-MM-DD-title.md:

---
layout: post
title: "Post Title"
date: YYYY-MM-DD
description: One-line summary shown in the post tree listing.
tags: [tag1, tag2]
---

Deployment

Pushes to main trigger the GitHub Actions workflow (.github/workflows/jekyll-gh-pages.yml), which builds and deploys to GitHub Pages at mzaran.com.

License

This project is licensed under the GNU General Public License v3.0.