@authup/i18n

中文文档
1.0.0-beta.73发布于 2026/11/02Apache-2.0TypeScriptES Module近 30 天下载 1987

Authup的英文,德文,法文和西班牙文翻译目录,准备到一个Ingo商店.

中文使用文档
文档目录9 节
  1. 为什么?
  2. 安装
  3. 使用量
  4. 装入目录
  5. 选择单数或复数
  6. 命名空间
  7. API 密码
  8. 页:1
  9. 许可证

Authup logo

@authup/i18n (英语)

Authup的英文,德文,法文和西班牙文翻译目录,准备到一个Ingo商店.
标签,出错消息和邮件复制控制台和服务器使用,没有附加框架.

npm version CI License: Apache-2.0

安装 • 妇女 使用量 • 妇女 API 密码 • 妇女 文档


为什么?

嵌入 Authup 的 UI 组件, 使 Authup 错误代码或名称权限需要相同的单词 Authup 使用, 使用相同的语言 。 这个软件包是作为简单数据的单词:a 灵通 您加载到商店的目录树, 加上地方注册簿和关键语句 .

关切没有它用这个
错误消息每张信件表 ErrorCode 你可能会收到authupError 名称空间, 由 ErrorCode 数值 @authup/errors
权限和范围名称显示原始标识符, 如 user_updateauthupPermission, (中文(简体) ), authupScope 财务报告和审定财务报表 authupPolicy 提供每个内置标识符的显示名称
语言手持辅助语言列表LOCALES, (中文(简体) ), isLocale 财务报告和审定财务报表 matchLocale 超过四个作者的地盘
密钥漂移在一个语言中缺少的密钥在运行时出现每个目录都按其关键词键入,一个对等测试检查所有四个地方

安装

npm install @authup/i18n ilingo

仅限无害环境管理。 节点.js >=26.0.0。 。 。 . ilingo 是此软件包的依赖性; 当代码构建时, 也可以自行安装 Ilingo 举个例子. @ebec/core 财务报告和审定财务报表 validup 是可选的对等方:它们只对输入的有关系 IssueDataByCode 增加此套件声明 .

使用量

装入目录

import {
    CATALOGS,
    DEFAULT_LOCALE,
    TranslatorTranslationMailKey,
    TranslatorTranslationNamespace,
    matchLocale,
} from '@authup/i18n';
import { ErrorCode } from '@authup/errors';
import { Ilingo, MemoryStore } from 'ilingo';

const ilingo = new Ilingo({
    store: new MemoryStore({ data: CATALOGS }),
    locale: DEFAULT_LOCALE,
});

const locale = matchLocale('de-DE') ?? DEFAULT_LOCALE; // 'de'

await ilingo.get({
    namespace: TranslatorTranslationNamespace.ERROR,
    key: ErrorCode.ENTITY_NOT_FOUND,
    locale,
});

await ilingo.get({
    namespace: TranslatorTranslationNamespace.MAIL,
    key: TranslatorTranslationMailKey.PASSWORD_RESET_EXPIRY,
    data: { minutes: 30 },
}); // 'The code expires in 30 minutes.'
  • CATALOGS 是一个灵通 CatalogNode (当地,然后命名空间,然后翻译),所以 MemoryStore({ data: CATALOGS }) 把它当作现在和 getSync 还行.
  • matchLocale 小写标签, 保留主子标签, 当它是一个作者语言时返回它, 否则 undefined。 。 。 .
  • 值可能包含 {{name}} 占位符,从 data。 。 。 .

选择单数或复数

import { TranslatorTranslationEntityKey, TranslatorTranslationNamespace } from '@authup/i18n';
import type { Ilingo } from 'ilingo';

declare const ilingo: Ilingo;

await ilingo.get({
    namespace: TranslatorTranslationNamespace.ENTITY,
    key: TranslatorTranslationEntityKey.USER,
    count: 1,
}); // 'User'

