中文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
时间： 2024-10-15 01:26:46

中文javadoc的相关文章

在Eclipse中设置中文JavaDOC

在Eclipse中设置中文JavaDOC 转载:http://www.cnblogs.com/kay/archive/2008/05/26/1207956.html 在Eclipse中,我们常常看一些英文的JavaDoc提示或者没有相应的提示是很不习惯的,如下图所示:我们现在要把这种不习惯的提示改为中文的JavaDOC提示,首先先到http://download.java.net/jdk/jdk-api-localizations/jdk-api-zh-cn/publish/1.6.0/html

如何制作中文Javadoc包，并导入到Eclipse

原理:使用chm转换工具将chm文件转换为zip文件,导入eclipse中即可. 准备 JDK1.9 API 中文 谷歌翻译版:http://www.pc6.com/softview/SoftView_551833.html           这个也可以自己找资源 CHM反编译工具 1.0:http://www.onlinedown.net/soft/47759.htm           也可以自己找 第一步: 将反编译工具 与JDK1.9解压好 第二步: 设置好chm文件路径和存放路径,点

Eclipse中文语言包安装和设置中文

对于英语水平不好或者初学者来说使用中文开发环境可以有效提高学习效率,便于快速的学习和上手,不过对于当前的技术环境学习英语还是非常有必要的,当对Eclipse掌握到一定程度还是应该多使用英语环境来开发,以便更进一步的深入学习和了解.下面让我们来学习如何为Eclipse安装语言包和设置中文的文档. 准备 在开始所有的工作前请提前安装好Eclipse,下载地址:http://www.eclipse.org/downloads/. 语言包(和自己使用的Eclipse版本对应)下载地址:http://ww

MyEclipse 2015优化技巧

MyEclipse 2015优化速度方案仍然主要有这么几个方面:去除无需加载的模块.取消冗余的配置.去除不必要的检查.关闭更新. 第一步: 去除不需要加载的模块 一个系统20%的功能往往能够满足80%的需求,MyEclipse也不例外,我们在大多数时候只需要20%的系统功能,所以可以将一些不使用 的模块禁止加载启动.通过Windows- Preferences打开配置窗口,依次选择左侧的General--> Startup and Shutdown,这个时候在右侧就显示出了Eclipse启动时加

MyEclipse的安装和汉化过程

一. 安装和汉化 1.到FTP上下载 MyEclipseForSpring-9.1-offline-installer-windows.exe 2.将下载解压好的MyEclipse for Spring 9.1进行安装,安装时选择32bit的版本!安装完成后把[Launch MyEclipse]的勾取消掉,不要运行. 二. 汉化 一) 注意事项 1.安装目录中不要出现带空格的文件夹. 2.安装之前明确两个文件夹(文中表示为红色,请按照自己的实际情况更改)的安装地址(我的Common文件夹和MyE

WeakHashMap的一点理解

本文的大部分参考自下面这篇blog:http://hongjiang.info/java-referencequeue/ 先上图: WeakHashMap的实现是通过ReferenceQueue这个"监听器"来优雅的实现自动删除那些引用不可达的key的. 先看看ReferenceQueue在Java中的描述: Reference queues, to which registered reference objects are appended by the garbage colle

java笔记-修改javadoc为中文API信息

Eclipse 默认的Javadoc API是英文版的,修改成中文版本的API步骤为: Window-->Preference-->Java-->Installed JREs 选择已经安装好的JRE-->Edit-->JRE system libraries-->rt.jar (默认是英文版本的源代码连接和javadoc的位置信息: 源代码连接:默认使用了JDK安装文件夹中自带的src.zip文件,包含英文版本的javadoc信息 javadoc位置:指向java网站上

Eclipse中javadoc的使用以及中文乱码的解决

在使用Eclipse的时候有一个很方便使用的功能,那就是自动生成javadoc,但是在实际使用过程中发现,如果配置不当,会导致生成的doc文件中出现中文乱码. 研究后解决问题如下: 1,在项目菜单选择"生成Javadoc"命令, 或者在项目右键菜单选择导出>>>"生成Javadoc" 2,这样都会打开Javadoc向导. 配置自己javadoc.exe命令的位置,生成javadoc的对象和类型. 要选择需要输出javadoc的源码文件, 选择输出成

linux下javadoc生成文件出现中文乱码

javadoc命令的正确使用姿势 javadoc -d apidoc -windowtitle Testing -doctitle 'The API of javadoc' -header 'My class' -charset UTF-8 -author -version *.java 注意 使用-author和-version是因为javadoc默认不提取这两个信息 增加-endoing UTF-8选项可使代码文件编码也更改为UTF-8 版权声明:本文为博主原创文章,未经博主允许不得转载.