edgepress 2026.10.1 → 2026.10.13

package/content/pages/home/en.json

@@ -0,0 +1,248 @@
+{
+  "$schema": "../../../schemas/pages.schema.json",
+  "title": "EdgePress website builder",
+  "lang": "en",
+  "slug": "home",
+  "homepage": true,
+  "description": "Build static websites with Markdown, editable pages and consent-controlled services on five hosting platforms.",
+  "keywords": [
+    "website builder",
+    "Cloudflare Workers",
+    "page elements",
+    "website plugins"
+  ],
+  "blocks": [
+    {
+      "columns": 1,
+      "cells": [
+        [
+          {
+            "type": "hero",
+            "eyebrow": "A project built for the edge",
+            "title": "Build a fast website from clear, editable source files.",
+            "text": "EdgePress turns Markdown articles, page layouts, themes and optional services into static websites for Cloudflare, Vercel, Netlify, Tencent EdgeOne Pages and Alibaba Cloud ESA Pages.",
+            "mascotSrc": "/edgepress/brand/home-hero.png",
+            "mascotAlt": "A giant panda and Taiwanese black bear standing together with friendly smiles; the bear has a clear pale V chest marking.",
+            "mascotWidth": 1536,
+            "mascotHeight": 1024,
+            "mascotSizes": "(max-width: 620px) calc(100vw - 64px), 320px",
+            "mascotWebpSrcset": [
+              {
+                "src": "/edgepress/brand/home-hero-768.webp",
+                "width": 768
+              },
+              {
+                "src": "/edgepress/brand/home-hero.webp",
+                "width": 1536
+              }
+            ],
+            "cta": {
+              "label": "Start with the quick guide",
+              "url": "/quick-start/"
+            },
+            "highlights": [
+              "Editable pages in localized JSON files",
+              "Articles written in Markdown",
+              "Shared layouts and theme-defined palettes"
+            ]
+          }
+        ]
+      ]
+    },
+    {
+      "columns": 1,
+      "cells": [
+        [
+          {
+            "type": "feature-grid",
+            "title": "A clear place for each part of a site",
+            "items": [
+              {
+                "title": "Pages use editable elements",
+                "icon": "layout-grid",
+                "text": "Set the number of columns first, then choose elements and edit their content in each page file.",
+                "url": "/theme-development/"
+              },
+              {
+                "title": "Posts use Markdown",
+                "icon": "file-text",
+                "text": "Write long-form articles in Markdown and let the built-in renderer sanitize and format them.",
+                "url": "/project-introduction/"
+              },
+              {
+                "title": "Themes own the design",
+                "icon": "palette",
+                "text": "Build layouts with HTML partials and keep each theme's color palette in its stylesheet.",
+                "url": "/theme-development/"
+              },
+              {
+                "title": "Integrations wait for consent",
+                "icon": "shield-check",
+                "text": "Add tracking, statistics, advertising, or CAPTCHA services with provider details in configuration.",
+                "url": "/plugin-development/"
+              }
+            ]
+          }
+        ]
+      ]
+    },
+    {
+      "columns": 2,
+      "cells": [
+        [
+          {
+            "type": "section",
+            "title": "Learn the project",
+            "tone": "soft",
+            "blocks": [
+              {
+                "type": "text",
+                "paragraphs": [
+                  "Start with the project introduction and quick start. The guides cover the feature lifecycle, supported runtimes, and the recommended publishing workflow."
+                ]
+              },
+              {
+                "type": "link-list",
+                "title": "Project guides",
+                "items": [
+                  {
+                    "label": "Project introduction",
+                    "url": "/project-introduction/"
+                  },
+                  {
+                    "label": "Quick start",
+                    "url": "/quick-start/"
+                  }
+                ]
+              }
+            ]
+          }
+        ],
+        [
+          {
+            "type": "section",
+            "title": "Extend the project",
+            "tone": "soft",
+            "blocks": [
+              {
+                "type": "text",
+                "paragraphs": [
+                  "Use theme partials for shared head metadata, navigation, footer, and error-page layout. Page-specific rows and element content stay in localized page files.",
+                  "Build plugins run in Node. Browser services wait for explicit consent before requesting vendor code."
+                ]
+              },
+              {
+                "type": "link-list",
+                "title": "Development guides",
+                "items": [
+                  {
+                    "label": "Theme development",
+                    "url": "/theme-development/"
+                  },
+                  {
+                    "label": "Plugin development",
+                    "url": "/plugin-development/"
+                  }
+                ]
+              }
+            ]
+          }
+        ]
+      ]
+    },
+    {
+      "columns": 1,
+      "cells": [
+        [
+          {
+            "type": "latest-posts",
+            "title": "Latest project updates",
+            "count": 3,
+            "paginate": true
+          }
+        ]
+      ]
+    },
+    {
+      "columns": 1,
+      "cells": [
+        [
+          {
+            "type": "media-text",
+            "mediaType": "image",
+            "src": "/images/previews/edgepress-en.webp",
+            "alt": "Actual local EdgePress website preview.",
+            "caption": "Interface preview captured locally.",
+            "placement": "left",
+            "title": "See what your source becomes",
+            "text": "Posts, navigation, search and language routes publish together. Choose a theme and keep everyday writing in Markdown."
+          }
+        ]
+      ]
+    },
+    {
+      "columns": 1,
+      "cells": [
+        [
+          {
+            "type": "data-table",
+            "title": "Free hosting priority (2026-10-04)",
+            "headers": [
+              "Priority",
+              "Platform",
+              "Allowance and conditions"
+            ],
+            "rows": [
+              [
+                "1",
+                "Cloudflare",
+                "Unlimited static requests; 3,000 build minutes/month."
+              ],
+              [
+                "2",
+                "Tencent EdgeOne Pages",
+                "Currently unlimited website traffic/requests; 500 builds/month. Free-phase limits may change."
+              ],
+              [
+                "3",
+                "Vercel Hobby",
+                "100 GB/month and 1 million CDN requests; personal non-commercial use."
+              ],
+              [
+                "4",
+                "Netlify Free",
+                "300 shared credits/month. A deploy costs 15; traffic 20/GB; requests 2/10,000. Pauses when exhausted."
+              ],
+              [
+                "Verify",
+                "Alibaba Cloud ESA Pages",
+                "Traffic uses the site package. Confirm its quota; 100,000/day functions is not static bandwidth."
+              ]
+            ]
+          }
+        ]
+      ]
+    },
+    {
+      "columns": 1,
+      "cells": [
+        [
+          {
+            "type": "link-list",
+            "title": "Deployment and quota sources",
+            "items": [
+              {
+                "label": "Chinese guide",
+                "url": "https://github.com/jsw-teams/edgepress/blob/main/content/guides/zh-cn.md"
+              },
+              {
+                "label": "Official quota sources",
+                "url": "https://github.com/jsw-teams/edgepress/blob/main/content/guides/platforms.md"
+              }
+            ]
+          }
+        ]
+      ]
+    }
+  ]
+}

