edgepress 2026.10.1 → 2026.10.13

package/content/pages/privacy-policy/en.md

@@ -1,93 +0,0 @@
----
-title: Privacy policy
-lang: en
-slug: privacy-policy
-description: How this site handles request data, consent choices, optional analytics, data rights, and supplier disclosures.
-blocks:
-  - columns: 1
-    cells:
-      -
-        - type: section
-          title: Controller and contact
-          tone: soft
-          blocks:
-            - type: privacy-controller
-              nameLabel: Controller
-              contactLabel: Privacy contact
-              missingTitle: Publication setup required
-              missingText: Add the responsible person's or organization's real name and a working privacy contact in config.yml before publishing.
-            - type: text
-              text: Confirm that the configured name identifies the responsible person or legal entity. Add a postal address, EU representative, or data protection officer contact here when applicable to the operator.
-  - columns: 2
-    cells:
-      -
-        - type: section
-          title: Site requests and legal bases
-          blocks:
-            - type: text
-              paragraphs:
-                - This site publishes pages and posts and provides client-side search. It has no visitor accounts, comments, or contact form in this build.
-                - To deliver and protect the site, the hosting and network providers receive request data such as IP address, requested path, request time, and browser or device headers. Where GDPR applies, the operator relies on legitimate interests in serving a secure and reliable site (Article 6(1)(f)); the operator must document the balancing assessment and confirm actual hosting logs and retention in the deployment account.
-                - Optional browser services listed below load only after an affirmative choice. Where their processing includes personal data and consent is the chosen legal basis, it is based on consent (Article 6(1)(a)). Refusing optional services does not prevent access to the site's basic pages.
-      -
-        - type: section
-          title: Optional browser services
-          blocks:
-            - type: text
-              text: This list is generated from enabled services in config.yml. It identifies each purpose, data category, recipient, retention period, and the supplier's own privacy information.
-            - type: privacy-services
-              emptyText: No optional third-party browser services are configured.
-  - columns: 1
-    cells:
-      -
-        - type: section
-          title: Cloudflare Web Analytics
-          blocks:
-            - type: text
-              paragraphs:
-                - When accepted, the Cloudflare beacon reports page-view and browser performance metrics. Its published dimensions include page path, referrer, device, browser, operating system, and country. Cloudflare says its beacon receives the source IP as part of the HTTP request, discards it at the nearest data center, and does not store it in its core databases or logs; Cloudflare also says the beacon does not use browser storage.
-                - Cloudflare states that unsampled beacon data is retained for 7 days and then aggregated to about 10% for longer-term storage; dashboard history is available for 6 months. The beacon may be processed in a different country or region from the visitor. The operator must check the actual Cloudflare account, plan, and applicable data processing terms before publication.
-  - columns: 2
-    cells:
-      -
-        - type: section
-          title: Consent, retention, and transfers
-          tone: accent
-          blocks:
-            - type: text
-              paragraphs:
-                - The privacy choice is saved in the visitor's browser on that device for the configured period. This site does not send the choice to the operator or keep a server-side receipt. A visitor can reopen Privacy settings to change or withdraw it; withdrawal stops an active integration after the page reloads. If the operator relies on consent to process personal data, the operator must ensure it can demonstrate consent as required by GDPR Article 7.
-                - Hosting and security log retention depends on the deployed provider account and is not set by this source configuration. Cloudflare's data processing addendum describes transfer safeguards, including standard contractual clauses for restricted transfers; the operator must confirm the applicable agreement and safeguards for this deployment.
-            - type: privacy-consent
-              storageLabel: Saved on
-              expiryLabel: Preference expiry
-              proposedDateLabel: Notice proposed
-              effectiveDateLabel: Notice effective
-              expiryText: "{days} days after saving"
-      -
-        - type: section
-          title: Your rights
-          blocks:
-            - type: text
-              paragraphs:
-                - Where GDPR applies, you may request access, rectification, erasure, restriction, or object to processing. You may request data portability where the legal conditions apply, and withdraw consent at any time without affecting processing that was lawful before withdrawal.
-                - Contact the controller using the details above to exercise a right or ask a question. You may also complain to the competent data protection supervisory authority, including in the EU country where you live, work, or believe an infringement occurred.
-                - This site does not configure solely automated decisions that produce legal or similarly significant effects. The operator should update this notice if that changes or if the site adds accounts, forms, or other data uses.
-  - columns: 1
-    cells:
-      -
-        - type: section
-          title: Legal reference
-          blocks:
-            - type: link-list
-              title: Official documents
-              items:
-                - label: General Data Protection Regulation (EUR-Lex)
-                  url: https://eur-lex.europa.eu/eli/reg/2016/679/oj/eng
-                - label: Cloudflare RUM beacon privacy details
-                  url: https://developers.cloudflare.com/speed/observatory/rum-beacon/
-                - label: Cloudflare Web Analytics retention and FAQ
-                  url: https://developers.cloudflare.com/web-analytics/faq/
-                - label: Cloudflare Data Processing Addendum
-                  url: https://www.cloudflare.com/cloudflare-customer-dpa/
----

