Auto-sync: 2026-04-18 16:02

wiki/sources/Building-your-Quartz.md

@@ -0,0 +1,51 @@
+---
+title: "Building your Quartz"
+type: source
+tags:
+  - clippings
+  - quartz
+  - obsidian
+date: 2026-04-17
+---
+
+## Source File
+- [[raw/Home Office/Building your Quartz.md]]
+
+## Summary
+
+- 核心主题：Quartz 静态站点构建与自托管指南
+- 问题域：静态站点生成与部署
+- 方法/机制：通过命令行构建 Quartz 静态站点，支持 Nginx、Apache、Caddy 三种自托管方案
+- 结论/价值：Quartz 将 Obsidian 笔记转化为可托管的静态网站
+
+## Key Claims
+
+- Quartz 将 Markdown 文件转化为 HTML、JS、CSS 静态文件
+- 自托管需要配置 Web 服务器处理无 .html 扩展名的 URL
+- 生产环境部署不应使用 --serve 模式
+
+## Key Quotes
+
+> "This will start a local web server to run your Quartz on your computer."
+
+> "Serve mode is intended for local previews only. For production workloads, see the page on hosting."
+
+## Key Concepts
+
+- [[静态站点生成]]：Quartz 将 Markdown 转换为静态 HTML 文件的技术
+- [[静态站点托管]]：通过 Web 服务器（Nginx/Apache/Caddy）托管静态文件
+- [[Quartz]]：Obsidian 笔记静态站点生成器
+
+## Key Entities
+
+- [[Obsidian]]：本地笔记软件，Quartz 的内容来源
+- [[Nginx]]：高性能 Web 服务器，用于生产环境托管
+- [[Apache]]：老牌 Web 服务器，用于自托管方案
+- [[Caddy]]：自动 HTTPS 的现代 Web 服务器
+
+## Connections
+
+- [[Obsidian]] →产出 [[静态站点生成]] → [[Quartz]]
+- [[静态站点托管]] ←依赖 [[Nginx]]
+- [[静态站点托管]] ←依赖 [[Apache]]
+- [[静态站点托管]] ←依赖 [[Caddy]]