2013-07-29 58 views
0

我從來沒有使用PHPDoc的面前,但是我想Authorize.Net PHP SDK文檔,似乎我需要PHPDoc的生成它們。PHPDoc的產生與斷開的鏈接文檔和格式

當我運行:

C:\Users\Owner\PhpstormProjects\CRM\anet_php_sdk>C:\Users\Owner\wamp\bin\php\php5.3.13\phpdoc -t phpdocs/ -d lib 

我得到「分析文件」和「否摘要方法」的流,我認爲是好的。對象方法和參數列表就足夠了,即使沒有描述性總結。

它結束了與此:

Storing cache in "C:\Users\Owner\PhpstormProjects\CRM\anet_php_sdk\phpdocs" .. O K 
Load cache               .. 0.091 s 
Preparing template "responsive-twig"         .. 0.168 s 
Preparing 15 transformations           .. 0.000 s 
Build "elements" index            .. 0.017 s 
Replace textual FQCNs with object aliases       .. 0.214 s 
Build "packages" index            .. 0.025 s 
Build "namespaces" index and add namespaces to "elements"   .. 0.006 s 
Transform analyzed project into artifacts       .. 6.702 s 
Analyze results and write report to log        .. 0.005 s 

C:\Users\Owner\PhpstormProjects\CRM\anet_php_sdk> 

我估計也就是確定。

的輸出目錄結構是這樣的:

Directory of C:\Users\Owner\PhpstormProjects\CRM\anet_php_sdk\phpdocs 

07/29/2013 03:20 PM <DIR>   . 
07/29/2013 03:20 PM <DIR>   .. 
07/29/2013 03:20 PM <DIR>   classes 
07/29/2013 03:20 PM   16,344 classes.svg 
07/29/2013 03:20 PM <DIR>   css 
07/29/2013 03:20 PM    5,713 deprecated.html 
07/29/2013 03:20 PM   100,054 errors.html 
07/29/2013 03:20 PM    5,717 graph_class.html 
07/29/2013 03:20 PM <DIR>   img 
07/29/2013 03:20 PM    7,528 index.html 
07/29/2013 03:20 PM <DIR>   js 
07/29/2013 03:20 PM    6,900 markers.html 
07/29/2013 03:20 PM <DIR>   namespaces 
07/29/2013 03:20 PM <DIR>   packages 
07/29/2013 03:20 PM <DIR>   phpdoc-cache-08 
07/29/2013 03:20 PM <DIR>   phpdoc-cache-2b 
07/29/2013 03:20 PM <DIR>   phpdoc-cache-2e 
07/29/2013 03:20 PM <DIR>   phpdoc-cache-48 
07/29/2013 03:20 PM <DIR>   phpdoc-cache-4f 
07/29/2013 03:20 PM <DIR>   phpdoc-cache-62 
07/29/2013 03:20 PM <DIR>   phpdoc-cache-64 
07/29/2013 03:20 PM <DIR>   phpdoc-cache-7a 
07/29/2013 03:20 PM <DIR>   phpdoc-cache-8c 
07/29/2013 03:20 PM <DIR>   phpdoc-cache-a3 
07/29/2013 03:20 PM <DIR>   phpdoc-cache-a6 
07/29/2013 03:20 PM <DIR>   phpdoc-cache-db 
07/29/2013 03:20 PM <DIR>   phpdoc-cache-e0 
       6 File(s)  142,256 bytes 
       21 Dir(s) 394,722,947,072 bytes free 

C:\Users\Owner\PhpstormProjects\CRM\anet_php_sdk\phpdocs> 

似乎有點奇怪那一堆緩存是躺在身邊,但無論好了,我不知道從PHPDoc的什麼期望。

但是 - 實際的文檔是不可用的。該索引非常漂亮,綠色等,但索引中的每一個鏈接都會將我帶到一個未格式化的屏幕,我非常懷疑缺少CSS格式。

從任何這些頁面的每一個環節,比如看到一個方法,是壞的。看來phpdoc把所有的文件放到了錯誤的地方。我試着將它們整理出來,使其工作,但它似乎不管多少重新排列我輸出的文件結束了更多的重新安排需要。此外,我不應該這樣做。

我做錯了什麼?

+0

好吧,我不知道我該怎麼做?不知道你的意思 – Lurk21

回答

2

有一個與響應,樹枝模板的錯誤。
我建議你嘗試喜歡new-black

phpdoc --template=new-black -t phpdocs/ -d lib

來源的模板:Issue954

2

那麼我不得不手動重新安排所有的PHPDoc的輸出。相當馬虎恕我直言。