# conanzhangtech/mksite architecture

> Architecture diagram of the GitHub repository conanzhangtech/mksite, 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/conanzhangtech/mksite
- Repository: https://github.com/conanzhangtech/mksite

## Overview

mksite is a Hugo theme that turns Markdown content into a portfolio, research, articles, documentation, résumé, and product pages. The principal workflow is an author creating structured content, Hugo rendering it with the theme, and visitors receiving a static site. The README documents the feature set but no source excerpts were supplied, so internal calls and implementation-level links cannot be verified; the graph shows only documented relationships.

Main entry points: [`starter/content`](https://github.com/conanzhangtech/mksite/tree/main/starter/content) (Markdown content), [`archetypes`](https://github.com/conanzhangtech/mksite/tree/main/archetypes) (Content archetypes), [`layouts`](https://github.com/conanzhangtech/mksite/tree/main/layouts) (Theme layouts)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_content["Content authoring"]
  node_markdown["Markdown content"]
  node_archetypes["Content archetypes"]
end

subgraph group_rendering["Hugo rendering"]
  node_layouts["Theme layouts"]
end

subgraph group_features["Site features"]
  node_projects["Project pages"]
  node_research["Research pages"]
  node_articles["Article pages"]
  node_portfolio["Portfolio page"]
  node_resume["Résumé page"]
  node_docs["Docs mode"]
  node_search["Client search<br/>[search.html]"]
  node_pdf["PDF reader<br/>[pdf.html]"]
end

subgraph group_presentation["Presentation"]
  node_appearance["Theme appearance"]
  node_static_site["Generated website"]
end

node_author(("Site author"))
node_hugo["Hugo"]
node_visitor(("Site visitor"))

node_author -->|"writes"| node_markdown
node_archetypes -->|"scaffolds"| node_markdown
node_markdown -->|"provides content"| node_hugo
node_hugo -->|"renders with"| node_layouts
node_hugo -->|"generates"| node_static_site
node_visitor -.->|"views"| node_static_site

click node_markdown "https://github.com/conanzhangtech/mksite/tree/main/starter/content"
click node_archetypes "https://github.com/conanzhangtech/mksite/tree/main/archetypes"
click node_layouts "https://github.com/conanzhangtech/mksite/tree/main/layouts"
click node_projects "https://github.com/conanzhangtech/mksite/tree/main/layouts/projects"
click node_research "https://github.com/conanzhangtech/mksite/tree/main/layouts/research"
click node_articles "https://github.com/conanzhangtech/mksite/tree/main/layouts/articles"
click node_portfolio "https://github.com/conanzhangtech/mksite/tree/main/layouts/portfolio"
click node_resume "https://github.com/conanzhangtech/mksite/tree/main/layouts/resume"
click node_docs "https://github.com/conanzhangtech/mksite/tree/main/layouts/docs"
click node_search "https://github.com/conanzhangtech/mksite/blob/main/layouts/_partials/search.html"
click node_pdf "https://github.com/conanzhangtech/mksite/blob/main/layouts/_partials/pdf.html"
click node_appearance "https://github.com/conanzhangtech/mksite/tree/main/assets"

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_markdown,node_archetypes toneBlue
class node_layouts toneAmber
class node_projects,node_research,node_articles,node_portfolio,node_resume,node_docs,node_search,node_pdf toneMint
class node_appearance,node_static_site toneRose
class node_author,node_hugo,node_visitor toneIndigo
```

## Components

### Content authoring

- [Markdown content](https://github.com/conanzhangtech/mksite/tree/main/starter/content): `starter/content`
- [Content archetypes](https://github.com/conanzhangtech/mksite/tree/main/archetypes): `archetypes`

### Hugo rendering

- [Theme layouts](https://github.com/conanzhangtech/mksite/tree/main/layouts): `layouts`

### Site features

- [Project pages](https://github.com/conanzhangtech/mksite/tree/main/layouts/projects): `layouts/projects`
- [Research pages](https://github.com/conanzhangtech/mksite/tree/main/layouts/research): `layouts/research`
- [Article pages](https://github.com/conanzhangtech/mksite/tree/main/layouts/articles): `layouts/articles`
- [Portfolio page](https://github.com/conanzhangtech/mksite/tree/main/layouts/portfolio): `layouts/portfolio`
- [Résumé page](https://github.com/conanzhangtech/mksite/tree/main/layouts/resume): `layouts/resume`
- [Docs mode](https://github.com/conanzhangtech/mksite/tree/main/layouts/docs): `layouts/docs`
- [Client search](https://github.com/conanzhangtech/mksite/blob/main/layouts/_partials/search.html): `layouts/_partials/search.html`
- [PDF reader](https://github.com/conanzhangtech/mksite/blob/main/layouts/_partials/pdf.html): `layouts/_partials/pdf.html`

### Presentation

- [Theme appearance](https://github.com/conanzhangtech/mksite/tree/main/assets): `assets`
- **Generated website**

### Other components

- **Site author**
- **Hugo**
- **Site visitor**

## Connections

- Site author → Markdown content: writes (evidence: `README.md`)
- Content archetypes → Markdown content: scaffolds (evidence: `README.md`)
- Markdown content → Hugo: provides content (evidence: `README.md`)
- Hugo → Theme layouts: renders with (evidence: `README.md`)
- Hugo → Generated website: generates (evidence: `README.md`)
- Site visitor → Generated website: views