package/content/pages/home/zh-cn.json

@@ -0,0 +1,248 @@
+{
+  "$schema": "../../../schemas/pages.schema.json",
+  "title": "写文建站 网站构建器",
+  "lang": "zh-CN",
+  "slug": "home",
+  "homepage": true,
+  "description": "使用 Markdown、可编辑页面与按需服务，将静态网站部署到五个平台。",
+  "keywords": [
+    "网站构建器",
+    "Cloudflare Workers",
+    "页面元素",
+    "网站插件"
+  ],
+  "blocks": [
+    {
+      "columns": 1,
+      "cells": [
+        [
+          {
+            "type": "hero",
+            "eyebrow": "为边缘网络构建",
+            "title": "用清晰、可编辑的源文件构建快速网站。",
+            "text": "写文建站将 Markdown 文章、页面布局、主题与可选服务构建为静态网站，支持 Cloudflare、Vercel、Netlify、腾讯 EdgeOne Pages 和阿里云 ESA Pages。",
+            "mascotSrc": "/edgepress/brand/home-hero.png",
+            "mascotAlt": "大熊猫与台湾黑熊友好并肩站立，黑熊胸前的浅色 V 形胸斑清晰可见。",
+            "mascotWidth": 1536,
+            "mascotHeight": 1024,
+            "mascotSizes": "(max-width: 620px) calc(100vw - 64px), 320px",
+            "mascotWebpSrcset": [
+              {
+                "src": "/edgepress/brand/home-hero-768.webp",
+                "width": 768
+              },
+              {
+                "src": "/edgepress/brand/home-hero.webp",
+                "width": 1536
+              }
+            ],
+            "cta": {
+              "label": "从快速入门开始",
+              "url": "/[launge]/quick-start/"
+            },
+            "highlights": [
+              "在本地化 JSON 文件中编辑页面",
+              "使用 Markdown 撰写文章",
+              "复用布局，配色由主题定义"
+            ]
+          }
+        ]
+      ]
+    },
+    {
+      "columns": 1,
+      "cells": [
+        [
+          {
+            "type": "feature-grid",
+            "title": "网站各部分各有清晰位置",
+            "items": [
+              {
+                "title": "页面使用可编辑元素",
+                "icon": "layout-grid",
+                "text": "先设置栏数，再选择元素类型，并在各页面文件中编辑对应内容。",
+                "url": "/[launge]/theme-development/"
+              },
+              {
+                "title": "文章使用 Markdown",
+                "icon": "file-text",
+                "text": "使用 Markdown 撰写长文，由内置渲染器进行清理和排版。",
+                "url": "/[launge]/project-introduction/"
+              },
+              {
+                "title": "主题负责视觉设计",
+                "icon": "palette",
+                "text": "使用 HTML 局部模板构建布局，并将各主题的配色保留在样式表中。",
+                "url": "/[launge]/theme-development/"
+              },
+              {
+                "title": "集成遵循用户同意",
+                "icon": "shield-check",
+                "text": "配置跟踪、统计、广告或人机验证服务及其供应商信息。",
+                "url": "/[launge]/plugin-development/"
+              }
+            ]
+          }
+        ]
+      ]
+    },
+    {
+      "columns": 2,
+      "cells": [
+        [
+          {
+            "type": "section",
+            "title": "了解项目",
+            "tone": "soft",
+            "blocks": [
+              {
+                "type": "text",
+                "paragraphs": [
+                  "从项目介绍和快速入门开始。指南涵盖功能生命周期、支持的运行环境和建议的发布流程。"
+                ]
+              },
+              {
+                "type": "link-list",
+                "title": "项目指南",
+                "items": [
+                  {
+                    "label": "项目介绍",
+                    "url": "/[launge]/project-introduction/"
+                  },
+                  {
+                    "label": "快速入门",
+                    "url": "/[launge]/quick-start/"
+                  }
+                ]
+              }
+            ]
+          }
+        ],
+        [
+          {
+            "type": "section",
+            "title": "扩展项目",
+            "tone": "soft",
+            "blocks": [
+              {
+                "type": "text",
+                "paragraphs": [
+                  "使用主题局部模板复用 head 元数据、导航、页脚和错误页布局。每个页面的行布局和元素内容保存在本地化页面文件中。",
+                  "构建插件在 Node 中运行。浏览器服务会等到访客明确同意后才请求供应商代码。"
+                ]
+              },
+              {
+                "type": "link-list",
+                "title": "开发指南",
+                "items": [
+                  {
+                    "label": "主题开发",
+                    "url": "/[launge]/theme-development/"
+                  },
+                  {
+                    "label": "插件开发",
+                    "url": "/[launge]/plugin-development/"
+                  }
+                ]
+              }
+            ]
+          }
+        ]
+      ]
+    },
+    {
+      "columns": 1,
+      "cells": [
+        [
+          {
+            "type": "latest-posts",
+            "title": "最新项目动态",
+            "count": 3,
+            "paginate": true
+          }
+        ]
+      ]
+    },
+    {
+      "columns": 1,
+      "cells": [
+        [
+          {
+            "type": "media-text",
+            "mediaType": "image",
+            "src": "/images/previews/edgepress-zh.webp",
+            "alt": "写文建站本地网站界面实拍。",
+            "caption": "本地构建的界面截图。",
+            "placement": "left",
+            "title": "看见源文件生成的网站",
+            "text": "文章、导航、搜索与语言路由一起发布。选择主题，日常写作只需要 Markdown。"
+          }
+        ]
+      ]
+    },
+    {
+      "columns": 1,
+      "cells": [
+        [
+          {
+            "type": "data-table",
+            "title": "免费部署优先级（2026-10-04）",
+            "headers": [
+              "优先级",
+              "平台",
+              "额度与条件"
+            ],
+            "rows": [
+              [
+                "1",
+                "Cloudflare",
+                "静态请求免费不限量；每月 3,000 分钟构建。"
+              ],
+              [
+                "2",
+                "腾讯 EdgeOne Pages",
+                "当前网站流量与请求不限量；每月 500 次构建。免费阶段额度可能调整。"
+              ],
+              [
+                "3",
+                "Vercel Hobby",
+                "每月 100 GB 与 100 万次 CDN 请求；限个人非商业用途。"
+              ],
+              [
+                "4",
+                "Netlify Free",
+                "每月 300 共享积分；部署 15，流量每 GB 20，请求每万次 2；用尽暂停。"
+              ],
+              [
+                "待核实",
+                "阿里云 ESA Pages",
+                "流量使用站点套餐额度；每天 10 万次函数额度不是静态流量。"
+              ]
+            ]
+          }
+        ]
+      ]
+    },
+    {
+      "columns": 1,
+      "cells": [
+        [
+          {
+            "type": "link-list",
+            "title": "部署说明与额度来源",
+            "items": [
+              {
+                "label": "中文说明",
+                "url": "https://github.com/jsw-teams/edgepress/blob/main/content/guides/zh-cn.md"
+              },
+              {
+                "label": "官方额度来源",
+                "url": "https://github.com/jsw-teams/edgepress/blob/main/content/guides/platforms.md"
+              }
+            ]
+          }
+        ]
+      ]
+    }
+  ]
+}

