NotionNext更新指南

2022-6-2|2023-1-17
tangly1024
tangly1024

项目更新

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

最简单的更新

您的项目若版本比较旧,则右上角将会出现一个 Fetch upstream 按钮,点击并选择 Fetch and merge即可更新为最新的代码
notion image
或者如果出现 UpdateBranch 选项也可以直接更新,不要点击 Discard xx commits 选项,这样会丢失您自己的代码修改。
notion image
💡
如果您此处的按钮既不是 Fetch and merge,也没有 Update branch,则说明我的代码和您的有冲突,请小心驾驶。

代码冲突时的更新

注意

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

高级更新

当我和你的代码发生冲突(confilcts),(例如我修改了blog.config.js文件,你也修改了此文件),导致在更新时,Git需要人工确认要合并代码时需要保留的最终代码版本。
  • 不要点 Discard xx commits
    • 图中右上角Sync fork 按钮下只有Discard 2 commits,不要点他
      图中右上角Sync fork 按钮下只有Discard 2 commits,不要点他

下载Github Desktop

建议是用github之类的代码版本管理工具,在您的电脑上进行合并。

参考教程

这里具体的更新合并步骤教程待完成。您可以参阅以下两位战友的热心分享:
Git实践应用 | Anjhon's Blog
将本地文件夹初始化为给本地git仓库,在github上新建仓库,将本地的仓库推送到远程仓库 如果想要将本地文件夹同步到已经存在且有数据的远程仓库中,建议先将本地文件上传到github,再使用vscode进行克隆,然后修改,然后推送 3、授权完成再点击克隆存储库,会出现弹窗,可以选择需要克隆的仓库 1、在对本地仓库进行更改之后会查看到提示,第一步需要将本地更改提交到 暂存区 2、将 暂存区的更改提交到本地 版本库(master) 1、Failed to connect to github.com port 443:connection timed out 2、Git: fatal: unable to access ' https://github.com/.git/ ': LibreSSL SSL_read: error:02FFF03C:system library:func(4095):Operation timed out, errno 60 网络问题,连不上github,当前网络限制访问github导致的报错原因; 3、Git: fatal: unable to access ' https://github.com/anjhon1994/My_tools.git/ ': Failed to connect to port 443 after 75062 ms: Operation timed out git使用的网络端口不是VPN的端口,将git端口设置为vpn端口 1、先使用GitHubDesktop克隆fork后的仓库到本地 2、选择原仓库的想要更新的版本,合并到自fork后的仓库 3、如果是整个文件都被修改了(文件名相同但内容不同,如相同名称的图片)会询问是使用哪个分支的提交; 4、如果是代码文件的内容有冲突,则会提示在你的默认编辑器中进行手动合并;
Git实践应用 | Anjhon's Blog

其他部署方式更新

除了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分钟)。
完成部署
完成部署

更新日志

可在 https://github.com/tangly1024/NotionNext/releases 查看版本更新发布历史。
 
 
NotionNext配置评论插件-Valine/WalineLinux命令行编辑快捷键
  • Twikoo
  • Waline
  • Giscus
  • Cusdis