edgepress 2026.10.1 → 2026.10.13

package/content/pages/theme-development/zh-cn.json

@@ -0,0 +1,349 @@
+{
+  "$schema": "../../../schemas/pages.schema.json",
+  "title": "主题开发",
+  "lang": "zh-CN",
+  "slug": "theme-development",
+  "description": "使用共享 HTML 局部模板、CSS 配色、页面元素布局和可复用错误页构建 EdgePress 主题。",
+  "blocks": [
+    {
+      "columns": 1,
+      "cells": [
+        [
+          {
+            "type": "section",
+            "title": "按需开发节省流量版本",
+            "blocks": [
+              {
+                "type": "text",
+                "paragraphs": [
+                  "轻量版本是主题的可选能力，不强制每个主题提供。支持时在 theme.json 中声明 dataSaver，并把专用样式与可选脚本放在 assets/。框架负责检测、用户选择、延后媒体请求及本地资源安全；主题负责合理的轻量配色、布局与必要交互。",
+                  "使用系统字体和少量 CSS，不引入装饰性图片或网络字体。可选 layoutStyles 声明已发布样式，构建时提取共享布局并移除字体声明与 URL。专用样式调整图片卡片，保留真实标题、摘要、日期、导航、页脚、焦点与主题配色，不能粗暴将所有网格变为一列。非必要的完整模式脚本使用 data-data-optional。动态图片在设置任何媒体地址前调用 window.edgepressDataSaver?.deferMedia，不能等下载开始后才隐藏。",
+                  "站长分别决定是否检测首屏延迟、是否响应浏览器节流偏好。首屏过久才提示选择文字省流版，不因慢网络标签自动切换；明确的 saveData 信号可以在导航时启用省流版。不常驻三档选择器，文字版保留切回完整页面的入口。用户明确选择优先于自动判断，不突然刷新正在阅读的页面。"
+                ]
+              },
+              {
+                "type": "code",
+                "title": "theme.json 增加声明",
+                "language": "json",
+                "code": "\"dataSaver\": {\n  \"stylesheet\": \"data-saver-theme.css\",\n  \"scripts\": [],\n  \"layoutStyles\": [\"style.css\"]\n}\n"
+              },
+              {
+                "type": "code",
+                "title": "config.yml 站点配置",
+                "language": "yaml",
+                "code": "site:\n  dataSaver:\n    enabled: true\n    debug: false\n    mode: auto\n    detectSlowConnection: true\n    respectBrowserPreference: false\n    promptAfterMs: 5000\n"
+              },
+              {
+                "type": "text",
+                "text": "只有调试时才开启 site.dataSaver.debug，并用 /?data-save 查看文字版。关闭后该入口进入本地化静态 404 页面；真正 HTTP 404 需由托管规则处理。默认完整版，在等待页直接展示实际资源进度与文字版入口，不等待完整样式或引擎才能切换。完整样式、多媒体、引擎分阶段加载，字体下载不阻挡阅读。保留已聚焦的选择，授权后按需加载所选服务，不连带加载其他插件。系统字体回退需覆盖中日韩文字。"
+              },
+              {
+                "type": "text",
+                "paragraphs": [
+                  "用隔离浏览器模拟慢网络与 saveData，检查真实请求记录，同时覆盖不支持相关 API、存储受阻、关闭 JavaScript、键盘操作、小屏幕、暗色及高对比。文字模式不应自动请求完整主题、字体、图片或文档和视频引擎；单独加载媒体不能启动其他预览。保留资源依赖指纹、完整显示功能、外链提示与当前有效服务同意。"
+                ]
+              }
+            ]
+          }
+        ]
+      ]
+    },
+    {
+      "columns": 1,
+      "cells": [
+        [
+          {
+            "type": "text",
+            "text": "文档通过纯浏览器 document-viewer 自动预览，支持 PDF、DOC/DOCX、PPT/PPTX 和 XLS/XLSX。云端构建无需安装 Office 或 LibreOffice。预览不保证 Office 排版完全一致，不执行宏，也不加载文档内外部资源。"
+          },
+          {
+            "type": "code",
+            "title": "文档区块",
+            "language": "json",
+            "code": "[\n  {\n    \"type\": \"document\",\n    \"title\": \"年度报告\",\n    \"src\": \"/documents/report.docx\"\n  },\n  {\n    \"type\": \"document\",\n    \"title\": \"分享的工作表\",\n    \"src\": \"https://files.example/download/123\",\n    \"format\": \"xlsx\",\n    \"service\": \"documents\"\n  }\n]"
+          },
+          {
+            "type": "text",
+            "text": "本地文档放在 content/assets/documents/。文章和 Pages 文本区块支持独立一行的 !document[年度报告](/documents/report.docx)。无扩展名的分享下载地址使用 !document[分享报告](https://files.example/download/123){format=pdf service=documents}。远程文档须在 plugins.consent.services 注册 external-api 服务并填写隐私披露，等待当前访客同意后才请求。地址必须返回文件原始字节且允许 CORS；分享页面解析、身份验证和访问权限由外部服务负责，不新增站点代理。"
+          }
+        ]
+      ]
+    },
+    {
+      "columns": 1,
+      "cells": [
+        [
+          {
+            "type": "hero",
+            "eyebrow": "主题指南",
+            "title": "让主题负责共享布局和视觉设计。",
+            "text": "页面定义行栏数、元素类型和内容。主题负责网站外壳、字体、间距、颜色和响应式行为。"
+          }
+        ]
+      ]
+    },
+    {
+      "columns": 2,
+      "cells": [
+        [
+          {
+            "type": "section",
+            "title": "主题结构",
+            "tone": "soft",
+            "blocks": [
+              {
+                "type": "code",
+                "title": "主题文件",
+                "language": "text",
+                "code": "themes/your-theme/\n  theme.json\n  package.json\n  README.md\n  layouts/\n    layout.html\n    partials/\n      head.html\n      header.html\n      footer.html\n  assets/\n    style.css\n"
+              },
+              {
+                "type": "text",
+                "paragraphs": [
+                  "共享布局会渲染所有页面和文章。head、header 和 footer 局部模板提供常见网站组件。在 config.yml 中配置页面标题后缀与分隔符、站点标题、全站导航、语言链接、页脚内容和组件显示状态。",
+                  "使用双花括号占位符输出经过转义的值。唯一允许的原样占位符是生成的页面内容、JSON-LD 和 EdgePress 生成的导航标记。保留跳转链接、唯一 main 主区域、带标签的导航、可见焦点和一个页面级 h1。",
+                  "页面块中的站内链接可写成 /[launge]/quick-start/。生成页面会把 [launge] 替换为当前语言路径；默认语言会移除该段，因此同一链接可用于中英文页面。",
+                  "将 body 保持为全高纵向布局，并让 main 延伸，这样短页面的页脚也会留在视口底部。",
+                  "将页面图片和下载文件放在 content/assets/。EdgePress 会按原相对路径发布到站点根目录，例如 content/assets/images/diagram.svg 对应 /images/diagram.svg。themes/<name>/assets/ 用于共享 CSS 和 JavaScript。",
+                  "在主题中统一设计代码块、复制按钮和文章目录。窄屏代码行会自动折行，复制控件具有清晰的键盘焦点，生成的文章目录会链接到标题锚点。"
+                ]
+              }
+            ]
+          }
+        ],
+        [
+          {
+            "type": "section",
+            "title": "选择主题配色",
+            "tone": "soft",
+            "blocks": [
+              {
+                "type": "text",
+                "paragraphs": [
+                  "颜色、字体选择和组件样式保存在当前主题的样式表中。不要在 config.yml 中填写颜色。切换主题不会改变页面内容。",
+                  "使用 edgepress theme list 查看可用主题。使用 edgepress theme use default、edgepress theme use atelier 或 edgepress theme use signal 进行切换。",
+                  "使用 edgepress theme install <npm-package>[@version] 安装 npm 上发布的主题包。包内必须包含 theme.json 和 layouts/layout.html。EdgePress 会将主题复制到 themes/，且不会运行 npm 安装脚本。",
+                  "使用 edgepress theme create my-theme 创建可发布到 npm 的主题包骨架，其中包含 npm package.json、空白样式表、无障碍布局以及 head、header、导航和 footer 文件。编辑后使用 edgepress theme use my-theme 切换；也可以进入该目录运行 npm publish --access public 发布。"
+                ]
+              },
+              {
+                "type": "notice",
+                "title": "共享错误页",
+                "text": "EdgePress 使用所选主题布局生成本地化的 403 和 404 页面。静态资源被拒绝访问时，Worker 会返回对应的 403 页面。",
+                "tone": "info"
+              }
+            ]
+          }
+        ]
+      ]
+    },
+    {
+      "columns": 1,
+      "cells": [
+        [
+          {
+            "type": "section",
+            "title": "页面行与可编辑元素",
+            "blocks": [
+              {
+                "type": "text",
+                "paragraphs": [
+                  "每个页面的语言版本使用 JSON 文件；元数据与有序 blocks 同在一个对象中，本地 Pages schema 提供编辑器校验。文章仍使用 Markdown。",
+                  "数据从外向内排列：先设每行的 columns 栏数，再为每栏设置一个 cells 项，然后在栏内选择元素类型，最后编辑该元素字段。验证器会拒绝栏数不匹配或空白的栏。",
+                  "页面不使用文章 Markdown 渲染器。文章仍使用 Markdown 撰写，并由内置安全渲染器输出。",
+                  "hero 元素可用 mascotWebpSrcset 提供按宽度递增的路径候选项，并设置与显示宽度一致的 mascotSizes，以及匹配备用图片尺寸的 mascotWidth 和 mascotHeight。mascotSrc 会留作不支持 WebP 的浏览器备用图。"
+                ]
+              },
+              {
+                "type": "data-table",
+                "title": "可用元素类别",
+                "headers": [
+                  "元素",
+                  "主要用途"
+                ],
+                "rows": [
+                  [
+                    "hero、section、text、heading",
+                    "页面结构和文字内容"
+                  ],
+                  [
+                    "display-text",
+                    "编辑式、衬线、描边、等宽或强调字样"
+                  ],
+                  [
+                    "media-text",
+                    "图片或带字幕视频配合可编辑文字"
+                  ],
+                  [
+                    "link-list、list、steps、code、data-table、notice",
+                    "导航、说明、代码、信息和提示"
+                  ],
+                  [
+                    "feature-grid、quote、cta、faq、latest-posts",
+                    "可复用页面组合"
+                  ],
+                  [
+                    "privacy-services、privacy-controller、privacy-consent、captcha、ad-slot",
+                    "使用配置数据的站点集成"
+                  ]
+                ]
+              },
+              {
+                "type": "notice",
+                "title": "视频字幕",
+                "text": "media-text 视频元素需要 WebVTT 字幕源、语言标签和字幕轨道名称。视频使用浏览器原生控件并设置 preload none。第三方视频嵌入应放在明确同意后才启用的集成中。",
+                "tone": "warning"
+              }
+            ]
+          }
+        ]
+      ]
+    },
+    {
+      "columns": 1,
+      "cells": [
+        [
+          {
+            "type": "section",
+            "title": "开发与预览",
+            "blocks": [
+              {
+                "type": "steps",
+                "items": [
+                  {
+                    "title": "选择主题",
+                    "text": "安装或创建主题后，使用 EdgePress theme 命令修改 edgepress.config.mjs 中的 paths.theme。",
+                    "command": "edgepress theme use your-theme"
+                  },
+                  {
+                    "title": "编辑布局和 CSS",
+                    "text": "修改所选主题的布局、局部模板和样式表。构建时会为每个 CSS 和 JavaScript 资源生成内容指纹。"
+                  },
+                  {
+                    "title": "预览网站",
+                    "text": "server 会监视源文件、重新构建输出、刷新浏览器，并更新无障碍化和 agent 友好度报告。",
+                    "command": "edgepress server"
+                  }
+                ]
+              }
+            ]
+          }
+        ]
+      ]
+    },
+    {
+      "columns": 1,
+      "cells": [
+        [
+          {
+            "type": "section",
+            "title": "使用共享图标库",
+            "tone": "soft",
+            "text": "EdgePress 随站点提供 28 个本地Lucide SVG 图标，存放在 content/assets/edgepress/icons/，发布路径为 /edgepress/icons/<name>.svg。主题导航会自动使用图标；feature-grid 也可为功能卡片指定图标，不增加运行时依赖，也不会请求第三方服务器。",
+            "blocks": [
+              {
+                "type": "code",
+                "title": "在主题局部模板中添加装饰图标",
+                "language": "html",
+                "code": "<img class=\"icon icon-library\" src=\"/edgepress/icons/layers.svg\" width=\"24\" height=\"24\" alt=\"\" aria-hidden=\"true\">\n"
+              },
+              {
+                "type": "code",
+                "title": "为功能卡片指定图标",
+                "language": "json",
+                "code": "[\n  {\n    \"title\": \"文章使用 Markdown\",\n    \"icon\": \"file-text\",\n    \"text\": \"撰写并发布文章。\"\n  }\n]"
+              }
+            ]
+          }
+        ]
+      ]
+    },
+    {
+      "columns": 1,
+      "cells": [
+        [
+          {
+            "type": "section",
+            "title": "显示单个项目的文章",
+            "blocks": [
+              {
+                "type": "text",
+                "paragraphs": [
+                  "使用 post-list 的 category: edgepress 或 categories: [博客, 未分类] 筛选栏目，按日期由新到旧排列，优先选择当前语言版本。count 可设为 1 到 12；单个分类超出的文章链接到当前语言分类归档。"
+                ]
+              },
+              {
+                "type": "code",
+                "title": "项目文章列表",
+                "language": "json",
+                "code": "[\n  {\n    \"columns\": 1,\n    \"cells\": [\n      [\n        {\n          \"type\": \"post-list\",\n          \"title\": \"EdgePress articles\",\n          \"category\": \"edgepress\",\n          \"count\": 6\n        }\n      ]\n    ]\n  }\n]"
+              },
+              {
+                "type": "text",
+                "paragraphs": [
+                  "在文章前置数据加入 category: edgepress；省略分类时默认未分类。标签仅在文章页展示，移除 tag 筛选和标签归档。site.archive.categories 控制主见闻栏目；首页分页时使用相同分类。"
+                ]
+              }
+            ]
+          }
+        ]
+      ]
+    },
+    {
+      "columns": 1,
+      "cells": [
+        [
+          {
+            "type": "text",
+            "heading": "图片细节查看",
+            "text": "文章图片和 Pages 的 image、media-text 图片块支持点击全屏放大。原图地址与展示图不同时，Pages 图片块可填写 originalSrc，Markdown HTML 图片可填写 data-original，链接到图片文件的图片也可直接放大；点击查看时才加载原图。工具栏支持缩放、保存与关闭，关闭后回到原位置。品牌图片和普通导航链接保留原用途，可选服务中的图片仍需要访客授权，并遵循 CSP。"
+          },
+          {
+            "type": "text",
+            "text": "构建时会自动给本地发布图片添加实际宽高，在加载前保留其比例；已设置的宽高会保留。远程图片请自行填写尺寸，构建器不会请求远程图片。"
+          }
+        ]
+      ]
+    },
+    {
+      "columns": 1,
+      "cells": [
+        [
+          {
+            "type": "text",
+            "heading": "本地多语言字体",
+            "text": "内置主题随站点打包 Noto Sans、Noto Serif 和简繁中文可变字体，不请求字体 CDN。WOFF2 按 Unicode 字符范围分片，只加载当前页面使用的字形；繁体语言优先使用繁体字形。界面、文章、Pages 和代码中的中文均可使用本地字形，不要求访客安装中文字体。"
+          },
+          {
+            "type": "code",
+            "title": "自定义主题使用统一字体变量",
+            "language": "css",
+            "code": ":root { font-family: var(--edgepress-font-sans); }\nh1, h2 { font-family: var(--edgepress-font-serif); }\npre, code { font-family: var(--edgepress-font-mono); }\n"
+          },
+          {
+            "type": "text",
+            "text": "字体覆盖拉丁字母、希腊字母、西里尔字母及常用简繁中文，并非完整 Unicode。增加阿拉伯语等其他文字系统的语言包时，应同时加入对应 Noto 字体与 unicode-range；保持同源加载、OFL 许可证和内容哈希。fonts:sync 仅维护字体资源，普通构建无需下载字体。"
+          }
+        ]
+      ]
+    },
+    {
+      "columns": 1,
+      "cells": [
+        [
+          {
+            "type": "text",
+            "heading": "在 Pages 插入查看器",
+            "text": "文档以带页码的连续分页展示，不再使用上下页按钮。document 插入 PDF 和 Office；media-viewer 插入图片、视频或混合附件。只挂载选中的媒体，点击播放后才加载视频。远程资源须填写 service，登记 external-api 服务并明确配置 img-src、media-src、connect-src 所需来源，授权后才请求。视频字幕填写 captions 和 captionLanguage；只有确实无声的片段才可用 silent: true 代替字幕。"
+          },
+          {
+            "type": "code",
+            "title": "Pages 查看器元素",
+            "language": "json",
+            "code": "[\n  {\n    \"columns\": 1,\n    \"cells\": [\n      [\n        {\n          \"type\": \"document\",\n          \"title\": \"Report\",\n          \"src\": \"/documents/report.pdf\"\n        },\n        {\n          \"type\": \"media-viewer\",\n          \"title\": \"Photos and video\",\n          \"items\": [\n            {\n              \"type\": \"image\",\n              \"src\": \"/images/photo.webp\",\n              \"originalSrc\": \"/images/photo-original.webp\",\n              \"alt\": \"Detail of the project interface\"\n            },\n            {\n              \"type\": \"video\",\n              \"src\": \"/videos/walkthrough.mp4\",\n              \"poster\": \"/images/poster.webp\",\n              \"label\": \"Project walkthrough\",\n              \"captions\": \"/videos/walkthrough.en.vtt\",\n              \"captionLanguage\": \"en\"\n            }\n          ]\n        }\n      ]\n    ]\n  }\n]"
+          }
+        ]
+      ]
+    }
+  ]
+}

