同步 Blog 主题变更：Webmention、互动区与样式修复

2026-08-30 20:57:39 +08:00
parent b70ed6051a
commit d6cd9ea4c5
23 changed files with 1534 additions and 38 deletions
@@ -2,7 +2,7 @@

 Mirages 是一个基于 Astro 的静态博客主题，用于发布文章和独立页面。旧版 PHP 文件位于本项目之外，保持不变。

-本文档说明 Astro 主题的常用配置、Twikoo 评论和文章 Frontmatter。
+本文档说明 Astro 主题的常用配置、Twikoo 评论、WebMention 和文章 Frontmatter。

 ## 运行项目

@@ -117,6 +117,22 @@ pnpm build

 如果页面显示“评论暂时不可用”，依次检查云函数地址是否能从浏览器直接访问、CORS 配置、Twikoo 环境变量和 `envId` 是否包含多余路径或空格。

+## WebMention 配置
+
+WebMention 与 Twikoo 并行工作：Twikoo 接收本站评论，WebMention 接收其他网站对文章的回复、提及、点赞和转发。配置入口位于 `src/site.config.ts`：
+
+```ts
+webmentions: {
+  enabled: true,
+  endpoint: 'https://webmention.example.com',
+  form: true
+},
+```
+
+启用后，全站 `<head>` 会声明 `${endpoint}/receive`，文章页从 `${endpoint}/get` 读取当前 canonical URL 的已批准 WebMention。`form` 控制是否在文章底部显示手动发送表单。
+
+仓库在 `deploy/webmention/` 提供了基于 webmentiond、SQLite 和 Docker Compose 的自托管配置。服务器部署、SMTP 登录、反向代理及验证步骤见该目录的 `README.md`。
+
 ## 文章 Frontmatter

 文章位于 `src/content/posts`，独立页面位于 `src/content/pages`。两者使用相同的字段结构：