# @authup/i18n 中文文档

规范地址：https://npmcn.com/package/%40authup/i18n/

版本：1\.0\.0-beta\.73
npm 元数据更新时间：2026-11-01T20:47:01.140Z
中文译文更新时间：2026-11-07T08:24:58.687Z
软件包许可：Apache-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40authup/i18n
原文对照：https://npmcn.com/package/%40authup/i18n/?lang=original
项目主页：https://github.com/authup/authup#readme
源码仓库：https://github.com/authup/authup

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：612 kB，123 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=26\.0\.0
- 运行依赖：4 个
- peer 依赖：validup ^2\.0\.1，@ebec/core ^1\.3\.2
- 首次发布：2026-06-09T08:31:52.981Z
- 最新版本发布：2026-11-01T20:47:00.859Z
- 近 30 天下载量：1987（2026-10-07 至 2026-11-05，npm 官方下载统计）
- 已发布版本数：29（近 12 个月 29 个）

## 中文简介

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

## 安装

```sh
npm install @authup/i18n
```

也可以使用：`pnpm add @authup/i18n`、`yarn add @authup/i18n`、`bun add @authup/i18n`

## README

![Authup logo](https://raw.githubusercontent.com/authup/authup/master/.github/assets/logo.svg)

# @authup/i18n (英语)

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

[![npm version](https://img.shields.io/npm/v/@authup/i18n)](https://www.npmjs.com/package/@authup/i18n) [![CI](https://github.com/authup/authup/actions/workflows/main.yml/badge.svg)](https://github.com/authup/authup/actions/workflows/main.yml) [![License: Apache-2.0](https://img.shields.io/badge/license-Apache--2.0-blue)](https://npmcn.com/package/%40authup/i18n/LICENSE)

[**安装**](https://npmcn.com/package/%40authup/i18n/#readme-installation) • 妇女 [使用量](https://npmcn.com/package/%40authup/i18n/#readme-usage) • 妇女 [API 密码](https://npmcn.com/package/%40authup/i18n/#readme-api) • 妇女 [文档](https://authup.org/)

* * *

## 为什么?

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

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

## 安装

```shell
npm install @authup/i18n ilingo
```

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

## 使用量

### 装入目录

```typescript
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`。 。 。 .

### 选择单数或复数

```typescript
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 成员 | 命名空间 | 密钥 |
| --- | --- | --- |
| `ENTITY` | `authupEntity` | `TranslatorTranslationEntityKey`复数名词 |
| `FIELD` | `authupField` | `TranslatorTranslationFieldKey` |
| `ACTION` | `authupAction` | `TranslatorTranslationActionKey` |
| `COMMON` | `authupCommon` | `TranslatorTranslationCommonKey` |
| `CLIENT` | `authupClient` | `TranslatorTranslationClientKey` |
| `APP` | `authupApp` | `TranslatorTranslationAppKey` |
| `ERROR` | `authupError` | `ErrorCode` 从 `@authup/errors` |
| `MAIL` | `authupMail` | `TranslatorTranslationMailKey`,交易邮件副本 |
| `PERMISSION` | `authupPermission` | `PermissionName` 从 `@authup/core-kit` |
| `SCOPE` | `authupScope` | `ScopeName` 从 `@authup/core-kit` |
| `POLICY` | `authupPolicy` | `SystemPolicyName` 从 `@authup/access` |
| `VUECS` | `vuecs` | `TranslatorTranslationVuecsKey`,为 `@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 许可证](https://npmcn.com/package/%40authup/i18n/LICENSE)。 。 。 .

## 常见问题

### @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 和提交记录判断。