1

クラスをそれぞれ 1 つのファイルに配置しようとしましたが、クラスはいくつかの異なるライブラリに属しています。

基本的に、これらのファイルlibrary inf.logic;の上部には次のものがあります。

  • web/logic/realm.dart(輸入品region.dart)
  • web/logic/region.dart(輸入品../events.dart)
  • web/logic/tile.dart

これには次のものがありますlibrary inf.gfx;。

  • web/gfx/viewport.dart(輸入品../logic/realm.dart)

これには次のものがありますlibrary inf;。

  • web/events.dart

そして、infデフォルトでライブラリにあるように見えるメインエントリポイントがあります。

  • web/inf.dart(インポートgfx/viewport.dart, logic/realm.dart, logic/region.dart, logic/tile.dart)

dartdoc を生成すると、一部のクラスのみをランダムにキャッチしているように見えます。region.dartメイン エントリ ポイントは上記のすべてのクラスを明示的に使用しますが、とに対して生成されたドキュメントのみを取得しevents.dartます。他のファイルは含まれず、他のクラスを参照するドキュメント内のリンクは 404 になります。

何か間違ったことをしているような気がします。ライブラリのラッパー ファイルを作成して and を使用する必要がpartありpart ofますか? ファイルのリレーション間にメンテナンスの必要性を追加するという考えは本当に嫌いです。これは、インポートからすでに暗黙的になっているはずです。

また、相対パスを取り除くにはどうすればよいですか? 試してみpackage:inf/logic/realm.dartましたが、うまくいきません…</p>

4

1 に答える 1

0

Andrei Mouravski は、メーリング リストでこれに答えました。

ここにはいくつかの問題があります。

  1. Dartdoc が 404 リンクを生成している場合は、提供できるすべての情報とともにバグを報告してください。何かが壊れた可能性が高いです。dartbug.com/new

  2. 複数のエントリポイントを渡すことで、同時に複数のことを文書化できます。注: 複数のエントリポイントがある場合は、「pkg」コマンド ライン オプションを使用してパッケージ フォルダーを指定する必要があります。

  3. ラッパー ファイルは必要ありませんが、dartdoc はエントリポイントにインポートされたすべてのライブラリを文書化する必要があるため、文書化するすべてのライブラリをインポートする単純なファイルを作成するだけでよい可能性があります。私たちはこれを改善するために取り組んでいますが、現時点では少し壊れていることをお詫びします.

于 2012-12-27T02:10:42.620 に答える