# ro-baca/wiki-ro architecture

> Architecture diagram of the GitHub repository ro-baca/wiki-ro, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ro-baca/wiki-ro
- Repository: https://github.com/ro-baca/wiki-ro

## Overview

Wiki-Ro is a personal digital garden: notes are authored locally in Obsidian and published as a navigable website with Quartz. The runtime flow represented here is Markdown parsing, filtering, then emitting pages and supporting site assets; the published experience includes search, exploration, and tag listings. README statements support the authoring and publishing context, while source excerpts and the SOURCE INDEX support the Quartz relationships shown. Unsampled capabilities are grouped by their exact source directories; their internal calls are not inferred.

Main entry points: [`quartz/plugins/emitters`](https://github.com/ro-baca/wiki-ro/tree/v4/quartz/plugins/emitters) (Site emitters), [`quartz/components`](https://github.com/ro-baca/wiki-ro/tree/v4/quartz/components) (Page components), [`quartz/processors/emit.ts`](https://github.com/ro-baca/wiki-ro/blob/v4/quartz/processors/emit.ts) (Site emission), [`quartz/processors/parse.ts`](https://github.com/ro-baca/wiki-ro/blob/v4/quartz/processors/parse.ts) (Markdown parsing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_pipeline["Content pipeline"]
  node_parse["Markdown parsing<br/>[parse.ts]"]
  node_filter["Publish filtering<br/>[filter.ts]"]
  node_emit["Site emission<br/>[emit.ts]"]
end

subgraph group_plugins["Plugin stages"]
  node_transformers["Content transformers"]
  node_filters["Content filters"]
  node_emitters["Site emitters"]
end

subgraph group_site["Site rendering"]
  node_pagegen["Page generation<br/>[contentPage.tsx]"]
  node_folderpages["Folder listings<br/>[folderPage.tsx]"]
  node_tagpages["Tag listings<br/>[tagPage.tsx]"]
  node_indexes["Content indexes<br/>[contentIndex.tsx]"]
  node_assets["Site assets<br/>[assets.ts]"]
  node_render["Page rendering<br/>[renderPage.tsx]"]
end

subgraph group_ui["Reader experience"]
  node_search["Search interface<br/>[Search.tsx]"]
  node_explorer["Note explorer<br/>[Explorer.tsx]"]
  node_taglisting["Tag page view<br/>[TagContent.tsx]"]
  node_pagelist["Page lists<br/>[PageList.tsx]"]
  node_graph["Link graph<br/>[Graph.tsx]"]
  node_backlinks["Backlinks<br/>[Backlinks.tsx]"]
  node_components["Page components"]
end

subgraph group_shared["Shared runtime"]
  node_config["Site configuration<br/>[quartz.config.ts]"]
  node_context["Build context<br/>[ctx.ts]"]
  node_vfile["Processed content model<br/>[vfile.ts]"]
  node_paths["Slug and link paths<br/>[path.ts]"]
  node_trie["File trie<br/>[fileTrie.ts]"]
  node_resources["Static resources<br/>[resources.tsx]"]
  node_theme["Theme configuration<br/>[theme.ts]"]
  node_i18n["Translations<br/>[index.ts]"]
end

node_author(("Garden author"))
node_obsidian["Obsidian"]
node_markdown["Markdown notes"]
node_website["Published garden"]

node_author -->|"writes notes"| node_obsidian
node_obsidian -->|"authors"| node_markdown
node_markdown -->|"reads files"| node_parse
node_parse -->|"applies plugins"| node_transformers
node_parse -->|"produces content"| node_vfile
node_parse -->|"assigns slugs"| node_paths
node_filter -->|"checks plugins"| node_filters
node_emit -->|"runs plugins"| node_emitters
node_config -->|"configures"| node_transformers
node_config -->|"configures"| node_filters
node_config -->|"configures"| node_emitters
node_pagegen -.->|"renders pages"| node_render
node_folderpages -.->|"renders listings"| node_render
node_tagpages -.->|"renders listings"| node_render
node_emitters -.->|"emits pages"| node_pagegen
node_emitters -.->|"emits listings"| node_folderpages
node_emitters -.->|"emits listings"| node_tagpages
node_emitters -.->|"emits indexes"| node_indexes
node_emitters -.->|"emits assets"| node_assets
node_render -.->|"renders with"| node_components
node_components -.->|"includes"| node_search
node_components -->|"includes"| node_explorer
node_components -.->|"includes"| node_graph
node_components -.->|"includes"| node_backlinks
node_taglisting -->|"renders list"| node_pagelist
node_explorer -->|"reads structure"| node_trie
node_search -->|"gets labels"| node_i18n
node_taglisting -->|"gets labels"| node_i18n
node_taglisting -->|"reads metadata"| node_vfile
node_emit -->|"uses resources"| node_resources
node_emit -->|"uses context"| node_context
node_emit -.->|"writes site"| node_website
node_website -->|"publishes garden"| node_author

click node_parse "https://github.com/ro-baca/wiki-ro/blob/v4/quartz/processors/parse.ts"
click node_filter "https://github.com/ro-baca/wiki-ro/blob/v4/quartz/processors/filter.ts"
click node_emit "https://github.com/ro-baca/wiki-ro/blob/v4/quartz/processors/emit.ts"
click node_transformers "https://github.com/ro-baca/wiki-ro/tree/v4/quartz/plugins/transformers"
click node_filters "https://github.com/ro-baca/wiki-ro/tree/v4/quartz/plugins/filters"
click node_emitters "https://github.com/ro-baca/wiki-ro/tree/v4/quartz/plugins/emitters"
click node_config "https://github.com/ro-baca/wiki-ro/blob/v4/quartz.config.ts"
click node_context "https://github.com/ro-baca/wiki-ro/blob/v4/quartz/util/ctx.ts"
click node_pagegen "https://github.com/ro-baca/wiki-ro/blob/v4/quartz/plugins/emitters/contentPage.tsx"
click node_folderpages "https://github.com/ro-baca/wiki-ro/blob/v4/quartz/plugins/emitters/folderPage.tsx"
click node_tagpages "https://github.com/ro-baca/wiki-ro/blob/v4/quartz/plugins/emitters/tagPage.tsx"
click node_indexes "https://github.com/ro-baca/wiki-ro/blob/v4/quartz/plugins/emitters/contentIndex.tsx"
click node_assets "https://github.com/ro-baca/wiki-ro/blob/v4/quartz/plugins/emitters/assets.ts"
click node_render "https://github.com/ro-baca/wiki-ro/blob/v4/quartz/components/renderPage.tsx"
click node_search "https://github.com/ro-baca/wiki-ro/blob/v4/quartz/components/Search.tsx"
click node_explorer "https://github.com/ro-baca/wiki-ro/blob/v4/quartz/components/Explorer.tsx"
click node_taglisting "https://github.com/ro-baca/wiki-ro/blob/v4/quartz/components/pages/TagContent.tsx"
click node_pagelist "https://github.com/ro-baca/wiki-ro/blob/v4/quartz/components/PageList.tsx"
click node_graph "https://github.com/ro-baca/wiki-ro/blob/v4/quartz/components/Graph.tsx"
click node_backlinks "https://github.com/ro-baca/wiki-ro/blob/v4/quartz/components/Backlinks.tsx"
click node_components "https://github.com/ro-baca/wiki-ro/tree/v4/quartz/components"
click node_vfile "https://github.com/ro-baca/wiki-ro/blob/v4/quartz/plugins/vfile.ts"
click node_paths "https://github.com/ro-baca/wiki-ro/blob/v4/quartz/util/path.ts"
click node_trie "https://github.com/ro-baca/wiki-ro/blob/v4/quartz/util/fileTrie.ts"
click node_resources "https://github.com/ro-baca/wiki-ro/blob/v4/quartz/util/resources.tsx"
click node_theme "https://github.com/ro-baca/wiki-ro/blob/v4/quartz/util/theme.ts"
click node_i18n "https://github.com/ro-baca/wiki-ro/blob/v4/quartz/i18n/index.ts"

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_parse,node_filter,node_emit toneBlue
class node_transformers,node_filters,node_emitters toneAmber
class node_pagegen,node_folderpages,node_tagpages,node_indexes,node_assets,node_render toneMint
class node_search,node_explorer,node_taglisting,node_pagelist,node_graph,node_backlinks,node_components toneRose
class node_config,node_context,node_vfile,node_paths,node_trie,node_resources,node_theme,node_i18n,node_author,node_obsidian,node_markdown,node_website toneIndigo
```

## Components

### Content pipeline

- [Markdown parsing](https://github.com/ro-baca/wiki-ro/blob/v4/quartz/processors/parse.ts): `quartz/processors/parse.ts`
- [Publish filtering](https://github.com/ro-baca/wiki-ro/blob/v4/quartz/processors/filter.ts): `quartz/processors/filter.ts`
- [Site emission](https://github.com/ro-baca/wiki-ro/blob/v4/quartz/processors/emit.ts): `quartz/processors/emit.ts`

### Plugin stages

- [Content transformers](https://github.com/ro-baca/wiki-ro/tree/v4/quartz/plugins/transformers): `quartz/plugins/transformers`
- [Content filters](https://github.com/ro-baca/wiki-ro/tree/v4/quartz/plugins/filters): `quartz/plugins/filters`
- [Site emitters](https://github.com/ro-baca/wiki-ro/tree/v4/quartz/plugins/emitters): `quartz/plugins/emitters`

### Site rendering

- [Page generation](https://github.com/ro-baca/wiki-ro/blob/v4/quartz/plugins/emitters/contentPage.tsx): `quartz/plugins/emitters/contentPage.tsx`
- [Folder listings](https://github.com/ro-baca/wiki-ro/blob/v4/quartz/plugins/emitters/folderPage.tsx): `quartz/plugins/emitters/folderPage.tsx`
- [Tag listings](https://github.com/ro-baca/wiki-ro/blob/v4/quartz/plugins/emitters/tagPage.tsx): `quartz/plugins/emitters/tagPage.tsx`
- [Content indexes](https://github.com/ro-baca/wiki-ro/blob/v4/quartz/plugins/emitters/contentIndex.tsx): `quartz/plugins/emitters/contentIndex.tsx`
- [Site assets](https://github.com/ro-baca/wiki-ro/blob/v4/quartz/plugins/emitters/assets.ts): `quartz/plugins/emitters/assets.ts`
- [Page rendering](https://github.com/ro-baca/wiki-ro/blob/v4/quartz/components/renderPage.tsx): `quartz/components/renderPage.tsx`

### Reader experience

- [Search interface](https://github.com/ro-baca/wiki-ro/blob/v4/quartz/components/Search.tsx): `quartz/components/Search.tsx`
- [Note explorer](https://github.com/ro-baca/wiki-ro/blob/v4/quartz/components/Explorer.tsx): `quartz/components/Explorer.tsx`
- [Tag page view](https://github.com/ro-baca/wiki-ro/blob/v4/quartz/components/pages/TagContent.tsx): `quartz/components/pages/TagContent.tsx`
- [Page lists](https://github.com/ro-baca/wiki-ro/blob/v4/quartz/components/PageList.tsx): `quartz/components/PageList.tsx`
- [Link graph](https://github.com/ro-baca/wiki-ro/blob/v4/quartz/components/Graph.tsx): `quartz/components/Graph.tsx`
- [Backlinks](https://github.com/ro-baca/wiki-ro/blob/v4/quartz/components/Backlinks.tsx): `quartz/components/Backlinks.tsx`
- [Page components](https://github.com/ro-baca/wiki-ro/tree/v4/quartz/components): `quartz/components`

### Shared runtime

- [Site configuration](https://github.com/ro-baca/wiki-ro/blob/v4/quartz.config.ts): `quartz.config.ts`
- [Build context](https://github.com/ro-baca/wiki-ro/blob/v4/quartz/util/ctx.ts): `quartz/util/ctx.ts`
- [Processed content model](https://github.com/ro-baca/wiki-ro/blob/v4/quartz/plugins/vfile.ts): `quartz/plugins/vfile.ts`
- [Slug and link paths](https://github.com/ro-baca/wiki-ro/blob/v4/quartz/util/path.ts): `quartz/util/path.ts`
- [File trie](https://github.com/ro-baca/wiki-ro/blob/v4/quartz/util/fileTrie.ts): `quartz/util/fileTrie.ts`
- [Static resources](https://github.com/ro-baca/wiki-ro/blob/v4/quartz/util/resources.tsx): `quartz/util/resources.tsx`
- [Theme configuration](https://github.com/ro-baca/wiki-ro/blob/v4/quartz/util/theme.ts): `quartz/util/theme.ts`
- [Translations](https://github.com/ro-baca/wiki-ro/blob/v4/quartz/i18n/index.ts): `quartz/i18n/index.ts`

### Other components

- **Garden author**
- **Obsidian**
- **Markdown notes**
- **Published garden**

## Connections

- Garden author → Obsidian: writes notes (evidence: `README.md`)
- Obsidian → Markdown notes: authors (evidence: `README.md`)
- Markdown notes → Markdown parsing: reads files (evidence: `quartz/processors/parse.ts`)
- Markdown parsing → Content transformers: applies plugins (evidence: `quartz/processors/parse.ts`)
- Markdown parsing → Processed content model: produces content (evidence: `quartz/processors/parse.ts`)
- Markdown parsing → Slug and link paths: assigns slugs (evidence: `quartz/processors/parse.ts`)
- Publish filtering → Content filters: checks plugins (evidence: `quartz/processors/filter.ts`)
- Site emission → Site emitters: runs plugins (evidence: `quartz/processors/emit.ts`)
- Site configuration → Content transformers: configures (evidence: `quartz.config.ts`)
- Site configuration → Content filters: configures (evidence: `quartz.config.ts`)
- Site configuration → Site emitters: configures (evidence: `quartz.config.ts`)
- Page generation → Page rendering: renders pages
- Folder listings → Page rendering: renders listings
- Tag listings → Page rendering: renders listings
- Site emitters → Page generation: emits pages
- Site emitters → Folder listings: emits listings
- Site emitters → Tag listings: emits listings
- Site emitters → Content indexes: emits indexes
- Site emitters → Site assets: emits assets
- Page rendering → Page components: renders with
- Page components → Search interface: includes (evidence: `quartz/components/index.ts`)
- Page components → Note explorer: includes (evidence: `quartz.layout.ts`)
- Page components → Link graph: includes (evidence: `quartz/components/index.ts`)
- Page components → Backlinks: includes (evidence: `quartz/components/index.ts`)
- Tag page view → Page lists: renders list (evidence: `quartz/components/pages/TagContent.tsx`)
- Note explorer → File trie: reads structure (evidence: `quartz/components/Explorer.tsx`)
- Search interface → Translations: gets labels (evidence: `quartz/components/Search.tsx`)
- Tag page view → Translations: gets labels (evidence: `quartz/components/pages/TagContent.tsx`)
- Tag page view → Processed content model: reads metadata (evidence: `quartz/components/pages/TagContent.tsx`)
- Site emission → Static resources: uses resources (evidence: `quartz/processors/emit.ts`)
- Site emission → Build context: uses context (evidence: `quartz/processors/emit.ts`)
- Site emission → Published garden: writes site
- Published garden → Garden author: publishes garden (evidence: `README.md`)
