bhargavachary.github.io — Claude Context

bhargavachary.github.io — Claude Context

Personal website and blog — https://bhargavachary.in Jekyll site using bulma-clean-theme (GitHub Pages compatible).

Stack

  • Jekyll + GitHub Pages (Ruby — no conda/Python env needed)
  • Theme: chrisrhymes/bulma-clean-theme@v0.14.0 (remote theme via remote_theme in _config.yml)
  • Analytics: Google Analytics G-TFVWELSZ9W
  • Comments: Disqus (bhargavacharyin)
  • Deploy: GitHub Actions → .github/workflows/jekyll.yml (triggers on push to master)

Structure

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

Key Rules

  • Posts: _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 testing locally first
  • Optimize images before committing: bash scripts/optimize-images.sh
  • Do not commit a macOS-generated Gemfile.lock - it’s platform-specific and will break CI
  • Public repo - never commit credentials, tokens, or new tracking IDs

Prose Typography House Style

  • 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.

Local Dev

bundle install
bundle exec jekyll serve
# open http://localhost:4000

Deploy

Push to master → GitHub Actions builds and deploys automatically. Do not manually push to gh-pages - CI owns that branch.