Documentation restructure: - New docs/getting-started/ guide (4 files: install, quick-start, first-skill, next-steps) - New docs/user-guide/ section (6 files: core concepts through troubleshooting) - New docs/reference/ section (CLI_REFERENCE, CONFIG_FORMAT, ENVIRONMENT_VARIABLES, MCP_REFERENCE) - New docs/advanced/ section (custom-workflows, mcp-server, multi-source) - New docs/ARCHITECTURE.md - system architecture overview - Archived legacy files (QUICKSTART.md, QUICK_REFERENCE.md, docs/guides/USAGE.md) to docs/archive/legacy/ Chinese (zh-CN) translations: - Full zh-CN mirror of all user-facing docs (getting-started, user-guide, reference, advanced) - GitHub Actions workflow for translation sync (.github/workflows/translate-docs.yml) - Translation sync checker script (scripts/check_translation_sync.sh) - Translation helper script (scripts/translate_doc.py) Content updates: - CHANGELOG.md: [Unreleased] → [3.1.0] - 2026-02-22 - README.md: updated with new doc structure links - AGENTS.md: updated agent documentation - docs/features/UNIFIED_SCRAPING.md: updated for unified scraper workflow JSON config Analysis/planning artifacts (kept for reference): - DOCUMENTATION_OVERHAUL_PLAN.md, DOCUMENTATION_OVERHAUL_SUMMARY.md - FEATURE_GAP_ANALYSIS.md, IMPLEMENTATION_GAPS_ANALYSIS.md, CREATE_COMMAND_COVERAGE_ANALYSIS.md - CHINESE_TRANSLATION_IMPLEMENTATION_SUMMARY.md, ISSUE_260_UPDATE.md Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
6.5 KiB
6.5 KiB
🇨🇳 中文文档翻译 - 招募社区志愿者 / Chinese Documentation Translation - Call for Volunteers
📢 项目介绍 / Project Introduction
我们正在将 Skill Seekers 文档翻译成简体中文,需要社区志愿者参与审阅!
We're translating Skill Seekers documentation to Simplified Chinese and need community volunteers to help review!
🎯 目标 / Goal
将 18 份文档翻译成简体中文,并保持与英文版本同步。
Translate 18 documentation files to Simplified Chinese and keep them in sync with English versions.
📁 翻译范围 / Translation Scope
| 优先级 | 类别 | 文件数 | 状态 |
|---|---|---|---|
| P0 | 入门指南 | 4 | 🔍 待审阅 |
| P1 | 用户指南 | 6 | 🔍 待审阅 |
| P2 | 参考文档 | 4 | 🔍 待审阅 |
| P3 | 高级主题 | 4 | 🔍 待审阅 |
总计:18 个文件
🤝 如何参与 / How to Participate
方式 1:审阅自动翻译(推荐)/ Option 1: Review Auto-Translations (Recommended)
- 查看 PR - 我们会自动创建包含中文翻译的 PR
- 阅读审阅 - 检查中文翻译的准确性和流畅性
- 提出修改 - 在 PR 中评论建议的修改
- 批准合并 - 确认无误后批准
方式 2:直接翻译 / Option 2: Direct Translation
- 认领文件 - 在下方评论认领要翻译的文件
- 基于原文 - 使用英文原文进行翻译
- 遵循标准 - 遵循下方的翻译标准
- 提交 PR - 提交翻译好的文档
📋 待审阅文件清单 / Files Pending Review
入门指南 / Getting Started (P0)
| 文件 | 自动翻译 | 认领人 | 状态 |
|---|---|---|---|
| README.md | ✅ | - | 🔍 待审阅 |
| getting-started/01-installation.md | ✅ | - | 🔍 待审阅 |
| getting-started/02-quick-start.md | ✅ | - | 🔍 待审阅 |
| getting-started/03-your-first-skill.md | ✅ | - | 🔍 待审阅 |
| getting-started/04-next-steps.md | ✅ | - | 🔍 待审阅 |
用户指南 / User Guide (P1)
| 文件 | 自动翻译 | 认领人 | 状态 |
|---|---|---|---|
| user-guide/01-core-concepts.md | ✅ | - | 🔍 待审阅 |
| user-guide/02-scraping.md | ✅ | - | 🔍 待审阅 |
| user-guide/03-enhancement.md | ✅ | - | 🔍 待审阅 |
| user-guide/04-packaging.md | ✅ | - | 🔍 待审阅 |
| user-guide/05-workflows.md | ✅ | - | 🔍 待审阅 |
| user-guide/06-troubleshooting.md | ✅ | - | 🔍 待审阅 |
参考文档 / Reference (P2)
| 文件 | 自动翻译 | 认领人 | 状态 |
|---|---|---|---|
| reference/CLI_REFERENCE.md | ✅ | - | 🔍 待审阅 |
| reference/MCP_REFERENCE.md | ✅ | - | 🔍 待审阅 |
| reference/CONFIG_FORMAT.md | ✅ | - | 🔍 待审阅 |
| reference/ENVIRONMENT_VARIABLES.md | ✅ | - | 🔍 待审阅 |
高级主题 / Advanced (P3)
| 文件 | 自动翻译 | 认领人 | 状态 |
|---|---|---|---|
| advanced/mcp-server.md | ✅ | - | 🔍 待审阅 |
| advanced/mcp-tools.md | ✅ | - | 🔍 待审阅 |
| advanced/custom-workflows.md | ✅ | - | 🔍 待审阅 |
| advanced/multi-source.md | ✅ | - | 🔍 待审阅 |
状态说明:
- 🔍 待审阅 / Pending review
- 🔄 审阅中 / In review
- ✅ 已完成 / Completed
📝 翻译标准 / Translation Standards
技术术语 / Technical Terms
保持英文的术语 / Keep in English:
| 术语 | 说明 |
|---|---|
| CLI | 命令行界面 |
| API | 应用程序接口 |
| JSON | - |
| YAML | - |
| MCP | Model Context Protocol |
| URL | - |
| HTTP | - |
| skill | 第一次出现用"技能 (skill)",之后用"技能" |
| workflow | 第一次出现用"工作流 (workflow)",之后用"工作流" |
| scraper | 第一次出现用"抓取器 (scraper)",之后用"抓取器" |
代码示例 / Code Examples
保持原样 - 所有代码示例、命令和文件路径保持英文:
# 中文文档中仍然显示:
pip install skill-seekers
skill-seekers create https://docs.django.com/
链接 / Links
内部链接指向中文版本:
<!-- 英文 -->
See [Installation Guide](01-installation.md)
<!-- 中文 -->
参见 [安装指南](01-installation.md)
格式 / Formatting
- 保留所有 Markdown 格式
- 保留所有代码块
- 保留所有表格
- 保留所有列表
🏆 贡献奖励 / Rewards
- README 致谢 - 在 README 中感谢所有贡献者
- 优先测试 - 优先获得新版本测试权限
- 社区徽章 - 获得社区贡献者徽章 🏅
- GitHub Profile - 在 GitHub 个人资料中展示贡献
📚 相关资源 / Resources
- 翻译计划详情: DOCUMENTATION_CHINESE_TRANSLATION_PLAN.md
- 中文文档入口: docs/zh-CN/README.md
- 英文原文: docs/README.md
💬 如何认领 / How to Claim
在此 Issue 下评论:
我想审阅:getting-started/02-quick-start.md
或
I want to review: user-guide/03-enhancement.md
🔔 自动更新通知 / Auto-Update Notifications
当英文文档更新时,GitHub Actions 会自动:
- 翻译变更内容
- 创建 PR
- 在此 Issue 中通知
When English docs are updated, GitHub Actions will automatically:
- Translate the changes
- Create a PR
- Notify in this Issue
📞 联系方式 / Contact
有问题?在此 Issue 下评论或联系:
Questions? Comment on this issue or contact:
- GitHub Issues: https://github.com/yusufkaraaslan/Skill_Seekers/issues
让我们一起打造完美的中文文档!
Let's build perfect Chinese documentation together!
🚀🌐🇨🇳