# wcowin/zensical-chinese-tutorial architecture

> Architecture diagram of the GitHub repository wcowin/zensical-chinese-tutorial, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-28). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/wcowin/zensical-chinese-tutorial
- Repository: https://github.com/wcowin/zensical-chinese-tutorial

## Overview

This repository is a Chinese-language Zensical tutorial site, not the implementation of the Zensical runtime. Its main reader journey is from getting-started guidance through configuration and content features to deployment; the README and tree also identify distinct plugin and advanced-topic branches. The graph represents documented guidance, not runtime calls. Unsampled page contents limit claims about links between individual topics.

Main entry points: [`docs/getting-started/quick-start.md`](https://github.com/wcowin/zensical-chinese-tutorial/blob/main/docs/getting-started/quick-start.md) (Quick start), [`docs/blog/deployment/github-pages.md`](https://github.com/wcowin/zensical-chinese-tutorial/blob/main/docs/blog/deployment/github-pages.md) (GitHub Pages guide), [`docs/blog/deployment/netlify.md`](https://github.com/wcowin/zensical-chinese-tutorial/blob/main/docs/blog/deployment/netlify.md) (Netlify guide), [`docs/blog/deployment/gitlab-pages.md`](https://github.com/wcowin/zensical-chinese-tutorial/blob/main/docs/blog/deployment/gitlab-pages.md) (GitLab Pages guide)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_onboarding["Getting started"]
  node_quickstart["Quick start<br/>[quick-start.md]"]
  node_migration["Migration<br/>[migration.md]"]
end

subgraph group_authoring["Site authoring"]
  node_configuration["Configuration<br/>[configuration.md]"]
  node_theme["Theme customization"]
  node_markdown["Markdown extensions"]
end

subgraph group_plugins["Plugins"]
  node_blog["Blog plugin<br/>[blog.md]"]
  node_search["Search plugin<br/>[search.md]"]
  node_tags["Tags plugin<br/>[tags.md]"]
  node_rss["RSS plugin<br/>[rss.md]"]
end

subgraph group_advanced["Advanced topics"]
  node_performance["Performance<br/>[performance.md]"]
  node_seo["SEO<br/>[seo.md]"]
  node_i18n["Internationalization<br/>[i18n.md]"]
  node_comments["Comment systems<br/>[comment-system.md]"]
end

subgraph group_deployment["Deployment"]
  node_githubguide["GitHub Pages guide<br/>[github-pages.md]"]
  node_netlifyguide["Netlify guide<br/>[netlify.md]"]
  node_gitlabguide["GitLab Pages guide<br/>[gitlab-pages.md]"]
  node_selfhostguide["Self-hosting guide<br/>[self-hosted.md]"]
end

node_reader(("Reader"))
node_overview["Tutorial overview<br/>[index.md]"]
node_cli["Zensical CLI"]
node_hosting["Hosting provider"]

node_reader -->|"reads"| node_overview
node_reader -->|"follows"| node_quickstart
node_quickstart -->|"guides use"| node_cli
node_migration -->|"guides migration"| node_cli
node_reader -->|"learns configuration"| node_configuration
node_reader -->|"learns customization"| node_theme
node_reader -->|"learns authoring"| node_markdown
node_reader -->|"learns plugins"| node_blog
node_reader -->|"learns plugins"| node_search
node_reader -->|"learns plugins"| node_tags
node_reader -->|"learns plugins"| node_rss
node_reader -->|"reads guidance"| node_performance
node_reader -->|"reads guidance"| node_seo
node_reader -->|"reads guidance"| node_i18n
node_reader -->|"reads guidance"| node_comments
node_reader -->|"follows deployment"| node_githubguide
node_reader -->|"follows deployment"| node_netlifyguide
node_reader -->|"follows deployment"| node_gitlabguide
node_reader -->|"follows deployment"| node_selfhostguide
node_githubguide -->|"explains deployment"| node_hosting
node_netlifyguide -->|"explains deployment"| node_hosting
node_gitlabguide -->|"explains deployment"| node_hosting
node_selfhostguide -->|"explains deployment"| node_hosting

click node_overview "https://github.com/wcowin/zensical-chinese-tutorial/blob/main/docs/index.md"
click node_quickstart "https://github.com/wcowin/zensical-chinese-tutorial/blob/main/docs/getting-started/quick-start.md"
click node_migration "https://github.com/wcowin/zensical-chinese-tutorial/blob/main/docs/getting-started/migration.md"
click node_configuration "https://github.com/wcowin/zensical-chinese-tutorial/blob/main/docs/tutorials/configuration.md"
click node_theme "https://github.com/wcowin/zensical-chinese-tutorial/blob/main/docs/tutorials/theme-customization.md"
click node_markdown "https://github.com/wcowin/zensical-chinese-tutorial/blob/main/docs/tutorials/markdown-extensions.md"
click node_blog "https://github.com/wcowin/zensical-chinese-tutorial/blob/main/docs/blog/plugins/blog.md"
click node_search "https://github.com/wcowin/zensical-chinese-tutorial/blob/main/docs/blog/plugins/search.md"
click node_tags "https://github.com/wcowin/zensical-chinese-tutorial/blob/main/docs/blog/plugins/tags.md"
click node_rss "https://github.com/wcowin/zensical-chinese-tutorial/blob/main/docs/blog/plugins/rss.md"
click node_performance "https://github.com/wcowin/zensical-chinese-tutorial/blob/main/docs/blog/advanced/performance.md"
click node_seo "https://github.com/wcowin/zensical-chinese-tutorial/blob/main/docs/blog/advanced/seo.md"
click node_i18n "https://github.com/wcowin/zensical-chinese-tutorial/blob/main/docs/blog/advanced/i18n.md"
click node_comments "https://github.com/wcowin/zensical-chinese-tutorial/blob/main/docs/blog/advanced/comment-system.md"
click node_githubguide "https://github.com/wcowin/zensical-chinese-tutorial/blob/main/docs/blog/deployment/github-pages.md"
click node_netlifyguide "https://github.com/wcowin/zensical-chinese-tutorial/blob/main/docs/blog/deployment/netlify.md"
click node_gitlabguide "https://github.com/wcowin/zensical-chinese-tutorial/blob/main/docs/blog/deployment/gitlab-pages.md"
click node_selfhostguide "https://github.com/wcowin/zensical-chinese-tutorial/blob/main/docs/blog/deployment/self-hosted.md"

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_quickstart,node_migration,node_overview toneBlue
class node_configuration,node_theme,node_markdown toneAmber
class node_blog,node_search,node_tags,node_rss toneMint
class node_performance,node_seo,node_i18n,node_comments toneRose
class node_githubguide,node_netlifyguide,node_gitlabguide,node_selfhostguide,node_reader,node_cli,node_hosting toneIndigo
```

## Components

### Getting started

- [Quick start](https://github.com/wcowin/zensical-chinese-tutorial/blob/main/docs/getting-started/quick-start.md): `docs/getting-started/quick-start.md`
- [Migration](https://github.com/wcowin/zensical-chinese-tutorial/blob/main/docs/getting-started/migration.md): `docs/getting-started/migration.md`

### Site authoring

- [Configuration](https://github.com/wcowin/zensical-chinese-tutorial/blob/main/docs/tutorials/configuration.md): `docs/tutorials/configuration.md`
- [Theme customization](https://github.com/wcowin/zensical-chinese-tutorial/blob/main/docs/tutorials/theme-customization.md): `docs/tutorials/theme-customization.md`
- [Markdown extensions](https://github.com/wcowin/zensical-chinese-tutorial/blob/main/docs/tutorials/markdown-extensions.md): `docs/tutorials/markdown-extensions.md`

### Plugins

- [Blog plugin](https://github.com/wcowin/zensical-chinese-tutorial/blob/main/docs/blog/plugins/blog.md): `docs/blog/plugins/blog.md`
- [Search plugin](https://github.com/wcowin/zensical-chinese-tutorial/blob/main/docs/blog/plugins/search.md): `docs/blog/plugins/search.md`
- [Tags plugin](https://github.com/wcowin/zensical-chinese-tutorial/blob/main/docs/blog/plugins/tags.md): `docs/blog/plugins/tags.md`
- [RSS plugin](https://github.com/wcowin/zensical-chinese-tutorial/blob/main/docs/blog/plugins/rss.md): `docs/blog/plugins/rss.md`

### Advanced topics

- [Performance](https://github.com/wcowin/zensical-chinese-tutorial/blob/main/docs/blog/advanced/performance.md): `docs/blog/advanced/performance.md`
- [SEO](https://github.com/wcowin/zensical-chinese-tutorial/blob/main/docs/blog/advanced/seo.md): `docs/blog/advanced/seo.md`
- [Internationalization](https://github.com/wcowin/zensical-chinese-tutorial/blob/main/docs/blog/advanced/i18n.md): `docs/blog/advanced/i18n.md`
- [Comment systems](https://github.com/wcowin/zensical-chinese-tutorial/blob/main/docs/blog/advanced/comment-system.md): `docs/blog/advanced/comment-system.md`

### Deployment

- [GitHub Pages guide](https://github.com/wcowin/zensical-chinese-tutorial/blob/main/docs/blog/deployment/github-pages.md): `docs/blog/deployment/github-pages.md`
- [Netlify guide](https://github.com/wcowin/zensical-chinese-tutorial/blob/main/docs/blog/deployment/netlify.md): `docs/blog/deployment/netlify.md`
- [GitLab Pages guide](https://github.com/wcowin/zensical-chinese-tutorial/blob/main/docs/blog/deployment/gitlab-pages.md): `docs/blog/deployment/gitlab-pages.md`
- [Self-hosting guide](https://github.com/wcowin/zensical-chinese-tutorial/blob/main/docs/blog/deployment/self-hosted.md): `docs/blog/deployment/self-hosted.md`

### Other components

- **Reader**
- [Tutorial overview](https://github.com/wcowin/zensical-chinese-tutorial/blob/main/docs/index.md): `docs/index.md`
- **Zensical CLI**
- **Hosting provider**

## Connections

- Reader → Tutorial overview: reads
- Reader → Quick start: follows
- Quick start → Zensical CLI: guides use
- Migration → Zensical CLI: guides migration
- Reader → Configuration: learns configuration
- Reader → Theme customization: learns customization
- Reader → Markdown extensions: learns authoring
- Reader → Blog plugin: learns plugins
- Reader → Search plugin: learns plugins
- Reader → Tags plugin: learns plugins
- Reader → RSS plugin: learns plugins
- Reader → Performance: reads guidance
- Reader → SEO: reads guidance
- Reader → Internationalization: reads guidance
- Reader → Comment systems: reads guidance
- Reader → GitHub Pages guide: follows deployment
- Reader → Netlify guide: follows deployment
- Reader → GitLab Pages guide: follows deployment
- Reader → Self-hosting guide: follows deployment
- GitHub Pages guide → Hosting provider: explains deployment
- Netlify guide → Hosting provider: explains deployment
- GitLab Pages guide → Hosting provider: explains deployment
- Self-hosting guide → Hosting provider: explains deployment