KDharmarajanDev.github.io

Static personal website for Karthik Dharmarajan.

Preview locally with any basic static server, for example:

python3 -m http.server

The site is now served from the repository root with plain HTML and CSS. Migration notes live in STATIC_SITE_MIGRATION_PLAN.md.

Blog

Create a dependency-free blog post with:

python3 scripts/new-post.py "Post title" --description "One-sentence summary."

See blog/README.md for the complete authoring and one-time Giscus setup workflow.

Pre-push check

Run this before pushing:

python3 scripts/check-site.py

Along with checking local links and blog scaffolding, it reports publication authors missing from author-links.js. Add authors who intentionally do not need a link to AUTHORS_WITHOUT_LINKS_ALLOWED in scripts/check-site.py.

GitHub stars

Publication star counts come from the checked-in github-stars-data.js snapshot, so the live site does not depend on GitHub, Shields.io, or a token pool. Refresh the snapshot when desired with:

python3 scripts/update-github-stars.py

The script works without authentication for this site's small repository list. Set GITHUB_TOKEN or GH_TOKEN to use a higher GitHub API rate limit. Refreshes are atomic: if any request fails, the last known snapshot remains unchanged.