技术文档生成工具：appledoc

作项目通常都会要求写技术文档，特别是提供SDK或者基础组件的。若是手写这类技术文档的话，工做量比编写代码也少不了多少。好比 Java 语言自己就自带 javadoc 命令，能够从源码中抽取文档。本篇咱们看一下OC中的一个相似工具：appledoc。

1.简介

基于命令行的操做、使用方便，默认生成的文档风格和苹果的官方文档是一致的，即docset，集成到xcode中就跟苹果的官方文档如出一辙，在源码中按住option再单击就能够调出相应方法的帮助，固然也能够生成html文档。

总结一下，它具备下面这些特色：

• 它默认生成的文档风格和苹果的官方文档是一致的；
• appledoc 是用 objective-c 生成的，必要的时候调试和改动也比较方便；
• 能够生成 docset，而且集成到 Xcode 中，至关于在源码中按住 option 再单击就能够调出相应方法的帮助；
• appledoc 源码在 github 上；
• 没有特殊的注释要求，能够用 /\*\* \*/ 的格式，也能够兼容 /\*! \*/ 的格式的注释，而且生成的注释有汇总页面。

2.安装

安装很简单，按照下面的指令执行便可：

git clone git://github.com/tomaz/appledoc.git
cd appledoc
sudo sh install-appledoc.sh

3.使用

使用 appledoc 时，只须要用以下命令便可：

/*
--project-name 工程名字     
--project-company 公司名字   
--company-id 公司ID    
--output 生成结果路径
*/
appledoc --no-create-docset --output ../doc --project-name GofKit --project-company "Gof" --company-id "com.gof" .

appledoc 会扫描当前路径下的全部文件，而后生成好文档放到 doc 目录下。

简写以下所示：

appledoc -o ./doc --project-name GofKit --project-company Gof .

编译出的Docset默认会放在~/Library/Developer/Shared/Documentation/DocSets路径下。 Docset格式，其实是一个bundle，里面包含了一些xml和html。显示包内容后就能够查看和修改了。若是须要放到网站上，那单独将html部分取出来就行。 

4.参考资料 

如何将本身项目的代码文档导出为苹果样式