lightpointventures 搭建博客
帮用户快速生成一个可以直接使用的个人博客网站。
步骤
1. 了解需求
依次提问（每次一个）：
问题 1：博客用途
这个博客是做什么的？比如技术分享、个人日记、作品集。
问题 2：技术偏好
你想用什么方案？从简单到复杂排列：
- 纯 Markdown + GitHub Pages — 零配置，写完 push 就上线，适合只想写文章不想折腾的人
- Hugo — Go 编写的静态站点生成器，构建极快（毫秒级），不需要 Node.js 环境
- 11ty (Eleventy) — 轻量 Node.js 静态生成器，模板灵活，零客户端 JS
- Astro — 支持 Markdown + 组件混写，内置代码高亮和 RSS，适合技术博客
- Next.js — 适合需要动态功能（评论、搜索、用户系统）的博客
- 纯静态 HTML — 完全手写，适合想学前端基础的新手 不确定的话我根据你的用途帮你选。
问题 3：风格偏好
喜欢什么风格？
- 简约 — 大量留白，黑白灰主色，内容为中心（类似 Medium）
- 技术感 — 深色主题，等宽字体，终端风格配色
- 文艺 — 衬线字体，暖色调，杂志排版感
- 文档风 — 侧边栏导航，适合系列教程或知识库 没想法我来选。
2. 生成博客
根据选择生成完整的博客项目：
- 首页 — 文章列表，按时间倒序
- 文章页 — 支持 Markdown 渲染，代码高亮
- 关于页 — 个人介绍
- 示例文章 — 2-3 篇示例文章，展示 Markdown 用法
- SEO — meta 标签、Open Graph、sitemap
技术要求：
- 响应式布局，移动端友好
- 配色和谐，排版专业
- 纯 Markdown/GitHub Pages 方案：只需一个仓库，README 或 index.md 即可
- Hugo/11ty 方案：提供本地预览命令和构建命令
- 如果是纯静态 HTML 方案，单文件夹即可运行
3. 验证和调整
博客已生成，用浏览器打开预览。 想调整什么？比如换颜色、改布局、加功能。
迭代修改直到满意。完成后提示：
用 /deploy 可以把博客部署上线。
遇到问题
- 构建失败 — 先检查 Node.js / Hugo / Ruby 版本是否匹配项目要求；删除 node_modules 和 lock 文件后重新安装
- GitHub Pages 部署后页面空白 — 检查仓库 Settings > Pages 中 Source 分支和目录是否正确；确认 baseURL 配置与实际域名一致
- Markdown 渲染异常（图片不显示、代码块错乱） — 检查图片路径是否用相对路径；代码块确认用三个反引号且语言标识正确
- 样式在本地正常但部署后丢失 — 检查 CSS/资源路径是否用了绝对路径
/开头，GitHub Pages 子目录部署需要加 baseURL 前缀 - RSS 订阅不工作 — 确认生成了 feed.xml 或 rss.xml，且 head 中有对应的 link 标签