# gustavoguanabara/html-css architecture

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

- Interactive diagram: https://gitdiagram.com/gustavoguanabara/html-css
- Repository: https://github.com/gustavoguanabara/html-css

## Overview

##### Project type and purpose
- This is a static educational website (HTML5/CSS3 course materials).
- Purpose: host PDFs, code samples (HTML/CSS exercises), and challenges for learners.
- Hosted via GitHub Pages, no dynamic backend.

##### File structure
- Top‐level:
- _config.yml indicates a Jekyll/GitHub Pages build.
- aulas-pdf: PDFs of lectures.
- exercicios: folders of HTML/CSS exercises.
- desafios: PDF challenges and supporting files.
- imagens: site images (e.g., mascote.png).
- README.md describes site content and links.
- .gitignore, LICENSE—standard repo files.

##### Extract insights from README
- Static site with direct links to PDFs and live HTML demos.
- Uses GitHub Pages URL structure (gustavoguanabara.github.io/html-css).

##### Main components
a. Content authoring environment
– Developer’s local machine (editor, Git CLI).
b. Source code repository
– GitHub repo (branches, commits).
c. Build pipeline
– Jekyll (reads _config.yml, converts any markdown to HTML).
d. Hosting platform
– GitHub Pages (serves static assets over HTTPS/CDN).
e. End user
– Learner’s web browser (requests HTML/CSS/PDF files).

##### Relationships and data flow
- Author edits files → commits to Git → push to GitHub.
- GitHub triggers Pages build via Jekyll → outputs static site.
- GitHub Pages CDN serves content → browser requests/receives assets.
- Browser renders HTML/CSS; PDFs open via built‐in viewer or download.

##### Architectural patterns/design principles
- Static site generator (Jekyll) pattern.
- Content‐pipeline separation: raw assets (PDFs), templates, final output.
- Infrastructure as code: configuration (_config.yml) controls build.

##### Technologies/frameworks/libraries
- Git/GitHub for version control and hosting.
- Jekyll (built into GitHub Pages) for static site generation.
- HTML5/CSS3 for front‐end.
- PDF assets as binary resources.

## Diagram (Mermaid)

```mermaid
flowchart TD
    DevLocal["Developer Local (VSCode, Git CLI)"]:::dev
    GitHubRepo["GitHub Repo (main branch)"]:::dev

    subgraph "Content Layer"
        PDFs["Lecture PDFs"]:::content
        Exercises["Exercises"]:::content
        IndexHTML["exercicios/index.html"]:::content
        StyleCSS["exercicios/style.css"]:::content
        Challenges["Challenges"]:::content
        Images["Site Images"]:::content
        Promo["Promotional Assets"]:::content
        Readme["README.md"]:::content
        Gitignore[".gitignore"]:::content
        License["LICENSE"]:::content
    end

    subgraph "Build Layer"
        Config["_config.yml (Jekyll Config)"]:::build
        Jekyll["Jekyll SSG"]:::build
    end

    subgraph "Hosting Layer"
        GHPages["GitHub Pages CDN"]:::host
    end

    Browser["Learner Browser (Chrome/Firefox)"]:::client

    DevLocal -->|"push"| GitHubRepo
    GitHubRepo -->|"trigger build"| Jekyll
    Config -->|"reads config"| Jekyll
    Jekyll -->|"deploy static site"| GHPages
    GHPages -->|"serve assets"| Browser

    Exercises --> IndexHTML
    Exercises --> StyleCSS

    click PDFs "https://github.com/gustavoguanabara/html-css/tree/master/aulas-pdf/"
    click Exercises "https://github.com/gustavoguanabara/html-css/tree/master/exercicios/"
    click IndexHTML "https://github.com/gustavoguanabara/html-css/blob/master/exercicios/index.html"
    click StyleCSS "https://github.com/gustavoguanabara/html-css/blob/master/exercicios/style.css"
    click Challenges "https://github.com/gustavoguanabara/html-css/tree/master/desafios/"
    click Images "https://github.com/gustavoguanabara/html-css/tree/master/imagens/"
    click Promo "https://github.com/gustavoguanabara/html-css/tree/master/ajude-a-divulgar/"
    click Readme "https://github.com/gustavoguanabara/html-css/blob/master/README.md"
    click Gitignore "https://github.com/gustavoguanabara/html-css/blob/master/.gitignore"
    click License "https://github.com/gustavoguanabara/html-css/tree/master/LICENSE"
    click Config "https://github.com/gustavoguanabara/html-css/blob/master/_config.yml"

    classDef dev fill:#D0E6FF,stroke:#0066CC,color:#000
    classDef content fill:#E6F7FF,stroke:#3399FF,color:#000
    classDef build fill:#DFFFE0,stroke:#33CC33,color:#000
    classDef host fill:#FFE6CC,stroke:#FF9933,color:#000
    classDef client fill:#F0F0F0,stroke:#999999,color:#000
```
