Project Guide

Overview

This repository contains the source for parasurama.github.io. It is a Jekyll site built with the Minimal Mistakes remote theme and the GitHub Pages gem set.

Structure

• index.md: homepage content, including research and teaching.
• _config.yml: site-wide Jekyll, theme, author, plugin, and build settings. Restart the local server after changing this file.
• _data/navigation.yml: links shown in the top navigation banner.
• _pages/: standalone pages included in the site build.
• _posts/: dated blog posts.
• _layouts/ and _includes/: reusable page templates and partials.
• _sass/ and assets/: styles, scripts, images, and other static assets.
• _papers/, _cv/, and _jmp/: PDFs and source files linked from the site.
• _projects/: project-specific pages and assets.
• _site/: generated site output. Do not edit it directly; Jekyll rebuilds it from the source files.

Serve Locally

The repository includes a Dockerfile, which is the recommended way to run the site without managing Ruby locally. From the repository root:

docker build -t parasurama-github-io-local .
docker run --rm -p 4000:4000 parasurama-github-io-local

Open http://127.0.0.1:4000/. Rebuild the image after changing source files.

Alternatively, install Ruby and Bundler, then install the locked dependencies:

bundle install

Start the development server:

bundle exec jekyll serve --livereload

Open http://127.0.0.1:4000/. Jekyll rebuilds content changes automatically in this mode. Restart the server after editing _config.yml.

To verify a production-style build without serving it:

bundle exec jekyll build

Editing Notes

• Edit source files, not generated files under _site/.
• Keep internal URLs root-relative when they should work across the whole site.
• Preserve unrelated changes in the working tree.
• Run bundle exec jekyll build after structural, configuration, layout, or navigation changes.