edgepress 2026.10.1 → 2026.10.13

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

@@ -0,0 +1,325 @@
+{
+  "$schema": "../../../schemas/pages.schema.json",
+  "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\nnpm run build\nnpm run dev\n"
+              }
+            ]
+          }
+        ]
+      ]
+    },
+    {
+      "columns": 1,
+      "cells": [
+        [
+          {
+            "type": "section",
+            "title": "Write your first article with Markdown",
+            "tone": "soft",
+            "blocks": [
+              {
+                "type": "text",
+                "text": "After the one-time setup, everyday writing uses Markdown. EdgePress creates the title, date, and language for you. Open the path printed by the command and write below the second --- line. The theme handles the page title, article list, contents, search, and feed."
+              },
+              {
+                "type": "steps",
+                "items": [
+                  {
+                    "title": "Create an article",
+                    "text": "The command prints the new Markdown file path and never overwrites an existing post.",
+                    "command": "npm run new -- post \"My first article\""
+                  },
+                  {
+                    "title": "Write in Markdown",
+                    "text": "Replace the starter paragraph. Use"
+                  },
+                  {
+                    "title": "Preview and publish",
+                    "text": "Keep the preview running while you edit. Save the file to refresh it. Build before publishing through your existing deployment workflow.",
+                    "command": "npm run dev"
+                  }
+                ]
+              },
+              {
+                "type": "code",
+                "title": "A short article body",
+                "language": "markdown",
+                "code": "This is my first article. **Markdown** formats the text.\n\n## What I learned\n\n- Record the problem.\n- Explain the solution.\n\n[Project source](https://github.com/jsw-teams/edgepress)\n"
+              },
+              {
+                "type": "text",
+                "text": "Site settings are handled during setup. The page-layout and theme guides below are available when you want to change the website design. They are optional for everyday article writing."
+              }
+            ]
+          }
+        ]
+      ]
+    },
+    {
+      "columns": 1,
+      "cells": [
+        [
+          {
+            "type": "heading",
+            "level": 2,
+            "text": "Read Pages as nested collections"
+          },
+          {
+            "type": "text",
+            "text": "Page (rows) → row (cells) → cell (elements). \"cells\": [[{ \"type\": \"text\", \"text\": \"Hello\" }]] places one text element in one cell. See the Pages authoring guide for the complete example."
+          },
+          {
+            "type": "link-list",
+            "title": "Read Pages as nested collections",
+            "items": [
+              {
+                "label": "Read Pages as nested collections",
+                "url": "/page-authoring/"
+              }
+            ]
+          }
+        ]
+      ]
+    },
+    {
+      "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 post \"A project update\""
+                  },
+                  {
+                    "title": "Create a page folder",
+                    "text": "Add content/pages/<page-id>/en.json. Each configured locale gets its own lowercase locale filename."
+                  },
+                  {
+                    "title": "Set the language",
+                    "text": "Match the metadata 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 layout in the blocks array of each localized JSON page.",
+                  "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/reports/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\nedgepress doctor\nedgepress deploy\n"
+              },
+              {
+                "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": "text",
+                "paragraphs": [
+                  "You can run edgepress check before writing your first article. Markdown verification uses a built-in in-memory sample; no tutorial post or posts directory is required. Worker compatibility reads the actual main entry from Wrangler configuration.",
+                  "With Edge, Chrome or Chromium installed, the report includes headless desktop, phone and tablet profiles in light and dark modes, browser accessibility-tree checks, and a sample of Tab, Shift+Tab and Enter navigation. No visible browser or desktop screen reader is launched. Simulations do not replace physical-device or assistive-technology testing; unavailable browser checks are labeled accordingly."
+                ]
+              },
+              {
+                "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\ngit add .\ngit commit -m \"Initial EdgePress site\"\ngit branch -M main\ngit remote add origin https://github.com/<owner>/<repository>.git\ngit push -u origin main\n"
+                  },
+                  {
+                    "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 {\n  listen 80;\n  server_name example.org;\n  root /var/www/edgepress;\n  index index.html;\n\n  location / {\n    try_files $uri $uri/ $uri.html =404;\n  }\n\n  error_page 403 /403.html;\n  error_page 404 /404.html;\n}\n"
+                  },
+                  {
+                    "type": "code",
+                    "title": "Generate the upload directory",
+                    "language": "sh",
+                    "code": "edgepress generate"
+                  },
+                  {
+                    "type": "notice",
+                    "title": "Worker-only integrations",
+                    "text": "All deployments serve static output. Register optional external APIs and widgets under plugins.consent.services in config.yml; each backend manages its own private credentials and security.",
+                    "tone": "warning"
+                  }
+                ]
+              }
+            ]
+          }
+        ]
+      ]
+    },
+    {
+      "columns": 1,
+      "cells": [
+        [
+          {
+            "type": "text",
+            "heading": "Publication dates and time zones",
+            "text": "Set site.timeZone in config.yml (default Asia/Taipei). New posts include a complete timestamp with an explicit offset. Timestamps without an offset are interpreted in that configured zone, independently of the build host. Date-only articles stay calendar dates; complete timestamps are shown in the reader’s current zone. Ambiguous daylight-saving times require an explicit offset."
+          },
+          {
+            "type": "code",
+            "title": "config.yml",
+            "language": "yaml",
+            "code": "site:\n  timeZone: Asia/Taipei\n"
+          }
+        ]
+      ]
+    }
+  ]
+}

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

