@gmana/km-translit

中文文档
0.1.2发布于 2026/10/16MITTypeScriptESM + CJS零依赖近 30 天下载 3442

高棉文为拉丁文

中文使用文档
文档目录14 节
  1. 特征
  2. 安装
  3. 使用量
  4. 高棉语为拉丁语
  5. 拉丁语到高棉语
  6. API 密码
  7. khmerToLatin(text: string, overrides?: Record<string, strin…
  8. latinToKhmer(text: string, overrides?: Record<string, strin…
  9. DEFAULT_OVERRIDES: Record<string, string>
  10. capitalize(text: string): string
  11. 罗马化是如何运作的
  12. 限制
  13. 0.1.0中的变化
  14. 许可证

@gmana/km-翻译

一个轻量级,无依赖性的图书馆,用于将高棉文转写为拉丁文(罗马化)并回译.

罗马化跟随 BGN/PCGN 1972 (英语) 高棉语系统,仅限于平地的ASCII——该体系的二极论 使用量(â, (中文(简体) ), ŏ, (中文(简体) ), ĕə, (中文(简体) ), é)被丢弃,所以输出可以用于名称,标识符和URL. 因此,这是一个 BGN/PCGN -- -- 地名来源 剖面图,不是符合要求的执行.

特征

  • 高棉语改为拉丁语khmerToLatin(中文(简体) ) ——音节-知音罗马化有正等可达形式.
  • 拉丁语为高棉语(latinToKhmer(中文(简体) ) ——最优的反演,总能出出造型良好的高棉语.
  • 覆盖 ——规则所不能从来的名称和地名词典.
  • 无依赖性 ——小捆绑,无害环境管理和CJS.
  • 类型脚本 ——已完全输入出框.

安装

npm install @gmana/km-translit
pnpm add @gmana/km-translit

使用量

高棉语为拉丁语

import { khmerToLatin } from "@gmana/km-translit"

khmerToLatin("សុន ស្រេង") // "Son Sreng"
khmerToLatin("ចាន់ សុភា") // "Chan Sophea"
khmerToLatin("ហ៊ុន សែន") // "Hun Sen"
khmerToLatin("ភ្នំពេញ") // "Phnom Penh"

高棉语块外的文字完全保留下来——拉丁语、通俗语、高棉数字和白话 穿过未触及的:

khmerToLatin("Hello សុខា!") // "Hello Sokha!"
khmerToLatin("Khmer ១២៣ Text") // "Khmer ១២៣ Text"

字段边界来自空格 财务报告和审定财务报表 出自ZWSP(U+200B),常规高棉语单词分隔符:

khmerToLatin("សុន​ស្រេង") // "Son Sreng"  (separated by U+200B)

自定义高于规则和内置默认值:

khmerToLatin("សុន ស្រេង", { សុន: "sun", ស្រេង: "sraeng" }) // "Sun Sraeng"

拉丁语到高棉语

import { latinToKhmer } from "@gmana/km-translit"

latinToKhmer("son seng") // "សុន សេង"
latinToKhmer("rath") // "រតន៍"  (built-in override)
latinToKhmer("rath", { rath: "រ័ត្ន" }) // "រ័ត្ន"

API 密码

khmerToLatin(text: string, overrides?: Record<string, string>): string

罗马化高棉文. 每个高棉语词都是资本化的;周围的文字是孤立的. overrides 将高棉字映射到 其拉丁文形式并被分层 DEFAULT_OVERRIDES。 。 。 .

latinToKhmer(text: string, overrides?: Record<string, string>): string

将拉丁文文本转换回高棉文. 罗曼化丢弃了信息——系列,元音长度,以及选择中 符合一个声音——所以 损失:产出总是很好的高棉语,但并不总是 匹配原始拼写。 使用 overrides 名字必须精确的循环.

DEFAULT_OVERRIDES: Record<string, string>

内设例外. 高棉跑道没有内部的字词界限,所以没有写字的多字正名 分隔符( e)ភ្នំពេញ → Phnom Penh住在这里.

capitalize(text: string): string

将每个空格分隔的单词的第一个字母大写,其他小写.

罗马化是如何运作的

高棉文被分解为音节——发音组,元音,可达——而不是由字符来分解. 这个结构 正确之处如下:

规则示例
科达斯使用未发售的决赛,而非发售表ចន្ទ → Chan (无) Chant(中文(简体) )
Sonorant 下标保留基地系列ស្រេង → Sreng, (中文(简体) ), ស្ទឹង → Stoeng
ំ 财务报告和审定财务报表 ះ 与元音连接ព្រះ → Preah, (中文(简体) ), ភ្នំ → Phnum
៊ 编号 : ៉ 移动序列សុន → Son, (中文(简体) ), ស៊ុន → Sun
់ 标记可达កង់ → Kang
៍ 编号 : ៑ 安静他们的一致តន៍ → Ta
ៗ 重复上一个单词ខ្ញុំៗ → Khnhum Khnhum

限制

  • 没有字典,高棉语中的文字分割是不可能的. 以空格或 ZWSP 分隔单词, 或将短语添加到 overrides。 。 。 .
  • 未以书面发音的语气拼音(ស័ក្តិ → Sakte没有 Sak)需要一个覆盖.
  • 如果某一名称有既定的拼写,而规则不产生(វណ្ណា → Vonna常规 范纳, (中文(简体) ), 使用覆盖.

0.1.0中的变化

核心被重写为音节引擎,它纠正了输出前几个版本出错:

投入0.0.x (韩语)0.1.0 (中文(简体) )
អានអាnAn
ភ្នំពេញPhnmpenhPhnom Penh
ព្រះPrhPreah
សៀមរាបSiemarabSiem Reap
ចន្ទChantChan
សុខា!SokhaSokha!
សុន​ស្រេង (津巴布韦语)SonasrengSon Sreng
latinToKhmer("arun")ារុនអារុន

还作了修改:

  • 第二系列对应表格不完整(ង ញ ន ម យ រ ល វ )),这影响了元音在之后 这些符合: សិរី 现在 Seri (曾经是) Serei和 បុរី 现在 Bori (曾经是) Borei) (中文(简体) ).
  • 非高棉文本不再重置. khmerToLatin 只使用生成的单词 .
  • 白地空间被保存下来,而不是正常化;空地,标签和新线的运行得以存活.
  • latinToKhmer 插入 អ 元音-初始音节的载体,因此其输出总是有效的高棉语.

许可证

麻省理工学院

版本与发布记录

@gmana/km-translit 共发布 3 个版本,首次发布于 2026/04/09;过去 12 个月发布了 3 个版本。

版本发布日期距今
0.1.2latest2026/10/161 个月前
0.0.22026/04/097 个月前
0.0.12026/04/097 个月前

关于 @gmana/km-translit 的常见问题

@gmana/km-translit 是什么?

高棉文为拉丁文

如何安装 @gmana/km-translit?

在项目目录运行 npm install @gmana/km-translit,或使用 pnpm add / yarn add / bun add。

@gmana/km-translit 支持 TypeScript 吗?

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

@gmana/km-translit 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@gmana/km-translit 需要什么版本的 Node.js?

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

@gmana/km-translit 可以商用吗?

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

@gmana/km-translit 的下载量有多少?

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

@gmana/km-translit 还在维护吗?

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