@gluhar/i18n
Gluhar i18n 软件包. 安装和配置 @nuxtjs/i18n 从一个工程文件,并提供 useMessages 键.
I18n如何在克卢哈尔项目中工作
有两种文字,它们从不混合:
| 它的栖息地点 | 读取 | |
|---|---|---|
| 用户界面字符串 (按钮、标签、错误) | lang/<code>.json,随建筑一起运出 | t("key") |
| 内容 (任何编辑写作) | 卫生,本地化 每个字段 (单位:千美元)localeString, (中文(简体) ), localeText, (中文(简体) ), localeBlock(中文(简体) ) | l(field) |
UI 字符串不在 Sanity 中被编写 。 镜像工作室文档 lang/*.json 是真理的第二个来源和两个漂移——v6被移除 loadMessages 编辑 Translations 类型.
配置 - config/i18n.config.ts
当地人唯一的真相来源. 工作室也导入了它,所以保持一个平坦的静态模块.
export const locales = [
{ code: "bg", language: "bg-BG", name: "Български" },
{ code: "en", language: "en-GB", name: "English" },
] as const;
export const defaultLocale = "bg";
// Optional. Locale t() falls back to for a missing key. Default: defaultLocale.
export const fallbackLocale = "en";
as const 需要: LangCode 从中键入。 永远不要在任何地方写一个地语编码(路由规则,站点地图排除,重定向)——来源于 locales 编号 : defaultLocale。哪个地方是默认变化的频率比你想象的要多.
信件输入 lang/<code>.json (记名键是好的). 键从 默认 语言文件,所以 t("missing.key") 是类型错误.
默认
strategy: "prefix_except_default"——默认的地块没有前缀,其他的都是/<code>/…。 。 。 .detectBrowserLanguage: false- 饼干驱动302开/无法与 ISR- crashed HTML 工作,并与hreflang相矛盾. 取出语言者为开关.fallbackLocale通过生成 vue-i18n 配置应用。 要完全接管 vue-i18n 配置,添加i18n/i18n.config.ts(单位:千美元)defineI18nConfig它胜过创造者.
已解决的选项写入 nuxt.options.i18n,所以读取回 i18n 配置的模块(@nuxtjs/sitemap, nuxt-seo),参见真实的当地人. 不要在顶层镜像配置 i18n 键 ——v5项目做了这个工作;v6项目重复了每个地方. 其它 @nuxtjs/i18n 选项(例如). baseUrl进去 gluhar.i18n 或顶层 i18n 键 - 只是不 locales。 。 。 .
使用量
const { t, l, locale } = useMessages();
t("form.submit"); // typed key from lang/<default>.json
t("plan.symmetric", { speed: 500 }); // fills "[speed]"; unfilled [x] are removed
l(page.title); // { bg, en } → the active locale's value
l() 已经 无后退:只用一种语言填入的字段使另一种语言空出.
类型 : LocaleString, (中文(简体) ), LocaleBlocks, (中文(简体) ), LocaleField<V> (从 @gluhar/i18n/types 以及产生的全球效应 LangCode 财务报告和审定财务报表 MessageKey。 。 。 .
捐款
地方发展
# Install dependencies
npm install
# Generate type stubs
npm run dev:prepare
# Develop with the playground
npm run dev
# Build the playground
npm run dev:build
# Run ESLint
npm run lint
# Run Vitest
npm run test
npm run test:watch
# Release new version
npm run release