【推荐】2019 Java 开发者跳槽指南.pdf(吐血整理) >>>
对于Doxygen以前只听别人说过,而现在使用它也是一个偶然,缘分吧。前两天看box2d的官方sdk中,发现他有用户手册却没有说明,只是留下了一个Doxygen的文件。事情告一段落,然后今天在看box2d的例子的时候发现他的函数里都有注释即对函数的使用说明,这才让我想起了Doxygen,有了它,可以轻松生成自己最喜欢的chm格式的API文档。而且网上的api文档不好找。
csdn的教程链接:http://blog.csdn.net/flyoxs/article/details/7558175
这是给大家参考的至于今天我就给大家一个例子,用doxygen生成Box2d的api文档。
先下载doxygen的向导程序doxygenwizard,然后安装,操作如下
下载地址可以到上面的csdn博客中查找网址。
file->open->box2d(你的box2d目录)/documention->选择doxygen的文件打开,随便点几个选项想发现人家已经帮你配置好了,这里我们直接生成。
run->run doxygen。等一会就会生成一堆html。这里认为html已经满足需要的就不用往下面看了。
如下图:
但是html格式不是我想要的,我需要的是一个pdf文档和chm文档所以需要进行下面的步骤:
点击wizard->output->prepared compress html(chm)
选中后在进行下面的设置:
CHMFILE为你要生成程序的目录。hhclocation即在微软网上下载的
html help workshop,在其安装目录找到hhc.exe生成即可。
最后一步可有可无:点击 expert->output lauguage->chinse,他会把api中的一些文字改为中文的,不过用处不是很大。到此手里会有一份关于box2d的chm格式文档。
来源:oschina
链接:https://my.oschina.net/u/2334725/blog/533718