Source for jasontrost.com, a static personal site hosted on GitHub Pages.
index.html,about.html,media.html— main pagesnotes/— notes index, posts, and RSS feed (notes/rss.xml)style.css— all stylingfonts/— self-hosted woff2 fonts (Cormorant, Hanken Grotesk)sitemap.xml,robots.txt,CNAME— SEO and custom-domain config- Images live at the repo root and in
notes/images/
No build step, but the site uses root-relative paths (/style.css, /about.html), so opening files directly via file:// renders unstyled. Serve the directory instead:
python3 -m http.server 8000 # then visit http://localhost:8000Pushing to main deploys automatically via GitHub Pages. The site is served at the custom domain in CNAME.
The site sits behind Cloudflare, which caches style.css for four hours. Every page links the stylesheet with a version query (/style.css?v=YYYYMMDD). Bump that value on all pages whenever you change the CSS, or the live site will serve the old styles until the cache expires.
- Create
notes/<slug>.html(copy an existing post for the page structure and meta tags). - Add a card linking to it in
notes/index.html. - Add an
<item>tonotes/rss.xml. - Add a
<url>entry tositemap.xml.