appledoc,方便的程序文档编写工具
2015-11-17 15:57
309 查看
appledoc是自动化文档生成工具,推荐大家使用
它默认生成的文档风格和苹果的官方文档是一致的,安装使用后,可以直接在Xcode中查看。
appledoc 就是用 objective-c 生成的,必要的时候调试和改动也比较方便。
可以生成 docset,并且集成到 Xcode 中。这一点做的非常好,相当于在源码中按住 option 再单击就可以调出相应方法的帮助。
它没有特殊的注释要求,可以用 /** */ 的格式,也可以兼容 /*! */ 的格式的注释,并且生成的注释有汇总页面。
安装
那么简单介绍一下如何安装 appledoc,安装非常简单,只需要 2 步:
使用
使用 appledoc 时,只需要用如下命令即可:
appledoc 会扫描当前路径下的所有文件,然后生成好文档放到 doc 目录下。你也可以用 appledoc —help 查看所有可用的参数。
详细的信息可以查看官方的文档:http://gentlebytes.com/appledoc/
它默认生成的文档风格和苹果的官方文档是一致的,安装使用后,可以直接在Xcode中查看。
appledoc 就是用 objective-c 生成的,必要的时候调试和改动也比较方便。
可以生成 docset,并且集成到 Xcode 中。这一点做的非常好,相当于在源码中按住 option 再单击就可以调出相应方法的帮助。
它没有特殊的注释要求,可以用 /** */ 的格式,也可以兼容 /*! */ 的格式的注释,并且生成的注释有汇总页面。
安装
那么简单介绍一下如何安装 appledoc,安装非常简单,只需要 2 步:
1 2 3 | git clone git://github.com/tomaz/appledoc.git cd appledoc sudo sh install-appledoc.sh |
使用 appledoc 时,只需要用如下命令即可:
appledoc -o ./doc --project-name ynote --project-company youdao . 常用的命令PATHS -o, --output <path> Output path -t, --templates <path> Template files path --docset-install-path <path> DocSet installation path -s, --include <path> Include static doc(s) at path -i, --ignore <path> Ignore given path -x, --exclude-output <path> Exclude given path from output --index-desc <path> File including main index description PROJECT INFO -p, --project-name <string> Project name -v, --project-version <string> Project version -c, --project-company <string> Project company --company-id <string> Company UTI (i.e. reverse DNS name) OUTPUT GENERATION -h, --create-html [b] Create HTML -d, --create-docset [b] Create documentation set -n, --install-docset [b] Install documentation set to Xcode -u, --publish-docset [b] Prepare DocSet for publishing --html-anchors <string> [*] The html anchor format to use in DocSet HTML. --clean-output [b] Remove contents of output path bef |
详细的信息可以查看官方的文档:http://gentlebytes.com/appledoc/
相关文章推荐
- 峰回路转,Firefox 浏览器即将重返 iOS 平台
- 峰回路转,Firefox 浏览器即将重返 iOS 平台
- 不可修补的 iOS 漏洞可能导致 iPhone 4s 到 iPhone X 永久越狱
- iOS 12.4 系统遭黑客破解,漏洞危及数百万用户
- 每日安全资讯:NSO,一家专业入侵 iPhone 的神秘公司
- [转][源代码]Comex公布JailbreakMe 3.0源代码
- 讲解iOS开发中基本的定位功能实现
- js判断客户端是iOS还是Android等移动终端的方法
- IOS开发环境windows化攻略
- 检测iOS设备是否越狱的方法
- .net平台推送ios消息的实现方法
- 探讨Android与iOS,我们将何去何从?
- Android、iOS和Windows Phone中的推送技术详解
- IOS 改变键盘颜色代码
- 举例详解iOS开发过程中的沙盒机制与文件
- Android和IOS的浏览器中检测是否安装某个客户端的方法
- 分享一个iOS下实现基本绘画板功能的简单方法
- javascript实现阻止iOS APP中的链接打开Safari浏览器
- IOS中内存管理那些事