docs-l10n

项目概述

docs-l10n 项目是一个致力于将 TensorFlow 网站上的技术内容和 Jupyter 笔记本进行翻译的项目。TensorFlow 是一个广泛使用的开源机器学习框架，此项目通过翻译，使全球更多的开发者能够无障碍地访问和使用这项资源。

如何参与贡献

参与该项目的贡献者可以通过 GitLocalize 提交拉取请求和进行评审。参与者需要遵循 TensorFlow 文档贡献者指南，并签署贡献者许可协议（CLA）以便将自己的贡献合法地纳入到这个开源项目中。

签署CLA

贡献者在提交贡献之前需要检查已有的贡献者许可协议，确保其 Git 提交所用的电子邮箱已正确设置，以便贡献生效。

内容访问

在 tensorflow.org 上查看已翻译内容时，可以通过页面内的语言切换器进行选择，或者在 URL 末尾加上 ?hl=<lang> 来指定语言。如果页面没有人工翻译，部分内容可能会使用机器翻译，并且相关页面会有相应的标记。如果机器翻译效果不理想，用户可以选择切换回英语版本，并考虑通过 GitLocalize 项目提供人工翻译。

源内容管理

翻译所需的源内容汇集在多个 GitHub 代码仓库中，翻译完成后，定期发布到网站。如果发现源内容有误，建议修正提交到上游仓库，而不是直接修改翻译目录中的内容。

不翻译的内容

需要注意的是，并非 tensorflow.org 上的所有内容都会在此项目中被翻译。例如，API 参考、旧版本、图片以及某些时间敏感的章节（如安装说明）通常不翻译。这些页面在 GitLocalize 界面中会被自动过滤。

风格指南

项目中采用了 TensorFlow 文档笔记工具来确保格式和风格的一致性。贡献者需要遵循 TensorFlow 文档风格指南，以及 Google 开发者文档风格指南。

语言支持

官方语言支持由多种因素决定，包括网站流量、需求、社区支持和受众偏好等。对于不再维护的语言版本可能会被移除，而新语言的支持会在 TensorFlow 博客或推特上公布。

社区贡献

项目的社区分支包含由社区贡献的、不由团队官方支持的语言内容。这部分内容构成一个未维护的档案，如果某种语言未得到官方支持，用户可为其创建自己的开源分支。

许可证

docs-l10n 项目使用 Apache License 2.0 开源许可证。