多语言
加语言、改文案、链接写法。
英文默认,不带前缀(/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)
用户看到哪种语言
- 页头切换过的语言,记在 Cookie
i18n_redirected - 第一次打开
/按浏览器语言跳一次,中文浏览器到/zh - 直接打开具体页面不跳
注册时把语言记进 user.locale(en、zh 或空),给以后按语言发邮件用。
线上
hreflang 和 canonical 的域名来自 NUXT_PUBLIC_I18N_BASE_URL,npm run deploy:production 会自动写入。