# sisayie/sisayie.github.io architecture

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

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

## Overview

Academic Pages is a Jekyll template for publishing an academic website. An author configures the site and adds content; Jekyll renders the template into pages, with optional scripts that generate publication and talk entries and a separate talk-location map workflow. The graph preserves the main content collections, presentation layer, generators, and map-clustering capability. Rendering relationships are only documented at a high level in the README; unsampled template wiring is not asserted.

Main entry points: [`talkmap.py`](https://github.com/sisayie/sisayie.github.io/blob/master/talkmap.py) (Talk Map Generator), [`_publications`](https://github.com/sisayie/sisayie.github.io/tree/master/_publications) (Publications), [`_talks`](https://github.com/sisayie/sisayie.github.io/tree/master/_talks) (Talks), [`_config.yml`](https://github.com/sisayie/sisayie.github.io/blob/master/_config.yml) (Site Configuration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_site["Site Content"]
  node_config["Site Configuration<br/>[_config.yml]"]
  node_data[("Site Data")]
  node_pages["Pages"]
  node_posts["Posts"]
  node_publications["Publications"]
  node_talks["Talks"]
  node_portfolio["Portfolio"]
end

subgraph group_presentation["Presentation"]
  node_layouts["Page Layouts"]
  node_includes["Template Includes"]
  node_styles["Stylesheets"]
  node_scripts["Site Scripts"]
  node_siteoutput["Rendered Website"]
end

subgraph group_generators["Content Generation"]
  node_pubgen["Publication Generator<br/>[publications.py]"]
  node_bibgen["BibTeX Generator<br/>[pubsFromBib.py]"]
  node_talkgen["Talk Generator<br/>[talks.py]"]
end

subgraph group_mapping["Talk Mapping"]
  node_mapgen["Talk Map Generator<br/>[talkmap.py]"]
  node_geocoder["Geocoding Service"]
  node_getorg["Map Output Library"]
  node_locations["Map Locations Data<br/>[org-locations.js]"]
  node_clusterdev["Cluster Plugin Source"]
  node_clusterbuilt["Cluster Plugin"]
end

node_author(("Site Author"))

node_author -->|"configures"| node_config
node_author -->|"adds content"| node_pages
node_author -->|"adds content"| node_posts
node_pubgen -->|"writes entries"| node_publications
node_bibgen -->|"writes entries"| node_publications
node_talkgen -->|"writes entries"| node_talks
node_mapgen -->|"reads talk files"| node_talks
node_mapgen -->|"geocodes places"| node_geocoder
node_mapgen -->|"creates map"| node_getorg
node_mapgen -->|"outputs map data"| node_locations
node_author -->|"previews locally"| node_siteoutput
node_config -.->|"configures rendering"| node_siteoutput
node_data -.->|"supplies site data"| node_siteoutput
node_pages -.->|"renders pages"| node_siteoutput
node_posts -.->|"renders posts"| node_siteoutput
node_publications -.->|"renders collection"| node_siteoutput
node_talks -.->|"renders collection"| node_siteoutput
node_portfolio -.->|"renders collection"| node_siteoutput
node_layouts -.->|"provides layouts"| node_siteoutput
node_includes -.->|"provides fragments"| node_siteoutput
node_styles -.->|"styles pages"| node_siteoutput
node_scripts -.->|"adds interactions"| node_siteoutput

click node_config "https://github.com/sisayie/sisayie.github.io/blob/master/_config.yml"
click node_data "https://github.com/sisayie/sisayie.github.io/tree/master/_data"
click node_pages "https://github.com/sisayie/sisayie.github.io/tree/master/_pages"
click node_posts "https://github.com/sisayie/sisayie.github.io/tree/master/_posts"
click node_publications "https://github.com/sisayie/sisayie.github.io/tree/master/_publications"
click node_talks "https://github.com/sisayie/sisayie.github.io/tree/master/_talks"
click node_portfolio "https://github.com/sisayie/sisayie.github.io/tree/master/_portfolio"
click node_layouts "https://github.com/sisayie/sisayie.github.io/tree/master/_layouts"
click node_includes "https://github.com/sisayie/sisayie.github.io/tree/master/_includes"
click node_styles "https://github.com/sisayie/sisayie.github.io/tree/master/assets/css"
click node_scripts "https://github.com/sisayie/sisayie.github.io/tree/master/assets/js"
click node_pubgen "https://github.com/sisayie/sisayie.github.io/blob/master/markdown_generator/publications.py"
click node_bibgen "https://github.com/sisayie/sisayie.github.io/blob/master/markdown_generator/pubsFromBib.py"
click node_talkgen "https://github.com/sisayie/sisayie.github.io/blob/master/markdown_generator/talks.py"
click node_mapgen "https://github.com/sisayie/sisayie.github.io/blob/master/talkmap.py"
click node_locations "https://github.com/sisayie/sisayie.github.io/blob/master/talkmap/org-locations.js"
click node_clusterdev "https://github.com/sisayie/sisayie.github.io/blob/master/talkmap/leaflet_dist/leaflet.markercluster-src.js"
click node_clusterbuilt "https://github.com/sisayie/sisayie.github.io/blob/master/talkmap/leaflet_dist/leaflet.markercluster.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_config,node_data,node_pages,node_posts,node_publications,node_talks,node_portfolio toneBlue
class node_layouts,node_includes,node_styles,node_scripts,node_siteoutput toneAmber
class node_pubgen,node_bibgen,node_talkgen toneMint
class node_mapgen,node_geocoder,node_getorg,node_locations,node_clusterdev,node_clusterbuilt toneRose
class node_author toneIndigo
```

## Components

### Site Content

- [Site Configuration](https://github.com/sisayie/sisayie.github.io/blob/master/_config.yml): `_config.yml`
- [Site Data](https://github.com/sisayie/sisayie.github.io/tree/master/_data): `_data`
- [Pages](https://github.com/sisayie/sisayie.github.io/tree/master/_pages): `_pages`
- [Posts](https://github.com/sisayie/sisayie.github.io/tree/master/_posts): `_posts`
- [Publications](https://github.com/sisayie/sisayie.github.io/tree/master/_publications): `_publications`
- [Talks](https://github.com/sisayie/sisayie.github.io/tree/master/_talks): `_talks`
- [Portfolio](https://github.com/sisayie/sisayie.github.io/tree/master/_portfolio): `_portfolio`

### Presentation

- [Page Layouts](https://github.com/sisayie/sisayie.github.io/tree/master/_layouts): `_layouts`
- [Template Includes](https://github.com/sisayie/sisayie.github.io/tree/master/_includes): `_includes`
- [Stylesheets](https://github.com/sisayie/sisayie.github.io/tree/master/assets/css): `assets/css`
- [Site Scripts](https://github.com/sisayie/sisayie.github.io/tree/master/assets/js): `assets/js`
- **Rendered Website**

### Content Generation

- [Publication Generator](https://github.com/sisayie/sisayie.github.io/blob/master/markdown_generator/publications.py): `markdown_generator/publications.py`
- [BibTeX Generator](https://github.com/sisayie/sisayie.github.io/blob/master/markdown_generator/pubsFromBib.py): `markdown_generator/pubsFromBib.py`
- [Talk Generator](https://github.com/sisayie/sisayie.github.io/blob/master/markdown_generator/talks.py): `markdown_generator/talks.py`

### Talk Mapping

- [Talk Map Generator](https://github.com/sisayie/sisayie.github.io/blob/master/talkmap.py): `talkmap.py`
- **Geocoding Service**
- **Map Output Library**
- [Map Locations Data](https://github.com/sisayie/sisayie.github.io/blob/master/talkmap/org-locations.js): `talkmap/org-locations.js`
- [Cluster Plugin Source](https://github.com/sisayie/sisayie.github.io/blob/master/talkmap/leaflet_dist/leaflet.markercluster-src.js): `talkmap/leaflet_dist/leaflet.markercluster-src.js`
- [Cluster Plugin](https://github.com/sisayie/sisayie.github.io/blob/master/talkmap/leaflet_dist/leaflet.markercluster.js): `talkmap/leaflet_dist/leaflet.markercluster.js`

### Other components

- **Site Author**

## Connections

- Site Author → Site Configuration: configures (evidence: `README.md`)
- Site Author → Pages: adds content (evidence: `README.md`)
- Site Author → Posts: adds content (evidence: `README.md`)
- Publication Generator → Publications: writes entries (evidence: `markdown_generator/publications.py`)
- BibTeX Generator → Publications: writes entries (evidence: `markdown_generator/pubsFromBib.py`)
- Talk Generator → Talks: writes entries (evidence: `markdown_generator/talks.py`)
- Talk Map Generator → Talks: reads talk files (evidence: `talkmap.py`)
- Talk Map Generator → Geocoding Service: geocodes places (evidence: `talkmap.py`)
- Talk Map Generator → Map Output Library: creates map (evidence: `talkmap.py`)
- Talk Map Generator → Map Locations Data: outputs map data (evidence: `talkmap.py`)
- Site Author → Rendered Website: previews locally (evidence: `README.md`)
- Site Configuration → Rendered Website: configures rendering
- Site Data → Rendered Website: supplies site data
- Pages → Rendered Website: renders pages
- Posts → Rendered Website: renders posts
- Publications → Rendered Website: renders collection
- Talks → Rendered Website: renders collection
- Portfolio → Rendered Website: renders collection
- Page Layouts → Rendered Website: provides layouts
- Template Includes → Rendered Website: provides fragments
- Stylesheets → Rendered Website: styles pages
- Site Scripts → Rendered Website: adds interactions
