edgepress 2026.9.4 → 2026.9.5

package/README.md

@@ -2,7 +2,7 @@
 
 [![Deploy to Cloudflare](https://deploy.workers.cloudflare.com/button)](https://deploy.workers.cloudflare.com/?url=https://github.com/jsw-teams/edgepress)
 
-The button deploys this repository's demo site to your Cloudflare account. To create a new site, follow the npm quick start below.
+The button creates a copy of this repository in your GitHub account and a new Worker in your Cloudflare account. It is for creating a separate site, not updating an existing one. Choose unused destination repository and Worker names during setup. If `edgepress` already exists, choose a different name such as `my-edgepress-site`; to update an existing deployment, use that repository's connected Workers Builds integration instead of clicking the button again.
 
 EdgePress builds static websites for Cloudflare Workers. Write posts in Markdown, compose pages from editable rows and elements, choose a shared theme, and build the site into dist/.
 
@@ -67,4 +67,4 @@ The header search page filters Markdown posts from the generated local search in
 
 Project guides are published from content/pages/: project introduction, quick start, theme development, plugin development, and privacy policy. The privacy policy intentionally reports that the starter site still needs a real site URL, operator name, and privacy contact before publication.
 
-Version 2026.9.4 records the fourth requested release update for September 2026. It is available as the `edgepress` npm package. See the [request 1 notes](content/posts/2026-09-24-edgepress-release-2026-9-1/), [request 2 notes](content/posts/2026-09-25-edgepress-release-2026-9-2/), [request 3 notes](content/posts/2026-09-25-edgepress-release-2026-9-3/), and [request 4 notes](content/posts/2026-09-25-edgepress-release-2026-9-4/).
+Version 2026.9.5 records the fifth requested release update for September 2026. It is available as the `edgepress` npm package. See the [request 1 notes](content/posts/2026-09-24-edgepress-release-2026-9-1/), [request 2 notes](content/posts/2026-09-25-edgepress-release-2026-9-2/), [request 3 notes](content/posts/2026-09-25-edgepress-release-2026-9-3/), [request 4 notes](content/posts/2026-09-25-edgepress-release-2026-9-4/), and [request 5 notes](content/posts/2026-09-25-edgepress-release-2026-9-5/).

package/content/pages/quick-start/en.md

@@ -93,6 +93,7 @@ blocks:
                   paragraphs:
                     - Create an empty repository on GitHub, then push the EdgePress source. In the Cloudflare dashboard, create a Worker and connect that repository with Workers Builds. Choose main as the production branch. Set a unique Worker name in wrangler.jsonc before deployment.
                     - For this repository, set Workers Builds root directory to /, build command to npm run build, and deploy command to npx wrangler deploy. No build variables are required. The build command generates dist/ before Wrangler publishes the Worker; dist/ stays out of Git.
+                    - The Deploy to Cloudflare button in the GitHub README creates a new GitHub repository copy and a new Worker. During setup, choose unused names for both. If a repository or Worker named edgepress already exists, choose a different name. To update an existing Worker, use its existing repository and Workers Builds connection; the button does not attach to or update an existing project.
                     - If the log remains at Initializing build environment before cloning the repository or running commands, verify that the Cloudflare Workers and Pages GitHub App still has access to this repository. Reconnect the repository or reinstall and reauthorize the app, then retry. Check that the selected Cloudflare API token is still valid; Workers Builds can create a token automatically, and stale tokens must be replaced in Build settings. This stage runs before the project build command.
                 - type: code
                   title: Upload the source repository
@@ -115,6 +116,8 @@ blocks:
                       url: https://developers.cloudflare.com/workers/ci-cd/builds/configuration/
                     - label: Troubleshoot Workers Builds
                       url: https://developers.cloudflare.com/workers/ci-cd/builds/troubleshoot/
+                    - label: Deploy button behavior and setup
+                      url: https://developers.cloudflare.com/workers/platform/deploy-buttons/
             - type: section
               title: Generate files for OpenResty or Nginx
               blocks:

package/content/pages/quick-start/zh-cn.md

@@ -93,6 +93,7 @@ blocks:
                   paragraphs:
                     - 在 GitHub 创建空仓库并推送 EdgePress 源代码。然后在 Cloudflare 控制台创建 Worker，并通过 Workers Builds 连接该仓库，选择 main 作为生产分支。部署前请在 wrangler.jsonc 中设置唯一的 Worker 名称。
                     - 此仓库的 Workers Builds 设置为：根目录 /、构建命令 npm run build、部署命令 npx wrangler deploy。无需添加构建变量。构建命令会先生成 dist/，再由 Wrangler 发布 Worker；dist/ 不会提交到 Git。
+                    - GitHub README 中的一键部署按钮会在你的 GitHub 账户创建一份新仓库副本，并在 Cloudflare 创建一个新 Worker。设置时请为目标仓库和 Worker 选择未占用的名称。如果 `edgepress` 已存在，请改用其他名称。要更新已有 Worker，请继续使用它已连接的仓库和 Workers Builds；按钮不会连接或更新已有项目。
                     - 如果日志在克隆仓库或运行命令前一直停留在 Initializing build environment，请检查 Cloudflare Workers and Pages GitHub App 是否仍有此仓库的访问权限。重新连接仓库，或重新安装并授权该 App 后再试。还需确认所选 Cloudflare API Token 仍有效；Workers Builds 可以自动创建 Token，如果已选 Token 失效，需要在 Build 设置中替换。此阶段尚未运行项目构建命令。
                 - type: code
                   title: 推送源代码仓库
@@ -115,6 +116,8 @@ blocks:
                       url: https://developers.cloudflare.com/workers/ci-cd/builds/configuration/
                     - label: 排查 Workers Builds
                       url: https://developers.cloudflare.com/workers/ci-cd/builds/troubleshoot/
+                    - label: 一键部署按钮的工作方式
+                      url: https://developers.cloudflare.com/workers/platform/deploy-buttons/
             - type: section
               title: 为 OpenResty 或 Nginx 生成静态文件
               blocks:

package/content/posts/2026-09-25-edgepress-release-2026-9-5/en.md

@@ -0,0 +1,17 @@
+---
+title: "EdgePress September 2026 update: request 5"
+date: 2026-09-25
+lang: en
+slug: edgepress-release-2026-9-5
+tags:
+  - release
+  - cloudflare
+---
+
+This is the fifth requested EdgePress update for September 2026.
+
+## Clarify Cloudflare one-click deployment
+
+The README and bilingual quick-start guides now explain that Cloudflare's Deploy button creates a new GitHub repository copy and a new Worker. Choose unused names for both during setup. The button does not connect to or update an existing Worker; use the existing repository's Workers Builds connection to publish updates.
+
+The release notes and project compatibility history are updated as version `2026.9.5`.

package/content/posts/2026-09-25-edgepress-release-2026-9-5/zh-cn.md

@@ -0,0 +1,17 @@
+---
+title: EdgePress 2026 年 9 月更新：第 5 次需求
+date: 2026-09-25
+lang: zh-CN
+slug: edgepress-release-2026-9-5
+tags:
+  - 发布
+  - Cloudflare
+---
+
+这是 EdgePress 在 2026 年 9 月针对第 5 次需求的更新。
+
+## 说明 Cloudflare 一键部署的行为
+
+README 和中英文快速入门现已说明，Cloudflare 一键部署按钮会创建新的 GitHub 仓库副本和新的 Worker。设置时需要为两者选择未占用的名称。按钮不会连接或更新已有 Worker；更新已有项目应使用原仓库连接的 Workers Builds。
+
+发布说明和项目兼容性历史已更新至 `2026.9.5`。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "edgepress",
-  "version": "2026.9.4",
+  "version": "2026.9.5",
   "description": "A static website builder for Cloudflare Workers with editable pages, Markdown posts, local search, themes, and consent-gated integrations.",
   "type": "module",
   "bin": {

package/project-compatibility.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "frameworkVersion": "2026.9.4",
+  "frameworkVersion": "2026.9.5",
   "requirements": {
     "nodeMajor": 22,
     "nodeMinimumVersion": "22.12.0",
@@ -24,7 +24,8 @@
     { "name": "Markdown syntax verification and responsive post screenshots", "stage": "experimental", "since": "2026.9.2" },
     { "name": "Compact localized language selector", "stage": "experimental", "since": "2026.9.2" },
     { "name": "npm theme installation and blank theme scaffolds", "stage": "experimental", "since": "2026.9.3" },
-    { "name": "PDF-only audit output and temporary screenshot capture", "stage": "experimental", "since": "2026.9.4" }
+    { "name": "PDF-only audit output and temporary screenshot capture", "stage": "experimental", "since": "2026.9.4" },
+    { "name": "Cloudflare one-click deployment guidance for existing and new projects", "stage": "stable", "since": "2026.9.5" }
   ],
   "releaseHistory": [
     {
@@ -50,6 +51,12 @@
       "date": "2026-09-25",
       "request": 4,
       "notes": "Keep audit output as a single accessible PDF with embedded screenshots, remove the templates directory and package archive, document Workers Builds initialization troubleshooting, and pin the Wrangler compatibility date to the first of the month."
+    },
+    {
+      "version": "2026.9.5",
+      "date": "2026-09-25",
+      "request": 5,
+      "notes": "Clarify that the Cloudflare one-click deployment button creates a new repository copy and Worker, explain unique naming and the path for updating existing Workers, and publish the guidance in README and bilingual quick-start pages."
     }
   ]
 }