# wicksome/til architecture

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

- Interactive diagram: https://gitdiagram.com/wicksome/til
- Repository: https://github.com/wicksome/til

## Overview

##### Main Components

a. Content Management Layer
- Markdown (.md) files repository
- AsciiDoc (.adoc) files repository
- Directory structure organization

b. Processing Layer
- File synchronization system
- Format conversion handlers
- Blog integration pipeline

c. Presentation Layer
- Blog rendering system (wickso.me)
- Chrome extensions integration
- Local preview capabilities

##### Key Relationships to Highlight

- Flow from local content creation to blog publication
- Demonstrate the parallel handling of Markdown and AsciiDoc formats
- Integration with external tools and viewers

##### Specific Implementation Details

- Blue rectangles for content storage components
- Green rectangles for processing components
- Orange rectangles for presentation components
- Purple rectangles for external tools/integrations

**[Content Layer]**

- v
**[Processing Layer]**

- v
**[Presentation Layer]**

##### Elements

a. Content Organization:
- Category-based structure
- Asset management system
- Version control integration (Git)

b. Processing Workflows:
- File synchronization
- GitHub Actions pipeline
- Format conversion processes

c. Viewing Mechanisms:
- Blog rendering
- Chrome extensions
- Local preview capabilities

##### Important Notes

- Keep the main workflow clear and central
- Notes for special handling of different file types

- The clear separation between content management and presentation
- The automated synchronization process
- The multiple viewing options available
- The extensible nature of the system

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Style Definitions
    classDef content fill:#3498db,stroke:#2980b9,color:white
    classDef processing fill:#2ecc71,stroke:#27ae60,color:white
    classDef presentation fill:#e67e22,stroke:#d35400,color:white
    classDef tools fill:#9b59b6,stroke:#8e44ad,color:white
    classDef external fill:#95a5a6,stroke:#7f8c8d,color:white

    subgraph ContentLayer["Content Management Layer"]
        MarkdownRepo["Markdown Repository"]:::content
        AsciidocRepo["AsciiDoc Repository"]:::content
        Assets["Asset Management"]:::content
        DirStructure["Directory Structure"]:::content
    end

    subgraph ProcessingLayer["Processing Layer"]
        FileSync["File Synchronization"]:::processing
        FormatConv["Format Conversion"]:::processing
        BuildPipe["Build Pipeline"]:::processing
    end

    subgraph PresentationLayer["Presentation Layer"]
        ChromeExt["Chrome Extensions"]:::presentation
        BlogConfig["Blog Configuration"]:::presentation
        PreviewTools["Preview Tools"]:::presentation
    end

    subgraph DevTools["Development Tools"]
        PlantUML["PlantUML Integration"]:::tools
        JSONTools["JSON Tools"]:::tools
        MarkdownTools["Markdown Tools"]:::tools
        VCS["Version Control"]:::tools
        DevEnv["Development Environment"]:::tools
    end

    %% Relationships
    ContentLayer --> ProcessingLayer
    ProcessingLayer --> PresentationLayer
    DevTools --> ContentLayer
    DevTools --> ProcessingLayer

    %% Click Events
    click MarkdownRepo "https://github.com/wicksome/til/tree/main/markdown/"
    click AsciidocRepo "https://github.com/wicksome/til/tree/main/asciidoc/"
    click Assets "https://github.com/wicksome/til/tree/main/tools/assets/"
    click FileSync "https://github.com/wicksome/til/blob/main/.github/workflows/pages.yml"
    click FormatConv "https://github.com/wicksome/til/blob/main/asciidoc/convert-md-to-adoc.adoc"
    click BuildPipe "https://github.com/wicksome/til/blob/main/index.adoc"
    click ChromeExt "https://github.com/wicksome/til/blob/main/chrome-extensions.adoc"
    click BlogConfig "https://github.com/wicksome/til/tree/main/CNAME"
    click PreviewTools "https://github.com/wicksome/til/blob/main/tools/skeleton/index.html"
    click PlantUML "https://github.com/wicksome/til/tree/main/plantuml/"
    click JSONTools "https://github.com/wicksome/til/tree/main/tools/json/"
    click MarkdownTools "https://github.com/wicksome/til/tree/main/tools/mybatis-log-to-sql/"
    click VCS "https://github.com/wicksome/til/tree/main/vcs/git/"
    click DevEnv "https://github.com/wicksome/til/tree/main/.vscode/"

    %% Legend
    subgraph Legend
        L1["Content Components"]:::content
        L2["Processing Components"]:::processing
        L3["Presentation Components"]:::presentation
        L4["Development Tools"]:::tools
    end
```
