Lazy loaded image
NotionNext更新教程
Noooter
Mar 6, 2026
Mar 6, 2026
type
Post
status
Invisible
date
Mar 6, 2026
writer
Noooter
summary
NotionNext关键更新的教程,留个记录
tags
category
icon
password
slug

更新步骤

📢
万事问AI!!!Gemini可以实际解决很多问题!!!
仓库地址:
如果要更新NotionNext,在frok的NotionNext项目里点击Sync Fork,查看里面的提示再来分情况更新;更新后记得新Deploy一下~
notion image

正常更新

正常情况下,如果有更新就是像下面一样,可以直接更新,直接点击Update branch即可,不要点击Discard XX commits,这样的话之前所有的修改就全部没了。
notion image

特殊更新

如果出现了下面的提示,那一定是勤劳的tangly1024又更新了配置文件,Github无法理解差异,没办法直接更新了。具体步骤看下面👇🏻
notion image
⚠️
这种情况下点击Open pull request会把代码上提交到NotionNext中央仓库(贡献代码),不能随便点!
 

特殊更新冲突解决办法

总的来说,这个办法就是,先提交贡献代码,然后把提交的贡献代码删掉,不给人添乱。

解决步骤

  1. 先打开Pull requests,点击New pull request新建一个合并请求;
    1. notion image
  1. 点击Create pull request建立合并请求;
    1. notion image
  1. Add a title里面随便设置一个标题,点击Create pull request,创建合并请求;
    1. notion image
  1. 拉到最底下,点击Resolve conflicts,手动解决冲突;
    1. notion image
  1. 修改冲突的代码,修改好之后点击Mark as resolved,标记为已经解决;
    1. notion image
  1. 再点击Commit merge,提交更新;
  1. 如果你调试之后一切正常了,更新也完成了,记得去tangly1024的NotionNext中央仓库,打开Pull requests,找到自己的合并请求,然后把它关闭掉。
 

本地调试

