中文javadoc

大量的中文注释,其实最大的目的是想生成中文的Javadoc。但是中文注释实在太不高级了,在各种编码下还会变成乱码。本着高端大气国际化的思路,还是想把它换成英文,但是又不想放弃中文的Javadoc,怎么办呢?

stackoverflow上有个帖子,说是在源码里写两种语言的注释,然后用过css切换。还有日本人用freemarker的语法来写Javadoc的http://www.ruimo.com/howto/java/javadoc-i18n/index_en.html。但是看到代码里一堆翻译文本也挺烦的,不符合咱们无重复代码的宗旨,是吧?

又搜到一个日本人做的工具l10ndoclet。不得不说日本人这方面确实比较严谨。这个工具可以抽出代码中的Javadoc,单独保存成xml,下次直接修改这个xml即可。

javadoc -docfilessubdirs -sourcepath ./webmagic-core/src/main/java/:./webmagic-extension/src/main/java/ us.codecraft.webmagic -subpackages us.codecraft.webmagic -docletpath ~/Downloads/l10ndoclet.jar -doclet com.sun.tools.doclets.l10n.PreProcess -d /data/webmagic/doc

javadoc -docfilessubdirs -sourcepath ./webmagic-core/src/main/java/:./webmagic-extension/src/main/java/ us.codecraft.webmagic -docletpath ~/Downloads/l10ndoclet.jar -subpackages us.codecraft.webmagic -cmntpath /data/webmagic/doc -doclet com.sun.tools.doclets.l10n.PostProcess -d /data/webmagic/doc
原文地址:https://www.cnblogs.com/timssd/p/5568516.html