# @alto-avios/alto-tokens 中文文档

规范地址：https://npmcn.com/package/%40alto-avios/alto-tokens/

版本：3\.15\.1
npm 元数据更新时间：2026-10-02T12:15:54.755Z
中文译文更新时间：2026-11-06T09:46:24.069Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40alto-avios/alto-tokens
原文对照：https://npmcn.com/package/%40alto-avios/alto-tokens/?lang=original
项目主页：https://github.com/va1-a/alto-tokens#readme
源码仓库：https://github.com/va1-a/alto-tokens

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

- 包体积（解压后）：1.5 MB，215 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：0 个
- 首次发布：2024-07-22T15:26:35.438Z
- 最新版本发布：2026-10-02T12:15:54.525Z
- 近 30 天下载量：3515（2026-10-06 至 2026-11-04，npm 官方下载统计）
- 已发布版本数：39（近 12 个月 10 个）

## 中文简介

IAGL 设计托肯斯

## 安装

```sh
npm install @alto-avios/alto-tokens
```

也可以使用：`pnpm add @alto-avios/alto-tokens`、`yarn add @alto-avios/alto-tokens`、`bun add @alto-avios/alto-tokens`

## README

# 阿尔托·托肯斯

[![license](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/va1-a/alto-tokens/blob/main/LICENSE)

[零小时文档](https://zeroheight.com/8d62898ee/p/179199-how-to-use-tokens)

## 概览

@alto-avios/alto-tokens软件包包含了IAGL的设计令牌,使用"样式词典"来生成,以确保网络和应用开发的应用程序的风格一致.

此软件包包括预建的可以轻松地被集成到您的项目中的符号,同时支持使用"样式词典"的转换,过滤和输出格式. 生成的令牌在构建后被放入 dist/alto-tokens 文件夹中.

## 地方发展

### 先决条件

在设置项目之前, 请确保您在本地机器上安装以下设备 :

-   **节点.js**:v20.11.1(根据建议)
-   **国家预防机制**: 随节点而来
-   **数字**: (可选,但建议管理节点版本)

### 构建托肯

要建立符号,请使用以下命令:

`npm run build:tokens`

### 样式词典

我们正在使用"样式词典"v4处理设计符号的转换和生成. 此外,我们利用@tokens-studio/sd-transforms软件包进行高级改造.

关于如何与"样式词典"合作的更多信息,请参考他们的文档.

### 项目结构

`utils/`: 存储自定义配置、转换、过滤和格式的文件夹. `dist/`: 在构建过程后将生成的令牌放入的分发文件夹 . `raw-tokens/`: 从 figma 输出的 json 文件 .

## 安装

要安装软件包, 请运行

`npm i @alto-avios/alto-tokens`

您的新生成的令牌可以在名为 : `/dist`

## 字体

每个品牌都有一个字体.css文件,包含品牌特有字体面定义. 您可以直接将该文件导入到您的 React 或 Next.js 应用程序,为每个品牌应用正确的字体.

要在您的工程中使用品牌字体:

1.  请确保您已安装@alto-avios/alto-tokens.
    
2.  导入您需要的品牌的字体. cs 文件 :
    

`// Example for "aer-lingus" brand in a React component` `import '@alto-avios/alto-tokens/web/aer-lingus/fonts.css';`

将"aer-lingus"替换为所期望的品牌,如"British-airways","vueling"等.

### 请求 CORS 访问

若您正在将这些资源用于我们国家遥感组织政策目前不允许的域, 请联系我们请求访问。 提供需要访问的确切域或子域(例如, [https://storybook.design.dev.iagl.dignal (中文(中国大陆) )](https://storybook.design.dev.iagl.digital/) 或者说 [https://stg.iagl. 数码](https://stg.iagl.digital/)) (中文(简体) ). 我们将在S3 CORS政策中增加这些领域,以确保无缝整合.

## 更新

检查是否有更新 :

`npm outdated`

如果有更新,则更新软件包:

`npm update @alto-avios/alto-tokens`

## 许可证

本项目的许可条件如下: [麻省理工学院许可证](https://npmcn.com/LICENSE)。 。 。 .

## 常见问题

### @alto-avios/alto-tokens 是什么？

IAGL 设计托肯斯

### 如何安装 @alto-avios/alto-tokens？

在项目目录运行 npm install @alto-avios/alto-tokens，或使用 pnpm add / yarn add / bun add。

### @alto-avios/alto-tokens 支持 TypeScript 吗？

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

### @alto-avios/alto-tokens 支持 ESM 还是 CommonJS？

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

### @alto-avios/alto-tokens 可以商用吗？

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

### @alto-avios/alto-tokens 的下载量有多少？

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

### @alto-avios/alto-tokens 还在维护吗？

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