如何翻译、生成一份JDK 8 SourceCode API文档的说明 有更新!

    我在话题:如何翻译一份Java8中文帮助文档中提到过要做这样一件事情,当时应者寥寥无几,现将目前的做法与大家分享。

    背景:要把jdk源码 api翻译成中文,有两种思路。一是直接下载官方api文档,在Html中直接将api翻译为中文;二是在源码中进行翻译,可以边熟悉源码边翻译,翻译完后编译源码,生成api文档。前者,获取简单,但由于夹杂了各种标签,翻译的时候麻烦多多,易错。后者,则要费一些功夫编译源码。

    一、在Eclipse中,新建Java项目,以我本机为例,在新建的时候选定库文件为1.8u65的JDK版本,点击确定。

    二、在JDK目录下,找到src.zip。

    三、src解压到新建Java项目的src目录之下。

    四、只留下"java","javax","org"目录,其余目录干扰Java源码编译,且用不到,删除。

    五、此时,"build"一下,1.8u65版本为例,"problems"选项卡内,还有一个编译错误,定位到错误,将相应的语句注释。注释后,没有编译错误,就可以翻译了。

    六、保存,重新编译,没有错误。在首选项中找到Java->Compiler,将compiliance Lever设置为1.8,确定保存。

    七、右键工程,选"export"->"Java doc"。

    八、选定"Javadoc Command",javadoc存放目录(默认为项目根目录的doc目录),点击完成。

    生成后的api文档如下:

    2016-07-01更新: 项目已经开始了,主页: https://github.com/Java8-CNAPI-Team/Java8CN 如果您有兴趣或疑问,可联系我:QQ475296958

    该文章同步自 B3log 社区

    validate