brennan.casa

Blog Workflow Part 3: Making Posts

July 18, 2026

This is Part 3 of a 3-part series documenting the blog workflow. This part covers making posts and the Git workflow.

Making Posts

  1. Create a new Markdown file in src/notes/ (e.g., new-note.md)
  2. Add frontmatter:
    ---
layout: layouts/post.njk
title: Your Title
date: YYYY-MM-DD
tags: [note]
---
  3. Write content in Markdown
  4. The note automatically appears in the notes index and homepage

Modifying Templates

  1. Edit Nunjucks templates in src/_includes/
  2. Changes apply to all pages using those templates
  3. Layout changes affect all pages using that layout
  4. Partial changes affect all pages including that partial

Git Workflow

The _site/ directory is gitignored since it's generated during build. Only source files are tracked in Git. When deploying:

  1. Commit changes to source files
  2. Build locally with npm run build
  3. Deploy with npm run deploy
  4. The generated _site/ is synced to the server

The workflow from making posts to deployment:

  1. Create or edit content in src/ directory
  2. Test locally with npm run serve
  3. Commit changes to Git
  4. Build with npm run build
  5. Deploy with npm run deploy
  6. Changes are live at https://brennan.casa

Previous Parts

Return to Part 1: Project Structure & Architecture for information about the project structure and template architecture.

Continue from Part 2: Build Process & Deployment for information about the build process and deployment workflow.