【发布时间】:2013-10-04 16:44:43
【问题描述】:
我们有一个社会责任项目,旨在鼓励年轻人学习移动应用程序开发。我们主要面临的主要问题是语言。我们国家的大多数年轻人都没有足够的英语知识,无法用英语搜索或学习一些东西。这就是为什么我们与全球教程/学习网站的最大区别之一是使用母语。
作为该项目在技术方面的支持者,我们回答问题、撰写博客文章并尝试帮助人们以母语学习移动应用程序开发。我在帮助人们时面临的问题之一是无法提供关于我们给出的回复的官方参考资料(以母语)。这个问题促使我考虑将整个 android sdk 文档翻译成我们的母语 :) 我知道这是一项艰巨的工作,我们可能会尝试众包我不知道但我想在这里问的只是关于实施的建议一个项目。
您将使用哪种技术,如何与最新版本的 sdk 保持同步。您认为当前的 android sdk 文档页面是完全自动生成的吗?它只是java-doc吗?如何使用 java-doc 支持多语言?还是用其他方式?
我希望问题不会因为无关而被关闭,这是一个完全技术性的问题。
谢谢大家
【问题讨论】:
-
"你认为当前的 android sdk 文档页面是完全自动生成的吗?" - 是的。 “它只是java-doc吗?” -- JavaDocs 当然是,可能使用一些自定义 doclet,这些 doclet 知道 Android 特定的注释,如
@hide。 -
如何使用 java-doc 支持多语言? 我还不知道 Android DK,但正如 CommonsWare 提到的,一个定制的 doclet。 (或 taglet)使用外部资源。背景:对于过去的 Java (SE) 项目,我做了一个 taglet,它将 HTML 和/或图像文件从其他地方导入 Javadocs。 (但这不是 IDE 可以看到的)。在您的情况下,通过指向不同的“文档文件”,例如,特定于每种语言,您可以分别构建尽可能多的 API javadoc 版本。
-
在问了这个问题后,我遇到了微软社区翻译程序,该程序旨在在社区的帮助下翻译 msdn,并提供比机器翻译内容更好的本地内容。 msdn.microsoft.com/en-us/translate
标签: android documentation translation javadoc multilingual