完善api-doc,用eclipse生成javadoc的時候發生“編碼 GBK 的不可映射字符 ”,很是惱火。其實是字符編碼問題。
打開eclipse,project -> Generate javadoc 一項一項的選你要輸出javadoc的項目,在VM設置中加入以下代碼 -encoding utf-8 -charset utf-8
這次操作,輸出的html代碼不會發生“編碼 GBK 的不可映射字符 ”問題,而且html字符編碼都設為了UTF-8,問題徹底解決。
對應的ant target 如下
<target name="javadoc">
<echo>+---------------------------------------------------+</echo>
<echo>| Building Doc File |</echo>
<echo>+---------------------------------------------------+</echo>
<javadoc access="protected"
additionalparam="-encoding utf-8 -charset utf-8 "
author="true"
classpath="${classes.dir}"
destdir="${doc.dir}/api"
nodeprecated="false"
nodeprecatedlist="false"
noindex="false"
nonavbar="false"
notree="false"
packagenames="org.xxx.common.web.tag.go"
source="1.6"
sourcepath="${src.dir}"
splitindex="true"
use="true"
version="true"
>
<link href="http://java.sun.com/javase/6/docs/api/" />
</javadoc>
</target>