edgepress 2026.9.3

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

@@ -0,0 +1,73 @@
+---
+title: 隐私政策
+lang: zh-CN
+slug: privacy-policy
+description: 本 EdgePress 网站当前的数据处理方式、同意管理、已配置集成和发布前信息。
+blocks:
+  - columns: 1
+    cells:
+      -
+        - type: section
+          title: 网站运营者
+          tone: soft
+          blocks:
+            - type: privacy-controller
+              nameLabel: 个人信息处理者
+              contactLabel: 隐私联系
+              missingTitle: 发布前需要补充信息
+              missingText: 当前 config.yml 尚未填写真实运营者名称和隐私联系方式，site.url 仍为 example.com。正式发布前请替换这些值。
+  - columns: 2
+    cells:
+      -
+        - type: section
+          title: 此起始站点当前的功能
+          blocks:
+            - type: text
+              paragraphs:
+                - 此源项目生成公开页面、文章、搜索数据、站点地图和 Atom 订阅。它不包含访客账户系统、评论功能或联系表单。
+                - Worker 提供可选的 /api/v1/ 后端代理。只有部署者配置 Service Binding，或同时设置 BACKEND_URL 和 BACKEND_TOKEN 密钥后，代理才会转发请求。此起始站点不会将页面内容提交到该接口。
+                - 托管和内容分发服务商可能为运行网站而处理连接和请求数据。运营者应在发布前确认实际服务商，说明适用条款和数据保留期限。
+      -
+        - type: section
+          title: 可选浏览器服务
+          blocks:
+            - type: text
+              text: 当前配置的跟踪、统计、广告和人机验证服务列表均为空。运营者添加服务后，下方列表会根据所配置的供应商、用途和保留期限自动生成。
+            - type: privacy-services
+              emptyText: 此源项目当前没有配置可选的第三方浏览器服务。
+  - columns: 1
+    cells:
+      -
+        - type: section
+          title: 同意偏好
+          tone: accent
+          blocks:
+            - type: text
+              paragraphs:
+                - 浏览器集成只有在访客接受已配置服务后才会加载。存在可保存的选择时，同意界面会将第一方偏好存储在本地浏览器中；它不是服务器端审计日志。
+                - 访客可以重新打开“隐私设置”更改选择。撤回之前已启用的服务后，页面会重新载入，以停止该集成继续运行。
+            - type: privacy-consent
+              storageLabel: 浏览器存储键
+              expiryLabel: 偏好过期时间
+              versionLabel: 同意配置版本
+              expiryText: "保存后 {days} 天"
+  - columns: 1
+    cells:
+      -
+        - type: section
+          title: 供应商与法律信息
+          blocks:
+            - type: text
+              paragraphs:
+                - 启用供应商前，运营者应记录供应商接收的信息、处理目的、接收方、适用保留期限和跨境传输情况。浏览器配置中只能填写公开站点标识；CAPTCHA 密钥必须保存在可信服务器中，并由服务器验证每个响应令牌。
+                - 此起始配置无法确定实际部署的运营者所在地、法律依据、数据保留义务或适用的个人权利。请根据实际网站完成政策，必要时咨询合格的专业人员。
+            - type: link-list
+              title: 主要法律资料
+              items:
+                - label: EUR-Lex GDPR 正文
+                  url: https://eur-lex.europa.eu/eli/reg/2016/679
+                - label: 英国 ICO 隐私告知指引
+                  url: https://ico.org.uk/for-organisations/advice-for-small-organisations/getting-started-with-gdpr/data-protection-self-assessment/what-information-you-must-supply-under-the-gdpr/
+                - label: 中国个人信息保护法
+                  url: https://www.miit.gov.cn/jgsj/zfs/fl/art/2022/art_515a4b20c12f430eab54bb4f56d89f56.html
+---

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

@@ -0,0 +1,88 @@
+---
+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.1: the first 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

