@aparte/locales

中文文档
0.32.1发布于 2026/11/02MITTypeScriptES Module零依赖构建来源已验证近 30 天下载 3352

The chat’s interface in nine languages for aparté — French, Spanish, Portuguese (Brazil), German, Italian, Russian, Japanese, Korean and Chinese (Simplified). Pass one to aparteGlobalConfig.setLocale(); core ships English.

原始使用文档

@aparte/locales

The chat's interface in nine languages for aparté: every label, button and screen-reader string the chat draws. Core ships English (APARTE_DEFAULT_LOCALE); install this to switch.

npm install @aparte/locales @aparte/core
import { aparteGlobalConfig } from '@aparte/core';
import { es } from '@aparte/locales/es';

aparteGlobalConfig.setLocale(es);

Each language is its own entry, so a page loads only the one it imports. All of them are also named exports of the package root.

LanguageEntryExporttag
French@aparte/locales/frfrfr-FR
Spanish@aparte/locales/eseses
Portuguese (Brazil)@aparte/locales/pt-BRptBRpt-BR
German@aparte/locales/dedede
Italian@aparte/locales/ititit
Russian@aparte/locales/rururu
Japanese@aparte/locales/jajaja
Korean@aparte/locales/kokoko
Chinese (Simplified)@aparte/locales/zh-CNzhCNzh-CN

Every language translates every string core draws, keeps English's placeholders ({tool}, {n}, {name}…), and is written left to right. The tag also sets how dates and numbers are formatted.

To follow the browser's language, with English when none matches:

import { aparteGlobalConfig } from '@aparte/core';
import { de, es, fr } from '@aparte/locales';

const byLanguage = { de, es, fr };
const language = navigator.language.slice(0, 2) as keyof typeof byLanguage;
if (byLanguage[language]) aparteGlobalConfig.setLocale(byLanguage[language]);

@aparte/core is a peer dependency. The Localization guide covers the whole AparteLocale surface, a locale of your own, and strings of your own.

ESM-only. Part of the aparté monorepo.

版本与发布记录

@aparte/locales 共发布 19 个版本,首次发布于 2026/10/27;过去 12 个月发布了 19 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.32.1latest2026/11/024 天前
0.32.02026/11/024 天前
0.31.02026/11/024 天前
0.30.12026/11/014 天前
0.30.02026/11/014 天前
0.29.42026/11/015 天前

关于 @aparte/locales 的常见问题

@aparte/locales 是什么?

The chat’s interface in nine languages for aparté — French, Spanish, Portuguese (Brazil), German, Italian, Russian, Japanese, Korean and Chinese (Simplified). Pass one to aparteGlobalConfig.setLocale(); core ships English.

如何安装 @aparte/locales?

在项目目录运行 npm install @aparte/locales,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:@aparte/core(>=0.32.1 <1.0.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@aparte/locales 支持 TypeScript 吗?

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

@aparte/locales 支持 ESM 还是 CommonJS?

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

@aparte/locales 需要什么版本的 Node.js?

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

@aparte/locales 可以商用吗?

@aparte/locales 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@aparte/locales 的下载量有多少?

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

@aparte/locales 还在维护吗?

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