51 lines
1.6 KiB
Markdown
51 lines
1.6 KiB
Markdown
---
|
||
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]] |