Merge branch 'main' into main

Author: lostiv

.github/FUNDING.yml

@@ -1,2 +1,3 @@
 # These are supported funding model platforms
 ko_fi: tangly1024
+buy_me_a_coffee: tangly1024

.nvmrc

@@ -1 +1 @@
-20.20.0
+20.18.0

DEPLOYMENT.md

@@ -8,11 +8,11 @@ NotionNext 支持多种部署方式，本指南将详细介绍各种部署选项
 
 ### 0. 本地统一基线（推荐）
 
-为提升跨平台兼容性（Vercel / Cloudflare Pages / Netlify），本项目建议统一使用以下最简流程：
+为提升跨平台兼容性（Vercel / Cloudflare Pages / Netlify / EdgeOne Pages 等），本项目建议统一使用以下最简流程：
 
 ```bash
-# Node 20
-nvm use || nvm install 20.20.0
+# Node 20（版本以仓库根目录 `.nvmrc` 为准，便于与各平台预装列表对齐）
+nvm use || nvm install
 
 # Yarn
 npm i -g yarn
@@ -195,6 +195,18 @@ netlify deploy --prod --dir=out
   status = 301
 ```
 
+## 腾讯云 EdgeOne Pages
+
+EdgeOne 构建阶段会按仓库中的 `.nvmrc` 切换 Node 版本。若控制台报错类似 **Failed to switch to Node.js x.y.z**，通常是因为平台上 **未提供该补丁版本**（例如仅有 `20.18.0`，而旧版本 `.nvmrc` 写了 `20.20.0`）。
+
+处理方式：
+
+1. **保持上游**：拉取最新 NotionNext，确认 `.nvmrc` 已与 EdgeOne「项目设置 → Node.js 版本」下拉列表中可选版本一致（一般为当前文件中的 `20.18.x`）。
+2. **自建仓库**：在 EdgeOne 控制台选择与 `.nvmrc` **完全一致**的 Node 版本；仍失败时检查构建日志是否仍在读取旧的 `.nvmrc`（需推送后再构建）。
+3. `package.json` 中 `engines.node` 为 `>=20 <25`，在 Node 20 系列内均可构建；关键是 **构建环境实际安装的版本**能解析 `.nvmrc`。
+
+构建命令与静态导出等与其它平台相同，按需配置环境变量（至少 `NOTION_PAGE_ID`）。
+
 ## Docker 部署
 
 ### Dockerfile

DEVELOPMENT.md

@@ -4,7 +4,7 @@
 
 ### 环境要求
 
-- Node.js = 20.20.0（使用 `.nvmrc` 保持一致）
+- Node.js 20 LTS（具体补丁版本以仓库根目录 `.nvmrc` 为准，与各托管平台预装 Node 对齐）
 - Yarn = 1.22.22（使用 `package.json#packageManager` 保持一致）
 - Git
 

README.md

@@ -40,7 +40,7 @@ Notion是一个能让效率暴涨的生产力引擎，可以帮你书写文档
 
 ```bash
 # 1) 使用 Node 20（建议先安装 nvm）
-nvm use || nvm install 20.20.0
+nvm use || nvm install
 
 # 2) 安装 Yarn（若未安装）
 npm i -g yarn

README_EN.md

@@ -39,7 +39,7 @@ A static blog system built with NextJS and Notion API, deployed on Vercel. Desig
 
 ```bash
 # 1) Use Node 20 (nvm recommended)
-nvm use || nvm install 20.20.0
+nvm use || nvm install
 
 # 2) Install Yarn if needed
 npm i -g yarn

__tests__/lib/utils/stripTransientUrlParams.test.js

@@ -0,0 +1,24 @@
+import {
+  stripTransientQueryParamsFromAsPath,
+  stripTransientQueryParamsFromUrl
+} from '@/lib/utils/stripTransientUrlParams'
+
+describe('stripTransientQueryParamsFromUrl', () => {
+  it('removes giscus and target from full URL', () => {
+    const u =
+      'https://blog.example.com/post/foo?giscus=abc&x=1&target=comment#h'
+    const out = stripTransientQueryParamsFromUrl(u)
+    expect(out).toBe('https://blog.example.com/post/foo?x=1#h')
+  })
+})
+
+describe('stripTransientQueryParamsFromAsPath', () => {
+  it('strips giscus from asPath', () => {
+    expect(stripTransientQueryParamsFromAsPath('/a/b?giscus=1')).toBe('/a/b')
+  })
+  it('preserves other query and hash', () => {
+    expect(
+      stripTransientQueryParamsFromAsPath('/p?k=1&giscus=x#c')
+    ).toBe('/p?k=1#c')
+  })
+})

components/Comment.js

