使用doxygen生成postgis docset文档

Question

首先，很抱歉问这个愚蠢的问题，这是我第一次来这里。

我正在尝试从Dash 2生成文档集文档，并使用MacOsX (http://kapeli.com/dash/)的代码片段管理器Dash探索它。

这里有一个已经存在的http://www.postgis.org/documentation/postgis-doxygen/文档，但是我需要在我的机器上生成它。

我从http://svn.osgeo.org/postgis/下载了最后一个主干，然后运行只包含一些子目录的doxygen：

-loader -macros -postgis -raster -regress -topology

在doxygen html docs目录中运行make之后，它很好地生成了一个Postgis.docset文件。

一切都很顺利，但是文档一团糟，并且遗漏了Postgis文档中已经存在的所有注释(/doc/子文件夹)。

有人有这方面的经验吗？我是否应该排除/包含其他子文件夹，或者指向doxygen中现有的PostGis文档？

谢谢!

更新：

感谢Mike！我不能运行./configure，我不得不重新下载PostGIS代码(2.0.1)。按照Dash coder的建议更改doxygen.cfg和doxygen.cfg.in文件，make doxygen运行得很好：

GENERATE_DOCSET   = YES
SEARCHENGINE      = NO
DISABLE_INDEX     = YES
GENERATE_TREEVIEW = NO

无论如何，文档看起来很糟糕，我正在尝试生成类似于PostgreSQL文档集的东西。在下一步中，我想手动生成文档集，将html文件直接链接到.docset中的sqlite db中。我在PostGIS中生成html文档时遇到问题。

make chunked-html
make -C html/image_src images
make -C ../../../liblwgeom liblwgeom.la
make[2]: *** No rule to make target `liblwgeom.la'.  Stop.
make[1]: *** [../../../liblwgeom/.libs/liblwgeom.a] Error 2
make: *** [images] Error 2

有什么线索吗？

Answer 1

谢谢Mike的迅速回答，但我对doxygne的输出并不满意。很抱歉，我不能投票给你的答案，因为我没有足够的声誉。我最终从http://postgis.refractions.net/documentation/manual-2.0/下载了现有的文档，并创建了自己的sqlite db，将文档集中的所有内容打包在一起，正如这里http://kapeli.com/docsets/所解释的那样。我会张贴更多的细节，如果有人感兴趣。

Answer 2

您可以使用make为您构建此应用程序。此外，请确保在路径上安装了Graphviz。

在源根目录中：

./configure
cd doc
make doxygen

要构建文档的其他组件，请参阅doc/README。