@@ -0,0 +1,88 @@
+---
+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.1，即 2026 年 9 月针对本次需求的第一次更新。
+                - 月度审核就绪后发布次版本；缺陷、安全修复和依赖更新使用修订版本。新主版本发布后，前一主版本继续获得 12 个月的安全修复支持。
+                - 发布前应同步更新 project-compatibility.json 和此功能清单。运行 edgepress doctor 可检查本机 Node.js 版本、Worker 入口和兼容日期。
+---

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

@@ -0,0 +1,147 @@
+---
+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 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 rewrites tools/page-check.md and tools/page-check.json.
+            - 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. Check the generated 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.
+                    - The build and deploy scripts in package.json are detected by Workers Builds. It runs npm run build to generate dist/, then npm run deploy to publish the Worker. dist/ stays out of Git. Cloudflare manages the build authorization for this connection.
+                - 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 GitHub to Cloudflare Workers Builds
+                      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/
+            - 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
+---

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

@@ -0,0 +1,147 @@
+---
+title: 快速入门
+lang: zh-CN
+slug: quick-start
+description: 安装 EdgePress、创建 Markdown 文章、编辑页面元素、本地构建并打开实时预览。
+blocks:
+  - columns: 1
+    cells:
+      -
+        - type: hero
+          eyebrow: 从这里开始
+          title: 配置项目并打开实时预览。
+          text: 安装项目依赖后使用 edgepress 命令。本地预览会在源文件变更后自动构建，并刷新无障碍化和 agent 友好度报告。
+  - columns: 1
+    cells:
+      -
+        - type: section
+          title: 环境要求与初始命令
+          tone: soft
+          blocks:
+            - type: data-table
+              title: 支持基线
+              headers:
+                - 要求
+                - 最低版本
+              rows:
+                - - Node.js
+                  - "22.12"
+                - - npm
+                  - 当前受支持版本
+                - - Cloudflare 账户
+                  - 仅部署时需要
+            - type: code
+              title: 安装依赖并运行 EdgePress
+              language: sh
+              code: |
+                npm ci
+                edgepress build
+                edgepress server
+  - columns: 2
+    cells:
+      -
+        - type: section
+          title: 创建内容
+          blocks:
+            - type: steps
+              items:
+                - title: 创建文章
+                  text: 文章使用 Markdown，保存在 content/posts/<post-id>/en.md 或 zh-cn.md 等本地化文件中。
+                  command: edgepress new "A project update"
+                - title: 创建页面目录
+                  text: 新建 content/pages/<page-id>/en.md。每种已配置语言都有一个小写语言文件名。
+                - title: 设置语言
+                  text: front matter 的 lang 值需与文件名匹配；在 edgepress.config.mjs 中启用可选语言。
+      -
+        - type: section
+          title: 编辑页面布局
+          blocks:
+            - type: text
+              paragraphs:
+                - 页面没有 Markdown 文章正文。请将布局写在每个本地化页面文件的 blocks 前置数据中。
+                - 每行先选择 1 至 4 栏，并为每栏添加一个 cells 项。然后在栏内选择元素类型，再填写该元素的内容字段。
+                - 可用元素包括 hero、section、text、heading、display-text、media-text、链接、列表、步骤、代码、表格、提示、最新文章，以及已配置的隐私或集成组件。
+            - type: notice
+              title: 视频无障碍要求
+              text: media-text 视频元素需要 WebVTT 字幕文件、语言代码、字幕轨道名称和可访问的媒体描述。尽量使用本地托管的视频文件。
+              tone: info
+  - columns: 1
+    cells:
+      -
+        - type: section
+          title: 配置与预览
+          blocks:
+            - type: text
+              paragraphs:
+                - 在 config.yml 中编辑站点标题、简介、规范 URL、agent SEO、导航、页脚文字和隐私运营者信息。主题配色保存在各自主题的 CSS 中。
+                - 使用 edgepress theme list 查看主题，使用 edgepress theme use <主题名称> 切换主题。主题路径保存在 edgepress.config.mjs 中。
+                - 使用 edgepress theme install <npm-package> 安装主题包，或使用 edgepress theme create <名称> 创建空白主题。
+                - edgepress server 会启动本地 Wrangler 服务、监视源文件、重新构建变更页面、刷新浏览器，并更新 tools/page-check.md 和 tools/page-check.json。
+            - type: code
+              title: 构建、检查和部署
+              language: sh
+              code: |
+                edgepress check
+                edgepress doctor
+                edgepress deploy
+            - type: text
+              text: 兼容性检查会读取 project-compatibility.json 和 wrangler.jsonc 中的 Node.js 基线、Worker 入口和兼容日期。部署前请查看生成的报告。
+            - type: section
+              title: 将源代码上传到 GitHub
+              blocks:
+                - type: text
+                  paragraphs:
+                    - 在 GitHub 创建空仓库并推送 EdgePress 源代码。然后在 Cloudflare 控制台创建 Worker，并通过 Workers Builds 连接该仓库，选择 main 作为生产分支。部署前请在 wrangler.jsonc 中设置唯一的 Worker 名称。
+                    - Workers Builds 会读取 package.json 中的 build 和 deploy 脚本，先运行 npm run build 生成 dist/，再运行 npm run deploy 发布 Worker。dist/ 不会提交到 Git；Cloudflare 会管理此连接的构建授权。
+                - type: code
+                  title: 推送源代码仓库
+                  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: 本地部署时，先运行 npx wrangler login 完成 Cloudflare 身份验证，再运行 edgepress deploy。该命令会生成 dist/，并依据 wrangler.jsonc 部署 Worker。
+                - type: link-list
+                  title: 部署参考
+                  items:
+                    - label: 将 GitHub 连接到 Cloudflare Workers Builds
+                      url: https://developers.cloudflare.com/workers/ci-cd/builds/git-integration/github-integration/
+                    - label: 配置 Workers Builds 命令
+                      url: https://developers.cloudflare.com/workers/ci-cd/builds/configuration/
+            - type: section
+              title: 为 OpenResty 或 Nginx 生成静态文件
+              blocks:
+                - type: text
+                  paragraphs:
+                    - edgepress build 和 edgepress generate 使用同一个生成流程，将静态网站写入 dist/。运行 edgepress generate 后，把 dist/ 目录内的文件上传到服务器网站根目录。如果不希望网址多出一层目录，不要把 dist/ 本身作为嵌套目录上传。
+                    - OpenResty 使用 Nginx 配置语法托管静态文件。将 root 指向已上传的目录；try_files 会依次检查原始路径、目录首页和 .html 路由。生成的 403.html 与 404.html 可用于错误响应。
+                - type: code
+                  title: Nginx 或 OpenResty 基础站点配置
+                  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: 生成上传目录
+                  language: sh
+                  code: edgepress generate
+                - type: notice
+                  title: 仅 Worker 支持的集成
+                  text: 静态托管不会运行 src/worker.js。内置 /api/ 代理和 Cloudflare Service Binding 需要部署 EdgePress Worker；否则需在当前服务器配置等效的服务端路由。不要把后端 Token 写入浏览器设置。
+                  tone: warning
+---

