0

以前に phpdoc を使用したことはありませんが、Authorize.Net PHP SDK ドキュメントが必要で、phpdoc で生成する必要があるようです。

私が実行すると:

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

「Parsing file」と「No summary for method」のストリームが表示されますが、これで問題ないと思います。説明的な要約がなくても、オブジェクトのメソッドとパラメーターのリストで十分です。

それはこれで終わります:

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>

どちらもOKだと思います。

出力されるディレクトリ構造は次のようになります。

 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 がすべてのファイルを間違った場所に置いたようです。それらを並べ替えて機能させようとしましたが、出力されたファイルをどれだけ並べ替えても、さらに並べ替えが必要になるようです。その上、私はこれを行う必要はありません。

私は何を間違えましたか?

4

2 に答える 2

2

response-twig テンプレートにバグがあります。
次のようなテンプレートを試すことをお勧めしますnew-black

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

出典:Issue954

于 2013-07-29T20:48:13.593 に答える
2

Well I just had to manually re-arrange all of the phpdoc output. Pretty sloppy IMHO.

于 2013-07-29T20:45:09.273 に答える