中文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

中文javadoc

标签：

原文地址：http://www.cnblogs.com/destim/p/5568516.html