# eavesofit/eavesofit-blog architecture

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

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

## Overview

##### Project type and purpose
- This is a static blog built with Jekyll (a Ruby-based static site generator).
- README confirms it’s the main repo for a personal blog (“eavesofit-blog”).

##### File structure
- Top-level files:
– Gemfile/Gemfile.lock: Ruby dependencies (Jekyll + plugins)
– _config.yml: Jekyll configuration (site metadata, permalink style, plugins)
– .gitignore: files excluded from VCS
– index.html / index.markdown: homepage templates or content
- Posts directory: `_posts/` contains Markdown or HTML files for each blog post.
- 404.html: custom 404 page.
- No “src” or “backend” folders—everything is static.

##### Key insights from README
- Confirms it’s a blog repo—no runtime server or API layer; all pages are pre-rendered.

##### Main components
a. Content source
– Markdown files in `_posts/`, index.markdown, custom pages (404.html)
– Static assets (CSS, JS, images) if present
b. Configuration & templates
– `_config.yml` (sitewide settings)
– Layouts and includes (not shown in file tree, typically in `_layouts/` or `_includes/`)
c. Build engine
– Jekyll (Ruby gem invoked via `jekyll build` or `jekyll serve`)
d. Output artifact
– Generated static files (HTML, CSS, JS) in `_site/` (not checked into Git)
e. Hosting platform
– GitHub Pages (or any static-site host)
f. End user
– Browser receiving rendered pages

##### Relationships and data flow
- Author commits Markdown + config → Git repository
- CI or local build invokes Jekyll engine with templates + content + config
- Jekyll processes Liquid tags and Markdown → generates static HTML/CSS/JS in `_site/`
- Host (e.g., GitHub Pages) deploys contents of `_site/` to a CDN or web server
- End user’s browser requests pages → served by static host

##### Important architectural patterns
- Static Site Generation (SSG)
- Template-driven rendering (Liquid templates)
- Git-based deployment (push to main branch triggers rebuild on GitHub Pages)

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Author
    Author["Author / Developer"]:::external

    %% Git Repository with subcomponents
    subgraph "Git Repository"
        subgraph "Content Source"
            MD["_posts/"]:::content
            Home1["index.html"]:::content
            Home2["index.markdown"]:::content
            ErrorPage["404.html"]:::content
        end
        Config["_config.yml"]:::content
        subgraph "Dependencies"
            Gem["Gemfile"]:::repo
            GemLock["Gemfile.lock"]:::repo
        end
        subgraph "Metadata"
            Readme["README.md"]:::repo
            Gitignore[".gitignore"]:::repo
        end
    end

    %% Build Engine
    Jekyll["Jekyll Build Engine"]:::engine

    %% Generated Output
    Site["_site/ (Generated Site)"]:::deploy

    %% Hosting
    Host["GitHub Pages / CDN"]:::deploy

    %% End User
    Browser["End User Browser"]:::external

    %% Connections
    Author -->|"git push"| MD
    Author --> MD
    Author --> Home1
    Author --> Home2
    Author --> ErrorPage
    Author --> Config
    Author --> Gem
    Author --> GemLock
    Author --> Readme
    Author --> Gitignore

    MD -->|"trigger build"| Jekyll
    Home1 --> Jekyll
    Home2 --> Jekyll
    ErrorPage --> Jekyll
    Config --> Jekyll
    Gem --> Jekyll
    GemLock --> Jekyll

    Jekyll -->|"generate static files"| Site
    Site -->|"deploy"| Host
    Host -->|"HTTP request"| Browser

    %% Click Events
    click MD "https://github.com/eavesofit/eavesofit-blog/tree/main/_posts/"
    click Home1 "https://github.com/eavesofit/eavesofit-blog/blob/main/index.html"
    click Home2 "https://github.com/eavesofit/eavesofit-blog/blob/main/index.markdown"
    click ErrorPage "https://github.com/eavesofit/eavesofit-blog/blob/main/404.html"
    click Config "https://github.com/eavesofit/eavesofit-blog/blob/main/_config.yml"
    click Gem "https://github.com/eavesofit/eavesofit-blog/tree/main/Gemfile"
    click GemLock "https://github.com/eavesofit/eavesofit-blog/blob/main/Gemfile.lock"
    click Readme "https://github.com/eavesofit/eavesofit-blog/blob/main/README.md"
    click Gitignore "https://github.com/eavesofit/eavesofit-blog/blob/main/.gitignore"

    %% Styles
    classDef content fill:#f9f,stroke:#333,stroke-width:2px
    classDef engine fill:#ff9,stroke:#333,stroke-width:2px
    classDef deploy fill:#9f9,stroke:#333,stroke-width:2px
    classDef external fill:#9cf,stroke:#333,stroke-width:2px
    classDef repo fill:#ccf,stroke:#333,stroke-width:2px
```
