Skip to content

88lin/NotionNext

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6,138 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

基于 NotionNext Heo 主题的深度定制增强版

🎨 极致 UI 质感 | ⚡ 秒级加载体验 | 🔍 SEO 深度重构 | 🤖 AI 智能摘要

本项目打破模板化局限,聚焦个人博客的精致感高性能。通过全量重构核心组件、注入全局自定义 CSS、优化资源加载策略及完善 SEO 架构,打造一款更美观、更快速、更具辨识度的 Notion 驱动博客。


✨ 核心特性 (Core Features)

🎨 视觉美学:全量重构与质感升级

不仅仅是换肤,而是对交互逻辑与视觉体系的全面焕新。

  • 专属配色体系:摒弃默认靛蓝,定制暖橙 + 湖蓝双主色体系,全量覆盖标签、按钮、链接及表单元素,统一视觉风格。
  • 核心组件重写:深度重构导航、文章卡片、页脚、代码高亮 (PrismMac) 等 20+ 核心模块,适配精致博客定位。
  • 🤖 AI 文章摘要:新增 AISummar.js 专属组件,提炼文章核心观点,大幅提升阅读效率。
  • Tailwind 扩展:扩展自定义配置规则,实现像素级的样式控制。

💎 全局交互:非侵入式 CSS 增强

通过全局注入 custom.css,在不修改主题源码的前提下,实现电影级的交互动效:

  • 沉浸式页脚:新增多色渐变流动动画 (16s 缓动),搭配玻璃态光泽与立体阴影,打造极具质感的底部体验。
  • 液态玻璃按钮:重构全站按钮,采用多色渐变光效 + 悬停上浮 + 点击缩放反馈,兼具美感与无障碍优化。
  • 定制化光标与滚动条
    • 双状态专属鼠标指针(普通/悬停),强化品牌辨识度。
    • 45°斜纹光影滚动条,兼顾美观与操作手感。
  • 玻璃态加载进度条:深度美化 pace.js,采用毛玻璃效果 + 四色渐变流动,消除等待焦虑。
  • 阅读体验优化
    • 文章内链新增渐变下划线与背景高亮动效。
    • 搜索框聚焦外发光过渡,提升交互反馈感。
  • 性能友好动效:针对 prefers-reduced-motion 设备自动禁用冗余动画,利用 will-change 优化渲染性能,拒绝卡顿。

⚡ 性能飞跃:极速加载与资源调度

每一毫秒的提升,只为更流畅的阅读体验。

  • 静态资源 CDN 化:AOS 等库迁移至稳定 CDN,剔除本地冗余,显著减小项目体积。
  • 并行加载策略:重构评论与动画组件,由串行改为 Promise.all 并行加载,大幅提升首屏速度 (FCP)。
  • 感知性能优化
    • 集成 instant.page 链接预加载,实现页面“秒开”。
    • 重写 LazyImageLenis 平滑滚动组件,平衡流畅度与性能损耗。
  • 智能缓存机制:页面缓存周期从 60 秒延长至 30 天,大幅降低 Vercel 服务端消耗,提升复访速度。
  • 项目瘦身:彻底清理无用文档、废弃脚本及广告配置,保持代码库纯净。

🔍 SEO 架构:搜索引擎友好重构

让优质内容更容易被世界发现。

  • SEO 核心重构:全量重写 SEO.js,优化元标签、结构化数据 (Schema.org) 及 OG 标签生成逻辑。
  • 自动化站点地图:内置 sitemap.xml 自动生成,无缝对接搜索引擎爬虫。
  • 精准关键词策略:预设覆盖技术、资源、工具等维度的关键词矩阵,提升收录权重。
  • 动态元数据:针对不同页面类型(文章、分类、标签)动态生成 Title 与 Description,提升排名潜力。

