-
-
-
- 
@@ -34,6 +54,8 @@ Notion是一个能让效率暴涨的生产力引擎，可以帮你书写文档
一个使用 NextJS + Notion API 实现的，部署在 Vercel 上的静态博客系统。为Notion和所有创作者设计。
+**仓库托管：** 主仓库现由 GitHub 组织 **[notionnext-org](https://github.com/notionnext-org)** 维护（canonical：`https://github.com/notionnext-org/NotionNext`）。欢迎参与贡献并关注组织内协作说明；若在转让前已克隆本地仓库，建议执行 `git remote set-url origin https://github.com/notionnext-org/NotionNext.git` 后使用 `git remote -v` 确认。
+
支持多种部署方案
## 新开发者 3 分钟上手
@@ -69,6 +91,8 @@ yarn dev
- [Theme Migration Guide (English)](./docs/THEME_MIGRATION_GUIDE.md)
- [贡献入口（中文）](./CONTRIBUTING.zh-CN.md)
- [贡献入口（英文）](./CONTRIBUTING.md)
+- [维护与变更尺度（中文）](./docs/MAINTENANCE_PHILOSOPHY.zh-CN.md)
+- [Maintenance & change control (English)](./docs/MAINTENANCE_PHILOSOPHY.en.md)
## 预览效果
@@ -90,7 +114,7 @@ yarn dev
致敬每一位开发者！
-[](https://github.com/tangly1024/NotionNext/graphs/contributors)
+[](https://github.com/notionnext-org/NotionNext/graphs/contributors)
## 引用技术
@@ -110,4 +134,4 @@ The MIT License.
## Star History
-[](https://star-history.com/#tangly1024/NotionNext&Date)
+[](https://star-history.com/#notionnext-org/NotionNext&Date)
diff --git a/README_EN.md b/README_EN.md
index d4b84d98059..88c51f57e20 100644
--- a/README_EN.md
+++ b/README_EN.md
@@ -13,14 +13,14 @@ You can set up your personal website in just a few minutes. Here is the link to
# NotionNext
@@ -34,6 +34,8 @@ You can set up your personal website in just a few minutes. Here is the link to
A static blog system built with NextJS and Notion API, deployed on Vercel. Designed for Notion and all creators.
+**Repository hosting:** The main repository is maintained by the GitHub organization **[notionnext-org](https://github.com/notionnext-org)** (canonical: `https://github.com/notionnext-org/NotionNext`). Contributions are welcome; see the org page for collaboration. If you cloned before the transfer, run `git remote set-url origin https://github.com/notionnext-org/NotionNext.git` and verify with `git remote -v`.
+
## 3-Minute Quick Start
@@ -67,6 +69,8 @@ To help new contributors get started quickly, the project keeps docs bilingual w
- [Theme Migration Guide (English)](./docs/THEME_MIGRATION_GUIDE.md)
- [贡献入口（中文）](./CONTRIBUTING.zh-CN.md)
- [Contribution Guide (English)](./CONTRIBUTING.md)
+- [维护与变更尺度（中文）](./docs/MAINTENANCE_PHILOSOPHY.zh-CN.md)
+- [Maintenance & change control (English)](./docs/MAINTENANCE_PHILOSOPHY.en.md)
## Preview
@@ -88,7 +92,7 @@ Special thanks to Craig Hart for initiating the Nobelium project.
This project exists thanks to all the people who contribute.
-[](https://github.com/tangly1024/NotionNext/graphs/contributors)
+[](https://github.com/notionnext-org/NotionNext/graphs/contributors)
## Technologies Used
diff --git a/__tests__/lib/staticPaths.test.js b/__tests__/lib/staticPaths.test.js
index d891b44d7d8..d08dd1d3cc1 100644
--- a/__tests__/lib/staticPaths.test.js
+++ b/__tests__/lib/staticPaths.test.js
@@ -46,6 +46,32 @@ describe('staticPaths build helpers', () => {
})
})
+ it('does not keep a rejected allPages lookup pinned in process memory', async () => {
+ isExport.mockReturnValue(false)
+ fetchGlobalAllData
+ .mockRejectedValueOnce(new Error('notion unavailable'))
+ .mockResolvedValueOnce({
+ allPages: [
+ { id: '1', slug: 'hello', type: 'Post', status: 'Published' }
+ ]
+ })
+ getPriorityPages.mockReturnValue([])
+
+ await jest.isolateModulesAsync(async () => {
+ const { getSharedAllPages } = require('@/lib/build/staticPaths')
+
+ await expect(getSharedAllPages({ from: 'slug-paths' })).rejects.toThrow(
+ 'notion unavailable'
+ )
+ await expect(getSharedAllPages({ from: 'slug-paths' })).resolves.toEqual([
+ { id: '1', slug: 'hello', type: 'Post', status: 'Published' }
+ ])
+
+ expect(fetchGlobalAllData).toHaveBeenCalledTimes(2)
+ expect(getOrSetDataWithCache).toHaveBeenCalledTimes(2)
+ })
+ })
+
it('prefetches once per route call in export mode and returns all matching paths', async () => {
isExport.mockReturnValue(true)
fetchGlobalAllData.mockResolvedValue({
diff --git a/docs/MAINTENANCE_PHILOSOPHY.en.md b/docs/MAINTENANCE_PHILOSOPHY.en.md
new file mode 100644
index 00000000000..277c47d5e48
--- /dev/null
+++ b/docs/MAINTENANCE_PHILOSOPHY.en.md
@@ -0,0 +1,51 @@
+# Maintenance and change-control philosophy
+
+This document is for **core maintainers and frequent contributors**. Read it together with [Contributing](../CONTRIBUTING.md) and [Contribution workflow](./CONTRIBUTION_WORKFLOW.en.md). The goal is to welcome contributions while **reducing large, hard-to-control changes** that destabilize `main` and fork ecosystems.
+
+## Principles
+
+1. **Small, reviewable, revertible steps**: Prefer several focused PRs over one huge, hard-to-review batch.
+2. **Intent before code**: For behavior or data-contract changes, align scope in an Issue or Discussion before opening the PR.
+3. **Protect core paths**: Data layer, routing, global config, and build/export pipelines affect the whole project—PRs should explain motivation, risk, and how they were verified.
+4. **No unrelated refactors mixed in**: Do not bundle wide renames, mass formatting, or major dependency bumps with unrelated fixes or features; split PRs when needed.
+5. **Dependencies and toolchain**: Major framework or lockfile-policy upgrades need rationale, breaking-change notes, and regression checks (build, critical-path tests).
+
+## Suggested PR sizing
+
+| Kind | Suggested approach |
+| --- | --- |
+| Bugfix | Minimal fix + tests or clear repro notes |
+| Small feature / theme-local | Keep within theme or a single module boundary; avoid drive-by shared-layer edits |
+| Cross-theme / shared API | Agree API and defaults in an Issue first; keep migrations documented |
+| Breaking changes | Document version/config migration; split into phases if it helps reviewers |
+
+## High-impact areas (extra clarity expected)
+
+Changes here tend to affect all sites or many themes—**PR descriptions and verification notes should be stronger** (whether two-person review is required is up to owners and maintainers):
+
+- `lib/db/` (including `SiteDataApi`, Notion fetch and caching)
+- `pages/` SSG/ISR, i18n, and build-lifecycle logic
+- `next.config.js` and export/build scripts
+- Global config (`blog.config.js`, `lib/config.js`, and similar defaults)
+- Security-sensitive areas: auth, secrets, third-party callbacks, CSP, etc.
+
+## Keeping the project from drifting
+
+- **Prefer opt-in or configurable behavior** for niche site assumptions; avoid baking them into global defaults.
+- **Theme isolation**: Keep theme-specific logic under `themes/
-
-
- {post.title}
-
+ className='flex h-40 cursor-pointer overflow-hidden rounded-lg'>
+
+ {/* 背景图：略放大 + 轻模糊，弱化细节 */}
+
+
-
-
+
+
+ {post.title}
+