How deepakshebani/deepak_report works
Project Type and Purpose
• This is a data-story/static-site project built with Quarto (Markdown + code), Plotly (JS/Python charts), and hosted as a static site on GitHub Pages.
• It ingests UNICEF indicators (likely CSV or API), transforms them via code chunks in .qmd files, and renders interactive HTML visualizations.
File Structure
• Top-level files:
– .qmd (Quarto source documents: unicef_report.qmd, unicef_report_with_narrative.qmd)
– Jupyter notebook (Untitled0.ipynb) – exploratory analysis
– HTML outputs (Deepak_report.html, index.html)
– Deepak_report.html is the compiled report; index.html is the landing page.
• No backend/server code—this is purely a static-site pipeline.
• Build artifacts: HTML pages, JS/CSS from Plotly and Quarto.
Extract Additional Insights from the README
• Live site: GitHub Pages at deepakshebani2.github.io/Deepak_report/.
• Four main visualization sections, each combining narrative + code.
• No mention of CI/CD, but GitHub Actions could be in use (you may surface that if configured).
Main Components & Interactions
a. Data Source
– UNICEF dataset files (possibly CSV or pulled via API)
b. Quarto Engine
– Reads .qmd sources + data
– Executes Python/R code chunks (via Jupyter or native engines)
– Emits HTML, JS, CSS assets
c. Visualization Library
– Plotly.js (rendered in the browser)
– Or Plotly in Python to pre-bake JSON
d. Static Site Assets
– HTML pages (Deepak_report.html, index.html)
– Supporting JS/CSS (Quarto theme, Plotly bundles)
e. Hosting/Delivery
– GitHub Pages CDN serving static files
– End-user browsers consuming the site
Data Source → Quarto Engine → Generated HTML/JS/CSS → GitHub Pages → Browser
Architectural Patterns & Principles
• Static Site Generation (SSG)
• “Code+Content” orchestration via Quarto (similar to Jekyll but code-aware)
• Client-side rendering of interactive charts (Plotly)
• Version control–based deployment (Git → GitHub Pages)
Detail Level
• Intermediate steps (e.g., code chunk execution, asset bundling).
• Call out key technologies next to each component (e.g., Quarto, Python, Plotly, GitHub Pages).