# pranjalrai-iitd/news architecture

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

- Interactive diagram: https://gitdiagram.com/pranjalrai-iitd/news
- Repository: https://github.com/pranjalrai-iitd/news

## Overview

Quartz turns an Obsidian-style Markdown vault into a navigable static website: the configured build parses and transforms notes, filters publication candidates, then runs emitters to produce pages and site assets. The site adds folder/tag listings, search, graph navigation, localization, themes, and optional analytics. The README also documents a raw-HTML hosting option. The graph follows relationships documented in the README and SOURCE INDEX; several emitter and UI internals were not sampled, so uncertain calls are omitted.

Main entry points: [`source/quartz/plugins/index.ts`](https://github.com/pranjalrai-iitd/news/blob/main/source/quartz/plugins/index.ts) (Plugin registry), [`source/quartz/build.ts`](https://github.com/pranjalrai-iitd/news/blob/main/source/quartz/build.ts) (Quartz build), [`source/quartz/plugins/emitters/componentResources.ts`](https://github.com/pranjalrai-iitd/news/blob/main/source/quartz/plugins/emitters/componentResources.ts) (Static resources), [`source/quartz.config.ts`](https://github.com/pranjalrai-iitd/news/blob/main/source/quartz.config.ts) (Site configuration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_build["Build orchestration"]
  node_build["Quartz build<br/>[build.ts]"]
  node_config["Site configuration<br/>[quartz.config.ts]"]
  node_pluginregistry["Plugin registry<br/>[index.ts]"]
end

subgraph group_content["Content processing"]
  node_parser["Markdown parser<br/>[parse.ts]"]
  node_transformers["Markdown transforms"]
  node_filters["Publication filters<br/>[filter.ts]"]
end

subgraph group_publish["Site generation"]
  node_emitterprocessor["Emitter processor<br/>[emit.ts]"]
  node_pageemitters["Content page emitters<br/>[contentPage.tsx]"]
  node_listingemitters["Folder and tag pages"]
  node_indexemitter["Search and feeds<br/>[contentIndex.ts]"]
  node_resources["Static resources"]
end

subgraph group_experience["Website experience"]
  node_renderer["Page renderer<br/>[renderPage.tsx]"]
  node_layout["Page components"]
  node_search["Search interface<br/>[Search.tsx]"]
  node_graph["Link graph<br/>[Graph.tsx]"]
  node_localization["Localization<br/>[index.ts]"]
end

node_vault["Obsidian vault"]
node_website["Generated website"]
node_rawhtml["Raw HTML pages"]
node_visitor(("Site visitor"))
node_analytics(("Analytics services"))

node_vault -->|"supplies notes"| node_build
node_config -->|"configures"| node_build
node_build -->|"parses files"| node_parser
node_parser -->|"applies transforms"| node_transformers
node_build -->|"filters content"| node_filters
node_build -->|"emits output"| node_emitterprocessor
node_emitterprocessor -->|"uses plugins"| node_pluginregistry
node_config -->|"selects plugins"| node_pluginregistry
node_pluginregistry -->|"registers emitters"| node_pageemitters
node_pluginregistry -->|"registers emitters"| node_listingemitters
node_pluginregistry -->|"registers emitters"| node_indexemitter
node_pluginregistry -->|"registers emitter"| node_resources
node_pageemitters -.->|"writes pages"| node_website
node_listingemitters -.->|"writes listings"| node_website
node_indexemitter -->|"writes indexes"| node_website
node_resources -->|"writes assets"| node_website
node_renderer -->|"renders components"| node_layout
node_layout -.->|"forms pages"| node_website
node_search -.->|"supports searching"| node_visitor
node_graph -.->|"shows connections"| node_visitor
node_localization -->|"provides translations"| node_renderer
node_visitor -->|"views pages"| node_website
node_rawhtml -->|"hosts alongside"| node_website
node_resources -.->|"loads analytics"| node_analytics

click node_build "https://github.com/pranjalrai-iitd/news/blob/main/source/quartz/build.ts"
click node_config "https://github.com/pranjalrai-iitd/news/blob/main/source/quartz.config.ts"
click node_pluginregistry "https://github.com/pranjalrai-iitd/news/blob/main/source/quartz/plugins/index.ts"
click node_parser "https://github.com/pranjalrai-iitd/news/blob/main/source/quartz/processors/parse.ts"
click node_transformers "https://github.com/pranjalrai-iitd/news/tree/main/source/quartz/plugins/transformers"
click node_filters "https://github.com/pranjalrai-iitd/news/blob/main/source/quartz/processors/filter.ts"
click node_emitterprocessor "https://github.com/pranjalrai-iitd/news/blob/main/source/quartz/processors/emit.ts"
click node_pageemitters "https://github.com/pranjalrai-iitd/news/blob/main/source/quartz/plugins/emitters/contentPage.tsx"
click node_listingemitters "https://github.com/pranjalrai-iitd/news/tree/main/source/quartz/plugins/emitters"
click node_indexemitter "https://github.com/pranjalrai-iitd/news/blob/main/source/quartz/plugins/emitters/contentIndex.ts"
click node_resources "https://github.com/pranjalrai-iitd/news/blob/main/source/quartz/plugins/emitters/componentResources.ts"
click node_renderer "https://github.com/pranjalrai-iitd/news/blob/main/source/quartz/components/renderPage.tsx"
click node_layout "https://github.com/pranjalrai-iitd/news/tree/main/source/quartz/components"
click node_search "https://github.com/pranjalrai-iitd/news/blob/main/source/quartz/components/Search.tsx"
click node_graph "https://github.com/pranjalrai-iitd/news/blob/main/source/quartz/components/Graph.tsx"
click node_localization "https://github.com/pranjalrai-iitd/news/blob/main/source/quartz/i18n/index.ts"
click node_rawhtml "https://github.com/pranjalrai-iitd/news/tree/main/source/raw_html"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_build,node_config,node_pluginregistry toneBlue
class node_parser,node_transformers,node_filters toneAmber
class node_emitterprocessor,node_pageemitters,node_listingemitters,node_indexemitter,node_resources toneMint
class node_renderer,node_layout,node_search,node_graph,node_localization toneRose
class node_vault,node_website,node_visitor,node_analytics toneIndigo
class node_rawhtml toneTeal
```

## Components

### Build orchestration

- [Quartz build](https://github.com/pranjalrai-iitd/news/blob/main/source/quartz/build.ts): `source/quartz/build.ts`
- [Site configuration](https://github.com/pranjalrai-iitd/news/blob/main/source/quartz.config.ts): `source/quartz.config.ts`
- [Plugin registry](https://github.com/pranjalrai-iitd/news/blob/main/source/quartz/plugins/index.ts): `source/quartz/plugins/index.ts`

### Content processing

- [Markdown parser](https://github.com/pranjalrai-iitd/news/blob/main/source/quartz/processors/parse.ts): `source/quartz/processors/parse.ts`
- [Markdown transforms](https://github.com/pranjalrai-iitd/news/tree/main/source/quartz/plugins/transformers): `source/quartz/plugins/transformers`
- [Publication filters](https://github.com/pranjalrai-iitd/news/blob/main/source/quartz/processors/filter.ts): `source/quartz/processors/filter.ts`

### Site generation

- [Emitter processor](https://github.com/pranjalrai-iitd/news/blob/main/source/quartz/processors/emit.ts): `source/quartz/processors/emit.ts`
- [Content page emitters](https://github.com/pranjalrai-iitd/news/blob/main/source/quartz/plugins/emitters/contentPage.tsx): `source/quartz/plugins/emitters/contentPage.tsx`
- [Folder and tag pages](https://github.com/pranjalrai-iitd/news/tree/main/source/quartz/plugins/emitters): `source/quartz/plugins/emitters`
- [Search and feeds](https://github.com/pranjalrai-iitd/news/blob/main/source/quartz/plugins/emitters/contentIndex.ts): `source/quartz/plugins/emitters/contentIndex.ts`
- [Static resources](https://github.com/pranjalrai-iitd/news/blob/main/source/quartz/plugins/emitters/componentResources.ts): `source/quartz/plugins/emitters/componentResources.ts`

### Website experience

- [Page renderer](https://github.com/pranjalrai-iitd/news/blob/main/source/quartz/components/renderPage.tsx): `source/quartz/components/renderPage.tsx`
- [Page components](https://github.com/pranjalrai-iitd/news/tree/main/source/quartz/components): `source/quartz/components`
- [Search interface](https://github.com/pranjalrai-iitd/news/blob/main/source/quartz/components/Search.tsx): `source/quartz/components/Search.tsx`
- [Link graph](https://github.com/pranjalrai-iitd/news/blob/main/source/quartz/components/Graph.tsx): `source/quartz/components/Graph.tsx`
- [Localization](https://github.com/pranjalrai-iitd/news/blob/main/source/quartz/i18n/index.ts): `source/quartz/i18n/index.ts`

### Other components

- **Obsidian vault**
- **Generated website**
- [Raw HTML pages](https://github.com/pranjalrai-iitd/news/tree/main/source/raw_html): `source/raw_html`
- **Site visitor**
- **Analytics services**

## Connections

- Obsidian vault → Quartz build: supplies notes (evidence: `README.md`)
- Site configuration → Quartz build: configures (evidence: `source/quartz.config.ts`)
- Quartz build → Markdown parser: parses files (evidence: `source/quartz/build.ts`)
- Markdown parser → Markdown transforms: applies transforms (evidence: `source/quartz/processors/parse.ts`)
- Quartz build → Publication filters: filters content (evidence: `source/quartz/build.ts`)
- Quartz build → Emitter processor: emits output (evidence: `source/quartz/build.ts`)
- Emitter processor → Plugin registry: uses plugins (evidence: `source/quartz/processors/emit.ts`)
- Site configuration → Plugin registry: selects plugins (evidence: `source/quartz.config.ts`)
- Plugin registry → Content page emitters: registers emitters (evidence: `source/quartz/plugins/index.ts`)
- Plugin registry → Folder and tag pages: registers emitters (evidence: `source/quartz/plugins/index.ts`)
- Plugin registry → Search and feeds: registers emitters (evidence: `source/quartz/plugins/index.ts`)
- Plugin registry → Static resources: registers emitter (evidence: `source/quartz/plugins/index.ts`)
- Content page emitters → Generated website: writes pages
- Folder and tag pages → Generated website: writes listings
- Search and feeds → Generated website: writes indexes (evidence: `source/quartz/plugins/emitters/contentIndex.ts`)
- Static resources → Generated website: writes assets (evidence: `source/quartz/plugins/emitters/componentResources.ts`)
- Page renderer → Page components: renders components (evidence: `source/quartz/components/renderPage.tsx`)
- Page components → Generated website: forms pages
- Search interface → Site visitor: supports searching
- Link graph → Site visitor: shows connections
- Localization → Page renderer: provides translations (evidence: `source/quartz/components/renderPage.tsx`)
- Site visitor → Generated website: views pages (evidence: `README.md`)
- Raw HTML pages → Generated website: hosts alongside (evidence: `README.md`)
- Static resources → Analytics services: loads analytics (evidence: `source/quartz/plugins/emitters/componentResources.ts`)
