新版

~/project/
├── docs		# 1.94.254.213@/var/www/docs | https://docs.luoxingding.com/
└── Obsidian	# git@git.luoxingding.com:ding/Obsidian.git

旧版

Path: /home/ding/Disk/Sync/Obsidian/wiki

Build:

cd /home/ding/Documents/project/quartz-site/
./deploy.sh

修改记录

新建Self-Hosted目录，文件不用带Self-Hosted前缀了，因为自托管应用可不少。

在线文档： https://docs.luoxingding.com/

笔记整理方案规范

MOC 目录用于主索引，不要条目过多

命名：驼峰和连字符类别-用途-应用名应用名-分设置

本仓库不可冗余污染

好的！
我来为你定制一份高质量的 Quartz 4.x + Obsidian 生产级命名规范与最佳实践，适合你现在的架构，未来也利于迁移、SEO、稳定 URL，不易踩坑。

Quartz 4.x 生产级命名规范与最佳实践

适用场景：

✅ Obsidian 本地笔记库
✅ Quartz 4.x 静态发布系统
✅ Nginx Web 服务器静态托管
✅ SEO友好、URL稳定、未来迁移方便

1️⃣ 目录结构规范

以主题分类为父目录，目录前缀数字用于排序：

content/
├── 00-Inbox/         # 收集箱
├── 01-MOC/           # 知识地图与目录
├── 02-Templates/     # 模板（已在 quartz.config.ts 排除）
├── 20-Tech/          # 技术类笔记
├── 40-Life/          # 生活类笔记
├── 50-Archive/       # 归档区
└── index.md          # 首页

2️⃣ 文件命名规范

核心原则：文件名 = 最终 slug = URL 结尾

只使用小写字母、数字、短横线 -
禁止空格、中文、下划线、特殊符号
不要使用长句子，控制在 3~5 个词
关键词优先

例如：

原文件名	建议文件名
`Tool-Samba.md`	`samba.md`
`Nginx-SSL配置.md`	`nginx-ssl.md`
`邮件服务器.md`	`mail-server.md`
`AppFlowy-部署.md`	`appflowy-deploy.md`

3️⃣ YAML Frontmatter 规范

保留 title 与 date，slug 可选（备用于 future-proof）：

---
title: Samba 共享文件
date: 2025-06-11
slug: samba
tags: [Tech, Tool, NAS]
---

注意：当前 Quartz 4.x slug 不影响 URL，仍需靠文件名控制路径。未来升级时 slug 可能生效。

4️⃣ Quartz 配置最佳实践

在 quartz.config.ts：

export default {
  ignorePatterns: ["02-Templates/**"],  // 忽略模板目录
  // 其他配置保持默认
}

5️⃣ Nginx 配置要点

server {
    listen 443 ssl http2;
    server_name docs.luoxingding.com;
 
    ssl_certificate     /etc/nginx/ssl/cert.pem;
    ssl_certificate_key /etc/nginx/ssl/key.pem;
 
    root /var/www/docs;
    index index.html;
 
    location / {
        try_files $uri $uri/ =404;
    }
}

无需复杂 rewrite，Quartz 已输出静态扁平目录。

6️⃣ URL 示例效果

最终你的网站地址将非常漂亮：

页面	URL
Samba 共享文件	`https://docs.luoxingding.com/20-Tech/samba`
Nginx SSL配置	`https://docs.luoxingding.com/20-Tech/nginx-ssl`
邮件服务器搭建	`https://docs.luoxingding.com/20-Tech/mail-server`

7️⃣ 自动化建议（进阶）

Obsidian 中新建笔记时，使用模板规范化文件名；
可用 Obsidian 插件如 Templater + QuickAdd 实现自动命名；
rsync 脚本部署，定时构建。

🌱 你未来的 Quartz 系统将非常稳健

✅ Obsidian 与 Quartz 完美同步
✅ URL 长期稳定
✅ SEO 友好
✅ 易于迁移与备份
✅ 可持续更新

👉 如果你愿意，我还可以顺手再帮你做一份：

「完整自动化发布脚本」
一键从 Obsidian 自动发布到远程服务器。

要不要？ 👇

取消MOC目录，index作为总MOC.

将本仓库使用私有的gitea托管。仅电脑端使用，无需同步移动端修改。

该在线文档当前管理办法

使用Obsidian做笔记
使用Gitea托管源码
使用Quartz构建在线文档
通过脚本构建并传输到服务器

以下为需要使用到的各个组件。

rsync
nginx

文件架构目录-笔记，不要设置子目录，相应的多个笔记使用驼峰命名附件资源，不用放图床，直接在本地images目录

示例：有点东西公司_北雪南送项目_项目企划书_20240107_V1.2_#未完成_@麦先生【内部】.docx

命名参考

不设编号了笔记不设子目录，附件，图片等非笔记例外（模板，附件，图片等放在同一目录的不同子目录）

修订：图片：images 且不能忽略，否则抓不到，至于附件需要下载的则给出链接算了，放一起反而会越发冗余。文件下载的方式也不少，如nginx，dufs等。

SelfHosted/Cloudreve_deploy.md
Server/Nginx_ssl.md
Linux/
Other

版本不以标签形式体现，会造成链接变动，以标签形式吧
Server/Nginx_Domain_V0.1.md >> Server/Nginx_Domain.md

https://quartz.jzhao.xyz/authoring-content

以后笔记还是用obsidian，只用两个库，不可贪多。

text

🪴 Notes Shared

探索

简介和指南

新版

旧版