Tech Pills Blog

Jekyll-based bilingual tech blog by Miguel Marcondes, hosted on GitHub Pages at https://tech-pills.github.io.

Project Structure

  • _posts/ — Published articles (Portuguese). Format: YYYY-MM-DD-slug.markdown
  • _en/ — English translations. Format: YYYY-MM-DD-slug.md
  • _drafts/ — Work in progress articles
  • _cfps/ — Conference Call for Papers submissions
  • _docs/ — Writing guides and documentation
  • assets/images/posts/<slug>/ — Images per post, with optimized/ subfolder

Content Conventions

Language: Portuguese is the primary language (lang: pt-br). English translations go in _en/ with lang: en. Always write Portuguese first.

Frontmatter (required for all posts):

---
layout: post
title: "Title"
excerpt: Brief SEO description
date: YYYY-MM-DD HH:MM:SS -0300
categories: [category1, category2]
tags: [tag1, tag2, tag3]
author: Miguel Marcondes
lang: pt-br
image: /assets/images/posts/slug/hero.png
---

Cross-language links: Each version includes a blockquote linking to the other:

> English version here: link
> Portuguese version here: link

Writing Guides

  • See _docs/WRITING_POST.md for the full publishing workflow (images, optimization, frontmatter)
  • See _docs/TDC_CFP_WRITING.md for conference talk submission guidelines

Development

bundle exec jekyll serve --livereload  # Local dev
./scripts/optimize-images.sh           # Optimize images before publishing

Skills

  • /write-article — Research, brainstorm, and write a blog article in Miguel’s voice
  • /humanizer — Run as a final pass on articles and CFPs to strip AI-writing patterns (inflated language, em dash overuse, AI vocabulary, generic conclusions). Especially useful on English translations.