How to write a new post
1. Create the file
Add a new file inside _posts/, named like this:
_posts/YYYY-MM-DD-a-short-slug.md
Example: _posts/2026-07-21-getting-back-into-this.md
The date in the filename controls where it lands in the feed, but the date field in the front matter (below) is what actually gets displayed and sorted on — keep them in sync.
2. Add the front matter
Every post needs this block at the very top of the file:
---
layout: post
title: 'Your Post Title Here'
date: YYYY-MM-DD
excerpt: 'A one to two sentence summary. This is what shows up in the homepage feed.'
---
title— shown as the heading on the post page and in the feeddate— controls sort order (newest first) and the date shown in the feedexcerpt— the short blurb shown under the title in the feed card. Keep it to a sentence or two.
3. Write the post
Everything below the --- front matter is regular Markdown.
To embed an image (drop the image in assets/img/projects/<slug>/ or similar first):
<div class="image-container">
<a href="/assets/img/projects/<slug>/<file>.png" target="_blank">
<img src="https://www.genevereyes.com/assets/img/projects/<slug>/<file>.png" alt="Avatar" class="image">
<div class="overlay">
<div class="text">
View Demo →
</div>
</div>
</a>
</div>
4. Publish
Commit and push to the gh-pages branch. GitHub Pages rebuilds automatically — the new post shows up live within a few minutes.
Adding a project instead of a post
Projects work the same way but live in _projects/ (soon-migrated from projects/) and take one extra field:
---
layout: post
title: 'Project Title'
date: YYYY-MM-DD
excerpt: 'One or two sentence summary.'
thumbnail: '<slug>/thumbnail.jpg'
---
thumbnail should point to a file inside assets/img/projects/, and is what shows in the feed’s grid card.