Nuxt Starter

多语言

加语言、改文案、链接写法。

英文默认,不带前缀(/login);中文在 /zh 下(/zh/login)。用的是 @nuxtjs/i18n。

文件

位置 内容
shared/locales.ts 支持的语言、默认语言、翻译文件列表
i18n/locales/<语言>/common.json 页头、首页、错误页
i18n/locales/<语言>/auth.json 登录注册、错误提示
i18n/locales/<语言>/account.json 账号页
nuxt.config.ts 的 i18n 路由策略、哪些页面不分语言

写法

<script setup lang="ts">
const { t } = useI18n()
const localePath = useLocalePath()
</script>

<template>
  <h1>{{ t('auth.login.title') }}</h1>
  <NuxtLink :to="localePath('/login')">{{ t('common.header.signIn') }}</NuxtLink>
</template>
  • 每个 JSON 的顶层 key 就是文件名,auth.json 里写 { "auth": { ... } }
  • 中文缺某条时显示英文
  • 站内链接、回调地址都用 localePath()
  • 错误码转文案:t(authErrorKey(code, status)),见 app/lib/auth-errors.ts

常见改动

  • 加一种语言:shared/locales.ts 加一项,复制 i18n/locales/en/ 成新目录再翻译
  • 加一个翻译文件:每种语言目录各放一份,在 messageFiles 里登记
  • 只做一种语言:shared/locales.ts 只留一项
  • 改默认语言:改 defaultLocale,重新构建发布
  • 某页只要一种语言:加进 nuxt.config.ts 的 i18n.pages,设为 false(现在是 /docs、/privacy、/terms)

用户看到哪种语言

  1. 页头切换过的语言,记在 Cookie i18n_redirected
  2. 第一次打开 / 按浏览器语言跳一次,中文浏览器到 /zh
  3. 直接打开具体页面不跳

注册时把语言记进 user.locale(en、zh 或空),给以后按语言发邮件用。

线上

hreflang 和 canonical 的域名来自 NUXT_PUBLIC_I18N_BASE_URL,npm run deploy:production 会自动写入。