# @city-of-baltimore/bromo-fonts 中文文档

规范地址：https://npmcn.com/package/%40city-of-baltimore/bromo-fonts/

版本：1\.4\.4
npm 元数据更新时间：2026-11-09T12:52:12.775Z
中文译文更新时间：2026-11-09T22:06:13.313Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40city-of-baltimore/bromo-fonts
原文对照：https://npmcn.com/package/%40city-of-baltimore/bromo-fonts/?lang=original
项目主页：https://github.com/city-of-baltimore/bromo#readme
源码仓库：https://github.com/city-of-baltimore/bromo

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

- 包体积（解压后）：234 kB，15 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=26 \<27
- 运行依赖：2 个
- peer 依赖：@city-of-baltimore/bromo \>=0\.29\.1 \|\| \>=1\.0\.0-0，@fontsource/noto-sans-kr 5\.3\.0，@fontsource/noto-sans-sc 5\.3\.0，@fontsource/noto-sans-arabic 5\.3\.0，@fontsource/noto-sans-devanagari 5\.3\.0
- 首次发布：2026-08-03T07:51:15.887Z
- 最新版本发布：2026-11-09T12:52:12.554Z
- 近 30 天下载量：2739（2026-10-10 至 2026-11-08，npm 官方下载统计）
- 已发布版本数：84（近 12 个月 84 个）

## 中文简介

巴尔的摩设计系统字体适配器. 自办基地和选入脚本面相,另设可选Adobe品牌快递.

## 安装

```sh
npm install @city-of-baltimore/bromo-fonts
```

也可以使用：`pnpm add @city-of-baltimore/bromo-fonts`、`yarn add @city-of-baltimore/bromo-fonts`、`bun add @city-of-baltimore/bromo-fonts`

## README

# @ city-of-baltimore/ broom-fonts (英语)

巴尔的摩设计系统的字体适配器. 登记家庭 名称 `BROMO_FONT_CONTRACT` 所以每个产品都继承一个 而不是每个解决方案.

```bash
npm install --save-exact @city-of-baltimore/bromo-fonts
```

```ts
// once, near your application entry, before anything renders.
// Pick exactly ONE of these two.
import "@city-of-baltimore/bromo-fonts/brand";        // City brand headings
// import "@city-of-baltimore/bromo-fonts/fonts.css";    // network-free
```

没有 `@font-face` 或字体 URL 属于应用程序代码。 可选母语 标签只添加下文描述的相关脚本条目.

**哪个?** `fonts.css` 请求只来自申请源头,并在汉肯语中填入标题 格罗特斯克. `brand` 是一个超级集,增加了城市的品牌面孔, 普罗克西玛·诺瓦(Prosima Nova),领先于它——以每页对Adobe的请求为代价 装入。 两者都得到了支持;无网络模式不是一个已退化的模式.

## 为什么这不是布洛莫的一部分

公众 `@city-of-baltimore/bromo` 软件包是麻省理工学院和无网络 **以 政策**: 它宣布不 `@font-face`,没有字体二进制,也没有联系人 字体主机. `verify:package-policy` 财务报告和审定财务报表 `verify:pack-install` 执行 在机械上,零例外.

**Bromo拥有哪个家庭是正确的。 这个适配器拥有他们如何到达.** 让他们分开是让送货改变的东西 新的许可证 新的宿主, 自我托管而不是CDN——不触及设计系统,以及什么 保证有执照的二进制 永远不能降落在麻省理工学院的柏油球上.

## 它能带来什么

| 作用 | 家属 | 许可证 | 交付 | 其中条目 |
| --- | --- | --- | --- | --- |
| 品牌标题 | 近似新星 700/800 | Adobe 网络项目( 只交付) | 阿多贝 CDN | `brand` 仅限 |
| 显示和标题 | 汉克·格罗特斯克 700/800 | (单位:千美元) | **自动托管**时捆绑 | 两者 |
| 身体与UI | 努尼托·桑斯 400-700/800 | (单位:千美元) | **自动托管**时捆绑 | 两者 |