package/content/posts/2026-09-24-edgepress-release-2026-9-1/en.md

@@ -29,4 +29,4 @@ The guides now cover consent-gated tracking, statistics, advertising, and human-
 
 edgepress server watches source files, rebuilds the site, refreshes the browser, and updates the accessibility and agent-friendliness report. edgepress check also captures desktop and mobile screenshots and writes tools/page-check.pdf with Markdown and JSON summaries.
 
-The automated report checks generated markup and metadata. It does not establish legal compliance or replace manual keyboard, contrast, or assistive-technology review.
+The automated report checks generated markup and metadata. It does not establish legal compliance or replace manual keyboard, contrast, or assistive-technology review.

package/content/posts/2026-09-24-edgepress-release-2026-9-1/zh-cn.md

@@ -29,4 +29,4 @@ tags:
 
 edgepress server 会监视源文件、重新构建网站、刷新浏览器，并更新无障碍化和 agent 友好度报告。edgepress check 还会捕获桌面与移动页面截图，并生成 tools/page-check.pdf，以及 Markdown 和 JSON 摘要。
 
-自动报告检查生成的标记和元数据，但不能证明符合特定法律，也不能取代键盘、对比度或辅助技术的人工审核。
+自动报告检查生成的标记和元数据，但不能证明符合特定法律，也不能取代键盘、对比度或辅助技术的人工审核。

package/content/posts/2026-10-03-edgepress-release-2026-10-3/en.md

@@ -0,0 +1,16 @@
+---
+title: EdgePress October update 3
+lang: en
+date: 2026-10-03T10:00:00+08:00
+slug: edgepress-release-2026-10-3
+category: edgepress
+pinned: true
+description: Optional GitHub App comments, pinned article lists, local publication times and automatic article change history.
+---
+This update adds optional RepoRelay discussions. Readers choose whether to load GitHub comments; App credentials stay in the Worker. Repository installation and persistent signing keys are configured automatically.
+
+Article lists support pinned entries. Publication timestamps follow the reader’s timezone. The latest article update is detected from content history, and authors can enable an actual content diff with `showChanges: true`; it is hidden by default.
+
+Consent services follow the existing YAML configuration. Disabled integrations retain their settings without loading. UI icons now use licensed Lucide SVGs, and all content image sources live under `content/assets`.
+
+See the README for Worker configuration and the required full Git checkout for article history.

package/content/posts/2026-10-03-edgepress-release-2026-10-3/zh-cn.md

@@ -0,0 +1,16 @@
+---
+title: EdgePress 十月第 3 次更新
+lang: zh-CN
+date: 2026-10-03T10:00:00+08:00
+slug: edgepress-release-2026-10-3
+category: edgepress
+pinned: true
+description: 可选 GitHub App 评论、置顶文章、读者本地时间与自动内容变动记录。
+---
+本次更新接入可选的 RepoRelay 评论。读者选择后才加载 GitHub 评论，App 凭据保留在 Worker。仓库安装信息自动识别，签名密钥自动生成并持久保存。
+
+文章列表支持置顶。发表时间按读者当前时区显示；最近更新时间根据内容历史自动识别。文章可通过 `showChanges: true` 开启最近一次实际内容变动的展示，默认隐藏，无需填写修正说明。
+
+隐私服务读取现有 YAML 配置，禁用的集成保留设置而不加载。界面图标改用附带授权文件的 Lucide SVG，所有内容图像源统一存放于 `content/assets`。
+
+Worker 配置与文章历史所需的完整 Git 检出方式见 README。

