graphify 30语言本地化揭秘:README国际化如何管理 📅 发布时间:2026/8/31 9:25:11 👁 浏览次数: graphify 30语言本地化揭秘README国际化如何管理【免费下载链接】graphifyTurn any codebase, with its docs, SQL schemas, configs, and PDFs, into a queryable knowledge graph. A /graphify skill for Claude Code, Cursor, Codex, and Gemini CLI: local deterministic AST parsing, every edge explained, no vector store.项目地址: https://gitcode.com/GitHub_Trending/graph/graphifygraphify 是一个把任意代码库含文档、SQL 模式、配置与 PDF变成可查询知识图谱的开源工具也是 Claude Code、Cursor、Codex、Gemini CLI 的/graphify技能。而它最容易被忽略的一点是这套 README 文档本身完成了一次教科书级的多语言本地化——30 种语言、统一的命名规范、可折叠的语言切换导航全部以纯 Markdown 文件形式管理。 为什么 README 国际化值得研究很多开源项目的翻译是翻译完就忘文件命名随意、旧版残留、导航链接失效。graphify 的做法恰好相反它把本地化当成一个可持续维护的体系统一目录所有译文集中放在docs/translations/统一命名文件名即语言标识BCP-47统一入口主 README 顶部一处导航全局生效 翻译文件的命名规范文件名即语言代码全部 31 个译文文件都遵循同一个命名模板README.locale.md其中locale是标准 BCP-47 区域标识符文件语言说明docs/translations/README.zh-CN.md简体中文地区码CNdocs/translations/README.zh-TW.md繁體中文同语言不同地区靠地区码区分docs/translations/README.ja-JP.md日本語—docs/translations/README.fa-IR.mdفارسی波斯语—docs/translations/README.he-IL.mdעברית希伯来语目录中最大的一个文件这个命名的妙处在于不需要任何额外配置文件目录列表本身就是完整的多语言注册表。新增一门语言 新建一个符合规范的文件 在导航里加一个链接零代码改动。 语言切换导航一处定义全局可达主 README.md 顶部用 HTMLdetails折叠块实现了Read this in other languages导航README.md#L10-L14默认折叠不占用首屏空间点开即可选语言国旗 emoji 原生语言名如 Deutsch、 ภาษาไทย母语者一眼能认出自己的语言每个链接都指向docs/translations/README.locale.md的相对路径更贴心的是每个译文文件内部也带一份同款语言条见 docs/translations/README.zh-CN.md 第 3 行用户从任意语言进入都能横向跳转到其他语言或返回英文原版../../README.md。这形成了一个完整的语言互达网络不存在进了死胡同的译文。 31 门语言全景目前docs/translations/下共 31 个译文加上英文原版合计 32 种语言覆盖东亚简中、繁中、日语、韩语、越南语、泰语欧洲德、法、西、俄、葡、意、波、荷、土、乌、希伯来、希腊、捷克、瑞典、芬兰、丹麦、挪威、匈牙利、罗马尼亚中东与南亚阿拉伯语、波斯语、乌兹别克语、印地语、印尼语、菲律宾语 版本演进新旧译文如何共存对比目录内的文件可以清楚看到本地化的生长过程docs/translations/README.cs-CZ.md 77 行 ← 早期版本译文内容较短 docs/translations/README.ru-RU.md 170 行 ← 中期版本译文 docs/translations/README.uk-UA.md 592 行 ← 最新完整译文项目通过 CHANGELOG 记录每一次语言扩张与同步例如 CHANGELOG.md 中可以看到Docs: Filipino (fil-PH) README translation added (#1080)Fix: Ukrainian README translation updated to v8 — all new sections, correct badges, 31 languages (#995)Docs: Uzbek (uz-UZ) README translation (#982)这透露了两条管理规则增量式扩语言每新增一门语言都是一个独立 PR带独立编号互不阻塞按大版本同步刷新主 README 升级如 v8后旧译文会被逐一批量更新保证新增章节、徽章正确——而不是放任陈旧翻译挂着✅ 这套国际化方案值得抄作业的 3 点零基础设施没有 i18n 框架、没有 CI 校验脚本纯 Markdown 命名约定就能支撑 31 种语言维护成本极低导航与内容解耦语言切换逻辑只存在于两份语言条里正文互不干扰可审计每一次语言变更都留有 PR 编号记录谁在哪个版本翻译了什么一目了然如果你正在维护一个面向国际用户的开源项目这套docs/translations/ BCP-47 命名 双入口语言条的最小方案比引入重量级 i18n 工具更务实。想动手为 graphify 补充一门新语言的译文照着 docs/translations/ 里任意现有文件的结构与语言条格式即可起步。【免费下载链接】graphifyTurn any codebase, with its docs, SQL schemas, configs, and PDFs, into a queryable knowledge graph. A /graphify skill for Claude Code, Cursor, Codex, and Gemini CLI: local deterministic AST parsing, every edge explained, no vector store.项目地址: https://gitcode.com/GitHub_Trending/graph/graphify创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考