Bitcoin, Lightning & mobile money terminology, translated and explained.
# Bitcoin Glossary
A multilingual dictionary of Bitcoin, Lightning and mobile money terminology, published at
glossary.exonumia.africa. Every term occupies one row, with
a dedicated column per language, so translations can be read and compared side by side.
Currently **359 terms** across **14 categories** in **4 languages** — English, Gĩkũyũ, Kiswahili
and Soomaali.
A collaborative initiative by a collective of Translators, Localization Labs, HRF, and
exonumia.africa. Translations are community contributions and remain a work in progress.
## Running it
Static HTML, CSS and JavaScript — no build step, no dependencies, no framework. It does need to
be served over HTTP, because the page fetches the JSON files under `i18n/` and browsers block
that on `file://` URLs.
```bash
python3 -m http.server 4173
```
Then open . Deployment is a plain upload of the repository root to any
static host.
## Files
| File | Purpose |
| --- | --- |
| `index.html` | Page shell — masthead, toolbar, sidebar, footer |
| `styles.css` | Dictionary theme, light and dark, responsive |
| `app.js` | Loads the JSON, builds the model, renders and filters |
| `i18n/manifest.json` | Lists the language codes, in column order |
| `i18n/ .json` | One file per language — the data that changes when a translation lands |
| `conversion-script.py` | Turns the translators' CSV exports into the `i18n/` files |
| `tests/` | Unittest suite asserting the documented data claims and helper behavior |
| `.claude/skills/glossary-localization/` | Self-contained agent skill teaching LLM coding agents to localize with this glossary — `SKILL.md`, the termbase helper in `scripts/glossary.py` (lookup, text scan, reverse and cross-language reverse lookup), and `references/eval-plan.md` |
## The data
Each language lives in its own file, `i18n/ .json`, keyed by category, then a list of
entries. `i18n/manifest.json` holds the language codes in the order the columns should appear:
```json
["en", "ki", "sw", "so"]
``` …