package/content/pages/privacy-policy/zh-cn.md

@@ -1,93 +0,0 @@
----
-title: 隐私政策
-lang: zh-CN
-slug: privacy-policy
-description: 说明本网站如何处理请求数据、同意偏好、可选统计服务、个人权利和供应商信息。
-blocks:
-  - columns: 1
-    cells:
-      -
-        - type: section
-          title: 个人信息处理者与联系
-          tone: soft
-          blocks:
-            - type: privacy-controller
-              nameLabel: 处理者
-              contactLabel: 隐私联系
-              missingTitle: 发布前需要补充信息
-              missingText: 正式发布前，请在 config.yml 中填写负责个人或组织的真实名称和有效隐私联系方式。
-            - type: text
-              text: 请确认上方名称能识别负责的个人或法律实体。若运营者情形适用，还应在本政策中补充邮寄地址、欧盟代表或数据保护官的联系方式。
-  - columns: 2
-    cells:
-      -
-        - type: section
-          title: 网站请求与处理依据
-          blocks:
-            - type: text
-              paragraphs:
-                - 本网站发布页面和文章，并提供在访客浏览器中运行的站内搜索。本构建版本没有访客账户、评论或联系表单。
-                - 为传送和保护网站，托管及网络服务商会收到请求数据，例如 IP 地址、请求路径、请求时间以及浏览器或设备请求头。在 GDPR 适用时，运营者以提供安全、可靠网站服务的合法利益为依据（第 6 条第 1 款 (f) 项）；运营者应记录利益衡量，并在部署账户中确认实际日志内容与保留期限。
-                - 下方列出的可选浏览器服务只有在访客主动选择后才加载。若相关处理涉及个人数据且以同意为法律依据，则依据第 6 条第 1 款 (a) 项处理。拒绝可选服务不会阻止访问网站基本页面。
-      -
-        - type: section
-          title: 可选浏览器服务
-          blocks:
-            - type: text
-              text: 此列表根据 config.yml 中启用的服务生成，列明处理目的、数据类别、接收方、保留期限及供应商自己的隐私说明。
-            - type: privacy-services
-              emptyText: 当前没有配置可选的第三方浏览器服务。
-  - columns: 1
-    cells:
-      -
-        - type: section
-          title: Cloudflare 网站分析
-          blocks:
-            - type: text
-              paragraphs:
-                - 访客接受后，Cloudflare 信标会报告页面浏览和浏览器性能指标。Cloudflare 公布的报告维度包括页面路径、来源页、设备、浏览器、操作系统和国家或地区。Cloudflare 表示，信标会在正常 HTTP 请求中接收来源 IP，在最近的数据中心丢弃该 IP，且不会将其保存到核心数据库或日志中；Cloudflare 也表示该信标不会使用浏览器存储。
-                - Cloudflare 表示未采样信标数据保留 7 天，之后汇总为约 10% 的长期数据；仪表板可查看最近 6 个月的数据。信标可能在访客所在国家或地区以外处理。发布前，运营者应核实实际 Cloudflare 账户、套餐和适用的数据处理条款。
-  - columns: 2
-    cells:
-      -
-        - type: section
-          title: 同意、保留期限与跨境传输
-          tone: accent
-          blocks:
-            - type: text
-              paragraphs:
-                - 隐私选择保存在访客当前设备的浏览器中，并遵循所配置的期限。本网站不会将这项选择发送给运营者，也不会在服务器保存回执。访客可重新打开“隐私设置”修改或撤回选择；撤回后，页面重新载入以停止已启用的集成。若运营者依赖同意处理个人数据，必须确保能够按照 GDPR 第 7 条证明已取得同意。
-                - 托管和安全日志的保留期取决于部署服务商账户，本源配置没有设置该期限。Cloudflare 数据处理附录说明了受限传输的保障机制，包括标准合同条款；运营者应核实本部署适用的协议和保障措施。
-            - type: privacy-consent
-              storageLabel: 保存位置
-              expiryLabel: 偏好有效期
-              proposedDateLabel: 告知拟定日期
-              effectiveDateLabel: 告知生效日期
-              expiryText: 保存后 {days} 天
-      -
-        - type: section
-          title: 你的权利
-          blocks:
-            - type: text
-              paragraphs:
-                - GDPR 适用时，你可以请求访问、更正、删除或限制处理，也可以在适用条件下反对处理。满足法律条件时，你可以请求数据可携；你也可以随时撤回同意，撤回不影响撤回前基于同意进行的合法处理。
-                - 如需行使权利或提出问题，请使用上方的处理者联系方式。你也可以向有管辖权的数据保护监管机构投诉，包括你居住或工作的欧盟国家，或你认为发生违规的国家。
-                - 本网站当前未配置会产生法律影响或类似重大影响的纯自动化决策。如果此情况改变，或网站新增账户、表单等数据用途，运营者应更新本告知。
-  - columns: 1
-    cells:
-      -
-        - type: section
-          title: 法律与供应商资料
-          blocks:
-            - type: link-list
-              title: 官方资料
-              items:
-                - label: 欧盟《通用数据保护条例》（EUR-Lex）
-                  url: https://eur-lex.europa.eu/eli/reg/2016/679/oj/eng
-                - label: Cloudflare RUM 信标隐私说明
-                  url: https://developers.cloudflare.com/speed/observatory/rum-beacon/
-                - label: Cloudflare 网站分析保留期限与常见问题
-                  url: https://developers.cloudflare.com/web-analytics/faq/
-                - label: Cloudflare 数据处理附录
-                  url: https://www.cloudflare.com/cloudflare-customer-dpa/
----

