0

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

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

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

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

谢谢你的帮助！:)

汤姆

4

2 回答 2

0

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

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

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

你可以用一堆命令行开关来完成同样的事情，但打字appledoc ~/path/project.plist要干净得多。

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

于 2012-11-26T02:42:01.570 回答
0

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

  1. 将 AppledocSettings.plist 放在项目的根目录中（注意“S”大写）。
  2. “--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 设置和参数
惊人的类似 Apple 的文档

于 2012-12-14T14:33:09.040 回答