【持续更新】NotionNext 3.15已上线, 更新历史

NotionNext升级操作指南

Tangly - 2022-06-02 - 软件技术 / NotionNext
2022-6-2|最后更新: 2023-5-29|
category
tags
type
status
slug
date
summary
icon
password

项目更新

本项目在长期维护更新中,不时将修复一些bug和增加新特性。新版本中对页面样式以及加载速度都做了大量的优化,因此非常推荐更新到最新版本。
访问以下文章查看版本日志:

最简单的更新

当您的代码版本落后于NotionNext最新版时,则右上角将会出现一个 Fetch upstream 按钮,点击并选择 Fetch and merge即可更新为最新的代码,或者如果出现 UpdateBranch 选项也可以直接更新。
notion image
 

出现冲突

当我和你的代码发生冲突(confilcts),(例如我修改了blog.config.js文件,你也修改了此文件),导致在更新时,Git需要人工确认要合并代码时需要保留的最终代码版本。
此时弹出框中会显示,Discard xx commits 选项;请谨慎点击,这么做意味着您放弃了自己修改的代码,选择与我的仓库代码保持完全一致。建议先做好备份。
notion image
💡
如果您此处的按钮既不是 Fetch and merge,也没有 Update branch,则说明我的代码和您的有冲突,请参考文章后面的部分进行操作。

冲突时如何更新

  • 推荐简单方案
    • 若你并不是熟悉Git的操作,推荐做法是备份一下您的代码,诸如blog.config.js配置文件,然后重新fork一遍项目,再更新新版本中的配置项,重新配置即可。
 

优化的建议

建立一个专用部署分支

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

常见问题

更新后打开网页,版本号还是旧的?
请检查以下两处
  1. vercel后台最新一次部署是否成功?
    1. notion image
  1. github代码是否合并成功? 检查您代码中的版本号 ,它在package.json 文件中。
    1. notion image

其他部署方式更新

除了Github fork部署,还支持Docker部署、Vercel一键Clone部署。这两种部署方式更新方法如下:

1.Docker 部署

备份你的blog.config.js 等自定义配置信息,并重新执行Docker指令,获取最新版本镜像。镜像已上传至Dockerhub,可以在安装Docker环境的系统中执行以下命令。
旧版
docker run -p 3000:3000 -e NOTION_PAGE_ID="02ab3b8678004aa69e9e415905ef32a5" notionnext:2.8.1 # 02ab3b8678004aa69e9e415905ef32a5 这个值可替换成你的Notion_PAGE_ID 此环境变量则默认读取示例文章
docker run -p 3000:3000 -e NEXT_PUBLIC_THEME="next" -e NOTION_PAGE_ID="02ab3b8678004aa69e9e415905ef32a5" tangly1024/notionnext:3.3.9 # 02ab3b8678004aa69e9e415905ef32a5 这个值可替换成你的Notion_PAGE_ID 此环境变量则默认读取示例文章
可在Github的Packages、或Dockerhub中查看所有docker镜像的版本

2.Vercel一键部署

删除旧版Vercel项目,重新按找以下步骤一键Clone部署。
2.选择用Github方式创建仓库,然后点击create 确认部署。
选择仓库创建方式
选择仓库创建方式
创建仓库
创建仓库
系统将自动完成部署(大约等待2分钟)。
完成部署
完成部署
NotionNext配置评论插件-Valine/WalineLinux命令行编辑快捷键