首先我们需要准备这些工具#

• 能够独立思考的大脑 x 1：用于看懂本文，以及独立解决可能遇到的问题
• Github账号 x 1：用于Fork仓库和存储博客代码
• Git 版本控制工具 x 1：用于将Github仓库克隆到本地，以及后续上传博客内容
• Node.js x 1：Fuwari基于Node.js开发，需安装此环境才能运行
• Cloudflare账号 x 1：用于将博客部署到Cloudflare Pages，同时获取免费SSL证书等服务
• Obsidian x 1：一款非常好用的Markdown编辑器，能实时预览文本效果，用来写博客刚刚好

第一步：Fork Fuwari仓库#

1. 登录你的Github账号
2. 访问Fuwari的官方模板仓库：https://github.com/saicaca/fuwari
3. 点击仓库页面右上角的「Fork」按钮（如下图）
4. 跳转后无需修改其他配置，直接点击绿色的「Create fork」按钮即可（注：若已Fork过，此按钮会显示为「Sync fork」）
5. 进入你Fork后的仓库页面，点击绿色的「Code」按钮，复制弹出窗口中最上方的Git地址（示例：https://github.com/你的用户名/fuwari.git）

第二步：本地部署环境#

1. 在电脑上新建一个文件夹（如命名为「blog」），用于存放博客代码
2. 打开终端，通过cd 文件夹路径命令导航到这个新建文件夹（例：cd /Users/你的用户名/Documents/blog）
3. 在终端执行刚才复制的Git命令，克隆仓库：git clone https://github.com/你的用户名/fuwari.git（网络稳定的情况下，等待克隆完成后，文件夹内会出现「fuwari」子文件夹）
4. 安装pnpm包管理工具：在终端执行npm install -g pnpm（全局安装，后续可重复使用）
5. 进入Fuwari项目根目录：cd fuwari
6. 安装项目依赖：依次执行pnpm install和pnpm add sharp（sharp用于处理图片资源，是Fuwari的必要依赖）
7. 完成以上步骤后，本地环境就搭建好了，可通过后续命令预览博客效果

最后，你可以参考Fuwari官方仓库的Readme.md，进行博客的基础配置（如修改站点名称、作者信息等）。

1. 新建文章#

1
pnpm new-post <你的文章标题>

执行后会在项目根目录的 src/content/posts 文件夹中，自动生成一个名为「你的文章标题.md」的文件。

2. 本地调试（预览效果）#

1
pnpm dev

执行后终端会显示本地访问地址（通常是 http://localhost:4321），打开浏览器访问即可实时预览博客效果，修改内容后页面会自动刷新。

3. 构建生产版本#

1
pnpm build

将博客构建为可部署的静态文件，输出到项目根目录的 ./dist/ 文件夹中（部署时需上传此文件夹内的内容）。

4. 配置Git全局账号（首次使用Git需执行）#

1
git config --global user.name "你的Github用户名"
2
git config --global user.email "你的Github注册邮箱"

5. 上传代码到Github（更新博客后）#

1. 提交所有修改的文件：git add .（注意末尾的点，表示“所有文件”）
2. 添加提交说明：git commit -m "你的提交信息"（示例：git commit -m "新增Hello-Fuwar文章"）
3. 推送到远程仓库：git push（首次推送可能需要输入Github账号密码或Token，按提示操作即可）