@bluecateng/l10n-cli

中文文档
0.3.0发布于 2026/08/14ISCES Module构建来源已验证近 30 天下载 1867

L10n指挥线公用事业

中文使用文档
文档目录11 节
  1. 安装
  2. 配置
  3. 大麻兰斯
  4. 源代码
  5. 模块
  6. 目录
  7. 语言
  8. 使用量
  9. 提取字符串
  10. 建筑目录
  11. 在JetBrains IDEs(WebStorm/IDEA)中用作文件监视器

@bluecateng/l10n-cli

L10n的指挥线公用事业.

从旧版本升级? 见 移徙指南。 。 。 .

安装

npm i -D @bluecateng/l10n-cli

配置

将这个格式的对象添加到 package.json。所有路径都相对目录 package.json 已经定位.

"bc-l10n": {
  "hashLength": <number>,
  "sourcePath": <string>,
  "module": <string>,
  "catalogPath": <string>,
  "locales": <Array<string>>
}

大麻兰斯

为了在生产中保存空间,代码只包含原字符串的散列. 此字段指定了散列的截取长度 . 它应该是避免冲突的最低长度,冲突在建设时得到确认.

  • 要求:是
  • 示例 3

源代码

通取出处之道.

  • 要求:无
  • 默认 : "src"

模块

装入字符串的模块路径(参见 @bluecateng/l10n-core) (中文(简体) ).

  • 要求:是
  • 示例 "src/l10n"

目录

创建信件目录文件的路径 . 它必须包含符号"{locale}",它将被相应的地块所取代. 它不得包含扩展,扩展将在生成时附加.

  • 要求:是
  • 示例 "src/l10n/{locale}"

语言

清单 BCP-47 (单位:千美元) 地方代码.

  • 要求:无
  • 默认 : ["en"]
  • 示例 ["en", "fr"]

使用量

提取字符串

命令行可以使用两种模式:

  • 在开发过程中从单个文件中提取字符串,用于单个地方.
  • 在承诺从所有源文件中提取所有配置的本地文件的字符串之前.

npx @bluecateng/l10n-cli [ -l <locale> ] [ <file-paths> ... ]

语言

要更新的单一地块代码 。 如果没有指定,则将更新所有已配置的地块 .

文件路径

用于提取字符串的源文件路径 . 如果没有指定,所有源文件都将被扫描.

建筑目录

编译 .po 每个已配置的地块的目录 .po.js 可直接导入的模块(参见 @bluecateng/l10n-core) (中文(简体) ).

npx @bluecateng/l10n-cli build <outDir>

离线

编译的目录 .po.js 文件将被写入 . 每个目录都写在与其对应的路径上 catalogPath相对 sourcePath 并扎根于 outDir。 。 。 .

  • 示例:与 sourcePath "src" 财务报告和审定财务报表 catalogPath "src/l10n/{locale}",则 en 目录写入 <outDir>/l10n/en.po.js。 。 。 .

在JetBrains IDEs(WebStorm/IDEA)中用作文件监视器

此配置可以在设置 > 下添加 工具 > 文件监视器.

PO file watcher configuration

版本与发布记录

@bluecateng/l10n-cli 共发布 8 个版本,首次发布于 2022/09/22;过去 12 个月发布了 2 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.3.0latest2026/08/142 个月前
0.2.22026/04/096 个月前
0.2.12025/06/041.4 年前
0.2.02024/04/272 年前
0.1.82023/02/223 年前
0.1.72023/02/093 年前

关于 @bluecateng/l10n-cli 的常见问题

@bluecateng/l10n-cli 是什么?

L10n指挥线公用事业

如何安装 @bluecateng/l10n-cli?

在项目目录运行 npm install @bluecateng/l10n-cli,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 l10n-cli,可以用 npx l10n-cli 直接运行。

@bluecateng/l10n-cli 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/bluecateng__l10n-cli 是否存在。

@bluecateng/l10n-cli 支持 ESM 还是 CommonJS?

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

@bluecateng/l10n-cli 需要什么版本的 Node.js?

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

@bluecateng/l10n-cli 可以商用吗?

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

@bluecateng/l10n-cli 的下载量有多少?

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

@bluecateng/l10n-cli 还在维护吗?

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