CSS

自定义样式表

在项目根目录创建 style.css。moss 在默认主题之后加载它,你的规则会覆盖默认值。

:root {
  --moss-color-accent: #2d5a2d;
  --moss-font-body: "Inter", -apple-system, sans-serif;
  --moss-content-width: 72ch;
}

不需要构建步骤,不需要配置。文件自动加载。

变量

字体

变量默认值说明
--moss-font-body系统无衬线字体栈正文字体
--moss-font-heading继承正文标题字体
--moss-font-monoui-monospace, SFMono-Regular代码字体
--moss-font-serifIowan Old Style, 衬线字体栈衬线字体(配合字体切换使用)
--moss-font-size-base1.125rem基准字号
--moss-font-weight320默认字重

颜色

变量默认值说明
--moss-color-accent#2d5a2d链接、高亮、强调元素
--moss-color-bg#faf8f5页面背景色
--moss-color-text#2c2825主文字色
--moss-color-muted#8a8580次要/弱化文字色
--moss-color-surface#f4f1ec卡片和表面背景色

布局

变量默认值说明
--moss-content-width67ch内容最大宽度
--moss-content-width-sidebar62ch侧边栏激活时的内容宽度
--moss-nav-widthvar(--moss-content-width)导航栏和页脚最大宽度
--moss-sidebar-width280px侧边栏宽度
--moss-site-max-width1200px站点整体最大宽度
--moss-container-paddingclamp(1rem, 5vw, 2rem)容器两侧内边距

间距

变量默认值说明
--moss-space-xs0.5rem超小(8px)
--moss-space-sm1rem小(16px)
--moss-space-md1.5rem中(24px)
--moss-space-lg2rem大(32px)
--moss-space-xl3rem超大(48px)
--moss-space-2xl4rem特大(64px)

深色模式

深色模式自动跟随系统设置。用以下选择器自定义深色模式配色:

[data-theme="dark"] {
  --moss-color-bg: #0f0f0f;
  --moss-color-accent: #6abf6a;
}

组件类名

自动生成的组件使用稳定的 .moss-* 类名。在 style.css 中用这些类名来定制样式。

集合网格

类名元素
.moss-collection-grid网格容器
.moss-collection-card单张卡片
.moss-collection-card-cover封面图包裹层
.moss-collection-card-content封面下方的内容区
.moss-collection-card-title卡片标题
.moss-collection-card-count文章数量/副标题

子页面摘要

类名元素
.moss-child-summary摘要卡片
.moss-child-summary-rowFlex 行(正文 + 封面)
.moss-child-summary-body文字内容区
.moss-child-summary-meta日期或数量
.moss-child-summary-title标题
.moss-child-summary-description描述摘录
.moss-child-summary-cover侧封面图

文章列表

类名元素
.moss-article-listing列表容器
.moss-article-item单条列表项
.moss-prefix-link带前缀的链接(日期/数量)
.moss-year-group年份分组标题

短代码类名

{.class} 语法给短代码块添加自定义类:

:::grid 3 {.profiles .featured}
...
:::

然后在 CSS 中定制:

.profiles .moss-grid-card {
  border-radius: 50%;
}
Published with moss