Skip to content

Add Korean - #503

Merged
thcp merged 1 commit into
mainfrom
feat/korean-translation
Aug 30, 2026
Merged

Add Korean#503
thcp merged 1 commit into
mainfrom
feat/korean-translation

Conversation

@thcp

@thcp thcp commented Aug 30, 2026

Copy link
Copy Markdown
Collaborator

Closes #501

A tenth language table, 474 keys. Nothing about the machinery needed changing;
it was built to take another one.

What needed care

The plural shape. Korean does not inflect nouns for number, so every plural
family is .other only, the way ja, zhHans and id already do it. Copying
the English key set would have produced a table full of .one keys the resolver
never reads. The coverage check compares plural families rather than raw keys
precisely so that does not read as a gap.

Register. Plain 해요체 rather than the stiffer 합니다체, matching how direct
the other tables are. The audio loanwords a Korean musician already uses stay
loanwords: 보컬, 드럼, 베이스, 루프. Translating those would read as odd to
anyone who has opened a DAW.

Word order. Korean is verb-final, so several strings reorder around their
placeholders rather than substituting in place. Every {placeholder} and every
HTML tag was checked to survive that: 474 strings compared against English, zero
mismatches.

The test that earned its place

tests/js/i18n-detect.test.mjs exists because adding a table to LANGUAGES and
forgetting the matching branch in _detectDefault ships a language nobody's
browser can reach on its own. That is exactly what the first run reported:

FAIL  ko has locales covering it  -- add this language's locales to LOCALES

So ko and ko-KR route to it now, and the test knows about them. 45 pass.

Verified

Coverage script clean: all eleven tables complete at 474 keys, no orphans in the
European Portuguese variant.

Rendered in a browser with the language set to Korean, checked across the app
rather than in one place:

Split stems 스템 분리
Extract 추출
Mixer 믹서
Click to collapse 눌러서 접기
Song structure 곡 구조
4 stems 스템 4개

That last one is the plural family resolving through .other correctly.

83 browser tests pass, node --check clean on every file.

A tenth table, 474 keys. Nothing about the machinery needed changing; it was
built to take another language.

Korean does not inflect nouns for number, so every plural family here is .other
only, the way ja, zhHans and id already do it. Copying the English key set would
have produced a table full of .one keys the resolver never reads, and the
coverage check compares plural families rather than raw keys precisely so that
does not look like a gap.

The register is the plain 해요체 the interface wants rather than the stiffer
합니다체, and the audio loanwords a Korean musician already uses stay loanwords:
보컬, 드럼, 베이스, 루프. Translating those would read as odd to anyone who has
opened a DAW. Korean is verb-final, so several strings reorder around their
placeholders rather than substituting in place; every {placeholder} and every
HTML tag was checked to survive that.

The locale test caught what it was written to catch. Adding a language to
LANGUAGES without a matching branch in _detectDefault ships a table nobody's
browser can reach on its own, and that is exactly what the first run reported:

    FAIL  ko has locales covering it  -- add this language's locales to LOCALES

So ko and ko-KR route to it, and the test knows about them.

Closes #501
@thcp
thcp merged commit 2d2b8f5 into main Aug 30, 2026
10 checks passed
@thcp
thcp deleted the feat/korean-translation branch August 30, 2026 17: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.

StemDeck does not speak Korean

1 participant