NotionNext帮助手册✨ 更新日志
🚀 安装部署
✒ 写作指引
🛠 站点配置
📊 网站统计
⭐ 主题配置
📩 评论插件
🧷 外部插件
🔊 站点订阅
⌨ 开发指引
👨👦👦 联系方式
🤝 购买服务
NotionNext-升级教程
category
tags
type
status
slug
date
password
Last edited time
Jun 28, 2024 01:33 AM
summary
icon
前言
通过此文档您将学会如何将NotionNext升级至最新版本，参考此文档您可以完成整个项目的升级。
若您实在无法独立完成可以参考文末的求助方式。
版本号说明
请按需更新你的版本，每个版本由三位数字的版本号构成，例如某个版本号
3.16.4， 它的含义如下：第一位：
3 大版本升级，架构调整时，此数字会增加，目前表示第三代：
第二位： 16 通常是新功能、新特性、新bug，目前是第16次新增功能：
第三位： 4 微小功能调整，修复bug的补丁，3代表打了3个补丁：版本历史
本项目在长期维护更新中，不时将修复一些bug和增加新特性。新版本中对页面样式以及加载速度都做了大量的优化，因此推荐您更新到最新版。
您可以在NotionNext的Github仓库右上角点击Star，以便关注项目动态，您将第一时间收到新版本发布的消息。
访问以下文章可以查看版本更新记录：
简单更新方法
当您的代码版本落后于NotionNext最新版时，项目右上角将会出现一个更新按钮，这个按钮可能会有三种情况：
- 显示
Fetch upstream按钮，点击并选择Fetch and merge即可更新为最新的代码。
- 显示
Sync fork按钮，点击并选择Update branch按钮，即可自动更新。
- 没有上面两种情况的按钮，这种情况下大概率是因为修改了相同部分的代码导致冲突，需要手动确认才能合并，请看下文。
出现冲突
当我和你的代码发生冲突（
confilcts），(例如我修改了blog.config.js文件，你也修改了此文件)，导致在更新时，Git需要人工确认要合并代码时需要保留的最终代码版本。这里的弹框按钮具体内容有挺多情况，其中一种是这样，显示
Disard xx commits 或者 open pull request.
Discard xx commits的意思是放弃修改的代码，这样就可以消除你与我的代码冲突，然后就可以点击update更新。点击此选项请注意备份自己在代码中修改的配置。
Open Pull Request非专业人士请勿点击此项。它意味着你希望将你修改的功能或者修复的bug，提交到NotionNext的中央仓库，简称PR（贡献代码），我会审核你的提交内容，如果审核通过将会在新版本中发布。
带有冲突的更新
- 简单方案1
- 备份自己改动的配置文件 例如 blog.config.js ，以及主题 /themes/xx/config.js
- 然后点击放弃xx次提交, 点击 Discard 21 commits，表示放弃自己的修改，
- 然后就可以正常更新, 点击Update branch，页面上方出现一个蓝色的提示横幅，告诉我已经成功更新。
- 更新后，按照之前备份的配置文件，重新配置
- 重头再来
若你并不是熟悉Git的操作，推荐做法是备份一下您的代码，诸如
blog.config.js配置文件，然后重新fork一遍项目，再更新新版本中的配置项，重新配置即可。所有文章数据都存在你的notion笔记中，此处重新部署的速度其实很快，无需太多配置。
- 更多手动方案，感谢网友们的分享！
优化建议
建立一个专用部署分支
您可以选择在Git仓库中，建立属于自己的分支，例如我建了一个
deploy/tangly1024.com 分支， 并在vercel中导入并选择使用该分支进行部署，main分支则用于提交更新最新的代码版本。
这样，以后您只需在自己的分支修改代码，然后每次更新NotionNext版本只是main分支的更新，然后在自己的仓库中选择将main合并到自己建立的部署分支即可。
部署更新失败如何解决
更新后打开网页，版本号还是旧的？
请检查Vercel部署日志，查看日志方法。
Deployment模块
打开Vercel后台的Deployment标签，这里可以查看您的所有部署记录。
其中，部署状态是绿色的
Ready表示成功，标注为红色的Error则失败
查看错误日志
点击此次部署记录的标题，打开详情页面
详情页下方，是打包编译的日志，在
Error分组中展现了出现错误的原因，以及对应的代码行数。按照提示修正github中的代码即可重新部署。
寻求帮助
- 留言求助
- 社群讨论
- 向我寻求助
Loading...
Last update: 2022-06-02