649 字
3 分钟
Fuwari搭建指北
想要拥有一个加载速度快、设计优雅的静态博客？Fuwari或许正是你需要的解决方案。
环境准备
在开始之前，请确保你的系统满足以下要求：
- Node.js >= 20
- pnpm >= 9
- Git
安装 Node.js
- 访问 Node.js 官网，下载并安装 Node.js LTS 版本
- 安装完成后，打开终端，验证安装：
Terminal window node --version
安装 pnpm
在终端中执行以下命令安装 pnpm：
npm install -g pnpm验证安装：
pnpm --version安装 Fuwari
-
克隆项目仓库：
Terminal window git clone https://github.com/yyhhkya/fuwari.gitcd fuwari -
安装依赖：
Terminal window pnpm install -
启动开发服务器：
Terminal window pnpm dev
现在你可以在浏览器中访问 http://localhost:4321 查看博客了。
配置修改
基本配置
主要配置文件位于 src/config.ts，你需要修改以下内容：
- 网站标题、描述
- 作者信息
- 社交媒体链接
- 评论系统配置
- 导航菜单设置
自定义样式
你可以通过修改以下文件来自定义网站样式：
src/styles/variables.styl- 主题颜色等变量src/styles/main.css- 全局样式src/styles/markdown.css- 文章内容样式
创建文章
使用以下命令创建新文章：
pnpm new-post <文章标题>文章将在 src/content/posts 目录下创建，使用 Markdown 格式编写。
创建自定义页面
使用以下命令创建自定义页面：
pnpm new-page <页面名称>页面将在 src/content/spec 目录下创建，使用 Markdown 格式编写。
部署方案
GitHub Pages 部署
- 在 GitHub 仓库设置中启用 GitHub Pages
- 配置 GitHub Actions 工作流（项目已内置）
- 推送代码后会自动构建并部署
服务器部署
- 配置
auto-deploy-fuwari/auto-deploy.sh脚本中的服务器信息 - 在服务器上设置好 nginx 配置
- GitHub Actions 构建完成后会自动部署到服务器
功能说明
Fuwari 二开版包含以下主要功能：
- 🎨 明暗主题切换
- 🔍 内置搜索功能
- 📝 Markdown 和 MDX 支持
- 🏷️ 标签和分类系统
- 💬 Giscus 评论系统
- 📱 响应式设计
- 🔝 文章置顶
- 🔗 友链管理
- 📊 统计代码集成
- 🚀 自动部署
常见问题
-
构建失败怎么办？
- 检查 Node.js 版本是否符合要求
- 确保使用 pnpm 安装依赖
- 查看 GitHub Actions 日志定位具体错误
-
如何修改友链？
- 编辑
src/friends_data.ts文件 - 按照已有格式添加或修改友链信息
- 编辑
-
如何添加统计代码？
- 在
src/head_data.ts中添加统计代码 - 支持百度统计、Google Analytics 等
- 在
结语
Fuwari 提供了一个现代化、功能完善的博客解决方案。通过本教程的指引，你应该已经能够成功搭建并运行自己的博客。如果在使用过程中遇到问题，欢迎查阅 项目文档 或提交 Issue。