🛠️ 工程化与配置优化

  • Vercel 深度调优:重构 vercel.json,新增 82 行 部署规则,优化缓存策略、路由重写及资源压缩,提升稳定性。
  • Next.js 构建优化:完善 next.config.js 构建逻辑,提升打包效率与渲染性能。
  • 依赖管理:更新 package.json,移除冗余包,引入必要新依赖,确保安全性与功能性。

⚙️ 配置指南

本项目保持与上游 NotionNext 的高度兼容性,同时新增了丰富的个性化配置项。

配置文件 说明
blog.config.js 核心配置:兼容上游文档,新增项已注释说明。
public/css/custom.css 视觉定制:全局样式与动效入口。无需修改源码,已引入CDN链接提高加载速度。
vercel.json 部署规则:已预置优化后的缓存与路由规则,一般无需修改。

📦 部署与使用

本项目完全兼容上游的所有部署流程(Vercel / Docker / 本地部署等)。


⚠️ 特别说明

这是一个高度个性化的定制版本 (Opinionated Fork)。

  • 兼容性说明:由于进行了深度精简和重构,部分原版 NotionNext 的 Heo 主题的功能可能已被移除或修改。如果你发现某些功能缺失,那很可能是因为我个人并未使用到该功能。
  • 适用人群:适合追求极致视觉体验、且具备一定动手能力(能自行解决配置冲突)的用户。
  • 反馈与交流
    • 如果你发现了 Bug,欢迎提交 Issue。
    • 如果你觉得某些样式与你的内容不契合,也欢迎提出建议。
    • 注:对于“恢复被移除功能”类的请求,可能不会立即采纳,但欢迎 PR 共同讨论。

如果这个项目对你有帮助,欢迎给个 Star ⭐️!


帮助教程

访问帮助:NotionNext帮助手册

本项目教程为免费、公开资源,仅限个人学习使用,禁止利用本教程建立的博客发布非法内容、进行违法犯罪活动。严禁任何个人或组织将本教程用于商业用途,包括但不限于直接售卖、间接收费、或其他变相盈利行为。转载、复制或介绍本教程内容时,须保留作者信息并明确注明来源。 本项目仅提供由作者团队授权的付费咨询服务,请注意辨别,谨防诈骗行为。任何未经授权的收费服务均可能存在法律风险。

Notion是一个能让效率暴涨的生产力引擎,可以帮你书写文档、管理笔记,搭建知识库,甚至可以为你规划项目、时间管理、组织团队、提高生产力、还有当前最强大的AI技术加持。

若希望进一步探索Notion的功能,欢迎购买《Notion笔记从入门到精通进阶课程

若希望获得稳定、高速、不限设备数量的VPN科学上网服务,欢迎使用飞鸟VPN,这是我目前在用的VPN,仅作友情推广

NotionNext

中文文档 | README in English


一个使用 NextJS + Notion API 实现的,部署在 Vercel 上的静态博客系统。为Notion和所有创作者设计。

支持多种部署方案

预览效果

在线演示:https://preview.tangly1024.com/ ,点击左下角挂件可以切换主题,没找到喜欢的主题?贡献一个吧~

Next Medium Hexo Fukasawa
预览NEXT 预览MEDIUM 预览HEXO 预览FUKASAWA

致谢

感谢Craig Hart发起的Nobelium项目

Craig Hart
Craig Hart

贡献者

致敬每一位开发者!

Contributors

引用技术

🔗 友情链接

  • Elog Markdown 批量导出工具、开放式跨平台博客解决方案,随意组合写作平台(语雀/Notion/FlowUs/飞书)和博客平台(Hexo/Vitepress/Halo/Confluence/WordPress等)

License

The MIT License.

Star History

Star History Chart

About

基于NotionNext的Heo主题进行二次开发,旨在打破模板化限制,打造极致的阅读体验。聚焦极致UI质感、SEO优化与加载速度提升。按个人喜好精简重构,打造精致博客体验。

Topics

Resources

License

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • JavaScript 96.7%
  • CSS 1.9%
  • Other 1.4%