AGENTS.md - bhargavachary.github.io

AGENTS.md - bhargavachary.github.io

Personal website and blog for D K Bhargav Achary. Live site: https://bhargavachary.in

Stack

  • Static site generator: Jekyll + GitHub Pages (Ruby)
  • Theme: chrisrhymes/bulma-clean-theme@v0.14.0 (remote theme via _config.yml)
  • Analytics: Google Analytics G-TFVWELSZ9W
  • Comments: Disqus (bhargavacharyin)
  • Deploy: Push to master → GitHub Actions (jekyll.yml) → auto-deploys to gh-pages
  • No Node.js, no npm, no Python - pure Jekyll/Ruby

Structure

_posts/         ← blog posts: YYYY-MM-DD-title.md (required front matter)
_pages/         ← static pages
_data/          ← YAML data files (nav, authors, etc.)
_includes/      ← reusable HTML partials
_layouts/       ← page layout templates
_config.yml     ← site config (do not touch url or baseurl)
Gemfile         ← Ruby deps (github-pages gem + plugins)
scripts/
  optimize-images.sh   ← run before committing any images

Commands

bundle install                  # install Ruby deps
bundle exec jekyll serve        # local dev at http://localhost:4000
bash scripts/optimize-images.sh # optimize images before committing

Rules

  • Blog posts go in _posts/YYYY-MM-DD-title.md with front matter: layout, title, date, categories
  • Do not change url: "https://bhargavachary.in" or baseurl: "" in _config.yml
  • Do not modify the remote theme version without local testing first
  • Optimize images with optimize-images.sh before committing
  • Do not commit a macOS-generated Gemfile.lock - it’s platform-specific and breaks CI
  • Do not manually push to gh-pages - CI owns that branch
  • Public repo - never commit credentials, tokens, or new tracking IDs

Prose Typography House Style

Follow Bhargav’s authentic personal writing habits across all blog posts and authored Markdown pages:

  • Sentence-level dash: Always use spaced ASCII hyphen ( - ). Never use em dashes (—), unspaced hyphens as dashes (word-word), or en dashes (–).
  • Numeric and date ranges: Use unspaced ASCII hyphen without spaces (e.g., 2015-2018, 10-20 km, 40-70%, ₹10-20).
  • Compound terms: Use unspaced ASCII hyphen (e.g., U.S.-China, Smoot-Hawley, wife-husband).
  • Ellipsis: Use three ASCII periods (...), not the Unicode ellipsis character (…).
  • Lists and bullets: Use standard Markdown list markers (- item). Avoid Unicode bullets (•, ▪, ●).
  • Emoji and decorative symbols: Keep prose clean. Avoid corporate emoji lists (✅, ❌, 🚀) and decorative framework emojis.
  • Quotations and Multilingual Text: Preserve exact quotations and all Indic script text (Hindi, Odia, Sanskrit, Telugu, Bengali) without modification.
  • Code, URLs, and Syntax: Never modify code blocks, terminal illustrations, HTML tags, front matter, or URLs.

Owner

D K Bhargav Achary - sole maintainer.