# @db-ux/db-theme-fonts 中文文档

规范地址：https://npmcn.com/package/%40db-ux/db-theme-fonts/

版本：2\.2\.0
npm 元数据更新时间：2026-10-23T09:59:53.153Z
中文译文更新时间：2026-11-11T18:21:12.578Z
软件包许可：SEE LICENSE IN LICENSE

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

原始 npm 页面：https://www.npmjs.com/package/%40db-ux/db-theme-fonts
原文对照：https://npmcn.com/package/%40db-ux/db-theme-fonts/?lang=original

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

- 包体积（解压后）：850 kB，42 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：0 个
- 首次发布：2025-02-11T14:50:28.021Z
- 最新版本发布：2026-10-23T09:59:52.887Z
- 近 30 天下载量：5386（2026-10-12 至 2026-11-10，npm 官方下载统计）
- 已发布版本数：12（近 12 个月 3 个）

## 中文简介

暂无中文简介

## 安装

```sh
npm install @db-ux/db-theme-fonts
```

也可以使用：`pnpm add @db-ux/db-theme-fonts`、`yarn add @db-ux/db-theme-fonts`、`bun add @db-ux/db-theme-fonts`

## README

# @db-ux/db-主题信息

我们在这个软件包中为 DB Apps 提供 db 主题fonts 。 由于法律问题,一些文件被加密。 要解密他们 你需要去 [营销门户](https://marketingportal.extranet.deutschebahn.com/marketingportal/Design-Anwendungen/db-ux-design-system/resources/db-theme)。 。 。 . **说明:** 深链接不起作用,您需要在登录后再次点击链接.

您可以在页面上找到两个环境变量:

-   `ASSET_PASSWORD`
-   `ASSET_INIT_VECTOR`

在安装前 `@db-ux/db-theme-fonts` 您需要创建 `.env` 文档并添加到您的 `.gitignore`后,将这两个变量添加到 `.env` 文档.

```env
ASSET_PASSWORD=db-theme-fonts
ASSET_INIT_VECTOR=db-theme-fonts
```

这个 `postinstall` 脚本在内 `@db-ux/db-theme-fonts` 软件包将为您解密文件。 如果解密对你无效(例如因为Git生命周期剧本,例如: `postinstall`,已失效,例如被 `ignore-scripts` 设置),您需要手动运行解密脚本(参见我们 [“贡献”/“比较”文档](https://github.com/db-ux-design-system/core-web/blob/main/CONTRIBUTING.md#prepare) 页:1 或者,你可以将这些节点脚本包含在生命周期脚本中.

> **说明:** 你用得着 `process.env.` 本地或CI/CD中将所需的环境变量传递到 `postinstall`。 。 。 .

## 安装

> **说明:** 阅读上面的免责声明:)

```shell
npm i @db-ux/db-theme-fonts
```

## 用法为 `@db-ux/core-components`

### 导入

包含这个主题有不同的方式. 因此,您需要导入正确的 `.css` 文档。 根据您使用的捆绑器, 会有多个文件 . `[TYPE]` 如果您不使用相对路径, 则应该用您的捆绑器替换 :

-   `relative`: 无捆绑器
-   `absolute`: 无捆绑器
-   `rollup`数字 : `vite`, (中文(简体) ), `rollup`
-   `webpack`数字 : `webpack`, (中文(简体) ), `nextjs`

#### 联合来文/TS

```javascript
// main.[js|ts]
import "@db-ux/core-components/build/styles/bundle.css"; /* loads whitelabel */
import "@db-ux/db-theme-fonts/build/styles/[TYPE].css"; /* Overwrite whitelabel  */
```

#### 支助科

```css
/* main.css */
@import "@db-ux/core-components/build/styles/bundle.css"; /* loads whitelabel */
@import "@db-ux/db-theme-fonts/build/styles/[TYPE].css"; /* Overwrite whitelabel  */
```

#### 维特

您可能需要添加一个 `resolve` 内 `vite.config.[js|ts]`数字 :

```javascript
import * as path from "node:path";

export default defineConfig({
    ...
    resolve: {
        alias: {
            "@db-ux": path.resolve("node_modules/@db-ux"),
        },
    },
});
```

## 高级设置

而不是覆盖白标签( N)`[TYPE].css`)也可以包括每个 `.css` 您需要在您的项目中:

```javascript
// main.[js|ts]

/* load components */
import "@db-ux/core-components/build/styles/index.css";

/* load foundations (optional) */
import "@db-ux/core-foundations/build/styles/helpers/classes/all.css";
import "@db-ux/core-foundations/build/styles/density/classes/all.css";
import "@db-ux/core-foundations/build/styles/fonts/classes/all.css";
import "@db-ux/core-foundations/build/styles/colors/classes/all.css";

/* load assets */
import "@db-ux/db-theme-fonts/build/styles/[TYPE].css";
import "@db-ux/db-theme-icons/build/styles/[TYPE].css";

/* load theme */
import "@db-ux/db-theme-fonts/build/styles/index.css";
```

### 覆盖标题字体权重

标题字体船增加重量(`light`, (中文(简体) ), `black`, (中文(简体) ), `wideextrablack`) 在白标签默认值上. 导入 `[TYPE].css` 上面已经应用了它们.

#### 类型脚本自动完成

要让 TypeScript 自动完成附加标题字体权重, 您需要包含类型 :

```json
{
  "compilerOptions": {
    ...,
    "types": [..., "@db-ux/db-theme-fonts"]
  },
  "include": [
    ...,
    "node_modules/@db-ux/db-theme-fonts/build/types/overwrite.d.ts"
  ]
}
```

如果您有多个覆盖, 您也可以复制 `overwrite.d.ts` 进入您的 `src` 文件夹并添加其他类型.

## 德国Bahn品牌

由于我们想在数字化旅程中完全支持我们的用户和客户,使用德乙品牌和商标时,即使使用我们提供的该产品的代码,也会受到明确的准则和限制;德乙完全保留了对德乙品牌的所有权利,尽管我们提供了DB UX产品的代码,可以在Apache 2.0许可下自由使用并发布. 请看看我们的品牌门户 [https://marketingportal.extranet.deutschebahn.com/ 页面存档备份,存于互联网档案馆](https://marketingportal.extranet.deutschebahn.com/) 就任何品牌问题与谁联系.

不允许您在Deutsche Bahn网站和应用程序之外使用此套件或其任何内容(如设计资产以及受保护的特征和商标等).

## 许可证

这个工程在特殊的Apache-2.0下获得许可,参见这个包中的LECENCE文件.

## 常见问题

### 如何安装 @db-ux/db-theme-fonts？

在项目目录运行 npm install @db-ux/db-theme-fonts，或使用 pnpm add / yarn add / bun add。

### @db-ux/db-theme-fonts 支持 TypeScript 吗？

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

### @db-ux/db-theme-fonts 支持 ESM 还是 CommonJS？

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

### @db-ux/db-theme-fonts 可以商用吗？

@db-ux/db-theme-fonts 使用 SEE LICENSE IN LICENSE 许可。许可条款写在包内的独立文件中，请阅读该文件确认可否商用。以上为概括，不构成法律意见，请以许可原文为准。

### @db-ux/db-theme-fonts 的下载量有多少？

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

### @db-ux/db-theme-fonts 还在维护吗？

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