package/content/pages/project-introduction/en.md

@@ -1,88 +0,0 @@
----
-title: Project introduction
-lang: en
-slug: project-introduction
-description: EdgePress architecture, release policy, feature maturity, and supported runtime baseline.
-blocks:
-  - columns: 1
-    cells:
-      -
-        - type: hero
-          eyebrow: Project overview
-          title: A static site builder with editable pages and Markdown articles.
-          text: EdgePress separates content, presentation, trusted build-time plugins, and Worker request handling so each part has a clear place to change.
-  - columns: 1
-    cells:
-      -
-        - type: feature-grid
-          title: Project boundaries
-          items:
-            - title: Pages
-              text: Each localized page stores its ordered row layout, column count, element types, and element content in Markdown front matter.
-            - title: Posts
-              text: Each article is a Markdown document rendered with the built-in sanitizing pipeline.
-            - title: Themes
-              text: HTML layouts, shared partials, and hard-coded CSS palettes control site presentation.
-  - columns: 1
-    cells:
-      -
-        - type: section
-          title: Supported baseline
-          tone: soft
-          blocks:
-            - type: data-table
-              title: Runtime and capability status for this release
-              headers:
-                - Area
-                - Baseline
-                - Status
-              rows:
-                - - Build CLI
-                  - Node.js 22.12 or newer
-                  - Stable
-                - - Worker runtime
-                  - Module Worker with Request, Response, and Web APIs
-                  - Stable
-                - - Static publishing
-                  - Workers Static Assets through Wrangler
-                  - Stable
-                - - Node.js APIs in Worker
-                  - Not required by src/worker.js
-                  - Stable
-                - - Plugin API
-                  - Major version 1
-                  - Experimental
-                - - Page block builder
-                  - Ordered rows, 1 to 4 columns, validated elements
-                  - Experimental
-                - - Backend forwarding
-                  - Optional Service Binding or URL plus Worker token
-                  - Experimental
-            - type: text
-              text: The compatibility manifest is project-compatibility.json. The Worker compatibility date is pinned in wrangler.jsonc. Static page delivery does not require nodejs_compat.
-  - columns: 1
-    cells:
-      -
-        - type: section
-          title: Release and feature lifecycle
-          blocks:
-            - type: data-table
-              title: Feature stages
-              headers:
-                - Stage
-                - Meaning
-              rows:
-                - - Experimental
-                  - Usable, with configuration or behavior that may change in a minor release.
-                - - Stable
-                  - Follows semantic versioning; breaking changes require a major release.
-                - - Deprecated
-                  - Remains available for at least two minor releases and is removed in a major release, except for urgent security issues.
-                - - Removed
-                  - No longer shipped; the compatibility manifest records the removal release.
-            - type: text
-              paragraphs:
-                - "Monthly releases use the year.month.request format. This release is 2026.9.10: the tenth requested release update for September 2026."
-                - Ship a minor release when the monthly review is ready, and use patch releases for defects, security fixes, and dependency updates. Support the previous major release with security fixes for 12 months after a new major line begins.
-                - Before a release, update project-compatibility.json and this feature matrix together. Run edgepress doctor to review the local Node.js version, Worker entry, and configured compatibility date.
----