@@ -1,6 +1,7 @@
 import Tabs from '@/components/Tabs'
 import { siteConfig } from '@/lib/config'
 import { isBrowser, isSearchEngineBot } from '@/lib/utils'
+import { stripTransientQueryParamsFromAsPath } from '@/lib/utils/stripTransientUrlParams'
 import dynamic from 'next/dynamic'
 import { useRouter } from 'next/router'
 import { useEffect, useRef, useState } from 'react'
@@ -49,19 +50,29 @@ const Comment = ({ frontMatter, className }) => {
     }
   }, [frontMatter])
 
-  // 当连接中有特殊参数时跳转到评论区
-  if (
-    isBrowser &&
-    ('giscus' in router.query || router.query.target === 'comment')
-  ) {
-    setTimeout(() => {
-      const url = router.asPath.replace('?target=comment', '')
-      history.replaceState({}, '', url)
-      document
-        ?.getElementById('comment')
-        ?.scrollIntoView({ block: 'start', behavior: 'smooth' })
-    }, 1000)
-  }
+  useEffect(() => {
+    if (!isBrowser || !router.isReady) {
+      return
+    }
+    const hasGiscus = 'giscus' in router.query
+    const scrollComment = router.query.target === 'comment'
+    if (!hasGiscus && !scrollComment) {
+      return
+    }
+    const cleanPath = stripTransientQueryParamsFromAsPath(router.asPath)
+    window.history.replaceState(window.history.state, '', cleanPath)
+    router
+      .replace(cleanPath, undefined, { scroll: false, shallow: true })
+      .catch(() => {})
+    if (scrollComment || hasGiscus) {
+      const t = window.setTimeout(() => {
+        document
+          ?.getElementById('comment')
+          ?.scrollIntoView({ block: 'start', behavior: 'smooth' })
+      }, 400)
+      return () => window.clearTimeout(t)
+    }
+  }, [router.isReady, router.asPath, router.query])
 
   if (!frontMatter) {
     return null

components/Giscus.js

@@ -1,6 +1,8 @@
 import { siteConfig } from '@/lib/config'
 import { useGlobal } from '@/lib/global'
 import { loadExternalResource } from '@/lib/utils'
+import { stripTransientQueryParamsFromAsPath } from '@/lib/utils/stripTransientUrlParams'
+import Router from 'next/router'
 import { useEffect } from 'react'
 // import Giscus from '@giscus/react'
 
@@ -15,12 +17,30 @@ const GiscusComponent = () => {
   const { isDarkMode } = useGlobal()
   const theme = isDarkMode ? 'dark' : 'light'
   useEffect(() => {
+    const syncGiscusQueryOutOfUrl = () => {
+      if (typeof window === 'undefined') {
+        return
+      }
+      const full = `${window.location.pathname}${window.location.search}${window.location.hash}`
+      const clean = stripTransientQueryParamsFromAsPath(full)
+      if (clean === full) {
+        return
+      }
+      window.history.replaceState(window.history.state, '', clean)
+      Router.replace(clean, undefined, { scroll: false, shallow: true }).catch(() => {})
+    }
+
     loadExternalResource('/js/giscus.js', 'js').then(() => {
       if (window?.Giscus?.init) {
         window?.Giscus?.init('#giscus')
       }
+      syncGiscusQueryOutOfUrl()
     })
+
+    const onRouteDone = () => syncGiscusQueryOutOfUrl()
+    Router.events.on('routeChangeComplete', onRouteDone)
     return () => {
+      Router.events.off('routeChangeComplete', onRouteDone)
       window?.Giscus?.destroy()
     }
   }, [isDarkMode])

components/NotionPage.js

@@ -104,22 +104,6 @@ const NotionPage = ({ post, className }) => {
         })
       })
     }
-
-    // 查找所有具有 'notion-collection-page-properties' 类的元素,删除notion自带的页面properties
-    const timer = setTimeout(() => {
-      // 查找所有具有 'notion-collection-page-properties' 类的元素
-      const elements = document.querySelectorAll(
-        '.notion-collection-page-properties'
-      )
-
-      // 遍历这些元素并将其从 DOM 中移除
-      elements?.forEach(element => {
-        element?.remove()
-      })
-    }, 1000) // 1000 毫秒 = 1 秒
-
-    // 清理定时器，防止组件卸载时执行
-    return () => clearTimeout(timer)
   }, [post])
 
   // const cleanBlockMap = cleanBlocksWithWarn(post?.blockMap);
@@ -261,7 +245,7 @@ const Equation = dynamic(
       await import('@/lib/plugins/mhchem')
       return m.Equation
     }),
-  { ssr: false }
+  { ssr: true }
 )
 
 // 原版文档