History

Doxa Maps ac71afaf55 Share opens on "Share this page"; Embed is its own tab; a header menu opens beside its button (shareable pages P3) ShareButton: the first tab is "Share this page", the link to exactly what the reader is looking at. Where the page owns its address (urlOwner 'app' or 'host', on the map's own profile-config or any element above it across shadow roots) that is the page's own URL, read at open and at copy; on a partner's page it is the map's own page, as before. The second tab, "Embed", says in plain words what embedding is and why it helps, keeps the buttons.shareSteps list, then the paste hint, the sizes and the code. Copy/sizes labels come from the catalogue. MapControlMenu: a standalone anchor (a Share button outside any map toolbar) resolves where its menu lives when it opens, and places it below the button, toward the side with room, inside the viewport, at the readable width (340 or the viewport minus its edges), converting into the menu's real containing block. The render-time area tag that sent header menus far left and narrow is gone. Map toolbars keep their placement unchanged. English only for now (the new share.json keys are recorded as translation debt in check:i18n-parity). check:map-menu-anchor reads a resolution that lives in a named function, every named-area return must keep its structural fallback.		2026-10-03 06:05:46 +00:00
..
locales	Share opens on "Share this page"; Embed is its own tab; a header menu opens beside its button (shareable pages P3)	2026-10-03 06:05:46 +00:00
CATALOGUES.md	Speak the reader's language on the UPG-100 map, its wall and the print HUD	2026-09-29 08:33:43 +00:00
index.js	Comments name no internal hosts or teams; the A9 leaf-hint comment every page carries is neutral	2026-09-30 22:36:47 +00:00
keyedError.js	Speak the reader's language on the UPG-100 map, its wall and the print HUD	2026-09-29 08:33:43 +00:00
README.md	consolidate docs into documentation/ and deployment shells into deployment/	2026-09-21 23:23:23 +00:00
useRegionsI18n.js	A country map you can drop on one page, without the dashboard around it	2026-09-29 01:38:07 +00:00

README.md

library/i18n/ — the map's translations

One of the three customization seams (colors/, api/, i18n/). This one owns every user-facing string. Translations are one folder per locale, one JSON file per area, inlined at build time into a Vue I18n instance (one per <doxa-map>, so embeds don't bleed state).

  i18n/
  ┌───────────────────────────────┐
  │ index.js   ← engine, don't edit │
  │ locales/                        │
  │   en/  buttons.json legend.json …│  ← en is the source of truth + fallback
  │   es/ ar/ zh/ …  (same keys)     │  ← 11 shipped locales, drop in your own
  └───────────────────────────────┘
     filename → namespace:  buttons.json → $t('buttons.prayForThem')

11 shipped locales; ar renders right-to-left (RTL_LOCALES).
Add a language by copying locales/en/ to locales/<code>/ — never by editing index.js (except adding the code to SUPPORTED_LOCALES).
Missing keys fall back to English silently.

Adding or overriding a locale? The full contract (locale matrix, checklist, integration) is in ../../documentation/architecture/i18n.md.