Doxygenを実行してみた

C言語のソースファイルを使って、Doxygenを実行してみました。その手順を紹介します。

C言語のソースファイルにDoxygenのコメントを挿入済みとします。

１．Doxygen関連のファイルを保存するディレクトリを指定します。

２．「Wizard」→「Project」→「Project name:」にプロジェクト名を入力します。

３．「Wizard」→「Project」→「Project synopsis:」にプロジェクトの概要を入力します。

４．「Wizard」→「Project」→「Source code directory:」にソースファイルが入っているディレクトリを指定します。

１．上記画面の通りに設定します。

１．上記画面の通りに設定します。

１．上記画面の通りに設定します。

１．「DOXYFILE_ENCODING」を「UTF-8」に設定します。

　　「OUTPUT_LANGUAGE」を「Japanese」に設定します。

「PROJECT_NAME」（Project name）または

「PROJECT_BRIEF」(Project synopsis)が日本語の場合、

「DOXYFILE_ENCODING」が「CP932」だとエラーで正常にビルドできませんでした。

そのため、「DOXYFILE_ENCODING」を「UTF-8」に設定します。

エラーメッセージ内容：

error: Error: failed to translate characters from CP932 to UTF-8: Illegal byte sequence
Exiting…

２．「INPUT_ENCODING」を「CP932」と入力します。

　　ソースファイルの文字コードに合わせています。

３．「DOT_PATH」が設定されていることを確認します。

　　もし設定されていなければ、Graphvizのインストールディレクトリを指定します。

１．「Run doxygen」ボタンをクリックし、Doxygenを実行します。

　　　実行完了後、「Doxygen has finished」と表示されます。

　　　出力ファイルは「Show HTML output」ボタンをクリックして表示することができます。