Skip to content

fix(i18n): the four places seven languages did not reach - #195

Merged
chaxus merged 1 commit into
mainfrom
i18n-audit-fixes
Aug 23, 2026
Merged

fix(i18n): the four places seven languages did not reach#195
chaxus merged 1 commit into
mainfrom
i18n-audit-fixes

Conversation

@chaxus

@chaxus chaxus commented Aug 23, 2026

Copy link
Copy Markdown
Contributor

A pass over the site now that it ships seven languages instead of two. Four gaps, all of them things a reader hits and none of them watched by anything.

1. The language trigger did not fit a phone

Widening it to 132px (so "Português" stopped being cut in half) meant that at 390px it pushed its own caret past the viewport edge and wrapped "Document Editor" onto two lines. Below 620px the bar now drops its GitHub link — that link is in every footer, while the language switch is the only control that changes the language.

2. /history and /404 still offered two languages

Both are hand-written (an app surface and an error page; neither goes through the generator), so their switch does not come from LOCALES. Nothing noticed, because neither page is in the sitemap or the hreflang graph. Both now list all seven, pinned against Object.keys(LOCALES).

3. Portuguese was two different Portugueses

The /pt/ pages, the generator's UI strings and the vendor locale the editor loads (pt.json, not pt-pt.json) are Brazilian. The shell's pt table was largely European — ficheiro, guardados, Definições, "Não é possível anular", "está a meio". One reader saw Brazilian on the landing page, European in /history, Brazilian again in the editor. Fourteen strings rewritten.

4. llms-full.txt was seven times longer than it needed to be

It walks every page under public/, so the translations took it from ~97 KB to 680 KB of the same facts restated seven times. Now English pages only, with a note at the top saying where the mirrors are; /llms.txt still lists them.

Checked and clean

  • SEO coverage: 7 × 21 pages, complete hreflang graph, 154 sitemap URLs
  • Editor language: ?locale= verified per locale down to the vendor frame's lang= and the toolbar text
  • Horizontal overflow: 7 languages × desktop/phone — nothing else escapes the viewport
  • German compounds (Installieren und im Flugzeug nutzen, 35 chars) wrap cleanly in the pillar columns

docs/explorations/2026-08-23-seven-languages-audit.md records the whole pass, including the two things left open: design-audit still only measures English pages, and /history and /404 still duplicate chrome the generator owns everywhere else.

🤖 Generated with Claude Code

A pass over the site now that it ships seven languages instead of two.
Four gaps, all of them things a reader hits and nothing in the suite
watched.

**The language trigger did not fit a phone.** Widening it to 132px so it
could hold "Português" meant that at 390px it pushed its own caret past
the viewport edge and wrapped "Document Editor" onto two lines. Below
620px the bar drops its GitHub link -- that link is in every footer,
while the language switch is the only control that changes the language.

**/history and /404 still offered two languages.** They are hand-written
(an app surface and an error page, neither goes through the generator),
so their switch does not come from LOCALES and nothing noticed: neither
page is in the sitemap or the hreflang graph. Both now list all seven,
pinned against Object.keys(LOCALES).

**Portuguese was two different Portugueses.** The /pt/ pages, the
generator's UI strings and the vendor locale the editor loads (pt.json,
not pt-pt.json) are Brazilian; the shell's pt table was largely European
-- ficheiro, guardados, Definições, "Não é possível anular", "está a
meio". So one reader saw Brazilian on the landing page, European in
/history, and Brazilian again in the editor. Fourteen strings rewritten
to match everything around them.

**llms-full.txt was seven times longer than it needed to be.** It walks
every page under public/, so the translations took it from ~97 KB to
680 KB of the same facts restated. It now covers the English pages and
says at the top where the mirrors are; /llms.txt still lists them.

docs/explorations/2026-08-23-seven-languages-audit.md records the whole
pass, including what was checked and found clean, and the two things
left: design-audit still only measures English, and /history and /404
still duplicate chrome the generator owns everywhere else.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@chaxus
chaxus enabled auto-merge (rebase) August 23, 2026 03:58
@cloudflare-workers-and-pages

Copy link
Copy Markdown

Deploying document with  Cloudflare Pages  Cloudflare Pages

Latest commit: b7b4c18
Status: ✅  Deploy successful!
Preview URL: https://632d2649.document-7hm.pages.dev
Branch Preview URL: https://i18n-audit-fixes.document-7hm.pages.dev

View logs

@chaxus
chaxus merged commit 92891a8 into main Aug 23, 2026
18 checks passed
@chaxus
chaxus deleted the i18n-audit-fixes branch August 23, 2026 04:04
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant