我從來沒有使用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把所有的文件放到了錯誤的地方。我試着將它們整理出來,使其工作,但它似乎不管多少重新排列我輸出的文件結束了更多的重新安排需要。此外,我不應該這樣做。
我做錯了什麼?
好吧,我不知道我該怎麼做?不知道你的意思 – Lurk21