Tag: headerdoc

Objective-C文档生成器:HeaderDoc与Doxygen vs. AppleDoc

我需要为我的工作场所实施文档生成解决scheme,并缩小到标题中提到的三个解决scheme。 在这些解决scheme之间的forms化比较中,我能够find很less的信息,我希望那些有上述经验的人能够衡量: 这是我从最初的传球中能够收集到的东西: HeaderDoc优点:与苹果现有的文档一致,与制作苹果docset的兼容性 HeaderDoc缺点:很难修改行为,项目并没有积极的工作,很多人已经离开了它(这意味着一定有什么不足,尽pipe我无法量化)。 Doxygen优点:积极支持社区B / C广泛的使用基地,非常可定制的,多数输出types(如乳胶等) Doxygen缺点:使其看起来/行为与苹果文档一致,与苹果docsets的兼容性不是那么简单 AppleDoc优点:看起来与苹果现有的文档一致,与制作苹果docsets的兼容性, AppleDoc缺点:正在积极开发typedefs,枚举和函数的文档 这听起来准确吗? 我们期望的解决scheme将有: 一致的外观和感觉与苹果objective-c类参考 能够select单击从Xcode中提取文档参考,然后链接到文档(就像苹果的类) 智能处理类别,扩展名等(甚至是苹果类的自定义类别) 能够创build我们自己的参考页面(就像这个页面:加载…可以包括图像,并可以从生成的类引用无缝链接,如苹果的UIViewController类引用链接到链接的页面。 易于运行可集成到构build脚本中的命令行命令 优美的处理非常大的代码库 基于以上所有的信息,上面的解决scheme是否明显比其他解决scheme好? 任何build议或信息添加将非常感激。