package/content/pages/project-introduction/zh-cn.md

@@ -1,88 +0,0 @@
----
-title: 项目介绍
-lang: zh-CN
-slug: project-introduction
-description: EdgePress 的架构、发布政策、功能成熟度和支持的运行环境基线。
-blocks:
-  - columns: 1
-    cells:
-      -
-        - type: hero
-          eyebrow: 项目概览
-          title: 页面可编辑、文章用 Markdown 的静态网站构建器。
-          text: EdgePress 将内容、展示、可信构建插件和 Worker 请求处理分开放置，让每个部分都有清晰的修改位置。
-  - columns: 1
-    cells:
-      -
-        - type: feature-grid
-          title: 项目边界
-          items:
-            - title: Pages 页面
-              text: 每个本地化页面都在 Markdown 前置数据中保存有序行布局、栏数、元素类型和元素内容。
-            - title: Posts 文章
-              text: 每篇文章都是 Markdown 文档，并由内置安全渲染流程输出。
-            - title: Themes 主题
-              text: HTML 布局、共享局部模板和主题内硬编码的 CSS 配色负责网站展示。
-  - columns: 1
-    cells:
-      -
-        - type: section
-          title: 支持基线
-          tone: soft
-          blocks:
-            - type: data-table
-              title: 本版本的运行环境与功能状态
-              headers:
-                - 范围
-                - 基线
-                - 状态
-              rows:
-                - - 构建命令行
-                  - Node.js 22.12 或更新版本
-                  - 稳定
-                - - Worker 运行环境
-                  - 使用 Request、Response 和 Web API 的 Module Worker
-                  - 稳定
-                - - 静态发布
-                  - 通过 Wrangler 发布 Workers Static Assets
-                  - 稳定
-                - - Worker 中的 Node.js API
-                  - src/worker.js 不需要 Node.js API
-                  - 稳定
-                - - 插件 API
-                  - 主版本 1
-                  - 实验性
-                - - 页面元素构建器
-                  - 有序行、1 至 4 栏、经过验证的元素
-                  - 实验性
-                - - 后端转发
-                  - 可选 Service Binding 或 URL 加 Worker 密钥
-                  - 实验性
-            - type: text
-              text: 兼容性清单位于 project-compatibility.json。Worker 兼容日期固定在 wrangler.jsonc 中。静态页面服务不需要 nodejs_compat。
-  - columns: 1
-    cells:
-      -
-        - type: section
-          title: 发布与功能生命周期
-          blocks:
-            - type: data-table
-              title: 功能阶段
-              headers:
-                - 阶段
-                - 含义
-              rows:
-                - - 实验性
-                  - 可以使用，但配置或行为可能在次版本发布时调整。
-                - - 稳定
-                  - 遵循语义化版本；破坏性变更需要主版本更新。
-                - - 弃用
-                  - 通常至少保留两个次版本后再于主版本移除，紧急安全问题除外。
-                - - 移除
-                  - 不再随项目发布；兼容性清单记录移除版本。
-            - type: text
-              paragraphs:
-                - 月度版本使用“年.月.请求序号”格式。本次版本为 2026.9.10，即 2026 年 9 月针对本次需求的第十次更新。
-                - 月度审核就绪后发布次版本；缺陷、安全修复和依赖更新使用修订版本。新主版本发布后，前一主版本继续获得 12 个月的安全修复支持。
-                - 发布前应同步更新 project-compatibility.json 和此功能清单。运行 edgepress doctor 可检查本机 Node.js 版本、Worker 入口和兼容日期。
----

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

