3

目的は、Visual Studio C# ソリューション全体のドキュメントを Doxygen で自動的に作成することです。これは、Jenkins を使用する外部ビルドサーバーで発生するはずです。私のプロジェクトの構造は次のようなものです：

Root
    Tools
        doxygen-1.8.0
            doxygen.exe
    Project1
        bin
        ...
    Project2
        bin
        ...
    ...

Doxywizard で Doxyfile を作成する場合、入力と出力のパスは残念ながら絶対パスです。つまり、それらは開発者のマシンに依存し、Jenkins サーバーでは機能しなくなります。どうすればそれを修正できるか知っていますか？これは Doxygen のFULL_PATH_NAMESとSTRIP_FROM_PATHに関係があるのではないかと疑っていますが、正直なところ、これら 2 つのパラメーターの説明はわかりません。たぶん私は間違っていますが、これは 2 つのパラメーターとはまったく関係ありません。

ありがとうございました！

4

1 に答える 1

4

Windows上のdoxygenが、構成ファイルがWindowsパス（バックスラッシュ区切り文字付き）またはUnixパス（スラッシュ付き）を使用することを期待しているかどうかはわかりません。とにかく、パスがdoxygenを実行するディレクトリからの相対パスであることを確認する必要があります。

Doxyfileで、INPUTリストと OUTPUT_DIRECTORY相対パスを設定します。ルート内から実行していると仮定します：

INPUT = ./Project1 \
        ./Project2

一般に、相対パスを指定するすべての変数を更新する必要があります（そして、リソースがソース管理にチェックインされていることを確認してください）。

一部のプロジェクトでは、環境変数を介してOUTPUT_DIRECTORYを設定すると便利であることがわかりました。

OUTPUT_DIRECTORY = $(DOXYGEN_OUTOUT_DIR)

他では、それは単なる相対的なパスです：

OUTPUT_DIRECTORY = ./gen/docs

先頭./は厳密には必要ありませんが、これが相対パスであることを示す読み取り可能なインジケーターです。

変数は役に立ちません。FULL_PATH_NAMES生成されたファイルリストにファイルがどのように表示されるかを制御します。

于 2012-04-30T06:01:22.207 に答える