package/content/pages/local-tools/en.json

@@ -0,0 +1,14 @@
+{
+  "$schema": "../../../schemas/pages.schema.json",
+  "title": "Browser-local tools",
+  "lang": "en",
+  "slug": "local-tools",
+  "description": "Add a local browser tool to JSON Pages without a separate HTML document or server.",
+  "blocks": [{"columns":1,"cells":[[
+    {"type":"text","text":"A `local-tool` element mounts trusted site JavaScript inside a normal JSON Page. EdgePress owns the document, theme, navigation, page rows, escaping and asset fingerprints. Use this element for local calculators, file readers or search tools; external providers still require a consent-controlled service."},
+    {"type":"code","language":"json","code":"{\n  \"type\": \"local-tool\",\n  \"id\": \"question-search\",\n  \"title\": \"Search the question bank\",\n  \"script\": \"/tools/search.js\",\n  \"stylesheet\": \"/tools/search.css\",\n  \"data\": \"/data/questions.json\",\n  \"fallback\": \"Enable JavaScript to search locally.\"\n}"},
+    {"type":"text","text":"Put executable assets in `static/` or `content/assets/`. All referenced assets must exist at build time. Scripts use `.js` or `.mjs`, optional styles use `.css`, and optional public data uses `.json`. Paths must be local absolute site paths without traversal, query strings or remote origins. Keep IDs unique within the Page."},
+    {"type":"code","language":"javascript","code":"const root = document.querySelector('#question-search');\nconst mount = root.querySelector('[data-tool-mount]');\nconst response = await fetch(root.dataset.toolData);\nconst data = await response.json();\n// Create accessible controls with DOM APIs inside mount.\n// Import local modules normally; EdgePress fingerprints the graph."},
+    {"type":"text","text":"The tool module is trusted source, with the same responsibility as a theme script. Keep private files and inputs in browser memory, load expensive workers or models on visitor demand, and provide cancellation and clear failures. A local element does not authorize requests to external services or add an API. Static JSON remains refreshable; executable dependencies receive immutable hashed URLs."}
+  ]]}]
+}

