多语言Android SDK文档

Question

我们有一个社会责任项目，旨在鼓励年轻人学习移动应用开发。我们面临的主要问题是语言。我们国家的大多数年轻人没有足够的英语知识来搜索或学习英文内容。这就是为什么我们与全球教程/学习网站最大的区别之一是使用本地语言。

作为项目技术支持者，我们回答问题，写博客文章，并试图帮助人们用他们的本地语言学习移动应用程序开发。我在帮助人们时遇到的问题之一是无法提供关于我们所给出答案的官方参考资料（以本地语言）。这个问题促使我考虑将整个Android SDK文档翻译成我们的本地语言:) 我知道这是一项巨大的任务，也许我们可以尝试众包，但我想在这里问的只是有关实施这样一个项目的建议。

你会使用什么样的技术？如何保持与sdk最新版本的同步？您是否认为当前的Android SDK文档页面是完全自动生成的？它只是Java-doc吗？如何用Java-doc或其他方式支持多种语言？

我希望问题不会被关闭，因为它是一个完全技术性的问题。

谢谢大家。

- mehmet6parmak

---

“你认为当前的Android SDK文档页面是完全自动生成的吗？”—— 是的。“它只是Java-doc吗？”—— JavaDocs肯定是，可能使用一些自定义 doclet 知道 Android 特定注释，如@hide。 - CommonsWare

值得检查一下，这里有一个链接：http://stackoverflow.com/questions/5538586/generate-localized-javadoc - Tanhan

如何使用Java-doc支持多语言？ 我还不了解Android DK，但正如CommonsWare所提到的，可以使用自定义doclet（或taglet）来使用外部资源。背景：对于以前的Java（SE）项目，我做了一个taglet，它将HTML和/或图像文件从其他地方导入到Javadocs中。（但这在IDE中是不可查看的）。 在您的情况下，通过指向不同的“doc-files”，例如，针对每种语言特定的文件，您可以分别构建许多API javadoc版本。 - eruve

在提出这个问题后，我了解到微软社区翻译计划，该计划旨在借助社区的力量翻译 MSDN，并提供比机器翻译更好的本地化内容。http://msdn.microsoft.com/en-us/translate/ - mehmet6parmak

Answer 1

有趣的问题！

我猜你不仅想要Java文档，还想要由developers.android.com提供的教程和其他一切。

我认为你应该直接向Google / Android开发人员寻求支持，例如在这里。我相信他们会喜欢这个想法，并通过给你访问保持教程更新的源来支持你。 一个独立的解决方案是实现一个developers.android.com的爬虫并自己跟踪更改。但我不知道你可以/愿意花多少精力去做这件事。

对于众包：我曾经为众包写作纠错做过一个项目，在那里我们使用了Amazon Mechanical Turk。它也被用于翻译。构建适用于众包的自定义任务并自动化整个过程非常容易。例如，他们提供了一个Java API。它需要一定的费用，但与专业翻译相比相当便宜。

只是一些建议...

- Terry