NotionNext-升级教程

category
tags
type
status
slug
date
password
Last edited time
Jun 14, 2024 08:30 AM
summary
icon

前言

通过此文档您将学会如何将NotionNext升级至最新版本,参考此文档您可以完成整个项目的升级。
若您实在无法独立完成可以参考文末的求助方式。

版本号说明

请按需更新你的版本,每个版本由三位数字的版本号构成,例如某个版本号 3.16.4, 它的含义如下:
第一位: 3 大版本升级,架构调整时,此数字会增加,目前表示第三代: 第二位: 16 通常是新功能、新特性、新bug,目前是第16次新增功能: 第三位: 4 微小功能调整,修复bug的补丁,3代表打了3个补丁:

版本历史

本项目在长期维护更新中,不时将修复一些bug和增加新特性。新版本中对页面样式以及加载速度都做了大量的优化,因此推荐您更新到最新版。
您可以在NotionNext的Github仓库右上角点击Star,以便关注项目动态,您将第一时间收到新版本发布的消息。
notion image
访问以下文章可以查看版本更新记录:

简单更新方法

当您的代码版本落后于NotionNext最新版时,项目右上角将会出现一个更新按钮,这个按钮可能会有三种情况:
  1. 显示 Fetch upstream 按钮,点击并选择 Fetch and merge即可更新为最新的代码。
    1. notion image
  1. 显示 Sync fork 按钮,点击并选择 Update branch 按钮,即可自动更新。
    1. notion image
  1. 没有上面两种情况的按钮,这种情况下大概率是因为修改了相同部分的代码导致冲突,需要手动确认才能合并,请看下文。

出现冲突

当我和你的代码发生冲突(confilcts),(例如我修改了blog.config.js文件,你也修改了此文件),导致在更新时,Git需要人工确认要合并代码时需要保留的最终代码版本。
这里的弹框按钮具体内容有挺多情况,其中一种是这样,显示 Disard xx commits 或者 open pull request.
notion image
  • Discard xx commits 的意思是强制升级到最新版,并且将你之前自己的修改覆盖掉,点击此选项请注意备份自己修改的配置。
  • Open Pull Request 通常不会使用,它意味着你希望将你修改的功能或者修复的bug,提交到NotionNext的中央仓库,简称PR(贡献代码)我会审核你的提交内容,如果审核通过将会在新版本中发布。

带有冲突的更新

  • 简单方案1
      1. 备份自己改动的配置文件 例如 blog.config.js ,以及主题 /themes/xx/config.js
      1. 然后点击放弃xx次提交, 点击 Discard 21 commits,表示放弃自己的修改,
        1. notion image
      1. 然后就可以正常更新, 点击Update branch,页面上方出现一个蓝色的提示横幅,告诉我已经成功更新。
      1. 更新后,按照之前备份的配置文件,重新配置
        1. notion image
  • 重头再来
    • 若你并不是熟悉Git的操作,推荐做法是备份一下您的代码,诸如blog.config.js配置文件,然后重新fork一遍项目,再更新新版本中的配置项,重新配置即可。
      所有文章数据都存在你的notion笔记中,此处重新部署的速度其实很快,无需太多配置。
 

优化建议

建立一个专用部署分支

您可以选择在Git仓库中,建立属于自己的分支,例如我建了一个 deploy/tangly1024.com 分支, 并在vercel中导入并选择使用该分支进行部署,main分支则用于提交更新最新的代码版本。
notion image
notion image
 
这样,以后您只需在自己的分支修改代码,然后每次更新NotionNext版本只是main分支的更新,然后在自己的仓库中选择将main合并到自己建立的部署分支即可。

部署更新失败如何解决

更新后打开网页,版本号还是旧的?
请检查Vercel部署日志,查看日志方法。

Deployment模块

打开Vercel后台的Deployment标签,这里可以查看您的所有部署记录。
在Deployment中可以查看每次部署记录
在Deployment中可以查看每次部署记录
其中,部署状态是绿色的Ready表示成功,标注为红色的Error则失败
notion image

查看错误日志

点击此次部署记录的标题,打开详情页面
notion image
详情页下方,是打包编译的日志,在Error分组中展现了出现错误的原因,以及对应的代码行数。按照提示修正github中的代码即可重新部署。
notion image

寻求帮助

Waiting List - ProV4.6.0
Loading...
Catalog
Article List
✨ 更新日志
🚀 安装部署
✒ 写作指引
🛠 站点配置
📊 网站统计
⭐ 主题配置
📩 评论插件
🧷 外部插件
🔊 站点订阅
⌨ 开发指引
👨‍👦‍👦 联系方式
🤝 购买服务