@martlet/core

中文文档
2.2.3发布于 2026/11/02MITTypeScriptESM + CJS构建来源已验证

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

中文使用文档
文档目录9 节
  1. 设计方向
  2. 选择要采用什么
  3. 排版和覆盖
  4. 来源和发布
  5. 布局
  6. 释放
  7. 基础规范
  8. 实验性UI语言
  9. 采用修复预览

无足鸟核心

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

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

设计方向

关于系统扩展的设计方向和准则,请参阅 市场设计章程.

选择要采用什么

进口效果
@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增量网站迁移的可选变量别名
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 用于天文学成分和中性启动器。

来源和发布

编辑 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, layout JavaScript导出,以及 layout.json. 布局原语包括容器、垂直堆栈、包装集群、有界网格、侧边栏和成对区域。进口 @martlet/core/full.css 为完整的样式层添加 @martlet/core/layout.css 后 foundation.css 仅用于结构类。看到 源观察和响应规则.

释放

当前的GitHub发布工作流可以通过npm trusted publishing自动发布;此私有候选不能发布。看到 发布设置 为一次性包件授权放行单。

基础规范

读了 工作基础规范 对于间距关系,响应组合,排版,密度,表面,运动,可访问性,以及发送值和建议应用程序角色之间的区别。

实验性UI语言

语法, 源的决定, 框架和迁移指南, 机器可读的支持 描述实验核心2.2.2 / Astro 1.2.2的巩固。现有默认值保持兼容;源概要文件是可选的。

语法复习, 验证表单, 查询/结果模式 将实验语法扩展到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 文档布局/模式类。 原生表单样式 可选的文档 forms.css 包含的层 full.css;行为仍然是主机所有的。现有的颜色/字体和标记保留其原有的身份。

版本与发布记录

@martlet/core 共发布 2 个版本,首次发布于 2026/11/01;过去 12 个月发布了 2 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
2.2.3latest2026/11/021 天前
0.0.0-stage2026/11/012 天前

关于 @martlet/core 的常见问题

@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 和提交记录判断。