Diary of a lazy developer

Tech posts from my projects. Each post lives in its project repo as POST.it.md and POST.en.md, and gets published here automatically by a GitHub Action.

• Theme: leonids (Jekyll)
• Automation: publish.yml
• Sources: sources.yml

Prerequisites

• Docker and Docker Compose
• gh CLI (optional, for manual workflow trigger)

Publishing

Posts are collected from source repos and published to the blog, then cross-posted to social platforms.

EN posts go directly to dev.to (as draft) and Mastodon; Buffer queues them for LinkedIn, Twitter/X and Threads, where you review and approve before publishing.

Scheduled publishing (every Saturday at 6:00 UTC) is currently disabled; trigger manually.

To trigger it manually:

1. Go to Actions > Publish posts
2. Click “Run workflow” > “Run workflow”

Or from CLI:

gh workflow run publish.yml

Cross-posting

All secrets go in repo Settings > Secrets and variables > Actions > New repository secret.

dev.to (draft)

1. On dev.to: Settings > Extensions > DEV Community API Keys > Generate API Key
2. Secret: DEV_TO_API_KEY

Mastodon (public post with image)

1. On mastodon.social: Settings > Development > New Application > select read, write and profile
2. Copy the token: MASTODON_ACCESS_TOKEN

Buffer (LinkedIn, Twitter, Threads queue with review)

1. Create a free account on buffer.com and connect LinkedIn, Twitter/X and Threads
2. On buffer.com: My Organization (bottom left) > Apps & Integrations > API (beta) > + New Key
3. Secret: BUFFER_ACCESS_TOKEN

Post frontmatter

Each post in a source repo has this frontmatter:

---
title: "Docker on EC2 with Terraform"
date: 2026-04-10
categories: [devops]
tags: [terraform, docker, aws, ec2]
repo: bilardi/aws-docker-host
social_summary: "I wrote my first article in the #DiaryOfALazyDeveloper series 🚀\n\n..."
---

#DiaryOfALazyDeveloper is added automatically on all social posts.

Project structure

_layouts/  # leonids theme: page templates
_includes/  # leonids theme: reusable HTML partials
_sass/  # leonids theme: SCSS stylesheets
css/  # leonids theme: compiled CSS
js/  # leonids theme: JavaScript
_posts/  # generated by GitHub Action (gitignored)
img/  # diagrams and favicon
.github/workflows/
    publish.yml  # GitHub Action: collect posts + cross-post
    collect-posts.sh  # clones source repos, copies POST files
    devto-publish.sh  # publish to dev.to as draft
    mastodon-publish.sh  # publish to Mastodon
    buffer-publish.sh  # queue to Buffer (LinkedIn, Twitter, Threads)
sources.yml  # list of repos to scan for POST.it.md / POST.en.md
docker-compose.yml  # local Jekyll server
_config.yml  # Jekyll configuration

Development

docker compose up

If something is not updated,

rm -rf _site .jekyll-cache .jekyll-metadata
touch .jekyll-metadata; chmod 777 .jekyll-metadata
touch Gemfile.lock; chmod 777 Gemfile.lock
docker compose up

Not commit (there are also in the .gitignore file)

• _site
• .jekyll-cache
• .jekyll-metadata
• Gemfile.lock

Blog post

• Italian
• English

License

This repo is released under the MIT license. See LICENSE for details.