2012-10-16 42 views
0

所以我有一個構建腳本,它在xcode中構建我的庫之後運行,它生成appledoc文檔並將其安裝到XCode中。令人討厭的是,這將所有的HTML等放入我的用戶主文件夾(隱藏)庫文件夾中的一個模糊的文件夾中。Appledoc自動將html複製到項目目錄

如果能夠從這些docset中複製HTML並將它們放到項目目錄中的文件夾中,那真的太棒了。這可以在需要發佈時複製到庫的壓縮文檔中。

如果是手動操作的情況(通過查看appledoc的幫助頁面,它看起來好像不能開箱即可)然後我可以這樣做,但是有什麼方法可以獲得最終目錄來自appledoc的路徑?我能看到的唯一方法是將輸出文件分開並在其中找到路徑。

感謝您的幫助! :)

湯姆

回答

0

您可以使用Appledoc project settings文件來定製你的文件的輸出路徑(除其他事項外)。

具體來說,您可以將此鍵添加到您的AppledocSettings.plist文件:

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

可以完成與一堆命令行開關同樣的事情,但輸入appledoc ~/path/project.plist是很多清潔。

編輯:似乎紳士的Appledoc文檔已經消失,由於網站重新組織(諷刺,那),所以目前的鏈接是404。這裏至少有一個simple example的AppledocSettings.plist格式,你可以添加--output鍵。

0

像@波旁騎師提到的,你可以使用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 Settings and parameters
Amazing Apple-like Documentation