88
99Markdown 创建的页面通过固定路由访问:
1010
11- ```
12- https://你的域名/page/{slug}
13- ```
11+
12+ https://你的域名/page/{slug}
13+
1414
1515例如:
1616- 后台创建 slug 为 ` about ` 的页面 → 访问 ` https://blog.sharpfort.net/page/about `
@@ -24,23 +24,23 @@ https://你的域名/page/{slug}
2424
2525### 数据流
2626
27- ```
28- 后台 /admin/pages
29- │ 填写:标题 / Slug / Markdown 内容 / 排序 / 是否发布 / 是否显示导航
30- ▼
31- POST /api/admin/pages → D1 pages 表 (upsert)
32- │
33- ▼
34- 前台 /page/:slug
35- │ 路由匹配 → DynamicPage 组件
36- │ GET /api/pages/:slug → 读取 pages 表
37- ▼
38- renderMarkdown(content)
39- │ marked (解析) + highlight.js (代码高亮)
40- │ + KaTeX (数学公式) + DOMPurify (XSS 过滤)
41- ▼
42- HTML 输出 → 浏览器渲染
43- ```
27+
28+ 后台 /admin/pages
29+ │ 填写:标题 / Slug / Markdown 内容 / 排序 / 是否发布 / 是否显示导航
30+ ▼
31+ POST /api/admin/pages → D1 pages 表 (upsert)
32+ │
33+ ▼
34+ 前台 /page/:slug
35+ │ 路由匹配 → DynamicPage 组件
36+ │ GET /api/pages/:slug → 读取 pages 表
37+ ▼
38+ renderMarkdown(content)
39+ │ marked (解析) + highlight.js (代码高亮)
40+ │ + KaTeX (数学公式) + DOMPurify (XSS 过滤)
41+ ▼
42+ HTML 输出 → 浏览器渲染
43+
4444
4545### 核心渲染器
4646
@@ -112,44 +112,44 @@ HTML 输出 → 浏览器渲染
112112
113113当你需要在 Monolith 中新增一个页面时,把下面的提示词发给 AI Agent:
114114
115- ``` markdown
116- 我需要在 Monolith 博客中新增一个页面,请先帮我分析这个页面应该用哪个方案。
117-
118- 我的需求是:[ 在这里描述你的页面要做什么]
119115
120- 请按以下步骤帮我:
116+ 我需要在 Monolith 博客中新增一个页面,请先帮我分析这个页面应该用哪个方案。
117+
118+ 我的需求是:[在这里描述你的页面要做什么]
119+
120+ 请按以下步骤帮我:
121+
122+ 1. **方案判断**:分析这个页面是「纯内容展示」还是需要「数据查询/用户交互」,告诉我应该用 Markdown 页面还是全栈开发。
123+
124+ 2. **如果是 Markdown 页面**,请询问我以下信息:
125+ - 页面标题(必填)
126+ - URL Slug(如 about、friends,建议用英文小写连字符)
127+ - 内容取向:偏技术文档 / 个人介绍 / 项目展示 / 其他
128+ - 是否需要显示在顶部导航栏
129+ - 是否需要目录 TOC
130+ 然后根据我的回答,生成完整的 Markdown 内容,包括:
131+ - 合适的标题层级结构
132+ - 表格(如有对照信息)
133+ - 代码示例(如适用)
134+ - 图片/视频占位(如需要)
135+
136+ 3. **如果是全栈开发**,请告诉我需要新增哪些文件和 API,给出完整的实现方案(就像开发友链功能那样)。
137+
138+ 4. 生成后,告诉我如何在后台创建/部署这个页面。
121139
122- 1 . ** 方案判断** :分析这个页面是「纯内容展示」还是需要「数据查询/用户交互」,告诉我应该用 Markdown 页面还是全栈开发。
123-
124- 2 . ** 如果是 Markdown 页面** ,请询问我以下信息:
125- - 页面标题(必填)
126- - URL Slug(如 about、friends,建议用英文小写连字符)
127- - 内容取向:偏技术文档 / 个人介绍 / 项目展示 / 其他
128- - 是否需要显示在顶部导航栏
129- - 是否需要目录 TOC
130- 然后根据我的回答,生成完整的 Markdown 内容,包括:
131- - 合适的标题层级结构
132- - 表格(如有对照信息)
133- - 代码示例(如适用)
134- - 图片/视频占位(如需要)
135-
136- 3 . ** 如果是全栈开发** ,请告诉我需要新增哪些文件和 API,给出完整的实现方案(就像开发友链功能那样)。
137-
138- 4 . 生成后,告诉我如何在后台创建/部署这个页面。
139- ```
140140
141141### 简化版(你已经知道要用 Markdown)
142142
143- ``` markdown
144- 帮我在 Monolith 后台创建一个 Markdown 页面。
145- 标题:[ 你的标题]
146- Slug:[ url-slug]
147- 内容方向:[ 技术文档 / 个人介绍 / 项目展示 / 隐私政策 / 其他]
148- 显示在导航栏:[ 是 / 否]
149- 需要 TOC:[ 是 / 否]
150143
151- 请生成完整的 Markdown 内容。
152- ```
144+ 帮我在 Monolith 后台创建一个 Markdown 页面。
145+ 标题:[你的标题]
146+ Slug:[url-slug]
147+ 内容方向:[技术文档 / 个人介绍 / 项目展示 / 隐私政策 / 其他]
148+ 显示在导航栏:[是 / 否]
149+ 需要 TOC:[是 / 否]
150+
151+ 请生成完整的 Markdown 内容。
152+
153153
154154---
155155
0 commit comments