Quartz 部署流程
📦 前置环境准备
🚀 Quartz 初始化
# 克隆 Quartz 仓库
git clone https://github.com/jackyzha0/quartz.git
# 进入项目目录
cd quartz
# 安装依赖
npm install
# 初始化配置
npx quartz create⚙️ Git 配置
- 设置远程仓库源：
git remote set-url origin <你的仓库URL>
- 拉取源文件到本地仓库
🔧 GitHub 工作流设置
- 编辑部署配置文件：
quartz/.github/workflows/deploy.yml📌 注意：
quartz是项目的根目录路径 - 确保工作流文件包含正确的构建和部署配置
🛠️ 常用指令
| 命令 | 功能 |
|---|---|
npx quartz sync | 同步 GitHub 仓库内容并更新网页 |
npx quartz build --serve | 本地构建并启动实时预览服务器（默认端口：8080） |
📚 参考教程
《使用 Quartz 4.0 和 GitHub Pages 发布托管 Obsidian 笔记》
美化
配色
colors: {
lightMode: {
// 浅色模式配色方案
light: "rgba(250, 248, 246, 1)", // 页面背景色 - 米白色
lightgray: "rgba(224, 220, 216, 1)", // 边框颜色 - 浅灰色
gray: "rgba(240, 237, 233, 1)", // 图表链接和较重边框 - 灰色
darkgray: "rgba(109, 106, 103, 1)", // 正文文本 - 深灰色
dark: "rgba(58, 56, 54, 1)", // 标题文本和图标 - 近黑色
secondary: "rgba(196, 93, 101, 1)", // 链接颜色、当前图表节点 - 深红色
tertiary: "rgba(95, 174, 183, 1)", // 悬停状态和已访问图表节点 - 青色
highlight: "rgba(245, 227, 214, 1)", // 内部链接背景、高亮文本、代码高亮行 - 浅褐色
textHighlight: "rgba(168, 216, 224, 1)",// Markdown高亮文本背景 - 浅蓝色
},
darkMode: {
// 深色模式配色方案
light: "rgba(37, 42, 53, 1)", // 页面背景色 - 深石板灰
lightgray: "rgba(60, 65, 77, 1)", // 边框颜色 - 灰蓝色
gray: "rgba(52, 58, 71, 1)", // 图表链接和较重边框 - 深灰色
darkgray: "rgba(197, 201, 209, 1)", // 正文文本 - 浅灰色
dark: "rgba(230, 233, 239, 1)", // 标题文本和图标 - 近白色
secondary: "rgba(110, 130, 150, 1)", // 链接颜色、当前图表节点 - 深蓝色
tertiary: "rgba(217, 122, 115, 1)", // 悬停状态和已访问图表节点 - 橙红色
highlight: "rgba(74, 93, 122, 1)", // 内部链接背景、高亮文本、代码高亮行 - 深蓝色
textHighlight: "rgba(255, 217, 201, 1)",// Markdown高亮文本背景 - 浅橙色
},
},