大量的中文注释,其实最大的目的是想生成中文的Javadoc。但是中文注释实在太不高级了,在各种编码下还会变成乱码。本着高端大气国际化的思路,还是想把它换成英文,但是又不想放弃中文的Javadoc,怎么办呢?
上有个帖子,说是在源码里写两种语言的注释,然后用过css切换。还有日本人用freemarker的语法来写Javadoc的。但是看到代码里一堆翻译文本也挺烦的,不符合咱们无重复代码的宗旨,是吧?
又搜到一个日本人做的工具。不得不说日本人这方面确实比较严谨。这个工具可以抽出代码中的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