0

首先对不起愚蠢的问题，这是我第一次来这里。

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

这里有一个现有的 doxygen 文档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 文档？

谢谢！

更新：

感谢迈克！我无法运行./configure，我不得不重新下载 PostGIS 代码（2.0.1）。按照Dash 编码器的建议，make doxygen更改doxygen.cfg和文件运行良好：doxygen.cfg.in

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

无论如何，文档看起来很糟糕，我试图生成类似 PostgreSQL 文档集的东西。在下一步中，我想手动生成 docset，将 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

任何线索？

4

2 回答 2

1

感谢 Mike 的及时回答，但我对 doxygne 的输出不满意。对不起，我不能投票给你的答案，因为我没有足够的声誉。我最终从http://postgis.refractions.net/documentation/manual-2.0/下载了现有文档，并手动创建了 sqlite db，将所有内容打包在 docset 中，如此处所述http://kapeli.com/文档集/。如果有人感兴趣，我会发布更多详细信息。

于 2012-08-30T17:47:20.737 回答
0

您可以使用make它为您构建它。此外，请确保您在 PATH 上安装了Graphviz 。

从源根：

./configure
cd doc
make doxygen

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

于 2012-08-27T19:40:56.183 回答