# rilov/handbook architecture

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

- Interactive diagram: https://gitdiagram.com/rilov/handbook
- Repository: https://github.com/rilov/handbook

## Overview

This is a Jekyll handbook for browsing quick tech notes, comparisons, and runbooks. Readers enter through the topic index or category pages, then view topic content rendered with Jekyll layouts. The README documents topic/category listing behavior and GitHub Pages hosting; source excerpts were unavailable, so internal template wiring and the filter script’s behavior are not asserted.

Main entry points: [`_topics`](https://github.com/rilov/handbook/tree/main/_topics) (Topic articles), [`_layouts/category.html`](https://github.com/rilov/handbook/blob/main/_layouts/category.html) (Category layout), [`index.md`](https://github.com/rilov/handbook/blob/main/index.md) (Topic index), [`categories`](https://github.com/rilov/handbook/tree/main/categories) (Category pages)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_content["Handbook content"]
  node_index["Topic index<br/>[index.md]"]
  node_topics["Topic articles"]
  node_categories["Category pages"]
end

subgraph group_presentation["Page presentation"]
  node_category_layout["Category layout<br/>[category.html]"]
  node_topic_layout["Topic layout<br/>[topic.html]"]
  node_default_layout["Default layout<br/>[default.html]"]
  node_category_nav["Category navigation"]
  node_styles["Site styles<br/>[style.css]"]
  node_filter["Topic filtering<br/>[filter.js]"]
end

subgraph group_hosting["Browsing and hosting"]
  node_pages["GitHub Pages"]
  node_site["Published handbook"]
end

node_reader(("Reader"))

node_index -->|"lists by category"| node_topics
node_categories -->|"uses layout"| node_category_layout
node_category_layout -->|"shows topics"| node_topics
node_topics -->|"renders with"| node_topic_layout
node_reader -->|"requests pages"| node_pages
node_pages -->|"serves"| node_site

click node_index "https://github.com/rilov/handbook/blob/main/index.md"
click node_topics "https://github.com/rilov/handbook/tree/main/_topics"
click node_categories "https://github.com/rilov/handbook/tree/main/categories"
click node_category_layout "https://github.com/rilov/handbook/blob/main/_layouts/category.html"
click node_topic_layout "https://github.com/rilov/handbook/blob/main/_layouts/topic.html"
click node_default_layout "https://github.com/rilov/handbook/blob/main/_layouts/default.html"
click node_category_nav "https://github.com/rilov/handbook/blob/main/_includes/categories-nav.html"
click node_styles "https://github.com/rilov/handbook/blob/main/assets/css/style.css"
click node_filter "https://github.com/rilov/handbook/blob/main/assets/js/filter.js"

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_index,node_topics,node_categories toneBlue
class node_category_layout,node_topic_layout,node_default_layout,node_category_nav,node_styles,node_filter toneAmber
class node_pages,node_site toneMint
class node_reader toneIndigo
```

## Components

### Handbook content

- [Topic index](https://github.com/rilov/handbook/blob/main/index.md): `index.md`
- [Topic articles](https://github.com/rilov/handbook/tree/main/_topics): `_topics`
- [Category pages](https://github.com/rilov/handbook/tree/main/categories): `categories`

### Page presentation

- [Category layout](https://github.com/rilov/handbook/blob/main/_layouts/category.html): `_layouts/category.html`
- [Topic layout](https://github.com/rilov/handbook/blob/main/_layouts/topic.html): `_layouts/topic.html`
- [Default layout](https://github.com/rilov/handbook/blob/main/_layouts/default.html): `_layouts/default.html`
- [Category navigation](https://github.com/rilov/handbook/blob/main/_includes/categories-nav.html): `_includes/categories-nav.html`
- [Site styles](https://github.com/rilov/handbook/blob/main/assets/css/style.css): `assets/css/style.css`
- [Topic filtering](https://github.com/rilov/handbook/blob/main/assets/js/filter.js): `assets/js/filter.js`

### Browsing and hosting

- **GitHub Pages**
- **Published handbook**

### Other components

- **Reader**

## Connections

- Topic index → Topic articles: lists by category
- Category pages → Category layout: uses layout
- Category layout → Topic articles: shows topics
- Topic articles → Topic layout: renders with
- Reader → GitHub Pages: requests pages
- GitHub Pages → Published handbook: serves