package/content/pages/theme-development/en.md

@@ -0,0 +1,106 @@
+---
+title: Theme development
+lang: en
+slug: theme-development
+description: Build EdgePress themes with shared HTML partials, CSS palettes, element layouts, and reusable error pages.
+blocks:
+  - columns: 1
+    cells:
+      -
+        - type: hero
+          eyebrow: Theme guide
+          title: Let themes own shared layout and visual design.
+          text: Pages define row widths, element types, and content. Themes define the site shell, typography, spacing, colors, and responsive behavior.
+  - columns: 2
+    cells:
+      -
+        - type: section
+          title: Theme structure
+          tone: soft
+          blocks:
+            - type: code
+              title: Theme files
+              language: text
+              code: |
+                themes/your-theme/
+                  theme.json
+                  package.json
+                  README.md
+                  layouts/
+                    layout.html
+                    partials/
+                      head.html
+                      header.html
+                      footer.html
+                  assets/
+                    style.css
+            - type: text
+              paragraphs:
+                - The shared layout renders every page and post. The head, header, and footer partials provide common site components. Configure the page-title suffix and separator, site title, shared navigation, language links, footer text, and component visibility in config.yml.
+                - Use double-brace placeholders for escaped values. The approved raw placeholders are generated page content, JSON-LD, and EdgePress-generated navigation markup. Keep the skip link, one main landmark, labeled navigation, visible focus, and one page-level h1.
+                - Keep the body as a full-height vertical layout and let main grow so the footer stays at the bottom on short pages.
+      -
+        - type: section
+          title: Choose a theme palette
+          tone: soft
+          blocks:
+            - type: text
+              paragraphs:
+                - Keep colors, font choices, and component styling in the selected theme stylesheet. Do not put color values in config.yml. The site content stays the same when a theme changes.
+                - List the available themes with edgepress theme list. Select one with edgepress theme use default, edgepress theme use atelier, or edgepress theme use signal.
+                - Install a published theme with edgepress theme install <npm-package>[@version]. The package must include theme.json and layouts/layout.html. EdgePress copies it into themes/ and does not run npm install scripts.
+                - Start a custom theme with edgepress theme create my-theme. This creates an npm-ready package manifest, a blank stylesheet, and accessible layout, head, header, navigation, and footer files. Edit the files, then select it with edgepress theme use my-theme. Publish from that directory with npm publish --access public.
+            - type: notice
+              title: Shared error layouts
+              text: EdgePress generates localized 403 and 404 pages through the selected theme layout. The Worker serves the matching 403 page when static asset access is denied.
+              tone: info
+  - columns: 1
+    cells:
+      -
+        - type: section
+          title: Page rows and editable elements
+          blocks:
+            - type: text
+              paragraphs:
+                - Each page and locale is a Markdown file, but the page body after front matter must stay empty. The editor data lives in its blocks YAML.
+                - "Order the data from the outside inward: set each row's columns count first, provide one cells entry per column, select an element type inside a cell, then edit that element's fields. The validator rejects mismatched column counts and empty cells."
+                - Pages do not use the post Markdown renderer. Posts remain Markdown articles and use the built-in sanitizing renderer.
+            - type: data-table
+              title: Available element families
+              headers:
+                - Element
+                - Main purpose
+              rows:
+                - - hero, section, text, heading
+                  - Page structure and written content
+                - - display-text
+                  - Large editorial, serif, outline, mono, or accent typography
+                - - media-text
+                  - Image or captioned video paired with editable text
+                - - link-list, list, steps, code, data-table, notice
+                  - Navigation, instructions, code samples, facts, and callouts
+                - - feature-grid, quote, cta, faq, latest-posts
+                  - Reusable page composition
+                - - privacy-services, privacy-controller, privacy-consent, captcha, ad-slot
+                  - Configuration-backed site integrations
+            - type: notice
+              title: Video captions
+              text: media-text video entries require a WebVTT captions source, language tag, and track label. Videos use native controls and preload none. A third-party video embed should remain behind an explicit consent integration.
+              tone: warning
+  - columns: 1
+    cells:
+      -
+        - type: section
+          title: Develop and preview
+          blocks:
+            - type: steps
+              items:
+                - title: Select a theme
+                  text: Install or create a theme, then use the EdgePress theme command to change paths.theme in edgepress.config.mjs.
+                  command: edgepress theme use your-theme
+                - title: Edit layout and CSS
+                  text: Change the selected theme layout, partials, and stylesheet. Each CSS and JavaScript asset receives a content fingerprint during build.
+                - title: Preview the site
+                  text: The server watches source files, rebuilds the output, refreshes the browser, and updates the accessibility and agent-friendliness report.
+                  command: edgepress server
+---