实体名词为Inglo复数节点: count: 1 选择单数,其他任意数复数.

命名空间

Enum 成员命名空间密钥
ENTITYauthupEntityTranslatorTranslationEntityKey复数名词
FIELDauthupFieldTranslatorTranslationFieldKey
ACTIONauthupActionTranslatorTranslationActionKey
COMMONauthupCommonTranslatorTranslationCommonKey
CLIENTauthupClientTranslatorTranslationClientKey
APPauthupAppTranslatorTranslationAppKey
ERRORauthupErrorErrorCode 从 @authup/errors
MAILauthupMailTranslatorTranslationMailKey,交易邮件副本
PERMISSIONauthupPermissionPermissionName 从 @authup/core-kit
SCOPEauthupScopeScopeName 从 @authup/core-kit
POLICYauthupPolicySystemPolicyName 从 @authup/access
VUECSvuecsTranslatorTranslationVuecsKey,为 @vuecs/* 组件

API 密码

导出仁爱目的
CATALOGS针头每个作者的地块和命名空间,作为 INGO 目录节点
TranslatorTranslation<Namespace><Language>针头一个地方的一个命名空间,例如:. TranslatorTranslationErrorGerman
TranslatorTranslationNamespace语句上面的空间名称
TranslatorTranslation<Namespace>Key语句每个认证拥有的命名空间的密钥集
LOCALES, (中文(简体) ), LOCALE_CODES, (中文(简体) ), DEFAULT_LOCALE针头en, (中文(简体) ), de, (中文(简体) ), fr, (中文(简体) ), es 带有本地名称;默认为 en
isLocale, (中文(简体) ), matchLocale函数将字符串或 BCP-47 标记缩入作者的本地端
LocaleCode, (中文(简体) ), LocaleDescriptor, (中文(简体) ), NamespaceTranslations, (中文(简体) ), AuthupErrorData, (中文(简体) ), SystemPolicyNameValue类型区域、目录和错误数据类型

页:1

  • 政策名称包含点. system.default 是通向inglo的路,所以当您向上看时,请避开点: key: 'system\\.default'。 。 。 .
  • 命名空间的前缀为 authup 因此它们不能与主机应用程序自己的目录相撞. 仅 vuecs 不是的,因为它压倒了 @vuecs/* 组件自己的命名空间.
  • 每一个目录都充满了热情. 四个地方都在 CATALOGS; 还没有每个地方的懒惰装入.

许可证

由 所制

现按 Apache 2.0 许可证。 。 。 .

版本与发布记录

@authup/i18n 共发布 29 个版本,首次发布于 2026/06/09;过去 12 个月发布了 29 个版本。

版本发布日期距今
1.0.0-beta.73latest2026/11/025 天前
1.0.0-beta.722026/10/2711 天前
1.0.0-beta.712026/10/2018 天前
1.0.0-beta.702026/10/1919 天前
1.0.0-beta.692026/10/1424 天前
1.0.0-beta.682026/09/251 个月前

关于 @authup/i18n 的常见问题

@authup/i18n 是什么?

Authup的英文,德文,法文和西班牙文翻译目录,准备到一个Ingo商店.

如何安装 @authup/i18n?

在项目目录运行 npm install @authup/i18n,或使用 pnpm add / yarn add / bun add。

@authup/i18n 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@authup/i18n 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@authup/i18n 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=26.0.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@authup/i18n 可以商用吗?

@authup/i18n 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@authup/i18n 的下载量有多少?

根据 npm 官方下载统计,@authup/i18n 在 2026/10/07 – 2026/11/05 这 30 天内被下载 1,987 次,日均约 66 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@authup/i18n 还在维护吗?

最新版本 1.0.0-beta.73 发布于 2026/11/02(5 天前);至今共发布 29 个版本,其中过去 12 个月发布了 29 个;首次发布于 2026/06/09。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。