package/content/pages/local-tools/zh-cn.json

@@ -0,0 +1,14 @@
+{
+  "$schema": "../../../schemas/pages.schema.json",
+  "title": "浏览器本地工具",
+  "lang": "zh-CN",
+  "slug": "local-tools",
+  "description": "通过 JSON Pages 挂载浏览器本地工具，由写文建站生成页面与资源。",
+  "blocks": [{"columns":1,"cells":[[
+    {"type":"text","text":"`local-tool` 元素在原生 JSON 页面内挂载站点自己的浏览器模块。页面文档、主题、导航、行列布局、文本转义和资源指纹均由写文建站生成，不需要单独维护 HTML 网页。适用于本地计算、文件读取和题库检索；外部服务仍需通过逐服务同意机制接入。"},
+    {"type":"code","language":"json","code":"{\n  \"type\": \"local-tool\",\n  \"id\": \"question-search\",\n  \"title\": \"搜索题库\",\n  \"script\": \"/tools/search.js\",\n  \"stylesheet\": \"/tools/search.css\",\n  \"data\": \"/data/questions.json\",\n  \"fallback\": \"请启用 JavaScript 使用本地搜题。\"\n}"},
+    {"type":"text","text":"将资源放在 `static/` 或 `content/assets/`。模块、可选样式、可选公开数据分别使用 `.js` 或 `.mjs`、`.css`、`.json`，构建时必须存在。仅接受站内绝对路径，禁止外部地址、路径穿越和查询参数。一个页面内的工具 ID 不得重复。"},
+    {"type":"code","language":"javascript","code":"const root = document.querySelector('#question-search');\nconst mount = root.querySelector('[data-tool-mount]');\nconst response = await fetch(root.dataset.toolData);\nconst data = await response.json();\n// 使用 DOM API 在 mount 内创建无障碍控件。\n// 正常导入本地模块，框架会为依赖图生成指纹。"},
+    {"type":"text","text":"本地工具模块与主题脚本一样属于可信站点源码。私人文件和输入留在浏览器内存中，大型 Worker 和模型在访问者主动使用时加载，并提供取消和错误提示。此元素不授予外部服务请求权限，也不创建 API。公开 JSON 保持可重新验证，脚本和样式通过哈希地址长久缓存。"}
+  ]]}]
+}

