这篇说明本身也是笔记，写的是怎么维护这个站点。所有步骤都在本机完成，确认之后再上传。
新建一篇笔记
在 site/content/notes/ 下新建一个 Markdown 文件，文件名用英文小写和连字符，它会成为网址的一部分：
site/content/notes/sqlite-backup.md 对应 /notes/sqlite-backup/
文件开头是元信息：
---
title: SQLite 的一致性备份怎么做
date: 2026-10-12
draft: true
summary: 一句话说明这篇笔记解决什么问题，会出现在列表页。
---
draft: true 的笔记不会进入构建产物，只有本地预览加 -D 时会显示。确认要发布时改成 false。
本地预览
在 personal-site 目录下执行：
tools\hugo\hugo.exe server --source site -D
打开提示的地址就能看到效果，改文件后页面会自动刷新。
构建输出
确认内容无误后构建：
powershell -ExecutionPolicy Bypass -File scripts/build.ps1
产物全部在项目根目录的 public/ 里，是纯静态文件。部署时把整个目录上传到服务器的网站根目录；正式的域名和上传方式以仓库根目录的部署说明为准，这一篇只讲内容怎么写。
图片和附件
图片放在 site/static/uploads/，文件名同样用英文。正文里这样引用：
需要提供下载的文件也放在 static/uploads/，链接写到对应文件即可。
写小实验的另一种做法
如果实验本身就是一个独立的 HTML 页面，可以不走模板：把整个目录放到 site/static/lab/<名字>/ 里，然后在 site/content/lab/_index.md 正文中加一条链接。构建时会原样复制，不需要改任何模板。