Appledoc 自动复制 html 到项目目录答案

【问题标题】：Appledoc automatically copy html to project directoryAppledoc 自动复制 html 到项目目录
【发布时间】：2012-10-16 15:11:21
【问题描述】：

所以我有一个构建脚本，它在 xcode 中构建我的库后运行，它生成 appledoc 文档并将其安装到 XCode 中。

令人讨厌的是，这会将所有 HTML 等放入我的用户主文件夹（隐藏）库文件夹中的一个不起眼的文件夹中。

真正棒的是能够从这些文档集中复制 HTML 并将它们放入项目目录中的文件夹中。然后可以在需要发布时将其复制到库的压缩存档中。

如果是手动执行的情况（查看appledoc的帮助页面，它似乎无法立即执行此操作），那么我可以这样做，但是有没有办法获得最终的目录路径来自苹果文档？我能看到的唯一方法是拆开输出文件并在其中找到路径。

感谢您的帮助！ :)

汤姆

【问题讨论】：

标签： ios appledoc

【解决方案1】：

就像@Bourbon Jockey 提到的那样，您可以使用 plist 文件。但是，它对我的工作方式略有不同：

将 AppledocSettings.plist 放在项目的根目录中（注意“S”大写）。
“--output”不一定需要在数组中。以下是对我有用的示例：

    <?xml version="1.0" encoding="UTF-8"?>
    <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
    <plist version="1.0">
    <dict>
          <key>--project-name</key>  
          <string>The New Achiever</string>

          <key>--project-company</key>  
          <string>NHOC</string> 

          <key>--company-id</key>  
          <string>com.nhoc</string>

          <key>--ignore</key>
          <array>
              <string>*.m</string>
          </array>

          <key>--output</key>
          <string>/Users/Fernando/Documents/Projetos/Software/Achiever/Help</string>

          <key>--keep-intermediate-files</key>  
          <true/>
    </dict>
    </plist>

运行：

appledoc .

这些链接对我帮助很大：

Gentle Bytes Settings and parameters
Amazing Apple-like Documentation

【讨论】：

【解决方案2】：

您可以使用 Appledoc project settings 文件来自定义文档的输出路径（以及其他内容）。

具体来说，您可以将此密钥添加到您的 AppledocSettings.plist 文件中：

<key>--output</key>
<array>
    <string>Documentation/</string>
</array>

你可以用一堆命令行开关来完成同样的事情，但是输入appledoc ~/path/project.plist 会更简洁。

编辑：似乎 Gentlebytes 的 Appledoc 文档由于站点重组（具有讽刺意味）而消失了，因此该链接当前是 404。这里至少是 AppledocSettings.plist 格式的simple example，它您可以添加--output 键。

【讨论】：