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一下~
特殊更新冲突解决办法
总的来说,这个办法就是,先提交贡献代码,然后把提交的贡献代码删掉,不给人添乱。
解决步骤
- 先打开
Pull requests,点击New pull request新建一个合并请求;

- 点击
Create pull request建立合并请求;

- 在
Add a title里面随便设置一个标题,点击Create pull request,创建合并请求;

- 拉到最底下,点击
Resolve conflicts,手动解决冲突;

- 修改冲突的代码,修改好之后点击
Mark as resolved,标记为已经解决;

- 再点击
Commit merge,提交更新;
- 如果你调试之后一切正常了,更新也完成了,记得去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_ID和API_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
重新安装部署
之前安装部署过程的记录
本地部署过程
- fork项目到账号(isunkit),clone到本地,先看有没有Node.js环境(过程可以问AI),目前Mac mini已全局安装
- 在新的项目文件夹运行前要npm install(在Terminal安装比较好)
- 安装之后
npm run dev即可运行项目
- 如遇上无法连接到站点,可能是Notion被墙,需开TUN模式
修改项目内容
- 从.env.example复制一份文件重命名为
.env.local,修改里面的NOTION_PAGE_ID和 API_BASE_URL,并把文件加入.gitignore(可以把其它在Netlify的环境配置内容都填在这里,方便本地调试)
- 修改文件
blog.config.js(大部分能在Notion配置中心修改的都修改了)
- 主题选择
heo(其实这也是配置文件里面的,单独说一下)
- 修改themes-heo-
config.js
- 替换站点图标public-
favicon(直接替换文件即可)
- 替换顶栏右侧板块背景图public-
bg_image.jpg(直接替换文件即可)
- 增加手帐APP图标图片public-images-
heo(直接把图片拖进去即可)
- themes-heo-
style.js修改(修改部分标注了新增style by arale)
- styles-
global.css修改(修改部分标注了新增style by arale)
- 修改themes-heo-
index.js注释<Footer/>、<PostAdjacent {...props} />、<ShareBar post={post} />(修改部分标注了modified by arale)
- 全局搜索替换以下部分(要先11再12,不然12有的地方搜不到)
dark:hover:border-yellow👉🏻dark:hover:border-indigodark:hover:text-yellow👉🏻dark:hover:text-indigodark:group-hover:text-yellow👉🏻dark:group-hover:text-indigodark:bg-yellow👉🏻dark:bg-indigodark:hover:bg-yellow👉🏻dark:hover:bg-indigo
- 修改themes-heo-components文件夹下的:
Hero.js、:(修改部分标注了modified by arale)
- themes-heo-components文件夹内部替换:
top-10 left-10👉🏻top-6 left-5'text-4xl font-bold mb-3 dark:text-white’👉🏻'text-4xl font-bold mb-3 text-indigo-700''w-2/3 hidden xl:block’👉🏻'hidden xl:block’bg-[#4259efdd] dark:bg-[#dca846]👉🏻bg-[#df9283db] dark:bg-[#df9283db]'-ml-3 text-gray-300’👉🏻'-ml-3 text-white’today-card h-full bg-black👉🏻today-card h-full bg-whitetext-white p-10 items-end👉🏻text-indigo-700 p-10 items-endjustify-center rounded-3xl👉🏻justify-center bg-indigo-400 text-white rounded-3xlfadeInUp bg-[#4f65f0] dark:bg-indigo-600👉🏻fadeInUp bg-[#f9f3eb] dark:bg-[#424242]text-3xl font-extrabold mt-3👉🏻text-3xl text-indigo-700 font-extrabold mt-3dark:bg-indigo-500 dark:hover:bg-black👉🏻hover:text-indigo-700- 去掉
hover:text-black dark:hover:text-white(替换为空白) 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- Line91-95 👉🏻 Line956(修改部分标注了modified by arale)
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-950hover:bg-gray-50 dark:hover:bg-gray-900👉🏻hover:bg-indigo-50 dark:hover:bg-indigo-600hover:bg-black hover:bg-opacity-10👉🏻hover:text-white hover:bg-indigo-600cursor-pointer hover:bg-blue-600👉🏻cursor-pointer hover:bg-indigo-400- 顶部新增
import TagItemMini from './TagItemMini’ ${isDarkMode ? '#CA8A04' : '#0060e0'} inset;👉🏻${isDarkMode ? '#d68272': '#efc8c1'} inset;{`${isDarkMode ? 'bg-[#CA8A04]' : 'bg-[#0060e0]'}👉🏻{`${isDarkMode ? 'bg-[#d68272]' : 'bg-[#efc8c1]'}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-12bg-blue-500👉🏻bg-indigo-600hover:text-blue-500👉🏻hover:text-blue-600- 注释Line76-93;(修改部分标注了modified by arale)
<div className='flex justify-center '>👉🏻<div className='flex flex-col justify-center '>dark:text-gray-200 text-opacity-70👉🏻dark:text-white text-black- 注释Line108-113;(修改部分标注了modified by arale)
- 新增Line116-121;(修改部分标注了modified by arale)
'fa-regular fa-calendar’👉🏻'fa-regular fa-calendar mr-0.5’'fa-regular fa-calendar-check’👉🏻'fa-regular fa-calendar-check mr-0.5’'busuanzi_container_page_pv font-light mr-2’👉🏻'busuanzi_container_page_pv font-light pl-1 mr-2’'fa-solid fa-fire-flame-curved’👉🏻'fa-solid fa-fire-flame-curved mr-0.5’- 新增Line152-160;(修改部分标注了modified by arale)
- 更改嵌套关系 👉🏻 className='flex-col flex md:flex-row’后的</div>和className='pl-1 mr-2’后的</div>都移到</section>之前
- 去掉
hover:underline(替换为空白) - 注释Line59-62;(修改部分标注了modified by arale)
- 新增Line48-56;(修改部分标注了modified by arale)
- 注释Line37、Line64-70、Line76-86(修改部分标注了modified by arale)
dark:bg-[#ff953e]👉🏻dark:bg-[#1e1e1e] dark:hover:bg-[#df9283]bg-[#4f65f0] dark:bg-indigo-600 dark:border-gray-600👉🏻bg-[#f9f3eb] text-[#424242] dark:bg-[#424242] dark:text-whitecursor-pointer lg:p-6 p-4 border👉🏻cursor-pointer lg:p-6 p-4font-[1000] text-3xl👉🏻font-[1000] text-3xl text-indigo-700font-[1000] text-xl h-full👉🏻font-[1000] text-xl h-full text-gray-600 text-gray-600 dark:text-white
Hero.js:
InfoCard.js:
MenuItemCollapse.js:
MenuItemDrop.js:
PostHeader.js:
PostRecommend.js:
SideRight.js:
SlideOver.js:
TagItemMini.js:
直接按文件替换
TouchMeCard.js:
- lib-lang文件夹内部替换:
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,但这里需要显示为中文。
- components-
LoadingCover.js修改:
- styles/notion.css默认样式修改
字体颜色修改
可以修改Notion默认字体颜色和背景色。
品牌标准色使用:橙色,绿色,黄色,紫色。
下图为修改前后对比:


具体色号:文本为标准视觉的加深色;背景色则是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;
- Author:Noooter
- URL:https://noooter.netlify.app//article/31b7b2bc-1261-80f0-99b1-cf4bae2b53ec
- Copyright:如无特别声明,本文版权归©Noooter电子手帐所有, 采用 CC BY-NC-ND 4.0 许可协议,转载请附上原文出处链接和本声明。



