SuperAPI AI 工具集

mkdocs-translations

写作与研究

查看项目

更新于 10-15 21:52

技能介绍

用途:为 MkDocs 文档栈生成指定语言的翻译版本。使用前需先向用户确认目标语言及其区域代码(如 es、fr、pt-BR、ko),该代码将统一用于文件夹名、翻译内容路径和 MkDocs 配置更新。

主要能力:翻译 docs/docs/en 与 docs/docs/includes/en 下的所有文件,保持原有文件夹结构与 Markdown 格式(标题、代码块、元数据、链接),保留原文件名,并在每个文件末尾追加“Translated using GitHub Copilot and GPT-4o.”。同时更新 include 引用路径(如 includes/en/introduction-event.md 改为 includes/es/introduction-event.md),并在 mkdocs.yml 的 i18n 插件下新增目标语言条目,提供 nav_translations 与 admonition_translations 的对应翻译。

使用方式:先列出两个 en 目录下的全部文件与子目录,按顺序逐个翻译,不跳过、不重排、不中途停止;每完成一个文件后自动继续下一个,无需用户确认。开始创建新文件前,先用终端命令 git checkout -b docs-translation-<language> 新建分支。在 docs/docs/ 下按语言代码新建文件夹,镜像原 en 目录结构,将译文保存到对应目标语言文件夹。完成后核对已翻译文件数与源文件数是否一致,若有遗漏则从断点继续。

翻译规则:使用准确、清晰、技术性恰当的译文,采用计算机行业标准术语(例如优先使用“Stack Tecnológica”而非“Pila Tecnológica”)。不要评论、建议修改或尝试修复任何格式或 Markdown lint 问题(如标题或列表周围缺少空行、标题末尾标点、图片缺少 alt 文本、标题层级不当、行长度或间距问题),也不要就此类问题询问用户。不要将译文或文件包裹在 Markdown 代码块中。

限制:资料未提供该技能的具体安装方式、收费模式、支持平台及翻译质量保证等信息。