Website Update Notes

Website Update Notes

This note records the key decisions, implemented changes, and maintenance rules from the recent redesign of ZeyuGaoAi.github.io.

Current Positioning

  • Homepage positioning sentence:
    • Research Associate, University of Cambridge. Current research support from GE HealthCare.
  • Research identity:
    • Computational pathology
    • Multimodal AI
    • Whole-slide image analysis
    • Spatial omics / molecular prediction
    • Robust and clinically relevant pathology AI

What Was Cleaned Up

  • Removed placeholder template content that reduced credibility:
    • Teaching navigation entry
    • teaching placeholder pages
    • portfolio placeholder pages
  • Result:
    • top navigation is now focused on real content only
    • no fake or demo content should be reintroduced

Talks Maintenance Logic

  • Talks on the homepage should also be represented in _talks/ when they are real events.
  • Relevant event types to include:
    • invited talks
    • lectures
    • webinars
    • posters
    • flash talks
    • presentations
  • Current _talks/ archive has been expanded to cover homepage-reported activities from 2024-2026.
  • If a new talk appears in homepage news, also create a corresponding file in _talks/.

Homepage Structure

Homepage file:

  • _pages/about.md

Homepage style:

  • _sass/custom/_home.scss
  • imported from assets/css/main.scss

Current homepage sections:

  • Hero
  • Research Directions
  • Featured Publications
  • Selected Talks and Presentations
  • Recent Highlights
  • Background

Homepage Content Rules

  • The homepage should not read like a full CV pasted into one page.
  • Prefer concise, high-signal sections over long chronological text blocks.
  • Avoid self-promotional phrasing like:
    • A first-author ...
    • I proudly ...
    • This groundbreaking work ...
  • Publication descriptions should explain the method or contribution, not authorship status.
  • The homepage should surface:
    • strongest current research identity
    • best papers
    • selected recent talks
    • a short background summary
  • Featured Publications is a curated section, not a full list.
  • It should prioritize:
    • strongest representative work
    • papers that reflect current research direction
    • a mix of recent high-visibility work and foundational earlier first-author work
  • User preference from this session:
    • remove WWW 2026 HAAF from featured publications
    • include own key TMI, MedIA, and MICCAI papers
  • Current featured set includes:
    • CARE
    • PH2ST
    • SMMILe
    • TMI 2023
    • MedIA 2023
    • TMI 2022
    • MICCAI 2020
    • MICCAI 2021 (two papers)

If this section becomes too long later, reduce it to the best 6-8 items.

Current ordering rule:

  • order by year, newest to oldest

Current venue badge rule:

  • use local badge graphics rather than plain text pills
  • badge assets live in images/venue-badges/

Publications Page Logic

Publications page:

  • _pages/publications.html

Custom publication card include:

  • _includes/archive-publication-card.html

Publication page styles:

  • _sass/custom/_publications.scss
  • imported from assets/css/main.scss

The publications page is no longer intended to be a plain template list.

Current design goals:

  • card-based layout
  • clearer venue/year metadata
  • stronger visual hierarchy
  • action buttons such as Paper, Slides, BibTeX, Details
  • image-first presentation when a paper figure is available

Publication Image Logic

  • If a paper has a good figure / graphical abstract / representative main figure, use it as:
    • header.teaser
  • This is added in each publication markdown file.
  • Local paper figures live in:
    • images/papers/
  • Figure naming rule:
    • match the publication markdown filename stem whenever possible
    • examples:
      • TMI2023_MGTrans.md -> images/papers/TMI2023_MGTrans.png
      • MICCAI2024_PAMIL.md -> images/papers/MICCAI2024_PAMIL.png
  • If no figure is available yet:
    • publication cards fall back to a styled placeholder block using venue/year
  • This means missing images do not block page quality.

Current status:

  • all current publication entries now have a connected local teaser image
  • publication cards and single-paper pages should both show the same figure when header.teaser is present

When adding new paper images later:

  1. save the figure into images/papers/
  2. make the filename match the publication file stem if possible
  3. add or update:
    • header:
    • ` teaser: “papers/"`
  4. if an older image already exists, replacing the local file is often enough

Background Section Rule

  • Background should remain short and factual.
  • Supervisor names can include links.
  • Current linked advisors:
    • Chen Li
    • Deyu Meng
    • Xiangrong Zhang

What Not To Reintroduce

  • no placeholder template content
  • no empty nav entries
  • no generic portfolio demos
  • no long homepage news dump
  • no list-only publications page if card layout already exists
  • no repetitive self-labeling like first-author in homepage summaries
  • no external hotlinked paper figures when a local copy can be stored

Good Update Workflow

When updating the website later, use this order:

  1. Update content files first:
    • _pages/about.md
    • _talks/*.md
    • _publications/*.md
  2. If a new paper should appear strongly on the site:
    • decide whether it belongs in Featured Publications
    • add header.teaser if a representative figure exists
    • keep the publication filename human-readable using VenueYear_ShortName.md
  3. If a new talk is mentioned on the homepage:
    • add a corresponding _talks/ entry
  4. Only then refine style if needed
  5. Keep homepage curated rather than exhaustive
  6. Preserve old publication URLs when renaming files:
    • add permalink to the renamed markdown file
  7. Push with SSH if HTTPS push is unstable:
    • git push git@github.com:ZeyuGaoAi/ZeyuGaoAi.github.io.git master

Publication Naming Rule

  • Avoid generic filenames like:
    • BIBM2024.md
    • MICCAI2021_0.md
  • Prefer:
    • VenueYear_ShortName.md
  • Current examples:
    • BIBM2022_UBMA.md
    • BIBM2024_SDS.md
    • MICCAI2020_MinPointRCC.md
    • MICCAI2021_CHRNet.md
    • MICCAI2021_IBViT.md
    • MICCAI2024_PAMIL.md
    • TMI2022_GlobalLocalContrast.md
    • TMI2023_LeukemiaMIL.md
    • MedIA2023_MinPointMTL.md

When renaming existing publication files:

  1. rename the markdown file
  2. update the corresponding local figure filename if one exists
  3. add a permalink preserving the old /publications/.../ route
  4. verify the publication card and single-paper page still render correctly

Suggested Next Improvements

  • refine publication card layout after more teaser images are supplied
  • possibly reduce homepage featured publications count if the section becomes visually dense
  • improve SEO / social preview metadata later
  • unify title / bio wording in _config.yml with current homepage identity

Useful Files

  • Homepage content:
    • _pages/about.md
  • Homepage styles:
    • _sass/custom/_home.scss
  • Publications page:
    • _pages/publications.html
  • Publications card include:
    • _includes/archive-publication-card.html
  • Publications styles:
    • _sass/custom/_publications.scss
  • Talks archive:
    • _talks/
  • Publication entries:
    • _publications/

Maintenance Principle

The site should look like a curated academic research homepage, not a default Jekyll template and not a raw CV dump.