javagrant.com

Personal website deployed via GitHub Pages from docs/.

Structure

docs/              — GitHub Pages root (published site)
  index.html       — main CV-as-Wikipedia-page
  style.css        — site styles
  CNAME            — custom domain config
  assets/          — images, gifs, pdfs
  contact/         — contact page
  desires/         — wishlist / book list
  library/         — audiobook library
  notes/           — assorted notes
  phd-research/    — PhD research info & participate page
  tools/           — web tools (bookbinder, tracery, etc.)
drafts/            — unpublished blog posts & recommendations (markdown)
scripts/           — utility scripts
  set_external_links.py
  main.js          — vowel-detection benchmark

Deploy

Push to master. GitHub Pages serves docs/ at https://javagrant.com.

Local preview

Root-absolute paths (/style.css, /assets/...) only resolve when served from a root, not via file://. Run from the repo root:

python3 -m http.server --directory docs 8000
# open http://localhost:8000/

Checks before push

• External links: python3 scripts/check_links.py — verifies every http(s) link in docs/ is reachable (exits non-zero on breakage; skips bot-blocking hosts like LinkedIn/ResearchGate).
• External-link attributes: python3 scripts/set_external_links.py — adds target="_blank" and rel="noopener noreferrer" to external links in docs/index.html.