継続的な統合を可能にするdoxygenの相対パス

Question

Doxygenを使用して私のVisual Studio C＃ソリューション全体のドキュメントを自動的に作成することを目的としています。これは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つのパラメータとはまったく関係がありません。

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

Answer 1

Windowsでdoxygenが設定ファイルにWindowsパス（バックスラッシュ区切り記号）またはUNIXパス（スラッシュ付き）を使用するかどうかはわかりません。それにかかわらず、パスがdoxygenを実行するディレクトリからの相対パスであることを確認する必要があります。

Doxyfileには、INPUTのリストとOUTPUT_DIRECTORYの相対パスを設定します。あなたはルート内から実行していると仮定すると：一般的に

INPUT = ./Project1 \ 
     ./Project2 

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

他で

OUTPUT_DIRECTORY = $(DOXYGEN_OUTOUT_DIR) 

、そのわずか相対パス：

OUTPUT_DIRECTORY = ./gen/docs 

大手私たちのプロジェクトの一部で

は、私はそれが便利な環境変数を経由してOUTPUT_DIRECTORYを設定することが分かってきました ./は厳密には必要ではありませんが、これは相対パスであることがわかります。

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