# guytitt/hebreu architecture

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

- Interactive diagram: https://gitdiagram.com/guytitt/hebreu
- Repository: https://github.com/guytitt/hebreu

## Overview

This repository is a French-language Hebrew Bible learning site: readers browse grammar lessons, verb lexicons and conjugation tables, and biblical word and theme essays. Its main user workflow is navigation through a published collection of linked documents. The tree also contains scripts for generating document navigation, indexes and HTML, plus a small Bottle static-file server; these are auxiliary site operations, not a runtime learning pipeline. Relationships among unsampled content and scripts are limited to what the README or excerpts establish.

Main entry points: [`html`](https://github.com/guytitt/hebreu/tree/main/html) (Published site), [`prog/genereTDM.1.2.py`](https://github.com/guytitt/hebreu/blob/main/prog/genereTDM.1.2.py) (Contents generator), [`prog/genereSiteFrancis.3.0.py`](https://github.com/guytitt/hebreu/blob/main/prog/genereSiteFrancis.3.0.py) (Site generator), [`prog/genereSiteFrancis.2.9.py`](https://github.com/guytitt/hebreu/blob/main/prog/genereSiteFrancis.2.9.py) (Legacy generator)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_learning["Learning content"]
  node_grammar["Hebrew grammar"]
  node_verb_lexicon["Verb lexicons"]
  node_conjugations["Conjugation tables"]
  node_cantillation["Hebrew cantillation"]
  node_grammar_extras["Grammar dossiers"]
  node_waw_study["Waw conversive"]
  node_biblical_words["Biblical word themes"]
  node_hebrew_roots["Hebrew roots"]
  node_other_themes["Other themes"]
end

subgraph group_publishing["Site publishing"]
  node_site_generator["Site generator"]
  node_site_generator_legacy["Legacy generator"]
  node_display_metadata["Display metadata<br/>[genereAffMod.py]"]
  node_format_html["HTML formatter<br/>[mefHTML04.py]"]
  node_format_html_legacy["Legacy formatter<br/>[mefHTML03.py]"]
end

subgraph group_navigation["Navigation features"]
  node_toc_generator["Contents generator<br/>[genereTDM.1.2.py]"]
  node_index_generator["Index generator<br/>[genereIndex.py]"]
  node_list_ui["Collapsible lists<br/>[jsLists.js]"]
  node_complement_list_ui["Complement lists<br/>[jsLists.js]"]
end

subgraph group_serving["Site access"]
  node_static_server["Static server<br/>[serveurWeb.py]"]
  node_site["Published site"]
end

node_reader(("Reader"))

node_reader -->|"browses"| node_site
node_site_generator -->|"writes pages"| node_site
node_site_generator_legacy -->|"writes pages"| node_site
node_toc_generator -->|"writes contents"| node_site
node_toc_generator -->|"reads tree"| node_grammar
node_index_generator -->|"writes index"| node_site
node_static_server -->|"serves files"| node_site

click node_grammar "https://github.com/guytitt/hebreu/blob/main/Documents/Grammaire%20H%C3%A9bra%C3%AFque/A.Elements%20de%20base%20de%20la%20Grammaire/cours%20Grammaire%20assemble.pdf"
click node_verb_lexicon "https://github.com/guytitt/hebreu/blob/main/Documents/Grammaire%20H%C3%A9bra%C3%AFque/B.Les%20Verbes.%20R%C3%A9pertoire%20lexical/3.0%20Repertoire%20lexical%20des%20verbes%20hebreux.pdf"
click node_conjugations "https://github.com/guytitt/hebreu/tree/main/Documents/Grammaire%20H%C3%A9bra%C3%AFque/C.Les%20Verbes.Tableaux%20des%20conjugaisons"
click node_cantillation "https://github.com/guytitt/hebreu/tree/main/Documents/Grammaire%20H%C3%A9bra%C3%AFque/CD.Les%20te'amim%2C%20pour%20savourer%20l'h%C3%A9breu"
click node_grammar_extras "https://github.com/guytitt/hebreu/tree/main/Documents/Grammaire%20H%C3%A9bra%C3%AFque/D.Autres%20dossiers%20(de%20grammaire)"
click node_waw_study "https://github.com/guytitt/hebreu/tree/main/Documents/Grammaire%20H%C3%A9bra%C3%AFque/E.M%C3%A9moire%20sur%20le%20Waw%20conversif"
click node_biblical_words "https://github.com/guytitt/hebreu/tree/main/Documents/Mots%20et%20Themes%20bibliques/Des%20Mots%20de%20la%20Bible"
click node_hebrew_roots "https://github.com/guytitt/hebreu/tree/main/Documents/Mots%20et%20Themes%20bibliques/Des%20Racines%20Hebra%C3%AFques"
click node_other_themes "https://github.com/guytitt/hebreu/tree/main/Documents/Mots%20et%20Themes%20bibliques/Divers%20sujets%20en%20vrac"
click node_site_generator "https://github.com/guytitt/hebreu/blob/main/prog/genereSiteFrancis.3.0.py"
click node_site_generator_legacy "https://github.com/guytitt/hebreu/blob/main/prog/genereSiteFrancis.2.9.py"
click node_toc_generator "https://github.com/guytitt/hebreu/blob/main/prog/genereTDM.1.2.py"
click node_index_generator "https://github.com/guytitt/hebreu/blob/main/prog/genereIndex.py"
click node_display_metadata "https://github.com/guytitt/hebreu/blob/main/prog/genereAffMod.py"
click node_format_html "https://github.com/guytitt/hebreu/blob/main/prog/mefHTML04.py"
click node_format_html_legacy "https://github.com/guytitt/hebreu/blob/main/prog/mefHTML03.py"
click node_list_ui "https://github.com/guytitt/hebreu/blob/main/mef/jsLists.js"
click node_complement_list_ui "https://github.com/guytitt/hebreu/blob/main/complements/mef/jsLists.js"
click node_static_server "https://github.com/guytitt/hebreu/blob/main/prog/serveurWeb.py"
click node_site "https://github.com/guytitt/hebreu/tree/main/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_grammar,node_verb_lexicon,node_conjugations,node_cantillation,node_grammar_extras,node_waw_study,node_biblical_words,node_hebrew_roots,node_other_themes toneBlue
class node_site_generator,node_site_generator_legacy,node_display_metadata,node_format_html,node_format_html_legacy toneAmber
class node_toc_generator,node_index_generator,node_list_ui,node_complement_list_ui toneMint
class node_static_server,node_site toneRose
class node_reader toneIndigo
```

## Components

### Learning content

- [Hebrew grammar](https://github.com/guytitt/hebreu/blob/main/Documents/Grammaire%20H%C3%A9bra%C3%AFque/A.Elements%20de%20base%20de%20la%20Grammaire/cours%20Grammaire%20assemble.pdf): `Documents/Grammaire Hébraïque/A.Elements de base de la Grammaire/cours Grammaire assemble.pdf`
- [Verb lexicons](https://github.com/guytitt/hebreu/blob/main/Documents/Grammaire%20H%C3%A9bra%C3%AFque/B.Les%20Verbes.%20R%C3%A9pertoire%20lexical/3.0%20Repertoire%20lexical%20des%20verbes%20hebreux.pdf): `Documents/Grammaire Hébraïque/B.Les Verbes. Répertoire lexical/3.0 Repertoire lexical des verbes hebreux.pdf`
- [Conjugation tables](https://github.com/guytitt/hebreu/tree/main/Documents/Grammaire%20H%C3%A9bra%C3%AFque/C.Les%20Verbes.Tableaux%20des%20conjugaisons): `Documents/Grammaire Hébraïque/C.Les Verbes.Tableaux des conjugaisons`
- [Hebrew cantillation](https://github.com/guytitt/hebreu/tree/main/Documents/Grammaire%20H%C3%A9bra%C3%AFque/CD.Les%20te'amim%2C%20pour%20savourer%20l'h%C3%A9breu): `Documents/Grammaire Hébraïque/CD.Les te'amim, pour savourer l'hébreu`
- [Grammar dossiers](https://github.com/guytitt/hebreu/tree/main/Documents/Grammaire%20H%C3%A9bra%C3%AFque/D.Autres%20dossiers%20(de%20grammaire)): `Documents/Grammaire Hébraïque/D.Autres dossiers (de grammaire)`
- [Waw conversive](https://github.com/guytitt/hebreu/tree/main/Documents/Grammaire%20H%C3%A9bra%C3%AFque/E.M%C3%A9moire%20sur%20le%20Waw%20conversif): `Documents/Grammaire Hébraïque/E.Mémoire sur le Waw conversif`
- [Biblical word themes](https://github.com/guytitt/hebreu/tree/main/Documents/Mots%20et%20Themes%20bibliques/Des%20Mots%20de%20la%20Bible): `Documents/Mots et Themes bibliques/Des Mots de la Bible`
- [Hebrew roots](https://github.com/guytitt/hebreu/tree/main/Documents/Mots%20et%20Themes%20bibliques/Des%20Racines%20Hebra%C3%AFques): `Documents/Mots et Themes bibliques/Des Racines Hebraïques`
- [Other themes](https://github.com/guytitt/hebreu/tree/main/Documents/Mots%20et%20Themes%20bibliques/Divers%20sujets%20en%20vrac): `Documents/Mots et Themes bibliques/Divers sujets en vrac`

### Site publishing

- [Site generator](https://github.com/guytitt/hebreu/blob/main/prog/genereSiteFrancis.3.0.py): `prog/genereSiteFrancis.3.0.py`
- [Legacy generator](https://github.com/guytitt/hebreu/blob/main/prog/genereSiteFrancis.2.9.py): `prog/genereSiteFrancis.2.9.py`
- [Display metadata](https://github.com/guytitt/hebreu/blob/main/prog/genereAffMod.py): `prog/genereAffMod.py`
- [HTML formatter](https://github.com/guytitt/hebreu/blob/main/prog/mefHTML04.py): `prog/mefHTML04.py`
- [Legacy formatter](https://github.com/guytitt/hebreu/blob/main/prog/mefHTML03.py): `prog/mefHTML03.py`

### Navigation features

- [Contents generator](https://github.com/guytitt/hebreu/blob/main/prog/genereTDM.1.2.py): `prog/genereTDM.1.2.py`
- [Index generator](https://github.com/guytitt/hebreu/blob/main/prog/genereIndex.py): `prog/genereIndex.py`
- [Collapsible lists](https://github.com/guytitt/hebreu/blob/main/mef/jsLists.js): `mef/jsLists.js`
- [Complement lists](https://github.com/guytitt/hebreu/blob/main/complements/mef/jsLists.js): `complements/mef/jsLists.js`

### Site access

- [Static server](https://github.com/guytitt/hebreu/blob/main/prog/serveurWeb.py): `prog/serveurWeb.py`
- [Published site](https://github.com/guytitt/hebreu/tree/main/html): `html`

### Other components

- **Reader**

## Connections

- Reader → Published site: browses
- Site generator → Published site: writes pages (evidence: `prog/genereSiteFrancis.3.0.py`)
- Legacy generator → Published site: writes pages (evidence: `prog/genereSiteFrancis.2.9.py`)
- Contents generator → Published site: writes contents (evidence: `prog/genereTDM.1.2.py`)
- Contents generator → Hebrew grammar: reads tree (evidence: `prog/genereTDM.1.2.py`)
- Index generator → Published site: writes index (evidence: `prog/genereIndex.py`)
- Static server → Published site: serves files (evidence: `prog/serveurWeb.py`)