0

そのため、ライブラリをxcodeでビルドした後に実行されるビルドスクリプトがあり、appledocドキュメントを生成してXCodeにインストールします。

面倒なことに、これにより、すべての HTML などが、ユーザーのホーム フォルダー内の (非表示の) Library フォルダー内のあいまいなフォルダーに置かれます。

これらのドキュメントセットから HTML をコピーして、プロジェクト ディレクトリ内のフォルダーに配置できるとしたら、本当に素晴らしいことです。これは、公開する必要がある場合に、ライブラリの zip アーカイブにコピーできます。

手動で行う場合 (appledoc のヘルプ ページを見ると、これをすぐに実行できるようには見えません)、それを行うことはできますが、appledoc から最終的なディレクトリ パスを取得する方法はありますか? 私が見ることができる唯一の方法は、出力ファイルを分解してそこにあるパスを見つけることです。

助けてくれてありがとう！:)

トム

4

2 に答える 2

0

前述の@BourbonJockeyのように、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 .

これらのリンクは私を大いに助けました：

GentleBytesの設定とパラメータ
驚くべきAppleのようなドキュメント

于 2012-12-14T14:33:09.040 に答える
0

You can use an Appledoc project settings file to customize the output path (among other things) of your documentation.

Specifically, you can add this key to your AppledocSettings.plist file:

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

You can accomplish the same thing with a pile of command-line switches, but typing appledoc ~/path/project.plist is a lot cleaner.

EDIT: It seems that Gentlebytes' Appledoc documentation has vanished due to site re-org (ironic, that), so the link is currently a 404. Here is at least a simple example of the AppledocSettings.plist format, which you can add the --output key to.

于 2012-11-26T02:42:01.570 に答える