@@ -0,0 +1,325 @@
+{
+  "$schema": "../../../schemas/pages.schema.json",
+  "title": "快速入门",
+  "lang": "zh-CN",
+  "slug": "quick-start",
+  "description": "安装 EdgePress、创建 Markdown 文章、编辑页面元素、本地构建并打开实时预览。",
+  "blocks": [
+    {
+      "columns": 1,
+      "cells": [
+        [
+          {
+            "type": "hero",
+            "eyebrow": "从这里开始",
+            "title": "配置项目并打开实时预览。",
+            "text": "安装项目依赖后使用 edgepress 命令。本地预览会在源文件变更后自动构建，并刷新无障碍化和 agent 友好度 PDF 报告。"
+          }
+        ]
+      ]
+    },
+    {
+      "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\nnpm run build\nnpm run dev\n"
+              }
+            ]
+          }
+        ]
+      ]
+    },
+    {
+      "columns": 1,
+      "cells": [
+        [
+          {
+            "type": "section",
+            "title": "只用 Markdown 写第一篇文章",
+            "tone": "soft",
+            "blocks": [
+              {
+                "type": "text",
+                "text": "完成一次性配置后，日常写作只需 Markdown。EdgePress 会自动填写标题、日期和语言。打开命令输出的文件路径，在第二个 --- 后写正文。主题会处理文章标题、列表、目录、搜索和订阅。"
+              },
+              {
+                "type": "steps",
+                "items": [
+                  {
+                    "title": "新建文章",
+                    "text": "命令会输出新文件的路径，不会覆盖已有文章。",
+                    "command": "npm run new -- post \"我的第一篇文章\""
+                  },
+                  {
+                    "title": "写 Markdown 正文",
+                    "text": "替换示例段落。使用"
+                  },
+                  {
+                    "title": "预览并发布",
+                    "text": "写作时保持预览运行，保存文件即可刷新。发布前运行 npm run build，再使用已有部署流程。",
+                    "command": "npm run dev"
+                  }
+                ]
+              },
+              {
+                "type": "code",
+                "title": "简单的文章正文",
+                "language": "markdown",
+                "code": "这是我的第一篇文章。使用 **Markdown** 排版。\n\n## 学到的内容\n\n- 记录问题现象。\n- 说明解决方法。\n\n[项目源码](https://github.com/jsw-teams/edgepress)\n"
+              },
+              {
+                "type": "text",
+                "text": "站点配置在初次设置时完成。想调整页面设计时，再阅读下面的页面布局与主题说明；日常发文无需掌握这些开发内容。"
+              }
+            ]
+          }
+        ]
+      ]
+    },
+    {
+      "columns": 1,
+      "cells": [
+        [
+          {
+            "type": "heading",
+            "level": 2,
+            "text": "用括号看懂 Pages 的包含关系"
+          },
+          {
+            "type": "text",
+            "text": "页面（行列表）→ 行（单元格列表）→ 单元格（元素列表）。\"cells\": [[{ \"type\": \"text\", \"text\": \"Hello\" }]] 表示一行的一栏里放一个文字元素。完整 JSON 示例和字段说明见 Pages 编写指南。"
+          },
+          {
+            "type": "link-list",
+            "title": "用括号看懂 Pages 的包含关系",
+            "items": [
+              {
+                "label": "用括号看懂 Pages 的包含关系",
+                "url": "/page-authoring/"
+              }
+            ]
+          }
+        ]
+      ]
+    },
+    {
+      "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 post \"A project update\""
+                  },
+                  {
+                    "title": "创建页面目录",
+                    "text": "新建 content/pages/<page-id>/en.json。每种已配置语言都有一个小写语言文件名。"
+                  },
+                  {
+                    "title": "设置语言",
+                    "text": "元数据的 lang 值需与文件名匹配；在 edgepress.config.mjs 中启用可选语言。"
+                  }
+                ]
+              }
+            ]
+          }
+        ],
+        [
+          {
+            "type": "section",
+            "title": "编辑页面布局",
+            "blocks": [
+              {
+                "type": "text",
+                "paragraphs": [
+                  "页面没有 Markdown 文章正文。请将布局写在每个本地化 JSON 页面文件的 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/reports/page-check.pdf。截图会嵌入 PDF，生成后会清理临时文件。"
+                ]
+              },
+              {
+                "type": "code",
+                "title": "构建、检查和部署",
+                "language": "sh",
+                "code": "edgepress check\nedgepress doctor\nedgepress deploy\n"
+              },
+              {
+                "type": "text",
+                "text": "兼容性检查会读取 project-compatibility.json 和 wrangler.jsonc 中的 Node.js 基线、Worker 入口和兼容日期。部署前请查看 PDF 报告。"
+              },
+              {
+                "type": "text",
+                "paragraphs": [
+                  "第一篇文章尚未创建时，也可以运行 edgepress check。Markdown 检查使用内置的内存样例，无需发布教程文章或创建 posts 目录。Worker 兼容性检查读取 Wrangler 的实际 main 入口。",
+                  "安装 Edge、Chrome 或 Chromium 后，报告会包含无窗口的桌面、手机和平板深浅模式模拟、浏览器无障碍树检查，以及 Tab、Shift+Tab 和 Enter 键盘操作抽样。不会启动可见浏览器或桌面屏幕阅读器。模拟不能代替实体设备与辅助技术测试；浏览器检查不可用时会明确标注。"
+                ]
+              },
+              {
+                "type": "section",
+                "title": "将源代码上传到 GitHub",
+                "blocks": [
+                  {
+                    "type": "text",
+                    "paragraphs": [
+                      "在 GitHub 创建空仓库并推送 EdgePress 源代码。然后在 Cloudflare 控制台创建 Worker，并通过 Workers Builds 连接该仓库，选择 main 作为生产分支。部署前请在 wrangler.jsonc 中设置唯一的 Worker 名称。",
+                      "此仓库的 Workers Builds 设置为：根目录 /、构建命令 npm run build、部署命令 npx wrangler deploy。无需添加构建变量。构建命令会先生成 dist/，再由 Wrangler 发布 Worker；dist/ 不会提交到 Git。",
+                      "GitHub README 中的一键部署按钮会在你的 GitHub 账户创建一份新仓库副本，并在 Cloudflare 创建一个新 Worker。设置时请为目标仓库和 Worker 选择未占用的名称。如果 `edgepress` 已存在，请改用其他名称。要更新已有 Worker，请继续使用它已连接的仓库和 Workers Builds；按钮不会连接或更新已有项目。",
+                      "如果日志在克隆仓库或运行命令前一直停留在 Initializing build environment，请检查 Cloudflare Workers and Pages GitHub App 是否仍有此仓库的访问权限。重新连接仓库，或重新安装并授权该 App 后再试。还需确认所选 Cloudflare API Token 仍有效；Workers Builds 可以自动创建 Token，如果已选 Token 失效，需要在 Build 设置中替换。此阶段尚未运行项目构建命令。"
+                    ]
+                  },
+                  {
+                    "type": "code",
+                    "title": "推送源代码仓库",
+                    "language": "sh",
+                    "code": "git init\ngit add .\ngit commit -m \"Initial EdgePress site\"\ngit branch -M main\ngit remote add origin https://github.com/<owner>/<repository>.git\ngit push -u origin main\n"
+                  },
+                  {
+                    "type": "text",
+                    "text": "本地部署时，先运行 npx wrangler login 完成 Cloudflare 身份验证，再运行 edgepress deploy。该命令会生成 dist/，并依据 wrangler.jsonc 部署 Worker。"
+                  },
+                  {
+                    "type": "link-list",
+                    "title": "部署参考",
+                    "items": [
+                      {
+                        "label": "连接或重新授权 GitHub 集成",
+                        "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/"
+                      },
+                      {
+                        "label": "排查 Workers Builds",
+                        "url": "https://developers.cloudflare.com/workers/ci-cd/builds/troubleshoot/"
+                      },
+                      {
+                        "label": "一键部署按钮的工作方式",
+                        "url": "https://developers.cloudflare.com/workers/platform/deploy-buttons/"
+                      }
+                    ]
+                  }
+                ]
+              },
+              {
+                "type": "section",
+                "title": "为 OpenResty 或 Nginx 生成静态文件",
+                "blocks": [
+                  {
+                    "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 {\n  listen 80;\n  server_name example.org;\n  root /var/www/edgepress;\n  index index.html;\n\n  location / {\n    try_files $uri $uri/ $uri.html =404;\n  }\n\n  error_page 403 /403.html;\n  error_page 404 /404.html;\n}\n"
+                  },
+                  {
+                    "type": "code",
+                    "title": "生成上传目录",
+                    "language": "sh",
+                    "code": "edgepress generate"
+                  },
+                  {
+                    "type": "notice",
+                    "title": "仅 Worker 支持的集成",
+                    "text": "各平台均托管静态产物。可选外部 API 和界面在 config.yml 的 plugins.consent.services 注册，独立后端管理凭据和安全验证。",
+                    "tone": "warning"
+                  }
+                ]
+              }
+            ]
+          }
+        ]
+      ]
+    },
+    {
+      "columns": 1,
+      "cells": [
+        [
+          {
+            "type": "text",
+            "heading": "发表日期与时区",
+            "text": "在 config.yml 设置 site.timeZone，默认 Asia/Taipei。新文章生成带明确时差的完整时间；没有写时差的具体时间按此配置解释，不依赖构建机器时区。仅有年月日的文章保留日历日期，不补午夜或随读者时区变更。完整时间按读者当前时区展示，遇到夏令时重复或不存在的时间需明确填写时差。"
+          },
+          {
+            "type": "code",
+            "title": "config.yml",
+            "language": "yaml",
+            "code": "site:\n  timeZone: Asia/Taipei\n"
+          }
+        ]
+      ]
+    }
+  ]
+}