@foundernest/namecase

中文文档
1.0.5发布于 2021/06/16MITTypeScriptESM + CJS零依赖近 30 天下载 13.4万

用于确定人名资本化的全打字库. 基于tamtamchik PHP库.

中文使用文档
文档目录13 节
  1. 说明
  2. 安装
  3. 使用量
  4. 基本用途
  5. 预用
  6. 选项
  7. 不包括名后数
  8. 更改日志
  9. 测试
  10. 捐款
  11. 鸣谢
  12. 贷项
  13. 许可证

名称库

npm Build Status Coverage Status npm bundle size

NameCase是全键入执行 Lingua::EN::NameCase,用于转换字符串的库,以适合大小写。 这有利于将非正常化的数据转换为对人类友好的数据.

说明

Forenames和取名常被完全存储在UPPERCASE或小写中. 此库允许您尽可能将姓名转换成正确的大小写 。 虽然fronemes和取名如果确实出现在单一字符串中,通常会单独存储,但以白空分隔,取名Case正确处理.

目前名称Case名称正确,包括下列任何一种:

Mc, Mac, al, el, ap, bat, ben, bin, binti, binte, da, de, das, dos, delle, della, di, du, del, der, den, ten, ter, la, le, lo, van and von.

它正确处理那些也包含阴道和连字符的名字.

安装

通过 npm

npm install @foundernest/namecase

线条

yarn add @foundernest/namecase

使用量

基本用途

import { nameCase } from '@foundernest/namecase';

nameCase('KEITH');               // => Keith
nameCase('LEIGH-WILLIAMS');      // => Leigh-Williams
nameCase('MCCARTHY');            // => McCarthy
nameCase("O'CALLAGHAN");         // => O'Callaghan
nameCase('ST. JOHN');            // => St. John
nameCase('VON STREIT');          // => von Streit
nameCase('AP LLWYD DAFYDD');     // => ap Llwyd Dafydd
nameCase('HENRY VIII');          // => Henry VIII
nameCase('VAN DYKE');            // => van Dyke

预用

您可以通过调用默认选项来覆盖默认选项 nameCase 函数与 EnvironmentOptions 可选参数 :

import { nameCase } from '@foundernest/namecase';

nameCase('macmurdo');                        // => MacMurdo
nameCase('macmurdo', { irish: false });      // => Macmurdo

您也可以设置所有后续呼叫的选项 :

import { nameCase, setOptions } from '@foundernest/namecase';

nameCase('macmurdo');               // => MacMurdo
setOptions({ irish: false });
nameCase('macmurdo');               // => Macmurdo

或者你可以创造新的 Environment 有自定义选项的对象 :

import Environment from '@foundernest/namecase';

const ncEnv = new Environment({
  lazy: false
  roman: false
});

ncEnv.nameCase('Na li');     // => Na Li

选项

  • lazy — 默认 : true。如果字符串已经混合了,懒惰选项是 true。 。 。 .
  • irish — 默认 : true。正确的“Mac”例外.
  • spanish — 默认 : true。正确的西班牙语组合 y, (中文(简体) ), e 或者说 i。 。 。 .
  • roman — 默认 : true正确的罗马数字.
  • hebrew — 默认 : true。对 ben, (中文(简体) ), bat。 。 。 .
  • postnominal — 默认 : true右后额. 譬如说. PhD。 。 。 .

不包括名后数

import { excludePostNominals, nameCase } from '@foundernest/namecase';

nameCase('ČERNÝ MOST');         // Černý MOst
excludePostNominals('MOst');
nameCase('ČERNÝ MOST');         // Černý Most

更改日志

请看 变化 关于最近变化的更多信息.

测试

yarn test

捐款

请看 贡献指南 财务报告和审定财务报表 行为守则 详细情况.

鸣谢

这个库是一个端口 前一頁 软件包 由尤里·特克琴科(英语:Yuri Tkachenko)出道,也是俄罗斯的港口 Perl 图书馆 并将其大部分功能归功于由马克·萨默菲尔德(英语:Mark Summerfield)制作的Perl版本. 任何错误在Typescript端口是我的错.

贷项

原始佩尔 Lingua::EN::NameCase 版本 :

  • 版权: Mark Summerfield 1998-2014. 所有权利保留.
  • 版权:"芭比"2014-2020. 所有权利保留.

Ruby 版本 :

  • 版权: Aaron Patterson 2006. 所有权利保留.

前一頁 版本 :

  • 版权由Yuri Tkachenko 2016-2020. 所有权利保留.

字迹版本 :

许可证

麻省理工学院许可证(MIT). 请看 许可证文件 更多信息.

版本与发布记录

@foundernest/namecase 共发布 14 个版本,首次发布于 2020/03/12;过去 12 个月发布了 0 个版本。

版本发布日期距今
1.0.5latest2021/06/165 年前
1.0.42021/06/165 年前
1.0.32021/06/165 年前
1.0.22021/01/285 年前
1.0.12020/10/226 年前
1.0.02020/03/286 年前

关于 @foundernest/namecase 的常见问题

@foundernest/namecase 是什么?

用于确定人名资本化的全打字库. 基于tamtamchik PHP库.

如何安装 @foundernest/namecase?

在项目目录运行 npm install @foundernest/namecase,或使用 pnpm add / yarn add / bun add。

@foundernest/namecase 支持 TypeScript 吗?

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

@foundernest/namecase 支持 ESM 还是 CommonJS?

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

@foundernest/namecase 可以商用吗?

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

@foundernest/namecase 的下载量有多少?

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

@foundernest/namecase 还在维护吗?

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