主题升级指南

主题升级指南

当主题发布新版本时，按照以下步骤升级你的数字花园。

升级步骤

1. 备份重要内容

BASH
# 备份你的内容和配置
cp -r content/ content_backup/
cp garden.config.js garden.config.js.backup

2. 添加主题仓库为上游

BASH
# 添加原始主题仓库为上游源
git remote add upstream https://github.com/weichen-ink/digital-garden-eleventy-theme.git

# 查看远程仓库配置
git remote -v

3. 拉取最新更新

BASH
# 获取上游最新代码
git fetch upstream

# 合并最新的主题代码
git merge upstream/main

4. 更新依赖并测试

BASH
# 更新依赖包
npm install

# 启动测试
npm run serve

注意事项

  • 保留你的内容：content/ 目录和 garden.config.js 通常不会被覆盖
  • 解决冲突：如果出现合并冲突，手动解决后再提交
  • 测试功能：升级后检查网站是否正常工作

常见问题

Q: 合并时出现冲突怎么办？

手动编辑冲突文件，保留你需要的内容，然后：

BASH
git add .
git commit -m "解决升级冲突"

Q: 升级后网站无法启动？

检查 package.json 和依赖：

BASH
rm -rf node_modules/
npm install

Q: 如何回到升级前的状态？

BASH
# 恢复备份
rm -rf content/
mv content_backup/ content/
cp garden.config.js.backup garden.config.js

升级很简单，大部分情况下一次性就能成功！