package/content/pages/page-authoring/en.json

@@ -0,0 +1,107 @@
+{
+  "$schema": "../../../schemas/pages.schema.json",
+  "title": "Read Pages as nested collections",
+  "lang": "en",
+  "slug": "page-authoring",
+  "description": "Author JSON Pages with editor schema, nested objects and arrays, and independent folding.",
+  "blocks": [
+    {
+      "columns": 1,
+      "cells": [
+        [
+          {
+            "type": "hero",
+            "title": "Read Pages as nested collections",
+            "text": "Author JSON Pages with editor schema, nested objects and arrays, and independent folding."
+          }
+        ]
+      ]
+    },
+    {
+      "columns": 1,
+      "cells": [
+        [
+          {
+            "type": "code",
+            "title": "Complete two-column JSON Page",
+            "language": "json",
+            "code": "{\n  \"title\": \"My page\",\n  \"lang\": \"en\",\n  \"slug\": \"my-page\",\n  \"blocks\": [\n    {\n      \"columns\": 2,\n      \"cells\": [\n        [\n          {\n            \"type\": \"heading\",\n            \"level\": 2,\n            \"text\": \"About this project\"\n          },\n          {\n            \"type\": \"text\",\n            \"text\": \"A small tool for everyday writing.\"\n          }\n        ],\n        [\n          {\n            \"type\": \"link-list\",\n            \"title\": \"Read more\",\n            \"items\": [\n              {\n                \"label\": \"Project\",\n                \"url\": \"/[launge]/project-introduction/\"\n              }\n            ]\n          }\n        ]\n      ]\n    }\n  ]\n}"
+          }
+        ]
+      ]
+    },
+    {
+      "columns": 1,
+      "cells": [
+        [
+          {
+            "type": "text",
+            "paragraphs": [
+              "Save the example as content/pages/my-page/en.json. Locale filenames are lowercase; lang must match an enabled locale. homepage: true publishes at the localized site root. slug selects an ordinary page path. JSON Pages have no YAML front matter or Markdown body.",
+              "The blocks array holds rows in order. A row sets columns from 1 to 4 and contains that many arrays in cells. Each cell is an array containing at least one element. Elements appear from top to bottom.",
+              "JSON keys and strings use double quotes. Objects use braces and arrays use brackets; commas separate siblings. Do not add an elements field: the innermost arrays directly contain the elements.",
+              "A section’s blocks hold child elements, not new rows. For prose use text or paragraphs; for code use a code string with \\n for line breaks. Articles remain Markdown under content/posts.",
+              "A local $schema reference enables field help and validation in VS Code. The editor can fold each object and array and show its children in Outline. Legacy .md YAML Pages remain readable, but do not keep both formats for the same locale."
+            ]
+          }
+        ]
+      ]
+    },
+    {
+      "columns": 1,
+      "cells": [
+        [
+          {
+            "type": "data-table",
+            "title": "Common elements (fields)",
+            "headers": [
+              "Purpose",
+              "Element and key fields"
+            ],
+            "rows": [
+              [
+                "Title",
+                "heading (level, text)"
+              ],
+              [
+                "Prose",
+                "text (text OR paragraphs)"
+              ],
+              [
+                "Group",
+                "section (title, blocks)"
+              ],
+              [
+                "Code",
+                "code (language, code)"
+              ],
+              [
+                "Articles",
+                "post-list (title, category OR categories, count)"
+              ],
+              [
+                "Document",
+                "document (title, src)"
+              ],
+              [
+                "Gallery",
+                "media-viewer (title, items)"
+              ]
+            ]
+          }
+        ]
+      ]
+    },
+    {
+      "columns": 1,
+      "cells": [
+        [
+          {
+            "type": "text",
+            "text": "Run npm run pages:format to preview migration, then npm run pages:format -- --write to apply it. The tool checks field values and order before removing the legacy file. Run npm run build to validate the renderer."
+          }
+        ]
+      ]
+    }
+  ]
+}