# biaochenxuying/blog architecture

> Architecture diagram of the GitHub repository biaochenxuying/blog, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-04-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/biaochenxuying/blog
- Repository: https://github.com/biaochenxuying/blog

## Overview

##### Main Components
- Blog Content & Static Site Generators:
- “blog-gitbook”: Contains GitBook configuration, plugins, markdown pages, and an output “_book” directory. It represents one static site generation engine.
- “blog-vuepress”: Contains a similar blog structure using VuePress that leverages a “.vuepress” folder, custom components (e.g. comment.vue), configuration files, and build scripts.
- Supplementary Content Collections:
- “data-structure-and-algorithms”, “interview”, “resume”: These directories hold articles, tutorials, and resume details used to provide supporting content.
- Technical Project Examples & Prototypes:
- “typescript-in-action”: A multi-stage project (with “stage-0” to “stage-3”), illustrating migration and advanced TypeScript usage. It also includes prototypes and presentations (mindmap, ppt).
- Other subdirectories (e.g., “ts-react-app”, “ts-vue”, “ts-redux”, “ts-express”, “vue-employee-query”, etc.) represent sample applications that demonstrate practical usage of React, Vue, Node.js, Redux, and more.
- Build and Configuration Ecosystem:
- Numerous configuration files (webpack config files, Babel config files, tsconfig.json, .gitignore) indicate that each sample project is independently built and tested. This is an important “layer” in the architecture.

##### Relationships and Interactions
- Content Generation Pipelines:
- For GitBook: Markdown source files (found under “blog-gitbook/views” and others) are processed along with plugin configurations (under “blog-gitbook/_book/gitbook-plugin-…”) to create a static blog website.
- For VuePress: Source markdown and Vue components in “blog-vuepress/docs” are built using VuePress’s pipeline, with build scripts present in the “builds” folder.
- Build Process & Bundling:
- Content Integration:

##### Architectural Patterns & Design Principles
- Static Site Architecture: Both GitBook and VuePress follow a static site generation model. Emphasize the build pipeline (markdown → static HTML/CSS/JS).

##### Relevant Technologies & Frameworks
- Static Site Generators: GitBook, VuePress.
- Build Systems: webpack, Babel.
- Languages/Frameworks: JavaScript, TypeScript, React, Vue, Express.
- Testing & Configuration: jest (in “ts-base”), tsconfig, ESLint, etc.

## Diagram (Mermaid)

```mermaid
flowchart TD
    Portal["Blog Portal (README)"]:::portal

    subgraph "I. Blog Sites"
        direction TB
        GB["GitBook Blog"]:::blogSites
        VP["VuePress Blog"]:::blogSites
    end

    subgraph "II. Content Collections"
        direction TB
        DATA["Data Structures & Algorithms Articles"]:::content
        INT["Interview Guides"]:::content
        RES["Resume Content"]:::content
    end

    subgraph "III. Technical Samples/Prototypes"
        direction TB
        TSIA["TypeScript Project - Migration Stages & Prototypes"]:::tech
        SR["Sample React Application"]:::tech
        SE["Sample Express Application"]:::tech
        SV["Sample Vue Application"]:::tech
        SRX["Sample Redux Application"]:::tech
        SAR["Sample React (Alternate)"]:::tech
        VEmployee["Vue Employee Query Prototype"]:::tech
    end

    %% Portal links to Blog Sites & Content Collections & Tech Samples
    Portal -->|"links"| GB
    Portal -->|"links"| VP
    Portal -->|"links"| DATA
    Portal -->|"links"| INT
    Portal -->|"links"| RES
    Portal -->|"links"| TSIA

    %% Technical Samples internal structure
    TSIA -->|"contains"| SR
    TSIA -->|"contains"| SE
    TSIA -->|"contains"| SV
    TSIA -->|"contains"| SRX
    TSIA -->|"contains"| SAR
    TSIA -->|"contains"| VEmployee

    %% Build & Configuration Ecosystem for build processes in blog sites and tech samples
    GB --"build_process"--> Build1["Build & Config Layer"]:::build
    VP --"build_process"--> Build2["Build & Config Layer"]:::build
    TSIA --"build_test"--> Build3["Build & Config Layer"]:::build

    %% Click Events
    click GB "https://github.com/biaochenxuying/blog/tree/master/blog-gitbook"
    click VP "https://github.com/biaochenxuying/blog/tree/master/blog-vuepress"
    click DATA "https://github.com/biaochenxuying/blog/tree/master/data-structure-and-algorithms"
    click INT "https://github.com/biaochenxuying/blog/tree/master/interview"
    click RES "https://github.com/biaochenxuying/blog/tree/master/resume"
    click TSIA "https://github.com/biaochenxuying/blog/tree/master/typescript-in-action"
    click SR "https://github.com/biaochenxuying/blog/tree/master/typescript-in-action/sourcecode/ts-react-app"
    click SE "https://github.com/biaochenxuying/blog/tree/master/typescript-in-action/sourcecode/ts-express"
    click SV "https://github.com/biaochenxuying/blog/tree/master/typescript-in-action/sourcecode/ts-vue"
    click SRX "https://github.com/biaochenxuying/blog/tree/master/typescript-in-action/sourcecode/ts-redux"
    click SAR "https://github.com/biaochenxuying/blog/tree/master/typescript-in-action/sourcecode/ts-react"
    click VEmployee "https://github.com/biaochenxuying/blog/tree/master/typescript-in-action/sourcecode/vue-employee-query"

    %% Class Definitions
    classDef blogSites fill:#C1E1C1,stroke:#333,stroke-width:2px;
    classDef content fill:#C1D4E1,stroke:#333,stroke-width:2px;
    classDef tech fill:#FADBD8,stroke:#333,stroke-width:2px;
    classDef build fill:#D5DBDB,stroke:#333,stroke-width:2px;
    classDef portal fill:#F7DC6F,stroke:#333,stroke-width:2px;
```
