# strappazzon/www architecture

> Architecture diagram of the GitHub repository strappazzon/www, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2024-12-28). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/strappazzon/www
- Repository: https://github.com/strappazzon/www

## Overview

##### Main Components Identification

a) Static Site Generator Layer
- Jekyll at the center as the core processing engine
- Ruby plugins (_plugins directory) as auxiliary components

b) Content Structure Layer
- Templates (_templates directory)
- Components (_components directory)
- Pages (pages directory)
- Data Sources (_data directory)

c) Asset Processing Layer
- Styling (_sass directory)
- JavaScript (static/js)
- Static Assets (static/img, static/webfonts)

d) Build & Deployment Layer
- Cloudflare Pages (deployment platform)
- GitHub Actions (CI/CD workflows)

**[Content Sources] → [Processing Layer] → [Build Layer] → [Deployment Layer]**

##### Component Relationships

Key relationships:

a) Content Flow:
- _templates, _components, pages → Jekyll
- _data → Jekyll
- _sass → CSS Processor
- static assets → Direct to Build

b) Build Process:
- Jekyll → Static HTML
- SASS → Compiled CSS
- JavaScript → Minified JS
- GitHub Actions → Cloudflare Pages

##### Technical Details

Annotations for:
- Jekyll plugins and their functions
- GitHub Actions workflow paths
- Cloudflare Pages configuration
- Asset processing pipelines

Use:
- Rectangles: Main components

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph "Content Layer"
        Templates["Templates"]:::content
        Components["Components"]:::content
        Pages["Pages"]:::content
        DataSources["Data Sources"]:::content
        Cards["Card Components"]:::content
        Layout["Layout Components"]:::content
    end

    subgraph "Ruby Plugins Layer"
        Plugins["Ruby Plugins"]:::plugins
        Admonitions["Admonitions"]:::plugins
        Anchors["Anchors"]:::plugins
        HTMLTags["HTML Tags"]:::plugins
        ReadingTime["Reading Time"]:::plugins
        
        Plugins --> Admonitions
        Plugins --> Anchors
        Plugins --> HTMLTags
        Plugins --> ReadingTime
    end

    subgraph "Asset Processing Layer"
        SASS["SASS Styling"]:::assets
        JavaScript["JavaScript"]:::assets
        StaticAssets["Static Assets"]:::assets
        CSSProcess["CSS Processing"]:::assets

        subgraph "SASS Architecture"
            Abstracts["Abstracts"]:::sass
            BaseStyles["Base Styles"]:::sass
            ComponentStyles["Components"]:::sass
            LayoutStyles["Layout"]:::sass
            Themes["Themes"]:::sass
            VendorStyles["Vendor Styles"]:::sass

            SASS --> Abstracts
            SASS --> BaseStyles
            SASS --> ComponentStyles
            SASS --> LayoutStyles
            SASS --> Themes
            SASS --> VendorStyles
        end
    end

    subgraph "Build & Deployment"
        Jekyll["Jekyll"]:::build
        GHActions["GitHub Actions"]:::deployment
        CloudflarePages["Cloudflare Pages"]:::deployment
        BuildScripts["Build Scripts"]:::build
        Config["Jekyll Config"]:::config
        Dependencies["Build Dependencies"]:::config
    end

    Templates --> Jekyll
    Components --> Jekyll
    Pages --> Jekyll
    DataSources --> Jekyll
    Plugins --> Jekyll
    SASS --> CSSProcess
    JavaScript --> Jekyll
    StaticAssets --> Jekyll
    Jekyll --> BuildScripts
    BuildScripts --> GHActions
    GHActions --> CloudflarePages
    Config --> Jekyll
    Dependencies --> Jekyll

    %% Component Mappings
    click Plugins "https://github.com/Strappazzon/www/tree/master//_plugins/*"
    click Admonitions "https://github.com/Strappazzon/www/blob/master//_plugins/admonitions.rb"
    click Anchors "https://github.com/Strappazzon/www/blob/master//_plugins/anchors.rb"
    click HTMLTags "https://github.com/Strappazzon/www/blob/master//_plugins/html_tags.rb"
    click ReadingTime "https://github.com/Strappazzon/www/blob/master//_plugins/reading_time.rb"
    click Templates "https://github.com/Strappazzon/www/tree/master//_templates/*"
    click Components "https://github.com/Strappazzon/www/tree/master//_components/*"
    click Pages "https://github.com/Strappazzon/www/tree/master//pages/*"
    click DataSources "https://github.com/Strappazzon/www/tree/master//_data/*"
    click SASS "https://github.com/Strappazzon/www/tree/master//_sass/*"
    click JavaScript "https://github.com/Strappazzon/www/tree/master//static/js/*"
    click StaticAssets "https://github.com/Strappazzon/www/tree/master//static/img/*"
    click CSSProcess "https://github.com/Strappazzon/www/tree/master//static/css/*"
    click GHActions "https://github.com/Strappazzon/www/tree/master//.github/workflows/*"
    click BuildScripts "https://github.com/Strappazzon/www/tree/master//bin/*"
    click Cards "https://github.com/Strappazzon/www/tree/master//_components/cards/*"
    click Layout "https://github.com/Strappazzon/www/tree/master//_components/layout/*"
    click Abstracts "https://github.com/Strappazzon/www/tree/master//_sass/abstracts/*"
    click BaseStyles "https://github.com/Strappazzon/www/tree/master//_sass/base/*"
    click ComponentStyles "https://github.com/Strappazzon/www/tree/master//_sass/components/*"
    click LayoutStyles "https://github.com/Strappazzon/www/tree/master//_sass/layout/*"
    click Themes "https://github.com/Strappazzon/www/tree/master//_sass/themes/*"
    click VendorStyles "https://github.com/Strappazzon/www/tree/master//_sass/vendors/*"
    click Config "https://github.com/Strappazzon/www/blob/master//_config.yml"
    click Dependencies "https://github.com/Strappazzon/www/tree/master//Gemfile"

    classDef content fill:#3498db,stroke:#2980b9,color:white
    classDef plugins fill:#2ecc71,stroke:#27ae60,color:white
    classDef assets fill:#e74c3c,stroke:#c0392b,color:white
    classDef sass fill:#9b59b6,stroke:#8e44ad,color:white
    classDef build fill:#f1c40f,stroke:#f39c12,color:white
    classDef deployment fill:#1abc9c,stroke:#16a085,color:white
    classDef config fill:#95a5a6,stroke:#7f8c8d,color:white
```
