最近开发完成一个小接口模块,需要提供一份文档,由于注释格式遵循的是 Doxygen 的标准,所以打算自动生成一份文档(主要是为了偷懒 )。于是网上搜了一堆的教程,也走了很多弯路,折腾了几个小时,终于生成了一份比较满意的文档。所以记录一下我生成该 pdf 的整个过程,以备以后需要的时候查看。
走的弯路:一开始是在 Windows 下生成的,直接安装,有图形界面,生成 html 格式的文档很方便,但是如果想生成中文版的 PDF 文档,就很难了。所以转向 Linux 系统。
如果想在Windows下简单生成文档(非 PDF ),可以参考该篇文章
1. 环境安装
如果想生成中文 pdf 文档,必须要依赖 doxygen 生成的 Latex,然后再转成 PDF。
sudo apt-get install doxygen //安装doxygen
sudo apt-get install texlive-full // latex转pdf相关
sudo