Vatsal Sanjay's Personal Website

The personal website for Vatsal Sanjay, hosted at comphy-lab.org/vatsalsy, built with Jekyll. If you are looking for the website of the Computational Multiphase Physics Lab, check out comphy-lab.org or github.

Directory Structure

.
├── _config.yml              # Site configuration
├── _layouts                # Page templates
│   ├── default.html       # Base layout
├── .github                # GitHub templates and configurations
│   ├── ISSUE_TEMPLATE    # Issue templates
│   └── PULL_REQUEST_TEMPLATE.md # PR template
├── assets                 # Static files
│   ├── css               # Stylesheets
│   ├── favicon           # Site favicon
│   ├── images            # Image files
│   ├── js                # JavaScript files
│   └── logos             # Logo files
├── about.md               # About page (redirects to /#about)
├── aboutVatsal.md         # Content for the About section (loaded via JavaScript)
├── contact.md             # Contact page (redirects to comphy-lab.org/join)
├── index.html             # Homepage
├── phd-thesis.md          # PhD Thesis page (redirects to comphy-lab.org/research#thesis)
├── research-interests.md  # Research interests page (redirects to comphy-lab.org/research)
├── research-interest.md   # Redirect to comphy-lab.org/research
├── talks.md               # Talks page (redirects to comphy-lab.org/research)
├── Gemfile               # Ruby dependencies
└── _site                 # Generated site (not tracked in git)

Part A: Front-End Documentation

Local Development

1. Prerequisites

   • Ruby (version 2.5.0 or higher)
   • Bundler (gem install bundler)

2. Install Dependencies

   bundle install

3. Run Local Server

   bundle exec jekyll serve

   • Visit http://localhost:4000 in the browser
   • Changes in source files trigger automatic rebuilds

4. Deployment

   • Typically managed via GitHub Pages when merged/pushed to the main branch
   • Local testing is recommended before committing changes

Content Management

About Page & Content

• about.md: Redirects to the About section on the homepage (/#about)
• aboutVatsal.md: Contains the About section content loaded via JavaScript on the homepage
• The main.js file fetches and renders aboutVatsal.md in the #about-content element

IMPORTANT: When updating aboutVatsal.md, you must also update the fallback content in about.md (lines 15-37) to keep them synchronized. The fallback content is displayed when JavaScript is disabled.

Research Pages

• research-interests.md: Redirects to comphy-lab.org/research
• research-interest.md: Redirects to comphy-lab.org/research
• phd-thesis.md: Redirects to comphy-lab.org/research#thesis
• talks.md: Redirects to comphy-lab.org/research

Contact Page

• contact.md: Redirects to comphy-lab.org/join

Adding or Editing Team

See: comphy-lab.org/team and to edit, see: github

Research Papers

See: comphy-lab.org/research and to edit, see: github

Part B: Back-End Documentation

Configuration and Layouts

• _config.yml: Site-wide settings, collections, build options
• Layout Templates in _layouts/
• Partial Includes in _includes/
• Assets in assets/

Design Elements

• Color Scheme
  • Gradient text (Red to Blue) for lab name
  • Warm orange tint + blur for header
• Typography
  • Libre Baskerville, Open Sans
  • Gradients for emphasis
• Favicon
  • Located in /assets/favicon/
  • Multiple sizes for different devices and browsers
  • Generated from CoMPhy Lab logo

Fonts and Icons Attribution

• Academicons 1.7.0 (SIL OFL 1.1, MIT)
• Font Awesome
• Fontello (Various licenses)
• Libre Baskerville (SIL Open Font License)
• Open Sans (Apache License 2.0)

Contributing Guidelines

Issue Templates

The repository includes several issue templates to streamline the process of reporting problems or requesting changes:

1. Bug Report: Use this template to report website issues, broken links, or display problems
2. Add Team Member: Template for requesting addition of new lab members with their details
3. Add Publication: Template for adding new research publications with metadata

To create a new issue:

1. Click one of the template links above, or
2. Go to the Issues tab in GitHub
3. Click "New Issue"
4. Choose the appropriate template
5. Fill in the required information
6. Submit the issue

Pull Request Template

When submitting changes, use the provided PR template which includes:

• Description of changes
• Type of change (bug fix, feature, content update, etc.)
• Testing checklist
• Related issues
• Screenshots (if applicable)

To submit a PR:

1. Fork the repository
2. Create a new branch for your changes
3. Make and test your changes locally
4. Create a PR using the template
5. Link any related issues
6. Wait for review