0

headerdoc2html コマンドでドキュメントを生成してみました。しかし、headerdoc は toc.html しか生成しません。プロトコルの index.html はありません。何か問題でも？

以下のヘッダーファイルとコマンドを使用しました。 

/*!                                                                                                                                                                                                                                                                             
  @header Dummy.h                                                                                                                                                                                                                                                               
  hoge                                                                                                                                                                                                                                                                          
*/                                                                                                                                                                                                                                                                              


/*!                                                                                                                                                                                                                                                                             
  @class Foo                                                                                                                                                                                                                                                                    
  asdf                                                                                                                                                                                                                                                                          
*/                                                                                                                                                                                                                                                                              
@interface Foo : NSObject                                                                                                                                                                                                                                                       

/*!                                                                                                                                                                                                                                                                             
  @abstract xxx                                                                                                                                                                                                                                                                 
*/                                                                                                                                                                                                                                                                              
- (void)xxx;                                                                                                                                                                                                                                                                    

@end                                                                                                                                                                                                                                                                            

/*!                                                                                                                                                                                                                                                                             
  @protocol BarDelegate                                                                                                                                                                                                                                                         
*/                                                                                                                                                                                                                                                                              
@protocol BarDelegate                                                                                                                                                                                                                                                           

/*!                                                                                                                                                                                                                                                                             
  @abstract Sent after something                                                                                                                                                                                                                                                
*/                                                                                                                                                                                                                                                                              
- (void)didSomething:(Foo *)foo;                                                                                                                                                                                                                                                
@end

--

$ headerdoc2html *.h -o doc

その結果、

$ find doc
doc
doc/Dummy_h
doc/Dummy_h/Classes
doc/Dummy_h/Classes/Foo
doc/Dummy_h/Classes/Foo/index.html
doc/Dummy_h/Classes/Foo/toc.html
doc/Dummy_h/index.html
doc/Dummy_h/Protocols
doc/Dummy_h/Protocols/BarDelegate
doc/Dummy_h/Protocols/BarDelegate/toc.html
doc/Dummy_h/toc.html
4

1 に答える 1

0

あなたのコードは完璧だと思いますが、間違っているコマンドについてはそうです。headerDoc を作成するための 4 つのステップがあります。

ステップ 1 : プロジェクトが配置されているディレクトリに移動します (ヘッダー ファイルではなく)。

$ cd <Your_Project_Directory>

ステップ 2 : プロジェクトの all コントローラーの HTML DOC ファイルを作成し、HTML DOC ファイルを生成するディレクトリを作成します。

<Your_Project_Directory> $ headerdoc2html -o <DIR_PATH_TO_CREATE_YOUR_DOC> <PROJECT_NAME>

ステップ 3 : これで、doc ファイルを作成したディレクトリ パスに作成されたものが表示されます。それについてはあまり考えないでください。後で説明します。HTMLファイルを作成したディレクトリに移動します

<Your_Project_Directory> $ cd <DIR_PATH_TO_CREATE_YOUR_DOC>

ステップ 4 : それらは現在、ディレクトリ内に非常に多くのファイルがあり、それらはすべて互いに分離されているため、それらをまとめて相互にリンクを作成するには、最後のコマンドを適用する必要があります。

gatherheaderdoc ..

ここで最後の「..」(ドット2つ)で親ファイルに「masterTOC.HTML」ファイルが作成されます。これで、これを開いてプロジェクトをテストできます。

于 2016-10-16T05:38:26.367 に答える