@@ -1,153 +0,0 @@
----
-title: Quick start
-lang: en
-slug: quick-start
-description: Install EdgePress, create Markdown posts, edit page elements, build the site, and preview it locally.
-blocks:
-  - columns: 1
-    cells:
-      -
-        - type: hero
-          eyebrow: Start here
-          title: Set up the project and open the live preview.
-          text: Use the edgepress command after installing project dependencies. Local preview rebuilds changed source files and refreshes the PDF accessibility and agent-friendliness report.
-  - columns: 1
-    cells:
-      -
-        - type: section
-          title: Requirements and first commands
-          tone: soft
-          blocks:
-            - type: data-table
-              title: Supported baseline
-              headers:
-                - Requirement
-                - Minimum
-              rows:
-                - - Node.js
-                  - "22.12"
-                - - npm
-                  - Current supported release
-                - - Cloudflare account
-                  - Only needed to deploy
-            - type: code
-              title: Install dependencies and run EdgePress
-              language: sh
-              code: |
-                npm ci
-                edgepress build
-                edgepress server
-  - columns: 2
-    cells:
-      -
-        - type: section
-          title: Create content
-          blocks:
-            - type: steps
-              items:
-                - title: Create an article
-                  text: Posts use Markdown and are written in content/posts/<post-id>/en.md or a localized file such as zh-cn.md.
-                  command: edgepress new "A project update"
-                - title: Create a page folder
-                  text: Add content/pages/<page-id>/en.md. Each configured locale gets its own lowercase locale filename.
-                - title: Set the language
-                  text: Match the front matter lang value to the filename and enable optional locales in edgepress.config.mjs.
-      -
-        - type: section
-          title: Edit a page layout
-          blocks:
-            - type: text
-              paragraphs:
-                - Pages have no Markdown article body. Put the page layout in the blocks front matter of each localized page file.
-                - At the top of each row, choose columns from 1 to 4. Add one cells entry for each column. Inside a cell, add an element type, then its content fields.
-                - Supported content elements include hero, section, text, heading, display-text, media-text, links, lists, steps, code, tables, notices, latest-posts, and configured privacy or integration widgets.
-            - type: notice
-              title: Accessibility for video
-              text: A media-text video element requires a captions WebVTT file, a language code, a track label, and an accessible media label. Use locally hosted files when possible.
-              tone: info
-  - columns: 1
-    cells:
-      -
-        - type: section
-          title: Configure and preview
-          blocks:
-            - type: text
-              paragraphs:
-                - Edit site title, description, canonical URL, agent SEO, site navigation, footer text, and privacy controller details in config.yml. Theme colors live in theme CSS.
-                - Change the selected theme with edgepress theme list and edgepress theme use <theme-name>. Theme paths are stored in edgepress.config.mjs.
-                - Install a theme package with edgepress theme install <npm-package> or start with a blank theme using edgepress theme create <name>.
-                - edgepress server starts a local Wrangler server, watches source files, rebuilds changed pages, reloads the browser, and refreshes tools/page-check.pdf. Screenshots are embedded in the PDF and temporary files are removed after generation.
-            - type: code
-              title: Build, inspect, and deploy
-              language: sh
-              code: |
-                edgepress check
-                edgepress doctor
-                edgepress deploy
-            - type: text
-              text: Compatibility checks read the Node.js baseline, Worker entry, and compatibility date from project-compatibility.json and wrangler.jsonc. Review the PDF report before deploying.
-            - type: section
-              title: Publish the source on GitHub
-              blocks:
-                - type: text
-                  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
-                  language: sh
-                  code: |
-                    git init
-                    git add .
-                    git commit -m "Initial EdgePress site"
-                    git branch -M main
-                    git remote add origin https://github.com/<owner>/<repository>.git
-                    git push -u origin main
-                - type: text
-                  text: For a local deployment, authenticate with npx wrangler login, then run edgepress deploy. The command generates dist/ and deploys the Worker using wrangler.jsonc.
-                - type: link-list
-                  title: Deployment references
-                  items:
-                    - label: Connect or reauthorize the GitHub integration
-                      url: https://developers.cloudflare.com/workers/ci-cd/builds/git-integration/github-integration/
-                    - label: Configure Workers Builds commands
-                      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:
-                - type: text
-                  paragraphs:
-                    - edgepress build and edgepress generate use the same generator and write the static site to dist/. Run edgepress generate, then upload the contents of dist/ to the server's document root. Do not upload the dist/ directory as a nested folder unless that is the URL path you want.
-                    - OpenResty uses Nginx configuration syntax for static files. Set root to the uploaded directory; try_files checks the exact path, directory index, and .html route. The generated 403.html and 404.html files can be used for error responses.
-                - type: code
-                  title: Minimal Nginx or OpenResty site
-                  language: nginx
-                  code: |
-                    server {
-                      listen 80;
-                      server_name example.org;
-                      root /var/www/edgepress;
-                      index index.html;
-
-                      location / {
-                        try_files $uri $uri/ $uri.html =404;
-                      }
-
-                      error_page 403 /403.html;
-                      error_page 404 /404.html;
-                    }
-                - type: code
-                  title: Generate the upload directory
-                  language: sh
-                  code: edgepress generate
-                - type: notice
-                  title: Worker-only integrations
-                  text: Static hosting does not run src/worker.js. The built-in /api/ proxy and Cloudflare service bindings require an EdgePress Worker deployment; otherwise configure an equivalent server-side route on your host. Keep backend tokens out of browser settings.
-                  tone: warning
----