2013-07-29 61 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的输出。相当马虎恕我直言。