Questions tagged «appledoc»

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类引用如何链接到链接的页面。 易于运行的命令行命令,可以集成到构建脚本中 优雅地处理非常大的代码库 根据以上所有信息,上述任何解决方案是否明显优于其他解决方案?任何建议或补充信息将不胜感激。
By using our site, you acknowledge that you have read and understand our Cookie Policy and Privacy Policy.
Licensed under cc by-sa 3.0 with attribution required.