用 Astro 搭建的个人博客，网址：https://mistyxrain.github.io/
会打开一个「提灯 · 本地写作」窗口，可以：
- 导入思源：在思源里对文档「导出 → Markdown」得到 zip，直接拖进窗口。标题、正文、图片、附件、题头图（作为封面）都会自动处理。
- 新建 / 编辑：填标题、简介、日期、标签（可点选已有标签）、封面（可从正文图片里挑，或上传），勾选「草稿」则暂不发布。正文是所见即所得编辑器（和思源同源的 Vditor），可直接拖入/粘贴图片，也可「从思源 zip 导入正文」；工具栏右侧可切换到「即时渲染」或「源码」模式。
- 站点设置：改博客名、个签、邮箱、微信二维码（网站顶部的信封/微信图标）、首页背景图和透明度（默认是程序绘制的孔明灯夜景，可随时「恢复默认」）。
- 标签管理：新增、改名、删除标签，会同步修改所有相关文章。
- 修改已发布的文章：左侧点开 → 修改 → 保存 → 发布。可点「更新日期 · 今天」让文章显示“更新于”。
- 删除文章：编辑页「删除文章」→ 移到「回收站」，可恢复或彻底删除；点「发布到网站」后网站上才会移除。想暂时下线，勾「草稿」再发布即可。
- 预览：保存后在本地博客里查看效果（草稿也能预览）。
- 发布到网站：确认后自动提交并推送，1～2 分钟后网站更新。
关掉黑色的命令行窗口即退出。导入后没保存的图片放在临时区，不会被发布，下次启动时自动清理。
写作工具（
tools/editor/）只读写下面这几个位置的普通文件，不依赖 Astro 内部代码，所以 Astro 升级通常不影响它：src/content/blog/*.md（文章）、src/assets/posts/<网址名>/（图片）、public/files/<网址名>/（附件）。
npm install # 第一次使用时安装依赖
npm run dev # 打开 http://localhost:4321 预览在 src/content/blog/ 下新建一个 .md 文件，文件名就是网址（建议用英文或拼音，如 my-new-post.md → /post/my-new-post/）。开头写上：
---
title: "文章标题"
description: "一句话简介"
pubDate: 2026-10-11
tags: ["R", "随笔"]
heroImage: ../../assets/posts/my-new-post.jpg # 封面图，可省略
draft: false # 写 true 则暂不发布
---
正文用 Markdown 写。行内公式 $E=mc^2$，独立公式：
$$
\hat\beta = (X'X)^{-1}X'y
$$- 封面图放在
src/assets/posts/，文中图片也可以放这里，用引用。 - 图片会在构建时自动压缩，不用手动处理。
git add .
git commit -m "新文章：xxx"
git push推送后 GitHub 会自动构建，1～2 分钟后网站更新（进度见仓库的 Actions 页）。
| 想改的东西 | 文件 |
|---|---|
| 博客名、个签、邮箱、微信二维码、首页背景图 | src/site.json（或写作工具「站点设置」） |
| 导航菜单、评论服务地址 | src/consts.ts |
| 颜色、字体、排版 | src/styles/global.css |
| 首页 | src/pages/index.astro |
| 文章页布局 | src/pages/post/[...slug].astro |
| "关于"页 | src/content/blog/guan-yu-wo.md |
文章页底部的留言区和标题下的"阅读 N"由 Waline 提供。访客填昵称、邮箱即可留言，无需注册。
服务端需要自己部署一次（免费），部署好后把地址填进 src/consts.ts 的 WALINE_SERVER。
- 用 GitHub 账号登录 https://vercel.com。
- 打开 https://vercel.com/new/clone?repository-url=https://github.com/walinejs/waline/tree/main/example，按提示创建项目。
- 在 Vercel 项目里：Storage → Create Database → 选 Neon（免费的 PostgreSQL）→ 连接到这个项目。
- 打开 Neon 控制台的 SQL Editor，执行 waline.pgsql 里的内容建表。
- 回到 Vercel：Deployments → 最新一次 → Redeploy。
- 访问
https://你的项目.vercel.app/ui/register注册——第一个注册的账号就是管理员，可以审核、删除、回复评论。 - 想在有人留言时收到邮件：在 Vercel 的 Settings → Environment Variables 里配置
SMTP_SERVICE、SMTP_USER、SMTP_PASS、AUTHOR_EMAIL等（见 Waline 文档"评论通知"）。
注意：
*.vercel.app在国内访问不稳定。若国内读者看不到留言区，可在 Vercel 的 Settings → Domains 绑定一个自己的域名（如comment.你的域名.com），再把WALINE_SERVER改成它。