# @martlet/core 中文文档

规范地址：https://npmcn.com/package/%40martlet/core/

版本：2\.2\.3
npm 元数据更新时间：2026-11-01T17:21:15.039Z
中文译文更新时间：2026-11-01T20:03:06.623Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40martlet/core
原文对照：https://npmcn.com/package/%40martlet/core/?lang=original
项目主页：https://martletdesign.dev/
源码仓库：https://github.com/martletdesign/core

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

- 包体积（解压后）：184 kB，43 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：4 个
- 首次发布：2026-11-01T04:00:37.781Z
- 最新版本发布：2026-11-01T17:21:14.772Z
- 已发布版本数：2（近 12 个月 2 个）

## 中文简介

独立于框架的Martlet颜色、排版、字体、设计令牌和可选的界面样式

## 安装

```sh
npm install @martlet/core
```

也可以使用：`pnpm add @martlet/core`、`yarn add @martlet/core`、`bun add @martlet/core`

## README

# 无足鸟核心

> **未发布的迁移候选：** `@martlet/core` 是建议的新包标识，而不是已宣布的注册表版本。安装本地压缩包来测试它。现有的 `@martlet/theme` 安装保持支持的发布路径，直到单独批准发布和迁移。此审查分支被标记为私有以防止发布。

`@martlet/core` 是独立于框架的Martlet真相来源。它包含了从jameshoward.us中提取的浅/暗语义色和排版、间距、形状、深度和交互定义。

## 设计方向