⚠️
请注意Notion上线地址!感觉有时候NOTION_PAGE_ID会变动!特别是遇到Notion大更新,导致NotionNext必须更新的情况下!
  • 项目本地位置:WeLoveArale/♾️Code/Noooter/NotionNextNoooter
  • 项目文件夹拖到VSCode后,终端运行npm run dev,可以在本地打开调试(http://localhost:3000)。
  • 部署到Netlify使用的直接是main主支,所有的pull命令也是pull origin main
  • 由于本地调试需要调用Notion数据,最好开启TUN模式
 

修改文件

更新之后可能需要修改部分文件,这里是手动修改文件列表,需检查后判断是否需要修改:
 

配置文件

NOTION_PAGE_IDAPI_BASE_URL只能在文件和环境变量中配置:
本地调试:在.env.local中填写,并且把文件加入.gitignore,这样文件只会保存在本地,每次合并、push都不会被上传到网上,更安全哦~(使用的ALGOLIA搜索插件在本地调试时也是把环境变量写到这里)
网络配置:直接在Netlify的环境变量中配置
 
其它可以直接在Notion的配置中心中配置,需要开启的功能勾选☑️即可
默认主题:heo
默认语言:en-US
 

语言

目前只有一种语言版本,使用的是英文版en-US,但是版权声明需要更换:
📢
COPYRIGHT_NOTICE: '如无特别声明,本文版权归©Noooter电子手帐所有, 采用 CC BY-NC-ND 4.0 许可协议,转载请附上原文出处链接和本声明。',
修改路径:/lib/lang/en-US.js
 

重新安装部署

之前安装部署过程的记录

本地部署过程

  1. fork项目到账号(isunkit),clone到本地,先看有没有Node.js环境(过程可以问AI),目前Mac mini已全局安装
  1. 在新的项目文件夹运行前要npm install(在Terminal安装比较好)
  1. 安装之后npm run dev即可运行项目
  1. 如遇上无法连接到站点,可能是Notion被墙,需开TUN模式
 

修改项目内容

  1. 从.env.example复制一份文件重命名为.env.local,修改里面的NOTION_PAGE_ID和 API_BASE_URL,并把文件加入.gitignore(可以把其它在Netlify的环境配置内容都填在这里,方便本地调试)
  1. 修改文件blog.config.js(大部分能在Notion配置中心修改的都修改了)
  1. 主题选择heo(其实这也是配置文件里面的,单独说一下)
  1. 修改themes-heo-config.js
  1. 替换站点图标public-favicon(直接替换文件即可)
  1. 替换顶栏右侧板块背景图public-bg_image.jpg(直接替换文件即可)
  1. 增加手帐APP图标图片public-images-heo(直接把图片拖进去即可)
  1. themes-heo-style.js修改(修改部分标注了新增style by arale
  1. styles-global.css修改(修改部分标注了新增style by arale
  1. 修改themes-heo-index.js注释<Footer/><PostAdjacent {...props} /><ShareBar post={post} />(修改部分标注了modified by arale
  1. 全局搜索替换以下部分(要先11再12,不然12有的地方搜不到)
    1. dark:hover:border-yellow 👉🏻 dark:hover:border-indigo
    2. dark:hover:text-yellow 👉🏻 dark:hover:text-indigo
    3. dark:group-hover:text-yellow 👉🏻 dark:group-hover:text-indigo
    4. dark:bg-yellow 👉🏻 dark:bg-indigo
    5. dark:hover:bg-yellow 👉🏻 dark:hover:bg-indigo
  1. 修改themes-heo-components文件夹下的:Hero.js、:(修改部分标注了modified by arale
  1. themes-heo-components文件夹内部替换:
    1. Hero.js
      1. top-10 left-10 👉🏻 top-6 left-5
      1. 'text-4xl font-bold mb-3 dark:text-white’ 👉🏻 'text-4xl font-bold mb-3 text-indigo-700'
      1. 'w-2/3 hidden xl:block’ 👉🏻 'hidden xl:block’
      1. bg-[#4259efdd] dark:bg-[#dca846] 👉🏻 bg-[#df9283db] dark:bg-[#df9283db]
      1. '-ml-3 text-gray-300’ 👉🏻 '-ml-3 text-white’
      1. today-card h-full bg-black 👉🏻 today-card h-full bg-white
      1. text-white p-10 items-end 👉🏻 text-indigo-700 p-10 items-end
      1. justify-center rounded-3xl 👉🏻 justify-center bg-indigo-400 text-white rounded-3xl
      InfoCard.js
      1. fadeInUp bg-[#4f65f0] dark:bg-indigo-600 👉🏻 fadeInUp bg-[#f9f3eb] dark:bg-[#424242]
      1. text-3xl font-extrabold mt-3 👉🏻 text-3xl text-indigo-700 font-extrabold mt-3
      1. dark:bg-indigo-500 dark:hover:bg-black 👉🏻 hover:text-indigo-700
      1. 去掉hover:text-black dark:hover:text-white(替换为空白)
      1. group bg-indigo-400 dark:bg-indigo-500 hover:bg-white dark:hover:bg-black 👉🏻 group bg-indigo-400 hover:text-indigo-950 hover:bg-white
      1. Line91-95 👉🏻 Line956(修改部分标注了modified by arale
      1. hover:bg-indigo-50 hover:text-indigo-950 dark:bg-indigo-500 dark:hover:text-white dark:hover:bg-black 👉🏻 hover:bg-white hover:text-indigo-950
      MenuItemCollapse.js
      1. hover:bg-gray-50 dark:hover:bg-gray-900 👉🏻 hover:bg-indigo-50 dark:hover:bg-indigo-600
      MenuItemDrop.js
      1. hover:bg-black hover:bg-opacity-10 👉🏻 hover:text-white hover:bg-indigo-600
      1. cursor-pointer hover:bg-blue-600 👉🏻 cursor-pointer hover:bg-indigo-400
      PostHeader.js:
      1. 顶部新增import TagItemMini from './TagItemMini’
      1. ${isDarkMode ? '#CA8A04' : '#0060e0'} inset; 👉🏻 ${isDarkMode ? '#d68272': '#efc8c1'} inset;
      1. {`${isDarkMode ? 'bg-[#CA8A04]' : 'bg-[#0060e0]'} 👉🏻 {`${isDarkMode ? 'bg-[#d68272]' : 'bg-[#efc8c1]'}
      1. top-48 z-10 flex flex-col space-y-4 lg:-mt-12 👉🏻 top-30 z-10 flex flex-col space-y-4 md:top-40 lg:top-48 lg:-mt-12
      1. bg-blue-500 👉🏻 bg-indigo-600
      1. hover:text-blue-500 👉🏻 hover:text-blue-600
      1. 注释Line76-93;(修改部分标注了modified by arale
      1. <div className='flex justify-center '> 👉🏻 <div className='flex flex-col justify-center '>
      1. dark:text-gray-200 text-opacity-70 👉🏻 dark:text-white text-black
      1. 注释Line108-113;(修改部分标注了modified by arale
      1. 新增Line116-121;(修改部分标注了modified by arale
      1. 'fa-regular fa-calendar’ 👉🏻 'fa-regular fa-calendar mr-0.5’
      1. 'fa-regular fa-calendar-check’ 👉🏻 'fa-regular fa-calendar-check mr-0.5’
      1. 'busuanzi_container_page_pv font-light mr-2’ 👉🏻 'busuanzi_container_page_pv font-light pl-1 mr-2’
      1. 'fa-solid fa-fire-flame-curved’ 👉🏻 'fa-solid fa-fire-flame-curved mr-0.5’
      1. 新增Line152-160;(修改部分标注了modified by arale) 
      1. 更改嵌套关系 👉🏻 className='flex-col flex md:flex-row’后的</div>和className='pl-1 mr-2’后的</div>都移到</section>之前
      1. 去掉hover:underline(替换为空白)
      PostRecommend.js
      1. 注释Line59-62;(修改部分标注了modified by arale) 
      SideRight.js
      1. 新增Line48-56;(修改部分标注了modified by arale) 
      1. 注释Line37、Line64-70、Line76-86(修改部分标注了modified by arale
      SlideOver.js
      1. dark:bg-[#ff953e] 👉🏻  dark:bg-[#1e1e1e] dark:hover:bg-[#df9283]
      TagItemMini.js:
      直接按文件替换
      TouchMeCard.js
      1. bg-[#4f65f0] dark:bg-indigo-600 dark:border-gray-600 👉🏻 bg-[#f9f3eb] text-[#424242] dark:bg-[#424242] dark:text-white
      1. cursor-pointer lg:p-6 p-4 border 👉🏻 cursor-pointer lg:p-6 p-4
      1. font-[1000] text-3xl 👉🏻 font-[1000] text-3xl text-indigo-700
      1. font-[1000] text-xl h-full 👉🏻 font-[1000] text-xl h-full text-gray-600 text-gray-600 dark:text-white
  1. lib-lang文件夹内部替换:
    1. zh-CN.js
      本文采用 CC BY-NC-ND 4.0 许可协议,转载请注明出处。 👉🏻 如无特别声明,本文版权归©Noooter电子手帐所有, 采用 CC BY-NC-ND 4.0 许可协议,转载请附上原文出处链接和本声明。
      en-US.js
      All articles in this blog, except for special statements, adopt BY-NC-ND 4.0 agreement. Please indicate the source! 👉🏻 如无特别声明,本文版权归©Noooter电子手帐所有, 采用 CC BY-NC-ND 4.0 许可协议,转载请附上原文出处链接和本声明。 修改英文版声明是因为,网站使用的语言是en-US,但这里需要显示为中文。
  1. components-LoadingCover.js修改:
  1. styles/notion.css默认样式修改
    1. 字体颜色修改
      可以修改Notion默认字体颜色和背景色。
      品牌标准色使用:橙色,绿色,黄色,紫色。
      下图为修改前后对比:
      notion image
      notion image
      具体色号:文本为标准视觉的加深色;背景色则是light色(等级不一定)
      橙色文本.notion-orange .notion-orange_co👉🏻#d68272;
      橙色背景.notion-orange_background👉🏻#f7e4e0;
      绿色文本.notion-teal, .notion-teal_co👉🏻#73b192;
      绿色背景.notion-teal_background👉🏻#edf4f0;
      黄色文本.notion-yellow, .notion-yellow_co👉🏻#d3a259;
      黄色背景.notion-yellow_background👉🏻c;
      紫色文本.notion-purple, .notion-purple_co👉🏻#6659a7;
      紫色背景.notion-purple_background👉🏻#dddaea;
      粉色文本.notion-pink, .notion-pink_co👉🏻#fae4ef;
      粉色背景.notion-pink_background👉🏻#f8e5ea;
      红色文本.notion-red, .notion-red_co👉🏻#c83c3c;
       
 

Comments
Loading...