终于可以用appledoc生成html格式的doc文档了

来源:互联网 发布:丽水网络图书馆 编辑:程序博客网 时间:2024/06/05 17:27

上周五就在捣鼓这个了。已经从github下载了appledoc的源代码,也设置好路径。查看是否设置好可以使用which appledoc,安装好应该是在/usr/local/bin/appledoc里。

XCode版本5,依照github的提示添加了run script,代码拷贝的github上的,预期是生成的doc放在根目录下的help文件夹的,运行完也没在对应路径下找到help文件夹,只有一个Build Succeed。心灰意冷的。

之前尝试用终端吧,拷贝网上的代码,在项目目录里执行命令

appledoc --no-create-docset --output ~/doc --project-name "Your Project Name" --company-id "com.yourcommpany" --project-company "Your Company"

终端输出:

AppledocException: At least one directory or file name path is required


没文化的我一直以为是因为我没在对应的项目文件夹,可是后来也进到项目文件夹执行命令了,提示一致。再一遍遍去读各种英文资料啊。

今天打算改投doxgen的时候发现用法是"appledoc <option> + 项目文件夹"啊,直接在项目文件夹下,人不认啊。也怪自己偷懒,早看源代码就好了。结果费了2天时间,真够无聊的我。


正确写法:

appledoc --no-create-docset --output ~/doc --project-name "Your Project Name" --company-id "com.yourcommpany" --project-company "Your Company"  ./trunk


text in red is your project's path,absolute/relative path is ok.


附赠:

XCode 5下Build Phase添加Run Script方法。

XCode->Editor->Add Build Phase->Add Run Script Build Phase。


话痨还要说:网上那么多的教程都是XCode 4的,这个让我好找啊。

0 0