From fb7d8cf1ebb486147598c3d6e42d6a655eb87a2f Mon Sep 17 00:00:00 2001 From: wehub-skill-sync Date: Mon, 13 Jul 2026 21:35:48 +0800 Subject: [PATCH] chore: import zh skill docs-page --- README.wehub.md | 9 +++++++ SKILL.md | 64 +++++++++++++++++++++++++++++++++++++++++++++++++ example.html | 10 ++++++++ 3 files changed, 83 insertions(+) create mode 100644 README.wehub.md create mode 100644 SKILL.md create mode 100644 example.html diff --git a/README.wehub.md b/README.wehub.md new file mode 100644 index 0000000..0e5d717 --- /dev/null +++ b/README.wehub.md @@ -0,0 +1,9 @@ +# WeHub 来源说明 + +- Skill 名称：`docs-page` +- 中文类目：文档/指南/电子书 editorial +- 上游仓库：`nexu-io__open-design` +- 上游路径：`design-templates/docs-page/SKILL.md` +- 上游链接：https://github.com/nexu-io/open-design/blob/HEAD/design-templates/docs-page/SKILL.md +- 本仓库为 WeHub 中文 Skill 汉化包，基于 skill 市场筛选 Top200 清单整理 +- 原作者、版权和许可证信息以上游仓库为准 diff --git a/SKILL.md b/SKILL.md new file mode 100644 index 0000000..1116085 --- /dev/null +++ b/SKILL.md @@ -0,0 +1,64 @@ +--- +name: docs-page +description: | + 一个文档页面——内联起始导航、可滚动的文章正文、 + 内联结尾目录。当需求中提到"docs"、"documentation"、"guide"、"API reference" 或 "tutorial" 时使用。 +triggers: + - "docs" + - "documentation" + - "guide" + - "tutorial" + - "api reference" + - "文档" +od: + mode: prototype + platform: desktop + scenario: engineering + preview: + type: html + entry: index.html + design_system: + requires: true + sections: [color, typography, layout, components] + craft: + requires: [typography, typography-hierarchy, typography-hierarchy-editorial, rtl-and-bidi] +--- + +# 文档页面技能 + +在单个 HTML 文件中生成一个三栏文档页面。 + +## 工作流程 + +1. **阅读活跃的 DESIGN.md**（已注入上方）。正文使用 body 类型 token；代码使用 mono token；遵守行高和最大宽度规则。 +2. **从需求中选取一个主题**——页面看起来应该像真实的文档，而非通用线框图。包含具体的 API 名称、命令示例、合理的参数。 +3. **布局三个区域**，在内联轴上表达，以便布局在 `dir="rtl"` 下正确翻转： + - **内联起始导航**（240–280px，sticky）：分组的链接列表，当前页面加粗，并在 `inline-start` 边缘显示强调色条纹。3–5 组，每组 4–8 个链接。 + - **文章正文**（最大宽度约 720px，在中间列居中）：H1、引导段落、H2 章节、代码块、提示框（注意/警告）、内联链接、列表。 + - **内联结尾目录**（200–240px，sticky）：「本页内容」包含 H2/H3 锚点，当前章节随用户滚动高亮。 +4. **编写**单个 HTML 文档： + - `` 到 ``，所有 CSS 内联。 + - 三列布局使用 CSS Grid；侧栏使用 sticky 定位。 + - 代码块：mono token、柔和底色填充、复制按钮示意（仅视觉——无需 JS）。 + - 每个 H2/H3 都带有锚点 ID，以便目录链接生效。 + - 在导航、文章和目录上添加 `data-od-id`。 +5. **正文**：撰写至少 350 词的可信文档。至少包含一条 shell 命令、一段代码片段（5–15 行）、一个提示框、一个表格。 +6. **自我检查**： + - 正文文本在设计系统的最佳行长处换行（60–75 字符）。 + - 代码使用设计系统的 mono token，而非通用的 `monospace`。 + - 强调色克制使用——仅用于当前导航项、链接、一个提示框边框。不用于正文。 + - 页面在 1280w 下可读，在 900w 以下优雅折叠（目录消失，导航变为顶部抽屉）。 + - 在侧栏和强调色条纹上使用逻辑 CSS（`margin-inline-start`、`border-inline-start`、`inset-inline-end`、`text-align: start`），以便布局在 `dir="rtl"` 下正确翻转。 + +## 输出契约 + +在 `` 标签之间输出： + +``` + + +... + +``` + +artifact 前保留一句话描述，之后不跟任何内容。 diff --git a/example.html b/example.html new file mode 100644 index 0000000..b80a80d --- /dev/null +++ b/example.html @@ -0,0 +1,10 @@ +翻译完成。文件已保存为 `index.html`。主要翻译要点： + +- **`lang="en"` → `lang="zh-CN"`**：语言属性已更新 +- **所有可见文本**已逐句翻译为简体中文（标题、导航、正文、提示框、翻页按钮等） +- **`