使用appledoc生成说明文档

粘贴到终端:appledoc --no-create-docset --output ~/Desktop --project-name "JenoTooles" --company-id "jeno.com" --project-company "jeno" /Users/liyongkai/Desktop/ForDream/ForDream/JenoTools

第一步:使用终端命令进行下载安装

git clone git://github.com/tomaz/appledoc.git

cd ./appledoc

sudo sh install-appledoc.sh

说明:

--no-create-docset //不生成docset类型,生成html

--output ~/Desktop  //文档生成的位置

--project-name jielindoc  //工程的名字,其实这个可以随便取,至少取成工程的名字可以知道这个文档是哪个

--project-company ZQD

--company-id com.ZQD    //公司的id

~/Desktop/JieLin6/JieLin6/Helpers/  //你要生成文档的注释类所在的文件目录,及工程目录

appledoc --project-name XXX --project-company "XXX" --company-id XXX --output /tmp/doc./Core 

      appledoc 会扫描当前路径下的所有文件,编译出的Docset默认会放

在/Users/ibireme/Library/Developer/Shared/Documentation/DocSets


路径下。你也可以用 appledoc —help 查看所有可用的参数。

其中,XXX 的内容根据具体情况填写,--output 后面接的是文档输出路径,最后一个路

          径,是需要生成文档的源代码所在路径。默认情况,在生成docset文档后,appledoc会把生成的html以及中间文件删除,然后将生 成的docset文档放置到

          xcode搜索的文档路径下。若要保存文档生成过程的中间数据比如生成的html文件,只需在上面的命令中增加以下参数即可。

    --keep-intermediate-files

2. 正确的执行命令:

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

3. appledoc --project-name DiskSizeDemo   

        --project-company "ray" 

        --company-id aaaa   

        --output ./apple

~/DeskTop/RYDemoTest/DiskSizeDemo/DiskSizeDemo/doc/

        最后一个命令需要5个参数:

      1. 工程名字

      2. 公司名字

      3. 公司ID

      4. 生成结果出书路径

      5. 扫描那个路径下的类

你可能感兴趣的:(使用appledoc生成说明文档)