一、项目背景
本项目旨在建立一套完整的个人知识管理系统，涵盖文档编写、流程图绘制、站点地图生成等核心功能。
系统采用静态站点架构，所有内容以 Markdown 编写，通过 Obsidian 管理，最终发布到 NAS 服务器。
💡 核心目标：实现内容编写 → 自动渲染 → 一键部署 的完整闭环。
二、技术选型
系统选用以下技术栈，兼顾易用性和可维护性：
2.1 前端框架
采用纯 HTML + CSS + JavaScript 方案，不依赖第三方框架。全局样式统一管理在 global.css 中。
<link rel="stylesheet" href="css/global.css">
2.2 后端服务
部署在 NAS 服务器的 Lighttpd 上，支持静态文件托管和简单的 CGI 脚本。
三、部署流程
部署流程分为以下步骤：
- 在 Obsidian 中编写 Markdown 文档
- 使用 Mermaid 绘制流程图，导出 SVG
- 生成 sitemap.html 和 sitemap.xml
- 通过 SMB 复制到 NAS 服务器
四、常见问题
Q1: 如何解决 Mermaid 图表布局偏移？
A1: 使用 https://mermaid.live/ 校验，或调整 %%{init} 配置参数。
Q2: sitemap.xml 提交后多久能被搜索引擎收录？
A2: 通常在 1-7 天内，视搜索引擎爬取频率而定。
五、总结
通过上述流程，可以实现高效的静态站点内容管理，所有操作在本地完成，一键部署到服务器。
<div class="doc-layout">
<nav class="doc-toc">
<!-- 目录 -->
</nav>
<main class="doc-body">
<!-- 正文 -->
</main>
</div>