verbaria.org

Source for the Verbaria home page — a Jekyll site deployed to GitHub Pages.

Stack

• Jekyll 4 (kramdown + rouge). The legacy github-pages meta-gem was dropped: it pinned Jekyll 3.7 / ruby_dep 1.5, which caps Ruby at ~> 2.2 and can't run on modern Ruby.
• Builds with jekyll build and deploys via actions/deploy-pages, so we are not tied to GitHub Pages' bundled Jekyll version.

Run locally

Requires Ruby ≥ 3.2 (3.4 recommended — matches CI and Gemfile.lock).

./run.sh        # installs Jekyll (rubygems) and serves with live reload

Then open http://localhost:4000.

run.sh deliberately uses plain gem install + jekyll serve instead of bundle: the Gemfile/Gemfile.lock drive CI (via ruby/setup-ruby), but some local bundler installs have a broken gem downloader, whereas gem install works reliably. If your local bundle works, the equivalent is:

export PATH="$(ruby -e 'print Gem.user_dir')/bin:$PATH"
bundle install && bundle exec jekyll serve --watch --config _dev_config.yml

⚠️ Open the served URL, not the built file. All asset/page links are root-absolute (/verbaria.css, /images/…, /about/). They resolve against the site root, which a server (localhost:4000) or the deployed domain provides — but opening _site/index.html directly via file:// makes / point at your filesystem root, so the CSS 404s. Use the dev server.

Build (CI does this for you)

JEKYLL_ENV=production bundle exec jekyll build
# output → _site/  (gitignored)

Deploy

Push to master. The .github/workflows/jekyll.yml workflow builds the site (Ruby 3.4) and publishes it to GitHub Pages, served at the verbaria.org root (see CNAME). There is nothing to build or commit by hand — _site/ is generated on the runner.

Troubleshooting

• bundle: command not found — the user gem bin dir isn't on PATH; see step 1 above.
• cannot load such file -- webrick/erb/csv … — Ruby 3.x unbundled several stdlib gems; they're declared in the Gemfile, so run bundle install.
• See the Jekyll troubleshooting docs.