Networking, Cloud, Automation, Infrastructure, Containers and General Geekery
This file provides guidance to Codex (Codex.ai/code) when working with code in this repository.
Jekyll-based blog hosted on GitHub Pages at networkbrouhaha.com. Theme: jekyll-theme-modernist.
Run locally (with drafts and future-dated posts):
./serve.sh
# or equivalently:
bundle exec jekyll serve --drafts --future
Install dependencies (macOS):
./install.sh
Posts live in _posts/ with filename YYYY-MM-DD-slug.md. Required front matter:
---
layout: post
theme: jekyll-theme-modernist
title: "Post Title"
date: YYYY-MM-DD
comments: true
excerpt: Short description shown in previews and Twitter cards.<p>
---
comments: false disables Disqus on a per-post basisimage: /resources/... sets a Twitter large-card image; omitting it falls back to the site title image_drafts/ (no date in filename needed)Post images live under resources/YYYY/MM/ (e.g., resources/2023/01/image.png). Reference them with root-relative paths like /resources/2023/01/image.png.
Image embedding pattern used in posts:
{: .center}
[](/resources/YYYY/MM/image.png){:.drop-shadow}
_layouts/default.html — base layout; includes nav links (About, Links, Presentations), social icons, Disqus integration, and analytics (production only via jekyll.environment == 'production')_layouts/post.html — wraps default.html; renders post date with ordinal suffix and `<p>Here are presentations I’ve given at various conferences and webinars.</p>`
_config.yml — site metadata, permalink scheme (/:year/:month/:title/), pagination (10/page), plugins, author info_includes/analytics.html — Google Analytics snippet, only injected in production builds_sass/ — SCSS overrides on top of the modernist theme_site/ — generated output, not committed (should stay in .gitignore)Pushing to master triggers GitHub Pages to build and deploy automatically. No CI config needed.