两个自营家庭可以再分配 所以他们的档案船 `@fontsource` 依赖性并被捆绑到应用程序自己的输出中 . **此软件包没有自己的字体二进制 .**

**只有拉丁语子集.** 默认适配器导入 `latin` 财务报告和审定财务报表 `latin-ext`, (中文(简体) ), 不是全单码范围 西里尔语和越南语在该条目之外; 故事书记录了他们被钉住的努尼托的脸 整个上游 样式表。 可选的脚本条目列表如下. 应用程序不编辑 `fonts.css`。 。 。 .

Proxima Nova 无法被捆绑: 城市将其保存在 Adobe 字体网络下 允许使用 Adobe 的 CDN 进行渲染的 而不是允许自我接待 这是庄园的例外 自我主机规则,并且它有界限——只有标题,可选入,有自主机 汉肯·格罗特斯克直接在后面 所以阿多比的断奶要花一个层次 而不是 全部都一样.

仅 `h1`– 说吧 –`h6`,品牌锁,和警报标题使用标题堆; 其他的都是身体的脸.

## 可选本地语言标签

字法合同6添加了这些 **正常重量 700** 在保留条目时 碱性堆栈和 `fonts.css` 声明保持不变。 覆盖目前本地 标签;它们不主张完整的翻译工作流程、任意加权或 所有区域形式.

