在CentOS上装javadoc

刚来实习单位没多久，老大让我在服务器上装一个javadoc，可以把他们每天上传到svn服务器上的代码用javadoc显示出来，然后用web页面登陆查看，大家都一目了然。因为以前对这块一点都没有，所有的工作还是从百度和Google开始。

首先，在网上找到最多的javadoc的信息是在eclipse里面带有javadoc的插件，这个对我没有任何帮助，因为给的任务是只有svn代码库里面的代码，然后提取出文档。继续查资料，看到了关于javadoc命令的解释，稍微有点眉目了。

javadoc -d (要放的地址，如果没有需要提前新建） -sourcepath (源地址,一般最后是/src） -subpackages (src下最大的包名，javadoc后生成包名下所有的文档） -author -version(源代码作者和版本，写不写都行)

以此为思路，首先找到源代码。因为svn代码库的代码以一种特殊形式存放（数据库好像，未深究）是直接查看不到的，所以要先checkout出来。放到哪里呢？因为老大是想把文档放到网页上，要与tomcat相连（本服务器用的是tomcat5）为了图省事，我就直接把javadoc后的html文件放到了tomcat的webapps下面。所以就得出了javadoc命令行

javadoc -d /usr/share/tomcat5/webapps/xxx -sourcepath /home/XXX/svn/XXX/src -subpackages xxx -author -version

由于要求的是每天都要更新，所以我做了个shell脚本，每天执行的是1先删掉所有文件，2再重新建立新文件，3把svn代码库里的代码checkout出来4，javadoc出html文件放在tomcat的webapps里面5启动tomcat服务（可要可不要）6可在任意可以访问的主机上输入网址http：//xxx.xxx.xxx.xxx(服务器的网址):8080/XXX(代码库)即可。脚本代码如下，存放在自定义文件夹里。

编写完shell脚本了，为了定时，进入cron中，添加命令，使之自动运行。

所有代码如下：

以上为shell脚本，放在~/zhangyl里面，脚本名字叫javadoc_am这个自己定。

30 8 * * * bash /root/zhangyl/javadoc_am

这个是在/var/spool/cron中编写的，意思是在每天早上八点半执行脚本操作。

OK，我的工作笔记就是这些。不过中间也会遇到一些问题，比如亘古不变的中文乱码问题，这个大致的思路都差不多是变IOS之类的，但各有不同吧，可自行解决，也可以像我一样偷懒不解决。OVER

date:9.11

今天我把root用户改为一般用户zhyl，

useradd -d /usr/zhyl -m zhyl

出现了checkout不出来的情况，查出问题

# 进入需要重置权限的目录
cd /PATH/TO/MY/PROJECT

# 重置ownership
# NOTE: replace zhyl（用户名.用户组） with your user and group
sudo find . -exec chown zhyl {} \;

# 重置permissions
# NOTE: replace 2770 with your file permissions
sudo find . -exec chmod 2770 {} \;

# Now you can run the cleanup command to repair your .svn folders
svn cleanup

然后checkout的东西都在/usr/zhyl下面，所以shell脚本也有相应的调整。

不过有个问题，我编的javadoc里面中文注释都是乱码，怎么解决啊？？？？知道是改文字配置，但不知道在哪里修改

date：12.04

其实现在想想，乱码的问题无非就是两种情况，一是在javadoc的时候encoding 和 charset的问题，编码方式有GBK,UTF-8,GB2301等等形式，这方面要先确定；二是我要呈现在什么页面上面。如我做的trac，用的的是Python语言，gbk编码呈现，那charset的时候就应该是gbk。总之，编码和网页的配置要统一。当我在编shell脚本的时候无论怎么组合encoding和charset都不行的情况下，可以试着在网页配置上下功夫，config文件里面会有这一项的。个人理解~^_^