# tds2k5/blogport architecture

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

- Interactive diagram: https://gitdiagram.com/tds2k5/blogport
- Repository: https://github.com/tds2k5/blogport

## Overview

blogport is a Hugo-based personal blog and portfolio site, with posts, home-page configuration, terminal-command content, and browser-side theme behavior. The likely user journey is browsing the published pages; the tree also shows authoring content and configuring home-page sections and commands. The README is only a title, and no Hugo templates or build invocation were sampled, so connections from content/configuration to generated pages are omitted rather than assumed.

Main entry points: [`public/js/theme-scheme.js`](https://github.com/tds2k5/blogport/blob/main/public/js/theme-scheme.js) (Theme scheme), [`public/index.html`](https://github.com/tds2k5/blogport/blob/main/public/index.html) (Published pages)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_content["Blog content"]
  node_blog_posts["Blog posts"]
  node_knowledge_posts["Knowledge posts"]
  node_customization_posts["Customization guides"]
  node_reference_posts["Reference posts"]
  node_start_posts["Getting started"]
end

subgraph group_site_config["Site configuration"]
  node_home_data["Home-page data"]
  node_terminal_data["Terminal commands"]
  node_sidebar_data["Sidebar data<br/>[sidebar.yaml]"]
  node_hugo_config["Hugo configuration<br/>[hugo.yaml]"]
end

subgraph group_browser["Browser behavior"]
  node_alpine_runtime["Alpine runtime<br/>[main.js]"]
  node_theme_scheme["Theme scheme<br/>[theme-scheme.js]"]
end

subgraph group_published["Published site"]
  node_published_pages["Published pages<br/>[index.html]"]
  node_published_posts["Published posts"]
  node_published_assets["Published assets<br/>[main.css]"]
end

node_visitor(("Site visitor"))
node_browser_environment(("Browser environment"))

node_theme_scheme -->|"reads preferences, updates theme"| node_browser_environment
node_visitor -.->|"views"| node_published_pages

click node_blog_posts "https://github.com/tds2k5/blogport/tree/main/content/posts"
click node_knowledge_posts "https://github.com/tds2k5/blogport/tree/main/posts/content-model"
click node_customization_posts "https://github.com/tds2k5/blogport/tree/main/posts/customization"
click node_reference_posts "https://github.com/tds2k5/blogport/tree/main/posts/reference"
click node_start_posts "https://github.com/tds2k5/blogport/tree/main/posts/start"
click node_home_data "https://github.com/tds2k5/blogport/tree/main/data/home"
click node_terminal_data "https://github.com/tds2k5/blogport/tree/main/data/terminal"
click node_sidebar_data "https://github.com/tds2k5/blogport/blob/main/data/sidebar.yaml"
click node_hugo_config "https://github.com/tds2k5/blogport/blob/main/hugo.yaml"
click node_alpine_runtime "https://github.com/tds2k5/blogport/blob/main/public/js/main.js"
click node_theme_scheme "https://github.com/tds2k5/blogport/blob/main/public/js/theme-scheme.js"
click node_published_pages "https://github.com/tds2k5/blogport/blob/main/public/index.html"
click node_published_posts "https://github.com/tds2k5/blogport/tree/main/public/posts"
click node_published_assets "https://github.com/tds2k5/blogport/blob/main/public/css/main.css"

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_blog_posts,node_knowledge_posts,node_customization_posts,node_reference_posts,node_start_posts,node_browser_environment toneBlue
class node_home_data,node_terminal_data,node_sidebar_data,node_hugo_config toneAmber
class node_alpine_runtime,node_theme_scheme toneMint
class node_published_pages,node_published_posts,node_published_assets toneRose
class node_visitor toneIndigo
```

## Components

### Blog content

- [Blog posts](https://github.com/tds2k5/blogport/tree/main/content/posts): `content/posts`
- [Knowledge posts](https://github.com/tds2k5/blogport/tree/main/posts/content-model): `posts/content-model`
- [Customization guides](https://github.com/tds2k5/blogport/tree/main/posts/customization): `posts/customization`
- [Reference posts](https://github.com/tds2k5/blogport/tree/main/posts/reference): `posts/reference`
- [Getting started](https://github.com/tds2k5/blogport/tree/main/posts/start): `posts/start`

### Site configuration

- [Home-page data](https://github.com/tds2k5/blogport/tree/main/data/home): `data/home`
- [Terminal commands](https://github.com/tds2k5/blogport/tree/main/data/terminal): `data/terminal`
- [Sidebar data](https://github.com/tds2k5/blogport/blob/main/data/sidebar.yaml): `data/sidebar.yaml`
- [Hugo configuration](https://github.com/tds2k5/blogport/blob/main/hugo.yaml): `hugo.yaml`

### Browser behavior

- [Alpine runtime](https://github.com/tds2k5/blogport/blob/main/public/js/main.js): `public/js/main.js`
- [Theme scheme](https://github.com/tds2k5/blogport/blob/main/public/js/theme-scheme.js): `public/js/theme-scheme.js`

### Published site

- [Published pages](https://github.com/tds2k5/blogport/blob/main/public/index.html): `public/index.html`
- [Published posts](https://github.com/tds2k5/blogport/tree/main/public/posts): `public/posts`
- [Published assets](https://github.com/tds2k5/blogport/blob/main/public/css/main.css): `public/css/main.css`

### Other components

- **Site visitor**
- **Browser environment**

## Connections

- Theme scheme → Browser environment: reads preferences, updates theme (evidence: `public/js/theme-scheme.js`)
- Site visitor → Published pages: views