| 导入后缀 | 已命名的脸 | 明确的语言属性 |
| --- | --- | --- |
| `scripts/zh.css` | 诺托·桑斯SC | `zh` 或者说 `zh-Hans` (包括 `zh-Hans-*`(中文(简体) ) |
| `scripts/ko.css` | 诺托·桑斯 KR | `ko` 区域附属机构 |
| `scripts/ar.css` | 诺托·桑斯阿拉伯语 | `ar` 区域附属机构 |
| `scripts/hi.css` | 诺托·桑斯·德瓦纳加里 | `hi` 区域附属机构 |

```tsx
// In the existing lazy language-assistance feature, not every application's entry.
import "@city-of-baltimore/bromo-fonts/scripts/ar.css";

<Tag label={<>Arabic · <bdi lang="ar" dir="auto">العربية</bdi></>} />
```

继续导入已有的基础字体 。 适配器样式明确标有语言标记 文本; 它既不从字符中猜测语言, 也不重写全局字体 堆栈。 打开 `lang` 仅当英文描述符伴有时 这个. `LanguageAccessPanel` 还接受 `{ label, lang, dir? }` 保留的项目 常规字符串和基于标签的选择/召回。 它的结构标签使用 `bdi`,默认为 `dir="auto"`标签必须保持独特性.

赤裸裸的 `zh` 选择是今天分享的SC面孔 `中文` 标签。 没有 主张传统的中国保险政策; `zh-Hant` 不选择此条目. 使用这只700只的交付来管理标签,而不是400重的翻译体 copy. 扩大权重或语文要求需要明确改变合同.

每个脚本条目都需要它的Fontsource家族,适配器宣布为 **选项对等点** 在准确的版本中,它的CSS是生成的。 安装 用于您导入条目的家庭, 并且只有这些:

| 导入后缀 | 安装 |
| --- | --- |
| `scripts/zh.css` | `@fontsource/noto-sans-sc@5.3.0` |
| `scripts/ko.css` | `@fontsource/noto-sans-kr@5.3.0` |
| `scripts/ar.css` | `@fontsource/noto-sans-arabic@5.3.0` |
| `scripts/hi.css` | `@fontsource/noto-sans-devanagari@5.3.0` |

```bash
npm install --save-exact @fontsource/noto-sans-arabic@5.3.0
```

一个没有导入脚本项的应用程序不会安装其中任何一项( 约 4. 8 MB) 用于适配器及其底相,与全部4个相比,大约133 MB。 A 类 失踪家庭的建设失败——捆绑者无法解决面孔——相反 而不是画一个OS倒置.

所有面相来自精确的Fontsource 5.3.0包. 发电机保存 上游Unicode范围、完整的脚本碎片和未修改的塑造数据; 它只选择WOFF2。 它从不从截图字符创建字体. 仅应需要的Unicode shards下载.

该软件包包括上游通知 `licenses/`. 保留相关海外资产管制处 部署捆绑字体资产时通知。 适配器代码的麻省理工学院执照是 不替换字体的 OFL 许可证 。 费用估计数见打字指南 和剩余浏览器/设备接受; 仅注册的面孔无法证明 那张脸画了个壁画.

## 社区支助方案

**`fonts.css` 和可选脚本条目** 使用同源资产:

```
font-src 'self';
```

本条目上的应用程序可以 **删除** `https://use.typekit.net`, (中文(简体) ), `https://fonts.googleapis.com`,以及 `https://fonts.gstatic.com` 从他们的 `style-src` 财务报告和审定财务报表 `font-src` 完全指挥.

**`brand`** 附加 Adobe 运行时的样式表而不是导入, 所以 样式表和相片都需要Adobe可达:

```
style-src 'self' https://use.typekit.net;
font-src  'self' https://use.typekit.net https://p.typekit.net;
```

没有什么变化—— `fonts.googleapis.com` 财务报告和审定财务报表 `fonts.gstatic.com` 滚开 两者都有.

## 为什么品牌条目是JavaScript

因为样式表不能远离关键渲染路径,也就是 这里唯一重要的财产.

可选 `brand` 条目附加 Adobe 的样式表 `media="print"`, (中文(简体) ), 然后把它改为 `all` 装入 `addEventListener`保留了 样式表从初始渲染屏蔽路径中切出,并保留同一来源 自我托管的倒置。 它不会改变 Adobe 的字体描述符或保证 之后的交换是无法想象的 核定项目重量仍为700 ; 项目配置和许可的交付停留在适配器的 拥有者.

## 许可证

这个包裹是麻省理工学院的 它提供的字体保存着自己的许可证; 自动托管的相片 允许此适配器执行的再分配 :

-   **努尼托桑斯语Name** - SIL 开放字体许可证1.1,通过 `@fontsource/nunito-sans`。 。 。 .
    
-   **汉肯·格罗特斯克** - SIL 开放字体许可证1.1,通过 `@fontsource/hanken-grotesk`。 。 。 .
    
-   **诺托·桑斯SC、诺托·桑斯KR、诺托·桑斯阿拉伯语和诺托·桑斯德瓦纳加里语** —— 说 SIL Open Font License 1.1,通过相应的精确的Fontsource包.
    

## 在Nova附近地区

近新星只能由 单独、精心交付 `brand` 选入条目 . 它从来没有在 `fonts.css`,可选的脚本条目或Bromo的视觉基线 环境。 它现有的只交付Adobe许可证不允许销售. 如果城市获得自营许可证, 协调印刷合同 修改适配器,并取消远程例外;不要默默地替换 网络自由显示家族.

## 常见问题

### @city-of-baltimore/bromo-fonts 是什么？

巴尔的摩设计系统字体适配器\. 自办基地和选入脚本面相,另设可选Adobe品牌快递\.

### 如何安装 @city-of-baltimore/bromo-fonts？

在项目目录运行 npm install @city-of-baltimore/bromo-fonts，或使用 pnpm add / yarn add / bun add。

### @city-of-baltimore/bromo-fonts 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/city-of-baltimore\_\_bromo-fonts 是否存在。

### @city-of-baltimore/bromo-fonts 支持 ESM 还是 CommonJS？

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

### @city-of-baltimore/bromo-fonts 需要什么版本的 Node\.js？

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

### @city-of-baltimore/bromo-fonts 可以商用吗？

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

### @city-of-baltimore/bromo-fonts 的下载量有多少？

根据 npm 官方下载统计，@city-of-baltimore/bromo-fonts 在 2026/10/10 – 2026/11/08 这 30 天内被下载 2,739 次，日均约 91 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @city-of-baltimore/bromo-fonts 还在维护吗？

最新版本 1\.4\.4 发布于 2026/11/09（今天）；至今共发布 84 个版本，其中过去 12 个月发布了 84 个；首次发布于 2026/08/03。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。