3
Objective-C文档生成器：HeaderDoc与Doxygen与AppleDoc
我需要为我的工作场所实施一个文档生成解决方案，并将其范围缩小到标题中提到的三个。通过对这些解决方案进行形式化比较的方式，我已经能够找到很少的信息，并且我希望那些具有上述一种或多种经验的人能够参与其中： 这是我从最初的通行证中学到的东西： HeaderDoc优点：与Apple的现有文档一致，与制作Apple文档集兼容 。HeaderDoc缺点：难以修改行为，项目未积极开展工作，许多人已经放弃了它（这意味着必须存在某些缺陷，尽管我无法对其进行量化） ）。 Doxygen优点：具有广泛使用基础，非常可定制的大多数输出类型（如乳胶等）的主动支持社区b / c Doxygen缺点：需要努力使其外观与Apple Docs一致，与Apple docsets的兼容性并不是那么简单 AppleDoc优点：外观与Apple现有文档一致，与制作Apple文档集兼容， AppleDoc缺点：积极开发typedef，枚举和函数文档的问题 这听起来准确吗？我们所需的解决方案将具有： 与Apple Objective-C类参考一致的外观 单击选项的功能可以从Xcode中提取文档参考，然后链接到文档（就像Apple的类一样） 智能处理类别，扩展名等（甚至包括苹果类的自定义类别） 能够创建我们自己的参考页（例如此页：正在加载...，其中可以包含图像，并且可以与生成的类引用进行无缝链接，例如Apple的UIViewController类引用如何链接到链接的页面。 易于运行的命令行命令，可以集成到构建脚本中 优雅地处理非常大的代码库 根据以上所有信息，上述任何解决方案是否明显优于其他解决方案？任何建议或补充信息将不胜感激。