# bcars/bcarsdotorg architecture

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

- Interactive diagram: https://gitdiagram.com/bcars/bcarsdotorg
- Repository: https://github.com/bcars/bcarsdotorg

## Overview

##### Main Components Identification

A. Content Management Layer
- Content (Markdown files)
- Static Assets (images, PDFs, CSV files)
- Archetypes (templates)

B. Build System Layer
- Hugo Configuration
- Layouts
- Shortcodes
- i18n (Internationalization)

C. Output Layer
- Generated Static Website
- Asset Pipeline

**┌─────────────────────────────────────────┐**
- Content Layer               │
- ┬─────────────┬────────────┤
- Markdown   │   Static    │ Archetypes │
- Content   │   Assets    │            │
- ┬───────┴─────┬───────┴──────┬─────┘

- ▼             ▼              ▼
**┌─────────────────────────────────────────┐**
- Build Layer                │
- ┬─────────────┬────────────┤
- Hugo     │  Layouts &  │    i18n    │
- Config    │ Shortcodes  │            │
- ┴──────┬──────┴────────────┘

- ▼
**┌─────────────────────────────────────────┐**
- Output Layer                 │
- ┤
- Static Website Files             │
- ┘

##### Component Details

A. Content Layer (Blue)
- Directories for different content types:
- Regular pages (about, activities, etc.)
- Meeting minutes (chronological structure)
- Resources
- Field day information
- Static file storage for PDFs and images

B. Build Layer (Green)
- Hugo configuration (hugo.toml)
- Custom layouts for minutes and other content types
- Shortcodes for special functionality
- i18n support structure

C. Output Layer (Orange)
- Generated HTML
- Processed assets
- Deployment-ready files

##### Additional Elements

- Version control integration (Git)
- Custom CSS processing (assets/css/custom.css)
- File types and formats in the static assets section

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph CL["Content Layer"]
        MC["Markdown Content"]
        SA[("Static Assets")]
        AT["Archetypes"]
    end

    subgraph BL["Build Layer"]
        HC["Hugo Config"]
        LT["Layouts & Templates"]
        SC["Shortcodes"]
        I18["i18n Support"]
    end

    subgraph OL["Output Layer"]
        SW["Static Website"]
        PA["Processed Assets"]
    end

    %% Content Layer Details
    subgraph CMD["Content Management"]
        RP["Regular Pages"]
        MM["Meeting Minutes"]
        FD["Field Day"]
        RS["Resources"]
    end

    %% Static Assets Details
    subgraph SAD["Static Assets Storage"]
        SF["Files"]
        SI["Images"]
        MP["Meeting PDFs"]
    end

    %% Relationships
    MC --> CMD
    SA --> SAD
    CMD --> BL
    SAD --> BL
    AT --> BL
    BL --> OL

    %% Styling
    classDef default fill:#f9f9f9,stroke:#333,stroke-width:1px
    classDef content fill:#e1f5fe,stroke:#01579b
    classDef build fill:#e8f5e9,stroke:#1b5e20
    classDef output fill:#fff3e0,stroke:#e65100
    
    class CL,MC,CMD,RP,MM,FD,RS content
    class BL,HC,LT,SC,I18 build
    class OL,SW,PA output

    %% Click Events
    click MC "https://github.com/BCARS/bcarsdotorg/tree/main/content"
    click RP "https://github.com/BCARS/bcarsdotorg/blob/main/content/*.md"
    click MM "https://github.com/BCARS/bcarsdotorg/tree/main/content/meetings"
    click FD "https://github.com/BCARS/bcarsdotorg/tree/main/content/fieldday"
    click RS "https://github.com/BCARS/bcarsdotorg/tree/main/content/resources"
    click SA "https://github.com/BCARS/bcarsdotorg/tree/main/static"
    click SF "https://github.com/BCARS/bcarsdotorg/tree/main/static/files"
    click SI "https://github.com/BCARS/bcarsdotorg/tree/main/static/images"
    click MP "https://github.com/BCARS/bcarsdotorg/tree/main/static/files/minutes"
    click AT "https://github.com/BCARS/bcarsdotorg/tree/main/archetypes"
    click HC "https://github.com/BCARS/bcarsdotorg/blob/main/hugo.toml"
    click LT "https://github.com/BCARS/bcarsdotorg/tree/main/layouts"
    click SC "https://github.com/BCARS/bcarsdotorg/blob/main/layouts/shortcodes/list-files.html"
    click I18 "https://github.com/BCARS/bcarsdotorg/tree/main/i18n"
```
