Agent Notes for This Website

Agent Notes for This Website

This repository is Md Atik Enam’s AcademicPages/Jekyll personal website.

Main Editing Areas

  • Site-wide visual styling lives in _sass/_site-modern.scss.
  • Portfolio case-study styling lives in _sass/_case-study.scss.
  • Portfolio index page lives in _pages/portfolio.html.
  • Portfolio case studies live in _portfolio/.
  • Portfolio images live in images/portfolio/.
  • Navigation is controlled by _data/navigation.yml.

Local Build and Preview

Use the Windows command wrappers from the repository root:

.\scripts\build-local.cmd
.\scripts\serve-local.cmd

The local preview URL is:

http://127.0.0.1:4000/

This site uses a local Ruby gem install under local\bundle\ruby\3.3.0. The helper scripts set GEM_HOME, GEM_PATH, and JEKYLL_ENV=development before running Jekyll. The .cmd wrappers avoid PowerShell execution-policy blocks.

Important Local Preview Detail

_includes/base_path intentionally uses local, site-relative URLs in development. This keeps local CSS, JavaScript, thumbnails, and images visible before they are pushed to GitHub Pages. Production builds can still use site.url.

Verification Checklist

After changing content or styles:

.\scripts\build-local.cmd
Invoke-WebRequest -UseBasicParsing http://127.0.0.1:4000/portfolio/ | Select-Object -ExpandProperty StatusCode
git diff --check

Expected: Jekyll build succeeds, route returns 200, and git diff --check has no whitespace errors other than possible Windows line-ending warnings.

GitHub Pages Reminder

Local changes are not visible on https://md-atik-enam.github.io/ until they are committed and pushed to origin/master.