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;
}

元件 class

自動產生的元件使用穩定的 .moss-* class 名稱。在 style.css 中用這些選擇器自訂樣式。

集合格線

Class元素
.moss-collection-grid格線容器
.moss-collection-card個別卡片
.moss-collection-card-cover封面圖外層
.moss-collection-card-content封面下方的內容區
.moss-collection-card-title卡片標題
.moss-collection-card-count文章數量/副標題

子頁面摘要

Class元素
.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側邊封面圖

文章列表

Class元素
.moss-article-listing列表容器
.moss-article-item個別列表項目
.moss-prefix-link帶前綴(日期/數量)的連結
.moss-year-group年份分組標題

短代碼 class

{.class} 語法在短代碼區塊上加自訂 class:

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

然後在 CSS 中定位:

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