关于系统扩展的设计方向和准则，请参阅 [市场设计章程](https://npmcn.com/package/%40martlet/core/docs/charter.md).

## 选择要采用什么

| 进口 | 效果 |
| --- | --- |
| `@martlet/core/css` | 只有原始范围的浅色/深色变量；v1不变 |
| `@martlet/core/foundation.css` | 命名空间设计变量；没有字体加载或元素样式 |
| `@martlet/core/typography.css` | 内部文本角色 `.martlet`;需要基础变量 |
| `@martlet/core/fonts.css` | 可选的，本地捆绑Cambo， Lato， Cinzel和IBM Plex Mono资产通过Fontsource |
| `@martlet/core/components.css` | 可选的命名空间接口原语；需要颜色和粉底 |
| `@martlet/core/full.css` | 颜色、基础、排版和组件；字体仍然是可选的 |
| `@martlet/core/legacy.css` | 增量网站迁移的可选变量别名 |

```js
import '@martlet/core/full.css';
import '@martlet/core/fonts.css';
import { light, dark, foundation, design, capabilities } from '@martlet/core';
```

集 `data-martlet="light"` 或者 `data-martlet="dark"` 论元素到主题；添加 `class="martlet"` 选择排版和界面样式。模式可以在同一页面上共存。CSS在没有JavaScript的情况下仍然可用；字体包导入需要一个支持css的打包器。ESM和CommonJS导出、TypeScript声明、逐模式JSON、 `tokens.json`， `foundation.json`， `design.json`， `capabilities.json`和highlight.js样式都是显式的包导出。

## 排版和覆盖

-   衬线字体：Cambo字体，用于散文和主要标题。
-   Sans: Lato，用于界面文本、导航和元数据。
-   显示：Cinzel，用于显示重音和次要标题角色。
-   单字间距：IBM Plex单字间距，用于代码和终端文本。

这些角色来自原始的个人站点，而不是演示站点以前的Space Grotesk/DM Sans配对。伯克利单核细胞增多症没有传播。拥有许可证的车主可以撤销 `--martlet-font-mono` 在自己的根或主题范围上。普通消费者不需要专有字体。看到通知。Md用于字体许可。

可选的完整样式表不是站点模板：它不包含个人身份、内容、分析或同意策略。看到 [`@martlet/astro`](https://github.com/martletdesign/astro) 用于天文学成分和中性启动器。

## 来源和发布

编辑 `source.json` 在这里;运行 `npm ci --ignore-scripts`， `npm run build`， `npm test`, `npm pack`． 生成的 `dist/` 提交审查和可复制性。字体源依赖关系被固定；锁文件保持其完整性。源网站的原始颜色被保留为单独的身份令牌，而不是无声地取代现有的语义应用颜色。减少运动偏好将共享运动令牌归零。

这个 `capabilities` 导出记录每个集成应用的内容、需要单独配置的内容或不支持的内容。浏览器颜色主题不会改变字体。编辑器和终端仅在其主机允许的情况下使用等宽空间角色。

npm的作用域是 `martlet`． 要测试这个候选者，运行 `npm pack` 并安装生成的本地压缩包。发布的消费者继续使用 `@martlet/theme`． 软件包版本与应用程序端口版本无关。

中的应用程序端口生成器 `martletdesign/martlettheme` 目前消费 `@martlet/theme`． 它们的迁移需要单独审查变更。普通核查不公布；发布GitHub版本会触发发布工作流。

## 布局

2.1版本添加可选功能 [`layout.css`](https://npmcn.com/package/%40martlet/core/docs/layout.md), `layout` JavaScript导出，以及 `layout.json`． 布局原语包括容器、垂直堆栈、包装集群、有界网格、侧边栏和成对区域。进口 `@martlet/core/full.css` 为完整的样式层添加 `@martlet/core/layout.css` 后 `foundation.css` 仅用于结构类。看到 [源观察和响应规则](https://npmcn.com/package/%40martlet/core/docs/layout.md).

## 释放

当前的GitHub发布工作流可以通过npm trusted publishing自动发布；此私有候选不能发布。看到 [发布设置](https://npmcn.com/package/%40martlet/core/docs/releasing.md) 为一次性包件授权放行单。

## 基础规范

读了 [工作基础规范](https://npmcn.com/package/%40martlet/core/docs/foundations.md) 对于间距关系，响应组合，排版，密度，表面，运动，可访问性，以及发送值和建议应用程序角色之间的区别。

## 实验性UI语言

[语法](https://npmcn.com/package/%40martlet/core/docs/grammar.md)， [源的决定](https://npmcn.com/package/%40martlet/core/docs/source-decisions.md)， [框架和迁移指南](https://npmcn.com/package/%40martlet/core/docs/consolidation.md), [机器可读的支持](https://npmcn.com/package/%40martlet/core/language.json) 描述实验核心2.2.2 / Astro 1.2.2的巩固。现有默认值保持兼容；源概要文件是可选的。

[语法复习](https://npmcn.com/package/%40martlet/core/docs/coverage.md)， [验证表单](https://npmcn.com/package/%40martlet/core/docs/patterns/forms.md), [查询/结果模式](https://npmcn.com/package/%40martlet/core/docs/patterns/query-results.md) 将实验语法扩展到0.3。

## 采用修复预览

现有的 `@martlet/theme@next` 为实验2.2.2线； `latest` 保持稳定的2.1线。包、语法和框架版本是分开的：语法0.3是设计契约，核心2.2.2提供CSS/令牌，Astro 1.2.2提供包装器，React 0.1.0保留了经过测试的核心2.1.0依赖。确切的包版本属于lockfile。

[直接解析HTML](https://npmcn.com/package/%40martlet/core/docs/native-html.md) 文档布局/模式类。 [原生表单样式](https://npmcn.com/package/%40martlet/core/docs/form-styling.md) 可选的文档 `forms.css` 包含的层 `full.css`;行为仍然是主机所有的。现有的颜色/字体和标记保留其原有的身份。

## 常见问题

### @martlet/core 是什么？

独立于框架的Martlet颜色、排版、字体、设计令牌和可选的界面样式

### 如何安装 @martlet/core？

在项目目录运行 npm install @martlet/core，或使用 pnpm add / yarn add / bun add。

### @martlet/core 支持 TypeScript 吗？

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

### @martlet/core 支持 ESM 还是 CommonJS？

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

### @martlet/core 可以商用吗？

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

### @martlet/core 还在维护吗？

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