package/content/posts/2026-10-03-edgepress-release-202610-4/en.md

@@ -0,0 +1,22 @@
+---
+title: "EdgePress 202610.4: discussions and publication time"
+date: 2026-10-03
+lang: en
+category: edgepress
+tags:
+  - EdgePress
+  - RepoRelay
+description: Verified GitHub identity and avatars, a local image/GIF sticker
+  gallery, and deletion of your own comments. Discussions load only after you
+  opt in.
+---
+
+Comment authors now show their GitHub avatars. A separate sticker panel offers 24 locally hosted images in two packs, and operators can add their own licensed GIF or image packs. Upload images remains a separate action.
+
+After signing in, your own comments offer a delete action with confirmation. The Worker checks numeric identity, signed metadata and the actual discussion before deleting; this remains available when new comments are closed. Uploaded media and historical copies are not automatically removed.
+
+EdgePress 202610.4 adds explicit comments blocks for pages and removes repeated articles across pinned and recent lists. Sites without comments enabled omit the area. Both JS.GRIPE and connect show it and keep loading behind your privacy choice.
+
+Publication time is configured with `site.timeZone: Asia/Taipei`. Complete timestamps display in the reader’s zone, while date-only articles remain dates. No historical comment rewrite or author impersonation is required.
+
+[Install and integrate with EdgePress](https://github.com/jsw-teams/RepoRelay/blob/main/docs/edgepress.md) · [Independent changelog](https://github.com/jsw-teams/RepoRelay/blob/main/CHANGELOG.md)

package/content/posts/2026-10-03-edgepress-release-202610-4/zh-cn.md

@@ -0,0 +1,20 @@
+---
+title: EdgePress 202610.4：评论区与发表时区
+date: 2026-10-03
+lang: zh-CN
+category: edgepress
+tags:
+  - EdgePress
+  - RepoRelay
+description: 显示经过验证的 GitHub 身份和头像，可从本地图片、GIF 图集中选择表情包，支持删除自己的评论。读者选中评论后才加载讨论。
+---
+
+评论显示发表用户的 GitHub 头像。新增独立表情包面板，内置两个本地图集、共 24 张图片，站长也可加入有使用权限的 GIF 或图片包。“上传图片”保留为单独操作。
+
+登录后，本人评论提供删除按钮，确认后才删除。Worker 核验用户 ID、签名身份和实际讨论归属；关闭新评论后仍可删除自己的评论。删除不会自动清理已上传图片及历史副本。
+
+EdgePress 202610.4 新增页面 comments 区块，修正同一页置顶文章与最新文章重复出现的问题。未启用评论的站点不显示评论区域；js.gripe 和 connect.js.gripe 明确显示，加载仍由读者的隐私选择控制。
+
+文章发表时区在 config.yml 使用 `site.timeZone: Asia/Taipei` 配置。完整时间根据读者时区展示，只有年月日的文章保留日历日期。正式评论沿用原格式，不冒充原作者重新发表。
+
+[安装及 EdgePress 接入](https://github.com/jsw-teams/RepoRelay/blob/main/docs/edgepress.md) · [独立更新日志](https://github.com/jsw-teams/RepoRelay/blob/main/CHANGELOG.md)

package/content/posts/2026-10-03-edgepress-release-202610-5/en.md

@@ -0,0 +1,15 @@
+---
+title: "EdgePress 2026.10.5: CommentNest integration and persistent choices"
+lang: en
+date: 2026-10-03
+slug: edgepress-release-202610-5
+category: edgepress
+tags:
+  - EdgePress
+---
+
+EdgePress now connects to CommentNest · 评巢 using a configured backend URL. The independent project owns the complete comment widget, translations, styling, stickers and GitHub App backend. The framework keeps the consent gate and published article/page context.
+
+Privacy choices survive refresh and navigation, including browsers where persistent local storage is unavailable. Cosmetic names and translations no longer reset saved choices. Changing services, endpoints or notice dates asks for a new choice.
+
+[Install CommentNest and connect EdgePress](https://github.com/jsw-teams/CommentNest/blob/main/docs/edgepress.md).

package/content/posts/2026-10-03-edgepress-release-202610-5/zh-cn.md

@@ -0,0 +1,15 @@
+---
+title: EdgePress 2026.10.5：CommentNest 接入与偏好保存
+lang: zh-CN
+date: 2026-10-03
+slug: edgepress-release-202610-5
+category: edgepress
+tags:
+  - EdgePress
+---
+
+EdgePress 通过配置的后端 URL 接入 CommentNest · 评巢。独立项目负责完整评论界面、翻译、样式、表情包和 GitHub App 后端；框架保留隐私选择和已发布文章、页面的信息。
+
+偏好在刷新和导航后继续保留，本地持久存储受限时也有回退。名称、翻译和界面调整不再重置选择；服务、地址或告知日期变化时重新征求选择。
+
+[安装 CommentNest 并接入 EdgePress](https://github.com/jsw-teams/CommentNest/blob/main/docs/edgepress.md)。

package/edgeone.json

@@ -0,0 +1,43 @@
+{
+  "buildCommand": "npm run build",
+  "installCommand": "npm ci",
+  "outputDirectory": "dist",
+  "nodeVersion": "22.16.0",
+  "headers": [
+    {
+      "source": "/*",
+      "headers": [
+        {
+          "key": "Cache-Control",
+          "value": "public, max-age=0, must-revalidate"
+        },
+        {
+          "key": "X-Content-Type-Options",
+          "value": "nosniff"
+        },
+        {
+          "key": "Referrer-Policy",
+          "value": "strict-origin-when-cross-origin"
+        }
+      ]
+    },
+    {
+      "source": "/*.js",
+      "headers": [
+        {
+          "key": "Cache-Control",
+          "value": "public, max-age=31536000, immutable"
+        }
+      ]
+    },
+    {
+      "source": "/*.css",
+      "headers": [
+        {
+          "key": "Cache-Control",
+          "value": "public, max-age=31536000, immutable"
+        }
+      ]
+    }
+  ]
+}

package/esa.jsonc

@@ -0,0 +1,9 @@
+{
+  "name": "edgepress",
+  "installCommand": "npm ci",
+  "buildCommand": "npm run build",
+  "assets": {
+    "directory": "./dist",
+    "notFoundStrategy": "404Page"
+  }
+}

package/languages/base/en.json

@@ -1,6 +1,33 @@
 {
+  "dataSaverLoadFailed": "Required page resources could not load. Retry, or choose text view if available.",
+  "dataSaverRetry": "Retry loading",
+  "dataSaverProgressControls": "Page controls: {loaded} / {total} scripts completed",
+  "dataSaverLoadingNotice": "Full view is loading. You can switch to text view now to skip fonts and media.",
+  "dataSaverProgressStyles": "Page styles: {loaded} / {total} files completed",
+  "dataSaverProgressMedia": "First-screen images: {loaded} / {total} completed",
+  "serviceLoad": "Load this service",
+  "dataSaverLoading": "Preparing this page…",
+  "dataSaverTitle": "Data usage",
+  "dataSaverAuto": "Automatic",
+  "dataSaverText": "Text only",
+  "dataSaverFull": "Full view",
+  "dataSaverNotice": "Text mode pauses images, fonts, document previews and optional external services. Load individual media when needed, or switch to full view.",
+  "dataSaverLoad": "Load this media",
+  "dataSaverMissingDescription": "No text description was supplied for this media. Load it to see its contents.",
+  "dataSaverSlowTitle": "This page is taking a while",
+  "dataSaverSlowNotice": "Switch to a lighter text view without images or downloaded fonts, or keep waiting for the full page.",
+  "dataSaverSwitchText": "Use text view",
+  "dataSaverKeepFull": "Keep waiting",
+  "dataSaverReturnFull": "Show the full page",
+  "dataSaverTextNotice": "Text view · Images, fonts and previews load only when requested.",
+  "documentViewerPreview": "Preview document",
+  "documentViewerClose": "Close preview",
+  "documentViewerLoading": "Loading document…",
+  "documentViewerError": "Preview unavailable. Check the file, access and CORS settings.",
+  "documentViewerPage": "Page",
+  "documentViewerSheet": "Worksheet",
   "home": "Home",
-  "archives": "Archives",
+  "archives": "Journal",
   "noPosts": "No posts yet",
   "newer": "Newer posts",
   "older": "Older posts",
@@ -11,13 +38,13 @@
   "forbidden": "Access denied",
   "forbiddenText": "You do not have permission to access this page.",
   "returnHome": "Return home",
-  "allPosts": "All posts",
+  "allPosts": "All journal entries",
   "searchPosts": "Search articles",
   "searchIntro": "Search the Markdown articles published on this site. Search runs locally in your browser.",
   "searchLabel": "Search articles",
   "searchButton": "Search",
-  "searchHint": "Enter one or more words from an article title or text.",
-  "searchPrompt": "Enter a search term to find articles.",
+  "searchHint": "",
+  "searchPrompt": "",
   "searchNeedsJavaScript": "Article search needs JavaScript enabled. The search index stays on this site.",
   "searchNoResults": "No matching articles.",
   "searchResults": "Matching articles",
@@ -33,6 +60,7 @@
   "languageLabel": "Language",
   "skipToContent": "Skip to content",
   "pagination": "Pagination",
+  "pageNumber": "Page {page}",
   "pages": "Project pages",
   "latestPosts": "Latest posts",
   "postAuthor": "By {author}",
@@ -55,12 +83,49 @@
   "servicePrivacyLink": "Open policy",
   "reviewDetails": "Details",
   "essentialStorage": "Choice saved on this device for up to {days} days.",
-  "pluginTracking": "Tracking",
-  "pluginStatistics": "Statistics",
-  "pluginAdvertising": "Advertising",
-  "pluginCaptcha": "Human verification",
   "consentReload": "Your choice was saved. Reloading to apply the updated settings.",
-  "agentSummary": "Project guides and reference pages for the EdgePress website builder.",
+  "agentSummary": "Technical practice, research, personal commentary, and project updates from JS.GRIPE.",
   "closePrivacy": "Close settings",
-  "consentStoredOnDevice": "This device"
+  "consentStoredOnDevice": "This device",
+  "postStarter": "Write your first paragraph here. Use ## for sections, lists, links, and fenced code blocks as needed.",
+  "postCreated": "Created {file}",
+  "postNextSteps": "Open this file and replace the text after the closing --- with Markdown. The title, date, and language are already set.",
+  "postPreview": "Preview with npm run dev. Build with npm run build; publish through your existing deployment workflow.",
+  "postReadingTime": "About {minutes} min read",
+  "categoryBlog": "Blog",
+  "categoryUncategorized": "Uncategorized",
+  "allCategoryPosts": "All articles in this category",
+  "postPinned": "Pinned",
+  "postUpdated": "Updated",
+  "postChanges": "Most recent changes",
+  "loadMedia": "Load media",
+  "embedUnavailable": "Media is temporarily unavailable.",
+  "embedNeedsConsent": "This media is provided by {service}. It stays unloaded until you allow this service and request it.",
+  "embedReady": "You have allowed {service}. Media loads automatically when it comes into view.",
+  "embedLoading": "Loading media from {service}…",
+  "embedLoaded": "Media from {service} is loaded.",
+  "embedDisabled": "The site has disabled {service}. This media has not been loaded.",
+  "imageViewerOpenImage": "Enlarge image",
+  "imageViewerCloseImage": "Close image",
+  "imageViewerZoomIn": "Zoom in",
+  "imageViewerZoomOut": "Zoom out",
+  "imageViewerSaveOriginal": "Save original",
+  "imageViewerRetryMedia": "Retry loading",
+  "imageViewerLoading": "Loading…",
+  "imageViewerImageUnavailable": "This image is unavailable.",
+  "postChangeBefore": "Previously",
+  "postChangeAfter": "Now",
+  "postChangeAdded": "Added",
+  "postChangeRemoved": "Removed",
+  "demoPlay": "Play demo",
+  "demoPause": "Pause demo",
+  "demoReplay": "Replay demo",
+  "demoError": "The walkthrough could not load. Please try again.",
+  "demoResume": "Continue demo",
+  "demoLoading": "Loading demo…",
+  "demoSeek": "Demo progress",
+  "externalLinkTitle": "You're leaving this site",
+  "externalLinkDescription": "This link opens a different website, with its own content and privacy practices. Continue only if you want to visit it.",
+  "externalLinkBack": "Return",
+  "externalLinkContinue": "Continue to website"
 }