# why-note/why-note.github.io architecture

> Architecture diagram of the GitHub repository why-note/why-note.github.io, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/why-note/why-note.github.io
- Repository: https://github.com/why-note/why-note.github.io

## Overview

This repository is a personal portfolio and writing website. Its visitor workflow is to browse the profile and academic portfolio, then open project, publication, blog, or life content; the life area also includes a dedicated reflection page. The tree shows separate data, page, layout, and interactive-page assets. The README documents the portfolio sections and Jekyll Markdown rendering, while sampled JavaScript confirms the life-room link and reflection timeline behavior. Most templates and page wiring were not sampled, so those relationships are omitted rather than inferred.

Main entry points: [`index.md`](https://github.com/why-note/why-note.github.io/blob/main/index.md) (Home page), [`_layouts`](https://github.com/why-note/why-note.github.io/tree/main/_layouts) (Page layouts), [`life/reflection/index.html`](https://github.com/why-note/why-note.github.io/blob/main/life/reflection/index.html) (Reflection page), [`pages/projects.md`](https://github.com/why-note/why-note.github.io/blob/main/pages/projects.md) (Projects page)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_portfolio["Portfolio"]
  node_home["Home page<br/>[index.md]"]
  node_profile["Profile data<br/>[profile.yml]"]
  node_education["Education<br/>[education.yml]"]
  node_honors["Honors<br/>[honors.yml]"]
  node_research["Research experience"]
  node_projects["Projects page<br/>[projects.md]"]
  node_publications["Publications page<br/>[publications.md]"]
  node_imagebar["Image bar data<br/>[image_bar.yml]"]
end

subgraph group_publishing["Writing"]
  node_blogpage["Blog page<br/>[blog.md]"]
  node_blogposts["Blog posts"]
  node_lifepage["Life landing<br/>[index.html]"]
  node_lifeposts["Life articles"]
end

subgraph group_site["Site presentation"]
  node_layouts["Page layouts"]
  node_includes["Shared includes"]
  node_theme["Theme switching<br/>[theme_toggle.js]"]
  node_scrollreveal["Scroll reveal"]
end

subgraph group_interactive["Life interactions"]
  node_reflection["Reflection page<br/>[index.html]"]
  node_roomlinks["Room navigation<br/>[script.js]"]
  node_timeline["Timeline tracking<br/>[script.js]"]
end

node_visitor(("Visitor"))

node_visitor -.->|"visits"| node_home
node_visitor -.->|"browses"| node_projects
node_visitor -.->|"browses"| node_publications
node_visitor -.->|"browses"| node_blogpage
node_visitor -.->|"browses"| node_lifepage
node_visitor -.->|"opens"| node_reflection
node_roomlinks -->|"links to"| node_reflection
node_timeline -->|"tracks scroll"| node_reflection
node_home -.->|"presents"| node_profile
node_home -.->|"presents"| node_education
node_home -.->|"presents"| node_honors
node_home -.->|"presents"| node_research
node_home -.->|"features"| node_imagebar
node_blogpage -.->|"lists"| node_blogposts
node_lifepage -.->|"lists"| node_lifeposts
node_home -.->|"renders with"| node_layouts
node_projects -.->|"renders with"| node_layouts
node_publications -.->|"renders with"| node_layouts
node_layouts -.->|"uses"| node_includes
node_theme -.->|"changes theme for"| node_visitor
node_scrollreveal -.->|"reveals content to"| node_visitor

click node_home "https://github.com/why-note/why-note.github.io/blob/main/index.md"
click node_profile "https://github.com/why-note/why-note.github.io/blob/main/_data/profile.yml"
click node_education "https://github.com/why-note/why-note.github.io/blob/main/_data/education.yml"
click node_honors "https://github.com/why-note/why-note.github.io/blob/main/_data/honors.yml"
click node_research "https://github.com/why-note/why-note.github.io/blob/main/_data/research_experience.yml"
click node_projects "https://github.com/why-note/why-note.github.io/blob/main/pages/projects.md"
click node_publications "https://github.com/why-note/why-note.github.io/blob/main/pages/publications.md"
click node_imagebar "https://github.com/why-note/why-note.github.io/blob/main/_data/image_bar.yml"
click node_blogpage "https://github.com/why-note/why-note.github.io/blob/main/pages/blog.md"
click node_blogposts "https://github.com/why-note/why-note.github.io/tree/main/_blog"
click node_lifepage "https://github.com/why-note/why-note.github.io/blob/main/life/index.html"
click node_lifeposts "https://github.com/why-note/why-note.github.io/tree/main/_life"
click node_reflection "https://github.com/why-note/why-note.github.io/blob/main/life/reflection/index.html"
click node_roomlinks "https://github.com/why-note/why-note.github.io/blob/main/life/script.js"
click node_timeline "https://github.com/why-note/why-note.github.io/blob/main/life/reflection/script.js"
click node_layouts "https://github.com/why-note/why-note.github.io/tree/main/_layouts"
click node_includes "https://github.com/why-note/why-note.github.io/tree/main/_includes"
click node_theme "https://github.com/why-note/why-note.github.io/blob/main/assets/js/theme_toggle.js"
click node_scrollreveal "https://github.com/why-note/why-note.github.io/blob/main/assets/js/AOS_scroll_reveal.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_home,node_profile,node_education,node_honors,node_research,node_projects,node_publications,node_imagebar toneBlue
class node_blogpage,node_blogposts,node_lifepage,node_lifeposts toneAmber
class node_layouts,node_includes,node_theme,node_scrollreveal toneMint
class node_reflection,node_roomlinks,node_timeline toneRose
class node_visitor toneIndigo
```

## Components

### Portfolio

- [Home page](https://github.com/why-note/why-note.github.io/blob/main/index.md): `index.md`
- [Profile data](https://github.com/why-note/why-note.github.io/blob/main/_data/profile.yml): `_data/profile.yml`
- [Education](https://github.com/why-note/why-note.github.io/blob/main/_data/education.yml): `_data/education.yml`
- [Honors](https://github.com/why-note/why-note.github.io/blob/main/_data/honors.yml): `_data/honors.yml`
- [Research experience](https://github.com/why-note/why-note.github.io/blob/main/_data/research_experience.yml): `_data/research_experience.yml`
- [Projects page](https://github.com/why-note/why-note.github.io/blob/main/pages/projects.md): `pages/projects.md`
- [Publications page](https://github.com/why-note/why-note.github.io/blob/main/pages/publications.md): `pages/publications.md`
- [Image bar data](https://github.com/why-note/why-note.github.io/blob/main/_data/image_bar.yml): `_data/image_bar.yml`

### Writing

- [Blog page](https://github.com/why-note/why-note.github.io/blob/main/pages/blog.md): `pages/blog.md`
- [Blog posts](https://github.com/why-note/why-note.github.io/tree/main/_blog): `_blog`
- [Life landing](https://github.com/why-note/why-note.github.io/blob/main/life/index.html): `life/index.html`
- [Life articles](https://github.com/why-note/why-note.github.io/tree/main/_life): `_life`

### Site presentation

- [Page layouts](https://github.com/why-note/why-note.github.io/tree/main/_layouts): `_layouts`
- [Shared includes](https://github.com/why-note/why-note.github.io/tree/main/_includes): `_includes`
- [Theme switching](https://github.com/why-note/why-note.github.io/blob/main/assets/js/theme_toggle.js): `assets/js/theme_toggle.js`
- [Scroll reveal](https://github.com/why-note/why-note.github.io/blob/main/assets/js/AOS_scroll_reveal.js): `assets/js/AOS_scroll_reveal.js`

### Life interactions

- [Reflection page](https://github.com/why-note/why-note.github.io/blob/main/life/reflection/index.html): `life/reflection/index.html`
- [Room navigation](https://github.com/why-note/why-note.github.io/blob/main/life/script.js): `life/script.js`
- [Timeline tracking](https://github.com/why-note/why-note.github.io/blob/main/life/reflection/script.js): `life/reflection/script.js`

### Other components

- **Visitor**

## Connections

- Visitor → Home page: visits
- Visitor → Projects page: browses
- Visitor → Publications page: browses
- Visitor → Blog page: browses
- Visitor → Life landing: browses
- Visitor → Reflection page: opens
- Room navigation → Reflection page: links to (evidence: `life/script.js`)
- Timeline tracking → Reflection page: tracks scroll (evidence: `life/reflection/script.js`)
- Home page → Profile data: presents
- Home page → Education: presents
- Home page → Honors: presents
- Home page → Research experience: presents
- Home page → Image bar data: features
- Blog page → Blog posts: lists
- Life landing → Life articles: lists
- Home page → Page layouts: renders with
- Projects page → Page layouts: renders with
- Publications page → Page layouts: renders with
- Page layouts → Shared includes: uses
- Theme switching → Visitor: changes theme for
- Scroll reveal → Visitor: reveals content to (evidence: `README.md`)
