From cfcccbda62ee6756c6b81816719d5bc0c7269c83 Mon Sep 17 00:00:00 2001
From: Kevin Deng <sxzz@sxzz.moe>
Date: Thu, 20 Aug 2026 04:33:40 +0900
Subject: [PATCH] Add Japanese localization support (#11)

---
 app/components/DataSources.vue |   8 +-
 app/generated/face-marks.ts    |   6 +-
 app/locales/all.ts             |   2 +
 app/locales/index.ts           |  20 ++--
 app/locales/ja-jp.ts           | 161 +++++++++++++++++++++++++++++++++
 app/styles/vars.css            |  12 +++
 public/data/sources.json       |  42 +++++++--
 scripts/build-fonts.ts         |  14 ++-
 scripts/sources.ts             |  35 ++++++-
 scripts/tests/i18n.test.ts     |  45 +++++++++
 10 files changed, 321 insertions(+), 24 deletions(-)
 create mode 100644 app/locales/ja-jp.ts
 create mode 100644 scripts/tests/i18n.test.ts

diff --git a/app/components/DataSources.vue b/app/components/DataSources.vue
index b51b211..797a278 100644
--- a/app/components/DataSources.vue
+++ b/app/components/DataSources.vue
@@ -6,6 +6,10 @@ withDefaults(defineProps<{ detailed?: boolean }>(), { detailed: false })
 
 const { t, locale } = useT()
 const list = sources as Source[]
+const localize = (
+  fallback: string,
+  translations?: Source['localizedName'],
+): string => translations?.[locale.value] ?? fallback
 </script>
 
 <template>
@@ -31,7 +35,7 @@ const list = sources as Source[]
               target="_blank"
               rel="noreferrer"
               class="underline decoration-rule underline-offset-4 hover:decoration-ink focus-ring"
-              >{{ source.name }}</a
+              >{{ localize(source.name, source.localizedName) }}</a
             >
             <p
               v-if="detailed && source.note"
@@ -46,7 +50,7 @@ const list = sources as Source[]
               target="_blank"
               rel="noreferrer"
               class="underline decoration-transparent underline-offset-4 hover:decoration-current focus-ring"
-              >{{ source.license }}</a
+              >{{ localize(source.license, source.localizedLicense) }}</a
             >
           </td>
         </tr>
diff --git a/app/generated/face-marks.ts b/app/generated/face-marks.ts
index 79997be..8d171c6 100644
--- a/app/generated/face-marks.ts
+++ b/app/generated/face-marks.ts
@@ -8,9 +8,11 @@ export const FACE_VIEW_BOX = "0 -880 1000 1000"
 
 export const FACE_MARKS: Record<string, Record<string, string>> = {
   "sans": {
-    "黑": "M282 -696C311 -649 337 -586 346 -546L398 -567C390 -607 362 -667 332 -713ZM658 -714C641 -667 607 -598 581 -556L629 -536C656 -576 689 -638 717 -692ZM340 -90C351 -37 358 32 358 74L431 65C431 24 422 -44 410 -96ZM546 -88C568 -36 591 32 599 74L674 56C664 15 640 -52 616 -102ZM749 -92C797 -39 853 35 878 81L951 53C924 6 866 -66 818 -117ZM168 -117C144 -54 101 13 57 52L126 84C174 38 215 -34 240 -99ZM227 -739L461 -739L461 -521L227 -521ZM536 -739L766 -739L766 -521L536 -521ZM55 -224L55 -157L946 -157L946 -224L536 -224L536 -314L861 -314L861 -376L536 -376L536 -458L841 -458L841 -802L155 -802L155 -458L461 -458L461 -376L138 -376L138 -314L461 -314L461 -224Z"
+    "黑": "M282 -696C311 -649 337 -586 346 -546L398 -567C390 -607 362 -667 332 -713ZM658 -714C641 -667 607 -598 581 -556L629 -536C656 -576 689 -638 717 -692ZM340 -90C351 -37 358 32 358 74L431 65C431 24 422 -44 410 -96ZM546 -88C568 -36 591 32 599 74L674 56C664 15 640 -52 616 -102ZM749 -92C797 -39 853 35 878 81L951 53C924 6 866 -66 818 -117ZM168 -117C144 -54 101 13 57 52L126 84C174 38 215 -34 240 -99ZM227 -739L461 -739L461 -521L227 -521ZM536 -739L766 -739L766 -521L536 -521ZM55 -224L55 -157L946 -157L946 -224L536 -224L536 -314L861 -314L861 -376L536 -376L536 -458L841 -458L841 -802L155 -802L155 -458L461 -458L461 -376L138 -376L138 -314L461 -314L461 -224Z",
+    "ゴ": "M734 -825L680 -802C705 -767 740 -709 759 -667L815 -692C795 -730 758 -791 734 -825ZM861 -854L806 -831C833 -796 865 -739 887 -698L943 -722C922 -760 885 -820 861 -854ZM140 -104L140 -13C167 -15 212 -17 253 -17L742 -17L740 39L830 39C829 23 826 -22 826 -58L826 -574C826 -598 828 -629 828 -652C809 -651 779 -650 754 -650L262 -650C230 -650 186 -652 152 -656L152 -567C176 -568 225 -570 263 -570L742 -570L742 -98L251 -98C209 -98 165 -101 140 -104Z"
   },
   "serif": {
-    "宋": "M437 -839L427 -832C463 -801 498 -746 504 -701C573 -650 636 -794 437 -839ZM169 -733L152 -732C157 -667 118 -609 79 -588C56 -575 42 -554 51 -531C63 -505 101 -505 127 -523C156 -543 183 -586 183 -651L836 -651C823 -613 802 -566 786 -534L800 -527C839 -556 892 -604 920 -639C941 -640 952 -642 959 -648L880 -725L835 -681L180 -681C178 -697 175 -715 169 -733ZM848 -489L801 -429L532 -429L532 -580C556 -584 565 -593 567 -607L466 -618L466 -429L72 -429L81 -399L430 -399C356 -230 218 -74 37 28L47 44C233 -40 375 -164 466 -315L466 78L479 78C504 78 532 63 532 54L532 -399C609 -206 742 -53 894 31C904 1 928 -17 955 -20L957 -31C801 -94 642 -236 556 -399L910 -399C923 -399 933 -404 935 -415C902 -447 848 -489 848 -489Z"
+    "宋": "M437 -839L427 -832C463 -801 498 -746 504 -701C573 -650 636 -794 437 -839ZM169 -733L152 -732C157 -667 118 -609 79 -588C56 -575 42 -554 51 -531C63 -505 101 -505 127 -523C156 -543 183 -586 183 -651L836 -651C823 -613 802 -566 786 -534L800 -527C839 -556 892 -604 920 -639C941 -640 952 -642 959 -648L880 -725L835 -681L180 -681C178 -697 175 -715 169 -733ZM848 -489L801 -429L532 -429L532 -580C556 -584 565 -593 567 -607L466 -618L466 -429L72 -429L81 -399L430 -399C356 -230 218 -74 37 28L47 44C233 -40 375 -164 466 -315L466 78L479 78C504 78 532 63 532 54L532 -399C609 -206 742 -53 894 31C904 1 928 -17 955 -20L957 -31C801 -94 642 -236 556 -399L910 -399C923 -399 933 -404 935 -415C902 -447 848 -489 848 -489Z",
+    "明": "M837 -745L837 -545L580 -545L580 -745ZM516 -774L516 -454C516 -245 482 -70 301 68L315 80C480 -13 544 -143 567 -281L837 -281L837 -28C837 -10 831 -4 810 -4C785 -4 661 -13 661 -13L661 3C714 10 744 18 761 29C777 40 784 57 788 78C890 67 901 32 901 -20L901 -732C921 -736 938 -744 945 -753L860 -816L827 -774L591 -774L516 -807ZM837 -516L837 -310L572 -310C578 -358 580 -407 580 -455L580 -516ZM143 -728L331 -728L331 -504L143 -504ZM80 -758L80 -93L90 -93C122 -93 143 -111 143 -116L143 -213L331 -213L331 -133L340 -133C363 -133 393 -150 394 -157L394 -715C414 -720 431 -728 437 -736L357 -798L321 -758L155 -758L80 -789ZM143 -475L331 -475L331 -243L143 -243Z"
   }
 }
diff --git a/app/locales/all.ts b/app/locales/all.ts
index 672dbc1..7d452c4 100644
--- a/app/locales/all.ts
+++ b/app/locales/all.ts
@@ -1,3 +1,4 @@
+import { jaJP } from './ja-jp.ts'
 import { zhCN } from './zh-cn.ts'
 import { zhHK } from './zh-hk.ts'
 import { zhTW } from './zh-tw.ts'
@@ -14,6 +15,7 @@ export const messages: Record<Locale, Messages> = {
   'zh-CN': zhCN,
   'zh-TW': zhTW,
   'zh-HK': zhHK,
+  'ja-JP': jaJP,
 }
 
 export { LOCALES, type Locale }
diff --git a/app/locales/index.ts b/app/locales/index.ts
index 95637a3..86e2ebc 100644
--- a/app/locales/index.ts
+++ b/app/locales/index.ts
@@ -6,7 +6,7 @@ import { zhCN } from './zh-cn.ts'
  * not indexed, and cannot be linked to -- hence no hreflang either. Switching
  * to locale-prefixed routes means changing this file and useT, nothing else.
  */
-export const LOCALES = ['zh-CN', 'zh-TW', 'zh-HK'] as const
+export const LOCALES = ['zh-CN', 'zh-TW', 'zh-HK', 'ja-JP'] as const
 export type Locale = (typeof LOCALES)[number]
 
 /** What the prerendered HTML carries, and what anything unmatched falls back to. */
@@ -48,6 +48,11 @@ export const LOCALE_META: Record<Locale, LocaleMeta> = {
     sans: "'Noto Sans HK'",
     uiFamily: 'UI zh-HK',
   },
+  'ja-JP': {
+    htmlLang: 'ja-JP',
+    sans: "'Noto Sans JP'",
+    uiFamily: 'UI ja-JP',
+  },
 }
 
 /**
@@ -67,19 +72,22 @@ export const LOADERS: Record<Locale, () => Promise<Messages>> = {
   'zh-CN': () => Promise.resolve(zhCN),
   'zh-TW': async () => (await import('./zh-tw.ts')).zhTW,
   'zh-HK': async () => (await import('./zh-hk.ts')).zhHK,
+  'ja-JP': async () => (await import('./ja-jp.ts')).jaJP,
 }
 
 /**
  * The best locale for a browser's language list, in the browser's own order of
- * preference. A tag naming Hong Kong or Macao takes the Hong Kong copy, one
- * naming Taiwan or the traditional script takes the Taiwanese copy, and any
- * other Chinese tag takes the simplified. Anything else leaves it undecided,
- * so the caller can fall back.
+ * preference. Japanese tags take the Japanese copy. A Chinese tag naming Hong
+ * Kong or Macao takes the Hong Kong copy, one naming Taiwan or the traditional
+ * script takes the Taiwanese copy, and any other Chinese tag takes the
+ * simplified. Anything else leaves it undecided, so the caller can fall back.
  */
 export function matchLocale(tags: readonly string[]): Locale | undefined {
   for (const tag of tags) {
     const lower = tag.toLowerCase()
-    if (!lower.startsWith('zh')) continue
+    const language = lower.split('-', 1)[0]
+    if (language === 'ja') return 'ja-JP'
+    if (language !== 'zh') continue
     const parts = new Set(lower.split('-'))
     if (parts.has('hk') || parts.has('mo')) return 'zh-HK'
     if (parts.has('tw') || parts.has('hant')) return 'zh-TW'
diff --git a/app/locales/ja-jp.ts b/app/locales/ja-jp.ts
new file mode 100644
index 0000000..405c082
--- /dev/null
+++ b/app/locales/ja-jp.ts
@@ -0,0 +1,161 @@
+import type { zhCN } from './zh-cn.ts'
+
+export const jaJP: typeof zhCN = {
+  meta: {
+    title: '漢智',
+    name: 'Hanji',
+    description:
+      '中国大陸、香港、台湾、日本の4地域で常用される漢字の字形を比較します。同じ漢字でも、地域によって書き方が異なることがあります。',
+  },
+  region: {
+    cn: { short: '中', full: '中国大陸' },
+    hk: { short: '港', full: '香港' },
+    tw: { short: '台', full: '台湾' },
+    jp: { short: '日', full: '日本' },
+    old: { short: '旧字体', full: '日本の旧字体' },
+  },
+  hero: {
+    title: '一つの漢字、四つの字形',
+    body: '中国大陸、香港、台湾、日本。同じ漢字でも、地域によって書き方が異なることがあります。',
+    split: '分けて見る',
+    merge: '重ねて見る',
+  },
+  nav: {
+    about: 'このサイトについて',
+    github: 'GitHubリポジトリ',
+    theme: '表示テーマを切り替える',
+    back: '漢字表に戻る',
+    options: '表示設定',
+  },
+  options: {
+    title: '表示設定',
+    language: '表示言語',
+    emoji: '地域を旗で表示',
+    emojiHint: '「中・港・台・日」を対応する旗の記号に置き換えます。',
+    outline: '重ね表示で輪郭線を使う',
+    outlineHint:
+      '重ねた字形を輪郭線で表示します。画が一つに潰れにくくなり、違いが分かりやすくなります。',
+  },
+  style: {
+    label: '書体',
+    sans: 'ゴ',
+    serif: '明',
+    sansFull: 'ゴシック体',
+    serifFull: '明朝体',
+  },
+  filter: {
+    dimension: '比較方法',
+    glyph: '字形',
+    cp: 'コードポイント',
+    glyphHint:
+      '見た目の字形で比較します。4地域で同じコードポイントを使っていても、字形が異なれば別として扱います。',
+    cpHint:
+      'Unicodeコードポイントだけで比較します。「骨」のように同じコードポイントで字形が異なる漢字も同一として扱います。',
+    search: '検索',
+    searchPlaceholder: '漢字 / 読み / U+9AA8',
+    strokes: '画数',
+    common: '常用地域',
+    pattern: '差異パターン',
+    tier: '収録区分',
+    variety: '{n}種類の字形',
+    identical: '4地域で同形',
+    clear: '絞り込みを解除',
+    matched: '{n}字',
+  },
+  sort: {
+    label: '並べ替え',
+    common: '常用度',
+    strokes: '画数',
+    cp: 'コードポイント',
+    freq: '文字頻度',
+  },
+  table: {
+    strokes: '画数',
+    freq: '文字頻度',
+    old: '旧',
+    empty:
+      '条件に一致する漢字がありません。画数の範囲を広げるか、別の差異パターンを選んでください。',
+    page: '全{total}ページ中{page}ページ',
+    prev: '前のページ',
+    next: '次のページ',
+    showAll: '{n}字をすべて表示',
+    paginate: 'ページ分割して表示',
+  },
+  char: {
+    codePoint: 'Unicodeコードポイント',
+    strokes: '画数',
+    freq: '中国大陸の文字頻度',
+    reading: '読み方',
+    mandarin: '中国語（普通話）',
+    cantonese: '広東語',
+    on: '音読み',
+    kun: '訓読み',
+    listed: '収録区分',
+    variety: '{n}種類の字形',
+    identical: '字形は共通',
+    onePicked: '1列しか選択されていないため、比較できません',
+    also: '関連項目',
+    alsoOut: '{region}で使われる「{char}」には別の項目があります',
+    alsoIn: '「{char}」の{region}での字形でもあります',
+    stacked: '重ね表示',
+    split: '並列表示',
+    dict: '外部辞書',
+    tierCn: { 1: '一級字', 2: '二級字', 3: '三級字' },
+    tierTw: { 1: '常用国字', 2: '次常用国字' },
+    tierHk: { 1: '常用字' },
+    tierJp: { 1: '常用漢字', 2: '教育漢字' },
+  },
+  about: {
+    title: 'このサイトについて',
+    nameTitle: '名前の由来',
+    name1:
+      '「Hanji」は、各地における漢字の呼び名と、それぞれ一文字ずつ異なります。中国語ピンインのhanziとは「j/z」、日本語のkanjiとは「h/k」、韓国語のhanjaとは「i/a」が違います。同じものでも地域ごとに少しずつ変わる――それこそが、このアプリが扱うテーマです。',
+    name2:
+      'また、Hanjiは閩南語における「漢字」の実際の読みhàn-jīでもあります。つまり造語ではなく、もう一つの地域における呼び方です。中国語名の「漢智」はその音に由来します。',
+    methodTitle: '字形の違いをどう判定しているか',
+    scopeTitle: '収録範囲',
+    sourcesTitle: 'データソース',
+    limitTitle: 'このデータの限界',
+    noticeTitle: '注意事項',
+    thanksTitle: '謝辞',
+    dataTitle: 'データの利用',
+    use: '用途',
+    source: '出典',
+    license: 'ライセンス',
+    method1:
+      'Source Han SansとSource Han Serif（Noto Sans CJKとNoto Serif CJK）は、それぞれ5地域で一つの字形プールを共有し、地域ごとに「コードポイント→CID」のマッピングを持っています。同じプール内でCIDが同じなら同じ字形です。そこで中国大陸、香港、台湾、日本の4つのマッピングを比較し、同じ漢字が4地域で何種類の字形になるかを判定しています。',
+    method2:
+      '判定には2書体の和集合を使います。ゴシック体または明朝体のどちらか一方でも2地域を同形とする場合、同形として扱います。Source Han Sansでは、日本向けに常用漢字のおよそ5分の1に独自字形が用意されていますが、そのうち約200字はSource Han Serifでは分かれていません。「了」「人」「子」「水」「金」などが該当します。一方の書体だけが区別するものは、その書体のデザイン上の判断であり、地域規範の差とはみなしません。',
+    method3:
+      'その代わり、統合されたセルは同じグループの代表地域のフォントで描画され、Noto Sans JP独自のわずかに異なる字形は表示されません。これは「同じとみなす」ために必要な処理です。ページ上で同じと示した2セルは、実際にも同じ字形で描画されなければならないからです。',
+    scope1:
+      '中国大陸の『通用規範漢字表』（2013年）、台湾の『常用國字標準字體表』（1982年）、香港の『常用字字形表』、日本の『常用漢字表』（2010年）の4字表の和集合を収録しています。簡体字・繁体字や日本の新字体・旧字体のようにコードポイントが異なる対応字は1行にまとめ、全{rows}行です。',
+    scope2:
+      'そのうち{identical}行は4地域で字形が完全に一致し、{allDiffer}行は4地域すべてで異なります。字形が同じ漢字も収録しています。これは4地域の漢字表であり、字形差は比較軸の一つにすぎません。',
+    limit1:
+      'ここで測定しているのはSource Hanシリーズの地域別字形デザインであり、各地域の規格そのものではありません。それでも精度の高い代替指標です。Adobeの地域別字形はそれぞれ、中国大陸の『印刷通用漢字字形表』、台湾教育部の『國字標準字體』、香港教育局の『常用字字形表』、日本のJIS X 0208/0213（JIS2004字形）に基づいているためです。',
+    limit2:
+      'Source Hanの香港向け字形は対応範囲が完全ではないため、「香港だけが異なる」パターンは実際より少なく報告される可能性があります。',
+    limit3:
+      '画数は地域ごとに取得します。まずUnihanのkAlternateTotalStrokesを参照します。IRGソース別の値があり最も正確ですが、対象は100あまりのコードポイントのみです。日本については次にkRSAdobe_Japan1_6を使います。Adobe-Japan1-6に収録された日本字形を分析した値なので、「突」は9画ではなく8画です。どちらもなければkTotalStrokesを使いますが、こちらは最大でもzh-Hansとzh-Hantの2区分しかなく、香港と台湾は後者を共有します。',
+    limit4:
+      'そのため、日本列の画数は他の3地域と異なることがよくあります。そのうち約5分の1は字形自体は同一で、数え方だけが違います。日本では「阝」を3画、「ネ」を5画と数えるため、「那」は4地域で同形でも画数が6/6/6/7になります。',
+    limit5:
+      'OpenCCと各地域の規範字表が矛盾する場合は、規範字表を優先します。台湾の『常用國字標準字體表』には「脣」と「祕」が収録されていますが、OpenCCはそれらを「唇」「秘」に変換するため、台湾列には規範字表の字形を使います。コードポイントをまたぐ対応関係はOpenCCに基づきます。ただし、その異体字表には、地域ごとの異なる字形としての同一字（裏/裡）と、別の字を代用する関係（台湾では「著」が「著」と「着」を兼ね、日本では「欠」が「缺」、「缶」が「罐」の代用となる）が混在しています。後者を単純に逆引きすると、代用される側の現行漢字が別の行に吸収されてしまいます。そこで「ある地域の字表が2字を別々に収録している場合は統合しない」という基準を設けています。このため「著」「欠」「缶」「糸」は独立した項目として残り、それらを代用字として使うグループと相互にリンクしています。',
+    notice1:
+      '本サイトのデータは公的・権威的な資料ではありません。漢字の収録範囲、字形、画数、読みは地域ごとの規格間でも異なり、すべての人が納得する唯一のデータは存在しません。',
+    notice2:
+      '長期的な手作業メンテナンスを要する字表にしないため、本プロジェクトでは既存の公開データ――Unicode Unihan、各地域の文化・教育当局が公開する規範字表、AdobeとGoogleの公開フォント資源――を可能な限りそのまま利用しています。判定ルールは上記のとおりで、個人的な取捨選択や立場を示すものではありません。',
+    notice3:
+      '正式な用途では、元の規格や辞書を参照してください。各漢字の詳細ページには、その地域の辞書へのリンクを掲載しています。',
+    notice4:
+      '漢字は膨大なため、誤りを完全には避けられません。データの誤りを見つけた場合は{issues}でお知らせください。',
+    data1: '本サイトの漢字表データはJSON形式で公開しています：',
+    thanks:
+      'OpenCC、Unicode Unihan、zispace/hanzi-chars、Jun Da『Modern Chinese Character Frequency List』、Adobe Source Han、Noto CJKのメンテナーの皆さまに感謝します。一字ずつ比較できる{tofu}は本プロジェクトの先駆けであり、同じくNotoシリーズを使って4地域の字形を区別しています。',
+  },
+  footer: {
+    sources: 'データソース',
+    detail: '詳細説明と謝辞',
+  },
+}
diff --git a/app/styles/vars.css b/app/styles/vars.css
index 5306fc8..ae08bb7 100644
--- a/app/styles/vars.css
+++ b/app/styles/vars.css
@@ -52,6 +52,12 @@ html[lang='zh-HK'] {
     'Noto Sans SC', ui-sans-serif, system-ui, sans-serif;
 }
 
+html[lang='ja-JP'] {
+  --font-ui:
+    'UI Latin Sans', 'UI ja-JP Sans', 'Noto Sans', 'Noto Sans JP',
+    'Noto Sans SC', ui-sans-serif, system-ui, sans-serif;
+}
+
 /* The typeface switch reaches the whole interface, not only the table. The
    language pairs stay more specific so they keep winning. */
 html[data-style='serif'] {
@@ -72,6 +78,12 @@ html[data-style='serif'][lang='zh-HK'] {
     'Noto Serif SC', ui-serif, Georgia, serif;
 }
 
+html[data-style='serif'][lang='ja-JP'] {
+  --font-ui:
+    'UI Latin Serif', 'UI ja-JP Serif', 'Noto Serif', 'Noto Serif JP',
+    'Noto Serif SC', ui-serif, Georgia, serif;
+}
+
 html.dark {
   --c-ink: #e9e7e2;
   --c-ink-soft: #a6a39d;
diff --git a/public/data/sources.json b/public/data/sources.json
index 3f1e799..17cffd5 100644
--- a/public/data/sources.json
+++ b/public/data/sources.json
@@ -4,16 +4,21 @@
     "use": {
       "zh-CN": "判定四地字形差异",
       "zh-TW": "判定四地字形差異",
-      "zh-HK": "判定四地字形差異"
+      "zh-HK": "判定四地字形差異",
+      "ja-JP": "4地域の字形差を判定"
     },
     "name": "Adobe Source Han Sans / Serif（CMap 资源）",
+    "localizedName": {
+      "ja-JP": "Adobe Source Han Sans / Serif（CMapリソース）"
+    },
     "homepage": "https://github.com/adobe-fonts/source-han-sans",
     "license": "SIL OFL 1.1",
     "licenseUrl": "https://openfontlicense.org/",
     "note": {
       "zh-CN": "每套字体的四份地区 CMap 给出「码点 → CID」映射，同一字形池内 CID 相同即同一字形。判定取黑体与宋体的并集。",
       "zh-TW": "每套字體的四份地區 CMap 給出「碼位 → CID」對映，同一字形池內 CID 相同即同一字形。判定取黑體與宋體的聯集。",
-      "zh-HK": "每套字體的四份地區 CMap 給出「碼點 → CID」對應，同一字形池內 CID 相同即同一字形。判定取黑體與宋體的並集。"
+      "zh-HK": "每套字體的四份地區 CMap 給出「碼點 → CID」對應，同一字形池內 CID 相同即同一字形。判定取黑體與宋體的並集。",
+      "ja-JP": "各書体の4地域向けCMapには「コードポイント → CID」の対応があり、同じ字形プール内でCIDが同じなら同一字形です。判定にはゴシック体と明朝体の和集合を使います。"
     }
   },
   {
@@ -21,16 +26,21 @@
     "use": {
       "zh-CN": "页面展示用字体",
       "zh-TW": "頁面顯示用字體",
-      "zh-HK": "頁面顯示用字體"
+      "zh-HK": "頁面顯示用字體",
+      "ja-JP": "画面表示用フォント"
     },
     "name": "Noto Sans / Noto Serif（含 CJK）",
+    "localizedName": {
+      "ja-JP": "Noto Sans / Noto Serif（CJK対応）"
+    },
     "homepage": "https://github.com/notofonts/noto-cjk",
     "license": "SIL OFL 1.1",
     "licenseUrl": "https://openfontlicense.org/",
     "note": {
       "zh-CN": "汉字取自 CJK 版本，拉丁字母与数字取自拉丁版本，都按站内用字子集化后自托管，OFL 声明随附于 /fonts/OFL.txt。",
       "zh-TW": "漢字取自 CJK 版本，拉丁字母與數字取自拉丁版本，都按站內用字子集化後自行託管，OFL 聲明隨附於 /fonts/OFL.txt。",
-      "zh-HK": "漢字取自 CJK 版本，拉丁字母與數字取自拉丁版本，都按站內用字子集化後自行託管，OFL 聲明隨附於 /fonts/OFL.txt。"
+      "zh-HK": "漢字取自 CJK 版本，拉丁字母與數字取自拉丁版本，都按站內用字子集化後自行託管，OFL 聲明隨附於 /fonts/OFL.txt。",
+      "ja-JP": "漢字はCJK版、ラテン文字と数字はラテン版を使用し、サイト内で使う文字だけにサブセット化してセルフホストしています。OFLの表記は/fonts/OFL.txtに同梱しています。"
     }
   },
   {
@@ -38,9 +48,13 @@
     "use": {
       "zh-CN": "简繁、港台异体、日本新旧字体对应",
       "zh-TW": "簡繁、港臺異體、日本新舊字體對應",
-      "zh-HK": "簡繁、港台異體、日本新舊字體對應"
+      "zh-HK": "簡繁、港台異體、日本新舊字體對應",
+      "ja-JP": "簡体字・繁体字、香港・台湾の異体字、日本の新字体・旧字体の対応"
     },
     "name": "OpenCC 开放中文转换",
+    "localizedName": {
+      "ja-JP": "OpenCC（Open Chinese Convert）"
+    },
     "homepage": "https://github.com/BYVoid/OpenCC",
     "license": "Apache-2.0",
     "licenseUrl": "https://www.apache.org/licenses/LICENSE-2.0"
@@ -50,16 +64,21 @@
     "use": {
       "zh-CN": "四地标准字表",
       "zh-TW": "四地標準字表",
-      "zh-HK": "四地標準字表"
+      "zh-HK": "四地標準字表",
+      "ja-JP": "4地域の標準字表"
     },
     "name": "zispace/hanzi-chars",
     "homepage": "https://github.com/zispace/hanzi-chars",
     "license": "仓库未声明",
+    "localizedLicense": {
+      "ja-JP": "リポジトリに記載なし"
+    },
     "licenseUrl": "https://github.com/zispace/hanzi-chars",
     "note": {
       "zh-CN": "转录自各地官方规范：《通用规范汉字表》（2013）、臺灣《常用國字標準字體表》（1982）、香港《常用字字形表》、日本《常用漢字表》（2010）与《学年別漢字配当表》（2017）。",
       "zh-TW": "轉錄自各地官方規範：《通用規範漢字表》（2013）、臺灣《常用國字標準字體表》（1982）、香港《常用字字形表》、日本《常用漢字表》（2010）與《学年別漢字配当表》（2017）。",
-      "zh-HK": "轉錄自各地官方規範：《通用規範漢字表》（2013）、臺灣《常用國字標準字體表》（1982）、香港《常用字字形表》、日本《常用漢字表》（2010）與《学年別漢字配当表》（2017）。"
+      "zh-HK": "轉錄自各地官方規範：《通用規範漢字表》（2013）、臺灣《常用國字標準字體表》（1982）、香港《常用字字形表》、日本《常用漢字表》（2010）與《学年別漢字配当表》（2017）。",
+      "ja-JP": "各地域の公式規範である中国大陸の『通用規範漢字表』（2013年）、台湾の『常用國字標準字體表』（1982年）、香港の『常用字字形表』、日本の『常用漢字表』（2010年）と『学年別漢字配当表』（2017年）から転記されています。"
     }
   },
   {
@@ -67,7 +86,8 @@
     "use": {
       "zh-CN": "笔画数、读音",
       "zh-TW": "筆畫數、讀音",
-      "zh-HK": "筆畫數、讀音"
+      "zh-HK": "筆畫數、讀音",
+      "ja-JP": "画数・読み"
     },
     "name": "Unicode Han Database (Unihan)",
     "homepage": "https://www.unicode.org/reports/tr38/",
@@ -79,9 +99,13 @@
     "use": {
       "zh-CN": "大陆字频排名",
       "zh-TW": "大陸字頻排名",
-      "zh-HK": "大陸字頻排名"
+      "zh-HK": "大陸字頻排名",
+      "ja-JP": "中国大陸の文字頻度順位"
     },
     "name": "hanziDB.csv（Jun Da《现代汉语单字频率列表》）",
+    "localizedName": {
+      "ja-JP": "hanziDB.csv（Jun Da『Modern Chinese Character Frequency List』）"
+    },
     "homepage": "https://github.com/ruddfawcett/hanziDB.csv",
     "license": "MIT",
     "licenseUrl": "https://opensource.org/licenses/MIT"
diff --git a/scripts/build-fonts.ts b/scripts/build-fonts.ts
index 8aaa219..7e5ead1 100644
--- a/scripts/build-fonts.ts
+++ b/scripts/build-fonts.ts
@@ -289,13 +289,19 @@ async function faceMarks(): Promise<string> {
   // far too loosely.
   const viewBox = '0 -880 1000 1000'
   for (const style of STYLES) {
-    const font = fontkit.create(
-      Buffer.from(await raw(otf(style, 'cn'))),
-    ) as fontkit.Font
-    const scale = 1000 / font.unitsPerEm
     for (const locale of Object.keys(messages) as Locale[]) {
       // Each label is drawn in the face it names, and only in that face
       const char = messages[locale].style[style]
+      // Labels shared by several locales only need one outline. Locale order
+      // keeps the existing Chinese marks on the default face, while unique
+      // Japanese labels come from the Japanese face.
+      if (marks[style]?.[char]) continue
+      const source = UI_FONT[locale]
+      if (!source) continue
+      const font = fontkit.create(
+        Buffer.from(await raw(source(style))),
+      ) as fontkit.Font
+      const scale = 1000 / font.unitsPerEm
       const glyph = font.glyphForCodePoint(char.codePointAt(0)!)
       ;(marks[style] ??= {})[char] = glyph.path.scale(scale, -scale).toSVG()
     }
diff --git a/scripts/sources.ts b/scripts/sources.ts
index d311563..9c46d41 100644
--- a/scripts/sources.ts
+++ b/scripts/sources.ts
@@ -12,6 +12,7 @@ import { dirname, join } from 'node:path'
 import process from 'node:process'
 import { fileURLToPath } from 'node:url'
 import { unzipSync } from 'fflate'
+import type { Locale } from '../app/locales/index.ts'
 
 export const ROOT = dirname(dirname(fileURLToPath(import.meta.url)))
 export const RAW_DIR = join(ROOT, 'data/raw')
@@ -22,15 +23,19 @@ export const FONT_DIR = join(ROOT, 'public/fonts')
  * Copy in every interface language. Written out here rather than in the
  * message files because a source belongs with the rest of its record.
  */
-export type Localized = Record<'zh-CN' | 'zh-TW' | 'zh-HK', string>
+export type Localized = Record<Locale, string>
 
 export interface Source {
   id: string
   /** One line on what it is used for. */
   use: Localized
   name: string
+  /** Language-specific replacement when the source name itself has copy. */
+  localizedName?: Partial<Localized>
   homepage: string
   license: string
+  /** Language-specific replacement for a prose license label. */
+  localizedLicense?: Partial<Localized>
   licenseUrl: string
   /** Upstream standard, or a caveat worth stating. */
   note?: Localized
@@ -43,8 +48,12 @@ export const SOURCES: Source[] = [
       'zh-CN': '判定四地字形差异',
       'zh-TW': '判定四地字形差異',
       'zh-HK': '判定四地字形差異',
+      'ja-JP': '4地域の字形差を判定',
     },
     name: 'Adobe Source Han Sans / Serif（CMap 资源）',
+    localizedName: {
+      'ja-JP': 'Adobe Source Han Sans / Serif（CMapリソース）',
+    },
     homepage: 'https://github.com/adobe-fonts/source-han-sans',
     license: 'SIL OFL 1.1',
     licenseUrl: 'https://openfontlicense.org/',
@@ -55,6 +64,8 @@ export const SOURCES: Source[] = [
         '每套字體的四份地區 CMap 給出「碼位 → CID」對映，同一字形池內 CID 相同即同一字形。判定取黑體與宋體的聯集。',
       'zh-HK':
         '每套字體的四份地區 CMap 給出「碼點 → CID」對應，同一字形池內 CID 相同即同一字形。判定取黑體與宋體的並集。',
+      'ja-JP':
+        '各書体の4地域向けCMapには「コードポイント → CID」の対応があり、同じ字形プール内でCIDが同じなら同一字形です。判定にはゴシック体と明朝体の和集合を使います。',
     },
   },
   {
@@ -63,8 +74,12 @@ export const SOURCES: Source[] = [
       'zh-CN': '页面展示用字体',
       'zh-TW': '頁面顯示用字體',
       'zh-HK': '頁面顯示用字體',
+      'ja-JP': '画面表示用フォント',
     },
     name: 'Noto Sans / Noto Serif（含 CJK）',
+    localizedName: {
+      'ja-JP': 'Noto Sans / Noto Serif（CJK対応）',
+    },
     homepage: 'https://github.com/notofonts/noto-cjk',
     license: 'SIL OFL 1.1',
     licenseUrl: 'https://openfontlicense.org/',
@@ -75,6 +90,8 @@ export const SOURCES: Source[] = [
         '漢字取自 CJK 版本，拉丁字母與數字取自拉丁版本，都按站內用字子集化後自行託管，OFL 聲明隨附於 /fonts/OFL.txt。',
       'zh-HK':
         '漢字取自 CJK 版本，拉丁字母與數字取自拉丁版本，都按站內用字子集化後自行託管，OFL 聲明隨附於 /fonts/OFL.txt。',
+      'ja-JP':
+        '漢字はCJK版、ラテン文字と数字はラテン版を使用し、サイト内で使う文字だけにサブセット化してセルフホストしています。OFLの表記は/fonts/OFL.txtに同梱しています。',
     },
   },
   {
@@ -83,8 +100,12 @@ export const SOURCES: Source[] = [
       'zh-CN': '简繁、港台异体、日本新旧字体对应',
       'zh-TW': '簡繁、港臺異體、日本新舊字體對應',
       'zh-HK': '簡繁、港台異體、日本新舊字體對應',
+      'ja-JP': '簡体字・繁体字、香港・台湾の異体字、日本の新字体・旧字体の対応',
     },
     name: 'OpenCC 开放中文转换',
+    localizedName: {
+      'ja-JP': 'OpenCC（Open Chinese Convert）',
+    },
     homepage: 'https://github.com/BYVoid/OpenCC',
     license: 'Apache-2.0',
     licenseUrl: 'https://www.apache.org/licenses/LICENSE-2.0',
@@ -95,10 +116,14 @@ export const SOURCES: Source[] = [
       'zh-CN': '四地标准字表',
       'zh-TW': '四地標準字表',
       'zh-HK': '四地標準字表',
+      'ja-JP': '4地域の標準字表',
     },
     name: 'zispace/hanzi-chars',
     homepage: 'https://github.com/zispace/hanzi-chars',
     license: '仓库未声明',
+    localizedLicense: {
+      'ja-JP': 'リポジトリに記載なし',
+    },
     licenseUrl: 'https://github.com/zispace/hanzi-chars',
     note: {
       'zh-CN':
@@ -107,6 +132,8 @@ export const SOURCES: Source[] = [
         '轉錄自各地官方規範：《通用規範漢字表》（2013）、臺灣《常用國字標準字體表》（1982）、香港《常用字字形表》、日本《常用漢字表》（2010）與《学年別漢字配当表》（2017）。',
       'zh-HK':
         '轉錄自各地官方規範：《通用規範漢字表》（2013）、臺灣《常用國字標準字體表》（1982）、香港《常用字字形表》、日本《常用漢字表》（2010）與《学年別漢字配当表》（2017）。',
+      'ja-JP':
+        '各地域の公式規範である中国大陸の『通用規範漢字表』（2013年）、台湾の『常用國字標準字體表』（1982年）、香港の『常用字字形表』、日本の『常用漢字表』（2010年）と『学年別漢字配当表』（2017年）から転記されています。',
     },
   },
   {
@@ -115,6 +142,7 @@ export const SOURCES: Source[] = [
       'zh-CN': '笔画数、读音',
       'zh-TW': '筆畫數、讀音',
       'zh-HK': '筆畫數、讀音',
+      'ja-JP': '画数・読み',
     },
     name: 'Unicode Han Database (Unihan)',
     homepage: 'https://www.unicode.org/reports/tr38/',
@@ -127,8 +155,13 @@ export const SOURCES: Source[] = [
       'zh-CN': '大陆字频排名',
       'zh-TW': '大陸字頻排名',
       'zh-HK': '大陸字頻排名',
+      'ja-JP': '中国大陸の文字頻度順位',
     },
     name: 'hanziDB.csv（Jun Da《现代汉语单字频率列表》）',
+    localizedName: {
+      'ja-JP':
+        'hanziDB.csv（Jun Da『Modern Chinese Character Frequency List』）',
+    },
     homepage: 'https://github.com/ruddfawcett/hanziDB.csv',
     license: 'MIT',
     licenseUrl: 'https://opensource.org/licenses/MIT',
diff --git a/scripts/tests/i18n.test.ts b/scripts/tests/i18n.test.ts
new file mode 100644
index 0000000..0e606d4
--- /dev/null
+++ b/scripts/tests/i18n.test.ts
@@ -0,0 +1,45 @@
+import { describe, expect, it } from 'vitest'
+import { matchLocale } from '../../app/locales/index.ts'
+import { jaJP } from '../../app/locales/ja-jp.ts'
+import { zhCN } from '../../app/locales/zh-cn.ts'
+
+function leaves(value: unknown, prefix = ''): Record<string, string> {
+  if (typeof value === 'string') return { [prefix]: value }
+  return Object.fromEntries(
+    Object.entries(value as Record<string, unknown>).flatMap(([key, child]) =>
+      Object.entries(leaves(child, prefix ? `${prefix}.${key}` : key)),
+    ),
+  )
+}
+
+const params = (message: string): string[] =>
+  [...message.matchAll(/\{(\w+)\}/g)].map((match) => match[1]!).toSorted()
+
+describe('browser locale matching', () => {
+  it.each(['ja', 'ja-JP', 'ja-Jpan-JP'])('matches %s to Japanese', (tag) => {
+    expect(matchLocale([tag])).toBe('ja-JP')
+  })
+
+  it('uses the first supported language in browser preference order', () => {
+    expect(matchLocale(['en-US', 'ja-JP', 'zh-TW'])).toBe('ja-JP')
+  })
+
+  it('keeps the existing Chinese region matching', () => {
+    expect(matchLocale(['zh-Hans'])).toBe('zh-CN')
+    expect(matchLocale(['zh-Hant'])).toBe('zh-TW')
+    expect(matchLocale(['zh-MO'])).toBe('zh-HK')
+  })
+})
+
+describe('Japanese messages', () => {
+  it('has every message and interpolation parameter in the default locale', () => {
+    const base = leaves(zhCN)
+    const translated = leaves(jaJP)
+
+    expect(Object.keys(translated).toSorted()).toEqual(
+      Object.keys(base).toSorted(),
+    )
+    for (const [key, message] of Object.entries(base))
+      expect(params(translated[key]!), key).toEqual(params(message))
+  })
+})
-- 
2.51.2