无足鸟核心
未发布的迁移候选:
@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;行为仍然是主机所有的。现有的颜色/字体和标记保留其原有的身份。