美文网首页
使用appledoc生成说明文档

使用appledoc生成说明文档

作者: 1bf235f48fa8 | 来源:发表于2021-12-06 16:38 被阅读0次

    粘贴到终端: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生成说明文档

          本文链接:https://www.haomeiwen.com/subject/hjfnxrtx.html