# @gmana/km-translit 中文文档

规范地址：https://npmcn.com/package/%40gmana/km-translit/

版本：0\.1\.2
npm 元数据更新时间：2026-10-16T03:58:16.482Z
中文译文更新时间：2026-11-16T16:58:50.923Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40gmana/km-translit
原文对照：https://npmcn.com/package/%40gmana/km-translit/?lang=original
项目主页：https://github.com/sun-sreng/react#readme
源码仓库：https://github.com/sun-sreng/react

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

- 包体积（解压后）：110 kB，9 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=18
- 运行依赖：0 个
- 首次发布：2026-04-09T02:38:30.888Z
- 最新版本发布：2026-10-16T03:58:16.321Z
- 近 30 天下载量：3442（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：3（近 12 个月 3 个）

## 中文简介

高棉文为拉丁文

## 安装

```sh
npm install @gmana/km-translit
```

也可以使用：`pnpm add @gmana/km-translit`、`yarn add @gmana/km-translit`、`bun add @gmana/km-translit`

## README

# @gmana/km-翻译

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

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

## 特征

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

## 安装

```bash
npm install @gmana/km-translit
```

```bash
pnpm add @gmana/km-translit
```

## 使用量

### 高棉语为拉丁语

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

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

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

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

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

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

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

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

### 拉丁语到高棉语

```typescript
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 (中文(简体) ) |
| --- | --- | --- |
| `អាន` | `អាn` | `An` |
| `ភ្នំពេញ` | `Phnmpenh` | `Phnom Penh` |
| `ព្រះ` | `Prh` | `Preah` |
| `សៀមរាប` | `Siemarab` | `Siem Reap` |
| `ចន្ទ` | `Chant` | `Chan` |
| `សុខា!` | `Sokha` | `Sokha!` |
| `សុន​ស្រេង` (津巴布韦语) | `Sonasreng` | `Son Sreng` |
| `latinToKhmer("arun")` | `ារុន` | `អារុន` |

还作了修改:

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

## 许可证

麻省理工学院

## 常见问题

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

