0

我需要一个 PHP 项目的文档系统,并且我希望它能够将外部文档(用例、项目范围等)与从代码注释生成的文档集成。似乎 phpDocumentor 具有完全正确的功能集,但外部文档必须用 DocBook 编写,这对我们的团队来说太复杂了。

如果它在 python 中,sphinx 将非常适合这项工作(ReST 绝对比 docbook 简单)。有什么方法可以将外部 ReST 文档与从 phpdoc 中提取的文档集成在一起?我是否应该将外部文档分开(例如,将 ReST 用于外部,将 phpdoc 用于内部)?或者您对管理外部文档有更好的建议吗?

4

2 回答 2

2

您可以使用 pandoc 将 ReST 转换为 DocBook。

于 2010-01-09T23:15:37.060 回答
0

以 DocBook 样式转换 wordpress 帖子。这是示例。

http://hashfold.com/techfold/wordpress-how-to-generate-docbook-style-posts/

于 2012-01-01T22:39:34.467 回答