用doxygen的好处是,代码与文档可以同步更新,并且doxygen可以生成美观的pdf文档。
由于一直没搞好中文支持就没用上,后面发现少了几个包。
测试环境:ubuntu 12.04
安装包:cjk-latex,texlive-fonts-recommended。
文档生成脚本:
#!/bin/bash
doxygen -w latex header.tex0 footer.tex0 stylesheet.tex0 Doxyfile
cat header.tex0 | awk '{print;}
/\\usepackage{doxygen}/{print("\\usepackage{CJK}")} /\\begin{document}/{print("\\begin{CJK}{UTF8}{gbsn}")}' > header.tex
sed -ie "s/Your title here/RemoteFile Reference Manual/" header.tex
cat footer.tex0 | awk '{print;}/\\printindex/{print("\\end{CJK}")}' >footer.tex
rm stylesheet.tex0
doxygen Doxyfile
pushd latex
make
mv refman.pdf ../api.pdf
popd
rm header.tex* footer.tex*
rm -rf latex
注意先配置好Doxyfile后再运行脚本,相关选项:
GENERATE_HTML = NO
GENERATE_LATEX = YES
LATEX_OUTPUT = latex
LATEX_CMD_NAME = latex
MAKEINDEX_CMD_NAME = makeindex
COMPACT_LATEX